Mojo function

s_waitcnt

s_waitcnt[*, vmcnt: UInt32 = 63, expcnt: UInt32 = 7, lgkmcnt: UInt32 = 15]()

Performs an s_waitcnt instruction with the specified counters on AMD GPUs.

This function waits until the number of remaining outstanding memory operations matches the given counter values: vector (vmcnt), export (expcnt), and LGKM (local/global/memory/constant, lgkmcnt). It does not wait for this many instructions to complete, but for the counters to have these exact values before proceeding.

Only effective on AMD GPUs.

Note:

Only has an effect on AMD GPUs. On other platforms, raises a compile-time error if called.
The counters should be set carefully to avoid deadlocks or missed synchronization.
For example, s_waitcnt(vmcnt=0, expcnt=0, lgkmcnt=0) waits until all memory operations are complete.

Parameters:

vmcnt (UInt32): Waits until the remaining VMEM instructions is equal to this value (default: max).
expcnt (UInt32): Waits until the remaining export (GDS) instructions is equal to this value (default: max).
lgkmcnt (UInt32): Waits until the remaining LDS, GDS, constant-fetch, and message instructions is equal to this value (default: max).