Struct Node 

#[non_exhaustive]
pub struct Node {
    pub header: Header,
    pub crc_valid: Option<bool>,
    /* private fields */
}

A parsed btrfs B-tree node (leaf or interior), plus its non-fatal checksum status. The raw block bytes are retained so leaf item data can be sliced on demand (bounds-checked).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

header: Header

The decoded 101-byte header.

crc_valid: Option<bool>

The crc32c status over [0x20 .. block.len()]: Some(true) if the stored digest verifies, Some(false) if it does not (corrupt/tampered), or None for a non-crc32c checksum whose verifier is deferred.

Implementations

impl Node

pub fn parse(block: &[u8]) -> Result<Self, BtrfsError>

Parse a nodesize-byte btrfs node from the start of block.

The block should be exactly one node (nodesize bytes); the checksum is computed over [0x20 .. block.len()], so pass the whole node block. A bad checksum does not fail the parse — it is surfaced in Node::crc_valid.

Errors

• BtrfsError::Truncated if block is shorter than the 101-byte header.

pub fn is_leaf(&self) -> bool

true if this is a leaf node (level == 0).

pub fn leaf_items(&self) -> impl Iterator<Item = (DiskKey, &[u8])>

Iterate (key, data) over a leaf’s items. Each data slice is bounds-checked against the block: a lying data_offset/data_size yields an empty slice, never an over-read. An interior node yields nothing.

pub fn key_ptrs(&self) -> &[KeyPtr]

The interior node’s child key-pointers. A leaf yields an empty slice.

pub fn chunk_items(&self) -> Vec<(u64, Chunk)>

Decode every CHUNK_ITEM in a leaf into (logical_start, Chunk) pairs (the logical start is the item key’s offset). Non-CHUNK items (e.g. DEV_ITEM) are skipped. An interior node yields nothing.

Trait Implementations

impl Clone for Node

fn clone(&self) -> Node

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Node

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

Formats the value using the given formatter.

impl Eq for Node

impl PartialEq for Node

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Node