cdist-type__user(7)

Overview

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

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.

Releases

5 releases since Debian 9 (Stretch); the text changed 4 times.

9
10
11
12
13