1 .\" Access Control Lists manual pages
3 .\" (C) 2002 Andreas Gruenbacher, <a.gruenbacher@bestbits.at>
5 .\" This is free documentation; you can redistribute it and/or
6 .\" modify it under the terms of the GNU General Public License as
7 .\" published by the Free Software Foundation; either version 2 of
8 .\" the License, or (at your option) any later version.
10 .\" The GNU General Public License's references to "object code"
11 .\" and "executables" are to be interpreted as the output of any
12 .\" document formatting or typesetting system, including
13 .\" intermediate and printed output.
15 .\" This manual is distributed in the hope that it will be useful,
16 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
17 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 .\" GNU General Public License for more details.
20 .\" You should have received a copy of the GNU General Public
21 .\" License along with this manual. If not, see
22 .\" <http://www.gnu.org/licenses/>.
31 Linux Access Control Lists library (libacl, \-lacl).
36 .Fn acl_get_entry "acl_t acl" "int entry_id" "acl_entry_t *entry_p"
40 function obtains a descriptor for an ACL entry as specified by
42 within the ACL indicated by the argument
46 is ACL_FIRST_ENTRY, then the function returns in
48 a descriptor for the first ACL entry within
52 is ACL_NEXT_ENTRY, then the function returns in
54 a descriptor for the next ACL entry within
61 set to ACL_NEXT_ENTRY when there has not been either an initial
64 or a previous successful call to
69 .Fn acl_create_entry ,
70 .Fn acl_delete_entry ,
79 then the effect is unspecified.
83 do not modify any ACL entries. Subsequent operations using the returned
84 ACL entry descriptor operate on the ACL entry within the ACL in working
85 storage. The order of all existing entries in the ACL remains unchanged.
86 Any existing ACL entry descriptors that refer to entries within the ACL
87 continue to refer to those entries. Any existing ACL pointers that refer
88 to the ACL referred to by
90 continue to refer to the ACL.
92 If the function successfully obtains an ACL entry, the function returns a
95 If the ACL has no ACL entries, the function returns the value
99 is ACL_NEXT_ENTRY and the last ACL entry in the ACL has already been
100 returned by a previous call to
102 the function returns the value
104 until a successful call with an
106 of ACL_FIRST_ENTRY is made. Otherwise, the value
110 is set to indicate the error.
112 If any of the following conditions occur, the
118 to the corresponding value:
123 is not a valid pointer to an ACL.
127 is neither ACL_NEXT_ENTRY nor ACL_FIRST_ENTRY.
130 IEEE Std 1003.1e draft 17 (\(lqPOSIX.1e\(rq, abandoned)
132 .Xr acl_calc_mask 3 ,
133 .Xr acl_create_entry 3 ,
134 .Xr acl_copy_entry 3 ,
135 .Xr acl_delete_entry 3 ,
139 Derived from the FreeBSD manual pages written by
140 .An "Robert N M Watson" Aq rwatson@FreeBSD.org ,
141 and adapted for Linux by
142 .An "Andreas Gruenbacher" Aq a.gruenbacher@bestbits.at .