Tomasz Grysztar - Flat Assembler 1.64. Мануал программера

« entry» устанавливает точку входа для формата MZ, за ней должен следовать дальний адрес (имя сегмента, двоеточие и смещение в сегменте) желаемой точки входа.

« stack» устанавливает стек для MZ. За директивой может следовать числовое выражение, указывающее размер стека для автоматического создания, либо дальний адрес начального стекового фрейма, если вы хотите установить стек вручную. Если стек не определен, он будет создан с размером по умолчанию в 4096 байт.

« heap» со следующим за ней значением определяет максимальный размер дополнительного места в параграфах (это место в добавление к стеку и для неопределенных данных). Используйте « heap 0», Чтобы всегда отводить только память, которая программе действительно нужна.

Чтобы выбрать формат вывода PE, используйте директиву « format PE», за ней могут следовать дополнительные настройки формата: используйте « console», « GUI» или оператор « native», чтобы выбрать целевую субсистему (далее может следовать значение с плавающей точкой, указывающее версию субсистемы), « DLL» помечает файл вывода как динамическую связывающую библиотеку. Далее может следовать оператор « at» и числовое выражение, указывающее базу образа PE и далее опционально оператор « on» со следующей за ним строкой в кавычках, содержащей имя файла, выбирающей заглушку MZ для PE программы (если указанный файл не в формате MZ, то он трактуется как простой двоичный исполняемый файл и конвертируется в формат MZ). По умолчанию код для этого формата 32-битный. Пример объявления формата PE со всеми свойствами:

format PE GUI 4.0 DLL at 7000000h on 'stub.exe'

« section» определяет новую секцию, за ней должна следовать строка в кавычках, определяющая имя секции, и далее могут следовать один или больше флагов секций. Возможные флаги такие: « code», « data», « readable», « writeable», « executable», « shareable», « discardable», « notpageable». Начало секции выравнивается по странице (4096 байт). Пример объявления секции PE:

section '.text' code readable executable

Вместе с флагами также может быть определен один из специальных идентификаторов данных PE, отмечающий всю секцию как специальные данные, возможные идентификаторы: « export», « import», « resource» и « fixups». Если секция помечена для содержания настроек адресов, они генерируются автоматически, и никаких данных определять больше не требуется. Также данные ресурсов могут быть сгенерированы автоматически из файлов ресурсов, этого можно добиться, написав после идентификатора « resourse» оператор « from» и имя файла в кавычках. Ниже вы можете увидеть примеры секций, содержащих некоторые специальные данные:

section '.reloc' data discardable fixups

section '.rsrc' data readable resource from 'my.res'

« entry» создает точку входа для PE, далее должно следовать значение точки входа.

« stack» устанавливает размер стека для PE, далее должно следовать значение зарезервированного размера стека, опционально может следовать отделенное запятой значение начала стека. Если стек не определен, ему присваивается размер по умолчанию, равный 4096 байт.

« heap» выбирает размер дополнительного места для PE, далее должно следовать значение для зарезервированного для него места, опционально ещё может быть значение его начала, отделенное запятой. Если дополнительное место не определено, оно ставится по умолчанию равным 65536 байт, если не указано его начало, то оно устанавливается равным 0.

« data» начинает определение специальных данных PE, за директивой должен следовать один из идентификаторов данных (« export», « import», « resource» или « fixups») или номер записи данных в заголовке PE. Данные должны быть определены на следующих строках и заканчиваться директивой « end data». Если выбрано определение настроек адресов, они генерируются автоматически, и никаких данных определять больше не требуется. То же самое относится к ресурсам, если за идентификатором « resourse» следует оператор « from» и имя файла в кавычках — в этом случае данные берутся из этого файла ресурсов.

Чтобы выбрать COFF (Common Object File Format), используйте директиву « format COFF» или « format MS COFF», если вы хотите создать классический мелкософтофский файл COFF. По умолчанию код для этого формата 32-битный. Чтобы создать микросфтовский формат COFF для архитектуры x86-64, используйте установку « format MS64 COFF», в этом случае автоматически будет генерироваться код длинного режима.