pub struct ElfObject<'data> { /* private fields */ }
Expand description

Executable and Linkable Format, used for executables and libraries on Linux.

Implementations

Tests whether the buffer could contain an ELF object.

Tries to parse an ELF object from the given slice. Will return a partially parsed ELF object if at least the program and section headers can be parsed.

The container file format, which is always FileFormat::Elf.

The code identifier of this object.

As opposed to Mach-O, ELF does not specify a unique ID for object files in its header. Compilers and linkers usually add either SHT_NOTE sections or PT_NOTE program header elements for this purpose.

The debug link of this object.

The debug link is an alternative to the build id for specifying the location of an ELF’s debugging information. It refers to a filename that can be used to build various debug paths where debuggers can look for the debug files.

Errors
  • None if there is no gnu_debuglink section
  • DebugLinkError if this section exists, but is malformed

The binary’s soname, if any.

The debug information identifier of an ELF object.

The debug identifier is a rehash of the first 16 bytes of the code_id, if present. Otherwise, this function will hash the first page of the .text section (program code) to synthesize a unique ID. This is likely not a valid UUID since was generated off a hash value.

If all of the above fails, the identifier will be an empty DebugId.

The CPU architecture of this object, as specified in the ELF header.

The kind of this object, as specified in the ELF header.

The address at which the image prefers to be loaded into memory.

ELF files store all internal addresses as if it was loaded at that address. When the image is actually loaded, that spot might already be taken by other images and so it must be relocated to a new address. At runtime, a relocation table manages the arithmetics behind this.

Addresses used in symbols or debug_session have already been rebased relative to that load address, so that the caller only has to deal with addresses relative to the actual start of the image.

Determines whether this object exposes a public symbol table.

Returns an iterator over symbols in the public symbol table.

Returns an ordered map of symbols in the symbol table.

Determines whether this object contains debug information.

Constructs a debugging session.

A debugging session loads certain information from the object file and creates caches for efficient access to various records in the debug information. Since this can be quite a costly process, try to reuse the debugging session as long as possible.

ELF files generally use DWARF debugging information, which is also used by MachO containers on macOS.

Constructing this session will also work if the object does not contain debugging information, in which case the session will be a no-op. This can be checked via has_debug_info.

Determines whether this object contains stack unwinding information.

Determines whether this object contains embedded source.

Determines whether this object is malformed and was only partially parsed

Returns the raw data of the ELF file.

Trait Implementations

The Self type with 'slf lifetimes, returned by as_self.
Returns a reference to self with downcasted lifetime.
Formats the value using the given formatter. Read more
Returns whether the file was compiled for a big-endian or little-endian machine. Read more
Returns information and raw data of a section. Read more
Returns information and data of a section. Read more
Determines whether the specified section exists. Read more
Errors thrown when reading information from this object.
A session that allows optimized access to debugging information.
The iterator over the symbols in the public symbol table.
The container format of this file.
The code identifier of this object. Read more
The debug information identifier of this object.
The CPU architecture of this object.
The kind of this object.
The address at which the image prefers to be loaded into memory.
Determines whether this object exposes a public symbol table.
Returns an iterator over symbols in the public symbol table.
Returns an ordered map of symbols in the symbol table.
Determines whether this object contains debug information.
Constructs a debugging session. Read more
Determines whether this object contains stack unwinding information.
Determines whether this object contains embedded sources.
Determines whether this object is malformed and was only partially parsed

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
Converts self into T using Into<T>. Read more
Given the context attached to a nom error, and given the original input to the nom parser, extract more the useful context information. Read more
Causes self to use its Binary implementation when Debug-formatted.
Causes self to use its Display implementation when Debug-formatted. Read more
Causes self to use its LowerExp implementation when Debug-formatted. Read more
Causes self to use its LowerHex implementation when Debug-formatted. Read more
Causes self to use its Octal implementation when Debug-formatted.
Causes self to use its Pointer implementation when Debug-formatted. Read more
Causes self to use its UpperExp implementation when Debug-formatted. Read more
Causes self to use its UpperHex implementation when Debug-formatted. Read more
Formats each item in a sequence. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Pipes by value. This is generally the method you want to use. Read more
Borrows self and passes that borrow into the pipe function. Read more
Mutably borrows self and passes that borrow into the pipe function. Read more
Borrows self, then passes self.borrow() into the pipe function. Read more
Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
Borrows self, then passes self.as_ref() into the pipe function.
Mutably borrows self, then passes self.as_mut() into the pipe function. Read more
Borrows self, then passes self.deref() into the pipe function.
Mutably borrows self, then passes self.deref_mut() into the pipe function. Read more
Given the original input, as well as the context reported by nom, recreate a context in the original string where the error occurred. Read more
Immutable access to a value. Read more
Mutable access to a value. Read more
Immutable access to the Borrow<B> of a value. Read more
Mutable access to the BorrowMut<B> of a value. Read more
Immutable access to the AsRef<R> view of a value. Read more
Mutable access to the AsMut<R> view of a value. Read more
Immutable access to the Deref::Target of a value. Read more
Mutable access to the Deref::Target of a value. Read more
Calls .tap() only in debug builds, and is erased in release builds.
Calls .tap_mut() only in debug builds, and is erased in release builds. Read more
Calls .tap_borrow() only in debug builds, and is erased in release builds. Read more
Calls .tap_borrow_mut() only in debug builds, and is erased in release builds. Read more
Calls .tap_ref() only in debug builds, and is erased in release builds. Read more
Calls .tap_ref_mut() only in debug builds, and is erased in release builds. Read more
Calls .tap_deref() only in debug builds, and is erased in release builds. Read more
Calls .tap_deref_mut() only in debug builds, and is erased in release builds. Read more
Attempts to convert self into T using TryInto<T>. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more