summaryrefslogtreecommitdiffstats
path: root/ipa-admintools/man/ipa-adduser.1
blob: abf1485a4e4b753664a173a0b60d0358991ee15e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
.\" A man page for ipa-adduser
.\" Copyright (C) 2007 Red Hat, Inc.
.\" 
.\" This is free software; you can redistribute it and/or modify it under
.\" the terms of the GNU Library General Public License as published by
.\" the Free Software Foundation; version 2 only
.\" 
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" General Public License for more details.
.\" 
.\" You should have received a copy of the GNU Library General Public
.\" License along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\" 
.\" Author: Rob Crittenden <rcritten@redhat.com>
.\" 
.TH "ipa-adduser" "1" "Oct 10 2007" "freeipa" ""
.SH "NAME"
ipa\-adduser \- Add a user

.SH "SYNOPSIS"
ipa\-adduser [\fIOPTION\fR]... \fIuser\fR

.SH "DESCRIPTION"
Adds a user with username \fIuser\fR.

.SH "OPTIONS"
.TP 
\fB\-c\fR, \fB\-\-gecos\fR=\fIgecos\fR
Set the \f[SM]GECOS\fR field to \fIgecos\fR.
The \f[SM]GECOS\fR field is traditionally used to store user's real name and other information.
.TP 
\fB\-d\fR, \fB\-\-directory\fR=\fIdirectory\fR
Set user's home directory to \fIdirectory\fR.
If this option is not present, a default specified by the
.B freeIPA configuration is used.
.TP 
\fB\-f\fR, \fB\-\-firstname\fR=\fIgivenName\fR
Set user's first name to \fIgivenName\fR.
.TP 
\fB\-l\fR, \fB\-\-lastname\fR=\fIfamilyName\fR
Set user's last name to \fIfamilyName\fR.
.TP 
\fB\-p\fR, \fB\-\-password\fR=\fIpassword\fR
Set user's password to \fIpassword\fR.
.TP 
\fB\-s\fR, \fB\-\-shell\fR=\fIshell\fR
Set the user's login shell to \fIshell\fR.
If this option is not present, a default specified by the
.B freeIPA configuration is used.
.TP 
\fB\-G\fR, \fB\-\-groups\fR=\fIgroups\fR
Add this user to one or more groups in \fIgroups\fR.
\fIgroups\fR is a comma\-separated list of groups.
Each \fIgroup\fR must already exist.
.TP 
\fB\-k\fR, \fB\-\-krb\-principal\fR=\fIprincipal\fR
Set this user's principal to \fIprincipal\fR.
By default the principal is set to \fBuser\fR.
.TP 
\fB\-M\fR, \fB\-\-mailAddress\fR=\fImail\fR
Set this user's e\-mail address to \fImail\fR.
.PP 
The mandatory fields are: user, first name, last name and password. If any of these are not included on the command line you will be asked interactively.

If no options are passed then all questions are asked.
.SH "EXIT STATUS"
The exit status is 0 on success, nonzero on error.