DyninstAPI defensive mode manual update.
[dyninst.git] / instructionAPI / doc / latex / group__instructiondecoder.tex
1 \subsection{Instruction Decoding}
2 \label{group__instructiondecoder}\index{Instruction Decoding@{Instruction Decoding}}
3 An InstructionDecoder interprets a sequence of bytes according to a given machine language and transforms them into an instruction representation. It determines the opcode of the machine instruction, translates that opcode to an Operation object, uses that Operation to determine how to decode the instruction's Operands, and produces a decoded Instruction.
4
5
6 \begin{DoxyImage}
7 \includegraphics{decoder_use}
8 \caption{The InstructionDecoder's inputs and outputs}
9 \end{DoxyImage}
10  Instruction decoders are built from the following elements:
11 \begin{DoxyItemize}
12 \item A function to find and extract an opcode given a pointer into a buffer that points to the beginning of a machine instruction
13 \item A table that, for a particular architecture, maps opcodes to Operations and functions that decode Operands
14 \end{DoxyItemize}
15
16 From these elements, it is possible to generalize the construction of Instructions from Operations and Operands to an entirely platform-\/independent algorithm. Likewise, much of the construction of the ASTs representing each operand can be performed in a platform-\/independent manner.