FileACE C APIs

Describes the C FileACE APIs.

The FileACE C APIs are defined in the header file hdfs.h and are as follows:

hdfsSetAces

Sets the ACEs for a file or directory.

Syntax

int hdfsSetAces(hdfsFS fs, const char *path, hdfsFileAces *faces, int isSet, int isRecursive);

Parameters

fs: The configured filesystem handle
path: The path to the file or directory for which the ACEs need to be set.
faces: The ACEs to set
isSet: Set to 0 to merge with any existing ACEs, or set to 1 to replace all existing ACEs.
isRecursive: Set to 1 to apply ACEs recursively when setting on a directory.

Return Value

0 on success, else an error code.

Gets the ACEs from a file or directory.

Syntax

int hdfsGetAces(hdfsFS fs, const char *path, void *aceBuf, int bufLen, hdfsFileAces *faces);

Parameters

Return Value

0 on success, else error ERANGE, which indicates that the buffer is too small to hold the ACE entries.

Deletes all ACEs from a file or directory.

Syntax

int hdfsDeleteAces(hdfsFS fs, const char *path);

Parameters

Return Value

0 on success, else an appropriate error.