13.91. cdist-type__user(7)

13.91.1. NAME

cdist-type__user - Manage users

13.91.2. DESCRIPTION

This cdist type allows you to create or modify users on the target.

13.91.3. REQUIRED PARAMETERS

None.

13.91.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

13.91.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

13.91.6. MESSAGES

mod
User is modified
add
New user added

13.91.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

13.91.8. SEE ALSO

pw(8), usermod(8)

13.91.9. AUTHORS

Steven Armstrong <steven-cdist--@--armstrong.cc>

13.91.10. COPYING

Copyright (C) 2011 Steven Armstrong. Free use of this software is granted under the terms of the GNU General Public License version 3 (GPLv3).