xref: /original-bsd/usr.bin/passwd/passwd.1 (revision a91856c6)
1.\" Copyright (c) 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)passwd.1	6.10 (Berkeley) 03/14/91
7.\"
8.Vx
9.Vx
10.Dd
11.Dt PASSWD 1
12.Os BSD 4
13.Sh NAME
14.Nm passwd
15.Nd modify a user's password
16.Sh SYNOPSIS
17.Nm passwd
18.Op Fl l
19.Op Ar user
20.Sh DESCRIPTION
21.Nm Passwd
22changes the user's Kerberos password.  First, the user is prompted for their
23current password.
24If the current password is correctly typed, a new password is
25requested.
26The new password must be entered twice to avoid typing errors.
27.Pp
28The new password should be at least six characters long and not
29purely alphabetic.
30Its total length must be less than _PASSWORD_LEN (currently 128 characters).
31Numbers, upper case letters and meta characters
32are encouraged.
33.Pp
34Once the password has been verified,
35.Nm passwd
36communicates the new password information to
37the Kerberos authenticating host.
38.Tp Fl l
39This option causes the password to be updated only in the local
40password file, and not with the Kerberos database.
41When changing only the local password,
42.Xr pwd_mkdb  8
43is used to update the password databases.
44.Tp
45.Pp
46To change another user's Kerberos password, one must first
47run
48.Xr kinit 1
49followed by
50.Xr passwd 1 .
51The super-user is not required to provide a user's current password
52if only the local password is modified.
53.Sh FILES
54.Dw /etc/master.passwd
55.Di L
56.Dp Pa /etc/master.passwd
57The user database
58.Dp Pa /etc/passwd
59A Version 7 format password file
60.Dp Pa /etc/passwd.XXXXXX
61Temporary copy of the password file
62.Dp
63.Sh SEE ALSO
64.Xr chpass 1 ,
65.Xr kerberos 1 ,
66.Xr kinit 1 ,
67.Xr login 1 ,
68.Xr passwd 5 ,
69.Xr kpasswdd 8 ,
70.Xr pwd_mkdb 8 ,
71.Xr vipw 8
72.br
73Robert Morris and Ken Thompson,
74.Em UNIX password security
75.Sh HISTORY
76A
77.Nm passwd
78command appeared in Version 6 AT&T UNIX.
79