Struct SolverHandle 

pub struct SolverHandle { /* private fields */ }

Central handle for solver operations.

Every solver routine requires a SolverHandle. The handle binds operations to a specific CUDA context and stream, provides access to the underlying BLAS handle for delegating matrix operations, and manages a resizable device workspace buffer.

Thread safety

SolverHandle is Send but not Sync. Each thread should create its own handle (possibly sharing the same Arc<Context>).

Implementations

impl SolverHandle

pub fn new(ctx: &Arc<Context>) -> SolverResult<Self>

Creates a new solver handle with a freshly-allocated default stream.

The device’s compute capability is queried once and cached as an SmVersion for later kernel dispatch decisions. An initial workspace of 4 KiB is allocated.

Errors

Returns SolverError::Cuda if stream creation or device query fails. Returns SolverError::Blas if BLAS handle creation fails.

pub fn ensure_workspace(&mut self, bytes: usize) -> SolverResult<()>

Ensures the workspace buffer has at least bytes capacity.

If the current workspace is smaller, it is reallocated. The contents of the previous workspace are not preserved.

Errors

Returns SolverError::Cuda if reallocation fails.

pub fn blas(&self) -> &BlasHandle

Returns a reference to the underlying BLAS handle.

pub fn blas_mut(&mut self) -> &mut BlasHandle

Returns a mutable reference to the underlying BLAS handle.

pub fn stream(&self) -> &Stream

Returns a reference to the stream used for kernel launches.

pub fn context(&self) -> &Arc<Context>

Returns a reference to the CUDA context.

pub fn sm_version(&self) -> SmVersion

Returns the SM version of the bound device.

pub fn ptx_cache(&self) -> &PtxCache

Returns a reference to the PTX cache.

pub fn ptx_cache_mut(&mut self) -> &mut PtxCache

Returns a mutable reference to the PTX cache.

pub fn workspace(&self) -> &DeviceBuffer<u8>

Returns a reference to the device workspace buffer.

pub fn workspace_mut(&mut self) -> &mut DeviceBuffer<u8>

Returns a mutable reference to the device workspace buffer.