as

Section: GNU Development Tools (1)
Updated: 29 March 1996
Index Return to Main Contents

ИМЯ

GNU as - переносимый GNU ассемблер.

ОБЗОР

as [-a[dhlns]\|] [-D] [--defsym SYM=VAL] [-f] [--gstabs] [-I путь] [-K] [-L] [-M | --mri] [-o обьектный_файл] [-R] [--traditional-format] [-v] [-w] [-- | файлы...]

опции только для i960:
[-ACA|-ACA_A|-ACB|-ACC|-AKA|-AKB|-AKC|-AMC] [-b] [-no-relax]

опции только для m680x0:
[-l] [-mc68000|-mc68010|-mc68020]

ОПИСАНИЕ

GNU as - это фактически семейство ассемблеров. Если вы используете (или хотите использовать) GNU ассемблер на машине одной архитектуры, то вы должны найти в точности похожее окружение, чтобы использовать его для машин другой архитектуры. Каждая версия имеет много общего с другими, включая форматы обьектных файлов, многие директивы (часто называемые псевдо-опциями) и синтаксис ассемблера.

Для информации по синтаксису и псевдо-опциям, которые использует GNU as, смотрите секцию `as' в info (или руководство Using as: The GNU Assembler ).

as поначалу предполагалось использовать as для ассемблирования вывода компилятора GNU C gcc чтобы использовать компановщик ld. Тем не менее, мы пытались сделатьas корректно работающим и с чистым ассемблером. Это не значит, что as всегда использует такой же синтаксис как и другой ассемблер, работающий для той же архитектуры; например, мы знаем несколько несовместимых версий ассемблерного синтаксиса для 680x0.

Когда вы запускаете as он ассемблирует точно одну исходную программу. Исходная программа состоит из одного или нескольких файлов.(Стандартный ввод - это тоже файл.)

Если as не было дано имен файлов, то он пытается читать один входной файл из стандартного ввода as которым обычно является ваш терминал. Вы можете ввести ctl-D чтобы сказать as что больше нет программ для ассемблирования. Используйте` -- ' в вашей командной строке, если вам действительно нужен стандартный ввод.

as может выводить предупреждающие сообщения и сообщения об ошибках в стандартный файл ошибок (обычно это ваш терминал). Этого не должно происходить, когда as автоматический запускается компилятором. Предупреждения выводятся так, чтобы as не прекращал ассемблирование нужной программы; ошибки говорят о серьезных проблемах и приводят к остановке ассемблирования.

ОПЦИИ

-a: Включает ассемблерные листинги. Эта опция имеет различные подопции. d опускать директивы отладки. h включать внутрь выскокоуровневый исходный код; доступна только если может быть найден файл с исходным текстом и если он был скомпилирован с опцией -g. l включать внутрь ассемблерный листинг. n опускать обработку форм. s включать внутрь листинг символов. = файл устанавливает имя файла листинга; данная подопция должна быть последней. в списке подопций. Подопции включенные по умолчанию это hls.
-D: Эта опция допускается только для сценариев совместимых с вызовами для других ассемблеров; она ничего не делает.
--defsym SYM=VALUE: Присваивает символу SYM величину VALUE перед ассемблированием входного файла. VALUE должна быть целой константой. Как и в C, приставка 0x говорит о шестнадцатеричном числе, а приставка 0 об восьмеричном.
-f: ``fast'' пропускать обработку препроцессором (присваевает исходный текст выходу компилятора).
-I путь: Добавить путь в список поиска директив .include.
--gstabs: Генерировать отладочную информацию stabs для каждой ассебмлерной строки. Это может помочь в отладке ассемблерного кода, если отладчик умеет использовать эту информацию.
-K: Показывать предупреждения, когда различные таблицы изменяются для длинного смещения.
-L: Оставить (в таблице символов) локальные символы, начинающиеся с ` L '
-M, --mri: Ассемблирование в формате совместимом с MRI.
-o обьектный_файл: Имя обьектного_файла который делает as
-R: Поместить секцию данных в секцию текста
--traditional-format: Когда возможно, использовать такой же формат как и родной ассемблер (по видимому родной для данной архитектуры прим.пер.)
-v: Выдать версию as
-W, --warn: Подавлять предупреждающие сообщения.
--fatal-warnings: Считать предупреждающие сообщения фатальными.
--warn: Просто выдавать предупреждающие сообщения.
-- | файлы...: Исходные файлы для ассемблирования или стандартный ввод ( --)
-Avar: (Когда настроено для Intel 960.) Задает нужный вариант архитектуры Intel 960.
-b: (Когда настроено для Intel 960.) Добавляет код для сбора статистики о заданных ветвлениях.
-no-relax: (Когда настроено для Intel 960.) Не изменять инструкции compare-and-branch (проверки и ветвления) для длинного смещения; выдавать ошибку, если необходимо.
-l: (Когда настроено для Motorola 68000).
Укорачивает ссылки на неопределеные символы до одного слова, вместо двух.
-mc68000|-mc68010|-mc68020: (Когда настроено для Motorola 68000).
Определяет процессор из семейства 68000 (по умолчанию 68020)

Опции могут быть в любом порядке и могут находится перед, после или между именами файлов. Порядок имен файлов строго определен.

` -- ' (два тире) это имя стандартного ввода, точно также как и для простого имени входного файла для as

Исключая ` -- ' любые аргументы командной строки, что начинаются с тире (` - ') являются опциями. Каждая опция изменяет поведение as . Если не задано опций, то работают опции по умолчанию. После символа ` - ' позволяется одна или несколько букв; при этом важен регистр букв.
Все опции необязательны.

Опция ` -o ' ожидает одного имени файла. Имя файла может или непосредственно следовать за буквой опции (для совместимости с другими ассемблерами) или может быть следующим аргументом в командной строке (стандарт GNU).

Эти две команды эквивалентны:
as -o my-object-file.o mumble.s
as -omy-object-file.o mumble.s

СМОТРИТЕ ТАКЖЕ

`as' раздел в info ; Using as: The GNU Assembler ; gcc(1), ld(1).

АВТОРСКИЕ ПРАВА

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

Предоставляется право на копирование и распространение изменных версий данного руководства с условием, что неизменными остануться замечаения об авторских правах и правах, предоставляемых для данного документа.

Предоставляются права на копирование и распространение переводов данного документа на другие языки на условиях касающихся изменных версий, за исключением того, что вышеозначенные замечания могут быть включены на английском языке.