xref: /original-bsd/usr.bin/passwd/passwd.1 (revision c3e32dec)
1.\" Copyright (c) 1990, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"	@(#)passwd.1	8.1 (Berkeley) 06/06/93
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
29.Dv _PASSWORD_LEN
30(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.Bl -tag -width flag
39.It Fl l
40This option causes the password to be updated only in the local
41password file, and not with the Kerberos database.
42When changing only the local password,
43.Xr pwd_mkdb  8
44is used to update the password databases.
45.El
46.Pp
47To change another user's Kerberos password, one must first
48run
49.Xr kinit 1
50followed by
51.Xr passwd 1 .
52The super-user is not required to provide a user's current password
53if only the local password is modified.
54.Sh FILES
55.Bl -tag -width /etc/master.passwd -compact
56.It Pa /etc/master.passwd
57The user database
58.It Pa /etc/passwd
59A Version 7 format password file
60.It Pa /etc/passwd.XXXXXX
61Temporary copy of the password file
62.El
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.Rs
73.%A Robert Morris
74.%A Ken Thompson
75.%T "UNIX password security"
76.Re
77.Sh HISTORY
78A
79.Nm passwd
80command appeared in
81.At v6 .
82