Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
getacl(2)		      System Calls Manual		     getacl(2)

NAME
       getacl,	fgetacl	 - get access control list (ACL) information (HFS File
       Systems only)

SYNOPSIS
DESCRIPTION
       returns a complete listing of all ACL entries (uid.gid, mode) in	an ex-
       isting  file's  access  control	list.  path points to a	path name of a
       file.

       Similarly, returns a complete listing of	all ACL	entries	 for  an  open
       file known by the file descriptor fildes.

       nentries	 is the	number of entries being	reported on, and is never more
       than the	constant defined in If nentries	is non-zero,  it  must	be  at
       least  as  large	 as the	number of entries in the file's	ACL, including
       base entries (see setacl(2)).  returns the number  of  entries  in  the
       file's  ACL,  as	 well  as  the	ACL entries themselves in the array of
       structures acl declared by the calling program.

       If nentries is zero, returns the	number of entries in the  file's  ACL,
       including base ACL entries, and acl is ignored.

       Entries	are reported in	groups of decreasing order of specificity (see
       setacl(2)), then	sorted in each group by	user ID	 and  group  ID.   The
       content	of  array entries beyond the number of defined entries for the
       file is undefined.

RETURN VALUE
       Upon successful completion, and return a	non-negative value.  If	an er-
       ror  occurs,  a value of	-1 is returned,	and is set to indicate the er-
       ror.

ERRORS
       or fail to modify the acl array if any of the following is true:

	      [ENOTDIR]	     A component of the	path prefix is	not  a	direc-
			     tory.

	      [ENOENT]	     The  named	file does not exist (for example, path
			     is	null or	a component of path does not exist).

	      [EBADF]	     fildes is not a valid file	descriptor.

	      [EACCES]	     A component of the	path prefix denies search per-
			     mission.

	      [EFAULT]	     path  or  a  portion  of acl to be	written	points
			     outside  the  allocated  address  space  of   the
			     process.

	      [EINVAL]	     nentries  is non-zero and less than the number of
			     entries in	the file's ACL,	or it is greater than

	      [EOPNOTSUPP]   is	not supported on remote	files by some network-
			     ing services.

	      [ENOSYS]	     The function is not supported by this file	system
			     type.

	      [ENFILE]	     The system	file table is full.

	      [ENAMETOOLONG] The length	of path	exceeds	bytes, or  the	length
			     of	 a component of	path exceeds bytes while is in
			     effect.

	      [ELOOP]	     Too  many	symbolic  links	 were  encountered  in
			     translating the path name.

EXAMPLES
       The following call returns the number of	entries	in the ACL on file

       The  following  call  returns in	acl all	entries	in the ACL on the file
       opened with file	descriptor 5.

DEPENDENCIES
       and are only supported on HFS file system on standard  HP-UX  operating
       system.

AUTHOR
       and were	developed by HP.

SEE ALSO
       access(2), chmod(2), getaccess(2), setacl(2), stat(2), unistd(5).

								     getacl(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLES | DEPENDENCIES | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getacl&sektion=2&manpath=HP-UX+11.22>

home | help