Skip to main content

Crate subetha_core

Crate subetha_core 

Source
Expand description

Substrate for adaptive primitives.

The four core abstractions actually consumed by the IPC stack:

  • HandshakeHeader - per-instance generation counter and in-flight tracker.
  • ObservationRing - TLS-local ring buffer for op observations.
  • migration - dual-stack migration protocol primitives.
  • Marshal - type-system contract for “this value can cross an address-space boundary byte-identically.” Stricter than Send; required by every cross-process primitive in subetha-cxc that stores typed values (e.g. SharedDeque<T>).

Plus the architecture catalog (Axis / AxisMask) for direction signatures and the cpuid helpers for CPU-feature detection.

Every adaptive primitive in subetha-pointers and subetha-cxc carries a HandshakeHeader at a known offset.

Re-exports§

pub use axis_signature::Axis;
pub use axis_signature::AxisMask;
pub use axis_signature::Fusion;
pub use cpuid::has_movdir64b;
pub use cpuid::has_waitpkg;
pub use handshake::HandshakeHeader;
pub use marshal::Marshal;
pub use marshal::MarshalError;
pub use migration::Generation;
pub use migration::MigrationGuard;
pub use observation::Observation;
pub use observation::ObservationRing;
pub use observation::any_observer_armed;
pub use observation::thread_id;

Modules§

axis_signature
AxisSignature - direction-signature catalog for the SubEtha design cube, spanning both the concurrent-data-structure domain (deque variants) and the exotic-pointer domain.
cpuid
Tiny CPUID feature-detection surface that adaptive primitives across the SubEtha workspace consult to gate hardware-acceleration paths.
handshake
Per-instance handshake header: generation + in-flight refcounts.
marshal
The Marshal trait - the type-system contract for “this value can cross an address-space boundary byte-identically.”
migration
Dual-stack migration protocol.
observation
TLS-local observation ring.