2011-03-15 15:47:40 +00:00
|
|
|
cdist-type__user(7)
|
|
|
|
|
===================
|
2016-06-23 14:08:59 +00:00
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
cdist-type__user - Manage users
|
2011-03-15 15:47:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
This cdist type allows you to create or modify users on the target.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
|
|
|
-------------------
|
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
|
-------------------
|
2016-05-20 06:50:56 +00:00
|
|
|
state
|
2013-12-17 13:13:20 +00:00
|
|
|
absent or present, defaults to present
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
|
comment
|
2013-12-17 13:13:20 +00:00
|
|
|
see usermod(8)
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
|
home
|
2013-12-17 13:13:20 +00:00
|
|
|
see above
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
|
gid
|
2013-12-17 13:13:20 +00:00
|
|
|
see above
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
|
password
|
2013-12-17 13:13:20 +00:00
|
|
|
see above
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
|
shell
|
2013-12-17 13:13:20 +00:00
|
|
|
see above
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
|
uid
|
2013-12-17 13:13:20 +00:00
|
|
|
see above
|
2011-03-15 15:47:40 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
|
2013-12-17 13:13:20 +00:00
|
|
|
BOOLEAN PARAMETERS
|
|
|
|
|
------------------
|
2016-05-20 06:50:56 +00:00
|
|
|
system
|
2013-12-19 07:14:29 +00:00
|
|
|
see useradd(8), apply only on user create
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
|
create-home
|
2013-12-17 13:13:20 +00:00
|
|
|
see useradd(8), apply only on user create
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
|
remove-home
|
2013-12-17 13:13:20 +00:00
|
|
|
see userdel(8), apply only on user delete
|
2011-03-15 15:47:40 +00:00
|
|
|
|
2014-01-17 09:27:21 +00:00
|
|
|
|
|
|
|
|
MESSAGES
|
|
|
|
|
--------
|
2016-05-20 06:50:56 +00:00
|
|
|
mod
|
2014-01-17 09:27:21 +00:00
|
|
|
User is modified
|
2016-05-20 06:50:56 +00:00
|
|
|
|
|
|
|
|
add
|
2014-01-17 09:27:21 +00:00
|
|
|
New user added
|
|
|
|
|
|
2018-10-11 14:05:57 +00:00
|
|
|
userdel -r
|
|
|
|
|
If user was deleted with homedir
|
|
|
|
|
|
|
|
|
|
userdel
|
|
|
|
|
If user was deleted (keeping homedir)
|
2014-01-17 09:27:21 +00:00
|
|
|
|
2011-03-15 15:47:40 +00:00
|
|
|
EXAMPLES
|
|
|
|
|
--------
|
|
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
|
|
# Create user account for foobar with operating system default settings
|
|
|
|
|
__user foobar
|
2011-03-15 15:47:40 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
# Same but with a different shell
|
|
|
|
|
__user foobar --shell /bin/zsh
|
2011-03-15 15:47:40 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
# Same but for a system account
|
|
|
|
|
__user foobar --system
|
2013-12-17 13:13:20 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
# Set explicit uid and home
|
|
|
|
|
__user foobar --uid 1001 --shell /bin/zsh --home /home/foobar
|
2013-12-17 13:13:20 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
# Drop user if exists
|
|
|
|
|
__user foobar --state absent
|
2011-03-15 15:47:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
2016-06-30 13:12:32 +00:00
|
|
|
:strong:`pw`\ (8), :strong:`usermod`\ (8)
|
2016-06-17 19:28:16 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
AUTHORS
|
|
|
|
|
-------
|
|
|
|
|
Steven Armstrong <steven-cdist--@--armstrong.cc>
|
2011-03-15 15:47:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
COPYING
|
|
|
|
|
-------
|
2016-08-10 16:15:54 +00:00
|
|
|
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.
|
