1SSS_USERADD(8) SSSD Manual pages SSS_USERADD(8)
2
3
4
6 sss_useradd - create a new user
7
9 sss_useradd [options] LOGIN
10
12 sss_useradd creates a new user account using the values specified on
13 the command line plus the default values from the system.
14
16 -u,--uid UID
17 Set the UID of the user to the value of UID. If not given, it is
18 chosen automatically.
19
20 -c,--gecos COMMENT
21 Any text string describing the user. Often used as the field for
22 the user´s full name.
23
24 -h,--home HOME_DIR
25 The home directory of the user account. The default is to append
26 the LOGIN name to /home and use that as the home directory. The
27 base that is prepended before LOGIN is tunable with
28 “user_defaults/baseDirectory” setting in sssd.conf.
29
30 -s,--shell SHELL
31 The user´s login shell. The default is currently /bin/bash. The
32 default can be changed with “user_defaults/defaultShell” setting in
33 sssd.conf.
34
35 -G,--groups GROUPS
36 A list of existing groups this user is also a member of.
37
38 -m,--create-home
39 Create the user´s home directory if it does not exist. The files
40 and directories contained in the skeleton directory (which can be
41 defined with the -k option or in the config file) will be copied to
42 the home directory.
43
44 -M,--no-create-home
45 Do not create the user´s home directory. Overrides configuration
46 settings.
47
48 -k,--skel SKELDIR
49 The skeleton directory, which contains files and directories to be
50 copied in the user´s home directory, when the home directory is
51 created by sss_useradd.
52
53 Special files (block devices, character devices, named pipes and
54 unix sockets) will not be copied.
55
56 This option is only valid if the -m (or --create-home) option is
57 specified, or creation of home directories is set to TRUE in the
58 configuration.
59
60 -Z,--selinux-user SELINUX_USER
61 The SELinux user for the user´s login. If not specified, the system
62 default will be used.
63
64 -?,--help
65 Display help message and exit.
66
68 In order to function correctly, a domain with “id_provider=local” must
69 be created and the SSSD must be running.
70
71 The administrator might want to use the SSSD local users instead of
72 traditional UNIX users in cases where the group nesting (see
73 sss_groupadd(8)) is needed. The local users are also useful for testing
74 and development of the SSSD without having to deploy a full remote
75 server. The sss_user* and sss_group* tools use a local LDB storage to
76 store users and groups.
77
79 sssd(8), sssd.conf(5), sssd-ldap(5), sssd-krb5(5), sssd-simple(5),
80 sssd-ipa(5), sssd-ad(5), sssd-sudo(5), sss_cache(8), sss_debuglevel(8),
81 sss_groupadd(8), sss_groupdel(8), sss_groupshow(8), sss_groupmod(8),
82 sss_useradd(8), sss_userdel(8), sss_usermod(8), sss_obfuscate(8),
83 sss_seed(8), sssd_krb5_locator_plugin(8), sss_ssh_authorizedkeys(8),
84 sss_ssh_knownhostsproxy(8), sssd-ifp(5), pam_sss(8). sss_rpcidmapd(5)
85
87 The SSSD upstream - http://fedorahosted.org/sssd
88
89
90
91SSSD 01/15/2019 SSS_USERADD(8)