ACL_FROM_TEXT
Section: C Library Functions (3)
Index
Return to Main Contents
BSD mandoc
Linux ACL
NAME
acl_to_text
- convert an ACL to text
LIBRARY
Linux Access Control Lists library (libacl, -lacl).
SYNOPSIS
In sys/types.h
In sys/acl.h
Ft char *
Fn acl_to_text acl_t acl ssize_t *len_p
DESCRIPTION
The
Fn acl_to_text
function translates the ACL pointed to by the argument
acl
into a
NULL
terminated character string. If the pointer
len_p
is not
NULL
then the function returns the length of the string (not
including the
NULL
terminator) in the location pointed to by
len_p
The format of the text string returned by
Fn acl_to_text
is the long text form defined in
acl(5).
The ACL referred to by
acl
is not changed.
This function allocates any memory necessary to contain the string and
returns a pointer to the string. The caller should free any releasable
memory, when the new string is no longer required, by calling
acl_free3
with the
(void*)char
returned by
Fn acl_to_text
as an argument.
RETURN VALUE
On success, this function returns a pointer to the
long text form of the ACL.
On error, a value of
(char *)NULL
is returned, and
errno
is set appropriately.
ERRORS
If any of the following conditions occur, the
Fn acl_to_text
function returns a value of
(char *)NULL
and sets
errno
to the corresponding value:
- Bq Er EINVAL
-
The argument
acl
is not a valid pointer to an ACL.
The ACL referenced by
acl
contains one or more improperly formed ACL entries, or for some other
reason cannot be translated into a text form of an ACL.
- Bq Er ENOMEM
-
The character string to be returned requires more memory than is allowed
by the hardware or system-imposed memory management constraints.
STANDARDS
IEEE Std 1003.1e draft 17 (lqPOSIX.1erq, abandoned)
SEE ALSO
acl_free3,
Xw acl_from_text 3 ,
acl_to_any_text3,
acl(5)
AUTHOR
Derived from the FreeBSD manual pages written by
An Robert N M Watson Aq
rwatson@FreeBSD.org ,
and adapted for Linux by
An Andreas Gruenbacher Aq
a.gruenbacher@bestbits.at .
Index
- NAME
-
- LIBRARY
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- ERRORS
-
- STANDARDS
-
- SEE ALSO
-
- AUTHOR
-
|
|
- Running on 
-
:
: 