1.\"- 2.\" Copyright (c) 2000 Robert N. M. Watson 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" 26.\" $FreeBSD$ 27.\" 28.Dd March 30, 2000 29.Dt GETFACL 1 30.Os 31.Sh NAME 32.Nm getfacl 33.Nd get ACL information 34.Sh SYNOPSIS 35.Nm 36.Op Fl d 37.Op Ar 38.Sh DESCRIPTION 39The 40.Nm 41utility writes discretionary access control information associated with 42the specified file(s) to standard output. 43If the 44.Xr getconf 1 45utility indicates that 46.Eq { } Va _POSIX_ACL_EXTENDED 47is not in effect for a 48.Ar file 49then the standard discretionary access permissions are interpreted as 50an ACL containing only the required ACL entries. 51.Pp 52The following option is available: 53.Bl -tag -width indent 54.It Fl d 55The operation applies to the default ACL of a directory instead of the 56access ACL. 57An error is generated if a default ACL cannot be associated with 58.Ar file . 59.El 60.Pp 61The following operand is available: 62.Bl -tag -width indent 63.It Ar file 64A pathname of a file whose ACL shall be retrieved. 65If 66.Ar file 67is not specified, or a 68.Ar file 69is specified as 70.Fl , 71then 72.Nm 73reads a list of pathnames, each terminated by one newline character, 74from the standard input. 75.El 76.Sh EXAMPLES 77.Dl getfacl / 78.Pp 79Retrieve ACL for the directory 80.Pa / . 81.Pp 82.Dl getfacl -d / 83.Pp 84Retrieve the default ACL for the directory 85.Pa / , 86if any. 87.Sh SEE ALSO 88.Xr setfacl 1 , 89.Xr acl 3 , 90.Xr getextattr 8 , 91.Xr setextattr 8 , 92.Xr acl 9 , 93.Xr extattr 9 94.Sh STANDARDS 95The 96.Nm 97utility is expected to be 98.Tn IEEE 99Std 1003.2c compliant. 100.Sh HISTORY 101Extended Attribute and Access Control List support was developed as part 102of the 103.Tn TrustedBSD 104Project and introduced in 105.Fx 5.0 . 106.Sh AUTHORS 107.An Robert N M Watson 108