2011-03-15 22:41:30 +00:00
|
|
|
cdist-type__group(7)
|
2011-03-18 01:11:47 +00:00
|
|
|
====================
|
2016-05-20 06:50:56 +00:00
|
|
|
Manage groups
|
2011-03-15 22:37:17 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
Steven Armstrong <steven-cdist--@--armstrong.cc>
|
2011-03-15 22:37:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2011-03-15 22:41:30 +00:00
|
|
|
This cdist type allows you to create or modify groups on the target.
|
2011-03-15 22:37:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
|
|
-------------------
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
-------------------
|
2016-05-20 06:50:56 +00:00
|
|
|
state
|
2015-01-20 20:29:04 +00:00
|
|
|
absent or present, defaults to present
|
2016-05-20 06:50:56 +00:00
|
|
|
gid
|
2011-03-15 22:41:30 +00:00
|
|
|
see groupmod(8)
|
2016-05-20 06:50:56 +00:00
|
|
|
password
|
2011-03-15 22:37:17 +00:00
|
|
|
see above
|
|
|
|
|
|
|
|
|
2015-01-20 20:29:04 +00:00
|
|
|
BOOLEAN PARAMETERS
|
|
|
|
------------------
|
2016-05-20 06:50:56 +00:00
|
|
|
system
|
2015-01-20 20:29:04 +00:00
|
|
|
see groupadd(8), apply only on group creation
|
|
|
|
|
|
|
|
|
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
|
|
|
group is modified
|
2016-05-20 06:50:56 +00:00
|
|
|
add
|
2014-01-17 09:27:21 +00:00
|
|
|
New group added
|
2016-05-20 06:50:56 +00:00
|
|
|
remove
|
2015-01-20 20:29:04 +00:00
|
|
|
group is removed
|
2016-05-20 06:50:56 +00:00
|
|
|
change <property> <new_value> <current_value>
|
2014-01-17 09:27:21 +00:00
|
|
|
Changed group property from current_value to new_value
|
2016-05-20 06:50:56 +00:00
|
|
|
set <property> <new_value>
|
2016-05-13 20:44:54 +00:00
|
|
|
set property to new value, property was not set before
|
2014-01-17 09:27:21 +00:00
|
|
|
|
|
|
|
|
2011-03-15 22:37:17 +00:00
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
# Create a group 'foobar' with operating system default settings
|
|
|
|
__group foobar
|
2011-03-15 22:37:17 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
# Remove the 'foobar' group
|
|
|
|
__group foobar --state absent
|
2015-01-20 20:29:04 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
# Create a system group 'myservice' with operating system default settings
|
|
|
|
__group myservice --system
|
2015-01-20 20:29:04 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
# Same but with a specific gid
|
|
|
|
__group foobar --gid 1234
|
2011-03-15 22:37:17 +00:00
|
|
|
|
2016-05-20 06:50:56 +00:00
|
|
|
# Same but with a gid and password
|
|
|
|
__group foobar --gid 1234 --password 'crypted-password-string'
|
2011-03-15 22:37:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
2016-05-20 06:50:56 +00:00
|
|
|
- `cdist-type(7) <cdist-type.html>`_
|
2011-03-15 22:37:17 +00:00
|
|
|
|
|
|
|
|
|
|
|
COPYING
|
|
|
|
-------
|
2015-01-20 20:29:04 +00:00
|
|
|
Copyright \(C) 2011-2015 Steven Armstrong. Free use of this software is
|
2011-03-15 22:37:17 +00:00
|
|
|
granted under the terms of the GNU General Public License version 3 (GPLv3).
|