Struct CommonInformationEntry

pub struct CommonInformationEntry<R, Offset = <R as Reader>::Offset>
where
    R: Reader<Offset = Offset>,
    Offset: ReaderOffset,
{ /* private fields */ }

A Common Information Entry holds information that is shared among many Frame Description Entries. There is at least one CIE in every non-empty .debug_frame section.

Implementations

impl<R: Reader> CommonInformationEntry<R>

Signal Safe Methods

These methods are guaranteed not to allocate, acquire locks, or perform any other signal-unsafe operations.

pub fn offset(&self) -> R::Offset

Get the offset of this entry from the start of its containing section.

pub fn encoding(&self) -> Encoding

Return the encoding parameters for this CIE.

pub fn address_size(&self) -> u8

The size of addresses (in bytes) in this CIE.

pub fn instructions<'a, Section>( &self, section: &'a Section, bases: &'a BaseAddresses, ) -> CallFrameInstructionIter<'a, R>

where Section: UnwindSection<R>,

Iterate over this CIE’s initial instructions.

Can be used with FallibleIterator.

pub fn entry_len(&self) -> R::Offset

A constant that gives the number of bytes of the CIE structure, not including the length field itself (see Section 7.2.2). The size of the length field plus the value of length must be an integral multiple of the address size.

pub fn version(&self) -> u8

A version number (see Section 7.23). This number is specific to the call frame information and is independent of the DWARF version number.

pub fn augmentation(&self) -> Option<&Augmentation>

Get the augmentation data, if any exists.

The only augmentation understood by gimli is that which is defined by .eh_frame.

pub fn has_lsda(&self) -> bool

True if this CIE’s FDEs have a LSDA.

pub fn lsda_encoding(&self) -> Option<DwEhPe>

Return the encoding of the LSDA address for this CIE’s FDEs.

pub fn personality_with_encoding(&self) -> Option<(DwEhPe, Pointer)>

Return the encoding and address of the personality routine handler for this CIE’s FDEs.

pub fn personality(&self) -> Option<Pointer>

Return the address of the personality routine handler for this CIE’s FDEs.

pub fn fde_address_encoding(&self) -> Option<DwEhPe>

Return the encoding of the addresses for this CIE’s FDEs.

pub fn is_signal_trampoline(&self) -> bool

True if this CIE’s FDEs are trampolines for signal handlers.

pub fn code_alignment_factor(&self) -> u64

A constant that is factored out of all advance location instructions (see Section 6.4.2.1).

pub fn data_alignment_factor(&self) -> i64

A constant that is factored out of certain offset instructions (see below). The resulting value is (operand * data_alignment_factor).

pub fn return_address_register(&self) -> Register

An unsigned … constant that indicates which column in the rule table represents the return address of the function. Note that this column might not correspond to an actual machine register.

Trait Implementations

impl<R, Offset> Clone for CommonInformationEntry<R, Offset>

where R: Reader<Offset = Offset> + Clone, Offset: ReaderOffset + Clone,

fn clone(&self) -> CommonInformationEntry<R, Offset>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<R, Offset> Debug for CommonInformationEntry<R, Offset>

where R: Reader<Offset = Offset> + Debug, Offset: ReaderOffset + Debug,

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

Formats the value using the given formatter.

impl<R, Offset> PartialEq for CommonInformationEntry<R, Offset>

where R: Reader<Offset = Offset> + PartialEq, Offset: ReaderOffset + PartialEq,

fn eq(&self, other: &CommonInformationEntry<R, Offset>) -> 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<R, Offset> Eq for CommonInformationEntry<R, Offset>

where R: Reader<Offset = Offset> + Eq, Offset: ReaderOffset + Eq,

impl<R, Offset> StructuralPartialEq for CommonInformationEntry<R, Offset>

where R: Reader<Offset = Offset>, Offset: ReaderOffset,