pub struct DebugLine<R> { /* private fields */ }
Expand description
The DebugLine
struct contains the source location to instruction mapping
found in the .debug_line
section.
Implementations§
source§impl<'input, Endian> DebugLine<EndianSlice<'input, Endian>>where
Endian: Endianity,
impl<'input, Endian> DebugLine<EndianSlice<'input, Endian>>where
Endian: Endianity,
sourcepub fn new(debug_line_section: &'input [u8], endian: Endian) -> Self
pub fn new(debug_line_section: &'input [u8], endian: Endian) -> Self
Construct a new DebugLine
instance from the data in the .debug_line
section.
It is the caller’s responsibility to read the .debug_line
section and
present it as a &[u8]
slice. That means using some ELF loader on
Linux, a Mach-O loader on macOS, etc.
use gimli::{DebugLine, LittleEndian};
let debug_line = DebugLine::new(read_debug_line_section_somehow(), LittleEndian);
source§impl<R: Reader> DebugLine<R>
impl<R: Reader> DebugLine<R>
sourcepub fn program(
&self,
offset: DebugLineOffset<R::Offset>,
address_size: u8,
comp_dir: Option<R>,
comp_name: Option<R>,
) -> Result<IncompleteLineProgram<R>>
pub fn program( &self, offset: DebugLineOffset<R::Offset>, address_size: u8, comp_dir: Option<R>, comp_name: Option<R>, ) -> Result<IncompleteLineProgram<R>>
Parse the line number program whose header is at the given offset
in the
.debug_line
section.
The address_size
must match the compilation unit that the lines apply to.
The comp_dir
should be from the DW_AT_comp_dir
attribute of the compilation
unit. The comp_name
should be from the DW_AT_name
attribute of the
compilation unit.
use gimli::{DebugLine, DebugLineOffset, IncompleteLineProgram, EndianSlice, LittleEndian};
let debug_line = DebugLine::new(read_debug_line_section_somehow(), LittleEndian);
// In a real example, we'd grab the offset via a compilation unit
// entry's `DW_AT_stmt_list` attribute, and the address size from that
// unit directly.
let offset = DebugLineOffset(0);
let address_size = 8;
let program = debug_line.program(offset, address_size, None, None)
.expect("should have found a header at that offset, and parsed it OK");
Trait Implementations§
source§impl<R> Section<R> for DebugLine<R>
impl<R> Section<R> for DebugLine<R>
source§fn section_name() -> &'static str
fn section_name() -> &'static str
Returns the ELF section name for this type.
source§fn dwo_section_name() -> Option<&'static str>
fn dwo_section_name() -> Option<&'static str>
Returns the ELF section name (if any) for this type when used in a dwo
file.
source§fn xcoff_section_name() -> Option<&'static str>
fn xcoff_section_name() -> Option<&'static str>
Returns the XCOFF section name (if any) for this type when used in a XCOFF
file.
impl<R: Copy> Copy for DebugLine<R>
Auto Trait Implementations§
impl<R> Freeze for DebugLine<R>where
R: Freeze,
impl<R> RefUnwindSafe for DebugLine<R>where
R: RefUnwindSafe,
impl<R> Send for DebugLine<R>where
R: Send,
impl<R> Sync for DebugLine<R>where
R: Sync,
impl<R> Unpin for DebugLine<R>where
R: Unpin,
impl<R> UnwindSafe for DebugLine<R>where
R: UnwindSafe,
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
🔬This is a nightly-only experimental API. (
clone_to_uninit
)