Struct LaunchSpec 

pub struct LaunchSpec {
    pub grid_dim: (u32, u32, u32),
    pub block_dim: (u32, u32, u32),
    pub cluster_dim: ClusterDim,
    pub shared_bytes: u32,
    pub allow_non_portable_cluster: bool,
}

Full launch specification for a cluster-aware kernel.

Mirrors cudaLaunchKernelExC’s cudaLaunchConfig_t: (gridDim, blockDim, sharedBytes, stream) with the cluster dimension threaded through the attributes array.

Fields

grid_dim: (u32, u32, u32)

block_dim: (u32, u32, u32)

cluster_dim: ClusterDim

shared_bytes: u32

allow_non_portable_cluster: bool

Opt-in to clusters > 8 blocks (Blackwell only).

Implementations

impl LaunchSpec

pub fn new(grid_dim: (u32, u32, u32), block_dim: (u32, u32, u32)) -> Self

Construct a spec with no cluster (1×1×1) — equivalent to the classic 3-tuple launch surface.

pub fn with_cluster(self, cluster: ClusterDim) -> Result<Self, ClusterError>

Builder: set the cluster dimension. Validates against the 8-block portable cap on construction.

pub fn allow_non_portable(self) -> Self

Builder: opt into non-portable cluster sizes (>8 blocks). Caller must re-validate the cluster afterwards.

pub fn with_shared_bytes(self, bytes: u32) -> Self

Builder: set dynamic shared-memory bytes.

pub fn has_cluster(&self) -> bool

True if this spec has a non-trivial cluster dim (anything other than 1×1×1).

Trait Implementations

impl Clone for LaunchSpec

fn clone(&self) -> LaunchSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LaunchSpec

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

Formats the value using the given formatter.