summaryrefslogtreecommitdiffstats
path: root/usr.sbin/pw
diff options
context:
space:
mode:
authordd <dd@FreeBSD.org>2001-03-14 03:22:28 +0000
committerdd <dd@FreeBSD.org>2001-03-14 03:22:28 +0000
commitbfdb3b217bb9e55a2b92a6f33638832a06fd5838 (patch)
tree3772a77ef55461b6842e892782d2be8f4f231623 /usr.sbin/pw
parente925ab37f797efec7217f803788f45ae41fe61bb (diff)
downloadFreeBSD-src-bfdb3b217bb9e55a2b92a6f33638832a06fd5838.zip
FreeBSD-src-bfdb3b217bb9e55a2b92a6f33638832a06fd5838.tar.gz
Document the lock and unlock commands.
PR: 25187 Approved by: nik
Diffstat (limited to 'usr.sbin/pw')
-rw-r--r--usr.sbin/pw/pw.832
1 files changed, 32 insertions, 0 deletions
diff --git a/usr.sbin/pw/pw.8 b/usr.sbin/pw/pw.8
index c5743ee..51ebe19 100644
--- a/usr.sbin/pw/pw.8
+++ b/usr.sbin/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
OpenPOWER on IntegriCloud