[src/trunk]: src/usr.sbin/pwd_mkdb Clean up previous.

[ad <ad%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/6d80db482b03
branches:  trunk
changeset: 513974:6d80db482b03
user:      ad <ad%NetBSD.org@localhost>
date:      Sun Aug 19 09:01:47 2001 +0000

description:
Clean up previous.

diffstat:

 usr.sbin/pwd_mkdb/pwd_mkdb.8 |  28 ++++++++++++++--------------
 1 files changed, 14 insertions(+), 14 deletions(-)

diffs (54 lines):

diff -r c16f5c7fce3e -r 6d80db482b03 usr.sbin/pwd_mkdb/pwd_mkdb.8
--- a/usr.sbin/pwd_mkdb/pwd_mkdb.8      Sun Aug 19 07:29:26 2001 +0000
+++ b/usr.sbin/pwd_mkdb/pwd_mkdb.8      Sun Aug 19 09:01:47 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pwd_mkdb.8,v 1.17 2001/08/18 19:29:31 ad Exp $
+.\"    $NetBSD: pwd_mkdb.8,v 1.18 2001/08/19 09:01:47 ad Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -84,7 +84,7 @@
 .It Fl u Ar name
 Don't re-build the database files, but instead modify or add entries for the
 specified user only.  This option may only be used when the line number and
-user name in the password file have not changed, or when adding new user
+user name in the password file have not changed, or when adding a new user
 from the last line in the password file.
 .El
 .Pp
@@ -135,8 +135,19 @@
 .Xr vipw 8
 handle the locking necessary to avoid this problem.
 .Pp
+The database files are copied when the
+.Fl u
+option is used.  Real locking would make this unnecessary.
+.Pp
 Although the DB format is endian-transparent, the data stored in the DB is
-not.  This is difficult to fix without breaking compatibility.
+not.  Also, the format doesn't lend itself to insertion or removal of
+records from arbitrary locations in the password file.  This is difficult to
+fix without breaking compatibility.
+.Pp
+Using the
+.Fl u
+option on a system where multiple users share the same UID can have
+unexpected results.
 .Sh COMPATIBILITY
 Previous versions of the system had a program similar to
 .Nm
@@ -157,14 +168,3 @@
 .Xr userdel 8 ,
 .Xr usermod 8 ,
 .Xr vipw 8
-.Sh BUGS
-The database format should be changed so that inserting or removing records
-from arbitrary locations in the password file is possible.
-.Pp
-Strange things can happen when the
-.Fl u
-option is used and multiple users share the same UID.
-.Pp
-The database files are copied when the
-.Fl u
-option is used.  Locking would make this unnecessary.