PR: docs/9045

Update chpass(1) manual page.  Change the definition of the class
    field and also reorganize the field list to match that of the
    /etc/master.passwd file, to avoid confusion.
This commit is contained in:
Matthew Dillon 1998-12-13 02:47:00 +00:00
parent 9a0d08d599
commit f4b12e0a08

View File

@ -30,7 +30,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)chpass.1 8.2 (Berkeley) 12/30/93
.\" $Id: chpass.1,v 1.7.2.4 1998/08/14 03:38:01 thepish Exp $
.\" $Id: chpass.1,v 1.11 1998/08/14 03:47:38 thepish Exp $
.\"
.Dd December 30, 1993
.Dt CHPASS 1
@ -88,26 +88,30 @@ user's encrypted password
user's login
.It Gid:
user's login group
.It Class:
user's general classification
.It Change:
password change time
.It Expire:
account expiration time
.It Class:
user's general classification
.It Full Name:
user's real name
.It Location:
user's normal location (1)
.It Home Phone:
user's home phone (1)
.It Office Phone:
user's office phone (1)
.It Other Information:
any locally defined parameters for user (1)
.It Home Directory:
user's home directory
.It Shell:
user's login shell
.It Full Name:
user's real name
.It Location:
user's normal location
.It Home Phone:
user's home phone
.It Office Phone:
user's office phone
.It Other Information:
any locally defined parameters for user
.Pp
.It NOTE(1) -
In the actual master.passwd file, these fields are comma-delimited
fields embedded in the FullName field.
.El
.Pp
The
@ -141,6 +145,13 @@ This field may be filled in with either a number or a group name (see
.Xr group 5 ) .
.Pp
The
.Ar class
field references class descriptions in
.Ar /etc/login.conf
and is typically used to initialize the user's system resource limits
when they login.
.Pp
The
.Ar change
field is the date by which the password must be changed.
.Pp
@ -160,12 +171,15 @@ is the day of the month, and
.Ar year
is the year.
.Pp
The
.Ar class
field is currently unused. In the near future it will be a key to
a
.Xr termcap 5
style database of user attributes.
Five fields are available for storing the user's
.Ar full name , office location ,
.Ar work
and
.Ar home telephone
numbers and finally
.Ar other information
which is a single comma delimited string to represent any additional
gcos fields (typically used for site specific user information).
.Pp
The user's
.Ar home directory
@ -186,16 +200,6 @@ shell.
Non-standard is defined as a shell not found in
.Pa /etc/shells .
.Pp
The last five fields are for storing the user's
.Ar full name , office location ,
.Ar work
and
.Ar home telephone
numbers and finally
.Ar other information
which is a single comma delimited string to represent any additional
gcos fields (typically used for site specific user information).
.Pp
Once the information has been verified,
.Nm chpass
uses