Add -O and -T to the SYNOPSIS.
[dragonfly.git] / contrib / opie / opiegen.1
1 .\" opiegen.1: Manual page for the opiegen(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 .\"     Modified by cmetz for OPIE 2.4. Fixed *roff bug.
18 .\"     Created by cmetz for OPIE 2.2 from opiekey.1.
19 .\"
20 .ll 6i
21 .pl 10.5i
22 .lt 6.0i
23 .TH OPIEKEY 1 "February 20, 1996"
24 .AT 3
25 .SH NAME
26 opiegen \- Example OPIE-based OTP generator
27
28 .SH SYNOPSIS
29 .B opiegen
30 .sp 0
31 [
32 .I challenge
33 ]
34 .sp 0
35
36 .SH DESCRIPTION
37 .I opiegen
38 takes a properly formed OTP challenge either from the command line or from
39 standard input, prompts the user for a secret pass phrase, and generates an
40 OTP response to that challenge. It is intended as an example for programmers
41 of how a simple OTP generator can be built. Users should probably use the
42 .I opiekey
43 program instead.
44
45 .SH EXAMPLE
46 .sp 0
47 wintermute$ opiegen otp-md5 495 wi01309
48 .sp 0
49 Secret Pass Phrase:
50 .sp 0
51 GILL HUED GOES CHUM LIEU VAIN
52 .sp 0
53 wintermute$
54 .LP
55
56 .SH BUGS
57 .BR opiegen(1)
58 can lull a user into revealing his/her password when remotely logged in, thus
59 defeating the purpose of OPIE. This is especially a problem with xterm. 
60 .BR opiegen(1)
61 implements simple checks to reduce the risk of a user making
62 this mistake. Better checks are needed.
63 .LP
64
65 .SH SEE ALSO
66 .BR opiekey (1),
67 .BR opieserv (1),
68 .BR opie (4),
69 .BR opiepasswd (1),
70 .BR opieinfo (1),
71 .BR opiesu (1),
72 .BR opielogin (1),
73 .BR opieftpd (8),
74 .BR opiekeys (5),
75 .BR opieaccess (5)
76
77 .SH AUTHOR
78 The opiegen(1) program was created by Craig Metz for OPIE 2.2.
79
80 Bellcore's S/Key was written by Phil Karn, Neil M. Haller, and John S. Walden
81 of Bellcore. OPIE was created at NRL by Randall Atkinson, Dan McDonald, and
82 Craig Metz.
83
84 S/Key is a trademark of Bell Communications Research (Bellcore).
85
86 .SH CONTACT
87 OPIE is discussed on the Bellcore "S/Key Users" mailing list. To join,
88 send an email request to:
89 .sp
90 skey-users-request@thumper.bellcore.com