summaryrefslogtreecommitdiff
path: root/usr.sbin/pwd_mkdb/pwd_mkdb.8
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>1999-03-11 19:39:46 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>1999-03-11 19:39:46 +0000
commit0f19f5dba157291a0ce304b76c3c2f8253705cfb (patch)
tree7b03ce8fc335a688b2d8c4836dae657f24f3025f /usr.sbin/pwd_mkdb/pwd_mkdb.8
parent0d6963c57098b493eecba92752f863a2de60b70a (diff)
cleanup
Diffstat (limited to 'usr.sbin/pwd_mkdb/pwd_mkdb.8')
-rw-r--r--usr.sbin/pwd_mkdb/pwd_mkdb.848
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
+