acl_error(3)

acl_error3

Convert an acl error code to a text message

Usage

#include <sys/types.h>

#include <acl/libacl.h>

const char *

acl_error(int code);

Library

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

Overview

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.

Releases

13 releases since Debian 3.0 (Woody); the text changed 3 times.

  1. 3.0–3.1
  2. 4.0–5.0
  3. 6.0–10
  4. 11–Arch

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).

Author

Written by Andreas Gruenbacher ⟨[email protected]⟩.

From acl 2.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.