Enum samply_symbols::CodeId

pub enum CodeId {
    PeCodeId(PeCodeId),
    MachoUuid(Uuid),
    ElfBuildId(ElfBuildId),
}

An enum carrying an identifier for a binary. This is stores the same information as a debugid::CodeId, but without projecting it down to a string.

All types need to be treated rather differently, see their respective documentation.

Variants

PeCodeId(PeCodeId)

The code ID for a Windows PE file. When combined with the binary name, the code ID lets you obtain binaries from symbol servers. It is not useful on its own, it has to be paired with the binary name.

On Windows, a binary’s code ID is distinct from its debug ID (= pdb GUID + age). If you have a binary file, you can get both the code ID and the debug ID from it. If you only have a PDB file, you usually cannot get the code ID of the corresponding binary from it.

MachoUuid(Uuid)

The code ID for a macOS / iOS binary (mach-O). This is just the mach-O UUID. The mach-O UUID is shared between both the binary file and the debug file (dSYM), and it can be used on its own to find dSYMs using Spotlight.

The debug ID and the code ID contain the same information; the debug ID is literally just the UUID plus a zero at the end.

ElfBuildId(ElfBuildId)

The code ID for a Linux ELF file. This is the “ELF build ID” (also called “GNU build ID”). The build ID is usually 20 bytes, commonly written out as 40 hex chars.

It can be used to find debug files on the local file system or to download binaries or debug files from a debuginfod symbol server. it does not have to be paired with the binary name.

An ELF binary’s code ID is more useful than its debug ID: The debug ID is truncated to 16 bytes (32 hex characters), whereas the code ID is the full ELF build ID.

Trait Implementations

impl Clone for CodeId

fn clone(&self) -> CodeId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CodeId

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

Formats the value using the given formatter.

impl Display for CodeId

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

Formats the value using the given formatter.

impl FromStr for CodeId

type Err = ()

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for CodeId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for CodeId

fn cmp(&self, other: &CodeId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<CodeId> for CodeId

fn eq(&self, other: &CodeId) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<CodeId> for CodeId

fn partial_cmp(&self, other: &CodeId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for CodeId

impl StructuralEq for CodeId

impl StructuralPartialEq for CodeId