WARNING: Wiki content is an archive, no promise about quality!
Please choose a tutorial page:
- Fundamentals -- Information about C
- Tools
- Registers
- Simple Instructions
- Example 1 -- SC CDKey Initial Verification
- Example 2 -- SC CDKey Shuffle
- Example 2b -- SC CDKey Final Decode
- The Stack
- Functions
- Example 3 -- Storm.dll SStrChr
- Assembly Summary
- Machine Code
- Example 4 -- Smashing the Stack
- Cracking a Game
- Example 5 -- Cracking a game
- Example 6 -- Writing a keygen
- .dll Injection and Patching
- Memory Searching
- Example 7 -- Writing a cheat for Starcraft (1.05)
- Example 7 Step 1 -- Displaying Messages
- Example 7 Step 1b -- Above, w/ func ptrs
- Example 7 Final
- Example 8 -- Getting IX86.dll files
- 16-bit Assembly
- Example 9 -- Keygen for a 16-bit game
- Example 10 -- Writing a loader
This section is the first section specific to assembly. So if you're reading through the full guide, get ready for some actual learning!
A register is like a variable, except that there are a fixed number of registers. Each register is a special spot in the CPU where a single value is stored. A register is the only place where math can be done (addition, subtraction, etc). Registers frequently hold pointers which reference memory. Movement of values between registers and memory is very common.
Intel assembly has 8 general purpose 32-bit registers: eax, ebx, ecx, edx, esi, edi, ebp, esp. Although any data can be moved between any of these registers, compilers commonly use the same registers for the same uses, and some instructions (such as multiplication and division) can only use the registers they're designed to use.
Different compilers may have completely different conventions on how the various registers are used. For the purposes of this document, I will discuss the most common compiler, Microsoft's.
Volatility
Some registers are typically volatile across functions, and others remain unchanged. This is a feature of the compiler's standards and must be looked after in the code, registers are not preserved automatically (although in some assembly languages they are -- but not in x86). What that means is, when a function is called, there is no guarantee that volatile registers will retain their value when the function returns, and it's the function's responsibility to preserve non-volatile registers.
The conventions used by Microsoft's compiler are:
- Volatile: ecx, edx
- Non-Volatile: ebx, esi, edi, ebp
- Special: eax, esp (discussed later)
General Purpose Registers
This section will look at the 8 general purpose registers on the x86 architecture.
eax
eax is a 32-bit general-purpose register with two common uses: to store the return value of a function and as a special register for certain calculations. It is technically a volatile register, since the value isn't preserved. Instead, its value is set to the return value of a function before a function returns. Other than esp, this is probably the most important register to remember for this reason. eax is also used specifically in certain calculations, such as multiplication and division, as a special register. That use will be examined in the instructions section.
Here is an example of a function returning in C:
return 3; // Return the value 3
Here's the same code in assembly:
mov eax, 3 ; Set eax (the return value) to 3
ret ; Return
ebx
ebx is a non-volatile general-purpose register. It has no specific uses, but is often set to a commonly used value (such as 0) throughout a function to speed up calculations.
ecx
ecx is a volatile general-purpose register that is occasionally used as a function parameter or as a loop counter.
Functions of the "__fastcall" convention pass the first two parameters to a function using ecx and edx. Additionally, when calling a member function of a class, a pointer to that class is often passed in ecx no matter what the calling convention is.
Additionally, ecx is often used as a loop counter. for loops generally, although not always, set the accumulator variable to ecx. rep- instructions also use ecx as a counter, automatically decrementing it till it reaches 0. This class of function will be discussed in a later section.
edx
edx is a volatile general-purpose register that is occasionally used as a function parameter. Like ecx, edx is used for "__fastcall" functions.
Besides fastcall, edx is generally used for storing short-term variables within a function.
esi
esi is a non-volatile general-purpose register that is often used as a pointer. Specifically, for "rep-" class instructions, which require a source and a destination for data, esi points to the "source". esi often stores data that is used throughout a function because it doesn't change.
edi
edi is a non-volatile general-purpose register that is often used as a pointer. It is similar to esi, except that it is generally used as a destination for data.
ebp
ebp is a non-volatile general-purpose register that has two distinct uses depending on compile settings: it is either the frame pointer or a general purpose register.
If compilation is not optimized, or code is written by hand, ebp keeps track of where the stack is at the beginning of a function (the stack will be explained in great detail in a later section). Because the stack changes throughout a function, having ebp set to the original value allows variables stored on the stack to be referenced easily. This will be explored in detail when the stack is explained.
If compilation is optimized, ebp is used as a general register for storing any kind of data, while calculations for the stack pointer are done based on the stack pointer moving (which gets confusing -- luckily, IDA automatically detects and corrects a moving stack pointer!)
esp
esp is a special register that stores a pointer to the top of the stack (the top is actually at a lower virtual address than the bottom as the stack grows downwards in memory towards the heap). Math is rarely done directly on esp, and the value of esp must be the same at the beginning and the end of each function. esp will be examined in much greater detail in a later section.
Special Purpose Registers
For special purpose and floating point registers not listed here, have a look at the Wikipedia Article or other reference sites.
eip
eip, or the instruction pointer, is a special-purpose register which stores a pointer to the address of the instruction that is currently executing. Making a jump is like adding to or subtracting from the instruction pointer.
After each instruction, a value equal to the size of the instruction is added to eip, which means that eip points at the machine code for the next instruction. This simple example shows the automatic addition to eip at every step:
eip+1 53 push ebx
eip+4 8B 54 24 08 mov edx, [esp+arg_0]
eip+2 31 DB xor ebx, ebx
eip+2 89 D3 mov ebx, edx
eip+3 8D 42 07 lea eax, [edx+7]
.....
flags
In the flags register, each bit has a specific meaning and they are used to store meta-information about the results of previous operations. For example, whether the last calculation overflowed the register or whether the operands were equal. Our interest in the flags register is usually around the cmp and test operations which will commonly set or unset the zero, carry and overflow flags. These flags will then be tested by a conditional jump which may be controlling program flow or a loop.
16-bit and 8-bit Registers
In addition to the 8 32-bit registers available, there are also a number of 16-bit and 8-bit registers. The confusing thing about these registers it that they use the same storage space as the 32-bit registers. In other words, every 16-bit register is half of one of the 32-bit registers, so that changing the 16-bit also changes the 32-bit. Furthermore, the 8-bit registers are part of the 16-bit registers.
For example, eax is a 32-bit register. The lower half of eax is ax, a 16-bit register. ax is divided into two 8-bit registers, ah and al (a-high and a-low).
- There are 8 32-bit registers: eax, ebx, ecx, edx, esi, edi, ebp, esp.
- There are 8 16-bit registers: ax, bx, cx, dx, si, di, bp, sp.
- There are 8 8-bit registers: ah, al, bh, bl, ch, cl, dh, dl.
The relationships of these registers is shown in the table below:
<table border='1px' cellspacing='0' cellpadding='0' width='485'>
<tr>
<td colspan='1' width='25' align='left'>
32-bit
</td>
<td colspan='4' width='100' align='center'>
eax
</td>
<td colspan='1' rowspan='3' width='15'>
</td>
<td colspan='4' width='100' align='center'>
ebx
</td>
<td colspan='1' rowspan='3' width='15'>
</td>
<td colspan='4' width='100' align='center'>
ecx
</td>
<td colspan='1' rowspan='3' width='15'>
</td>
<td colspan='4' width='100' align='center'>
edx
</td>
</tr>
<tr>
<td colspan='1' width='25' align='left'>
16-bit
</td>
<td colspan='2' width='50' align='center'>
</td>
<td colspan='2' width='50' align='center'>
ax
</td>
<td colspan='2' width='50' align='center'>
</td>
<td colspan='2' width='50' align='center'>
bx
</td>
<td colspan='2' width='50' align='center'>
</td>
<td colspan='2' width='50' align='center'>
cx
</td>
<td colspan='2' width='50' align='center'>
</td>
<td colspan='2' width='50' align='center'>
dx
</td>
</tr>
<tr>
<td colspan='1' width='25' align='left'>
8-bit
</td>
<td colspan='1' width='25' align='center'>
</td>
<td colspan='1' width='25' align='center'>
</td>
<td colspan='1' width='25' align='center'>
ah
</td>
<td colspan='1' width='25' align='center'>
al
</td>
<td colspan='1' width='25' align='center'>
</td>
<td colspan='1' width='25' align='center'>
</td>
<td colspan='1' width='25' align='center'>
bh
</td>
<td colspan='1' width='25' align='center'>
bl
</td>
<td colspan='1' width='25' align='center'>
</td>
<td colspan='1' width='25' align='center'>
</td>
<td colspan='1' width='25' align='center'>
ch
</td>
<td colspan='1' width='25' align='center'>
cl
</td>
<td colspan='1' width='25' align='center'>
</td>
<td colspan='1' width='25' align='center'>
</td>
<td colspan='1' width='25' align='center'>
dh
</td>
<td colspan='1' width='25' align='center'>
dl
</td>
</tr>
<tr>
<td colspan='20'>
</td>
</tr>
<tr>
<td colspan='1' width='25' align='left'>
32-bit
</td>
<td colspan='4' width='100' align='center'>
esi
</td>
<td colspan='1' rowspan='2' width='15'>
</td>
<td colspan='4' width='100' align='center'>
edi
</td>
<td colspan='1' rowspan='2' width='15'>
</td>
<td colspan='4' width='100' align='center'>
ebp
</td>
<td colspan='1' rowspan='2' width='15'>
</td>
<td colspan='4' width='100' align='center'>
esp
</td>
</tr>
<tr>
<td colspan='1' width='25' align='left'>
16-bit
</td>
<td colspan='2' width='50' align='center'>
</td>
<td colspan='2' width='50' align='center'>
si
</td>
<td colspan='2' width='50' align='center'>
</td>
<td colspan='2' width='50' align='center'>
di
</td>
<td colspan='2' width='50' align='center'>
</td>
<td colspan='2' width='50' align='center'>
bp
</td>
<td colspan='2' width='50' align='center'>
</td>
<td colspan='2' width='50' align='center'>
sp
</td>
</tr>
</table>
Here are two examples:
<table border='1px' cellspacing='0' cellpadding='0'>
<tr>
<td width='50'>
eax
</td>
<td width='100'>
0x12345678
</td>
</tr>
<tr>
<td>
ax
</td>
<td>
0x5678
</td>
</tr>
<tr>
<td>
ah
</td>
<td>
0x56
</td>
</tr>
<tr>
<td>
al
</td>
<td>
0x78
</td>
</tr>
</table>
<table border='1px' cellspacing='0' cellpadding='0'>
<tr>
<td width='50'>
ebx
</td>
<td width='100'>
0x00000025
</td>
</tr>
<tr>
<td>
bx
</td>
<td>
0x0025
</td>
</tr>
<tr>
<td>
bh
</td>
<td>
0x00
</td>
</tr>
<tr>
<td>
bl
</td>
<td>
0x25
</td>
</tr>
</table>
64-bit Registers
A 64-bit register is made by concatenating a pair of 32-bit registers. This is shown by putting a colon between them.
The most common 64-bit register (used for operations such as division and multiplication) is edx:eax. This means that the 32-bits of edx are put in front of the 32-bits of eax, creating a double-long register, so to speak.
Here is a simple example:
<table border='1px' cellspacing='0' cellpadding='0'>
<tr>
<td width='80'>
edx
</td>
<td width='200'>
0x11223344
</td>
</tr>
<tr>
<td>
eax
</td>
<td>
0xaabbccdd
</td>
</tr>
<tr>
<td>
edx:eax
</td>
<td>
0x11223344aabbccdd
</td>
</tr>
</table>
Questions
Feel free to edit this section and post questions, I'll do my best to answer them. But you may need to contact me to let me know that a question exists.