Struct Symbol

#[repr(C)]
pub struct Symbol {
    pub name: [u8; 8],
    pub value: u32,
    pub section_number: i16,
    pub typ: u16,
    pub storage_class: u8,
    pub number_of_aux_symbols: u8,
}

A COFF symbol.

Unwind information for this function can be loaded with ExceptionData::get_unwind_info.

Fields

name: [u8; 8]

The name of the symbol.

An array of 8 bytes is used if the name is not more than 8 bytes long. This array is padded with nulls on the right if the name is less than 8 bytes long.

For longer names, the first 4 bytes are all zeros, and the second 4 bytes are an offset into the string table.

value: u32

The value that is associated with the symbol.

The interpretation of this field depends on section_number and storage_class. A typical meaning is the relocatable address.

section_number: i16

A one-based index into the section table. Zero and negative values have special meanings.

typ: u16

A number that represents type.

Microsoft tools set this field to 0x20 (function) or 0x0 (not a function).

storage_class: u8

An enumerated value that represents storage class.

number_of_aux_symbols: u8

The number of auxiliary symbol table entries that follow this record.

Each auxiliary record is the same size as a standard symbol-table record (18 bytes), but rather than define a new symbol, the auxiliary record gives additional information on the last symbol defined.

Implementations

impl Symbol

pub fn parse<'a>( bytes: &'a [u8], offset: usize, ) -> Result<(Option<&'a str>, Symbol)>

Parse the symbol at the given offset.

If the symbol has an inline name, then also returns a reference to the name’s location in bytes.

pub fn name<'a>(&'a self, strtab: &'a Strtab<'_>) -> Result<&'a str>

Returns the symbol name.

This may be a reference to an inline name in the symbol, or to a strtab entry.

pub fn name_offset(&self) -> Option<u32>

Return the strtab offset of the symbol name.

Returns None if the name is inline.

pub fn set_name_offset(&mut self, offset: u32)

Set the strtab offset of the symbol name.

pub fn base_type(&self) -> u16

Return the base type of the symbol.

This type uses the IMAGE_SYM_TYPE_* definitions.

pub fn derived_type(&self) -> u16

Return the derived type of the symbol.

This type uses the IMAGE_SYM_DTYPE_* definitions.

pub fn is_function_definition(&self) -> bool

Return true for function definitions.

These symbols use AuxFunctionDefinition for auxiliary symbol records.

pub fn is_weak_external(&self) -> bool

Return true for weak external symbols.

These symbols use AuxWeakExternal for auxiliary symbol records.

pub fn is_file(&self) -> bool

Return true for file symbol records.

The auxiliary records contain the name of the source code file.

pub fn is_section_definition(&self) -> bool

Return true for section definitions.

These symbols use AuxSectionDefinition for auxiliary symbol records.

Trait Implementations

impl Clone for Symbol

fn clone(&self) -> Symbol

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Symbol

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

Formats the value using the given formatter.

impl Default for Symbol

fn default() -> Symbol

Returns the “default value” for a type.

impl FromCtx<Endian> for Symbol

fn from_ctx(src: &[u8], ctx: Endian) -> Self

impl<'a> IntoCtx<Endian> for &'a Symbol

fn into_ctx(self, dst: &mut [u8], ctx: Endian)

impl IntoCtx<Endian> for Symbol

fn into_ctx(self, dst: &mut [u8], ctx: Endian)

impl PartialEq for Symbol

fn eq(&self, other: &Symbol) -> 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 SizeWith<Endian> for Symbol

fn size_with(ctx: &Endian) -> usize

impl<'a> TryFromCtx<'a, Endian> for Symbol

where Symbol: 'a,

type Error = Error

fn try_from_ctx( src: &'a [u8], ctx: Endian, ) -> Result<(Self, usize), Self::Error>

impl<'a> TryIntoCtx<Endian> for &'a Symbol

type Error = Error

fn try_into_ctx(self, dst: &mut [u8], ctx: Endian) -> Result<usize, Self::Error>

impl TryIntoCtx<Endian> for Symbol

type Error = Error

fn try_into_ctx(self, dst: &mut [u8], ctx: Endian) -> Result<usize, Self::Error>

impl Copy for Symbol

impl StructuralPartialEq for Symbol