Struct LinkPolicy 

pub struct LinkPolicy { /* private fields */ }

Controls how symbolic- and hard-link members are extracted.

By default, symbolic links are preserved as native links, including links to missing targets. Hard links and ambient symbolic-link targets require explicit opt-in.

Implementations

impl LinkPolicy

pub fn symlink_policy(self, policy: SymlinkPolicy) -> LinkPolicy

Configures how symbolic-link members are handled during extraction.

Symbolic links are preserved by default. Platforms without native symbolic-link creation require SymlinkPolicy::Skip or SymlinkPolicy::Reject.

pub fn allow_hard_links(self, allow: bool) -> LinkPolicy

Configures whether hard-link members may be extracted.

Hard links are forbidden by default because they are uncommon, difficult to extract consistently, and prone to implementation differentials. Enable them only for trusted archives.

pub fn allow_ambient_targets(self, allow: bool) -> LinkPolicy

Configures whether pre-existing symbolic-link targets may be used.

Existing symbolic links are followed only when capability-relative resolution remains beneath the extraction root. Ambient targets are forbidden by default. This does not affect hard-link validation.

pub fn allow_missing_targets(self, allow: bool) -> LinkPolicy

Configures whether symbolic links to missing targets may be extracted.

Missing symbolic-link targets are allowed by default. This does not affect hard-link validation.

Trait Implementations

impl Clone for LinkPolicy

fn clone(&self) -> LinkPolicy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for LinkPolicy

impl Debug for LinkPolicy

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

Formats the value using the given formatter.

impl Default for LinkPolicy

fn default() -> LinkPolicy

Returns the “default value” for a type.

impl Eq for LinkPolicy

impl PartialEq for LinkPolicy

fn eq(&self, other: &LinkPolicy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for LinkPolicy