Index for Section 3

Alphabetical listing for A

Bottom of page

acl_to_text(3)
NAME
  acl_to_text - Converts an ACL to an ASCII string

SYNOPSIS
  #include <sys/acl.h>

  char * acl_to_text(
	  acl_t acl_d,
	  ssize_t *len_p );

LIBRARY
  Security Library (libpacl.a)

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.

  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.

SEE ALSO
  acl_size(3), acl_from_text(3)

  Security

Index for Section 3

Alphabetical listing for A

Top of page