Struct Held 

pub struct Held { /* private fields */ }

One target directory held open for a whole landing verb.

Opened once, right after the lock under an apply and before any evidence is gathered, and carried through every decision read and every write, so a target root exchanged under the pathname after validation receives nothing: the descriptor names the directory that was validated, whatever its path has since become.

Implementations

impl Held

pub fn open(target: &Utf8Path) -> Result<Self, RkError>

Hold target, following no link at its final component.

Errors

The open failure, and a kernel link that is not UTF-8.

pub fn open_locked( target: &Utf8Path, lock: &TargetLock, ) -> Result<Self, RkError>

Hold target under lock: the directory opened must be the one the lock key was derived from, or the target was exchanged between the two steps and the landing refuses before it reads anything.

Errors

As Self::open, and a state-drift refusal naming the exchange.

pub fn base(&self) -> &Utf8Path

The path every read of this target goes through: the kernel’s link to the held directory.

pub fn display(&self) -> &Utf8Path

The path the operator named, for reports.

Trait Implementations

impl Debug for Held

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

Formats the value using the given formatter.