Struct DebugFileEntry 

pub struct DebugFileEntry {
    pub surface: FileSurface,
    pub path: String,
    pub source_hash: u64,
    pub line_starts: Vec<u32>,
}

One entry in the DebugInfo section’s section-local file table (docs/debugger-spec.md §2.3). Index 0 is always the reserved synthetic sentinel (§2.5) — surface = Synthetic, path = "" — real files start at index 1. Paths are project-root-relative (root_relative_key), not process-cwd-relative or absolute.

Fields

surface: FileSurface

path: String

source_hash: u64

content_hash of this file’s text exactly as the compiler consumed it (#3261) — no normalisation of line endings, whitespace or encoding on either side. A reader that hashes differently-normalised text will see a spurious mismatch, so the contract is the raw bytes that were compiled.

Lets a consumer detect that the source it is measuring against is not the source this program was built from, and answer StaleSource instead of a confidently wrong address. That failure applies to byte ranges every bit as much as to line numbers — offsets shift on every inserted character.

Per-file, deliberately: one dirty file then degrades debugging in that file alone, where a whole-program checksum degrades everything.

0 for the reserved synthetic sentinel at index 0, which names no real file.

line_starts: Vec<u32>

Byte offset of the start of each line in this file, ascending, with line_starts[0] == 0 (#3261). Length is the file’s line count.

Carrying this means the engine can answer file:line without being handed source text at all — which is what a remote debugger frontend (DAP’s setBreakpoints is file + line) needs, and what keeps line↔byte conversion to one implementation instead of one per consumer. Line indexing is 0-based here; a UI showing 1-based line numbers converts at its own edge.

Empty for the synthetic sentinel, and legitimately empty for an empty file.

Trait Implementations

impl Clone for DebugFileEntry

fn clone(&self) -> DebugFileEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DebugFileEntry

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

Formats the value using the given formatter.

impl Eq for DebugFileEntry

impl PartialEq for DebugFileEntry

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DebugFileEntry