Struct DecodedGsym 

pub struct DecodedGsym {
    pub source_version: GsymVersion,
    pub source_endian: Endian,
    pub base_address: u64,
    pub build_id: Vec<u8>,
    pub files: Vec<FileEntry>,
    pub functions: Vec<Function>,
}

An owned, version-independent representation of a complete GSYM file.

Decode with Gsym::decode_all, edit the public semantic fields when needed, then use Self::into_builder or Self::transcode to move the model into a new encoding.

A FunctionInfo record of a type this crate does not model makes decoding fail rather than silently disappearing during re-encoding. source_version and source_endian record what the input used, and TranscodeOptions overrides either one for the output.

File indices in the model refer to Self::files, including the reserved empty entry at index zero. Re-encoding renumbers the table and keeps only the files the retained functions reference.

Fields

source_version: GsymVersion

Version from which this model was decoded.

source_endian: Endian

Byte order from which this model was decoded.

base_address: u64

Image base address.

build_id: Vec<u8>

Opaque build identifier.

files: Vec<FileEntry>

Complete file table, including reserved index zero.

functions: Vec<Function>

Fully decoded semantic functions.

Implementations

impl DecodedGsym

pub fn to_builder(&self, options: TranscodeOptions) -> Result<GsymBuilder>

Builds a deterministic writer model by cloning this decoded model.

Use Self::into_builder when this model is no longer needed.

Errors

Returns an error for invalid file references or model data.

pub fn into_builder(self, options: TranscodeOptions) -> Result<GsymBuilder>

Converts this decoded model into a deterministic writer without cloning its file or function trees.

Errors

Returns an error for invalid file references or model data.

pub fn transcode(self, options: TranscodeOptions) -> Result<Vec<u8>>

Encodes the complete model using the requested output settings.

use gsym::{
    AddressRange, Endian, Function, Gsym, GsymBuilder, GsymVersion,
    TranscodeOptions,
};

let mut builder = GsymBuilder::new();
builder.add_function(Function::new(
    AddressRange::new(0x4000, 0x4010),
    b"transcoded",
))?;
let source = builder.to_bytes()?;
let decoded = Gsym::parse(source)?.decode_all()?;
let output = decoded.transcode(TranscodeOptions {
    version: Some(GsymVersion::V2),
    endian: Some(Endian::Big),
})?;

let reparsed = Gsym::parse(output)?;
assert_eq!(reparsed.header().version, GsymVersion::V2);
assert_eq!(reparsed.header().endian, Endian::Big);

Errors

Returns an error when the model cannot be represented by the requested format version.

pub fn segments( &self, target_size: usize, options: TranscodeOptions, ) -> Result<Vec<GsymSegment>>

Splits the model into independently valid GSYM files near target_size.

A single record larger than the target is emitted alone. Each shard contains only source files referenced by its functions. Boundaries are selected from exact encoded sizes, so all multi-function shards are at most the requested target.

Shards are ordered by address and their [first_address, end_address) spans tile the covered range without a gap, so GsymSegment::first_address and GsymSegment::end_address are enough to route an address to a shard: the shard whose span holds an address is the shard that resolves it, and an address below the first shard resolves nowhere, exactly as in the unsplit file. Segmentation is considerably more expensive than a single encode.

Errors

Returns an error for a zero target, empty model, invalid references, or an encoding failure.

Trait Implementations

impl Debug for DecodedGsym

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

Formats the value using the given formatter.

impl Eq for DecodedGsym

impl PartialEq for DecodedGsym

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DecodedGsym