1CDIST-TYPE__DIRECTORY(7)             cdist            CDIST-TYPE__DIRECTORY(7)
2
3
4

NAME

6       cdist-type__directory - Manage a directory
7

DESCRIPTION

9       This  cdist type allows you to create or remove directories on the tar‐
10       get.
11

REQUIRED PARAMETERS

13       None.
14

OPTIONAL PARAMETERS

16       state  'present' or 'absent', defaults to 'present'
17
18       group  Group to chgrp to.
19
20       mode   Unix permissions, suitable for chmod.
21
22       owner  User to chown to.
23

BOOLEAN PARAMETERS

25       parents
26              Whether to create parents as well (mkdir -p  behaviour).   Warn‐
27              ing:  all intermediate directory permissions default to whatever
28              mkdir -p does.
29
30              Usually this means root:root, 0700.
31
32       recursive
33              If supplied the chgrp and chown call will run recursively.  This
34              does not influence the behaviour of chmod.
35

MESSAGES

37       chgrp <group>
38              Changed group membership
39
40       chown <owner>
41              Changed owner
42
43       chmod <mode>
44              Changed mode
45
46       create Empty directory was created
47
48       remove Directory exists, but state is absent, directory will be removed
49              by generated code.
50
51       remove non directory
52              Something other than a directory with the same name  exists  and
53              was removed prior to create.
54

EXAMPLES

56          # A silly example
57          __directory /tmp/foobar
58
59          # Remove a directory
60          __directory /tmp/foobar --state absent
61
62          # Ensure /etc exists correctly
63          __directory /etc --owner root --group root --mode 0755
64
65          # Create nfs service directory, including parents
66          __directory /home/services/nfs --parents
67
68          # Change permissions recursively
69          __directory /home/services --recursive --owner root --group root
70
71          # Setup a temp directory
72          __directory /local --mode 1777
73
74          # Take it all
75          __directory /home/services/kvm --recursive --parents \
76              --owner root --group root --mode 0755 --state present
77

AUTHORS

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

COPYING

82       Copyright  (C)  2011  Nico  Schottelius. You can redistribute it and/or
83       modify it under the terms of the GNU General  Public  License  as  pub‐
84       lished  by  the  Free  Software  Foundation,  either  version  3 of the
85       License, or (at your option) any later version.
86
88       ungleich GmbH 2019
89
90
91
92
936.3.0                            Dec 12, 2019         CDIST-TYPE__DIRECTORY(7)
Impressum