Struct gimli::read::RelocateReader

pub struct RelocateReader<R: Reader<Offset = usize>, T: Relocate<R::Offset>> { /* private fields */ }

A Reader which applies relocations to addresses and offsets.

This is useful for reading sections which contain relocations, such as those in a relocatable object file. It is generally not used for reading sections in an executable file.

Implementations

impl<R, T> RelocateReader<R, T>

where R: Reader<Offset = usize>, T: Relocate<R::Offset>,

pub fn new(section: R, relocate: T) -> Self

Create a new RelocateReader which applies relocations to the given section reader.

Trait Implementations

impl<R: Clone + Reader<Offset = usize>, T: Clone + Relocate<R::Offset>> Clone for RelocateReader<R, T>

fn clone(&self) -> RelocateReader<R, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<R: Debug + Reader<Offset = usize>, T: Debug + Relocate<R::Offset>> Debug for RelocateReader<R, T>

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

Formats the value using the given formatter.

impl<R, T> Reader for RelocateReader<R, T>

where R: Reader<Offset = usize>, T: Relocate<R::Offset> + Debug + Clone,

type Endian = <R as Reader>::Endian

The endianity of bytes that are read.

type Offset = <R as Reader>::Offset

The type used for offsets and lengths.

fn read_address(&mut self, address_size: u8) -> Result<u64>

Read an address-sized integer, and return it as a u64.

fn read_offset(&mut self, format: Format) -> Result<R::Offset>

Parse a word-sized section offset according to the DWARF format.

fn read_sized_offset(&mut self, size: u8) -> Result<R::Offset>

Parse a section offset of the given size.

fn split(&mut self, len: Self::Offset) -> Result<Self>

Split a reader in two.

fn endian(&self) -> Self::Endian

Return the endianity of bytes that are read.

fn len(&self) -> Self::Offset

Return the number of bytes remaining.

fn empty(&mut self)

Set the number of bytes remaining to zero.

fn truncate(&mut self, len: Self::Offset) -> Result<()>

Set the number of bytes remaining to the specified length.

fn offset_from(&self, base: &Self) -> Self::Offset

Return the offset of this reader’s data relative to the start of the given base reader’s data.

fn offset_id(&self) -> ReaderOffsetId

Return an identifier for the current reader offset.

fn lookup_offset_id(&self, id: ReaderOffsetId) -> Option<Self::Offset>

Return the offset corresponding to the given id if it is associated with this reader.

fn find(&self, byte: u8) -> Result<Self::Offset>

Find the index of the first occurrence of the given byte. The offset of the reader is not changed.

fn skip(&mut self, len: Self::Offset) -> Result<()>

Discard the specified number of bytes.

fn to_slice(&self) -> Result<Cow<'_, [u8]>>

Return all remaining data as a clone-on-write slice.

fn to_string(&self) -> Result<Cow<'_, str>>

Convert all remaining data to a clone-on-write string.

fn to_string_lossy(&self) -> Result<Cow<'_, str>>

Convert all remaining data to a clone-on-write string, including invalid characters.

fn read_slice(&mut self, buf: &mut [u8]) -> Result<()>

Read exactly buf.len() bytes into buf.

fn read_u8_array<A>(&mut self) -> Result<A>

where A: Sized + Default + AsMut<[u8]>,

Read a u8 array.

fn is_empty(&self) -> bool

Return true if the number of bytes remaining is zero.

fn read_u8(&mut self) -> Result<u8>

Read a u8.

fn read_i8(&mut self) -> Result<i8>

Read an i8.

fn read_u16(&mut self) -> Result<u16>

Read a u16.

fn read_i16(&mut self) -> Result<i16>

Read an i16.

fn read_u32(&mut self) -> Result<u32>

Read a u32.

fn read_i32(&mut self) -> Result<i32>

Read an i32.

fn read_u64(&mut self) -> Result<u64>

Read a u64.

fn read_i64(&mut self) -> Result<i64>

Read an i64.

fn read_f32(&mut self) -> Result<f32>

Read a f32.

fn read_f64(&mut self) -> Result<f64>

Read a f64.

fn read_uint(&mut self, n: usize) -> Result<u64>

Read an unsigned n-bytes integer u64.

fn read_null_terminated_slice(&mut self) -> Result<Self>

Read a null-terminated slice, and return it (excluding the null).

fn skip_leb128(&mut self) -> Result<()>

Skip a LEB128 encoded integer.

fn read_uleb128(&mut self) -> Result<u64>

Read an unsigned LEB128 encoded integer.

fn read_uleb128_u32(&mut self) -> Result<u32>

Read an unsigned LEB128 encoded u32.

fn read_uleb128_u16(&mut self) -> Result<u16>

Read an unsigned LEB128 encoded u16.

fn read_sleb128(&mut self) -> Result<i64>

Read a signed LEB128 encoded integer.

fn read_initial_length(&mut self) -> Result<(Self::Offset, Format)>

Read an initial length field.

fn read_address_size(&mut self) -> Result<u8>

Read a byte and validate it as an address size.

fn read_word(&mut self, format: Format) -> Result<Self::Offset>

Parse a word-sized integer according to the DWARF format.

fn read_length(&mut self, format: Format) -> Result<Self::Offset>

Parse a word-sized section length according to the DWARF format.