1CDIST-TYPE__USER(7)                  cdist                 CDIST-TYPE__USER(7)
2
3
4

NAME

6       cdist-type__user - Manage users
7

DESCRIPTION

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

REQUIRED PARAMETERS

12       None.
13

OPTIONAL PARAMETERS

15       state  absent or present, defaults to present
16
17       comment
18              see usermod(8)
19
20       home   see above
21
22       gid    see above
23
24       password
25              see above
26
27       shell  see above
28
29       uid    see above
30

BOOLEAN PARAMETERS

32       system see useradd(8), apply only on user create
33
34       create-home
35              see useradd(8), apply only on user create
36
37       remove-home
38              see userdel(8), apply only on user delete
39

MESSAGES

41       mod    User is modified
42
43       add    New user added
44
45       userdel -r
46              If user was deleted with homedir
47
48       userdel
49              If user was deleted (keeping homedir)
50

EXAMPLES

52          # Create user account for foobar with operating system default settings
53          __user foobar
54
55          # Same but with a different shell
56          __user foobar --shell /bin/zsh
57
58          # Same but for a system account
59          __user foobar --system
60
61          # Set explicit uid and home
62          __user foobar --uid 1001 --shell /bin/zsh --home /home/foobar
63
64          # Drop user if exists
65          __user foobar --state absent
66

SEE ALSO

68       pw(8), usermod(8)
69

AUTHORS

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

COPYING

74       Copyright  (C)  2011  Steven  Armstrong. You can redistribute it and/or
75       modify it under the terms of the GNU General  Public  License  as  pub‐
76       lished  by  the  Free  Software Foundation, either version 3 of the Li‐
77       cense, or (at your option) any later version.
78
80       ungleich GmbH 2021
81
82
83
84
857.0.0                            Jul 31, 2022              CDIST-TYPE__USER(7)
Impressum