TechnologiesDeveloper Tools & Diagnostics

Runtime

iOSmacOStvOSwatchOSvisionOS

Runtime captures and symbolicates backtraces and inspects a process's address space for runtime diagnostics on macOS. Use Backtrace to capture a sequence of program counters and SymbolicatedBacktrace to resolve those frames to symbols, surfacing failures through DemanglingError when a mangled name cannot be decoded. Inspect the layout of loaded code with ImageMap, and examine individual binary sections using SectionInfo and SectionCharacteristics.

Capturing Backtraces 2

Capture the sequence of program counters that led to a point in execution and resolve them to symbols.

  • St
    BacktracemacOS 26.0+
    Holds a backtrace.
  • St
    SymbolicatedBacktracemacOS 26.0+
    A symbolicated backtrace

Inspecting the Address Space 3

Examine the layout of loaded code and the binary sections that make up a process's image.

  • St
    ImageMapmacOS 26.0+
    Holds a map of the process's address space.
  • St
    SectionInfo
    A structure that describes an individual section within a loaded binary image.
  • St
    SectionCharacteristics
    A structure that describes the attributes and properties of a binary section.

Errors 1

Failures that arise when a mangled symbol name cannot be decoded during symbolication.

  • En
    DemanglingError
    Error thrown to indicate failure to demangle a Swift symbol.

Extends 1

FixedWidthInteger
← Developer Tools & Diagnostics