1luseradd(1)                 General Commands Manual                luseradd(1)
2
3
4

NAME

6       luser - Add an user
7
8

SYNOPSIS

10       luseradd [OPTION]... user
11
12

DESCRIPTION

14       Adds an user with name user.
15
16

OPTIONS

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
22
23       -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
27
28       -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
34
35       -i, --interactive
36              Ask all questions when connecting to the user database, even  if
37              default answers are set up in libuser configuration.
38
39
40       -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
46
47       -M, --nocreatehome
48              Don't create a home directory and a mail  spool  for  the  newly
49              created user.
50
51
52       -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
57
58       -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
62
63       -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
68
69       -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
75
76       -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
80
81       -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
85

EXIT STATUS

87       The exit status is 0 on success, nonzero on error.
88
89
90
91libuser                           Jan 12 2005                      luseradd(1)