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/>.
29 .Nd copy an ACL from internal to external representation
31 Linux Access Control Lists library (libacl, \-lacl).
36 .Fn acl_copy_ext "void *buf_p" "acl_t acl" "ssize_t size"
40 function copies the ACL pointed to by
42 from system-managed space to the user managed space pointed to by
46 parameter represents the size in bytes of the buffer pointed to by
48 The format of the ACL placed in the buffer pointed to by
50 is a contiguous, persistent data item, the format of which is unspecified.
51 It is the responsibility of the invoker to allocate an area large enough
52 to hold the copied ACL. The size of the exportable, contiguous, persistent
53 form of the ACL may be obtained by invoking the
57 Any ACL entry descriptors that refer to an entry in the ACL referenced by
59 continue to refer to those entries. Any existing ACL pointers that refer
60 to the ACL referenced by
62 continue to refer to the ACL.
64 Upon success, this function returns the number of bytes placed in the buffer pointed to by
72 If any of the following conditions occur, the
74 function returns a value of
78 to the corresponding value:
83 parameter is zero or negative.
87 is not a valid pointer to an ACL.
91 contains one or more improperly formed ACL entries, or for some other
92 reason cannot be translated into the external form of an ACL.
96 parameter is greater than zero but smaller than the length of the contiguous, persistent form of the ACL.
99 IEEE Std 1003.1e draft 17 (\(lqPOSIX.1e\(rq, abandoned)
105 Derived from the FreeBSD manual pages written by
106 .An "Robert N M Watson" Aq rwatson@FreeBSD.org ,
107 and adapted for Linux by
108 .An "Andreas Gruenbacher" Aq a.gruenbacher@bestbits.at .