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

acl_copy_ext(3)
NAME
  acl_copy_ext - copies the ACL from system managed space to user managed
  space.

LIBRARY
  Security Library (libpacl.a)

SYNOPSIS
  #include <sys/acl.h>
  int acl_copy_ext(
	  void *buf_p,
	  acl_t acl_d,
	  ssize_t size);

PARAMETERS
  buf_p	    User space to copy the data package (contiguous) internal
	    representation of the ACL to.

  acl_d	    Specifies the working storage internal representation ACL entry
	    in system managed space to copy.

  size	    Indicates the size of the buffer pointed to by buf_p.

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.

  The acl_copy_ext() function copies the contents of the ACL in system
  managed space, pointed to by acl_d, into user space pointed to by buf_p.
  The ACL copied into user space is contiguous and is not NULL terminated.

RETURN VALUES
  Upon successful completion, the acl_copy_entry function returns the size of
  the ACL copied.  Otherwise, a value of -1 is returned and errno is set to
  indicate the error.

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

  [EINVAL]		   The size parameter is zero or negative.

			   The ACL referenced by acl_d contains one or more
			   improperly formed ACL entries, or for some other
			   reason can not be translated into the external
			   format.


  [ERANGE]		   The size parameter is greater then 0 but smaller
			   then the ACL to be copied.


RELATED INFORMATION
  acl_copy_int(3), acl_size(3)

  Security