Struct DirectGpuScanner 

pub struct DirectGpuScanner { /* private fields */ }

State for a pipelined direct-to-GPU scan.

Implementations

impl DirectGpuScanner

pub fn compile(patterns: &[&[u8]]) -> Self

Compile a set of literal patterns into a direct GPU matcher.

pub fn program(&self) -> &Program

Return the compiled packed-byte GPU program.

pub fn literal_set_cache_key(&self) -> String

Cache identity of the underlying literal set. Used by the MatchScan::cache_key impl so DirectGpuScanner caches don’t fork from the literal-set caches.

pub fn reference_scan(&self, haystack: &[u8]) -> Vec<Match>

CPU oracle for parity and tests.

pub fn scan<B: VyreBackend + ?Sized>( &self, backend: &B, haystack: &[u8], max_matches: u32, ) -> Result<Vec<Match>, BackendError>

Dispatch the direct packed-byte matcher through a concrete backend.

Errors

Returns vyre::BackendError when the backend cannot dispatch or read back the compiled matcher.

Trait Implementations

impl MatchScan for DirectGpuScanner

fn scan( &self, backend: &dyn VyreBackend, haystack: &[u8], max_matches: u32, ) -> Result<Vec<Match>, BackendError>

GPU dispatch through a concrete backend, returning up to max_matches matches. Engines pre-allocate the hit buffer at max_matches * 3 + 1 u32 slots; setting this too low silently truncates results.

fn reference_scan(&self, haystack: &[u8]) -> Vec<Match>

Reference oracle scan. Used by the cross-layer parity tests in vyre-conform; engines that lack a meaningful CPU stepper (none today) can return an empty vec but should never fabricate results.

fn cache_key(&self) -> String

Stable identity for cache filenames + telemetry. Engines hash their pattern set + version constant. Consumers pass this straight to cached_load_or_compile without further hashing.

fn try_reference_scan( &self, haystack: &[u8], ) -> Result<Vec<Match>, BackendError>

Fallible reference oracle scan. Surfaces a CPU-stepper failure (a haystack longer than the u32 match ABI the GPU path uses) as an error instead of aborting, so consumers holding dyn MatchScan can recover. The default delegates to the infallible Self::reference_scan for engines whose stepper genuinely cannot fail; engines with a fallible stepper override this to forward to their real fallible scan (and never route through the panicking infallible wrapper).