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.