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