Expand description
Backend-neutral compilation from validated typed graphs to immutable artifacts.
§Ownership
This crate owns the whole-program compile seam:
- input: a validated typed
ProgramGraph, immutableExternalFacts, and explicitSearchBudget - output: one versioned immutable
Artifactplus optionalTargetPayloadvalues in anArtifactEnvelope
Device admission, materialization, submission, queues, residency, and recovery are consumers of this compiler product and do not alter artifact identity.
Re-exports§
pub use target::attach_target;pub use target::compile_selected_modules;pub use target::EmittedTargetModule;pub use target::SelectedLowering;pub use target::TargetCompileError;pub use target::TargetCompiler;pub use target::TargetModuleBundle;pub use target::TargetModuleImage;pub use target::TARGET_MODULE_BUNDLE_SCHEMA_VERSION;
Modules§
- cost
- Open, reproducible whole-program candidate cost model.
- legality
- Stable semantic legality decisions for whole-program fusion.
- target
- Target compiler facets over compiler-selected modules and canonical ABI.
Structs§
- Artifact
- Versioned immutable canonical whole-program compiler result.
- Artifact
Abi - Canonical resource and entry ABI projected to every target payload.
- Artifact
Envelope - Canonical versioned envelope containing one neutral artifact and target attachments.
- Artifact
Node Id - Canonical node identity inside an artifact.
- Artifact
Value Id - Canonical value identity inside an artifact.
- Barrier
Record - Dependency-completion boundary between canonical stages.
- Compile
Error - Compilation or artifact-validation failure.
- Compile
Request - Unvalidated whole-program compilation request.
- Dependency
Edge - One canonical typed dependency edge.
- Diagnostic
- Serializable diagnostic shared by compiler, AOT, runtime, and drivers.
- Digest
- Stable 256-bit content identity.
- Entry
AbiRecord - One canonical executable entry in the whole-program ABI.
- External
Facts - Stable external semantic facts not encoded by graph topology.
- Fusion
Group Id - Canonical fusion-group identity inside an artifact.
- Fusion
Record - Canonical compiler-selected fusion group.
- Fusion
Rejection - Stable evidence that one proposed fusion was pruned before selection.
- Geometry
Record - Neutral per-node logical geometry.
- Materialization
Record - Canonical value materialization fact.
- Node
Record - Canonical executable-node payload.
- Provenance
- Deterministic identities establishing how an artifact was produced.
- Resource
AbiRecord - One canonical resource slot in the whole-program ABI.
- Resource
Envelope - Aggregate checked resource envelope.
- Resource
Record - Canonical resource and liveness fact for one typed graph value.
- Search
Budget - Explicit bounds for one whole-program schedule search.
- Search
Work - Exact bounded work performed while selecting a whole-program plan.
- Selected
Plan - Immutable compiler-selected whole-program plan.
- Target
Entry Point - Metadata for one entry in an attached target payload.
- Target
Payload - Digest-bound target bytes attached to one exact neutral artifact.
- Target
Payload Format - Versioned identity of target bytes without assigning concrete target semantics.
- Target
Profile - Immutable capability profile used for pure target compilation.
- Target
Resource Binding - Target binding metadata associated with one canonical neutral resource.
- Validated
Compile Request - A graph and complete immutable facts that passed request validation.
Enums§
- AbiAccess
- Canonical neutral resource access.
- Dependency
Endpoint - Dependency endpoint with an explicit identity domain.
- Dependency
Kind - Semantic reason that one artifact record depends on another.
- Materialization
Reason - Reason a typed value crosses a fusion-group boundary.
- Resource
Lifetime - Graph value lifetime represented in the artifact schema.
- Target
Resource Access - Access required by one target resource binding.
- Target
Resource Memory - Neutral memory class required by one target resource binding.
Constants§
- ARTIFACT_
ENVELOPE_ SCHEMA_ VERSION - Current schema for the artifact envelope that carries neutral data and target payloads.
- ARTIFACT_
SCHEMA_ VERSION - Current canonical artifact schema.
- TARGET_
PAYLOAD_ SCHEMA_ VERSION - Current schema for one target payload attachment.
Functions§
- compile
- Compile one validated typed graph into a canonical backend-neutral artifact.