Struct CachedKernel 

pub struct CachedKernel {
    pub fingerprint: u64,
    pub ptx: Arc<EmittedPtx>,
    pub compiled: CompiledHandle,
    /* private fields */
}

Cached PTX module entry.

integrity_hash is a BLAKE3 over ptx.text computed at construction time and re-verified on every KernelCache::get (jit S-3). It defends against in-memory poisoning by a sibling holder of a mutable reference and forms the basis of the integrity tag stored in the on-disk persistence layer (see DiskCacheConfig). The field is pub so downstream tests and observability can inspect the recorded hash, but construction via CachedKernel::new is the only path that produces a correct-by-construction value — KernelCache::put calls verify before accepting the entry, so a hand-crafted CachedKernel with a mismatched hash will be rejected.

Fields

fingerprint: u64

The blueprint that produced this PTX (for diagnostics).

ptx: Arc<EmittedPtx>

The emitted PTX text.

compiled: CompiledHandle

The cuda module handle is only meaningful when the cuda feature is on; for the stub path we keep ().

Implementations

impl CachedKernel

pub fn integrity_hash(&self) -> &[u8; 32]

Borrow the stored BLAKE3 integrity hash over ptx.text. Prefer this over reaching for the (hidden) field directly — the field is retained as pub for source compatibility only and may be sealed to pub(crate) in a future minor release.

pub fn new( fingerprint: u64, ptx: Arc<EmittedPtx>, compiled: CompiledHandle, ) -> Self

Construct a CachedKernel, computing integrity_hash from ptx.text. This is the only way to obtain a correct-by- construction value; the older struct-literal pattern still works (the field is pub for backward compatibility) but the literal must provide a matching hash or KernelCache::put will reject it.

pub fn verify_integrity(&self) -> bool

Re-compute the integrity hash and compare it against the stored value. Returns true iff the PTX text has not been tampered with since Self::new ran.

Trait Implementations

impl Clone for CachedKernel

fn clone(&self) -> CachedKernel

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CachedKernel

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.