cdist-type__group(7)

Overview

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

Required parameters

None.

Optional parameters

state: absent or present, defaults to present

gid: see groupmod(8)

password: see above

Boolean parameters

system: see groupadd(8), apply only on group creation

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

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'

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.

History

Debian 13 (Trixie): the text shown here
Debian 12 (Bookworm)
Debian 11 (Bullseye)
Debian 10 (Buster)
Debian 9 (Stretch)