Skip to main content

Crate mimir_node_map

Crate mimir_node_map 

Source
Expand description

Shared node-map wire format. This crate carries no image reader or binding engine.

Re-exports§

pub use source_file::clean_source_path;
pub use source_file::same_source_file;
pub use inline::*;

Modules§

contraction
Derive order from proven absent/optional hole boundaries. No wire witness.
inline
Serialized observations for the common inlined-binding contract. These records do not themselves establish runtime acceptance.
merged_extent
R1 observations from executable bytes outside known function extents.
outside
Machine-entry observations for conditional outside-reach coverage.
position
Structural position classification shared by producer and consumer.
proof
Stable proof identifiers. Legacy descriptions are read for diagnostics; unknown rules remain unaccepted. Readiness policy lives with the consumer.
reach
Reach from each entry’s first nodes, over only that entry’s directed pairs.
source_file
The driver’s lexical path algorithm; this does not establish file identity.

Structs§

BinEdge
One edge of the binary CFG of a function no DWARF scope covers.
BindingRefusal
BindingRefusals
DirectCall
A copy where the compiler made a hole’s call direct: the call (or jump) instruction and its target, a function whose symbol is among the hole node’s targets.
EntryFunction
One exec entry and its function.
Frame
One place in the source: an instance (its symbol), a file and a line.
HoleEdge
One exec.edges pair into or out of a hole node.
HoleNode
One hole node pair of the exec graph: a call through a pointer (site, kind hole) and its continuation (return_site, kind hole-return).
HoleReturn
One hole of the site table and where execution comes back after it.
MappedSite
One mapped call site.
MergedPosition
One merged instruction shared by every reachable candidate in a call closure.
ThreadEntries
A thread start of the site table and the exec entries a thread started there may run.
UnmappedSite
One call site the map does not tie to instructions.

Enums§

BindingRefusalKind
HoleHow
How a hole node’s call was tied to instructions.
HoleKind
What the instruction at a hole is, as decoded (never inferred).
MapHow
How a call site was tied to instructions.
Unmapped
Why a call site is not mapped.

Constants§

PROOF_ENTRY
The proof of an entry’s address.
PROOF_ENTRY_DWARF
The proof of an inlined entry’s addresses.
PROOF_ENTRY_MAIN
The proof of a process entry’s address when its instance has no code of its own.
PROOF_HOLE
The proof of a hole node’s call binding.
PROOF_HOLE_DIRECT
The proof of a hole node’s call binding where some copy’s call was made direct.
PROOF_HOLE_DUPLICATED
The proof of a hole node’s call binding where a copy holds the call more than once.
PROOF_HOLE_EDGE
The proof of a pair into or out of a hole node.
PROOF_HOLE_INLINED
Why a hole node pair whose target was inlined is bound and no position of a followed thread.
PROOF_HOLE_MERGED
The call closure, rather than a possibly incomplete DWARF scope list, bounds candidates.
PROOF_HOLE_OUTSIDE_REACH
Conditional on scope-ancestor and exec-reach; absence of a scope is no evidence.
PROOF_HOLE_PURE_CALL
Why a hole the site table lists needs no binding (pure_calls).
PROOF_HOLE_QUIET
Why a hole node pair is no position of a followed thread (quiet_holes).
PROOF_HOLE_REPORT
The instance has no DWARF copy; its unique report function extent holds one indirect call whose proven targets are all named by the exec hole.
PROOF_HOLE_RETURN
The proof of a hole node’s continuation binding.
PROOF_HOLE_RETURN_TAIL
The proof of a hole node’s continuation where some copy is a tail jump (tail_returns).
PROOF_HOLE_SITE
The proof of a hole node’s call binding when its exec block is also a mapped call site.
PROOF_HOLE_UNREACHED
A node outside every entry’s directed closure of its first nodes.
PROOF_KERNEL_IPS
The proof of the kernel addresses of a call or pointer-constant call site.
PROOF_KERNEL_IPS_ASM
The proof of the kernel addresses of a syscall call site.
PROOF_KERNEL_IPS_NULL
A call site whose every call is to address 0 (a weak symbol the link left undefined) reaches no syscall instruction: its kernel IP list is proven empty.
PROOF_KERNEL_IPS_OPENS
The proof of the kernel addresses of a call site whose reach passes an indirect transfer (the call itself, or a hole of the site table in a reached function).
PROOF_REGISTER_CONSTANT
How a call through a callee-saved register gets its target (register_constants).
PROOF_SITE
The proof of a mapped call site.
PROOF_SITE_ASM_INLINED
The proof of an inline-assembly call site whose system-call wrapper was inlined at its line.
PROOF_SITE_ASM_ONLY
The proof of an instance’s only inline-assembly call site that takes the syscall instructions of the wrappers inlined into it.
PROOF_SITE_POINTER
The proof of a MapHow::PointerConstant call site.
PROOF_SITE_REPORT
The instance has no DWARF copy; its unique symbol-table function extent in the pinned report contains the sole assembly row’s syscall instructions.
REQUIRED_ENTRY_KINDS
The entry kinds Enforce needs an address for.