uefi-ref/fasm
1
0
Fork 0
mirror of https://github.com/tgrysztar/fasm synced 2026-08-26 00:23:06 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

release 1.73.03

Browse source
This commit is contained in:
Tomasz Grysztar 2018-04-15 12:08:22 +02:00
parent cb136fe2a9
commit 142adcf9e9
30 changed files with 542 additions and 52 deletions
Download patch file Download diff file Expand all files Collapse all files

2
LICENSE.TXT
View file

@ -1,6 +1,6 @@
flat assembler version 1.73
Copyright (c) 1999-2017, Tomasz Grysztar.
Copyright (c) 1999-2018, Tomasz Grysztar.
All rights reserved.
This program is free for commercial and non-commercial use as long as

2
SOURCE/ASSEMBLE.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
assembler:

2
SOURCE/AVX.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
avx_single_source_pd_instruction_er_evex:

2
SOURCE/DOS/DPMI.INC
View file

@ -1,6 +1,6 @@
; flat assembler interface for DOS
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
init_dpmi_memory:

4
SOURCE/DOS/FASM.ASM
View file

@ -1,6 +1,6 @@
; flat assembler interface for DOS
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
format MZ
@ -336,7 +336,7 @@ get_params:
include '..\version.inc'
_logo db 'flat assembler version ',VERSION_STRING,24h
_copyright db 'Copyright (c) 1999-2017, Tomasz Grysztar',0Dh,0Ah,0
_copyright db 'Copyright (c) 1999-2018, Tomasz Grysztar',0Dh,0Ah,0
_usage db 0Dh,0Ah
db 'usage: fasm <source> [output]',0Dh,0Ah

2
SOURCE/DOS/MODES.INC
View file

@ -1,6 +1,6 @@
; flat assembler interface for DOS
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
segment modes use16

2
SOURCE/DOS/SYSTEM.INC
View file

@ -1,6 +1,6 @@
; flat assembler interface for DOS
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
go32:

2
SOURCE/ERRORS.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
out_of_memory:

2
SOURCE/EXPRCALC.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
calculate_expression:

2
SOURCE/EXPRPARS.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
convert_expression:

2
SOURCE/FORMATS.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
formatter:

4
SOURCE/LIBC/FASM.ASM
View file

@ -1,6 +1,6 @@
; flat assembler interface for Unix/libc
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
format ELF
@ -310,7 +310,7 @@ include 'system.inc'
include '..\version.inc'
_copyright db 'Copyright (c) 1999-2017, Tomasz Grysztar',0xA,0
_copyright db 'Copyright (c) 1999-2018, Tomasz Grysztar',0xA,0
_logo db 'flat assembler version ',VERSION_STRING,0
_usage db 0xA

2
SOURCE/LIBC/SYSTEM.INC
View file

@ -1,6 +1,6 @@
; flat assembler interface for Unix/libc
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
extrn malloc

4
SOURCE/LINUX/FASM.ASM
View file

@ -1,6 +1,6 @@
; flat assembler interface for Linux
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
format ELF executable 3
@ -288,7 +288,7 @@ include 'system.inc'
include '..\version.inc'
_copyright db 'Copyright (c) 1999-2017, Tomasz Grysztar',0xA,0
_copyright db 'Copyright (c) 1999-2018, Tomasz Grysztar',0xA,0
_logo db 'flat assembler version ',VERSION_STRING,0
_usage db 0xA

2
SOURCE/LINUX/SYSTEM.INC
View file

@ -1,6 +1,6 @@
; flat assembler interface for Linux
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
O_ACCMODE = 0003o

4
SOURCE/LINUX/X64/FASM.ASM
View file

@ -1,6 +1,6 @@
; flat assembler interface for Linux x64
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
format ELF64 executable 3 at 400000h
@ -304,7 +304,7 @@ include 'system.inc'
include '..\..\version.inc'
_copyright db 'Copyright (c) 1999-2017, Tomasz Grysztar',0xA,0
_copyright db 'Copyright (c) 1999-2018, Tomasz Grysztar',0xA,0
_logo db 'flat assembler version ',VERSION_STRING,0
_usage db 0xA

2
SOURCE/LINUX/X64/MODES.INC
View file

