Enum Mutation 

pub enum Mutation {
    Create {
        path: NamespacePath,
        record: FileRecord,
    },
    Restore {
        path: NamespacePath,
        record: FileRecord,
    },
    Remove {
        path: NamespacePath,
        expected_file_id: MetadataField<FileId>,
    },
    Rename {
        source: NamespacePath,
        destination: NamespacePath,
        replace: bool,
    },
    Link {
        source: NamespacePath,
        destination: NamespacePath,
    },
    SetMetadata {
        path: NamespacePath,
        metadata: ObjectId,
    },
    Write {
        path: NamespacePath,
        offset: u64,
        length: u64,
        content: ObjectId,
        content_offset: u64,
    },
    ValidateRegular {
        path: NamespacePath,
    },
    Resize {
        path: NamespacePath,
        logical_bytes: u64,
    },
    ZeroRange {
        path: NamespacePath,
        offset: u64,
        length: u64,
        allocated: bool,
        extend: bool,
    },
    Preallocate {
        path: NamespacePath,
        offset: u64,
        length: u64,
        keep_size: bool,
    },
    CloneRange {
        source: NamespacePath,
        source_offset: u64,
        destination: NamespacePath,
        destination_offset: u64,
        length: u64,
    },
    File {
        file_id: FileId,
        mutation: FileMutation,
    },
    CloneFileRange {
        source_file_id: FileId,
        source_offset: u64,
        destination_file_id: FileId,
        destination_offset: u64,
        length: u64,
    },
}

One ordered mutation within a single-volume atomic batch.

Variants

Create

Binds a new path-independent file record at an absent path.

Fields

path: NamespacePath

New namespace path.

record: FileRecord

Complete immutable initial record.

Restore

Restores one exact immutable record at a path while preserving any additional live hard-link bindings to the same identity. Unlike Create, the identity may already exist in the candidate generation.

Fields

path: NamespacePath

Namespace path to restore.

record: FileRecord

Exact source record. Its link count is adapted to the live binding topology; all other representable facts are restored verbatim.

Remove

Removes one namespace binding.

Fields

path: NamespacePath

Existing namespace path.

expected_file_id: MetadataField<FileId>

Optional exact file identity precondition.

Rename

Atomically moves one binding within the volume.

Fields

source: NamespacePath

Existing source path.

destination: NamespacePath

Destination path.

replace: bool

Whether an existing destination may be replaced.

Link

Creates another namespace binding to an existing non-directory file.

Fields

source: NamespacePath

Existing source path.

destination: NamespacePath

New link path.

SetMetadata

Replaces the complete canonical metadata object.

Fields

path: NamespacePath

Existing path.

metadata: ObjectId

Authenticated metadata object.

Write

Replaces one logical byte interval with authenticated content.

Fields

path: NamespacePath

Existing regular-file path.

offset: u64

Inclusive destination offset.

length: u64

Positive byte count.

content: ObjectId

Authenticated blob containing source bytes.

content_offset: u64

Inclusive source offset in content.

ValidateRegular

Validates that one existing path names a regular file without changing it.

Fields

path: NamespacePath

Existing regular-file path.

Resize

Changes logical file length while preserving sparse semantics.

Fields

path: NamespacePath

Existing regular-file path.

logical_bytes: u64

New logical byte length.

ZeroRange

Replaces a range with a hole or physically allocated zeros.

Fields

path: NamespacePath

Existing regular-file path.

offset: u64

Inclusive logical offset.

length: u64

Positive byte count.

allocated: bool

Preserve physical allocation instead of punching a hole.

extend: bool

Whether the replacement may extend logical file length.

Preallocate

Allocates sparse holes without replacing existing content.

Fields

path: NamespacePath

Existing regular-file path.

offset: u64

Inclusive logical offset.

length: u64

Positive byte count.

keep_size: bool

Preserve logical file length.

CloneRange

Clones one logical range without materializing unchanged content.

Fields

source: NamespacePath

Existing source regular file.

source_offset: u64

Inclusive source offset.

destination: NamespacePath

Existing destination regular file.

destination_offset: u64

Inclusive destination offset.

length: u64

Positive byte count.

File

Mutates one existing file through its stable path-independent identity.

Fields

file_id: FileId

Existing authenticated file-table identity.

mutation: FileMutation

Ordered record mutation.

CloneFileRange

Clones one logical range between stable file identities.

Fields

source_file_id: FileId

Existing source regular-file identity.

source_offset: u64

Inclusive source offset.

destination_file_id: FileId

Existing destination regular-file identity.

destination_offset: u64

Inclusive destination offset.

length: u64

Positive byte count.

Trait Implementations

impl Clone for Mutation

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mutation

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

Formats the value using the given formatter.

impl Eq for Mutation

impl PartialEq for Mutation

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Mutation