Content-type: text/html Man page of acl_to_text

acl_to_text

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

acl_to_text - Converts an ACL to an ASCII string  

LIBRARY

Security Library (libpacl.a)  

SYNOPSIS

#include <sys/acl.h>

char * acl_to_text(        acl_t acl_d
       ssize_t *len_p);
 

PARAMETERS

Designates the working storage internal representation of an ACL to convert to text external representation. Pointer to location to hold the length of the returned string or NULL.  

DESCRIPTION

NOTE: This function is based on Draft 13 of the POSIX P1003.6 standard. The function may change as the P1003.6 standard is finalized.

Given an ACL the acl_to_text() function converts it into a NULL terminated ASCII character string. The acl_to_text() function allocates any memory necessary and places the length of the string returned at len_p.  

RETURN VALUES

Upon successful completion, the acl_to_text() function returns an address pointing to the text external representation of the ACL. Otherwise, a value of NULL is returned and errno is set to indicate the error.  

ERRORS

If any of the following conditions occur, the acl_to_text() function sets errno to the corresponding value:

The argument acl_d is not in a recognized format. The argument acl_d contains one or more improperly formatted ACL entries. There is not enough memory available to the process to allocate the character string.  

RELATED INFORMATION

acl_size(3), acl_from_text(3)

Security delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:21 GMT, October 02, 2010