Struct RingContext 

pub struct RingContext<'a> {
    pub thread_id: ThreadId,
    pub block_id: BlockId,
    pub block_dim: Dim3,
    pub grid_dim: Dim3,
    clock: &'a HlcClock,
    kernel_id: u64,
    backend: ContextBackend,
}

GPU intrinsics facade for kernel handlers.

This struct provides access to GPU-specific operations like thread identification, synchronization, and atomic operations. The actual implementation varies by backend.

Lifetime

The context is borrowed for the duration of the kernel handler execution.

Fields

thread_id: ThreadId

Thread identity within block.

block_id: BlockId

Block identity within grid.

block_dim: Dim3

Block dimensions.

grid_dim: Dim3

Grid dimensions.

clock: &'a HlcClock

HLC clock instance.

kernel_id: u64

Kernel ID.

backend: ContextBackend

Backend implementation.

Implementations

impl<'a> RingContext<'a>

pub fn new( thread_id: ThreadId, block_id: BlockId, block_dim: Dim3, grid_dim: Dim3, clock: &'a HlcClock, kernel_id: u64, backend: ContextBackend, ) -> Self

Create a new context.

pub fn thread_id(&self) -> ThreadId

Get thread ID within block.

pub fn block_id(&self) -> BlockId

Get block ID within grid.

pub fn global_thread_id(&self) -> GlobalThreadId

Get global thread ID across all blocks.

pub fn warp_id(&self) -> WarpId

Get warp ID within block.

pub fn lane_id(&self) -> u32

Get lane ID within warp (0-31).

pub fn block_dim(&self) -> Dim3

Get block dimensions.

pub fn grid_dim(&self) -> Dim3

Get grid dimensions.

pub fn kernel_id(&self) -> u64

Get kernel ID.

pub fn sync_threads(&self)

Synchronize all threads in the block.

All threads in the block must reach this barrier before any thread can proceed past it.

pub fn sync_grid(&self)

Synchronize all threads in the grid (cooperative groups).

Requires cooperative kernel launch support.

pub fn sync_warp(&self)

Synchronize threads within a warp.

pub fn thread_fence(&self, scope: FenceScope)

Memory fence at the specified scope.

pub fn fence_thread(&self)

Thread-scope fence (compiler barrier).

pub fn fence_block(&self)

Block-scope fence.

pub fn fence_device(&self)

Device-scope fence.

pub fn fence_system(&self)

System-scope fence (CPU+GPU visible).

pub fn now(&self) -> HlcTimestamp

Get current HLC timestamp.

pub fn tick(&self) -> HlcTimestamp

Generate a new HLC timestamp (advances clock).

pub fn update_clock(&self, received: &HlcTimestamp) -> Result<HlcTimestamp>

Update clock with received timestamp.

pub fn atomic_add(&self, ptr: &AtomicU64, val: u64, order: MemoryOrder) -> u64

Atomic add and return old value.

pub fn atomic_cas( &self, ptr: &AtomicU64, expected: u64, desired: u64, success: MemoryOrder, failure: MemoryOrder, ) -> Result<u64, u64>

Atomic compare-and-swap.

pub fn atomic_exchange( &self, ptr: &AtomicU64, val: u64, order: MemoryOrder, ) -> u64

Atomic exchange.

pub fn warp_shuffle<T: Copy>(&self, value: T, src_lane: u32) -> T

Warp shuffle - get value from another lane.

Returns the value from the specified source lane.

pub fn warp_shuffle_down<T: Copy>(&self, value: T, delta: u32) -> T

Warp shuffle down - get value from lane + delta.

pub fn warp_shuffle_up<T: Copy>(&self, value: T, delta: u32) -> T

Warp shuffle up - get value from lane - delta.

pub fn warp_shuffle_xor<T: Copy>(&self, value: T, mask: u32) -> T

Warp shuffle XOR - get value from lane XOR mask.

pub fn warp_ballot(&self, predicate: bool) -> u32

Warp ballot - get bitmask of lanes where predicate is true.

pub fn warp_all(&self, predicate: bool) -> bool

Warp all - check if predicate is true for all lanes.

pub fn warp_any(&self, predicate: bool) -> bool

Warp any - check if predicate is true for any lane.

pub fn k2k_send( &self, _target_kernel: u64, _envelope: &MessageEnvelope, ) -> Result<()>

Send message to another kernel (K2K).

This is a placeholder; actual implementation requires runtime support.

pub fn k2k_try_recv(&self) -> Result<MessageEnvelope>

Try to receive message from K2K queue.

Trait Implementations

impl<'a> Debug for RingContext<'a>

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

Formats the value using the given formatter.