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

NAME

6       cdist-type__acl - Set ACL entries
7

DESCRIPTION

9       Fully  supported and tested on Linux (ext4 filesystem), partial support
10       for FreeBSD.
11
12       See setfacl and acl manpages for more details.
13
14       One of --entry or --source must be used.
15

OPTIONAL MULTIPLE PARAMETERS

17       entry  Set ACL entry following getfacl output syntax.  Must be used  if
18              --source is not used.
19

OPTIONAL PARAMETERS

21       source Read ACL entries from stdin or file.  Ordering of entries is not
22              important.  When reading from file, comments and empty lines are
23              ignored.  Must be used if --entry is not used.
24
25       file   Create/change file with __file using user:group:mode pattern.
26
27       directory
28              Create/change  directory  with __directory using user:group:mode
29              pattern.
30

BOOLEAN PARAMETERS

32       default
33              Set all ACL entries as default too.  Only directories  can  have
34              default  ACLs.   Setting default ACL in FreeBSD is currently not
35              supported.
36
37       recursive
38              Make setfacl recursive (Linux only),  but  not  getfacl  in  ex‐
39              plorer.
40
41       remove Remove  undefined  ACL entries.  mask and other entries can't be
42              removed, but only changed.
43

EXAMPLES

45          __acl /srv/project \
46              --default \
47              --recursive \
48              --remove \
49              --entry user:alice:rwx \
50              --entry user:bob:r-x \
51              --entry group:project-group:rwx \
52              --entry group:some-other-group:r-x \
53              --entry mask::r-x \
54              --entry other::r-x
55
56          # give Alice read-only access to subdir,
57          # but don't allow her to see parent content.
58
59          __acl /srv/project2 \
60              --remove \
61              --entry default:group:secret-project:rwx \
62              --entry group:secret-project:rwx \
63              --entry user:alice:--x
64
65          __acl /srv/project2/subdir \
66              --default \
67              --remove \
68              --entry group:secret-project:rwx \
69              --entry user:alice:r-x
70
71          # read acl from stdin
72          echo 'user:alice:rwx' \
73              | __acl /path/to/directory --source -
74
75          # create/change directory too
76          __acl /path/to/directory \
77              --default \
78              --remove \
79              --directory root:root:770 \
80              --entry user:nobody:rwx
81

AUTHORS

83       Ander Punnar <ander-at-kvlt-dot-ee>
84

COPYING

86       Copyright (C) 2018 Ander Punnar. You can redistribute it and/or  modify
87       it  under  the  terms of the GNU General Public License as published by
88       the Free Software Foundation, either version 3 of the License,  or  (at
89       your option) any later version.
90

92       ungleich GmbH 2020
93
94
95
96
976.9.6                            Apr 20, 2021               CDIST-TYPE__ACL(7)
Impressum