Click this button to go to the index for this section.

acl_to_text(3)
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
  acl_d	    Designates the working storage internal representation of an ACL
	    to convert to text external representation.

  len_p	    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:

  [EINVAL]	 The argument acl_d is not in a recognized format.

		 The argument acl_d contains one or more improperly formatted
		 ACL entries.

  [ENOMEM]	 There is not enough memory available to the process to
		 allocate the character string.



RELATED INFORMATION
  acl_size(3), acl_from_text(3)

  Security