CDIST-TYPE__USER(7)

📦
version 7.0.0 · 8 versions
, in fedora 43, fedora 44

💖 cdist-type__user 💖

okay bestie, welcome to cdist-type__user from the cdist manual pages — this is the one that handles all your user accounts on the target machine, and honestly? it's giving main character energy. no cap. ✨

🌸 NAME 🌸

cdist-type__user — manage users 👑💅

✨ DESCRIPTION ✨

so literally, this cdist type lets you create or modify users on the target. that's the whole vibe. new user? slay. tweak an existing one? also slay. 🫶

🎀 REQUIRED PARAMETERS 🎀

None. zero. nada. you don't have to pass anything, she just works. 💖

🌈 OPTIONAL PARAMETERS 🌈

these are the little extras you can pass if you want to be specific about it. iykyk.

  • state — either absent or present, and it defaults to present. so if you don't say anything, bestie is getting created. periodt.
  • comment — see usermod(8). go read that if you want the deets. 📖
  • home — see above 👆 (same deal as comment, okurrr)
  • gid — see above 👆
  • password — see above 👆
  • shell — see above 👆
  • uid — see above 👆

🦋 BOOLEAN PARAMETERS 🦋

these are the yes/no, on/off, vibe-check toggles. flags with no value, just vibes.

  • system — see useradd(8). heads up though: this one only applies on user create. it does nothing on modify, okay? 🚨
  • create-home — see useradd(8). also only applies on user create. 🏠✨
  • remove-home — see userdel(8). and this one only applies on user delete. bye bye home dir 😭

💬 MESSAGES 💬

the little receipts this type gives you when stuff happens. notifications, basically.

  • mod — User is modified 🔧
  • add — New user added 🎉
  • userdel -r — If user was deleted with homedir 💀🏠
  • userdel — If user was deleted (keeping homedir) 👋

⭐ EXAMPLES ⭐

okay here's where it gets fun, bestie. copy these EXACTLY, don't freestyle the syntax. 💅

# Create user account for foobar with operating system default settings
__user foobar

# Same but with a different shell
__user foobar --shell /bin/zsh

# Same but for a system account
__user foobar --system

# Set explicit uid and home
__user foobar --uid 1001 --shell /bin/zsh --home /home/foobar

# Drop user if exists
__user foobar --state absent

look at that last one. --state absent and they're GONE. dramatic but necessary. 🫡

🔥 SEE ALSO 🔥

pw(8), usermod(8) — go read those too, they're the supporting cast. 📚

👑 AUTHORS 👑

Steven Armstrong <steven-cdist--@--armstrong.cc> — icon behavior, honestly. thank you for your service 🫶

💜 COPYING 💜

Copyright (C) 2011 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.

ungleich GmbH 2021

and that's the whole page, bestie. every flag, every message, every example — nothing skipped, nothing invented. go manage some users, you got this 💖

cdist-type__user — from version 7.0.0, dated Jul 31, 2022. mwah 💋 bye bestie, slay your deployments 🦋✨

📦 where this page comes from