luseradd

Section: User Commands (1)
Updated: Jan 12 2005
Index Return to Main Contents

 

NAME

luseradd - Add an user

 

SYNOPSIS

luseradd [OPTION]... user

 

DESCRIPTION

Adds an user with name user.

 

OPTIONS

-c, --gecos=gecos
Set the SM]GECOS field to gecos. The SM]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.