Crate symbolic_common

Common functionality for symbolic.

This crate exposes a set of key types:

• ByteView: Gives access to binary data in-memory or on the file system.
• SelfCell: Allows to create self-referential types.
• Name: A symbol name that can be demangled with the demangle feature.
• InstructionInfo: A utility type for instruction pointer heuristics.
• Functions and utilities to deal with paths from different platforms.

Features

• serde (optional): Implements serde::Deserialize and serde::Serialize for all data types. In the symbolic crate, this feature is exposed via common-serde.

This module is part of the symbolic crate.

Structs

BreakpadFormat

Wrapper around DebugId for Breakpad formatting.

ByteView

A smart pointer for byte data.

CodeId

Unique platform-dependent identifier of code files.

DebugId

Unique identifier for debug information files and their debug information.

InstructionInfo

Helper to work with instruction addresses.

Name

The name of a potentially mangled symbol.

ParseCodeIdError

Indicates an error parsing a CodeId.

ParseDebugIdError

Indicates an error parsing a DebugId.

SelfCell

A container carrying a derived object alongside its owner.

UnknownArchError

An error returned for an invalid Arch.

UnknownLanguageError

An error returned for an invalid Language.

Uuid

A Universally Unique Identifier (UUID).

Enums

Arch

An enumeration of CPU architectures and variants.

CpuFamily

Represents a family of CPUs.

Language

A programming language declared in debugging information.

NameMangling

A Names mangling state.

Traits

AsSelf

Safe downcasting of dependent lifetime bounds on structs.

DSymPathExt

Extensions to Path for handling dSYM directories.

StableDeref

An unsafe marker trait for types that deref to a stable address, even when moved. For example, this is implemented by Box, Vec, Rc, Arc and String, among others. Even when a Box is moved, the underlying storage remains at a fixed location.

Functions

clean_path

Simplifies paths by stripping redundant components.

join_path

Joins paths of various platforms.

shorten_path

Trims a path to a given length.

split_path

Splits off the last component of a path.

split_path_bytes

Splits off the last component of a path given as bytes.