@ -1,6 +1,6 @@
; flat assembler interface for Linux x64
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
esp equ +rsp

2
SOURCE/LINUX/X64/SYSTEM.INC
View file

@ -1,6 +1,6 @@
; flat assembler interface for Linux x64
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
O_ACCMODE = 0003o

2
SOURCE/MESSAGES.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
_out_of_memory db 'out of memory',0

2
SOURCE/PARSER.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
parser:

2
SOURCE/PREPROCE.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
preprocessor:

2
SOURCE/SYMBDUMP.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
dump_symbols:

28
SOURCE/TABLES.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
include_variable db 'INCLUDE',0
@ -1300,6 +1300,8 @@ instructions_5:
dw sse_ss_instruction-instruction_handler
db 'rdmsr',32h
dw simple_extended_instruction-instruction_handler
db 'rdpid',7
dw rdpid_instruction-instruction_handler
db 'rdpmc',33h
dw simple_extended_instruction-instruction_handler
db 'rdtsc',31h
@ -1447,6 +1449,8 @@ instructions_6:
dw bndmov_instruction-instruction_handler
db 'bndstx',1Bh
dw bndstx_instruction-instruction_handler
db 'clzero',0
dw clzero_instruction-instruction_handler
db 'cmovae',43h
dw bs_instruction-instruction_handler
db 'cmovbe',46h
@ -1645,6 +1649,8 @@ instructions_6:
dw movpd_instruction-instruction_handler
db 'movups',10h
dw movps_instruction-instruction_handler
db 'mwaitx',0FBh
dw monitor_instruction-instruction_handler
db 'paddsb',0ECh
dw basic_mmx_instruction-instruction_handler
db 'paddsw',0EDh
@ -2011,6 +2017,10 @@ instructions_6:
dw simple_instruction_0f_01-instruction_handler
db 'xrstor',101b
dw fxsave_instruction-instruction_handler
db 'xsavec',4
dw xsaves_instruction-instruction_handler
db 'xsaves',5
dw xsaves_instruction-instruction_handler
db 'xsetbv',0D1h
dw simple_instruction_0f_01-instruction_handler
instructions_7:
@ -2023,7 +2033,7 @@ instructions_7:
db 'blsfill',12h
dw tbm_instruction-instruction_handler
db 'clflush',111b
dw fxsave_instruction-instruction_handler
dw clflush_instruction-instruction_handler
db 'cmovnae',42h
dw bs_instruction-instruction_handler
db 'cmovnbe',47h
@ -2113,7 +2123,7 @@ instructions_7:
db 'invvpid',81h
dw vmx_inv_instruction-instruction_handler
db 'ldmxcsr',10b
dw fxsave_instruction-instruction_handler
dw stmxcsr_instruction-instruction_handler
db 'loopned',0E0h
dw loop_instruction_32bit-instruction_handler
db 'loopneq',0E0h
@ -2225,7 +2235,7 @@ instructions_7:
db 'segment',0
dw segment_directive-instruction_handler
db 'stmxcsr',11b
dw fxsave_instruction-instruction_handler
dw stmxcsr_instruction-instruction_handler
db 'syscall',05h
dw simple_extended_instruction-instruction_handler
db 'sysexit',35h
@ -2474,6 +2484,8 @@ instructions_7:
dw avx_single_source_instruction_38_noevex-instruction_handler
db 'vtestps',0Eh
dw avx_single_source_instruction_38_noevex-instruction_handler
db 'xrstors',3
dw xsaves_instruction-instruction_handler
db 'xsave64',100b
dw fxsave_instruction_64bit-instruction_handler
instructions_8:
@ -2591,6 +2603,8 @@ instructions_8:
dw mask_instruction_w-instruction_handler
db 'maskmovq',0
dw maskmovq_instruction-instruction_handler
db 'monitorx',0FAh
dw monitor_instruction-instruction_handler
db 'movmskpd',0
dw movmskpd_instruction-instruction_handler
db 'movmskps',0
@ -2983,8 +2997,12 @@ instructions_8:
dw prefix_instruction-instruction_handler
db 'xrstor64',101b
dw fxsave_instruction_64bit-instruction_handler
db 'xsavec64',4
dw xsaves_instruction_64bit-instruction_handler
db 'xsaveopt',110b
dw fxsave_instruction-instruction_handler
db 'xsaves64',5
dw xsaves_instruction_64bit-instruction_handler
instructions_9:
db 'cmpxchg8b',8
dw cmpxchgx_instruction-instruction_handler
@ -3404,6 +3422,8 @@ instructions_9:
dw avx_pd_instruction-instruction_handler
db 'vunpcklps',14h
dw avx_ps_instruction-instruction_handler
db 'xrstors64',3
dw xsaves_instruction_64bit-instruction_handler
instructions_10:
db 'aesdeclast',0DFh
dw sse4_instruction_66_38-instruction_handler

