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 convert an ACL to text
31 Linux Access Control Lists library (libacl, \-lacl).
36 .Fn acl_to_text "acl_t acl" "ssize_t *len_p"
40 function translates the ACL pointed to by the argument
44 terminated character string. If the pointer
48 then the function returns the length of the string (not
51 terminator) in the location pointed to by
53 The format of the text string returned by
55 is the long text form defined in
57 The ACL referred to by
61 This function allocates any memory necessary to contain the string and
62 returns a pointer to the string. The caller should free any releasable
63 memory, when the new string is no longer required, by calling
71 On success, this function returns a pointer to the
72 long text form of the ACL.
79 If any of the following conditions occur, the
81 function returns a value of
85 to the corresponding value:
90 is not a valid pointer to an ACL.
94 contains one or more improperly formed ACL entries, or for some other
95 reason cannot be translated into a text form of an ACL.
97 The character string to be returned requires more memory than is allowed
98 by the hardware or system-imposed memory management constraints.
101 IEEE Std 1003.1e draft 17 (\(lqPOSIX.1e\(rq, abandoned)
104 .Xw acl_from_text 3 ,
105 .Xr acl_to_any_text 3 ,
108 Derived from the FreeBSD manual pages written by
109 .An "Robert N M Watson" Aq rwatson@FreeBSD.org ,
110 and adapted for Linux by
111 .An "Andreas Gruenbacher" Aq a.gruenbacher@bestbits.at .