1ipa-adduser(1) ipa-adduser(1)
2
3
4
6 ipa-adduser - Add a user
7
8
10 ipa-adduser [OPTION]... user
11
12
14 Adds a user with username user.
15
16
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 -d, --directory=directory
23 Set user's home directory to directory. If this option is not
24 present, a default specified by the freeIPA configuration is
25 used.
26
27 -f, --firstname=givenName
28 Set user's first name to givenName.
29
30 -l, --lastname=familyName
31 Set user's last name to familyName.
32
33 -p, --password=password
34 Set user's password to password.
35
36 -P Prompt for the user's password.
37
38 -s, --shell=shell
39 Set the user's login shell to shell. If this option is not
40 present, a default specified by the freeIPA configuration is
41 used.
42
43 -G, --groups=groups
44 Add this user to one or more groups in groups. groups is a
45 comma-separated list of groups. Each group must already exist.
46
47 -k, --krb-principal=principal
48 Set this user's principal to principal. By default the princi‐
49 pal is set to user.
50
51 -M, --mailAddress=mail
52 Set this user's e-mail address to mail.
53
54 --addattr attr=value
55 Adds value to attribute attr. Attributes set this way are done
56 after other options. If an attribute is listed more than once or
57 already exists in the entry, it is considered a multi-valued
58 attribute and a list of the values is created.
59
60 --setattr attr=value
61 Set attribute attr to value. Any existing value will be replaced
62 with value.
63
64 -v, --verbose
65 Display the XML-RPC request and response for more verbose debug‐
66 ging output.
67
68 The mandatory fields are: user, first name and last name. If any of
69 these are not included on the command line you will be asked interac‐
70 tively.
71
72 The password is asked interactively if not passed on the command-line
73 but it isn't mandatory. Leaving both values blank will leave the pass‐
74 word unset on the account.
75
76 If no options are passed then all questions are asked.
77
79 The exit status is 0 on success, nonzero on error.
80
81
82
83freeipa Oct 10 2007 ipa-adduser(1)