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

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/usermod.1m.man.txt
          +++ new/usr/src/man/man1m/usermod.1m.man.txt
   1    1  USERMOD(1M)                  Maintenance Commands                  USERMOD(1M)
   2    2  
   3    3  
   4    4  
   5    5  NAME
   6    6         usermod - modify a user's login information on the system
   7    7  
   8    8  SYNOPSIS
   9    9         usermod [-u uid [-o]] [-g group] [-G group [, group...]]
  10      -            [-d dir [-m]] [-s shell] [-c comment] [-l new_name]
       10 +            [-d dir [-m [-z|-Z]]] [-s shell] [-c comment] [-l new_name]
  11   11              [-f inactive] [-e expire]
  12   12              [-A authorization [, authorization]]
  13   13              [-P profile [, profile]] [-R role [, role]]
  14   14              [-K key=value] login
  15   15  
  16   16  
  17   17  DESCRIPTION
  18   18         The usermod utility modifies a user's login definition on the system.
  19   19         It changes the definition of the specified login and makes the
  20   20         appropriate login-related system file and file system changes.
↓ open down ↓ 74 lines elided ↑ open up ↑
  95   95             normal user.
  96   96  
  97   97             As a role account, no roles (-R or roles=value) can be present.
  98   98  
  99   99  
 100  100         -l new_logname
 101  101             Specify the new login name for the user. See passwd(4) for the
 102  102             requirements for usernames.
 103  103  
 104  104  
 105      -       -m
      105 +       -m [-z|-Z]
 106  106             Move the user's home directory to the new directory specified with
 107  107             the -d option. If the directory already exists, it must have
 108  108             permissions read/write/execute by group, where group is the user's
 109      -           primary group.
      109 +           primary group.  CHANGE_ZFS_FS option in /etc/default/useradd file
      110 +           determines if ZFS filesystem will be created or destroyed during
      111 +           this action. If this option is set to yes and parent directory of
      112 +           user's home directory is ZFS filesystem mount point, a new ZFS
      113 +           filesystem is created. If old user's home directory is a ZFS file
      114 +           system and CHANGE_ZFS_FS is set to yes, the filesystem will be
      115 +           destroyed.  -z and -Z options allow overwrite default behavior. If
      116 +           -z option is specified, usermod tries to create new file system and
      117 +           destroy the old one. If -Z option is specified, new filesystem is
      118 +           not created and the old one is not destroyed.
 110  119  
 111  120  
 112  121         -o
 113  122             This option allows the specified UID to be duplicated (non-unique).
 114  123  
 115  124  
 116  125         -P profile
 117  126             One or more comma-separated rights profiles defined in
 118  127             prof_attr(4). This replaces any existing profile setting in
 119  128             user_attr(4). If an empty profile list is specified, the existing
↓ open down ↓ 156 lines elided ↑ open up ↑
 276  285             Insufficient space to move the home directory (-m option). Other
 277  286             update requests will be implemented.
 278  287  
 279  288  
 280  289         12
 281  290             Unable to complete the move of the home directory to the new home
 282  291             directory.
 283  292  
 284  293  
 285  294  FILES
      295 +       /etc/default/useradd
      296 +           useradd, usermod and userdel configuration file
      297 +
      298 +
 286  299         /etc/group
 287  300             system file containing group definitions
 288  301  
 289  302  
 290  303         /etc/datemsk
 291  304             system file of date formats
 292  305  
 293  306  
 294  307         /etc/passwd
 295  308             system password file
↓ open down ↓ 44 lines elided ↑ open up ↑
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX