Forbid adding duplicate users with the name of "0".

[pw-darwin.git] / chpass / chpass.1

diff --git a/chpass/chpass.1 b/chpass/chpass.1
index 615751b4dd29a008fa75fa0d120e0748dd847b3c..c48967a0b49c7c97725bd8df77ac846acb398c5f 100644 (file)
--- a/chpass/chpass.1
+++ b/chpass/chpass.1
@@ -44,14 +44,14 @@
 .Nm ypchsh
 .Nd add or change user database information
 .Sh SYNOPSIS
-.Nm chpass
+.Nm
 .Op Fl a Ar list
 .Op Fl p Ar encpass
 .Op Fl e Ar expiretime
 .Op Fl s Ar newshell
 .Op user
 .Pp
-.Nm chpass
+.Nm
 .Op Fl oly
 .Op Fl a Ar list
 .Op Fl p Ar encpass
@@ -80,7 +80,7 @@ entry, in the format specified by
 .Xr passwd 5 ,
 as an argument.
 This argument must be a colon
-.Pq Dq \:
+.Pq Dq \&:
 separated list of all the
 user database fields, although they may be empty.
 .It Fl p
@@ -89,7 +89,8 @@ in the format used by
 .Xr crypt 3 ,
 as an argument.
 .It Fl e Ar expiretime
-Change the account expire time. This option is used to set the expire time
+Change the account expire time.
+This option is used to set the expire time
 from a script as if it was done in the interactive editor.
 .It Fl s Ar newshell
 Attempt to change the user's shell to
@@ -157,7 +158,9 @@ entries, and that one by random selection.
 The
 .Ar group
 field is the group that the user will be placed in at login.
-Since BSD supports multiple groups (see
+Since
+.Bx
+supports multiple groups (see
 .Xr groups 1 )
 this field currently has little special meaning.
 This field may be filled in with either a number or a group name (see
@@ -166,7 +169,7 @@ This field may be filled in with either a number or a group name (see
 The
 .Ar class
 field references class descriptions in
-.Ar /etc/login.conf
+.Pa /etc/login.conf
 and is typically used to initialize the user's system resource limits
 when they login.
 .Pp
@@ -204,7 +207,7 @@ gcos fields (typically used for site specific user information).
 Note that
 .Xr finger 1
 will display the office location and office phone together under the
-heading 
+heading
 .Ar Office: .
 .Pp
 The user's
@@ -259,18 +262,20 @@ Currently,
 can only make changes to the NIS passwd maps through
 .Xr rpc.yppasswdd 8 ,
 which normally only permits changes to a user's password, shell and GECOS
-fields. Except when invoked by the super-user on the NIS master server,
+fields.
+Except when invoked by the super-user on the NIS master server,
 .Nm
 (and, similarly,
 .Xr passwd 1 )
-can not use the
+cannot use the
 .Xr rpc.yppasswdd 8
 server to change other user information or
 add new records to the NIS passwd maps.
 Furthermore,
 .Xr rpc.yppasswdd 8
 requires password authentication before it will make any
-changes. The only user allowed to submit changes without supplying
+changes.
+The only user allowed to submit changes without supplying
 a password is the super-user on the NIS master server; all other users,
 including those with root privileges on NIS clients (and NIS slave
 servers) must enter a password.
@@ -308,11 +313,13 @@ change any field.
 .Em "Password authentication is required" .
 .Nm Chpass
 will prompt for the user's NIS password before effecting
-any changes. If the password is invalid, all changes will be
+any changes.
+If the password is invalid, all changes will be
 discarded.
 .Pp
 Exception: the super-user on the NIS master server is allowed to
-submit changes without supplying a password. (The super-user may
+submit changes without supplying a password.
+(The super-user may
 choose to turn off this feature using the
 .Fl o
 flag, described below.)
@@ -345,7 +352,8 @@ Users should use
 .Xr passwd 1
 or
 .Xr yppasswd 1
-to change their NIS passwords. The super-user is allowed to specify
+to change their NIS passwords.
+The super-user is allowed to specify
 a new password (even though the
 .Dq Password:
 field does not show
@@ -357,7 +365,7 @@ will refuse to update the NIS maps.
 .Pp
 Exception: the super-user on the NIS master server is permitted to
 change a user's NIS password with
-.Nm Ns .
+.Nm .
 .El
 .Pp
 There are also a few extra option flags that are available when
@@ -381,26 +389,30 @@ Specify a particular NIS domain.
 .Nm Chpass
 uses the system domain name by default, as set by the
 .Xr domainname 1
-command. The
+command.
+The
 .Fl d
 option can be used to override a default, or to specify a domain
 when the system domain name is not set.
 .It Fl h Ar host
-Specify the name or address of an NIS server to query. Normally,
+Specify the name or address of an NIS server to query.
+Normally,
 .Nm
 will communicate with the NIS master host specified in the
 .Pa master.passwd
 or
 .Pa passwd
-maps. On hosts that have not been configured as NIS clients, there is
+maps.
+On hosts that have not been configured as NIS clients, there is
 no way for the program to determine this information unless the user
-provides the hostname of a server. Note that the specified hostname need
+provides the hostname of a server.
+Note that the specified hostname need
 not be that of the NIS master server; the name of any server, master or
 slave, in a given NIS domain will do.
 .Pp
 When using the
 .Fl d
-option, the hostname defaults to 
+option, the hostname defaults to
 .Dq localhost .
 The
 .Fl h
@@ -422,10 +434,10 @@ domain socket). The
 .Fl o
 flag can be used to force
 .Nm
-to use the standard update mechanism instead. This option is provided
+to use the standard update mechanism instead.
+This option is provided
 mainly for testing purposes.
 .El
-.Pp
 .Sh FILES
 .Bl -tag -width /etc/master.passwd -compact
 .It Pa /etc/master.passwd
@@ -461,11 +473,11 @@ The
 and
 .Xr ypchsh 1
 commands are really only links to
-.Nm Ns .
+.Nm .
 .Sh BUGS
 User information should (and eventually will) be stored elsewhere.
 .Sh HISTORY
 The
-.Nm chpass
-command appeared in 
+.Nm
+command appeared in
 .Bx 4.3 Reno .