cdist-type__user - Man Page
Manage users
Description
This cdist type allows you to create or modify users on the target.
Required Parameters
None.
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
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
Messages
- mod
User is modified
- add
New user added
- userdel -r
If user was deleted with homedir
- userdel
If user was deleted (keeping homedir)
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
See Also
pw(8), usermod(8)
Authors
Steven Armstrong <steven-cdist--@--armstrong.cc>
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.
Copyright
ungleich GmbH 2021
Info
Jul 31, 2022 7.0.0 cdist