14.138. cdist-type__user(7)¶
14.138.1. NAME¶
cdist-type__user - Manage users
14.138.2. DESCRIPTION¶
This cdist type allows you to create or modify users on the target.
14.138.3. REQUIRED PARAMETERS¶
None.
14.138.4. OPTIONAL PARAMETERS¶
- state
- absent or present, defaults to present
- comment
- see usermod(8)
- home
- see above
- gid
- see above
- password
- see above
- shell
- see above
- uid
- see above
14.138.5. BOOLEAN PARAMETERS¶
- system
- see useradd(8), apply only on user create
- create-home
- see useradd(8), apply only on user create
- remove-home
- see userdel(8), apply only on user delete
14.138.6. MESSAGES¶
- mod
- User is modified
- add
- New user added
14.138.7. EXAMPLES¶
# 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
14.138.8. SEE ALSO¶
pw(8), usermod(8)
14.138.9. AUTHORS¶
Steven Armstrong <steven-cdist--@--armstrong.cc>
14.138.10. 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.