Merge branch 'vendor/LIBARCHIVE'
[dragonfly.git] / contrib / opie / opielogin.1
1 .\" opielogin.1: Manual page for the opielogin(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.2. Removed MJR DES documentation.
18 .\"     Modified at NRL for OPIE 2.0.
19 .\"     Option descriptions added from BSD.
20 .\"     Written at Bellcore for the S/Key Version 1 software distribution
21 .\"             (keylogin.1).
22 .\"
23 .ll 6i
24 .pl 10.5i
25 .lt 6.0i
26 .TH OPIELOGIN 1 "January 10, 1995"
27 .AT 3
28
29 .SH NAME
30 opielogin \- Replacement for login(1) that issues OPIE challenges.
31
32 .SH SYNOPSIS
33 .B opielogin 
34 [ -p ] [ -r 
35 .I hostname
36 | -h 
37 .I hostname
38 | -f
39 .I username
40 .sp 0
41
42 .I username
43 ]
44
45 .SH DESCRIPTION
46 .I opielogin
47 provides a replacement for the 
48 .IR login (1)
49 program that provides OPIE challenges
50 to users and accepts OPIE responses. It is downward compatible with the 
51 .IR keylogin(1)
52 program from the Bellcore S/Key Version 1 distribution, which, in
53 turn, is downward compatible with the
54 .IR login(1)
55 program from the 4.3BSD Net/2 distribution.
56
57 .SH OPTIONS
58 .TP
59 .B \-p
60 By default, login discards any previous environment.  The \-p 
61 option disables this behavior.
62 .TP
63 .B \-r
64 Process remote login from 
65 .I hostname.
66 .TP
67 .B \-h
68 The -h option specifies the host from which the connection was
69 received.  It is used by various daemons such as telnetd(8).
70 This option may only be used by the super\-user.
71 .TP
72 .B \-f
73 The -f option is used when a user name is specified to indicate
74 that proper authentication has already been done and that no
75 password need be requested.  This option may only be used by the
76 super\-user or when an already logged in user is logging in as
77 themselves.
78 .TP
79 .I username
80 The user name to log in as.
81 .SH EXAMPLE
82 .sp 0
83 wintermute$ opielogin
84 .sp 0
85 login: kebe
86 .sp 0
87 otp-md5 499 wi43143
88 .sp 0
89 Password: (echo on)
90 .sp 0
91 Password:SLY BLOB TOUR POP BRED EDDY
92 .sp 0
93  
94 .sp 0
95                         Welcome to wintermute.
96 .sp 0
97
98 .sp 0
99 wintermute$
100 .LP
101 .SH FILES
102 .TP
103 /etc/opiekeys -- database of information for the OPIE system.
104 .TP
105 /etc/opieaccess -- list of safe and unsafe networks and masks to go with them.
106 .TP
107 $HOME/.opiealways -- presence makes OPIE for logins mandatory for the user.
108
109 .SH SEE ALSO
110 .BR login (1),
111 .BR opie (4),
112 .BR opiekey (1),
113 .BR opiepasswd (1),
114 .BR opieinfo (1),
115 .BR opiesu (1),
116 .BR opieftpd (8),
117 .BR opiekeys (5),
118 .BR opieaccess (5)
119
120 .SH AUTHOR
121 Bellcore's S/Key was written by Phil Karn, Neil M. Haller, and John S. Walden
122 of Bellcore. OPIE was created at NRL by Randall Atkinson, Dan McDonald, and
123 Craig Metz.
124
125 S/Key is a trademark of Bell Communications Research (Bellcore).
126
127 .SH CONTACT
128 OPIE is discussed on the Bellcore "S/Key Users" mailing list. To join,
129 send an email request to:
130 .sp
131 skey-users-request@thumper.bellcore.com