Struct ImageCache 

pub struct ImageCache { /* private fields */ }

Map from Image::content_hash to a parsed PvmProgram. The PvmProgram is wrapped in Arc so the same predecoded body can be referenced from multiple in-flight InstanceEntries (siblings) and from concurrent threads (the kernel may eventually be multi-threaded).

Implementations

impl ImageCache

pub fn new() -> Self

pub fn len(&self) -> usize

Number of cached images.

pub fn is_empty(&self) -> bool

pub fn get(&self, content_hash: &CapHash) -> Option<Arc<PvmProgram>>

Look up by content hash. None if not yet cached.

pub fn insert(&mut self, content_hash: CapHash, program: Arc<PvmProgram>)

Cache a precomputed program under the given content hash.

pub fn get_or_decode( &mut self, content_hash: CapHash, code: Vec<u8>, bitmask: Vec<u8>, jump_table: Vec<u32>, ) -> Result<Arc<PvmProgram>, VmError>

Look up or compute: if the image’s content_hash is in the cache, return the cached program; otherwise parse code, bitmask, jump_table into a PvmProgram, cache it, and return it.

pub fn clear(&mut self)

Drop all cached programs. Used at block boundaries by the chain orchestrator if it wants to free memory.

Trait Implementations

impl Debug for ImageCache

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

Formats the value using the given formatter.

impl Default for ImageCache

fn default() -> ImageCache

Returns the “default value” for a type.