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 entry, or its mode bits are set to zero (no access)  if  it  is  a  base
       entry.

       uid  or gid can be or (defined in respectively, to represent non-specific 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 operating 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)