16.58. cdist-type__group(7)

16.58.1. NAME

cdist-type__group - Manage groups

16.58.2. DESCRIPTION

This cdist type allows you to create or modify groups on the target.

16.58.3. REQUIRED PARAMETERS

None.

16.58.4. OPTIONAL PARAMETERS

state

absent or present, defaults to present

gid

see groupmod(8)

password

see above

16.58.5. BOOLEAN PARAMETERS

system

see groupadd(8), apply only on group creation

16.58.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.58.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.58.8. AUTHORS

Steven Armstrong <steven-cdist--@--armstrong.cc>

16.58.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.