2. Параметры, задаваемые в командной строке.

Простейший способ использования GASP'а заключается в его запуске как фильтра, и последующем ассемблировании результатов его работы. В UNIX это можно сделать, например, так:

$ gasp prog.asm | as -o prog.o

gasp [ -a | --alternate ] [ -c CHAR | --commentchar CHAR ] [ -d | --debug ] [ -h | --help ] [ -M | --mri ] [ -o OUTFILE | --output OUTFILE ] [ -p | --print ] [ -s | --copysource ] [ -u | --unreasonable ] [ -v | --version ] INFILE ...

'INFILE ...'

Имена файлов ввода. Вы обязаны задать хотя бы одно имя; если задано больше 1, GASP обрабатывает все, соединяя результаты в порядке задания имен после INFILE.

Помечайте конец каждого файла ввода командой препроцессора '.END'.

`-a'

`--alternate'

Использование альтернативного ситаксиса макросов. (См.: "Альтернативный синтаксис макроопределений" об отличиях альтернативного синтаксиса от стандартного).

`-c 'CHAR''

`--commentchar 'CHAR''

Использовать CHAR в качестве символа комментария. Символом комментария по умолчанию является '!'. Например, чтобы использовать точку с запятой как символ комментария, можно указать " -c ';' " в командной строке. Поскольку символы ассемблерных команд часто имеют специальное значение в командных оболочках, желательно заключать в кавычки или помечать "\" (?) символ, когда вы указываете символ комментария.

Для простоты все примеры в данном руководстве используют символ комментария по умолчанию '!'.

`-d'

`--debug'

Отображает отладочную информацию. В этой версии GASP'а эта опция выдает информацию о строковых буферах, распределяемых GASP'ом внутренним образом. Для каждой имеющейся длины строки S GASP сообщает количество размещенных строк N этой длины при помощи строки вида

strings size S : N

GASP выводит эту статистику в стандартный поток ошибок по окончании обработки.

`-h'

`--help'

Выводит на экран краткую справку о параметрах командной строки GASP'а.

`-M'

`--mri'

Включение режима совместимости с ассемблером MRI (Microtec Research Inc.). При использовании этой опции GASP 'понимает' синтаксис и псевдооператоры ассемблера Microtec Research `ASM68K'.

`-o OUTFILE'

`--output OUTFILE'

Записывает результат работы в файл OUTFILE. Если эта опция не указана, то вывод происходит в стандартный поток вывода.

`-p'

`--print'

Вывод номеров строк исходного текста. Эта опция работает только в случае, если указано также '-s' для вывода исходного текста. В этом случае для каждой его строки GASP отображает ее номер (сразу после символа комментария в начале строки).

`-s'

`--copysource'

Копирование строк исходного текста на вывод. Эту опцию можно использовать для просмотра результата обработки отдельных строк. GASP помещает символ комментария в начале каждой строки исходного текста, так что результат можно после этого все равно ассемблировать.

`-u'

`--unreasonable'

Неограниченное возможное количество вложенных макросов. Поскольку вы можете определять макросы GASP'а внутри других макроопределений, препроцессор обычно включает "проверку на осмысленность". Если вашей программе требуется более 1000 вложенных расширений, GASP прервет обработку и выдаст сообщение об ошибке. Указание этой опции позволяет отключить эту проверку и использовать неограниченное количество вложенных макрорасширений.

`-v'

`--version'

Выводит номер версии GASP'а.