More egcs warning fixes:

[pw-darwin.git] / pw / pw.conf.5

diff --git a/pw/pw.conf.5 b/pw/pw.conf.5
index eeea80e142680769376a6f6f4706037d9b07cb7e..06bccb7777e27b6b0ac3dafb105cd80f11f08191 100644 (file)
--- a/pw/pw.conf.5
+++ b/pw/pw.conf.5
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"

-.\"    $Id: pw.conf.5,v 1.1.1.2 1996/12/09 23:55:22 joerg Exp $
+.\"    $Id: pw.conf.5,v 1.7 1997/10/10 06:23:34 charnier Exp $

 .\"
 .Dd December 9, 1996
 .Dt PW.CONF 5
 .\"
 .Dd December 9, 1996
 .Dt PW.CONF 5


@@ -43,9 +43,9 @@ files, allowing users and groups to be added, deleted and changed.
 This file may be modified via the
 .Xr pw 8
 command using the
 This file may be modified via the
 .Xr pw 8
 command using the

-.Ql \&useradd
+.Ar useradd

 command and the
 command and the

-.Ql \&-D
+.Fl D

 option, or by editing it directly with a text editor.
 .Pp
 Each line in
 option, or by editing it directly with a text editor.
 .Pp
 Each line in


@@ -56,16 +56,18 @@ blank lines and lines commencing with a
 character are considered comments, and any remaining lines are
 examined for a leading keyword, followed by corresponding data.
 .Pp
 character are considered comments, and any remaining lines are
 examined for a leading keyword, followed by corresponding data.
 .Pp

-Keywords recognised by 
+Keywords recognized by 

 .Xr pw 8
 are:
 .Bl -tag -width password_days -offset indent -compact
 .It defaultpasswd
 .Xr pw 8
 are:
 .Bl -tag -width password_days -offset indent -compact
 .It defaultpasswd

-affects passwords generated for new users
+affect passwords generated for new users

 .It reuseuids
 reuse gaps in uid sequences
 .It reusegids
 reuse gaps in gid sequences
 .It reuseuids
 reuse gaps in uid sequences
 .It reusegids
 reuse gaps in gid sequences

+.It nispasswd
+path to the NIS passwd database

 .It skeleton
 where to obtain default home contents
 .It newmail
 .It skeleton
 where to obtain default home contents
 .It newmail


@@ -100,16 +102,16 @@ days after which password expires
 .Pp
 Valid values for
 .Ar defaultpasswd
 .Pp
 Valid values for
 .Ar defaultpasswd

-are
+are:

 .Bl -tag -width password_days -offset indent -compact
 .It no
 .Bl -tag -width password_days -offset indent -compact
 .It no

-disables login on newly created accounts
+disable login on newly created accounts

 .It yes
 .It yes

-forces the password to be the account name
+force the password to be the account name

 .It none
 .It none

-forces a blank password
+force a blank password

 .It random
 .It random

-Generates a random password
+generate a random password

 .El
 .Pp
 The second and third options are insecure and should be avoided if
 .El
 .Pp
 The second and third options are insecure and should be avoided if


@@ -122,7 +124,7 @@ The final option causes
 .Xr pw 8
 to respond by printing a randomly generated password on stdout.
 This is the preferred and most secure option.
 .Xr pw 8
 to respond by printing a randomly generated password on stdout.
 This is the preferred and most secure option.

-.Xr pw 8
+.Xr Pw 8

 also provides a method of setting a specific password for the new
 user via a filehandle (command lines are not secure).
 .Pp
 also provides a method of setting a specific password for the new
 user via a filehandle (command lines are not secure).
 .Pp


@@ -152,6 +154,13 @@ user's uid and gid the same.
 If the new user's uid is currently in use as a group id, then the next
 available group id is chosen instead.
 .Pp
 If the new user's uid is currently in use as a group id, then the next
 available group id is chosen instead.
 .Pp

+On NIS servers which maintain a separate passwd database to
+.Pa /etc/master.passwd ,
+this option allows the additional file to be concurrently updated
+as user records are added, modified or removed.
+If blank or set to 'no', no additional database is updated.
+An absolute pathname must be used.
+.Pp

 The
 .Ar skeleton
 keyword nominates a directory from which the contents of a user's
 The
 .Ar skeleton
 keyword nominates a directory from which the contents of a user's


@@ -159,8 +168,8 @@ new home directory is constructed.
 This is
 .Pa /usr/share/skel
 by default.
 This is
 .Pa /usr/share/skel
 by default.

-.Xr pw 8 's
-.Ql \&-m
+.Xr Pw 8 's
+.Fl m

 option causes the user's home directory to be created and populated
 using the files contained in the
 .Ar skeleton
 option causes the user's home directory to be created and populated
 using the files contained in the
 .Ar skeleton


@@ -231,7 +240,7 @@ file.
 This is useful where all users share some resources, and is preferable
 to placing users into the same primary group.
 The effect of this keyword can be overridden using the
 This is useful where all users share some resources, and is preferable
 to placing users into the same primary group.
 The effect of this keyword can be overridden using the

-.Ql \&-G
+.Fl G

 option on the
 .Xr pw 8
 command line.
 option on the
 .Xr pw 8
 command line.


@@ -255,9 +264,9 @@ minimum and maximum respectively.
 The user and group id's actually used when creating an account with
 .Xr pw 8
 may be overridden using the
 The user and group id's actually used when creating an account with
 .Xr pw 8
 may be overridden using the

-.Ql \&-u
+.Fl u

 and
 and

-.Ql \&-g
+.Fl g

 command line options.
 .Pp
 The
 command line options.
 .Pp
 The


@@ -274,7 +283,7 @@ expiration date.
 .Pp
 .Sh LIMITS
 The maximum line length of
 .Pp
 .Sh LIMITS
 The maximum line length of

-.Pa /etc/acct/pw.conf
+.Pa /etc/pw.conf

 is 1024 characters. Longer lines will be skipped and treated
 as comments.
 .Sh FILES
 is 1024 characters. Longer lines will be skipped and treated
 as comments.
 .Sh FILES


@@ -285,10 +294,8 @@ as comments.
 .It Pa /etc/group
 .El
 .Sh SEE ALSO
 .It Pa /etc/group
 .El
 .Sh SEE ALSO

-.Xr pw 8 ,
-.Xr login.conf 5 ,

 .Xr passwd 1 ,
 .Xr passwd 1 ,

+.Xr group 5 ,
+.Xr login.conf 5 ,

 .Xr passwd 5 ,
 .Xr passwd 5 ,

-.Xr group 5
-
-
+.Xr pw 8