acl_error — convert an ACL error code to a text message

Library

Linux Access Control Lists library (libacl, -lacl).

Synopsis

#include <sys/types.h>
#include <acl/libacl.h>

const char *
acl_error(int code);

Description

The acl_error() function converts an ACL error code such as returned by the acl_check() function to a text message describing the error condition. In the “POSIX” locale, acl_check() returns the following descriptions for the error codes.

ACL_MULTI_ERROR

“Multiple entries”

ACL_DUPLICATE_ERROR

“Duplicate entries”

ACL_MISS_ERROR

“Missing or wrong entry”

ACL_ENTRY_ERROR

“Invalid entry type”

Return Value

The acl_error() function returns a text message if the error code is recognized, and a value of (const char *)NULL otherwise.

Standards

This is a non-portable, Linux specific extension to the ACL manipulation functions defined in IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned).

See Also

acl_check(3), acl_valid(3), acl(5)

Author

Written by Andreas Gruenbacher ⟨a.gruenbacher@bestbits.at⟩.

Referenced By

acl(5).

March 23, 2002