luser - Add an user
luseradd [OPTION]... user
Adds an user with name user.
Set the GECOS field to gecos. The GECOS field is traditionally
used to store user’s real name and other information.
Set user’s home directory to directory. If this option is not
present, a default specified by libuser configuration is used.
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.
Ask all questions when connecting to the user database, even if
default answers are set up in libuser configuration.
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 con-
figuration does not specify a default, is used.
Don’t create a home directory and a mail spool for the newly
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.
Set user’s password to password. Note that the password can be
viewed while running luseradd using tools such as ps(1).
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).
The user is a system user. Users that are not marked as system
user usually have automatically selected user IDs above a cer-
tain value (500 by default). This information is also passed to
the libuser backends. This option implies the -M option.
Set user’s login shell to shell. If this option is not present,
a default specified by libuser configuration is used.
Use user ID uid for the newly created user. An user ID is
selected automatically if this option is not present.
The exit status is 0 on success, nonzero on error.
libuser Jan 12 2005 luseradd(1)
Man(1) output converted with