X-Git-Url: https://git.cameronkatri.com/pw-darwin.git/blobdiff_plain/f21ffdee49297c31796eb1cf20c5fae902293938..e7e9d20da36ec9757300784f37aed5181d178894:/pw/pw.conf.5 diff --git a/pw/pw.conf.5 b/pw/pw.conf.5 index 7bbd09f..06bccb7 100644 --- a/pw/pw.conf.5 +++ b/pw/pw.conf.5 @@ -1,10 +1,30 @@ -.\" Copyright (c) 1996 -.\" David L. Nugent. -.\" Password/Group file maintenance suite +.\" Copyright (C) 1996 +.\" David L. Nugent. All rights reserved. +.\" +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY DAVID L. NUGENT 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 DAVID L. NUGENT 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. .\" -.\" $Id: pw.conf.5,v 1.2 1996/11/18 03:09:02 davidn Exp $ +.\" $Id: pw.conf.5,v 1.7 1997/10/10 06:23:34 charnier Exp $ .\" -.Dd November 13, 1996 +.Dd December 9, 1996 .Dt PW.CONF 5 .Os .Sh NAME @@ -23,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 -.Ql \&useradd +.Ar useradd command and the -.Ql \&-D +.Fl D option, or by editing it directly with a text editor. .Pp Each line in @@ -36,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 -Keywords recognised by +Keywords recognized by .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 nispasswd +path to the NIS passwd database .It skeleton where to obtain default home contents .It newmail @@ -64,7 +86,7 @@ default shell (without path) default group .It extragroups add new users to this groups -.It loginclass +.It defaultclass place new users in this login class .It minuid .It maxuid @@ -80,16 +102,16 @@ days after which password expires .Pp Valid values for .Ar defaultpasswd -are +are: .Bl -tag -width password_days -offset indent -compact .It no -disables login on newly created accounts +disable login on newly created accounts .It yes -forces the password to be the account name +force the password to be the account name .It none -forces a blank password +force a blank password .It random -Generates a random password +generate a random password .El .Pp The second and third options are insecure and should be avoided if @@ -102,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 +.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 @@ -132,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 +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 @@ -139,8 +168,8 @@ new home directory is constructed. 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 @@ -200,7 +229,7 @@ their own created automatically. This is the recommended procedure for new users as it best secures each user's files against interference by other users of the system irrespective of the -.Em umask . +.Em umask normally used by the user. .Pp .Ar extragroups @@ -211,12 +240,19 @@ 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 -.Ql \&-G -option on -.Xr pw 8 's +.Fl G +option on the +.Xr pw 8 command line. .Pp The +.Ar defaultclass +field determines the login class (See +.Xr login.conf 5 ) +that new users will be allocated unless overwritten by +.Xr pw 8 . +.Pp +The .Ar minuid , .Ar maxuid , .Ar mingid , @@ -228,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 -.Ql \&-u +.Fl u and -.Ql \&-g +.Fl g command line options. .Pp The @@ -247,7 +283,7 @@ expiration date. .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 @@ -258,9 +294,8 @@ as comments. .It Pa /etc/group .El .Sh SEE ALSO -.Xr pw 8 , .Xr passwd 1 , +.Xr group 5 , +.Xr login.conf 5 , .Xr passwd 5 , -.Xr group 5 - - +.Xr pw 8