summaryrefslogtreecommitdiff
path: root/share/man/man5/passwd.5
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>2000-03-01 18:01:23 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>2000-03-01 18:01:23 +0000
commit24d1ca5a1cbac141ec89b8d8e788cec58e1fa0fd (patch)
treec33ba3f0432f85697de0587a6f09b3fe3302925d /share/man/man5/passwd.5
parent60dc7dbcdc696404fe5683a09df802ada45f330a (diff)
Various cleanups.
Diffstat (limited to 'share/man/man5/passwd.5')
-rw-r--r--share/man/man5/passwd.576
1 files changed, 36 insertions, 40 deletions
diff --git a/share/man/man5/passwd.5 b/share/man/man5/passwd.5
index a1c7e9821b4..c1f7b8c3b6b 100644
--- a/share/man/man5/passwd.5
+++ b/share/man/man5/passwd.5
@@ -1,4 +1,4 @@
-.\" $OpenBSD: passwd.5,v 1.12 2000/01/19 08:33:27 pjanzen Exp $
+.\" $OpenBSD: passwd.5,v 1.13 2000/03/01 18:01:22 aaron Exp $
.\" $NetBSD: passwd.5,v 1.4 1995/07/28 06:46:05 phil Exp $
.\"
.\" Copyright (c) 1988, 1991, 1993
@@ -80,32 +80,31 @@ file is generated from the
.Nm master.passwd
file by
.Xr pwd_mkdb 8
-and has the class, change, and expire fields removed. Also, the encrypted
-password field is replaced by an asterisk
-.Pq Sq \&* .
+and has the class, change, and expire fields removed.
+Also, the encrypted password field is replaced by an asterisk
+.Pq Ql \&* .
.Pp
The
.Ar name
field is the login used to access the computer account, and the
.Ar uid
-field is the number associated with it. They should both be unique
-across the system (and often across a group of systems) since they
-control file access.
+field is the number associated with it.
+They should both be unique across the system (and often across a group of
+systems) since they control file access.
.Pp
While it is possible to have multiple entries with identical login names
-and/or identical user IDs, it is usually a mistake to do so. Routines
-that manipulate these files will often return only one of the multiple
-entries, and that one by random selection.
+and/or identical user IDs, it is usually a mistake to do so.
+Routines that manipulate these files will often return only one of the
+multiple entries, and that one by random selection.
.Pp
The login name must never begin with a hyphen
-.Pq Sq \&- ;
+.Pq Ql \&- ;
also, it is strongly
suggested that neither uppercase characters nor dots
-.Pq Sq \&.
+.Pq Ql \&.
be part
-of the name, as this tends to confuse mailers. No field may contain a
-colon
-.Pq Sq \&:
+of the name, as this tends to confuse mailers.
+No field may contain a colon
as this has been used historically to separate the fields
in the user database.
.Pp
@@ -115,7 +114,8 @@ form of the password.
If the
.Ar password
field is empty, no password will be required to gain access to the
-machine. This is almost invariably a mistake.
+machine.
+This is almost invariably a mistake.
Because
.Nm master.passwd
contains the encrypted user passwords, it should
@@ -135,30 +135,28 @@ this field currently has little special meaning.
.Pp
The
.Ar class
-field is currently unused. In the near future it will be a key to
-a
+field is currently unused.
+In the near future it will be a key to a
.Xr termcap 5
style database of user attributes.
.Pp
The
.Ar change
-field is the number in seconds,
-.Dv GMT ,
-from the epoch, until the
+field is the number in seconds, GMT, from the epoch, until the
password for the account must be changed.
This field may be left empty to turn off the password aging feature.
.Pp
The
.Ar expire
-field is the number in seconds,
-.Dv GMT ,
-from the epoch, until the
+field is the number in seconds, GMT, from the epoch, until the
account expires.
This field may be left empty to turn off the account aging feature.
.Pp
The
.Ar gecos
-field normally contains comma-separated subfields as follows:
+field normally contains comma
+.Pq Ql \&,
+separated subfields as follows:
.Pp
.Bl -tag -width office -offset indent -compact
.It name
@@ -185,8 +183,7 @@ program and possibly by other applications.
.Pp
The user's home directory is the full
.Tn UNIX
-path name where the user
-will be placed on login.
+path name where the user will be placed on login.
.Pp
The
.Ar shell
@@ -203,17 +200,16 @@ file also supports standard YP exclusions and inclusions, based on user
names and netgroups.
.Pp
Lines beginning with a
-.Dq \&-
+.Ql \&-
(minus sign) are entries marked as being excluded
from any following inclusions, which are marked with a
-.Dq +
+.Ql +
(plus sign).
.Pp
If the second character of the line is a
-.Dq @
-(at sign), the operation
-involves the user fields of all entries in the netgroup specified by the
-remaining characters of the
+.Ql @
+(at sign), the operation involves the user fields of all entries in the
+netgroup specified by the remaining characters of the
.Ar name
field.
Otherwise, the remainder of the
@@ -221,7 +217,7 @@ Otherwise, the remainder of the
field is assumed to be a specific user name.
.Pp
The
-.Dq +
+.Ql +
token may also be alone in the
.Ar name
field, which causes all users from the
@@ -235,16 +231,17 @@ If the entry contains non-empty
or
.Ar gid
fields, the specified numbers will override the information retrieved
-from the YP maps. As well, if the
+from the YP maps.
+As well, if the
.Ar gecos ,
-.Ar dir
+.Ar dir ,
or
.Ar shell
entries contain text, it will override the information included via YP.
On some systems, the
.Ar passwd
-field may also be overridden. It is recommended that the standard
-way to enable YP passwd support in
+field may also be overridden.
+It is recommended that the standard way to enable YP passwd support in
.Pa /etc/master.passwd
is:
.Pp
@@ -257,7 +254,6 @@ will result in
containing:
.Pp
+:*:0:0:::
-.Pp
.Sh SEE ALSO
.Xr chpass 1 ,
.Xr login 1 ,
@@ -286,7 +282,7 @@ script can be used to convert your old-style password
file into a new style password file.
The additional fields
.Dq class ,
-.Dq change
+.Dq change ,
and
.Dq expire
are added, but are turned off by default.