Struct WorktreeModePolicy 

pub struct WorktreeModePolicy {
    pub trust_filemode: bool,
    pub has_symlinks: bool,
}

What the worktree filesystem can express about a tracked path’s mode.

Git records these capabilities per repository as core.filemode (is the executable bit meaningful?) and core.symlinks (can the checkout hold symbolic links?). Both default to true; git init/git clone write false when probing the filesystem fails, which is the norm on Windows. When a capability is missing, the worktree cannot show that aspect of a path, so the mode already recorded in the index wins over what lstat reports.

Use WorktreeModePolicy::index_mode_for_worktree whenever a worktree mode is compared with or written over an index entry: staging, status and worktree diffs all share it.

Fields

trust_filemode: bool

core.filemode: the worktree’s executable bit is meaningful.

has_symlinks: bool

core.symlinks: the worktree can hold symbolic links.

Implementations

impl WorktreeModePolicy

pub fn from_config(config: &ConfigSet) -> Self

Read core.filemode and core.symlinks from config, defaulting each to true when unset or not a boolean.

pub fn index_mode_for_worktree( self, worktree_mode: u32, recorded_mode: Option<u32>, ) -> u32

The mode to record for a path given its worktree mode and the mode currently recorded.

Rules, in order:

1. Without symlink support, a regular file standing in for a recorded symlink (MODE_SYMLINK) stays a symlink: the file holds the link target.
2. Without a trusted executable bit, a regular file over a recorded regular file keeps the recorded 100644/100755.
3. Otherwise the worktree mode wins (including real type changes such as a directory, a symlink on a symlink-capable checkout, or a gitlink).

Parameters

• worktree_mode — Git mode derived from lstat (see crate::diff::mode_from_metadata).
• recorded_mode — the index entry’s mode, or None for a path not yet tracked (the worktree mode is then returned unchanged).

Returns

The Git mode to compare against or store in the index.

pub fn worktree_mode_matches( self, worktree_mode: u32, recorded_mode: u32, ) -> bool

Whether a worktree mode is indistinguishable from recorded_mode under this policy.

Equivalent to index_mode_for_worktree(worktree_mode, Some(recorded_mode)) == recorded_mode.

Trait Implementations

impl Clone for WorktreeModePolicy

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 WorktreeModePolicy

impl Debug for WorktreeModePolicy

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

Formats the value using the given formatter.

impl Default for WorktreeModePolicy

fn default() -> Self

Returns the “default value” for a type.

impl Eq for WorktreeModePolicy

impl PartialEq for WorktreeModePolicy

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WorktreeModePolicy