42. cdist-type__directory(7)¶

Manage a directory

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

42.1. DESCRIPTION¶

This cdist type allows you to create or remove directories on the target.

42.2. REQUIRED PARAMETERS¶

None.

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

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

42.5. MESSAGES¶

chgrp <group>: Changed group membership
chown <owner>: Changed owner
chmod <mode>: Changed mode
create: Empty directory was created
remove: Directory exists, but state is absent, directory will be removed by generated code.
remove non directory: Something other than a directory with the same name exists and was removed prior to create.

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

42.7. SEE ALSO¶

cdist-type(7)