Enum ACLError

pub enum ACLError {
    IoError(IoErrorDetail),
    ValidationError(ValidationErrorDetail),
}

Error type from ACL operations. To distinguish different causes, use the kind() method.

Variants

IoError(IoErrorDetail)

Filesystem error while reading or writing ACL (file not found, permission denied, etc).

ValidationError(ValidationErrorDetail)

ACL is not valid and cannot be written.

Unfortunately it is not possible to provide detailed reasons, but mainly it can mean:

• Required entries are missing (UserObj, GroupObj, Mask and Other).
• ACL contains entries that are not unique.

Implementations

impl ACLError

pub fn kind(&self) -> ErrorKind

Get a general category of error, as std::io::ErrorKind. Validation errors get returned as InvalidData.

use posix_acl::PosixACL;
use std::io::ErrorKind;
let err = PosixACL::read_acl("/tmp/this-file-does-not-exist").unwrap_err();
assert_eq!(err.kind(), ErrorKind::NotFound);

pub fn as_io_error(&self) -> Option<&Error>

Get reference to underlying std::io::Error that occurred, if any.

use posix_acl::PosixACL;
use std::io::ErrorKind;
let err = PosixACL::read_acl("/tmp/this-file-does-not-exist").unwrap_err();
assert_eq!(err.as_io_error().unwrap().raw_os_error().unwrap(), libc::ENOENT);

Trait Implementations

impl Debug for ACLError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ACLError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ACLError

fn source(&self) -> Option<&(dyn Error + 'static)>

Get underlying std::io::Error value.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.