Annotation of src/usr.bin/chpass/chpass.1, Revision 1.1.1.1
1.1 deraadt 1: .\" $NetBSD: chpass.1,v 1.6 1995/09/14 06:10:53 jtc Exp $
2: .\"
3: .\" Copyright (c) 1988, 1990, 1993
4: .\" The Regents of the University of California. All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
14: .\" 3. All advertising materials mentioning features or use of this software
15: .\" must display the following acknowledgement:
16: .\" This product includes software developed by the University of
17: .\" California, Berkeley and its contributors.
18: .\" 4. Neither the name of the University nor the names of its contributors
19: .\" may be used to endorse or promote products derived from this software
20: .\" without specific prior written permission.
21: .\"
22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32: .\" SUCH DAMAGE.
33: .\"
34: .\" @(#)chpass.1 8.2 (Berkeley) 12/30/93
35: .\"
36: .Dd December 30, 1993
37: .Dt CHPASS 1
38: .Os
39: .Sh NAME
40: .Nm chpass
41: .Nd add or change user database information
42: .Sh SYNOPSIS
43: .Nm chpass
44: .Op Fl a Ar list
45: .Op Fl s Ar newshell
46: .Op user
47: .Sh DESCRIPTION
48: .Nm Chpass
49: allows editing of the user database information associated
50: with
51: .Ar user
52: or, by default, the current user.
53: The information is formatted and supplied to an editor for changes.
54: .Pp
55: Only the information that the user is allowed to change is displayed.
56: .Pp
57: The options are as follows:
58: .Bl -tag -width Ds
59: .It Fl a
60: The super-user is allowed to directly supply a user database
61: entry, in the format specified by
62: .Xr passwd 5 ,
63: as an argument.
64: This argument must be a colon (``:'') separated list of all the
65: user database fields, although they may be empty.
66: .It Fl s
67: The
68: .Fl s
69: option attempts to change the user's shell to
70: .Ar newshell .
71: .El
72: .Pp
73: Possible display items are as follows:
74: .Pp
75: .Bl -tag -width "Home Directory:" -compact -offset indent
76: .It Login:
77: user's login name
78: .It Password:
79: user's encrypted password
80: .It Uid:
81: user's login
82: .It Gid:
83: user's login group
84: .It Change:
85: password change time
86: .It Expire:
87: account expiration time
88: .It Class:
89: user's general classification
90: .It Home Directory:
91: user's home directory
92: .It Shell:
93: user's login shell
94: .It Full Name:
95: user's real name
96: .It Location:
97: user's normal location
98: .It Home Phone:
99: user's home phone
100: .It Office Phone:
101: user's office phone
102: .El
103: .Pp
104: The
105: .Ar login
106: field is the user name used to access the computer account.
107: .Pp
108: The
109: .Ar password
110: field contains the encrypted form of the user's password.
111: .Pp
112: The
113: .Ar uid
114: field is the number associated with the
115: .Ar login
116: field.
117: Both of these fields should be unique across the system (and often
118: across a group of systems) as they control file access.
119: .Pp
120: While it is possible to have multiple entries with identical login names
121: and/or identical user id's, it is usually a mistake to do so. Routines
122: that manipulate these files will often return only one of the multiple
123: entries, and that one by random selection.
124: .Pp
125: The
126: .Ar group
127: field is the group that the user will be placed in at login.
128: Since BSD supports multiple groups (see
129: .Xr groups 1 )
130: this field currently has little special meaning.
131: This field may be filled in with either a number or a group name (see
132: .Xr group 5 ) .
133: .Pp
134: The
135: .Ar change
136: field is the date by which the password must be changed.
137: .Pp
138: The
139: .Ar expire
140: field is the date on which the account expires.
141: .Pp
142: Both the
143: .Ar change
144: and
145: .Ar expire
146: fields should be entered in the form ``month day year'' where
147: .Ar month
148: is the month name (the first three characters are sufficient),
149: .Ar day
150: is the day of the month, and
151: .Ar year
152: is the year.
153: .Pp
154: The
155: .Ar class
156: field is currently unused. In the near future it will be a key to
157: a
158: .Xr termcap 5
159: style database of user attributes.
160: .Pp
161: The user's
162: .Ar home directory
163: is the full UNIX path name where the user
164: will be placed at login.
165: .Pp
166: The
167: .Ar shell
168: field is the command interpreter the user prefers.
169: If the
170: .Ar shell
171: field is empty, the Bourne shell,
172: .Pa /bin/sh ,
173: is assumed.
174: When altering a login shell, and not the super-user, the user
175: may not change from a non-standard shell or to a non-standard
176: shell.
177: Non-standard is defined as a shell not found in
178: .Pa /etc/shells .
179: .Pp
180: The last four fields are for storing the user's
181: .Ar full name , office location ,
182: and
183: .Ar home
184: and
185: .Ar work telephone
186: numbers.
187: .Pp
188: Once the information has been verified,
189: .Nm chpass
190: uses
191: .Xr pwd_mkdb 8
192: to update the user database.
193: .Sh ENVIRONMENT
194: The
195: .Xr vi 1
196: editor will be used unless the environment variable EDITOR is set to
197: an alternate editor.
198: When the editor terminates, the information is re-read and used to
199: update the user database itself.
200: Only the user, or the super-user, may edit the information associated
201: with the user.
202: .Sh FILES
203: .Bl -tag -width /etc/master.passwd -compact
204: .It Pa /etc/master.passwd
205: The user database
206: .It Pa /etc/passwd
207: A Version 7 format password file
208: .It Pa /etc/chpass.XXXXXX
209: Temporary copy of the password file
210: .It Pa /etc/shells
211: The list of approved shells
212: .El
213: .Sh SEE ALSO
214: .Xr login 1 ,
215: .Xr finger 1 ,
216: .Xr passwd 1 ,
217: .Xr getusershell 3 ,
218: .Xr passwd 5 ,
219: .Xr pwd_mkdb 8 ,
220: .Xr vipw 8
221: .Rs
222: .%A Robert Morris
223: .%A Ken Thompson
224: .%T "UNIX Password security"
225: .Re
226: .Sh BUGS
227: User information should (and eventually will) be stored elsewhere.
228: .Sh HISTORY
229: The
230: .Nm
231: command appeared in
232: .Bx 4.3 Reno .