BSD 4_3_Net_2 release

[unix-history] / usr / src / usr.bin / chpass / chpass.1

diff --git a/usr/src/usr.bin/chpass/chpass.1 b/usr/src/usr.bin/chpass/chpass.1
index e2922eb..23ee47d 100644 (file)
--- a/usr/src/usr.bin/chpass/chpass.1
+++ b/usr/src/usr.bin/chpass/chpass.1
@@ -1,25 +1,39 @@
 .\" Copyright (c) 1988, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
 .\" Copyright (c) 1988, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"

-.\" Redistribution and use in source and binary forms are permitted provided
-.\" that: (1) source distributions retain this entire copyright notice and
-.\" comment, and (2) distributions including binaries display the following
-.\" acknowledgement:  ``This product includes software developed by the
-.\" University of California, Berkeley and its contributors'' in the
-.\" documentation or other materials provided with the distribution and in
-.\" all advertising materials mentioning features or use of this software.
-.\" Neither the name of the University nor the names of its contributors may
-.\" be used to endorse or promote products derived from this software without
-.\" specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
-.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"     @(#)chpass.1   5.9 (Berkeley) 7/24/90
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.

 .\"
 .\"

-.Dd July 24, 1990
+.\"     @(#)chpass.1   5.11 (Berkeley) 3/14/91
+.\"
+.Dd March 14, 1991

 .Dt CHPASS 1
 .Dt CHPASS 1

-.Os BSD 4.4
+.Os

 .Sh NAME
 .Nm chpass
 .Nd add or change user database information
 .Sh NAME
 .Nm chpass
 .Nd add or change user database information


@@ -39,51 +53,51 @@ The information is formatted and supplied to an editor for changes.
 Only the information that the user is allowed to change is displayed.
 .Pp
 The options are as follows:
 Only the information that the user is allowed to change is displayed.
 .Pp
 The options are as follows:

-.Tw Ds
-.Tp Fl a
+.Bl -tag -width Ds
+.It Fl a

 The super-user is allowed to directly supply a user database
 entry, in the format specified by
 .Xr passwd 5 ,
 as an argument.
 This argument must be a colon (``:'') separated list of all the
 user database fields, although they may be empty.
 The super-user is allowed to directly supply a user database
 entry, in the format specified by
 .Xr passwd 5 ,
 as an argument.
 This argument must be a colon (``:'') separated list of all the
 user database fields, although they may be empty.

-.Tp Fl s
+.It Fl s

 The
 .Fl s
 option attempts to change the user's shell to
 .Ar newsh .
 The
 .Fl s
 option attempts to change the user's shell to
 .Ar newsh .

-.Tp
+.El

 .Pp
 Possible display items are as follows:
 .Pp
 .Pp
 Possible display items are as follows:
 .Pp

-.Dw Home\ Directory:
-.Dp Login:
+.Bl -tag -width "Home Directory:" -compact -offset indent
+.It Login:

 user's login name
 user's login name

-.Dp Password:
+.It Password:

 user's encrypted password
 user's encrypted password

-.Dp Uid:
+.It Uid:

 user's id
 user's id

-.Dp Gid:
+.It Gid:

 user's login group id
 user's login group id

-.Dp Change:
+.It Change:

 password change time
 password change time

-.Dp Expire:
+.It Expire:

 account expiration time
 account expiration time

-.Dp Class:
+.It Class:

 user's general classification
 user's general classification

-.Dp Home Directory:
+.It Home Directory:

 user's home directory
 user's home directory

-.Dp Shell:
+.It Shell:

 user's login shell
 user's login shell

-.Dp Full Name:
+.It Full Name:

 user's real name
 user's real name

-.Dp Location:
+.It Location:

 user's normal location
 user's normal location

-.Dp Home Phone:
+.It Home Phone:

 user's home phone
 user's home phone

-.Dp Office Phone:
+.It Office Phone:

 user's office phone
 user's office phone

-.Dp
+.El

 .Pp
 The
 .Ar login
 .Pp
 The
 .Ar login


@@ -134,7 +148,7 @@ is the month name (the first three characters are sufficient),
 is the day of the month, and
 .Ar year
 is the year.
 is the day of the month, and
 .Ar year
 is the year.

-.bp
+.Pp

 The
 .Ar class
 field is currently unused.  In the near future it will be a key to
 The
 .Ar class
 field is currently unused.  In the near future it will be a key to


@@ -172,11 +186,8 @@ numbers.
 Once the information has been verified,
 .Nm chpass
 uses
 Once the information has been verified,
 .Nm chpass
 uses

-.Xr mkpasswd 8
-to update the user database.  This is run in the background, and,
-at very large sites could take several minutes.  Until this update
-is completed, the password file is unavailable for other updates
-and the new information will not be available to programs.
+.Xr pwd_mkdb 8
+to update the user database.

 .Sh ENVIRONMENT
 The
 .Xr vi 1
 .Sh ENVIRONMENT
 The
 .Xr vi 1


@@ -187,24 +198,33 @@ update the user database itself.
 Only the user, or the super-user, may edit the information associated
 with the user.
 .Sh FILES
 Only the user, or the super-user, may edit the information associated
 with the user.
 .Sh FILES

-.Dw /etc/master.passwd
-.Di L
-.Dp Pa /etc/master.passwd
+.Bl -tag -width /etc/master.passwd -compact
+.It Pa /etc/master.passwd

 The user database
 The user database

-.Dp Pa /etc/shells
+.It Pa /etc/passwd
+A Version 7 format password file
+.It Pa /etc/chpass.XXXXXX
+Temporary copy of the password file
+.It Pa /etc/shells

 The list of approved shells
 The list of approved shells

-.Dp
+.El

 .Sh SEE ALSO
 .Xr login 1 ,
 .Xr finger 1 ,
 .Sh SEE ALSO
 .Xr login 1 ,
 .Xr finger 1 ,

+.Xr passwd 1 ,

 .Xr getusershell 3 ,
 .Xr passwd 5 ,
 .Xr getusershell 3 ,
 .Xr passwd 5 ,

-.Xr mkpasswd 8 ,
+.Xr pwd_mkdb 8 ,

 .Xr vipw 8
 .Xr vipw 8

-.Pp
-Robert Morris and Ken Thompson,
-.Ar UNIX Password security
-.Sh HISTORY
-First release 4.3 Reno BSD.
+.Rs
+.%A Robert Morris
+.%A Ken Thompson
+.%T "UNIX Password security"
+.Re

 .Sh BUGS
 User information should (and eventually will) be stored elsewhere.
 .Sh BUGS
 User information should (and eventually will) be stored elsewhere.

+.Sh HISTORY
+The
+.Nm
+command appeared in 
+.Bx 4.3 Reno .