16.55. cdist-type__group(7)¶
16.55.1. NAME¶
cdist-type__group - Manage groups
16.55.2. DESCRIPTION¶
This cdist type allows you to create or modify groups on the target.
16.55.3. REQUIRED PARAMETERS¶
None.
16.55.4. OPTIONAL PARAMETERS¶
- state
- absent or present, defaults to present
- gid
- see groupmod(8)
- password
- see above
16.55.5. BOOLEAN PARAMETERS¶
- system
- see groupadd(8), apply only on group creation
16.55.6. 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
16.55.7. 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'
16.55.8. AUTHORS¶
Steven Armstrong <steven-cdist--@--armstrong.cc>
16.55.9. COPYING¶
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.