16.67. cdist-type__install_directory(7)¶
16.67.1. NAME¶
cdist-type__install_directory - Manage a directory with install command
16.67.2. DESCRIPTION¶
This cdist type allows you to create or remove directories on the target.
16.67.3. REQUIRED PARAMETERS¶
None.
16.67.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.67.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.67.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.67.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.67.8. AUTHORS¶
Nico Schottelius <nico-cdist--@--schottelius.org>
16.67.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.