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

FreeBSD Manual Pages

  
 
  

home | help
setaclentry(3C)						       setaclentry(3C)

NAME
       setaclentry(),  fsetaclentry()  -  add,	modify,	or delete one entry in
       file's access control list (ACL)	(HFS File Systems only)

SYNOPSIS
DESCRIPTION
       Both forms of this call add, modify, or delete one entry	 in  a	file's
       access  control	list  (ACL).  and take a path name (path) or open file
       descriptor (fd) and an entry identifier (uid, gid).   They  change  the
       indicated  entry's access mode bits to the given	value (mode), meanings
       of which	are defined in modes are represented as	and Irrelevant bits in
       mode values must	be zero.

       If the file's ACL does not have an entry	for the	given uid and gid, the
       entry is	created	and added to the ACL.  If  mode	 is  (defined  in  the
       matching	 entry is deleted from the file's ACL if it is an optional en-
       try, or its mode	bits are set to	zero (no access) if it is a  base  en-
       try.

       uid  or	gid  can be or (defined	in respectively, to represent non-spe-
       cific entries or	The file's or base entries can be referred to using or
       (defined	in for the file's owner	or group ID, respectively.

       and read	the file's ACL with or and modify it with or respectively.

RETURN VALUE
       If successful, and return zero.

ERRORS
       If an error occurs, and return the following negative values and	set

       -1     Unable to	perform	or on the file.	 indicates the cause.

       -2     Unable to	perform	or on the file.	 indicates the cause.

       -3     Cannot  add  a new entry because the ACL already has (defined in
	      entries.

       -4     Cannot delete a nonexisting entry.

       -5     Unable to	perform	or on the file.	 indicates the cause.

EXAMPLES
       The following code fragment adds	an entry  to  file  ``work/list''  for
       user  ID	115, group ID 32, or modifies the existing entry for that user
       and group, if any, with a new  access  mode  of	read  only.   It  also
       changes the owner base entry to have all	access rights, and deletes the
       entry, if any, for any user in group 109.

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

       NFS     and are not supported on	remote files.

AUTHOR
       and were	developed by HP.

SEE ALSO
       getacl(2),  setacl(2),  stat(2),	acltostr(3C), cpacl(3C), chownacl(3C),
       strtoacl(3C), acl(5), thread_safety(5).

							       setaclentry(3C)

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=setaclentry&sektion=3c&manpath=HP-UX+11.22>

home | help