.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__GROUP" "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__group \- Manage groups
.SH DESCRIPTION
.sp
This cdist type allows you to create or modify groups 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 gid
see groupmod(8)
.TP
.B password
see above
.UNINDENT
.SH BOOLEAN PARAMETERS
.INDENT 0.0
.TP
.B system
see groupadd(8), apply only on group creation
.UNINDENT
.SH MESSAGES
.INDENT 0.0
.TP
.B mod
group is modified
.TP
.B add
New group added
.TP
.B remove
group is removed
.TP
.B change <property> <new_value> <current_value>
Changed group property from current_value to new_value
.TP
.B set <property> <new_value>
set property to new value, property was not set before
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
# Create a group \(aqfoobar\(aq with operating system default settings
__group foobar

# Remove the \(aqfoobar\(aq group
__group foobar \-\-state absent

# Create a system group \(aqmyservice\(aq with operating system default settings
__group myservice \-\-system

# Same but with a specific gid
__group foobar \-\-gid 1234

# Same but with a gid and password
__group foobar \-\-gid 1234 \-\-password \(aqcrypted\-password\-string\(aq
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHORS
.sp
Steven Armstrong <\fI\%steven\-cdist\-\-@\-\-armstrong.cc\fP>
.SH COPYING
.sp
Copyright (C) 2011\-2015 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.
.