--- pw.8 2001/02/01 16:43:57 1.21 +++ pw.8 2001/02/13 23:50:32 @@ -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 @@ 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 --- pw.c 2000/12/29 18:04:49 1.23 +++ pw.c 2001/02/13 23:16:03 @@ -370,6 +370,15 @@ "usage: pw usernext [switches]\n" "\t-V etcdir alternate /etc location\n" "\t-C config configuration file\n" + "\t-q quiet operation\n", + "usage pw: lock [switches]\n" + "\t-V etcdir alternate /etc locations\n" + "\t-C config configuration file\n" + "\t-q quiet operation\n", + "usage pw: unlock [switches]\n" + "\t-V etcdir alternate /etc locations\n" + "\t-C config configuration file\n" + "\t-q quiet operation\n" }, { "usage: pw groupadd [group|gid] [switches]\n" @@ -409,6 +418,7 @@ "usage: pw groupnext [switches]\n" "\t-V etcdir alternate /etc location\n" "\t-C config configuration file\n" + "\t-q quiet operation\n" } };