Enum CreateReflink 

pub enum CreateReflink {
    Never,
    Auto,
}

Whether to materialize a new worktree by copy-on-write cloning an existing one’s files instead of checking them out ([create] reflink).

On a CoW filesystem (btrfs, XFS with reflink=1, APFS, ReFS) this shares the extents of every file, so a new worktree of a large repository costs almost no disk and almost no writing. It also carries the source’s ignored build output along, which is usually the point and occasionally not. The source’s untracked files are left behind, so the new worktree still comes up clean and Config::copy still governs which non-tracked files travel.

Off by default: it only pays off on a CoW filesystem, and copying a source’s ignored files is a bigger behavioural change than seeding. auto uses it when the filesystem supports it and a source worktree is already at the same tree, and silently checks out normally otherwise.

Variants

Never

Never clone; always check out (the default).

Auto

Clone when the filesystem and the source worktree allow it.

Implementations

impl CreateReflink

pub fn parse(value: &str) -> Option<CreateReflink>

Parses a create.reflink value (auto, never).

pub fn is_enabled(self) -> bool

Whether copy-on-write materialization is enabled.

pub fn identifier(self) -> &'static str

The config identifier this strategy round-trips through.

Trait Implementations

impl Clone for CreateReflink

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CreateReflink

impl Debug for CreateReflink

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

Formats the value using the given formatter.

impl Default for CreateReflink

fn default() -> Self

Returns the “default value” for a type.

impl Eq for CreateReflink

impl PartialEq for CreateReflink

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CreateReflink