NAME

       smbldap-useradd - Create a new user

SYNOPSIS

       smbldap-useradd [-abinwPW] [-c comment] [-d home_dir] [-g initial_group] [-m [-k
       skeleton_dir]] [-o user_ou] [-s shell] [-t time] [-u uid] [-A canchange] [-B mustchange]
       [-C smbhome] [-D homedrive] [-E scriptpath] [-F profilepath] [-G group[,...]] [-H
       acctflags] [-M mailaddr[,...]] [-N givenname] [-O mailaddr[,...]] [-S surname] [-T
       mailaddr[,...]] [-X encoding] [-Z name=value[,...]] login

DESCRIPTION

       Creating New Users The smbldap-useradd command creates a new user account using the values
       specified on the command line and the default values from the system and from the
       configuration files (in the /etc/smbldap-tools directory).

       Without any option, the account created will be a Unix (Posix) account. The following
       options may be used to add information:

       -a
          The user will have a Samba account (and Unix).

       -A
          Can change password? 0 if no, 1 if yes.

       -b
          The user is an AIX account.

       -B
          Must change password? 0 if no, 1 if yes.

       -c "comment"
          The new user's comment field (gecos). This option is for gecos only! To set as user's
       full name use the -N and -S options.

       -C sambaHomePath
          SMB home share, like '\\\\PDC-SRV\\homes'.

       -d home_dir
          The new user will be created using home_dir for the user's login directory. The default
       is to append the login name to userHomePrefix (defined in the configuration file) and use
       that as the login directory name.

       -D sambaHomeDrive
          Letter associated with home share, like 'H:'.

       -E sambaLogonScript
          Relative to the [netlogon] share (DOS script to execute on login, like 'foo.bat'.

       -F sambaProfilePath
          Profile directory, like '\\\\PDC-SRV\\profiles\\foo'.

       -g initial_group
          The group name or number of the user's initial login group. The group name must exist.
       A group number must refer to an already existing group. The default group number is
       defined in the configuration file (defaultUserGid="513").

       -G group,[...]
          A list of supplementary groups that the user is also a member of. Each group is
       separated from the next by a comma, with no intervening whitespace. The groups are subject
       to the same restrictions as the group given with the -g option. The default is for the
       user to belong only to the initial group.

       -H sambaAcctFlags
          Spaces and trailing bracket are ignored (samba account control bits like
       '[NDHTUMWSLKI]').

       -i
          Creates an interdomain trust account (machine Workstation). A password will be asked
       for the trust account.

       -k skeletonDir
          When creating the user's home directory, copy files and directories from skeletonDir
       rather than /etc/skel. The -k option is only valid in conjunction with the -m option. The
       default is not to create the directory and not to copy any files.

       -m
          The user's home directory will be created if it does not exist. The files contained in
       skeletonDir will be copied to the home directory if the -k option is used, otherwise the
       files contained in /etc/skel will be used instead.  Any directories contained in
       skeletonDir or /etc/skel will be created in the user's home directory as well.

       -M mail
          E-mail addresses (multiple addresses are separated by commas).

       --non-unique
          Allow the creation of a user account with a duplicate (non-unique) UID.

       -n
          Do not print banner message.

       -N givenname
          Family name. Defaults to username.

       -o node
          The user's account will be created in the specified organizational unit. It is relative
       to the user suffix dn ($usersdn) defined in the configuration file.  Ex: 'ou=admin,ou=all'

       -O localMailAddress
          localMailAddresses (multiple addresses are separated by commas).

       -P
          Ends by invoking smbldap-passwd.

       -p
          Read password from STDIN without verification.

       -s shell
          The name of the user's login shell. The default is to leave this field blank, which
       causes the system to select the default login shell.

       -S surname
          Defaults to username.

       -t time
          Wait <time> seconds before exiting script when adding computer's account. This is
       useful when Master/PDC and Slaves/BDCs are connected through the Internet (replication is
       not real time).

       -T mailToAddress
          Forward address (multiple addresses are separated by commas).

       -u uid
          The numerical value of the user's ID. This value must be unique, unless the
       --non-unique option is used. The value must be non-negative. The default is to use the
       smallest ID value greater than 1000 and greater than every other user.

       -w/-W
          Creates an account for a Samba machine (Workstation), so that it can join a
       sambaDomainName. Normally -w is used for adding machines through Samba but -W can be used
       for manual addition of samba attributes.

       -X encoding
          Specify input encoding for givenname and surname (default UTF-8).

       -Z name=value
          Specify custom LDAP attributes, using comma-separated name=value pairs.

SEE ALSO

       useradd(1)