diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-03-11 19:39:46 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 1999-03-11 19:39:46 +0000 |
commit | 0f19f5dba157291a0ce304b76c3c2f8253705cfb (patch) | |
tree | 7b03ce8fc335a688b2d8c4836dae657f24f3025f /usr.sbin/pwd_mkdb/pwd_mkdb.8 | |
parent | 0d6963c57098b493eecba92752f863a2de60b70a (diff) |
cleanup
Diffstat (limited to 'usr.sbin/pwd_mkdb/pwd_mkdb.8')
-rw-r--r-- | usr.sbin/pwd_mkdb/pwd_mkdb.8 | 48 |
1 files changed, 25 insertions, 23 deletions
diff --git a/usr.sbin/pwd_mkdb/pwd_mkdb.8 b/usr.sbin/pwd_mkdb/pwd_mkdb.8 index 8615ded314c..d4570a40f5c 100644 --- a/usr.sbin/pwd_mkdb/pwd_mkdb.8 +++ b/usr.sbin/pwd_mkdb/pwd_mkdb.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: pwd_mkdb.8,v 1.4 1998/06/03 06:44:25 deraadt Exp $ +.\" $OpenBSD: pwd_mkdb.8,v 1.5 1999/03/11 19:39:40 aaron Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -40,23 +40,23 @@ .Nm pwd_mkdb .Nd "generate the password databases" .Sh SYNOPSIS -.Nm pwd_mkdb +.Nm .Op Fl c .Op Fl p .Op Fl d Ar directory .Ar file .Sh DESCRIPTION -.Nm Pwd_mkdb +.Nm creates .Xr db 3 style secure and insecure databases for the specified file. These databases are then installed into -.Dq Pa /etc/spwd.db +.Pa /etc/spwd.db and -.Dq Pa /etc/pwd.db +.Pa /etc/pwd.db , respectively. The file is installed into -.Dq Pa /etc/master.passwd . +.Pa /etc/master.passwd . The file must be in the correct format (see .Xr passwd 5 ) . It is important to note that the format used in this system is @@ -69,10 +69,10 @@ Check if the password file is in the correct format. Do not change, add, or remove any files. .It Fl p Create a Version 7 style password file and install it into -.Dq Pa /etc/passwd . -.It Fl d +.Pa /etc/passwd . +.It Fl d Ar directory Operate in a base directory other than the default of -.Dq Pa /etc . +.Pa /etc . .It Ar file The absolute path to a file in .Ar master.passwd @@ -81,48 +81,49 @@ format, as described in .El .Pp The two databases differ in that the secure version contains the user's -encrypted password and the insecure version has an asterisk (``*'') +encrypted password and the insecure version has an asterisk +.Pq Sq \&* . .Pp The databases are used by the C library password routines (see .Xr getpwent 3 ) . .Pp -.Nm Pwd_mkdb +.Nm exits zero on success, non-zero on failure. .Sh FILES -.Bl -tag -width Pa -compact +.Bl -tag -width /etc/master.passwd -compact .It Pa /etc/master.passwd -The current password file. +current password file .It Pa /etc/passwd -A Version 7 format password file. +a Version 7 format password file .It Pa /etc/pwd.db -The insecure password database file. +insecure password database file .It Pa /etc/pwd.db.tmp -A temporary file. +temporary file .It Pa /etc/spwd.db -The secure password database file. +secure password database file .It Pa /etc/spwd.db.tmp -A temporary file. +temporary file .El .Sh BUGS Because of the necessity for atomic update of the password files, -.Nm pwd_mkdb +.Nm uses .Xr rename 2 to install them. This, however, requires that the file specified on the command line live on the same file system as the -.Dq Pa /etc +.Pa /etc directory. .Pp There are the obvious races with multiple people running -.Nm pwd_mkdb +.Nm on different password files at the same time. The front-ends to .Nm pwd_mkdb , .Xr chpass 1 , -.Xr passwd 1 +.Xr passwd 1 , and -.Xr vipw 8 , +.Xr vipw 8 handle the locking necessary to avoid this problem. .Sh COMPATIBILITY Previous versions of the system had a program similar to @@ -141,3 +142,4 @@ not be surprised by the changes in functionality. .Xr getpwent 3 , .Xr passwd 5 , .Xr vipw 8 + |