summaryrefslogtreecommitdiffstats
path: root/pw/pw.8
diff options
context:
space:
mode:
authorDima Dorfman <dd@FreeBSD.org>2001-03-14 03:22:28 +0000
committerDima Dorfman <dd@FreeBSD.org>2001-03-14 03:22:28 +0000
commit83da907080674779c85a9f45849b2eda63b6a046 (patch)
tree326b34fdbc536f6ac4799eb5058722ac8216684f /pw/pw.8
parent9369d758bb84ee2649da453e9bf1302525198b99 (diff)
downloadpw-darwin-83da907080674779c85a9f45849b2eda63b6a046.tar.gz
pw-darwin-83da907080674779c85a9f45849b2eda63b6a046.tar.zst
pw-darwin-83da907080674779c85a9f45849b2eda63b6a046.zip
Document the lock and unlock commands.
PR: 25187 Approved by: nik
Diffstat (limited to 'pw/pw.8')
-rw-r--r--pw/pw.832
1 files changed, 32 insertions, 0 deletions
diff --git a/pw/pw.8 b/pw/pw.8
index c5743ee..51ebe19 100644
--- a/pw/pw.8
+++ b/pw/pw.8
@@ -169,6 +169,18 @@
.Ar groupnext
.Op Fl C Ar config
.Op Fl q
+.Nm
+.Op Fl V Ar etcdir
+.Ar lock
+.Op name|uid
+.Op Fl C Ar config
+.Op Fl q
+.Nm
+.Op Fl V Ar etcdir
+.Ar unlock
+.Op name|uid
+.Op Fl C Ar config
+.Op Fl q
.Sh DESCRIPTION
.Nm Pw
is a command-line based editor for the system
@@ -758,6 +770,26 @@ to specify the group id.
The command
.Ar groupnext
returns the next available group id on standard output.
+.Sh USER LOCKING
+.Nm Pw
+supports a simple password locking mechanism for users; it works by
+prepending the string
+.Ql *LOCKED*
+to the beginning of the password field in
+.Pa master.passwd
+to prevent successful authentication.
+.Pp
+The
+.Ar lock
+and
+.Ar unlock
+commands take a user name or uid of the account to lock or unlock,
+respectively. The
+.Ql Fl V ,
+.Ql Fl C ,
+and
+.Ql Fl q
+options as described above are accepted by these commands.
.Sh DIAGNOSTICS
.Nm Pw
returns EXIT_SUCCESS on successful operation, otherwise