luseradd(1)

NAME
luseradd - Add an user

SYNOPSIS
luseradd [OPTION]... user

DESCRIPTION
Adds an user with name user.

OPTIONS

-c, --gecos=gecos
    Set the GECOS field to gecos. The GECOS field is traditionally used to store user's real name and other information.

-d, --directory=directory
    Set user's home directory to directory. If this option is not present, a default specified by libuser configuration is used.

-g, --gid=group
    Set user's primary group to group. group can either be a group ID of an existing group, or a group name; if group is a group name and the group does not exist, it is created. If the --gid option is not specified, the default group name is user.

-i, --interactive
    Ask all questions when connecting to the user database, even if default answers are set up in libuser configuration.

-k, --skeleton=directory
    Populate the newly created user's home directory with a copy of directory. If this option is not present, a default directory specified by libuser configuration, or /etc/skel if libuser configuration does not specify a default, is used.

-M, --nocreatehome
    Don't create a home directory and a mail spool for the newly created user.

-n, --nocreategroup
    If a group is not specified using -g, use group name "users" instead of user. Note that despite the name of the option, the group will still be created if it does not exist.

-P, --plainpassword=password
    Set user's password to password. Note that the password can be viewed while running luseradd using tools such as ps(1).

-p, --password=encrypted
    Set user's password to the password represented by the hash encrypted. Note that the hash can be viewed while running luseradd using tools such as ps(1).

-r, --reserved
    The user is a system user. Users that are not marked as system user usually have automatically selected user IDs above a certain value (500 by default). This information is also passed to the libuser backends. This option implies the -M option.

-s, --shell=shell
    Set user's login shell to shell. If this option is not present, a default specified by libuser configuration is used.

-u, --uid=uid
    Use user ID uid for the newly created user. An user ID is selected automatically if this option is not present.

EXIT STATUS
The exit status is 0 on success, nonzero on error.