Struct ElfInputs 

pub struct ElfInputs<'data> {
    pub image: &'data [u8],
    pub debug: Option<&'data [u8]>,
    pub symbols: Option<&'data [u8]>,
    pub supplementary: Option<&'data [u8]>,
    pub dwp: Option<&'data [u8]>,
}

Available on crate feature convert only.

ELF inputs used to construct a GSYM file.

Only image is required. Leaving a companion as None makes the converter fall back to the image itself for symbols and DWARF, so a single unstripped binary needs nothing else.

Passing inputs this way skips discovery entirely: nothing is read from the filesystem or the network. Use ElfConverter::convert_path when companion files should be searched for.

use gsym::convert::ElfInputs;

let image = std::fs::read("app")?;
let debug = std::fs::read("app.debug")?;
let inputs = ElfInputs::new(&image).with_debug(&debug);

Fields

image: &'data [u8]

Linked ET_EXEC, ET_DYN, or relocatable ET_REL ELF image.

debug: Option<&'data [u8]>

Explicit separate DWARF ELF, if different from the image.

symbols: Option<&'data [u8]>

Extra symbol-table ELF read alongside the image’s and debug input’s own tables.

supplementary: Option<&'data [u8]>

Supplementary DWARF ELF referenced by the main debug input.

dwp: Option<&'data [u8]>

Packaged split-DWARF input.

Implementations

impl<'data> ElfInputs<'data>

pub const fn new(image: &'data [u8]) -> Self

Creates inputs using one ELF for the image, symbols, and DWARF.

pub const fn with_debug(self, debug: &'data [u8]) -> Self

Uses an explicit ELF containing the image’s DWARF sections.

pub const fn with_symbols(self, symbols: &'data [u8]) -> Self

Adds an explicit ELF symbol table to the ones already imported.

pub const fn with_supplementary(self, supplementary: &'data [u8]) -> Self

Supplies the supplementary DWARF ELF referenced by the main debug input.

pub const fn with_dwp(self, dwp: &'data [u8]) -> Self

Supplies a packaged split-DWARF file.

Trait Implementations

impl<'data> Clone for ElfInputs<'data>

fn clone(&self) -> ElfInputs<'data>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'data> Copy for ElfInputs<'data>

impl Debug for ElfInputs<'_>

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

Formats the value using the given formatter.

impl<'data> Eq for ElfInputs<'data>

impl<'data> PartialEq for ElfInputs<'data>

fn eq(&self, other: &ElfInputs<'data>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'data> StructuralPartialEq for ElfInputs<'data>