NAME

cdist-type__user - 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

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

September 26, 2023

7.0.0