Struct PathFd

pub struct PathFd { /* private fields */ }

Simple helper to open a file or a directory with the O_PATH flag.

This is the recommended way to identify a path and manage the lifetime of the underlying opened file descriptor. Indeed, using other AsFd implementations such as File brings more complexity and may lead to unexpected errors (e.g., denied access).

Example

use landlock::{AccessFs, PathBeneath, PathFd, PathFdError};

fn allowed_root_dir(access: AccessFs) -> Result<PathBeneath<PathFd>, PathFdError> {
    let fd = PathFd::new("/")?;
    Ok(PathBeneath::new(fd, access))
}

Implementations

impl PathFd

pub fn new<T>(path: T) -> Result<Self, PathFdError>

where T: AsRef<Path>,

Trait Implementations

impl AsFd for PathFd

fn as_fd(&self) -> BorrowedFd<'_>

Borrows the file descriptor.