2
SOURCE/VARIABLE.INC
View file

@ -1,6 +1,6 @@
; flat assembler core variables
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
; Variables which have to be set up by interface:

4
SOURCE/VERSION.INC
View file

@ -1,6 +1,6 @@
; flat assembler version 1.73
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
;
; This programs is free for commercial and non-commercial use as long as
@ -33,7 +33,7 @@
; cannot simply be copied and put under another distribution licence
; (including the GNU Public Licence).
VERSION_STRING equ "1.73.02"
VERSION_STRING equ "1.73.03"
VERSION_MAJOR = 1
VERSION_MINOR = 73

4
SOURCE/WIN32/FASM.ASM
View file

@ -1,6 +1,6 @@
; flat assembler interface for Win32
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
format PE console
@ -342,7 +342,7 @@ section '.data' data readable writeable
include '..\version.inc'
_copyright db 'Copyright (c) 1999-2017, Tomasz Grysztar',0Dh,0Ah,0
_copyright db 'Copyright (c) 1999-2018, Tomasz Grysztar',0Dh,0Ah,0
_logo db 'flat assembler version ',VERSION_STRING,0
_usage db 0Dh,0Ah

2
SOURCE/WIN32/SYSTEM.INC
View file

@ -1,6 +1,6 @@
; flat assembler interface for Win32
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
CREATE_NEW = 1

67
SOURCE/X86_64.INC
View file

@ -1,6 +1,6 @@
; flat assembler core
; Copyright (c) 1999-2017, Tomasz Grysztar.
; Copyright (c) 1999-2018, Tomasz Grysztar.
; All rights reserved.
simple_instruction_except64:
@ -5449,12 +5449,21 @@ pmovsxdq_instruction:
mov [opcode_prefix],66h
ret
xsaves_instruction_64bit:
call operand_64bit
xsaves_instruction:
mov ah,0C7h
jmp xsave_common
fxsave_instruction_64bit:
call operand_64bit
fxsave_instruction:
mov [extended_code],0AEh
mov ah,0AEh
xor cl,cl
xsave_common:
mov [base_code],0Fh
mov [extended_code],ah
mov [postbyte_register],al
mov [mmx_size],cl
lods byte [esi]
call get_size_operator
cmp al,'['
@ -5462,22 +5471,19 @@ fxsave_instruction:
call get_address
mov ah,[operand_size]
or ah,ah
jz fxsave_size_ok
mov al,[postbyte_register]
cmp al,111b
je clflush_size_check
cmp al,10b
jb invalid_operand_size
cmp al,11b
ja invalid_operand_size
cmp ah,4
jz xsave_size_ok
cmp ah,[mmx_size]
jne invalid_operand_size
jmp fxsave_size_ok
clflush_size_check:
cmp ah,1
jne invalid_operand_size
fxsave_size_ok:
xsave_size_ok:
jmp instruction_ready
clflush_instruction:
mov ah,0AEh
mov cl,1
jmp xsave_common
stmxcsr_instruction:
mov ah,0AEh
mov cl,4
jmp xsave_common
prefetch_instruction:
mov [extended_code],18h
prefetch_mem_8bit:
@ -5823,6 +5829,21 @@ adx_instruction:
jne invalid_operand_size
call operand_64bit
jmp nomem_instruction_ready
rdpid_instruction:
mov [postbyte_register],al
mov [extended_code],0C7h
mov [base_code],0Fh
mov [opcode_prefix],0F3h
call take_register
cmp [code_type],64
je rdpid_64bit
cmp ah,4
jne invalid_operand_size
jmp nomem_instruction_ready
rdpid_64bit:
cmp ah,8
jne invalid_operand_size
jmp nomem_instruction_ready
vmclear_instruction:
mov [opcode_prefix],66h
@ -5965,6 +5986,20 @@ skinit_instruction:
jne invalid_operand
mov al,0DEh
jmp simple_instruction_0f_01
clzero_instruction:
call take_register
or al,al
jnz invalid_operand
mov al,0FCh
cmp [code_type],64
je clzero_64bit
cmp ah,4
jne invalid_operand
jmp simple_instruction_0f_01
clzero_64bit:
cmp ah,8
jne invalid_operand
jmp simple_instruction_0f_01
invlpga_instruction:
push eax
mov [base_code],0Fh

