1luseradd(1) General Commands Manual luseradd(1)
2
6 luseradd - Add an user
7
10 luseradd [OPTION]... user
11
14 Adds an user with name user.
15
18 -c, --gecos=gecos
19 Set the GECOS field to gecos. The GECOS field is traditionally
20 used to store user's real name and other information.
21 -d, --directory=directory
24 Set user's home directory to directory. If this option is not
25 present, a default specified by libuser configuration is used.
26 -g, --gid=group
29 Set user's primary group to group. group can either be a group
30 ID of an existing group, or a group name; if group is a group
31 name and the group does not exist, it is created. If the --gid
32 option is not specified, the default group name is user.
33 -i, --interactive
36 Ask all questions when connecting to the user database, even if
37 default answers are set up in libuser configuration.
38 -k, --skeleton=directory
41 Populate the newly created user's home directory with a copy of
42 directory. If this option is not present, a default directory
43 specified by libuser configuration, or /etc/skel if libuser con‐
44 figuration does not specify a default, is used.
45 -M, --nocreatehome
48 Don't create a home directory and a mail spool for the newly
49 created user.
50 -n, --nocreategroup
53 If a group is not specified using -g, use group name "users"
54 instead of user. Note that despite the name of the option, the
55 group will still be created if it does not exist.
56 -P, --plainpassword=password
59 Set user's password to password. Note that the password can be
60 viewed while running luseradd using tools such as ps(1).
61 -p, --password=encrypted
64 Set user's password to the password represented by the hash
65 encrypted. Note that the hash can be viewed while running
66 luseradd using tools such as ps(1).
67 -r, --reserved
70 The user is a system user. Users that are not marked as system
71 user usually have automatically selected user IDs above a cer‐
72 tain value (500 by default). This information is also passed to
73 the libuser backends. This option implies the -M option.
74 -s, --shell=shell
77 Set user's login shell to shell. If this option is not present,
78 a default specified by libuser configuration is used.
79 -u, --uid=uid
82 Use user ID uid for the newly created user. An user ID is
83 selected automatically if this option is not present.
84 --commonname=name
87 Use common name name for the newly created user. This attribute
88 is only supported in some backends (e.g.LDAP), and its support
89 may have further limitations (e.g. LDAP schema rules).
90 --givenname=name
93 Use given name name for the newly created user. This attribute
94 is only supported in some backends (e.g.LDAP), and its support
95 may have further limitations (e.g. LDAP schema rules).
96 --homephone=phone
99 Use home telephone number phone for the newly created user.
100 This attribute is only supported in some backends (e.g.LDAP),
101 and its support may have further limitations (e.g. LDAP schema
102 rules).
103 --roomnumber=room
106 Use room number room for the newly created user. This attribute
107 is only supported in some backends (e.g.LDAP), and its support
108 may have further limitations (e.g. LDAP schema rules).
109 --surname=name
112 Use surname name for the newly created user. This attribute is
113 only supported in some backends (e.g.LDAP), and its support may
114 have further limitations (e.g. LDAP schema rules).
115 --telephonenumber=phone
118 Use telephone number phone for the newly created user. This
119 attribute is only supported in some backends (e.g.LDAP), and its
120 support may have further limitations (e.g. LDAP schema rules).
121
124 The exit status is 0 on success, nonzero on error.
125libuser 2009-12-09 luseradd(1)