.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__USER" "7" "Jun 23, 2019" "5.1.2" "cdist"
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH NAME
.sp
cdist\-type__user \- Manage users
.SH DESCRIPTION
.sp
This cdist type allows you to create or modify users on the target.
.SH REQUIRED PARAMETERS
.sp
None.
.SH OPTIONAL PARAMETERS
.INDENT 0.0
.TP
.B state
absent or present, defaults to present
.TP
.B comment
see usermod(8)
.TP
.B home
see above
.TP
.B gid
see above
.TP
.B password
see above
.TP
.B shell
see above
.TP
.B uid
see above
.UNINDENT
.SH BOOLEAN PARAMETERS
.INDENT 0.0
.TP
.B system
see useradd(8), apply only on user create
.TP
.B create\-home
see useradd(8), apply only on user create
.TP
.B remove\-home
see userdel(8), apply only on user delete
.UNINDENT
.SH MESSAGES
.INDENT 0.0
.TP
.B mod
User is modified
.TP
.B add
New user added
.TP
.B userdel \-r
If user was deleted with homedir
.TP
.B userdel
If user was deleted (keeping homedir)
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# Create user account for foobar with operating system default settings
__user foobar

# Same but with a different shell
__user foobar \-\-shell /bin/zsh

# Same but for a system account
__user foobar \-\-system

# Set explicit uid and home
__user foobar \-\-uid 1001 \-\-shell /bin/zsh \-\-home /home/foobar

# Drop user if exists
__user foobar \-\-state absent
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBpw\fP(8), \fBusermod\fP(8)
.SH AUTHORS
.sp
Steven Armstrong <\fI\%steven\-cdist\-\-@\-\-armstrong.cc\fP>
.SH COPYING
.sp
Copyright (C) 2011 Steven Armstrong. You can redistribute it
and/or modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
.SH COPYRIGHT
ungleich GmbH 2019
.\" Generated by docutils manpage writer.
.