brintos

brintos / llvm-project-archived public Read only

0
0
Text · 4.0 KiB · 050ecd9 Raw
86 lines · plain
1..2    **************************************************3    *                                                *4    *   Automatically generated file, do not edit!   *5    *                                                *6    **************************************************7 8.. _amdgpu_synid_gfx11_msg_e37f7b:9 10msg11===12 13A 16-bit message code. The bits of this operand have the following meaning:14 15    ============ =============================== ===============16    Bits         Description                     Value Range17    ============ =============================== ===============18    3:0          Message *type*.                 0..1519    6:4          Optional *operation*.           0..720    7:7          Must be 0.                      021    9:8          Optional *stream*.              0..322    15:10        Unused.                         \-23    ============ =============================== ===============24 25This operand may be specified as one of the following:26 27* An :ref:`integer_number<amdgpu_synid_integer_number>` or an :ref:`absolute_expression<amdgpu_synid_absolute_expression>`. The value must be in the range from 0 to 0xFFFF.28* A *sendmsg* value which is described below.29 30    ==================================== ====================================================31    Sendmsg Value Syntax                 Description32    ==================================== ====================================================33    sendmsg(<*type*>)                    A message identified by its *type*.34    sendmsg(<*type*>,<*op*>)             A message identified by its *type* and *operation*.35    sendmsg(<*type*>,<*op*>,<*stream*>)  A message identified by its *type* and *operation*36                                         with a stream *id*.37    ==================================== ====================================================38 39*Type* may be specified using message *name* or message *id*.40 41*Op* may be specified using operation *name* or operation *id*.42 43Stream *id* is an integer in the range from 0 to 3.44 45Numeric values may be specified as positive :ref:`integer numbers<amdgpu_synid_integer_number>`46or :ref:`absolute expressions<amdgpu_synid_absolute_expression>`.47 48Each message type supports specific operations:49 50    ====================== ========== ============================== ============ ==========51    Message name           Message Id Supported Operations           Operation Id Stream Id52    ====================== ========== ============================== ============ ==========53    MSG_INTERRUPT          1          \-                             \-           \-54    MSG_HS_TESSFACTOR      2          \-                             \-           \-55    MSG_DEALLOC_VGPRS      3          \-                             \-           \-56    MSG_STALL_WAVE_GEN     5          \-                             \-           \-57    MSG_HALT_WAVES         6          \-                             \-           \-58    MSG_GS_ALLOC_REQ       9          \-                             \-           \-59    MSG_SYSMSG             15         SYSMSG_OP_ECC_ERR_INTERRUPT    1            \-60    \                                 SYSMSG_OP_REG_RD               2            \-61    \                                 SYSMSG_OP_TTRACE_PC            4            \-62    ====================== ========== ============================== ============ ==========63 64*Sendmsg* arguments are validated depending on how *type* value is specified:65 66* If message *type* is specified by name, arguments values must satisfy limitations detailed in the table above.67* If message *type* is specified as a number, each argument must not exceed the corresponding value range (see the first table).68 69Examples:70 71.. parsed-literal::72 73    // numeric message code74    msg = 0x1075    s_sendmsg 0x1276    s_sendmsg msg + 277 78    // sendmsg with strict arguments validation79    s_sendmsg sendmsg(MSG_INTERRUPT)80    s_sendmsg sendmsg(MSG_SYSMSG, SYSMSG_OP_TTRACE_PC)81 82    // sendmsg with validation of value range only83    msg = 284    op = 385    s_sendmsg sendmsg(msg, op)86