.\" Man page generated from reStructuredText.
.
.TH "CDIST-TYPE__ACL" "7" "Jun 23, 2019" "5.1.2" "cdist"
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH NAME
.sp
cdist\-type__acl \- Set ACL entries
.SH DESCRIPTION
.sp
Fully supported and tested on Linux (ext4 filesystem), partial support for FreeBSD.
.sp
See \fBsetfacl\fP and \fBacl\fP manpages for more details.
.SH REQUIRED MULTIPLE PARAMETERS
.INDENT 0.0
.TP
.B acl
Set ACL entry following \fBgetfacl\fP output syntax.
.UNINDENT
.SH BOOLEAN PARAMETERS
.INDENT 0.0
.TP
.B default
Set all ACL entries as default too.
Only directories can have default ACLs.
Setting default ACL in FreeBSD is currently not supported.
.TP
.B recursive
Make \fBsetfacl\fP recursive (Linux only), but not \fBgetfacl\fP in explorer.
.TP
.B remove
Remove undefined ACL entries.
\fBmask\fP and \fBother\fP entries can\(aqt be removed, but only changed.
.UNINDENT
.SH DEPRECATED PARAMETERS
.sp
Parameters \fBuser\fP, \fBgroup\fP, \fBmask\fP and \fBother\fP are deprecated and they
will be removed in future versions. Please use \fBacl\fP parameter instead.
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
__acl /srv/project \e
    \-\-default \e
    \-\-recursive \e
    \-\-remove \e
    \-\-acl user:alice:rwx \e
    \-\-acl user:bob:r\-x \e
    \-\-acl group:project\-group:rwx \e
    \-\-acl group:some\-other\-group:r\-x \e
    \-\-acl mask::r\-x \e
    \-\-acl other::r\-x

# give Alice read\-only access to subdir,
# but don\(aqt allow her to see parent content.

__acl /srv/project2 \e
    \-\-remove \e
    \-\-acl default:group:secret\-project:rwx \e
    \-\-acl group:secret\-project:rwx \e
    \-\-acl user:alice:\-\-x

__acl /srv/project2/subdir \e
    \-\-default \e
    \-\-remove \e
    \-\-acl group:secret\-project:rwx \e
    \-\-acl user:alice:r\-x
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHORS
.sp
Ander Punnar <ander\-at\-kvlt\-dot\-ee>
.SH COPYING
.sp
Copyright (C) 2018 Ander Punnar. 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.
.SH COPYRIGHT
ungleich GmbH 2019
.\" Generated by docutils manpage writer.
.