Executable Trash Generator
(ETG Engine)

version 2.00



User's Manual



DESCRIPTION

ETG is an engine used to generate x86 instructions of the given properties.

The following properties of the generic code may be specified:

The 8-bit registers are processed as parts of the 32-bit registers, so when including REG_EAX into destination-register-set, AL and AH will also be used.

16-bit registers are used only as source registers in some instructions, such as MOVSX.

No prefixes 66h/67h are generated.

INCLUDING

  To include ETG into your code, do the following:

    include ETG.INC

    push    offset rnd       ; offset of rnd()
    push    offset buf       ; offset of the output buffer
    push    size buf         ; max size of output buffer
    push    <NCMDS>          ; max number of instructions (max 0x7FFFFFFF)
    push    offset buf_size  ; resulting bufsize
    push    REG_EAX+REG_EBX  ; set of destination registers, [REG_xxx]
    push    REG_ECX+REG_EDX  ; set of source registers, [REG_xxx]
    push    ETG_ALL-ETG_JMPS ; set of available commands, [ETG_xxx]
    push    user_param       ; user parameter, passed into rnd()
    call    etg_engine

As a result, buffer 'buf' is filled with instructions, and DWORD 'buf_size' contains size of the buffer. Number of generated instruction is not more than parameter, and total size of generated code ('buf_size') is not more than specified maximal buffer size.

EXTERNAL RANDOMER

To allow generating code which depends on only passing parameters and algorithm of random number generator, ETG uses external randomer of the following form:

  DWORD cdecl rnd(DWORD userparam, DWORD range)
  {
    ...
    return x;   // x=[0..range-1]
  }

Here is an example of such randomer, written in assembler:

randseed        dd      ?

rnd:            mov     eax, randseed
                imul    eax, 214013
                add     eax, 2531011
                mov     randseed, eax
                shr     eax, 16
                imul    eax, [esp+8]
                shr     eax, 16
                ret

So, the rnd() subroutine may be called as following:

                push    100             ; range
                push    12345678h       ; user-param
                call    rnd
                add     esp, 8
                ; eax=0..99

FEATURES

Code of the ETG Engine is offset-independent, so it may be displaced and even permutated. The 'etg_engine' subroutine is written in pascal-style, so it clears all parameters from the stack when returning to caller. All registers are saved. Flags are modified, and DF is cleared (CLD).

Where it can be used?