docs/AMDGPU/gfx9_waitcnt.rst

   1 ..
   2     **************************************************
   3     *                                                *
   4     *   Automatically generated file, do not edit!   *
   5     *                                                *
   6     **************************************************
   7
   8 .. _amdgpu_synid9_waitcnt:
   9
  10 waitcnt
  11 ===========================
  12
  13 Counts of outstanding instructions to wait for.
  14
  15 The bits of this operand have the following meaning:
  16
  17     ============ ======================================================
  18     Bits         Description
  19     ============ ======================================================
  20     3:0          VM_CNT: vector memory operations count, lower bits.
  21     6:4          EXP_CNT: export count.
  22     11:8         LGKM_CNT: LDS, GDS, Constant and Message count.
  23     15:14        VM_CNT: vector memory operations count, upper bits.
  24     ============ ======================================================
  25
  26 This operand may be specified as a positive 16-bit :ref:`integer_number<amdgpu_synid_integer_number>`
  27 or as a combination of the following symbolic helpers:
  28
  29     ====================== ======================================================================
  30     Syntax                 Description
  31     ====================== ======================================================================
  32     vmcnt(<*N*>)           VM_CNT value. *N* must not exceed the largest VM_CNT value.
  33     expcnt(<*N*>)          EXP_CNT value. *N* must not exceed the largest EXP_CNT value.
  34     lgkmcnt(<*N*>)         LGKM_CNT value. *N* must not exceed the largest LGKM_CNT value.
  35     vmcnt_sat(<*N*>)       VM_CNT value computed as min(*N*, the largest VM_CNT value).
  36     expcnt_sat(<*N*>)      EXP_CNT value computed as min(*N*, the largest EXP_CNT value).
  37     lgkmcnt_sat(<*N*>)     LGKM_CNT value computed as min(*N*, the largest LGKM_CNT value).
  38     ====================== ======================================================================
  39
  40 These helpers may be specified in any order. Ampersands and commas may be used as optional separators.
  41
  42 *N* is either an
  43 :ref:`integer number<amdgpu_synid_integer_number>` or an
  44 :ref:`absolute expression<amdgpu_synid_absolute_expression>`.
  45
  46 Examples:
  47
  48 .. parsed-literal::
  49
  50     s_waitcnt 0
  51     s_waitcnt vmcnt(1)
  52     s_waitcnt expcnt(2) lgkmcnt(3)
  53     s_waitcnt vmcnt(1) expcnt(2) lgkmcnt(3)
  54     s_waitcnt vmcnt(1), expcnt(2), lgkmcnt(3)
  55     s_waitcnt vmcnt(1) & lgkmcnt_sat(100) & expcnt(2)
  56