84 lines
1.7 KiB
Plaintext
84 lines
1.7 KiB
Plaintext
cdist-type__directory(7)
|
|
========================
|
|
Nico Schottelius <nico-cdist--@--schottelius.org>
|
|
|
|
|
|
NAME
|
|
----
|
|
cdist-type__directory - Manage a directory
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This cdist type allows you to create or remove directories on the target.
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
-------------------
|
|
None.
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
-------------------
|
|
state::
|
|
'present' or 'absent', defaults to 'present'
|
|
|
|
group::
|
|
Group to chgrp to.
|
|
|
|
mode::
|
|
Unix permissions, suitable for chmod.
|
|
|
|
owner::
|
|
User to chown to.
|
|
|
|
|
|
BOOLEAN PARAMETERS
|
|
------------------
|
|
parents::
|
|
Whether to create parents as well (mkdir -p behaviour)
|
|
|
|
recursive::
|
|
If supplied the chgrp and chown call will run recursively.
|
|
This does *not* influence the behaviour of chmod.
|
|
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
--------------------------------------------------------------------------------
|
|
# A silly example
|
|
__directory /tmp/foobar
|
|
|
|
# Remove a directory
|
|
__directory /tmp/foobar --state absent
|
|
|
|
# Ensure /etc exists correctly
|
|
__directory /etc --owner root --group root --mode 0755
|
|
|
|
# Create nfs service directory, including parents
|
|
__directory /home/services/nfs --parents
|
|
|
|
# Change permissions recursively
|
|
__directory /home/services --recursive --owner root --group root
|
|
|
|
# Setup a temp directory
|
|
__directory /local --mode 1777
|
|
|
|
# Take it all
|
|
__directory /home/services/kvm --recursive --parents \
|
|
--owner root --group root --mode 0755 --state present
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
|
SEE ALSO
|
|
--------
|
|
- cdist-type(7)
|
|
|
|
|
|
COPYING
|
|
-------
|
|
Copyright \(C) 2011 Nico Schottelius. Free use of this software is
|
|
granted under the terms of the GNU General Public License version 3 (GPLv3).
|