ACL_FROM_TEXT(3) BSD Library Functions Manual ACL_FROM_TEXT(3)
NAME
acl_to_text — convert an ACL to text
LIBRARY
Linux Access Control Lists library (libacl, −lacl).
SYNOPSIS
#include <sys/types.h>
#include <sys/acl.h>
char *
acl_to_text(acl_t acl, ssize_t *len_p);
DESCRIPTION
The 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 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_free(3) with the (void*)char returned by 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 acl_to_text() function returns a value of (char *)NULL and sets errno to the corresponding value:
[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.
[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 (“POSIX.1e”, abandoned)
SEE ALSO
acl_free(3), acl_to_any_text(3), acl(5)
AUTHOR
Derived from the FreeBSD manual pages written by Robert N M Watson ⟨ rwatson@FreeBSD.org⟩ , and adapted for Linux by Andreas Gruenbacher ⟨ a.gruenbacher@bestbits.at⟩ .
Linux ACL March 23, 2002 Linux ACL
More Linux Commands
manpages/Tcl_FSEvalFileEx.3.html
Tcl_FSEvalFileEx(3) - procedures to interact with any filesy
There are several reasons for calling the Tcl_FS API functions (e.g. Tcl_FSAccess and Tcl_FSStat) rather than calling system level functions like access and sta
manpages/keyctl.1.html
keyctl(1) - Key management facility control - Linux man page
This program is used to control the key management facility in various ways using a variety of subcommands. KEY IDENTIFIERS The key identifiers passed to or ret
manpages/XkbSARedirectVMods.3.html
XkbSARedirectVMods(3) - Returns the vmods0 and vmods1 fields
XkbSARedirectVMods.3 - Actions associated with the XkbRedirectKeyAction structure generate KeyPress and KeyRelease events containing a keycode different from th
manpages/motd.news.5.html
motd.news(5) - Message of the day information for readers...
This file, found in pathetc/motd.news, contains local information for news readers in a free-form format. The entire file is returned verbatim to any client tha
manpages/log10.3.html
log10(3) - base-10 logarithmic function - Linux manual page
The log10() function returns the base 10 logarithm of x. RETURN VALUE On success, these functions return the base 10 logarithm of x. For special cases, includin
manpages/outb.2.html
outb(2) - port I/O (System calls - Linux man page)..........
outb.2 - This family of functions is used to do low-level port input and output. The out* functions do port output, the in* functions do port input; the b-suffi
manpages/localedef.1.html
localedef(1) - compile locale definition files (Man Page)...
The localedef program reads the indicated charmap and input files, compiles them to a binary form quickly usable by the locale functions in the C library (setlo
manpages/dracut.bootup.7.html
dracut.bootup(7) boot ordering in the initramfs (Man Page)
This flow chart illustrates the ordering of the services, if systemd is used in the dracut initramfs. systemd-journal.socket | v dracut-cmdline.service | v drac
manpages/Tk_SetClassProcs.3.html
Tk_SetClassProcs(3) - register widget specific procedures...
Tk_SetClassProcs is called to register a set of procedures that are used as callbacks in different places. The structure pointed to by procs contains the follow
manpages/io_submit.2.html
io_submit(2) - submit asynchronous I/O blocks for processing
The io_submit() system call queues nr I/O request blocks for processing in the AIO context ctx_id. The iocbpp argument should be an array of nr AIO control bloc
manpages/curl_easy_reset.3.html
curl_easy_reset(3) - reset all options of a libcurl session
Re-initializes all options previously set on a specified CURL handle to the default values. This puts back the handle to the same state as it was in when it was
manpages/ldap.3.html
ldap(3) - OpenLDAP Lightweight Directory Access Protocol API
The Lightweight Directory Access Protocol (LDAP) (RFC 4510) provides access to X.500 directory services. These services may be stand-alone or part of a distribu
