acl_set_file()

Set the access control list for a path

Synopsis:

#include <sys/acl.h>

int acl_set_file( const char *path_p,
                  acl_type_t type,
                  acl_t acl );

Since:

BlackBerry 10.0.0

Arguments:

path_p
The path that you want to set the ACL for.
type
The type of ACL; this must currently be ACL_TYPE_ACCESS.
acl
The ACL that you want to assign to the object.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The acl_set_file() function sets the access control list for a given path. The calling process's effective user ID must match the owner of the directory, or the process must have appropriate privileges in order to set the ACL. The ACL must also be valid, as defined by acl_valid().

If this function succeeds, the object's file permission bits might change; if it fails, the object's ACL and file permission bits aren't changed.

Returns:

0, or -1 if an error occurred ( errno is set).

Errors:

EACCES
Search permission was denied for a component of the path prefix, or the object exists and the process doesn't have the appropriate access rights.
EINVAL
The acl argument doesn't point to a valid ACL, or the type argument isn't ACL_TYPE_ACCESS.
ENAMETOOLONG
The length of the path_p argument exceeds PATH_MAX.
ENOENT
The named object doesn't exist, or path_p is an empty string.
ENOSPC
The directory or filesystem that would contain the new ACL can't be extended, or the filesystem is out of file allocation resources.
ENOTDIR
A component of the path prefix isn't a directory.
EPERM
The process doesn't have the appropriate privileges to set the ACL.
EROFS
The filesystem that the object is on is currently read-only.

Classification:

QNX Neutrino

This function is based on the withdrawn POSIX draft P1003.1e.

Safety:  
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes

Last modified: 2014-11-17



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus