Struct GraphExec 

pub struct GraphExec { /* private fields */ }

An instantiated (executable) CUDA graph.

Implementations

impl GraphExec

pub fn launch(&self, stream: &Stream) -> Result<()>

Launch this graph on stream. Can be called repeatedly — that’s the whole point of CUDA graphs.

pub fn as_raw(&self) -> CUgraphExec

Raw CUgraphExec. Use with care.

pub fn update(&self, new_template: &Graph) -> Result<UpdateResult>

Try to update this executable graph in place based on a new template graph. Returns Ok(info) in all cases — inspect UpdateResult to distinguish success from the various reasons CUDA refused the update. On refusal, the executable graph is left unchanged (not corrupted), so the caller can fall back to re-instantiating.

Only topology-invariant changes are allowed (same number + type of nodes, same dependency edges). Changes to kernel arguments, grid dims, memset values, memcpy params, etc. are supported.

pub unsafe fn set_kernel_node_params( &self, node: GraphNode, params: &CUDA_KERNEL_NODE_PARAMS, ) -> Result<()>

Live-edit a kernel-node’s parameters on the instantiated graph. Avoids re-instantiation when only arg values / grid dims / shmem change. The topology must match (no new nodes, no new edges).

Safety

Same launch invariants as crate::LaunchBuilder::launch.

pub fn set_memcpy_node_params( &self, node: GraphNode, params: &CUDA_MEMCPY3D, ) -> Result<()>

Live-edit a memcpy-node’s parameters on the instantiated graph.

pub fn set_memset_node_params( &self, node: GraphNode, params: &CUDA_MEMSET_NODE_PARAMS, ) -> Result<()>

Live-edit a memset-node’s parameters on the instantiated graph.

pub unsafe fn set_host_node_params( &self, node: GraphNode, fn_: unsafe extern "C" fn(*mut c_void), user_data: *mut c_void, ) -> Result<()>

Live-edit a host-node’s callback on the instantiated graph.

Safety

fn_ must remain callable with user_data for the lifetime of this GraphExec.

Trait Implementations

impl Clone for GraphExec

fn clone(&self) -> GraphExec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphExec

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

Formats the value using the given formatter.