Index for Section 3

Alphabetical listing for A

Bottom of page

acl_set_fd(3)
NAME
  acl_set_fd - Sets the ACL on the file or directory designated by the file
  descriptor

LIBRARY
  Security Library (libpacl.a)

SYNOPSIS
  #include <sys/acl.h>
  int acl_set_fd(
	  int fd;
	  acl_type_t type_d;
	  acl_t acl_d);

PARAMETERS
  fd	    Refers to the open file descriptor of the file or directory to
	    set the ACL on.

  type_d    Designates the type of ACL to set: ACL_TYPE_ACCESS,
	    ACL_TYPE_DEFAULT, or ACL_TYPE_DEFAULT_DIR.

  acl_d	    Working storage internal representation of the ACL that is being
	    set.

DESCRIPTION
  NOTE:	 This function is based on Draft 13 of the POSIX P1003.6 standard.

  Given a file descriptor to a file or directory, the acl_set_fd() function
  sets the designated ACL.  The type of ACL being set is determined by the
  type_d parameter.  If acl_d is NULL then the designated ACL is removed from
  the designated file or directory. The entry pointer used by the
  acl_get_entry() function becomes undefined after a call to the acl_set_fd()
  function.

RETURN VALUES
  Upon successful completion, the acl_set_fd() function returns a value of 0
  (zero).  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_set_fd() function sets
  errno to the corresponding value:

  [EACCES]	 The required access to the file was denied.

  [EBADF]	 The fd argument is not a valid file descriptor.

  [EINVAL]	 The acl_d argument does not contain a valid ACL.

		 Argument type_d does not contain a valid ACL type number.

  [ENOSPC]	 The directory or file system that would contain the new ACL
		 cannot be extended or the file system is out of file
		 allocation resources.

  [ENOTDIR]	 The argument type_d indicates a default ACL, and fd does not
		 point to a directory.

  [ENOTSUP]	 The designated file or directory resides on a file system
		 that does not support ACLs.

  [EPERM]	 The process does not have the appropriate permissions to
		 perform the operation.

		 The setting and changing of ACLs have been disabled by the
		 system administrator.

  [EPERM]	 The designated file or directory resides on a read-only file
		 system.

RELATED INFORMATION
  acl_get_fd(3), acl_valid(3), acl_set_file(3)

  Security

Index for Section 3

Alphabetical listing for A

Top of page