16.69. cdist-type__install_directory(7)¶

16.69.1. NAME¶

cdist-type__install_directory - Manage a directory with install command

16.69.2. DESCRIPTION¶

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

16.69.3. REQUIRED PARAMETERS¶

None.

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

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

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

16.69.7. EXAMPLES¶

# A silly example
__install_directory /tmp/foobar

# Remove a directory
__install_directory /tmp/foobar --state absent

# Ensure /etc exists correctly
__install_directory /etc --owner root --group root --mode 0755

# Create nfs service directory, including parents
__install_directory /home/services/nfs --parents

# Change permissions recursively
__install_directory /home/services --recursive --owner root --group root

# Setup a temp directory
__install_directory /local --mode 1777

# Take it all
__install_directory /home/services/kvm --recursive --parents \
    --owner root --group root --mode 0755 --state present

16.69.8. AUTHORS¶

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

16.69.9. COPYING¶

Copyright (C) 2011 Nico Schottelius. 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.