Enum ValidationIssue 

pub enum ValidationIssue {
    HeaderMagicMismatch,
    UnsupportedVersion(u8),
    RootDirOutOfBounds {
        offset: u64,
        length: u64,
        file_size: u64,
    },
    LeafDirOutOfBounds {
        tile_id: u64,
        offset: u64,
        length: u64,
        file_size: u64,
    },
    TileDataOutOfBounds {
        tile_id: u64,
        offset: u64,
        length: u64,
        file_size: u64,
    },
    OverlappingTiles {
        tile_id_a: u64,
        tile_id_b: u64,
    },
    NonMonotonicTileIds {
        leaf_dir_tile_id: u64,
    },
    DirectoryDecodeError(String),
    VarintTruncated {
        at: u64,
    },
}

A single integrity issue found during a validation pass over a PMTiles archive.

Variants

HeaderMagicMismatch

The first 7 bytes do not match the PMTiles magic string, or the header could not be parsed at all.

UnsupportedVersion(u8)

The spec-version byte is not 3.

RootDirOutOfBounds

The root-directory byte range [offset, offset + length) exceeds the reported file size.

Fields

offset: u64

Byte offset of the root directory.

length: u64

Byte length of the root directory.

file_size: u64

Total file size as reported by the data slice.

LeafDirOutOfBounds

A leaf-directory pointer entry’s byte range [offset, offset + length) within the leaf-dirs section exceeds the leaf-dirs section length.

Fields

tile_id: u64

Tile ID of the leaf-pointer directory entry.

offset: u64

Byte offset within the leaf-dirs section.

length: u64

Byte length of the leaf directory.

file_size: u64

Total length of the leaf-dirs section.

TileDataOutOfBounds

A tile entry’s data range [tile_data_offset + offset, + length) exceeds the total file size.

Fields

tile_id: u64

Tile ID of the offending directory entry.

offset: u64

Byte offset within the tile-data section.

length: u64

Byte length of the tile.

file_size: u64

Total file size as reported by the data slice.

OverlappingTiles

Two tile entries have data ranges that overlap (excluding the case where both offset+length values are equal, which is valid deduplication).

Fields

tile_id_a: u64

Tile ID of the first (earlier offset) entry.

tile_id_b: u64

Tile ID of the second (later offset) entry.

NonMonotonicTileIds

Within a single leaf directory the tile IDs are not non-decreasing.

Fields

leaf_dir_tile_id: u64

Tile ID of the leaf-pointer directory entry whose decoded leaf contains non-monotonic IDs.

DirectoryDecodeError(String)

The root or a leaf directory could not be decoded.

VarintTruncated

A varint in the directory was truncated before its terminal byte.

Fields

at: u64

Approximate file position at which the truncation was detected.

Trait Implementations

impl Clone for ValidationIssue

fn clone(&self) -> ValidationIssue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ValidationIssue

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

Formats the value using the given formatter.

impl Display for ValidationIssue

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

Formats the value using the given formatter.

impl PartialEq for ValidationIssue

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ValidationIssue