NAME

       cdist-type__group - Manage groups

DESCRIPTION

       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'

AUTHORS

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

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.