Enum Chunk 

pub enum Chunk<'a> {
    Metadata(&'a [u8]),
    InlineData(&'a [u8]),
    FileBackedData {
        dirfd_index: u32,
        length: u64,
        filename: &'a [u8],
    },
}

A chunk decoded from a splitdirfdstream.

Chunks carry either stream metadata (raw tar header/padding bytes), inline-transported file content (non-world-readable files the producer read through a privileged fd), or references to external files identified by a directory fd index and a relative filename.

Variants

Metadata(&'a [u8])

Stream metadata: raw tar header or padding bytes embedded directly in the stream. Consumers write these verbatim into the output.

InlineData(&'a [u8])

Inline-transported file content. The producer read these bytes through a privileged fd; the consumer decides whether to store them inline (≤ splitstream threshold) or as an external object based on data.len().

FileBackedData

Reference to an external file relative to one of the caller-supplied directory file descriptors.

The reader does not validate filename content — callers that consume filename directly must call validate_filename or use open_beneath / reconstruct, which call it internally.

Fields

dirfd_index: u32

Index into the dirfds array supplied to reconstruct.

length: u64

Number of bytes to read from the file, starting at offset 0.

filename: &'a [u8]

Relative filename within dirfds[dirfd_index].

Trait Implementations

impl<'a> Clone for Chunk<'a>

fn clone(&self) -> Chunk<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Chunk<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for Chunk<'a>

impl<'a> PartialEq for Chunk<'a>

fn eq(&self, other: &Chunk<'a>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for Chunk<'a>