opcodes 0.1.0

Database of Processor Instructions/Opcodes

Opcodes Project

The goal of this project is to document instruction sets in a format convenient for tools development. An instruction set is represented by three files:

• An XML file that describes instructions

• An XSD file that describes the structure of the XML file

• A Python module that reads the XML file and represents it as a set of Python objects

This project is a spin-off from Peach-Py assembler.

Current status

The project provides descriptions for most user-mode x86-64 instructions up to AVX2 and SHA (including 3dnow!+, XOP, FMA3, FMA4, TBM and BMI2). The following instructions are currently NOT supported:

• All priveledged instructions and user-mode system instructions (e.g. XSAVE, SLDT)

• Legacy string/streaming instructions (MOVS/SCAS/CMPS/STOS/LODS)

• LOCK and REP/REPZ/REPNZ prefixes

• x87 FPU instructions

• VIA Padlock instructions

• Intel HTM instructions

• Intel AVX-512 instructions

For each instruction the following information is provided:

• Summary description

• Instruction names in Intel assembly (Peach-Py, NASM, YASM and MASM assemblers), AT&T assembly (GNU assembler) and Plan 9 assembly (Go assembler)

• Operand types and characteristics (whether the operand is input or output)

• Implicit input and output registers

• ISA where this instruction was introduced

• Whether the instruction operates on FPU or MMX state

• Whether the instruction operates on AVX or legacy SSE state