Print this page
293 useradd/del/mod should be ZFS-aware

@@ -12,11 +12,11 @@
 .LP
 .nf
 \fBuseradd\fR [\fB-A\fR \fIauthorization\fR [,\fIauthorization...\fR]]
      [\fB-b\fR \fIbase_dir\fR] [\fB-c\fR \fIcomment\fR] [\fB-d\fR \fIdir\fR] [\fB-e\fR \fIexpire\fR]
      [\fB-f\fR \fIinactive\fR] [\fB-g\fR \fIgroup\fR] [\fB-G\fR \fIgroup\fR [,\fIgroup\fR]...]
-     [\fB-K\fR \fIkey=value\fR] [\fB-m\fR [\fB-k\fR \fIskel_dir\fR]] [\fB-p\fR \fIprojname\fR]
+     [\fB-K\fR \fIkey=value\fR] [\fB-m\fR [\fB-z|-Z\fR] [\fB-k\fR \fIskel_dir\fR]] [\fB-p\fR \fIprojname\fR]
      [\fB-P\fR \fIprofile\fR [,\fIprofile...\fR]] [\fB-R\fR \fIrole\fR [,\fIrole...\fR]]
      [\fB-s\fR \fIshell\fR] [\fB-u\fR \fIuid\fR [\fB-o\fR]] \fIlogin\fR
 .fi
 
 .LP

@@ -26,11 +26,10 @@
      [\fB-f\fR \fIinactive\fR] [\fB-g\fR \fIgroup\fR] [\fB-K\fR \fIkey=value\fR] [\fB-p\fR \fIprojname\fR]
      [\fB-P\fR \fIprofile\fR [,\fIprofile...\fR]] [\fB-R\fR \fIrole\fR [,\fIrole...\fR]]
 .fi
 
 .SH DESCRIPTION
-.sp
 .LP
 \fBuseradd\fR adds a new user to the \fB/etc/passwd\fR and \fB/etc/shadow\fR
 and \fB/etc/user_attr\fR files. The \fB-A\fR and \fB-P\fR options respectively
 assign authorizations and profiles to the user. The \fB-R\fR option assigns
 roles to a user. The \fB-p\fR option associates a project with a user. The

@@ -64,11 +63,10 @@
 To change the action of \fBuseradd\fR when the traditional login name
 length limit of eight characters is exceeded, edit the file
 \fB/etc/default/useradd\fR by removing the \fB#\fR (pound sign) before the
 appropriate \fBEXCEED_TRAD=\fR entry, and adding it before the others.
 .SH OPTIONS
-.sp
 .LP
 The following options are supported:
 .sp
 .ne 2
 .na

@@ -339,17 +337,23 @@
 .RE
 
 .sp
 .ne 2
 .na
-\fB\fB-m\fR\fR
+\fB\fB-m\fR\fR [\fB-z|-Z\fR]
 .ad
 .sp .6
 .RS 4n
 Create the new user's home directory if it does not already exist. If the
 directory already exists, it must have read, write, and execute permissions by
 \fIgroup\fR, where \fIgroup\fR is the user's primary group.
+CHANGE_ZFS_FS option in /etc/default/useradd file determines if ZFS filesystem
+will be created for new user. If this option is set to yes and parent directory
+of user's home directory is ZFS filesystem mount point, a new ZFS filesystem is
+created. \fB-z\fR and \fB-Z\fR options allow overwrite default behavior.
+If \fB-z\fR option is specified, \fBuseradd\fR tries to create new file system
+for user. If \fB-Z\fR option is specified, new file system is not created.
 .RE
 
 .sp
 .ne 2
 .na

@@ -418,11 +422,10 @@
 the next default \fBUID\fR number will be 201. \fBUID\fRs \fB0\fR-\fB99\fR are
 reserved for allocation by the Solaris Operating System.
 .RE
 
 .SH FILES
-.sp
 .LP
 \fB/etc/default/useradd\fR
 .sp
 .LP
 \fB/etc/datemsk\fR

@@ -443,11 +446,10 @@
 \fB/usr/include/limits.h\fR
 .sp
 .LP
 \fB/etc/user_attr\fR
 .SH ATTRIBUTES
-.sp
 .LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
 .sp
 
 .sp

@@ -459,19 +461,17 @@
 _
 Interface Stability     Committed
 .TE
 
 .SH SEE ALSO
-.sp
 .LP
 \fBpasswd\fR(1), \fBprofiles\fR(1), \fBroles\fR(1), \fBusers\fR(1B),
 \fBgroupadd\fR(1M), \fBgroupdel\fR(1M), \fBgroupmod\fR(1M), \fBgrpck\fR(1M),
 \fBlogins\fR(1M), \fBpwck\fR(1M), \fBuserdel\fR(1M), \fBusermod\fR(1M),
 \fBgetdate\fR(3C), \fBauth_attr\fR(4), \fBpasswd\fR(4), \fBprof_attr\fR(4),
 \fBproject\fR(4), \fBuser_attr\fR(4), \fBattributes\fR(5)
 .SH DIAGNOSTICS
-.sp
 .LP
 In case of an error, \fBuseradd\fR prints an error message and exits with a
 non-zero status.
 .sp
 .LP

@@ -543,11 +543,10 @@
 .fi
 .in -2
 .sp
 
 .SH NOTES
-.sp
 .LP
 The \fBuseradd\fR utility adds definitions to only the local \fB/etc/group\fR,
 \fBetc/passwd\fR, \fB/etc/passwd\fR, \fB/etc/shadow\fR, \fB/etc/project\fR, and
 \fB/etc/user_attr\fR files. If a network name service such as \fBNIS\fR or
 \fBNIS+\fR is being used to supplement the local \fB/etc/passwd\fR file with