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