Merge branch 'vendor/MDOCML'
[dragonfly.git] / contrib / opie / opieserv.1
1 .\" opieserv.1: Manual page for the opieserv(1) program.
2 .\"
3 .\" %%% portions-copyright-cmetz-96
4 .\" Portions of this software are Copyright 1996-1999 by Craig Metz, All Rights
5 .\" Reserved. The Inner Net License Version 2 applies to these portions of
6 .\" the software.
7 .\" You should have received a copy of the license with this software. If
8 .\" you didn't get a copy, you may request one from <license@inner.net>.
9 .\"
10 .\" Portions of this software are Copyright 1995 by Randall Atkinson and Dan
11 .\" McDonald, All Rights Reserved. All Rights under this copyright are assigned
12 .\" to the U.S. Naval Research Laboratory (NRL). The NRL Copyright Notice and
13 .\" License Agreement applies to this software.
14 .\"
15 .\"     History:
16 .\"
17 .\"     Created by cmetz for OPIE 2.2 from opiegen.1.
18 .\"
19 .ll 6i
20 .pl 10.5i
21 .lt 6.0i
22 .TH OPIEKEY 1 "February 20, 1996"
23 .AT 3
24 .SH NAME
25 opieserv \- Example OPIE-based OTP server
26
27 .SH SYNOPSIS
28 .B opieserv
29 .sp 0
30 [
31 .I principal
32 ]
33 .sp 0
34
35 .SH DESCRIPTION
36 .I opieserv
37 takes an OTP principal (e.g., a user name) from either the command line or
38 standard input and returns a current OTP challenge for that principal. It then 
39 reads an OTP response to that challenge from standard input and displays a
40 message and returns a value to indicate either success (exit value = 0) or
41 failure (exit value = 1). It is intended as an example for programmers
42 of how a simple OTP server can be built.
43
44 .SH EXAMPLE
45 .sp 0
46 wintermute$ opieserv kebe
47 .sp 0
48 otp-md5 495 wi01309
49 .sp 0
50 Response: 
51 .sp 0
52 User verified.
53 .sp 0
54 wintermute$
55 .LP
56
57 .SH SEE ALSO
58 .BR opiegen (1),
59 .BR opiekey (1),
60 .BR opie (4),
61 .BR opiepasswd (1),
62 .BR opieinfo (1),
63 .BR opiesu (1),
64 .BR opielogin (1),
65 .BR opieftpd (8),
66 .BR opiekeys (5),
67 .BR opieaccess (5)
68
69 .SH AUTHOR
70 The opieserv1) program was created by Craig Metz for OPIE 2.2.
71
72 Bellcore's S/Key was written by Phil Karn, Neil M. Haller, and John S. Walden
73 of Bellcore. OPIE was created at NRL by Randall Atkinson, Dan McDonald, and
74 Craig Metz.
75
76 S/Key is a trademark of Bell Communications Research (Bellcore).
77
78 .SH CONTACT
79 OPIE is discussed on the Bellcore "S/Key Users" mailing list. To join,
80 send an email request to:
81 .sp
82 skey-users-request@thumper.bellcore.com