CDIST-TYPE__DIRECTO(7)

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). Warning: all intermediate directory permissions default to whatever mkdir -p does.

        Usually this means root:root, 0700.

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).

AUTHOR

Nico Schottelius <nico-cdist--@--schottelius.org>
    Author.