X86DisassemblerDecoderCommon.h 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489
  1. #pragma once
  2. #ifdef __GNUC__
  3. #pragma GCC diagnostic push
  4. #pragma GCC diagnostic ignored "-Wunused-parameter"
  5. #endif
  6. //===-- X86DisassemblerDecoderCommon.h - Disassembler decoder ---*- C++ -*-===//
  7. //
  8. // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
  9. // See https://llvm.org/LICENSE.txt for license information.
  10. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
  11. //
  12. //===----------------------------------------------------------------------===//
  13. //
  14. // This file is part of the X86 Disassembler.
  15. // It contains common definitions used by both the disassembler and the table
  16. // generator.
  17. // Documentation for the disassembler can be found in X86Disassembler.h.
  18. //
  19. //===----------------------------------------------------------------------===//
  20. #ifndef LLVM_SUPPORT_X86DISASSEMBLERDECODERCOMMON_H
  21. #define LLVM_SUPPORT_X86DISASSEMBLERDECODERCOMMON_H
  22. #include "llvm/Support/DataTypes.h"
  23. namespace llvm {
  24. namespace X86Disassembler {
  25. #define INSTRUCTIONS_SYM x86DisassemblerInstrSpecifiers
  26. #define CONTEXTS_SYM x86DisassemblerContexts
  27. #define ONEBYTE_SYM x86DisassemblerOneByteOpcodes
  28. #define TWOBYTE_SYM x86DisassemblerTwoByteOpcodes
  29. #define THREEBYTE38_SYM x86DisassemblerThreeByte38Opcodes
  30. #define THREEBYTE3A_SYM x86DisassemblerThreeByte3AOpcodes
  31. #define XOP8_MAP_SYM x86DisassemblerXOP8Opcodes
  32. #define XOP9_MAP_SYM x86DisassemblerXOP9Opcodes
  33. #define XOPA_MAP_SYM x86DisassemblerXOPAOpcodes
  34. #define THREEDNOW_MAP_SYM x86Disassembler3DNowOpcodes
  35. #define MAP5_SYM x86DisassemblerMap5Opcodes
  36. #define MAP6_SYM x86DisassemblerMap6Opcodes
  37. #define INSTRUCTIONS_STR "x86DisassemblerInstrSpecifiers"
  38. #define CONTEXTS_STR "x86DisassemblerContexts"
  39. #define ONEBYTE_STR "x86DisassemblerOneByteOpcodes"
  40. #define TWOBYTE_STR "x86DisassemblerTwoByteOpcodes"
  41. #define THREEBYTE38_STR "x86DisassemblerThreeByte38Opcodes"
  42. #define THREEBYTE3A_STR "x86DisassemblerThreeByte3AOpcodes"
  43. #define XOP8_MAP_STR "x86DisassemblerXOP8Opcodes"
  44. #define XOP9_MAP_STR "x86DisassemblerXOP9Opcodes"
  45. #define XOPA_MAP_STR "x86DisassemblerXOPAOpcodes"
  46. #define THREEDNOW_MAP_STR "x86Disassembler3DNowOpcodes"
  47. #define MAP5_STR "x86DisassemblerMap5Opcodes"
  48. #define MAP6_STR "x86DisassemblerMap6Opcodes"
  49. // Attributes of an instruction that must be known before the opcode can be
  50. // processed correctly. Most of these indicate the presence of particular
  51. // prefixes, but ATTR_64BIT is simply an attribute of the decoding context.
  52. enum attributeBits {
  53. ATTR_NONE = 0x00,
  54. ATTR_64BIT = 0x1 << 0,
  55. ATTR_XS = 0x1 << 1,
  56. ATTR_XD = 0x1 << 2,
  57. ATTR_REXW = 0x1 << 3,
  58. ATTR_OPSIZE = 0x1 << 4,
  59. ATTR_ADSIZE = 0x1 << 5,
  60. ATTR_VEX = 0x1 << 6,
  61. ATTR_VEXL = 0x1 << 7,
  62. ATTR_EVEX = 0x1 << 8,
  63. ATTR_EVEXL2 = 0x1 << 9,
  64. ATTR_EVEXK = 0x1 << 10,
  65. ATTR_EVEXKZ = 0x1 << 11,
  66. ATTR_EVEXB = 0x1 << 12,
  67. ATTR_max = 0x1 << 13,
  68. };
  69. // Combinations of the above attributes that are relevant to instruction
  70. // decode. Although other combinations are possible, they can be reduced to
  71. // these without affecting the ultimately decoded instruction.
  72. // Class name Rank Rationale for rank assignment
  73. #define INSTRUCTION_CONTEXTS \
  74. ENUM_ENTRY(IC, 0, "says nothing about the instruction") \
  75. ENUM_ENTRY(IC_64BIT, 1, "says the instruction applies in " \
  76. "64-bit mode but no more") \
  77. ENUM_ENTRY(IC_OPSIZE, 3, "requires an OPSIZE prefix, so " \
  78. "operands change width") \
  79. ENUM_ENTRY(IC_ADSIZE, 3, "requires an ADSIZE prefix, so " \
  80. "operands change width") \
  81. ENUM_ENTRY(IC_OPSIZE_ADSIZE, 4, "requires ADSIZE and OPSIZE prefixes") \
  82. ENUM_ENTRY(IC_XD, 2, "may say something about the opcode " \
  83. "but not the operands") \
  84. ENUM_ENTRY(IC_XS, 2, "may say something about the opcode " \
  85. "but not the operands") \
  86. ENUM_ENTRY(IC_XD_OPSIZE, 3, "requires an OPSIZE prefix, so " \
  87. "operands change width") \
  88. ENUM_ENTRY(IC_XS_OPSIZE, 3, "requires an OPSIZE prefix, so " \
  89. "operands change width") \
  90. ENUM_ENTRY(IC_XD_ADSIZE, 3, "requires an ADSIZE prefix, so " \
  91. "operands change width") \
  92. ENUM_ENTRY(IC_XS_ADSIZE, 3, "requires an ADSIZE prefix, so " \
  93. "operands change width") \
  94. ENUM_ENTRY(IC_64BIT_REXW, 5, "requires a REX.W prefix, so operands "\
  95. "change width; overrides IC_OPSIZE") \
  96. ENUM_ENTRY(IC_64BIT_REXW_ADSIZE, 6, "requires a REX.W prefix and 0x67 " \
  97. "prefix") \
  98. ENUM_ENTRY(IC_64BIT_OPSIZE, 3, "Just as meaningful as IC_OPSIZE") \
  99. ENUM_ENTRY(IC_64BIT_ADSIZE, 3, "Just as meaningful as IC_ADSIZE") \
  100. ENUM_ENTRY(IC_64BIT_OPSIZE_ADSIZE, 4, "Just as meaningful as IC_OPSIZE/" \
  101. "IC_ADSIZE") \
  102. ENUM_ENTRY(IC_64BIT_XD, 6, "XD instructions are SSE; REX.W is " \
  103. "secondary") \
  104. ENUM_ENTRY(IC_64BIT_XS, 6, "Just as meaningful as IC_64BIT_XD") \
  105. ENUM_ENTRY(IC_64BIT_XD_OPSIZE, 3, "Just as meaningful as IC_XD_OPSIZE") \
  106. ENUM_ENTRY(IC_64BIT_XS_OPSIZE, 3, "Just as meaningful as IC_XS_OPSIZE") \
  107. ENUM_ENTRY(IC_64BIT_XD_ADSIZE, 3, "Just as meaningful as IC_XD_ADSIZE") \
  108. ENUM_ENTRY(IC_64BIT_XS_ADSIZE, 3, "Just as meaningful as IC_XS_ADSIZE") \
  109. ENUM_ENTRY(IC_64BIT_REXW_XS, 7, "OPSIZE could mean a different " \
  110. "opcode") \
  111. ENUM_ENTRY(IC_64BIT_REXW_XD, 7, "Just as meaningful as " \
  112. "IC_64BIT_REXW_XS") \
  113. ENUM_ENTRY(IC_64BIT_REXW_OPSIZE, 8, "The Dynamic Duo! Prefer over all " \
  114. "else because this changes most " \
  115. "operands' meaning") \
  116. ENUM_ENTRY(IC_VEX, 1, "requires a VEX prefix") \
  117. ENUM_ENTRY(IC_VEX_XS, 2, "requires VEX and the XS prefix") \
  118. ENUM_ENTRY(IC_VEX_XD, 2, "requires VEX and the XD prefix") \
  119. ENUM_ENTRY(IC_VEX_OPSIZE, 2, "requires VEX and the OpSize prefix") \
  120. ENUM_ENTRY(IC_64BIT_VEX_OPSIZE, 4, "requires 64-bit mode and VEX") \
  121. ENUM_ENTRY(IC_64BIT_VEX_OPSIZE_ADSIZE, 5, "requires 64-bit mode, VEX, and AdSize")\
  122. ENUM_ENTRY(IC_VEX_W, 3, "requires VEX and the W prefix") \
  123. ENUM_ENTRY(IC_VEX_W_XS, 4, "requires VEX, W, and XS prefix") \
  124. ENUM_ENTRY(IC_VEX_W_XD, 4, "requires VEX, W, and XD prefix") \
  125. ENUM_ENTRY(IC_VEX_W_OPSIZE, 4, "requires VEX, W, and OpSize") \
  126. ENUM_ENTRY(IC_VEX_L, 3, "requires VEX and the L prefix") \
  127. ENUM_ENTRY(IC_VEX_L_XS, 4, "requires VEX and the L and XS prefix")\
  128. ENUM_ENTRY(IC_VEX_L_XD, 4, "requires VEX and the L and XD prefix")\
  129. ENUM_ENTRY(IC_VEX_L_OPSIZE, 4, "requires VEX, L, and OpSize") \
  130. ENUM_ENTRY(IC_VEX_L_W, 4, "requires VEX, L and W") \
  131. ENUM_ENTRY(IC_VEX_L_W_XS, 5, "requires VEX, L, W and XS prefix") \
  132. ENUM_ENTRY(IC_VEX_L_W_XD, 5, "requires VEX, L, W and XD prefix") \
  133. ENUM_ENTRY(IC_VEX_L_W_OPSIZE, 5, "requires VEX, L, W and OpSize") \
  134. ENUM_ENTRY(IC_EVEX, 1, "requires an EVEX prefix") \
  135. ENUM_ENTRY(IC_EVEX_XS, 2, "requires EVEX and the XS prefix") \
  136. ENUM_ENTRY(IC_EVEX_XD, 2, "requires EVEX and the XD prefix") \
  137. ENUM_ENTRY(IC_EVEX_OPSIZE, 2, "requires EVEX and the OpSize prefix") \
  138. ENUM_ENTRY(IC_EVEX_W, 3, "requires EVEX and the W prefix") \
  139. ENUM_ENTRY(IC_EVEX_W_XS, 4, "requires EVEX, W, and XS prefix") \
  140. ENUM_ENTRY(IC_EVEX_W_XD, 4, "requires EVEX, W, and XD prefix") \
  141. ENUM_ENTRY(IC_EVEX_W_OPSIZE, 4, "requires EVEX, W, and OpSize") \
  142. ENUM_ENTRY(IC_EVEX_L, 3, "requires EVEX and the L prefix") \
  143. ENUM_ENTRY(IC_EVEX_L_XS, 4, "requires EVEX and the L and XS prefix")\
  144. ENUM_ENTRY(IC_EVEX_L_XD, 4, "requires EVEX and the L and XD prefix")\
  145. ENUM_ENTRY(IC_EVEX_L_OPSIZE, 4, "requires EVEX, L, and OpSize") \
  146. ENUM_ENTRY(IC_EVEX_L_W, 3, "requires EVEX, L and W") \
  147. ENUM_ENTRY(IC_EVEX_L_W_XS, 4, "requires EVEX, L, W and XS prefix") \
  148. ENUM_ENTRY(IC_EVEX_L_W_XD, 4, "requires EVEX, L, W and XD prefix") \
  149. ENUM_ENTRY(IC_EVEX_L_W_OPSIZE, 4, "requires EVEX, L, W and OpSize") \
  150. ENUM_ENTRY(IC_EVEX_L2, 3, "requires EVEX and the L2 prefix") \
  151. ENUM_ENTRY(IC_EVEX_L2_XS, 4, "requires EVEX and the L2 and XS prefix")\
  152. ENUM_ENTRY(IC_EVEX_L2_XD, 4, "requires EVEX and the L2 and XD prefix")\
  153. ENUM_ENTRY(IC_EVEX_L2_OPSIZE, 4, "requires EVEX, L2, and OpSize") \
  154. ENUM_ENTRY(IC_EVEX_L2_W, 3, "requires EVEX, L2 and W") \
  155. ENUM_ENTRY(IC_EVEX_L2_W_XS, 4, "requires EVEX, L2, W and XS prefix") \
  156. ENUM_ENTRY(IC_EVEX_L2_W_XD, 4, "requires EVEX, L2, W and XD prefix") \
  157. ENUM_ENTRY(IC_EVEX_L2_W_OPSIZE, 4, "requires EVEX, L2, W and OpSize") \
  158. ENUM_ENTRY(IC_EVEX_K, 1, "requires an EVEX_K prefix") \
  159. ENUM_ENTRY(IC_EVEX_XS_K, 2, "requires EVEX_K and the XS prefix") \
  160. ENUM_ENTRY(IC_EVEX_XD_K, 2, "requires EVEX_K and the XD prefix") \
  161. ENUM_ENTRY(IC_EVEX_OPSIZE_K, 2, "requires EVEX_K and the OpSize prefix") \
  162. ENUM_ENTRY(IC_EVEX_W_K, 3, "requires EVEX_K and the W prefix") \
  163. ENUM_ENTRY(IC_EVEX_W_XS_K, 4, "requires EVEX_K, W, and XS prefix") \
  164. ENUM_ENTRY(IC_EVEX_W_XD_K, 4, "requires EVEX_K, W, and XD prefix") \
  165. ENUM_ENTRY(IC_EVEX_W_OPSIZE_K, 4, "requires EVEX_K, W, and OpSize") \
  166. ENUM_ENTRY(IC_EVEX_L_K, 3, "requires EVEX_K and the L prefix") \
  167. ENUM_ENTRY(IC_EVEX_L_XS_K, 4, "requires EVEX_K and the L and XS prefix")\
  168. ENUM_ENTRY(IC_EVEX_L_XD_K, 4, "requires EVEX_K and the L and XD prefix")\
  169. ENUM_ENTRY(IC_EVEX_L_OPSIZE_K, 4, "requires EVEX_K, L, and OpSize") \
  170. ENUM_ENTRY(IC_EVEX_L_W_K, 3, "requires EVEX_K, L and W") \
  171. ENUM_ENTRY(IC_EVEX_L_W_XS_K, 4, "requires EVEX_K, L, W and XS prefix") \
  172. ENUM_ENTRY(IC_EVEX_L_W_XD_K, 4, "requires EVEX_K, L, W and XD prefix") \
  173. ENUM_ENTRY(IC_EVEX_L_W_OPSIZE_K, 4, "requires EVEX_K, L, W and OpSize") \
  174. ENUM_ENTRY(IC_EVEX_L2_K, 3, "requires EVEX_K and the L2 prefix") \
  175. ENUM_ENTRY(IC_EVEX_L2_XS_K, 4, "requires EVEX_K and the L2 and XS prefix")\
  176. ENUM_ENTRY(IC_EVEX_L2_XD_K, 4, "requires EVEX_K and the L2 and XD prefix")\
  177. ENUM_ENTRY(IC_EVEX_L2_OPSIZE_K, 4, "requires EVEX_K, L2, and OpSize") \
  178. ENUM_ENTRY(IC_EVEX_L2_W_K, 3, "requires EVEX_K, L2 and W") \
  179. ENUM_ENTRY(IC_EVEX_L2_W_XS_K, 4, "requires EVEX_K, L2, W and XS prefix") \
  180. ENUM_ENTRY(IC_EVEX_L2_W_XD_K, 4, "requires EVEX_K, L2, W and XD prefix") \
  181. ENUM_ENTRY(IC_EVEX_L2_W_OPSIZE_K, 4, "requires EVEX_K, L2, W and OpSize") \
  182. ENUM_ENTRY(IC_EVEX_B, 1, "requires an EVEX_B prefix") \
  183. ENUM_ENTRY(IC_EVEX_XS_B, 2, "requires EVEX_B and the XS prefix") \
  184. ENUM_ENTRY(IC_EVEX_XD_B, 2, "requires EVEX_B and the XD prefix") \
  185. ENUM_ENTRY(IC_EVEX_OPSIZE_B, 2, "requires EVEX_B and the OpSize prefix") \
  186. ENUM_ENTRY(IC_EVEX_W_B, 3, "requires EVEX_B and the W prefix") \
  187. ENUM_ENTRY(IC_EVEX_W_XS_B, 4, "requires EVEX_B, W, and XS prefix") \
  188. ENUM_ENTRY(IC_EVEX_W_XD_B, 4, "requires EVEX_B, W, and XD prefix") \
  189. ENUM_ENTRY(IC_EVEX_W_OPSIZE_B, 4, "requires EVEX_B, W, and OpSize") \
  190. ENUM_ENTRY(IC_EVEX_L_B, 3, "requires EVEX_B and the L prefix") \
  191. ENUM_ENTRY(IC_EVEX_L_XS_B, 4, "requires EVEX_B and the L and XS prefix")\
  192. ENUM_ENTRY(IC_EVEX_L_XD_B, 4, "requires EVEX_B and the L and XD prefix")\
  193. ENUM_ENTRY(IC_EVEX_L_OPSIZE_B, 4, "requires EVEX_B, L, and OpSize") \
  194. ENUM_ENTRY(IC_EVEX_L_W_B, 3, "requires EVEX_B, L and W") \
  195. ENUM_ENTRY(IC_EVEX_L_W_XS_B, 4, "requires EVEX_B, L, W and XS prefix") \
  196. ENUM_ENTRY(IC_EVEX_L_W_XD_B, 4, "requires EVEX_B, L, W and XD prefix") \
  197. ENUM_ENTRY(IC_EVEX_L_W_OPSIZE_B, 4, "requires EVEX_B, L, W and OpSize") \
  198. ENUM_ENTRY(IC_EVEX_L2_B, 3, "requires EVEX_B and the L2 prefix") \
  199. ENUM_ENTRY(IC_EVEX_L2_XS_B, 4, "requires EVEX_B and the L2 and XS prefix")\
  200. ENUM_ENTRY(IC_EVEX_L2_XD_B, 4, "requires EVEX_B and the L2 and XD prefix")\
  201. ENUM_ENTRY(IC_EVEX_L2_OPSIZE_B, 4, "requires EVEX_B, L2, and OpSize") \
  202. ENUM_ENTRY(IC_EVEX_L2_W_B, 3, "requires EVEX_B, L2 and W") \
  203. ENUM_ENTRY(IC_EVEX_L2_W_XS_B, 4, "requires EVEX_B, L2, W and XS prefix") \
  204. ENUM_ENTRY(IC_EVEX_L2_W_XD_B, 4, "requires EVEX_B, L2, W and XD prefix") \
  205. ENUM_ENTRY(IC_EVEX_L2_W_OPSIZE_B, 4, "requires EVEX_B, L2, W and OpSize") \
  206. ENUM_ENTRY(IC_EVEX_K_B, 1, "requires EVEX_B and EVEX_K prefix") \
  207. ENUM_ENTRY(IC_EVEX_XS_K_B, 2, "requires EVEX_B, EVEX_K and the XS prefix") \
  208. ENUM_ENTRY(IC_EVEX_XD_K_B, 2, "requires EVEX_B, EVEX_K and the XD prefix") \
  209. ENUM_ENTRY(IC_EVEX_OPSIZE_K_B, 2, "requires EVEX_B, EVEX_K and the OpSize prefix") \
  210. ENUM_ENTRY(IC_EVEX_W_K_B, 3, "requires EVEX_B, EVEX_K and the W prefix") \
  211. ENUM_ENTRY(IC_EVEX_W_XS_K_B, 4, "requires EVEX_B, EVEX_K, W, and XS prefix") \
  212. ENUM_ENTRY(IC_EVEX_W_XD_K_B, 4, "requires EVEX_B, EVEX_K, W, and XD prefix") \
  213. ENUM_ENTRY(IC_EVEX_W_OPSIZE_K_B, 4, "requires EVEX_B, EVEX_K, W, and OpSize") \
  214. ENUM_ENTRY(IC_EVEX_L_K_B, 3, "requires EVEX_B, EVEX_K and the L prefix") \
  215. ENUM_ENTRY(IC_EVEX_L_XS_K_B, 4, "requires EVEX_B, EVEX_K and the L and XS prefix")\
  216. ENUM_ENTRY(IC_EVEX_L_XD_K_B, 4, "requires EVEX_B, EVEX_K and the L and XD prefix")\
  217. ENUM_ENTRY(IC_EVEX_L_OPSIZE_K_B, 4, "requires EVEX_B, EVEX_K, L, and OpSize") \
  218. ENUM_ENTRY(IC_EVEX_L_W_K_B, 3, "requires EVEX_B, EVEX_K, L and W") \
  219. ENUM_ENTRY(IC_EVEX_L_W_XS_K_B, 4, "requires EVEX_B, EVEX_K, L, W and XS prefix") \
  220. ENUM_ENTRY(IC_EVEX_L_W_XD_K_B, 4, "requires EVEX_B, EVEX_K, L, W and XD prefix") \
  221. ENUM_ENTRY(IC_EVEX_L_W_OPSIZE_K_B,4, "requires EVEX_B, EVEX_K, L, W and OpSize") \
  222. ENUM_ENTRY(IC_EVEX_L2_K_B, 3, "requires EVEX_B, EVEX_K and the L2 prefix") \
  223. ENUM_ENTRY(IC_EVEX_L2_XS_K_B, 4, "requires EVEX_B, EVEX_K and the L2 and XS prefix")\
  224. ENUM_ENTRY(IC_EVEX_L2_XD_K_B, 4, "requires EVEX_B, EVEX_K and the L2 and XD prefix")\
  225. ENUM_ENTRY(IC_EVEX_L2_OPSIZE_K_B, 4, "requires EVEX_B, EVEX_K, L2, and OpSize") \
  226. ENUM_ENTRY(IC_EVEX_L2_W_K_B, 3, "requires EVEX_B, EVEX_K, L2 and W") \
  227. ENUM_ENTRY(IC_EVEX_L2_W_XS_K_B, 4, "requires EVEX_B, EVEX_K, L2, W and XS prefix") \
  228. ENUM_ENTRY(IC_EVEX_L2_W_XD_K_B, 4, "requires EVEX_B, EVEX_K, L2, W and XD prefix") \
  229. ENUM_ENTRY(IC_EVEX_L2_W_OPSIZE_K_B,4, "requires EVEX_B, EVEX_K, L2, W and OpSize") \
  230. ENUM_ENTRY(IC_EVEX_KZ_B, 1, "requires EVEX_B and EVEX_KZ prefix") \
  231. ENUM_ENTRY(IC_EVEX_XS_KZ_B, 2, "requires EVEX_B, EVEX_KZ and the XS prefix") \
  232. ENUM_ENTRY(IC_EVEX_XD_KZ_B, 2, "requires EVEX_B, EVEX_KZ and the XD prefix") \
  233. ENUM_ENTRY(IC_EVEX_OPSIZE_KZ_B, 2, "requires EVEX_B, EVEX_KZ and the OpSize prefix") \
  234. ENUM_ENTRY(IC_EVEX_W_KZ_B, 3, "requires EVEX_B, EVEX_KZ and the W prefix") \
  235. ENUM_ENTRY(IC_EVEX_W_XS_KZ_B, 4, "requires EVEX_B, EVEX_KZ, W, and XS prefix") \
  236. ENUM_ENTRY(IC_EVEX_W_XD_KZ_B, 4, "requires EVEX_B, EVEX_KZ, W, and XD prefix") \
  237. ENUM_ENTRY(IC_EVEX_W_OPSIZE_KZ_B, 4, "requires EVEX_B, EVEX_KZ, W, and OpSize") \
  238. ENUM_ENTRY(IC_EVEX_L_KZ_B, 3, "requires EVEX_B, EVEX_KZ and the L prefix") \
  239. ENUM_ENTRY(IC_EVEX_L_XS_KZ_B, 4, "requires EVEX_B, EVEX_KZ and the L and XS prefix")\
  240. ENUM_ENTRY(IC_EVEX_L_XD_KZ_B, 4, "requires EVEX_B, EVEX_KZ and the L and XD prefix")\
  241. ENUM_ENTRY(IC_EVEX_L_OPSIZE_KZ_B, 4, "requires EVEX_B, EVEX_KZ, L, and OpSize") \
  242. ENUM_ENTRY(IC_EVEX_L_W_KZ_B, 3, "requires EVEX_B, EVEX_KZ, L and W") \
  243. ENUM_ENTRY(IC_EVEX_L_W_XS_KZ_B, 4, "requires EVEX_B, EVEX_KZ, L, W and XS prefix") \
  244. ENUM_ENTRY(IC_EVEX_L_W_XD_KZ_B, 4, "requires EVEX_B, EVEX_KZ, L, W and XD prefix") \
  245. ENUM_ENTRY(IC_EVEX_L_W_OPSIZE_KZ_B, 4, "requires EVEX_B, EVEX_KZ, L, W and OpSize") \
  246. ENUM_ENTRY(IC_EVEX_L2_KZ_B, 3, "requires EVEX_B, EVEX_KZ and the L2 prefix") \
  247. ENUM_ENTRY(IC_EVEX_L2_XS_KZ_B, 4, "requires EVEX_B, EVEX_KZ and the L2 and XS prefix")\
  248. ENUM_ENTRY(IC_EVEX_L2_XD_KZ_B, 4, "requires EVEX_B, EVEX_KZ and the L2 and XD prefix")\
  249. ENUM_ENTRY(IC_EVEX_L2_OPSIZE_KZ_B, 4, "requires EVEX_B, EVEX_KZ, L2, and OpSize") \
  250. ENUM_ENTRY(IC_EVEX_L2_W_KZ_B, 3, "requires EVEX_B, EVEX_KZ, L2 and W") \
  251. ENUM_ENTRY(IC_EVEX_L2_W_XS_KZ_B, 4, "requires EVEX_B, EVEX_KZ, L2, W and XS prefix") \
  252. ENUM_ENTRY(IC_EVEX_L2_W_XD_KZ_B, 4, "requires EVEX_B, EVEX_KZ, L2, W and XD prefix") \
  253. ENUM_ENTRY(IC_EVEX_L2_W_OPSIZE_KZ_B, 4, "requires EVEX_B, EVEX_KZ, L2, W and OpSize") \
  254. ENUM_ENTRY(IC_EVEX_KZ, 1, "requires an EVEX_KZ prefix") \
  255. ENUM_ENTRY(IC_EVEX_XS_KZ, 2, "requires EVEX_KZ and the XS prefix") \
  256. ENUM_ENTRY(IC_EVEX_XD_KZ, 2, "requires EVEX_KZ and the XD prefix") \
  257. ENUM_ENTRY(IC_EVEX_OPSIZE_KZ, 2, "requires EVEX_KZ and the OpSize prefix") \
  258. ENUM_ENTRY(IC_EVEX_W_KZ, 3, "requires EVEX_KZ and the W prefix") \
  259. ENUM_ENTRY(IC_EVEX_W_XS_KZ, 4, "requires EVEX_KZ, W, and XS prefix") \
  260. ENUM_ENTRY(IC_EVEX_W_XD_KZ, 4, "requires EVEX_KZ, W, and XD prefix") \
  261. ENUM_ENTRY(IC_EVEX_W_OPSIZE_KZ, 4, "requires EVEX_KZ, W, and OpSize") \
  262. ENUM_ENTRY(IC_EVEX_L_KZ, 3, "requires EVEX_KZ and the L prefix") \
  263. ENUM_ENTRY(IC_EVEX_L_XS_KZ, 4, "requires EVEX_KZ and the L and XS prefix")\
  264. ENUM_ENTRY(IC_EVEX_L_XD_KZ, 4, "requires EVEX_KZ and the L and XD prefix")\
  265. ENUM_ENTRY(IC_EVEX_L_OPSIZE_KZ, 4, "requires EVEX_KZ, L, and OpSize") \
  266. ENUM_ENTRY(IC_EVEX_L_W_KZ, 3, "requires EVEX_KZ, L and W") \
  267. ENUM_ENTRY(IC_EVEX_L_W_XS_KZ, 4, "requires EVEX_KZ, L, W and XS prefix") \
  268. ENUM_ENTRY(IC_EVEX_L_W_XD_KZ, 4, "requires EVEX_KZ, L, W and XD prefix") \
  269. ENUM_ENTRY(IC_EVEX_L_W_OPSIZE_KZ, 4, "requires EVEX_KZ, L, W and OpSize") \
  270. ENUM_ENTRY(IC_EVEX_L2_KZ, 3, "requires EVEX_KZ and the L2 prefix") \
  271. ENUM_ENTRY(IC_EVEX_L2_XS_KZ, 4, "requires EVEX_KZ and the L2 and XS prefix")\
  272. ENUM_ENTRY(IC_EVEX_L2_XD_KZ, 4, "requires EVEX_KZ and the L2 and XD prefix")\
  273. ENUM_ENTRY(IC_EVEX_L2_OPSIZE_KZ, 4, "requires EVEX_KZ, L2, and OpSize") \
  274. ENUM_ENTRY(IC_EVEX_L2_W_KZ, 3, "requires EVEX_KZ, L2 and W") \
  275. ENUM_ENTRY(IC_EVEX_L2_W_XS_KZ, 4, "requires EVEX_KZ, L2, W and XS prefix") \
  276. ENUM_ENTRY(IC_EVEX_L2_W_XD_KZ, 4, "requires EVEX_KZ, L2, W and XD prefix") \
  277. ENUM_ENTRY(IC_EVEX_L2_W_OPSIZE_KZ, 4, "requires EVEX_KZ, L2, W and OpSize")
  278. #define ENUM_ENTRY(n, r, d) n,
  279. enum InstructionContext {
  280. INSTRUCTION_CONTEXTS
  281. IC_max
  282. };
  283. #undef ENUM_ENTRY
  284. // Opcode types, which determine which decode table to use, both in the Intel
  285. // manual and also for the decoder.
  286. enum OpcodeType {
  287. ONEBYTE = 0,
  288. TWOBYTE = 1,
  289. THREEBYTE_38 = 2,
  290. THREEBYTE_3A = 3,
  291. XOP8_MAP = 4,
  292. XOP9_MAP = 5,
  293. XOPA_MAP = 6,
  294. THREEDNOW_MAP = 7,
  295. MAP5 = 8,
  296. MAP6 = 9
  297. };
  298. // The following structs are used for the hierarchical decode table. After
  299. // determining the instruction's class (i.e., which IC_* constant applies to
  300. // it), the decoder reads the opcode. Some instructions require specific
  301. // values of the ModR/M byte, so the ModR/M byte indexes into the final table.
  302. //
  303. // If a ModR/M byte is not required, "required" is left unset, and the values
  304. // for each instructionID are identical.
  305. typedef uint16_t InstrUID;
  306. // ModRMDecisionType - describes the type of ModR/M decision, allowing the
  307. // consumer to determine the number of entries in it.
  308. //
  309. // MODRM_ONEENTRY - No matter what the value of the ModR/M byte is, the decoded
  310. // instruction is the same.
  311. // MODRM_SPLITRM - If the ModR/M byte is between 0x00 and 0xbf, the opcode
  312. // corresponds to one instruction; otherwise, it corresponds to
  313. // a different instruction.
  314. // MODRM_SPLITMISC- If the ModR/M byte is between 0x00 and 0xbf, ModR/M byte
  315. // divided by 8 is used to select instruction; otherwise, each
  316. // value of the ModR/M byte could correspond to a different
  317. // instruction.
  318. // MODRM_SPLITREG - ModR/M byte divided by 8 is used to select instruction. This
  319. // corresponds to instructions that use reg field as opcode
  320. // MODRM_FULL - Potentially, each value of the ModR/M byte could correspond
  321. // to a different instruction.
  322. #define MODRMTYPES \
  323. ENUM_ENTRY(MODRM_ONEENTRY) \
  324. ENUM_ENTRY(MODRM_SPLITRM) \
  325. ENUM_ENTRY(MODRM_SPLITMISC) \
  326. ENUM_ENTRY(MODRM_SPLITREG) \
  327. ENUM_ENTRY(MODRM_FULL)
  328. #define ENUM_ENTRY(n) n,
  329. enum ModRMDecisionType {
  330. MODRMTYPES
  331. MODRM_max
  332. };
  333. #undef ENUM_ENTRY
  334. #define CASE_ENCODING_RM \
  335. case ENCODING_RM: \
  336. case ENCODING_RM_CD2: \
  337. case ENCODING_RM_CD4: \
  338. case ENCODING_RM_CD8: \
  339. case ENCODING_RM_CD16: \
  340. case ENCODING_RM_CD32: \
  341. case ENCODING_RM_CD64
  342. #define CASE_ENCODING_VSIB \
  343. case ENCODING_VSIB: \
  344. case ENCODING_VSIB_CD2: \
  345. case ENCODING_VSIB_CD4: \
  346. case ENCODING_VSIB_CD8: \
  347. case ENCODING_VSIB_CD16: \
  348. case ENCODING_VSIB_CD32: \
  349. case ENCODING_VSIB_CD64
  350. // Physical encodings of instruction operands.
  351. #define ENCODINGS \
  352. ENUM_ENTRY(ENCODING_NONE, "") \
  353. ENUM_ENTRY(ENCODING_REG, "Register operand in ModR/M byte.") \
  354. ENUM_ENTRY(ENCODING_RM, "R/M operand in ModR/M byte.") \
  355. ENUM_ENTRY(ENCODING_RM_CD2, "R/M operand with CDisp scaling of 2") \
  356. ENUM_ENTRY(ENCODING_RM_CD4, "R/M operand with CDisp scaling of 4") \
  357. ENUM_ENTRY(ENCODING_RM_CD8, "R/M operand with CDisp scaling of 8") \
  358. ENUM_ENTRY(ENCODING_RM_CD16,"R/M operand with CDisp scaling of 16") \
  359. ENUM_ENTRY(ENCODING_RM_CD32,"R/M operand with CDisp scaling of 32") \
  360. ENUM_ENTRY(ENCODING_RM_CD64,"R/M operand with CDisp scaling of 64") \
  361. ENUM_ENTRY(ENCODING_SIB, "Force SIB operand in ModR/M byte.") \
  362. ENUM_ENTRY(ENCODING_VSIB, "VSIB operand in ModR/M byte.") \
  363. ENUM_ENTRY(ENCODING_VSIB_CD2, "VSIB operand with CDisp scaling of 2") \
  364. ENUM_ENTRY(ENCODING_VSIB_CD4, "VSIB operand with CDisp scaling of 4") \
  365. ENUM_ENTRY(ENCODING_VSIB_CD8, "VSIB operand with CDisp scaling of 8") \
  366. ENUM_ENTRY(ENCODING_VSIB_CD16,"VSIB operand with CDisp scaling of 16") \
  367. ENUM_ENTRY(ENCODING_VSIB_CD32,"VSIB operand with CDisp scaling of 32") \
  368. ENUM_ENTRY(ENCODING_VSIB_CD64,"VSIB operand with CDisp scaling of 64") \
  369. ENUM_ENTRY(ENCODING_VVVV, "Register operand in VEX.vvvv byte.") \
  370. ENUM_ENTRY(ENCODING_WRITEMASK, "Register operand in EVEX.aaa byte.") \
  371. ENUM_ENTRY(ENCODING_IB, "1-byte immediate") \
  372. ENUM_ENTRY(ENCODING_IW, "2-byte") \
  373. ENUM_ENTRY(ENCODING_ID, "4-byte") \
  374. ENUM_ENTRY(ENCODING_IO, "8-byte") \
  375. ENUM_ENTRY(ENCODING_RB, "(AL..DIL, R8B..R15B) Register code added to " \
  376. "the opcode byte") \
  377. ENUM_ENTRY(ENCODING_RW, "(AX..DI, R8W..R15W)") \
  378. ENUM_ENTRY(ENCODING_RD, "(EAX..EDI, R8D..R15D)") \
  379. ENUM_ENTRY(ENCODING_RO, "(RAX..RDI, R8..R15)") \
  380. ENUM_ENTRY(ENCODING_FP, "Position on floating-point stack in ModR/M " \
  381. "byte.") \
  382. \
  383. ENUM_ENTRY(ENCODING_Iv, "Immediate of operand size") \
  384. ENUM_ENTRY(ENCODING_Ia, "Immediate of address size") \
  385. ENUM_ENTRY(ENCODING_IRC, "Immediate for static rounding control") \
  386. ENUM_ENTRY(ENCODING_Rv, "Register code of operand size added to the " \
  387. "opcode byte") \
  388. ENUM_ENTRY(ENCODING_CC, "Condition code encoded in opcode") \
  389. ENUM_ENTRY(ENCODING_DUP, "Duplicate of another operand; ID is encoded " \
  390. "in type") \
  391. ENUM_ENTRY(ENCODING_SI, "Source index; encoded in OpSize/Adsize prefix") \
  392. ENUM_ENTRY(ENCODING_DI, "Destination index; encoded in prefixes")
  393. #define ENUM_ENTRY(n, d) n,
  394. enum OperandEncoding {
  395. ENCODINGS
  396. ENCODING_max
  397. };
  398. #undef ENUM_ENTRY
  399. // Semantic interpretations of instruction operands.
  400. #define TYPES \
  401. ENUM_ENTRY(TYPE_NONE, "") \
  402. ENUM_ENTRY(TYPE_REL, "immediate address") \
  403. ENUM_ENTRY(TYPE_R8, "1-byte register operand") \
  404. ENUM_ENTRY(TYPE_R16, "2-byte") \
  405. ENUM_ENTRY(TYPE_R32, "4-byte") \
  406. ENUM_ENTRY(TYPE_R64, "8-byte") \
  407. ENUM_ENTRY(TYPE_IMM, "immediate operand") \
  408. ENUM_ENTRY(TYPE_UIMM8, "1-byte unsigned immediate operand") \
  409. ENUM_ENTRY(TYPE_M, "Memory operand") \
  410. ENUM_ENTRY(TYPE_MSIB, "Memory operand force sib encoding") \
  411. ENUM_ENTRY(TYPE_MVSIBX, "Memory operand using XMM index") \
  412. ENUM_ENTRY(TYPE_MVSIBY, "Memory operand using YMM index") \
  413. ENUM_ENTRY(TYPE_MVSIBZ, "Memory operand using ZMM index") \
  414. ENUM_ENTRY(TYPE_SRCIDX, "memory at source index") \
  415. ENUM_ENTRY(TYPE_DSTIDX, "memory at destination index") \
  416. ENUM_ENTRY(TYPE_MOFFS, "memory offset (relative to segment base)") \
  417. ENUM_ENTRY(TYPE_ST, "Position on the floating-point stack") \
  418. ENUM_ENTRY(TYPE_MM64, "8-byte MMX register") \
  419. ENUM_ENTRY(TYPE_XMM, "16-byte") \
  420. ENUM_ENTRY(TYPE_YMM, "32-byte") \
  421. ENUM_ENTRY(TYPE_ZMM, "64-byte") \
  422. ENUM_ENTRY(TYPE_VK, "mask register") \
  423. ENUM_ENTRY(TYPE_VK_PAIR, "mask register pair") \
  424. ENUM_ENTRY(TYPE_TMM, "tile") \
  425. ENUM_ENTRY(TYPE_SEGMENTREG, "Segment register operand") \
  426. ENUM_ENTRY(TYPE_DEBUGREG, "Debug register operand") \
  427. ENUM_ENTRY(TYPE_CONTROLREG, "Control register operand") \
  428. ENUM_ENTRY(TYPE_BNDR, "MPX bounds register") \
  429. \
  430. ENUM_ENTRY(TYPE_Rv, "Register operand of operand size") \
  431. ENUM_ENTRY(TYPE_RELv, "Immediate address of operand size") \
  432. ENUM_ENTRY(TYPE_DUP0, "Duplicate of operand 0") \
  433. ENUM_ENTRY(TYPE_DUP1, "operand 1") \
  434. ENUM_ENTRY(TYPE_DUP2, "operand 2") \
  435. ENUM_ENTRY(TYPE_DUP3, "operand 3") \
  436. ENUM_ENTRY(TYPE_DUP4, "operand 4") \
  437. #define ENUM_ENTRY(n, d) n,
  438. enum OperandType {
  439. TYPES
  440. TYPE_max
  441. };
  442. #undef ENUM_ENTRY
  443. /// The specification for how to extract and interpret one operand.
  444. struct OperandSpecifier {
  445. uint8_t encoding;
  446. uint8_t type;
  447. };
  448. static const unsigned X86_MAX_OPERANDS = 6;
  449. /// Decoding mode for the Intel disassembler. 16-bit, 32-bit, and 64-bit mode
  450. /// are supported, and represent real mode, IA-32e, and IA-32e in 64-bit mode,
  451. /// respectively.
  452. enum DisassemblerMode {
  453. MODE_16BIT,
  454. MODE_32BIT,
  455. MODE_64BIT
  456. };
  457. } // namespace X86Disassembler
  458. } // namespace llvm
  459. #endif
  460. #ifdef __GNUC__
  461. #pragma GCC diagnostic pop
  462. #endif