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.
- Binding
Refusal - Binding
Refusals - Direct
Call - 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.
- Entry
Function - One exec entry and its function.
- Frame
- One place in the source: an instance (its symbol), a file and a line.
- Hole
Edge - One
exec.edgespair into or out of a hole node. - Hole
Node - One hole node pair of the exec graph: a call through a pointer (
site, kindhole) and its continuation (return_site, kindhole-return). - Hole
Return - One hole of the site table and where execution comes back after it.
- Mapped
Site - One mapped call site.
- Merged
Position - One merged instruction shared by every reachable candidate in a call closure.
- Thread
Entries - A thread start of the site table and the exec entries a thread started there may run.
- Unmapped
Site - One call site the map does not tie to instructions.
Enums§
- Binding
Refusal Kind - HoleHow
- How a hole node’s call was tied to instructions.
- Hole
Kind - 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
callorpointer-constantcall site. - PROOF_
KERNEL_ IPS_ ASM - The proof of the kernel addresses of a
syscallcall 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::PointerConstantcall 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.