47. cdist-type__group(7)¶
Manage groups
Steven Armstrong <steven-cdist--@--armstrong.cc>
47.1. DESCRIPTION¶
This cdist type allows you to create or modify groups on the target.
47.2. REQUIRED PARAMETERS¶
None.
47.3. OPTIONAL PARAMETERS¶
- state
- absent or present, defaults to present
- gid
- see groupmod(8)
- password
- see above
47.4. BOOLEAN PARAMETERS¶
- system
- see groupadd(8), apply only on group creation
47.5. MESSAGES¶
- mod
- group is modified
- add
- New group added
- remove
- group is removed
- change <property> <new_value> <current_value>
- Changed group property from current_value to new_value
- set <property> <new_value>
- set property to new value, property was not set before
47.6. EXAMPLES¶
# Create a group 'foobar' with operating system default settings
__group foobar
# Remove the 'foobar' group
__group foobar --state absent
# Create a system group 'myservice' 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 'crypted-password-string'
47.7. SEE ALSO¶
47.8. COPYING¶
Copyright (C) 2011-2015 Steven Armstrong. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).