Print this page
12288 getfacl and setfacl could stand improvement
*** 1,39 ****
'\" te
.\" \&.Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
! .TH GETFACL 1 "Nov 5, 1994"
.SH NAME
getfacl \- display discretionary file information
.SH SYNOPSIS
- .LP
.nf
\fBgetfacl\fR [\fB-ad\fR] \fIfile\fR...
.fi
.SH DESCRIPTION
- .sp
- .LP
For each argument that is a regular file, special file, or named pipe, the
\fBgetfacl\fR utility displays the owner, the group, and the Access Control
List (\fBACL\fR). For each directory argument, \fBgetfacl\fR displays the
owner, the group, and the \fBACL\fR and/or the default \fBACL\fR. Only
directories contain default \fBACL\fRs.
.sp
.LP
The \fBgetfacl\fR utility may be executed on a file system that does not
support \fBACL\fRs. It reports the \fBACL\fR based on the base permission bits.
.sp
.LP
With no options specified, \fBgetfacl\fR displays the filename, the file owner,
the file group owner, and both the \fBACL\fR and the default \fBACL\fR, if it
exists.
.SH OPTIONS
- .sp
- .LP
The following options are supported:
.sp
.ne 2
.na
\fB\fB-a\fR\fR
--- 1,42 ----
'\" te
.\" \&.Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved
+ .\" Copyright (c) 2020 Peter Tribble.
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
! .TH GETFACL 1 "Feb 8, 2020"
.SH NAME
getfacl \- display discretionary file information
.SH SYNOPSIS
.nf
\fBgetfacl\fR [\fB-ad\fR] \fIfile\fR...
.fi
.SH DESCRIPTION
For each argument that is a regular file, special file, or named pipe, the
\fBgetfacl\fR utility displays the owner, the group, and the Access Control
List (\fBACL\fR). For each directory argument, \fBgetfacl\fR displays the
owner, the group, and the \fBACL\fR and/or the default \fBACL\fR. Only
directories contain default \fBACL\fRs.
.sp
.LP
+ The \fBgetfacl\fR utility will fail if executed on a file system that supports
+ NFSv4 \fBACL\fRs. See \fBacl\fR(5) for a description of the difference
+ between the older POSIX-draft \fBACL\fRs and the newer NFSv4 \fBACL\fRs. The
+ \fBls\fR(1) utility, when used with the \fB-v\fR or \fB-V\fR options, will
+ display \fBACL\fRs on all types of file system.
+ .sp
+ .LP
The \fBgetfacl\fR utility may be executed on a file system that does not
support \fBACL\fRs. It reports the \fBACL\fR based on the base permission bits.
.sp
.LP
With no options specified, \fBgetfacl\fR displays the filename, the file owner,
the file group owner, and both the \fBACL\fR and the default \fBACL\fR, if it
exists.
.SH OPTIONS
The following options are supported:
.sp
.ne 2
.na
\fB\fB-a\fR\fR
*** 52,63 ****
Displays the filename, the file owner, the file group owner, and the default
\fBACL\fR of the file, if it exists.
.RE
.SH OPERANDS
- .sp
- .LP
The following operands are supported:
.sp
.ne 2
.na
\fB\fIfile\fR\fR
--- 55,64 ----
*** 65,76 ****
.RS 8n
The path name of a regular file, special file, or named pipe.
.RE
.SH OUTPUT
- .sp
- .LP
The format for \fBACL\fR output is as follows:
.sp
.in +2
.nf
# file: filename
--- 66,75 ----
*** 152,162 ****
.LP
In order to indicate that the \fBACL\fR mask restricts an \fBACL\fR entry,
\fBgetfacl\fR displays an additional tab character, pound sign (\fB#\fR), and
the actual permissions granted, following the entry.
.SH EXAMPLES
- .LP
\fBExample 1 \fRDisplaying file information
.sp
.LP
Given file \fBfoo\fR, with an \fBACL\fR six entries long, the command
--- 151,160 ----
*** 256,266 ****
.fi
.in -2
.sp
.SH FILES
- .sp
.ne 2
.na
\fB\fB/etc/passwd\fR\fR
.ad
.RS 15n
--- 254,263 ----
*** 275,286 ****
.RS 15n
group file
.RE
.SH ATTRIBUTES
- .sp
- .LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
--- 272,281 ----
*** 291,306 ****
_
Interface Stability Evolving
.TE
.SH SEE ALSO
- .sp
- .LP
\fBchmod\fR(1), \fBls\fR(1), \fBsetfacl\fR(1), \fBacl\fR(2),
! \fBaclsort\fR(3SEC), \fBgroup\fR(4), \fBpasswd\fR(4), \fBattributes\fR(5)
.SH NOTES
- .sp
- .LP
The output from \fBgetfacl\fR is in the correct format for input to the
\fBsetfacl\fR \fB-f\fR command. If the output from \fBgetfacl\fR is redirected
to a file, the file may be used as input to \fBsetfacl\fR. In this way, a user
may easily assign one file's \fBACL\fR to another file.
--- 286,298 ----
_
Interface Stability Evolving
.TE
.SH SEE ALSO
\fBchmod\fR(1), \fBls\fR(1), \fBsetfacl\fR(1), \fBacl\fR(2),
! \fBaclsort\fR(3SEC), \fBgroup\fR(4), \fBpasswd\fR(4), \fBacl\fR(5),
! \fBattributes\fR(5)
.SH NOTES
The output from \fBgetfacl\fR is in the correct format for input to the
\fBsetfacl\fR \fB-f\fR command. If the output from \fBgetfacl\fR is redirected
to a file, the file may be used as input to \fBsetfacl\fR. In this way, a user
may easily assign one file's \fBACL\fR to another file.