source: trunk/athena/bin/passwd/passwd.1 @ 11500

Revision 11500, 2.3 KB checked in by ghudson, 27 years ago (diff)
Add a passwd glue program which switches between kpasswd and /usr/bin/passwd, and updates {passwd,shadow,master.passwd}.local when a local password changes.
Line 
1.\" $Id: passwd.1,v 1.1 1998-05-08 15:15:09 ghudson Exp $
2.\"
3.\" Copyright 1998 by the Massachusetts Institute of Technology.
4.\"
5.\" Permission to use, copy, modify, and distribute this
6.\" software and its documentation for any purpose and without
7.\" fee is hereby granted, provided that the above copyright
8.\" notice appear in all copies and that both that copyright
9.\" notice and this permission notice appear in supporting
10.\" documentation, and that the name of M.I.T. not be used in
11.\" advertising or publicity pertaining to distribution of the
12.\" software without specific, written prior permission.
13.\" M.I.T. makes no representations about the suitability of
14.\" this software for any purpose.  It is provided "as is"
15.\" without express or implied warranty.
16.TH PASSWD 1 "5 May 1998"
17.SH NAME
18passwd \- Change Kerberos or local password
19.SH SYNOPSIS
20passwd \fI[-k|-l]\fR \fI[username]\fR
21.SH DESCRIPTION
22.I passwd
23changes a user's Kerberos or local password and possibly updates the
24system's local password file with the new user entry.
25.PP
26The first task of
27.I passwd
28is to choose between the Kerberos and local password-changing
29programs.  If the
30.B -k
31argument is given,
32.I passwd
33runs the Kerberos password-changing program (/usr/athena/bin/kpasswd);
34if the
35.B -l
36argument is given,
37.I passwd
38runs the local password-changing program (/usr/bin/passwd).  If
39neither option is given,
40.I passwd
41runs the local password-changing program if it is invoked by root or
42by a user listed as having a local account in
43.IR /etc/athena/access .
44Otherwise, it runs the Kerberos password-changing program.
45.PP
46If
47.I passwd
48runs the local password-changing program, it subsequently attempts to
49update the appropriate local passwd file (which may be
50.IR /etc/passwd.local ,
51.IR /etc/shadow.local ,
52or
53.I /etc/master.passwd.local
54depending on the system type) by replacing the line for the user with
55the new line from the appropriate passwd file.  If there is no local
56passwd file or if the user has no entry in the local passwd file, no
57update is performed.
58.SH FILES
59/etc/athena/access
60.br
61/etc/passwd
62.br
63/etc/passwd.local
64.br
65/etc/shadow
66.br
67/etc/shadow.local
68.br
69/etc/master.passwd
70.br
71/etc/master.passwd.local
72.PP
73depending on the system type.
74.SH "SEE ALSO"
75access(5)
76.SH AUTHOR
77Greg Hudson, MIT Information Systems
78.br
79Copyright 1998 by the Massachusetts Institute of Technology.
Note: See TracBrowser for help on using the repository browser.