1 /* Declarations for Intel 80386 opcode table
2 Copyright (C) 2007-2020 Free Software Foundation, Inc.
4 This file is part of the GNU opcodes library.
6 This library is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3, or (at your option)
11 It is distributed in the hope that it will be useful, but WITHOUT
12 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
13 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
14 License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GAS; see the file COPYING. If not, write to the Free
18 Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
21 #include "opcode/i386.h"
30 /* Position of cpu flags bitfiled. */
34 /* i186 or better required */
36 /* i286 or better required */
38 /* i386 or better required */
40 /* i486 or better required */
42 /* i585 or better required */
44 /* i686 or better required */
46 /* CMOV Instruction support required */
48 /* FXSR Instruction support required */
50 /* CLFLUSH Instruction support required */
52 /* NOP Instruction support required */
54 /* SYSCALL Instructions support required */
56 /* Floating point support required */
58 /* i287 support required */
60 /* i387 support required */
62 /* i686 and floating point support required */
64 /* SSE3 and floating point support required */
66 /* MMX support required */
68 /* SSE support required */
70 /* SSE2 support required */
72 /* 3dnow! support required */
74 /* 3dnow! Extensions support required */
76 /* SSE3 support required */
78 /* VIA PadLock required */
80 /* AMD Secure Virtual Machine Ext-s required */
82 /* VMX Instructions required */
84 /* SMX Instructions required */
86 /* SSSE3 support required */
88 /* SSE4a support required */
90 /* LZCNT support required */
92 /* POPCNT support required */
94 /* SSE4.1 support required */
96 /* SSE4.2 support required */
98 /* AVX support required */
100 /* AVX2 support required */
102 /* Intel AVX-512 Foundation Instructions support required */
104 /* Intel AVX-512 Conflict Detection Instructions support required */
106 /* Intel AVX-512 Exponential and Reciprocal Instructions support
109 /* Intel AVX-512 Prefetch Instructions support required */
111 /* Intel AVX-512 VL Instructions support required. */
113 /* Intel AVX-512 DQ Instructions support required. */
115 /* Intel AVX-512 BW Instructions support required. */
117 /* Intel L1OM support required */
119 /* Intel K1OM support required */
121 /* Intel IAMCU support required */
123 /* Xsave/xrstor New Instructions support required */
125 /* Xsaveopt New Instructions support required */
127 /* AES support required */
129 /* PCLMUL support required */
131 /* FMA support required */
133 /* FMA4 support required */
135 /* XOP support required */
137 /* LWP support required */
139 /* BMI support required */
141 /* TBM support required */
143 /* MOVBE Instruction support required */
145 /* CMPXCHG16B instruction support required. */
147 /* EPT Instructions required */
149 /* RDTSCP Instruction support required */
151 /* FSGSBASE Instructions required */
153 /* RDRND Instructions required */
155 /* F16C Instructions required */
157 /* Intel BMI2 support required */
159 /* HLE support required */
161 /* RTM support required */
163 /* INVPCID Instructions required */
165 /* VMFUNC Instruction required */
167 /* Intel MPX Instructions required */
169 /* 64bit support available, used by -march= in assembler. */
171 /* RDRSEED instruction required. */
173 /* Multi-presisionn add-carry instructions are required. */
175 /* Supports prefetchw and prefetch instructions. */
177 /* SMAP instructions required. */
179 /* SHA instructions required. */
181 /* CLFLUSHOPT instruction required */
183 /* XSAVES/XRSTORS instruction required */
185 /* XSAVEC instruction required */
187 /* PREFETCHWT1 instruction required */
189 /* SE1 instruction required */
191 /* CLWB instruction required */
193 /* Intel AVX-512 IFMA Instructions support required. */
195 /* Intel AVX-512 VBMI Instructions support required. */
197 /* Intel AVX-512 4FMAPS Instructions support required. */
199 /* Intel AVX-512 4VNNIW Instructions support required. */
201 /* Intel AVX-512 VPOPCNTDQ Instructions support required. */
203 /* Intel AVX-512 VBMI2 Instructions support required. */
205 /* Intel AVX-512 VNNI Instructions support required. */
207 /* Intel AVX-512 BITALG Instructions support required. */
209 /* Intel AVX-512 BF16 Instructions support required. */
211 /* Intel AVX-512 VP2INTERSECT Instructions support required. */
212 CpuAVX512_VP2INTERSECT,
213 /* mwaitx instruction required */
215 /* Clzero instruction required */
217 /* OSPKE instruction required */
219 /* RDPID instruction required */
221 /* PTWRITE instruction required */
223 /* CET instructions support required */
226 /* GFNI instructions required */
228 /* VAES instructions required */
230 /* VPCLMULQDQ instructions required */
232 /* WBNOINVD instructions required */
234 /* PCONFIG instructions required */
236 /* WAITPKG instructions required */
238 /* CLDEMOTE instruction required */
240 /* MOVDIRI instruction support required */
242 /* MOVDIRR64B instruction required */
244 /* ENQCMD instruction required */
246 /* RDPRU instruction required */
248 /* MCOMMIT instruction required */
250 /* SEV-ES instruction(s) required */
252 /* 64bit support required */
254 /* Not supported in the 64bit mode */
256 /* The last bitfield in i386_cpu_flags. */
260 #define CpuNumOfUints \
261 (CpuMax / sizeof (unsigned int) / CHAR_BIT + 1)
262 #define CpuNumOfBits \
263 (CpuNumOfUints * sizeof (unsigned int) * CHAR_BIT)
265 /* If you get a compiler error for zero width of the unused field,
267 #define CpuUnused (CpuMax + 1)
269 /* We can check if an instruction is available with array instead
271 typedef union i386_cpu_flags
275 unsigned int cpui186:1;
276 unsigned int cpui286:1;
277 unsigned int cpui386:1;
278 unsigned int cpui486:1;
279 unsigned int cpui586:1;
280 unsigned int cpui686:1;
281 unsigned int cpucmov:1;
282 unsigned int cpufxsr:1;
283 unsigned int cpuclflush:1;
284 unsigned int cpunop:1;
285 unsigned int cpusyscall:1;
286 unsigned int cpu8087:1;
287 unsigned int cpu287:1;
288 unsigned int cpu387:1;
289 unsigned int cpu687:1;
290 unsigned int cpufisttp:1;
291 unsigned int cpummx:1;
292 unsigned int cpusse:1;
293 unsigned int cpusse2:1;
294 unsigned int cpua3dnow:1;
295 unsigned int cpua3dnowa:1;
296 unsigned int cpusse3:1;
297 unsigned int cpupadlock:1;
298 unsigned int cpusvme:1;
299 unsigned int cpuvmx:1;
300 unsigned int cpusmx:1;
301 unsigned int cpussse3:1;
302 unsigned int cpusse4a:1;
303 unsigned int cpulzcnt:1;
304 unsigned int cpupopcnt:1;
305 unsigned int cpusse4_1:1;
306 unsigned int cpusse4_2:1;
307 unsigned int cpuavx:1;
308 unsigned int cpuavx2:1;
309 unsigned int cpuavx512f:1;
310 unsigned int cpuavx512cd:1;
311 unsigned int cpuavx512er:1;
312 unsigned int cpuavx512pf:1;
313 unsigned int cpuavx512vl:1;
314 unsigned int cpuavx512dq:1;
315 unsigned int cpuavx512bw:1;
316 unsigned int cpul1om:1;
317 unsigned int cpuk1om:1;
318 unsigned int cpuiamcu:1;
319 unsigned int cpuxsave:1;
320 unsigned int cpuxsaveopt:1;
321 unsigned int cpuaes:1;
322 unsigned int cpupclmul:1;
323 unsigned int cpufma:1;
324 unsigned int cpufma4:1;
325 unsigned int cpuxop:1;
326 unsigned int cpulwp:1;
327 unsigned int cpubmi:1;
328 unsigned int cputbm:1;
329 unsigned int cpumovbe:1;
330 unsigned int cpucx16:1;
331 unsigned int cpuept:1;
332 unsigned int cpurdtscp:1;
333 unsigned int cpufsgsbase:1;
334 unsigned int cpurdrnd:1;
335 unsigned int cpuf16c:1;
336 unsigned int cpubmi2:1;
337 unsigned int cpuhle:1;
338 unsigned int cpurtm:1;
339 unsigned int cpuinvpcid:1;
340 unsigned int cpuvmfunc:1;
341 unsigned int cpumpx:1;
342 unsigned int cpulm:1;
343 unsigned int cpurdseed:1;
344 unsigned int cpuadx:1;
345 unsigned int cpuprfchw:1;
346 unsigned int cpusmap:1;
347 unsigned int cpusha:1;
348 unsigned int cpuclflushopt:1;
349 unsigned int cpuxsaves:1;
350 unsigned int cpuxsavec:1;
351 unsigned int cpuprefetchwt1:1;
352 unsigned int cpuse1:1;
353 unsigned int cpuclwb:1;
354 unsigned int cpuavx512ifma:1;
355 unsigned int cpuavx512vbmi:1;
356 unsigned int cpuavx512_4fmaps:1;
357 unsigned int cpuavx512_4vnniw:1;
358 unsigned int cpuavx512_vpopcntdq:1;
359 unsigned int cpuavx512_vbmi2:1;
360 unsigned int cpuavx512_vnni:1;
361 unsigned int cpuavx512_bitalg:1;
362 unsigned int cpuavx512_bf16:1;
363 unsigned int cpuavx512_vp2intersect:1;
364 unsigned int cpumwaitx:1;
365 unsigned int cpuclzero:1;
366 unsigned int cpuospke:1;
367 unsigned int cpurdpid:1;
368 unsigned int cpuptwrite:1;
369 unsigned int cpuibt:1;
370 unsigned int cpushstk:1;
371 unsigned int cpugfni:1;
372 unsigned int cpuvaes:1;
373 unsigned int cpuvpclmulqdq:1;
374 unsigned int cpuwbnoinvd:1;
375 unsigned int cpupconfig:1;
376 unsigned int cpuwaitpkg:1;
377 unsigned int cpucldemote:1;
378 unsigned int cpumovdiri:1;
379 unsigned int cpumovdir64b:1;
380 unsigned int cpuenqcmd:1;
381 unsigned int cpurdpru:1;
382 unsigned int cpumcommit:1;
383 unsigned int cpusev_es:1;
384 unsigned int cpu64:1;
385 unsigned int cpuno64:1;
387 unsigned int unused:(CpuNumOfBits - CpuUnused);
390 unsigned int array[CpuNumOfUints];
393 /* Position of opcode_modifier bits. */
397 /* has direction bit. */
399 /* set if operands can be both bytes and words/dwords/qwords, encoded the
400 canonical way; the base_opcode field should hold the encoding for byte
403 /* load form instruction. Must be placed before store form. */
405 /* insn has a modrm byte. */
407 /* special case for jump insns; value has to be 1 */
413 /* special case for intersegment leaps/calls */
414 #define JUMP_INTERSEGMENT 4
415 /* absolute address for jump */
416 #define JUMP_ABSOLUTE 5
418 /* FP insn memory format bit, sized by 0x4 */
420 /* src/dest swap for floats. */
422 /* needs size prefix if in 32-bit mode */
424 /* needs size prefix if in 16-bit mode */
426 /* needs size prefix if in 64-bit mode */
429 /* check register size. */
431 /* instruction ignores operand size prefix and in Intel mode ignores
432 mnemonic size suffix check. */
434 /* default insn size depends on mode */
435 #define DEFAULTSIZE 2
437 /* any memory size */
439 /* b suffix on instruction illegal */
441 /* w suffix on instruction illegal */
443 /* l suffix on instruction illegal */
445 /* s suffix on instruction illegal */
447 /* q suffix on instruction illegal */
449 /* long double suffix on instruction illegal */
451 /* instruction needs FWAIT */
453 /* IsString provides for a quick test for string instructions, and
454 its actual value also indicates which of the operands (if any)
455 requires use of the %es segment. */
456 #define IS_STRING_ES_OP0 2
457 #define IS_STRING_ES_OP1 3
459 /* RegMem is for instructions with a modrm byte where the register
460 destination operand should be encoded in the mod and regmem fields.
461 Normally, it will be encoded in the reg field. We add a RegMem
462 flag to indicate that it should be encoded in the regmem field. */
464 /* quick test if branch instruction is MPX supported */
466 /* quick test if NOTRACK prefix is supported */
468 /* quick test for lockable instructions */
470 /* fake an extra reg operand for clr, imul and special register
471 processing for some instructions. */
473 /* An implicit xmm0 as the first operand */
475 /* The HLE prefix is OK:
476 1. With a LOCK prefix.
477 2. With or without a LOCK prefix.
478 3. With a RELEASE (0xf3) prefix.
480 #define HLEPrefixNone 0
481 #define HLEPrefixLock 1
482 #define HLEPrefixAny 2
483 #define HLEPrefixRelease 3
485 /* An instruction on which a "rep" prefix is acceptable. */
487 /* Convert to DWORD */
489 /* Convert to QWORD */
491 /* Address prefix changes register operand */
493 /* opcode is a prefix */
495 /* instruction has extension in 8 bit imm */
497 /* instruction don't need Rex64 prefix. */
499 /* deprecated fp insn, gets a warning */
501 /* insn has VEX prefix:
502 1: 128bit VEX prefix (or operand dependent).
503 2: 256bit VEX prefix.
504 3: Scalar VEX prefix.
510 /* How to encode VEX.vvvv:
511 0: VEX.vvvv must be 1111b.
512 1: VEX.NDS. Register-only source is encoded in VEX.vvvv where
513 the content of source registers will be preserved.
514 VEX.DDS. The second register operand is encoded in VEX.vvvv
515 where the content of first source register will be overwritten
517 VEX.NDD2. The second destination register operand is encoded in
518 VEX.vvvv for instructions with 2 destination register operands.
519 For assembler, there are no difference between VEX.NDS, VEX.DDS
521 2. VEX.NDD. Register destination is encoded in VEX.vvvv for
522 instructions with 1 destination register operand.
523 3. VEX.LWP. Register destination is encoded in VEX.vvvv and one
524 of the operands can access a memory location.
530 /* How the VEX.W bit is used:
531 0: Set by the REX.W bit.
532 1: VEX.W0. Should always be 0.
533 2: VEX.W1. Should always be 1.
534 3: VEX.WIG. The VEX.W bit is ignored.
540 /* VEX opcode prefix:
541 0: VEX 0x0F opcode prefix.
542 1: VEX 0x0F38 opcode prefix.
543 2: VEX 0x0F3A opcode prefix
544 3: XOP 0x08 opcode prefix.
545 4: XOP 0x09 opcode prefix
546 5: XOP 0x0A opcode prefix.
555 /* number of VEX source operands:
556 0: <= 2 source operands.
557 1: 2 XOP source operands.
558 2: 3 source operands.
560 #define XOP2SOURCES 1
561 #define VEX3SOURCES 2
563 /* Instruction with vector SIB byte:
564 1: 128bit vector register.
565 2: 256bit vector register.
566 3: 512bit vector register.
572 /* SSE to AVX support required */
574 /* No AVX equivalent */
577 /* insn has EVEX prefix:
578 1: 512bit EVEX prefix.
579 2: 128bit EVEX prefix.
580 3: 256bit EVEX prefix.
581 4: Length-ignored (LIG) EVEX prefix.
582 5: Length determined from actual operands.
591 /* AVX512 masking support:
592 1: Zeroing or merging masking depending on operands.
594 3: Both zeroing and merging masking.
596 #define DYNAMIC_MASKING 1
597 #define MERGING_MASKING 2
598 #define BOTH_MASKING 3
601 /* AVX512 broadcast support. The number of bytes to broadcast is
602 1 << (Broadcast - 1):
608 #define BYTE_BROADCAST 1
609 #define WORD_BROADCAST 2
610 #define DWORD_BROADCAST 3
611 #define QWORD_BROADCAST 4
614 /* Static rounding control is supported. */
617 /* Supress All Exceptions is supported. */
620 /* Compressed Disp8*N attribute. */
621 #define DISP8_SHIFT_VL 7
624 /* Default mask isn't allowed. */
627 /* The second operand must be a vector register, {x,y,z}mmN, where N is a multiple of 4.
628 It implicitly denotes the register group of {x,y,z}mmN - {x,y,z}mm(N + 3).
632 /* Support encoding optimization. */
641 /* ISA64: Don't change the order without other code adjustments.
642 0: Common to AMD64 and Intel64.
649 #define INTEL64ONLY 3
651 /* The last bitfield in i386_opcode_modifier. */
655 typedef struct i386_opcode_modifier
660 unsigned int modrm:1;
662 unsigned int floatmf:1;
663 unsigned int floatr:1;
665 unsigned int checkregsize:1;
666 unsigned int mnemonicsize:2;
667 unsigned int anysize:1;
668 unsigned int no_bsuf:1;
669 unsigned int no_wsuf:1;
670 unsigned int no_lsuf:1;
671 unsigned int no_ssuf:1;
672 unsigned int no_qsuf:1;
673 unsigned int no_ldsuf:1;
674 unsigned int fwait:1;
675 unsigned int isstring:2;
676 unsigned int regmem:1;
677 unsigned int bndprefixok:1;
678 unsigned int notrackprefixok:1;
679 unsigned int islockable:1;
680 unsigned int regkludge:1;
681 unsigned int implicit1stxmm0:1;
682 unsigned int hleprefixok:2;
683 unsigned int repprefixok:1;
684 unsigned int todword:1;
685 unsigned int toqword:1;
686 unsigned int addrprefixopreg:1;
687 unsigned int isprefix:1;
688 unsigned int immext:1;
689 unsigned int norex64:1;
692 unsigned int vexvvvv:2;
694 unsigned int vexopcode:3;
695 unsigned int vexsources:2;
696 unsigned int vecsib:2;
697 unsigned int sse2avx:1;
698 unsigned int noavx:1;
700 unsigned int masking:2;
701 unsigned int broadcast:3;
702 unsigned int staticrounding:1;
704 unsigned int disp8memshift:3;
705 unsigned int nodefmask:1;
706 unsigned int implicitquadgroup:1;
707 unsigned int optimize:1;
708 unsigned int attmnemonic:1;
709 unsigned int attsyntax:1;
710 unsigned int intelsyntax:1;
711 unsigned int isa64:2;
712 } i386_opcode_modifier;
714 /* Operand classes. */
716 #define CLASS_WIDTH 4
720 Reg, /* GPRs and FP regs, distinguished by operand size */
721 SReg, /* Segment register */
722 RegCR, /* Control register */
723 RegDR, /* Debug register */
724 RegTR, /* Test register */
725 RegMMX, /* MMX register */
726 RegSIMD, /* XMM/YMM/ZMM registers, distinguished by operand size */
727 RegMask, /* Vector Mask register */
728 RegBND, /* Bound register */
731 /* Special operand instances. */
733 #define INSTANCE_WIDTH 3
734 enum operand_instance
737 Accum, /* Accumulator %al/%ax/%eax/%rax/%st(0)/%xmm0 */
738 RegC, /* %cl / %cx / %ecx / %rcx, e.g. register to hold shift count */
739 RegD, /* %dl / %dx / %edx / %rdx, e.g. register to hold I/O port addr */
740 RegB, /* %bl / %bx / %ebx / %rbx */
743 /* Position of operand_type bits. */
747 /* Class and Instance */
748 ClassInstance = CLASS_WIDTH + INSTANCE_WIDTH - 1,
749 /* 1 bit immediate */
751 /* 8 bit immediate */
753 /* 8 bit immediate sign extended */
755 /* 16 bit immediate */
757 /* 32 bit immediate */
759 /* 32 bit immediate sign extended */
761 /* 64 bit immediate */
763 /* 8bit/16bit/32bit displacements are used in different ways,
764 depending on the instruction. For jumps, they specify the
765 size of the PC relative displacement, for instructions with
766 memory operand, they specify the size of the offset relative
767 to the base register, and for instructions with memory offset
768 such as `mov 1234,%al' they specify the size of the offset
769 relative to the segment base. */
770 /* 8 bit displacement */
772 /* 16 bit displacement */
774 /* 32 bit displacement */
776 /* 32 bit signed displacement */
778 /* 64 bit displacement */
780 /* Register which can be used for base or index in memory operand. */
784 /* WORD size. 2 byte */
786 /* DWORD size. 4 byte */
788 /* FWORD size. 6 byte */
790 /* QWORD size. 8 byte */
792 /* TBYTE size. 10 byte */
800 /* Unspecified memory size. */
803 /* The number of bits in i386_operand_type. */
807 #define OTNumOfUints \
808 ((OTNum - 1) / sizeof (unsigned int) / CHAR_BIT + 1)
809 #define OTNumOfBits \
810 (OTNumOfUints * sizeof (unsigned int) * CHAR_BIT)
812 /* If you get a compiler error for zero width of the unused field,
814 #define OTUnused OTNum
816 typedef union i386_operand_type
820 unsigned int class:CLASS_WIDTH;
821 unsigned int instance:INSTANCE_WIDTH;
824 unsigned int imm8s:1;
825 unsigned int imm16:1;
826 unsigned int imm32:1;
827 unsigned int imm32s:1;
828 unsigned int imm64:1;
829 unsigned int disp8:1;
830 unsigned int disp16:1;
831 unsigned int disp32:1;
832 unsigned int disp32s:1;
833 unsigned int disp64:1;
834 unsigned int baseindex:1;
837 unsigned int dword:1;
838 unsigned int fword:1;
839 unsigned int qword:1;
840 unsigned int tbyte:1;
841 unsigned int xmmword:1;
842 unsigned int ymmword:1;
843 unsigned int zmmword:1;
844 unsigned int unspecified:1;
846 unsigned int unused:(OTNumOfBits - OTUnused);
849 unsigned int array[OTNumOfUints];
852 typedef struct insn_template
854 /* instruction name sans width suffix ("mov" for movl insns) */
857 /* base_opcode is the fundamental opcode byte without optional
859 unsigned int base_opcode;
860 #define Opcode_D 0x2 /* Direction bit:
861 set if Reg --> Regmem;
862 unset if Regmem --> Reg. */
863 #define Opcode_FloatR 0x8 /* Bit to swap src/dest for float insns. */
864 #define Opcode_FloatD 0x400 /* Direction bit for float insns. */
865 #define Opcode_SIMD_FloatD 0x1 /* Direction bit for SIMD fp insns. */
866 #define Opcode_SIMD_IntD 0x10 /* Direction bit for SIMD int insns. */
868 /* extension_opcode is the 3 bit extension for group <n> insns.
869 This field is also used to store the 8-bit opcode suffix for the
870 AMD 3DNow! instructions.
871 If this template has no extension opcode (the usual case) use None
873 unsigned short extension_opcode;
874 #define None 0xffff /* If no extension_opcode is possible. */
877 unsigned char opcode_length;
879 /* how many operands */
880 unsigned char operands;
882 /* cpu feature flags */
883 i386_cpu_flags cpu_flags;
885 /* the bits in opcode_modifier are used to generate the final opcode from
886 the base_opcode. These bits also are used to detect alternate forms of
887 the same instruction */
888 i386_opcode_modifier opcode_modifier;
890 /* operand_types[i] describes the type of operand i. This is made
891 by OR'ing together all of the possible type masks. (e.g.
892 'operand_types[i] = Reg|Imm' specifies that operand i can be
893 either a register or an immediate operand. */
894 i386_operand_type operand_types[MAX_OPERANDS];
898 extern const insn_template i386_optab[];
900 /* these are for register name --> number & type hash lookup */
904 i386_operand_type reg_type;
905 unsigned char reg_flags;
906 #define RegRex 0x1 /* Extended register. */
907 #define RegRex64 0x2 /* Extended 8 bit register. */
908 #define RegVRex 0x4 /* Extended vector register. */
909 unsigned char reg_num;
910 #define RegIP ((unsigned char ) ~0)
911 /* EIZ and RIZ are fake index registers. */
912 #define RegIZ (RegIP - 1)
913 /* FLAT is a fake segment register (Intel mode). */
914 #define RegFlat ((unsigned char) ~0)
915 signed char dw2_regnum[2];
916 #define Dw2Inval (-1)
920 /* Entries in i386_regtab. */
923 #define REGNAM_EAX 41
925 extern const reg_entry i386_regtab[];
926 extern const unsigned int i386_regtab_size;
931 unsigned int seg_prefix;
935 extern const seg_entry cs;
936 extern const seg_entry ds;
937 extern const seg_entry ss;
938 extern const seg_entry es;
939 extern const seg_entry fs;
940 extern const seg_entry gs;