summaryrefslogtreecommitdiffstats
path: root/pw
diff options
context:
space:
mode:
authorWarren Block <wblock@FreeBSD.org>2016-04-23 22:57:54 +0000
committerWarren Block <wblock@FreeBSD.org>2016-04-23 22:57:54 +0000
commit627721b77ce09502b2d23c44eba53e00ad792d2e (patch)
tree1097aad4f66e0bbd793adb516a7e70c40289b11b /pw
parent18e46072de1bee4d12c5ed5ff012a750e727799a (diff)
downloadpw-darwin-627721b77ce09502b2d23c44eba53e00ad792d2e.tar.gz
pw-darwin-627721b77ce09502b2d23c44eba53e00ad792d2e.tar.zst
pw-darwin-627721b77ce09502b2d23c44eba53e00ad792d2e.zip
Add a single example of adding a user that roughly corresponds with the
adduser example in the Handbook. MFC after: 1 week
Diffstat (limited to 'pw')
-rw-r--r--pw/pw.814
1 files changed, 13 insertions, 1 deletions
diff --git a/pw/pw.8 b/pw/pw.8
index 84ceda3..4cf52b6 100644
--- a/pw/pw.8
+++ b/pw/pw.8
@@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd March 27, 2016
+.Dd April 23, 2016
.Dt PW 8
.Os
.Sh NAME
@@ -954,6 +954,18 @@ Pw default options file
.It Pa /var/log/userlog
User/group modification logfile
.El
+.Sh EXAMPLES
+Add new user Glurmo Smith (gsmith).
+A gsmith login group is created if not already present.
+The login shell is set to
+.Xr csh 1 .
+A new home directory at
+.Pa /home/gsmith
+is created if it does not already exist.
+Finally, a random password is generated and displayed:
+.Bd -literal -offset indent
+pw useradd -n gsmith -c "Glurmo Smith" -s /bin/csh -m -w random
+.Ed
.Sh EXIT STATUS
The
.Nm