CDIST-TYPE__GROUP(7)

💖 cdist-type__group 💖

okay bestie, gather round, because this is the cdist-type__group page from the cdist manual and it's literally the group-management icon we all needed 🎀

---

✨ NAME ✨

cdist-type__group — manage groups, fr fr 👑

---

🌸 DESCRIPTION 🌸

so the tea is: this cdist type lets you create or modify groups on the target. that's it, that's the vibe. new group? modified group? she handles it. periodt. 💅

---

🧚 REQUIRED PARAMETERS 🧚

None. like, zero. nothing. she asks for nothing and gives you everything. main character energy honestly 🫶

---

🎀 OPTIONAL PARAMETERS 🎀

• state — either absent or present, and if you just don't say anything it defaults to present ✨ (so she shows up by default, as she should)
• gid — see groupmod(8) for the deets 🍓
• password — see above 👆 (yes bestie, same energy as the line right before it)

---

🌈 BOOLEAN PARAMETERS 🌈

• system — see groupadd(8). heads up though: this one only applies on group creation, so if the group already exists she's not gonna retroactively make it a system group, no cap 🚫

---

💜 MESSAGES 💜

these are the lil status updates she sends you, like read receipts but for groups 📬

• 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 ⭐

copy these exactly bestie, no typos, we're being precise today 🎯

# 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> — we stan 💖

---

🦋 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. 🌸

yes the license text is long, but bestie, it's important, don't skip it 🙈

---

💀 COPYRIGHT 💀

ungleich GmbH 2021</purl> — wait, typo, ungleich GmbH 2021 💜

---

and that's the whole page!! this was cdist-type__group, version 7.0.0, dated Jul 31, 2022, from the cdist manual 💅 slay, go make some groups, ily, bye 🎀✨🦋