429
TOOLS/FAS.TXT Normal file
View file

@ -0,0 +1,429 @@
flat assembler
Symbolic information file format
Table 1 Header
/-------------------------------------------------------------------------\
| Offset | Size | Description |
|========|=========|======================================================|
| +0 | dword | Signature 1A736166h (little-endian). |
|--------|---------|------------------------------------------------------|
| +4 | byte | Major version of flat assembler. |
|--------|---------|------------------------------------------------------|
| +5 | byte | Minor version of flat assembler. |
|--------|---------|------------------------------------------------------|
| +6 | word | Length of header. |
|--------|---------|------------------------------------------------------|
| +8 | dword | Offset of input file name in the strings table. |
|--------|---------|------------------------------------------------------|
| +12 | dword | Offset of output file name in the strings table. |
|--------|---------|------------------------------------------------------|
| +16 | dword | Offset of strings table. |
|--------|---------|------------------------------------------------------|
| +20 | dword | Length of strings table. |
|--------|---------|------------------------------------------------------|
| +24 | dword | Offset of symbols table. |
|--------|---------|------------------------------------------------------|
| +28 | dword | Length of symbols table. |
|--------|---------|------------------------------------------------------|
| +32 | dword | Offset of preprocessed source. |
|--------|---------|------------------------------------------------------|
| +36 | dword | Length of preprocessed source. |
|--------|---------|------------------------------------------------------|
| +40 | dword | Offset of assembly dump. |
|--------|---------|------------------------------------------------------|
| +44 | dword | Length of assembly dump. |
|--------|---------|------------------------------------------------------|
| +48 | dword | Offset of section names table. |
|--------|---------|------------------------------------------------------|
| +52 | dword | Length of section names table. |
|--------|---------|------------------------------------------------------|
| +56 | dword | Offset of symbol references dump. |
|--------|---------|------------------------------------------------------|
| +60 | dword | Length of symbol references dump. |
\-------------------------------------------------------------------------/
Notes:
If header is shorter than 64 bytes, it comes from a version that does not
support dumping some of the structures. It should then be interpreted
that the data for missing structures could not be provided, not that the
size of that data is zero.
Offsets given in header generally mean positions in the file, however
input and output file names are specified by offsets in the strings table,
so you have to add their offset to the offset of strings table to obtain
the positions of those strings in the file.
The strings table contains just a sequence of ASCIIZ strings, which may
be referred to by other parts of the file. It contains the names of
main input file, the output file, and the names of the sections and
external symbols if there were any.
The symbols table is an array of 32-byte structures, each one in format
specified by table 2.
The preprocessed source is a sequence of preprocessed lines, each one
in format as defined in table 3.
The assembly dump contains an array of 28-byte structures, each one in
format specified by table 4, and at the end of this array an additional
double word containing the offset in output file at which the assembly
was ended.
It is possible that file does not contain assembly dump at all - this
happens when some error occured and only the preprocessed source was
dumped. If error occured during the preprocessing, only the source up to
the point of error is provided. In such case (and only then) the field
at offset 44 contains zero.
The section names table exists only when the output format was an object
file (ELF or COFF), and it is an array of 4-byte entries, each being an
offset of the name of the section in the strings table.
The index of section in this table is the same, as the index of section
in the generated object file.
The symbol references dump contains an array of 8-byte structures, each
one describes an event of some symbol being used. The first double word
of such structure contains an offset of symbol in the symbols table,
and the second double word is an offset of structure in assembly dump,
which specifies at what moment the symbol was referenced.
Table 2 Symbol structure
/-------------------------------------------------------------------------\
| Offset | Size | Description |
|========|=======|========================================================|
| +0 | qword | Value of symbol. |
|--------|-------|--------------------------------------------------------|
| +8 | word | Flags (table 2.1). |
|--------|-------|--------------------------------------------------------|
| +10 | byte | Size of data labelled by this symbol (zero means plain |
| | | label without size attached). |
|--------|-------|--------------------------------------------------------|
| +11 | byte | Type of value (table 2.2). Any value other than zero |
| | | means some kind of relocatable symbol. |
|--------|-------|--------------------------------------------------------|
| +12 | dword | Extended SIB, the first two bytes are register codes |
| | | and the second two bytes are corresponding scales. |
|--------|-------|--------------------------------------------------------|
| +16 | word | Number of pass in which symbol was defined last time. |
|--------|-------|--------------------------------------------------------|
| +18 | word | Number of pass in which symbol was used last time. |
|--------|-------|--------------------------------------------------------|
| +20 | dword | If the symbol is relocatable, this field contains |
| | | information about section or external symbol, to which |
| | | it is relative - otherwise this field has no meaning. |
| | | When the highest bit is cleared, the symbol is |
| | | relative to a section, and the bits 0-30 contain |
| | | the index (starting from 1) in the table of sections. |
| | | When the highest bit is set, the symbol is relative to |
| | | an external symbol, and the bits 0-30 contain the |
| | | the offset of the name of this symbol in the strings |
| | | table. |
|--------|-------|--------------------------------------------------------|
| +24 | dword | If the highest bit is cleared, the bits 0-30 contain |
| | | the offset of symbol name in the preprocessed source. |
| | | This name is a pascal-style string (byte length |
| | | followed by string data). |
| | | Zero in this field means an anonymous symbol. |
| | | If the highest bit is set, the bits 0-30 contain the |
| | | offset of the symbol name in the strings table, and |
| | | this name is a zero-ended string in this case (as are |
| | | all the strings there). |
|--------|-------|--------------------------------------------------------|
| +28 | dword | Offset in the preprocessed source of line that defined |
| | | this symbol (see table 3). |
\-------------------------------------------------------------------------/
Table 2.1 Symbol flags
/-----------------------------------------------------------------\
| Bit | Value | Description |
|=====|=======|===================================================|
| 0 | 1 | Symbol was defined. |
|-----|-------|---------------------------------------------------|
| 1 | 2 | Symbol is an assembly-time variable. |
|-----|-------|---------------------------------------------------|
| 2 | 4 | Symbol cannot be forward-referenced. |
|-----|-------|---------------------------------------------------|
| 3 | 8 | Symbol was used. |
|-----|-------|---------------------------------------------------|
| 4 | 10h | The prediction was needed when checking |
| | | whether the symbol was used. |
|-----|-------|---------------------------------------------------|
| 5 | 20h | Result of last predicted check for being used. |
|-----|-------|---------------------------------------------------|
| 6 | 40h | The prediction was needed when checking |
| | | whether the symbol was defined. |
|-----|-------|---------------------------------------------------|
| 7 | 80h | Result of last predicted check for being defined. |
|-----|-------|---------------------------------------------------|
| 8 | 100h | The optimization adjustment is applied to |
| | | the value of this symbol. |
|-----|-------|---------------------------------------------------|
| 9 | 200h | The value of symbol is negative number encoded |
| | | as two's complement. |
|-----|-------|---------------------------------------------------|
| 10 | 400h | Symbol is a special marker and has no value. |
\-----------------------------------------------------------------/
Notes:
Some of those flags are listed here just for completness, as they
have little use outside of the flat assembler. However the bit 0
is important, because the symbols table contains all the labels
that occured in source, even if some of them were in the
conditional blocks that did not get assembled.
Table 2.2 Symbol value types
/-------------------------------------------------------------------\
| Value | Description |
|=======|===========================================================|
| 0 | Absolute value. |
|-------|-----------------------------------------------------------|
| 1 | Relocatable segment address (only with MZ output). |
|-------|-----------------------------------------------------------|
| 2 | Relocatable 32-bit address. |
|-------|-----------------------------------------------------------|
| 3 | Relocatable relative 32-bit address (value valid only for |
| | symbol used in the same place where it was calculated, |
| | it should not occur in the symbol structure). |
|-------|-----------------------------------------------------------|
| 4 | Relocatable 64-bit address. |
|-------|-----------------------------------------------------------|
| 5 | [ELF only] GOT-relative 32-bit address. |
|-------|-----------------------------------------------------------|
| 6 | [ELF only] 32-bit address of PLT entry. |
|-------|-----------------------------------------------------------|
| 7 | [ELF only] Relative 32-bit address of PLT entry (value |
| | valid only for symbol used in the same place where it |
| | was calculated, it should not occur in the symbol |
| | structure). |
\-------------------------------------------------------------------/
Notes:
The types 3 and 7 should never be encountered in the symbols dump,
they are only used internally by the flat assembler.
If type value is a negative number, it is an opposite of a value
from this table and it means that the symbol of a given type has
been negated.
Table 2.3 Register codes for extended SIB
/------------------\
| Value | Register |
|=======|==========|
| 23h | BX |
|-------|----------|
| 25h | BP |
|-------|----------|
| 26h | SI |
|-------|----------|
| 27h | DI |
|-------|----------|
| 40h | EAX |
|-------|----------|
| 41h | ECX |
|-------|----------|
| 42h | EDX |
|-------|----------|
| 43h | EBX |
|-------|----------|
| 44h | ESP |
|-------|----------|
| 45h | EBP |
|-------|----------|
| 46h | ESI |
|-------|----------|
| 47h | EDI |
|-------|----------|
| 48h | R8D |
|-------|----------|
| 49h | R9D |
|-------|----------|
| 4Ah | R10D |
|-------|----------|
| 4Bh | R11D |
|-------|----------|
| 4Ch | R12D |
|-------|----------|
| 4Dh | R13D |
|-------|----------|
| 4Eh | R14D |
|-------|----------|
| 4Fh | R15D |
|-------|----------|
| 80h | RAX |
|-------|----------|
| 81h | RCX |
|-------|----------|
| 82h | RDX |
|-------|----------|
| 83h | RBX |
|-------|----------|
| 84h | RSP |
|-------|----------|
| 85h | RBP |
|-------|----------|
| 86h | RSI |
|-------|----------|
| 87h | RDI |
|-------|----------|
| 88h | R8 |
|-------|----------|
| 89h | R9 |
|-------|----------|
| 8Ah | R10 |
|-------|----------|
| 8Bh | R11 |
|-------|----------|
| 8Ch | R12 |
|-------|----------|
| 8Dh | R13 |
|-------|----------|
| 8Eh | R14 |
|-------|----------|
| 8Fh | R15 |
|-------|----------|
| 94h | EIP |
|-------|----------|
| 98h | RIP |
\------------------/
Table 3 Preprocessed line
/--------------------------------------------------------------------------\
| Offset | Size | Value |
|========|=================================================================|
| +0 | dword | When the line was loaded from source, this field |
| | | contains either zero (if it is the line from the main |
| | | input file), or an offset inside the preprocessed |
| | | source to the name of file, from which this line was |
| | | loaded (the name of file is zero-ended string). |
| | | When the line was generated by macroinstruction, this |
| | | field contains offset inside the preprocessed source to |
| | | the pascal-style string specifying the name of |
| | | macroinstruction, which generated this line. |
|--------|-------|---------------------------------------------------------|
| +4 | dword | Bits 0-30 contain the number of this line. |
| | | If the highest bit is zeroed, this line was loaded from |
| | | source. |
| | | If the highest bit is set, this line was generated by |
| | | macroinstruction. |
|--------|-------|---------------------------------------------------------|
| +8 | dword | If the line was loaded from source, this field contains |
| | | the position of the line inside the source file, from |
| | | which it was loaded. |
| | | If line was generated by macroinstruction, this field |
| | | contains the offset of preprocessed line, which invoked |
| | | the macroinstruction. |
| | | If line was generated by instantaneous macro, this |
| | | field is equal to the next one. |
|--------|-------|---------------------------------------------------------|
| +12 | dword | If the line was generated by macroinstruction, this |
| | | field contains offset of the preprocessed line inside |
| | | the definition of macro, from which this one was |
| | | generated. |
|--------|-------|---------------------------------------------------------|
| +16 | ? | The tokenized contents of line. |
\--------------------------------------------------------------------------/
Notes:
To determine, whether this is the line loaded from source, or generated by
macroinstruction, you need to check the highest bit of the second double
word.
The contents of line is no longer a text, which it was in source file,
but a sequence of tokens, ended with a zero byte.
Any chain of characters that aren't special ones, separated from other
similar chains with spaces or some other special characters, is converted
into symbol token. The first byte of this element has the value of 1Ah,
the second byte is the count of characters, followed by this amount of
bytes, which build the symbol.
Some characters have a special meaning, and cannot occur inside the
symbol, they split the symbols and are converted into separate tokens.
For example, if source contains this line of text:
mov ax,4
preprocessor converts it into the chain of bytes, shown here with their
hexadecimal values (characters corresponding to some of those values are
placed below the hexadecimal codes):
1A 03 6D 6F 76 1A 02 61 78 2C 1A 01 34 00
m o v a x , 4
The third type of token that can be found in preprocessed line is the
quoted text. This element is created from chain of any bytes other than
line breaks that are placed between the single or double quotes in the
original text. First byte of such element is always 22h, it is followed
by double word which specifies the number of bytes that follow, and the
value of quoted text comes next. For example, this line from source:
mov eax,'ABCD'
is converted into (the notation used is the same as in previous sample):
1A 03 6D 6F 76 1A 03 65 61 78 2C 22 04 00 00 00 41 42 43 44 00
m o v e a x , A B C D
This data defines two symbols followed by symbol character, quoted text
and zero byte that marks end of line.
There is also a special case of symbol token with first byte having the
value 3Bh instead of 1Ah, such symbol means that all the line elements
that follow, including this one, have already been interpreted by
preprocessor and are ignored by assembler.
Table 4 Row of the assembly dump
/-------------------------------------------------------------------------\
| Offset | Size | Description |
|========|=======|========================================================|
| +0 | dword | Offset in output file. |
|--------|-------|--------------------------------------------------------|
| +4 | dword | Offset of line in preprocessed source. |
|--------|-------|--------------------------------------------------------|
| +8 | qword | Value of $ address. |
|--------|-------|--------------------------------------------------------|
| +16 | dword | Extended SIB for the $ address, the first two bytes |
| | | are register codes and the second two bytes are |
| | | corresponding scales. |
|--------|-------|--------------------------------------------------------|
| +20 | dword | If the $ address is relocatable, this field contains |
| | | information about section or external symbol, to which |
| | | it is relative - otherwise this field is zero. |
| | | When the highest bit is cleared, the address is |
| | | relative to a section, and the bits 0-30 contain |
| | | the index (starting from 1) in the table of sections. |
| | | When the highest bit is set, the address is relative |
| | | to an external symbol, and the bits 0-30 contain the |
| | | the offset of the name of this symbol in the strings |
| | | table. |
|--------|-------|--------------------------------------------------------|
| +24 | byte | Type of $ address value (as in table 2.2). |
|--------|-------|--------------------------------------------------------|
| +25 | byte | Type of code - possible values are 16, 32, and 64. |
|--------|-------|--------------------------------------------------------|
| +26 | byte | If the bit 0 is set, then at this point the assembly |
| | | was taking place inside the virtual block, and the |
| | | offset in output file has no meaning here. |
| | | If the bit 1 is set, the line was assembled at the |
| | | point, which was not included in the output file for |
| | | some other reasons (like inside the reserved data at |
| | | the end of section). |
|--------|-------|--------------------------------------------------------|
| +27 | byte | The higher bits of value of $ address. |
\-------------------------------------------------------------------------/
Notes:
Each row of the assembly dump informs, that the given line of preprocessed
source was assembled at the specified address (defined by its type, value
and the extended SIB) and at the specified position in output file.

6
WHATSNEW.TXT
View file

@ -2,6 +2,12 @@
Visit http://flatassembler.net/ for more information.
version 1.73.03 (Apr 15, 2018)
[+] Added "rdpid", "xsavec", "xsaves", "xrstors", "clzero", "monitorx" and "mwaitx"
instructions.
version 1.73.02 (Dec 16, 2017)
[-] Fixed a bug in the storage of "virtual as" blocks.