---
name: "cdist-type__group"
section: "7"
platform: "linux"
package: "cdist"
version: "7.0.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cdist-type__group"
---

# cdist-type\_\_group(7)

Manage groups

## 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)](/groupmod/8.md)

- **password**

  see above

## BOOLEAN PARAMETERS

- **system**

  see [groupadd(8)](/groupadd/8.md), 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.

## COPYRIGHT

ungleich GmbH 2021