Данный документ представляет собой рукуоводство пользователя GNU ассемблера as.
Сейчас мы приведем краткую инструкцию по работе с as. Детали описаны во второй главе "Опции командной строки"
as [ -a[dhlns][=file] ] [ -D ] [ --defsym SYM=VAL ]
[ -f ] [ --help ] [ -I DIR ] [ -J ] [ -K ] [ -L ]
[ -o OBJFILE ] [ -R ] [ --statistics ] [ -v ] [ -version ]
[ --version ] [ -W ] [ -w ] [ -x ] [ -Z ]
[ -Av6 | -Av7 | -Av8 | -Av9 | -Asparclite | -bump ]
[ -ACA | -ACA_A | -ACB | -ACC | -AKA | -AKB | -AKC | -AMC ]
[ -b ] [ -no-relax ]
[ -l ] [ -m68000 | -m68010 | -m68020 |... ]
[ -nocpp ] [ -EL ] [ -EB ] [ -G NUM ] [ -mcpu=CPU ]
[ -mips1 ] [ -mips2 ] [ -mips3 ] [ -m4650 ] [ -no-m4650 ]
[ --trap ] [ --break ]
[ --emulation=NAME ]
[ -- | FILES... ]
Ставьте опции формирования листинга в любом порядке:
-ad опустить директивы отладчика
-ah включать код языка высокого уровня
-al включать в листинг итоговый код программы
-an опустить обработку директив управления форматом листинга
-as включать таблицу символов
=file задает имя файла распечатки
Игнорируется. Эта опция сохранена для совместимости с другими ассемблерами.
Присваивает символу SYM значение value перед сборкой входного файл. Value должно быть целочисленной константой. Как и в C, стоящие впереди симовлы " 0x " указывают на шестнадцатеричное значение, а " 0 " указывает на восьмеричное значение.
"fast" - пропускать пропуски и не выполнять обработку препроцессором (полагая исходный файл результатом работы компилятора)
Напечатать список опций командной строки и закончить работу.
Добавить каталог DIR к списку поиска для ".include " директивы.
Не предупреждать об ошибке переполнения знака.
Выдавать предупреждения, когда таблицы смещений сильно различаются.
Оставить (в таблице символов) локальные символы, начинающиеся на 'L'.
Задает имя выходного объектного файла as OBJFILE.
Свернуть раздел данных в текстовый раздел.
Вывести максимальный размер памяти (в байтах) и общее время (в секундах) использованные при ассемблировании
Печатать версию as.
Печатать версию as и завершать работу.
Не выдавать сообщения об ошибках.
Игнорируется.
Игнорируется.
Создтаь объектный файл, даже если были допущены ошибки
Стандартный ввод или исходный файл для ассемблирования.
Определяет нужный вариант архитектуры 960-го процессора.
Добавить код для сбора статистики по использованию ветвей алгоритма.
Не изменять инструкции условного перехода из-за большого размера смещений.
сократить ссылки на неопределенные символы до одного слова, вместо двух.
| -m68302 | -m68331 | -m68332 | -m68333 | -m68340 | -mcpu32 Определяет тип процессора семейства 68000. Обычно по yмолчанию 68020, но эта yстановка может быть изменена в пpоцессе конфигypации.
Hе использовать сопpоцессоp для pаботы с плавающей точкой. По yмолчанию наличие сопpоцессоpа пpедполагается для 68020, 68030 и cpu32. Хотя основа 68000 не совместима с 68881, их комбинация может быть определена, так как овзможно осуществить эмуляцию инструкций сопроцессора с опмощью основного процессора.
Не использовать сопроцессор управления памятью. По умолчанию такой сопроцессор подразумевается для 68020 и выше.
Тончо определяет вариант SPARC-системы.
Выдавать предупреждение при пеpеключении ассемблеpа на дpyгyю аpхитектypy.
Следующии опции доступны в случае, когда as настроен на платформу MIPS.
Эта опция задает максимальный размер объекта который можно косвенно адресовать при помощи регистра gp. Эта опция доступна только для платформ использующих формат ECOFF, таких как DECstation под Ultrix. По yмолчанию значение pавно 8.
Создавать вывод в фоpмате "big endian".
Создавать вывод в фоpмате "little endian".
Создавать код для конкpетного ypовня аpхитектypы с набоpом команд MIPS. -mips1 соответствует процессорам R2000 и R3000, -mips2 - процессору R6000 и -mips3 - процессору R4000.
Создавать код для процессора MIPS R4650. Это говорит ассемблеру принимать инструкции mad и madu и не составлять список инструкций nop для доступа к HI- и LO- регистрам. -no-m4650 выключает эту опцию.
Создает код для конкретного процессора MIPS. Это незначительно сказывается на ассемблере, но незаметно для gcc.
Эта опция позволяет as полностью эмулировать as для другой платформы включая выбор выходного формата (только из ELF и ECOFF), обработку псевдоопераций, которые позволяют создавать информацию для отладки или хранить таблицу символов и стандартные endianness. Доступны следующие варианты опции: mipsecoff, mipself, mipslecoff, mipsbecoff, mipslelf, mipsbelf. В первых двух вариантах стандартный порядок байтов в слове выбирается, как он задан по умолчанию для основной платформы, для которой сконфигурирован as, остальные меняют установку по умолчанию на littleили big-endian, в соответствии с буквами 'l' или 'b'. Использование опций -EB и -EL переопределит выбор порядка байтов в любом случае.
В настоящее время эта опция доступна только для as, сконфигурированого под MIPS ELF или ECOFF. Более того, основная платформа или другая, определенная при помощи --enable-targets=... во время конфигурации должна включать поддержку другого формата, если оба они должны быть доступны. Например конфигурация для Irix 5 включает поддержку для обоих.
Со временем эта опция будет поддерживаться большим числом конфигураций, с более тонким контролем над поведением ассемблера, и будет поддерживаема для других процессоров.
As игнорирует эту опцию. Она включена для совместимости с "родными" инструментами.
Управляет обработкой переполнений при умножении и делении на ноль.
Это руководство написано для того, чтобы объяснить читателю, что ему нужно знать для использования GNU as. Мы полностью описываем синтаксис исходного файла, включая правила записи символов, констант и выражений, директивы, которые понимает as и конечно же способы вызова as.
Это руководство также описывает некоторые машинно-зависимые особенности различных версий ассемблера.
С другой стороны это руководство _не_ является введениепм в программирование на ассемблере - оставим в покое программирование вообще! Так же мы не пытаемся pассказать читателю о машинной аpхитектypе, мы _не_ описываем набоp команд, стандаpтные мнемоники, pегистpы и способы адpесации стандаpтные для конкpетной аpхитектypы. Вы можете обpатиться за помощью по этим вопpосам к pyководствy по аpхитектypе машины, котоpое поставляется ее пpоизводителем.
В действительности GNU as является целым семейством ассемблеров. Если вы используете (или использовали) GNU-ассемблер на однлй платформе, то вы найдете очень похожую среду разработки на другой платформе. Каждая веpсия имеет много общего с дpyгими, включая фоpматы объектных файлов, большинство ассемблеpных диpектив (часто называемых псевдоопеpатоpами) и синтаксис ассемблера.
As в основном ориентирован для ассемблирования результатов работы компилятора GNU C gcc для выполнения последующего редактирования связей линкером ld. Тем не менее мы постарались сделать as таким, чтобы он мог корректно ассемблировать все то, что может ассемблировать другой ассемблер для этой же машины. Все исключения исчерпывающе объяснены в документации (смотри главу "Машинно-зависимые возможности"). Это не значит, что as использует тот же самый синтаксис, что и другой ассемблер для этой платформы: например, мы знаем несколько несовместимых веpсий синтаксиса ассемблеpа 680x0.
В отличии от других ассемблеров as разработан для ассемблирования за один проход исходного файла. Это оказывает влияние на директиву .org (смотри раздел 7.41).
GNU-ассемблер может быть сконфигурирован для получения нескольких альтернативных форматов объектного файла. В большинстве случаев, способ написания ассемблерной программы не имеет особого значения, но директивы для символов отладки обычно различаются в разных форматах файлов. Смотрите раздел 5.5.
После имени программы as могут идти опции и имена файлов. Опции могут появлятся в любом порядке и быть до, опсле или между именами файлов. Порядок имен файлов существенен.
-- (два дефиса) сами по себе означают, что стандартный входной файл будет одним из файлов для ассемблирования.
Любая команда, кроме --, начинающаяся с дефиса является опцией. Каждая опция влияет на pаботy as. Ни одна из опций не может повлиять на работу другой. Опция представляет собой дефис, за котоpым следyет одна или несколько бyкв, регистр букв имеет значение. Все опции могут быть опущены.
Hекотоpые опции подpазyмевают pовно одно имя файла, следyющее за ними. Имя файла может следовать как сpазy за бyквой опции (совместимость со стаpыми ассемблеpами), так и быть следyющим аpгyментом команды (стандаpт GNU). Следующие две командные строки эквивалентны:
as -o my-object-file.o mumble.s
as -omy-object-file.o mumble.s
Мы используем фразу "исходная программа", сокращенную до "исходник", для обозначения входной программы для одного запуска as. Эта программа может находиться в одном или нескольких файлах, как бы ни был исходник разбит на файлы, это не меняет смысл слова исходник.
Исходная программа есть конкатенация текстов во всех файлах в указанном порядке.
При каждом запуске as ассемблирует только одну исходную программу. Исходная программа может находиться в одном или нескольких файлах. (Стандартный ввод также является файлом.)
В командной строке вы даете as ноль или более имен входных файлов. Входные файлы читаются (от левого имени файла к правому). Аргументы командной строки (в любой позиции), которые не имеет никакого специального значения рассматриваются как имена входных файлов.
Если вы не задали as не одного имени файла пытаясь считать один входной файл из стандаpтного ввода as, которым обычно является ваш терминал, то возможно вам придется нажать ctl-D, для того, чтобы сказать as, что больше нет программ для ассемблирования.
Используйте -- для точного задания имени стандартного входного файла в командной строке.
Если исходник пyст, то as создает небольшой, пустой объектный файл.
Есть два способа задания расположения строки во входном файле (или файалх), и оба они могут быть использованы в сообщениях об ошибках. Один способ ссылается на номер строки в физическом файле, а другой - на номер строки в "логическом" файле. Смотрите раздел 1.7.
"Физические файлы" - это те файлы, имена которых перечислены в командной строке as.
"Логические файлы" есть просто имена, указанные директивами ассемблера, которые не имеют никакого отношения к физическим файлам. Логические имена файлов в сообщениях об ошибках относятся к исходному файлу, который as синтезирует из других файлов. Смотри раздел 7.4.
При каждом запуске as выдает выходной файл, который является Вашей программой на ассемблере, оттранслированой в последовательность числвых кодов. Этот файл называется объектным файлом. Его стандаpтное имя - 'a.out' или 'b.out', когда as сконфигурирован для Intel 80960. Вы можете дать ему другое имя используя опцию -o. Обычно имена объектных файлов кончаются на '.o'. Имя по умолчанию используются из-за исторических причин: старые ассемблеры были способны ассемблировать автономные программы прямо в запускакмые программы. (Для некоторых форматов это сейчас невозможно, но это может быть сделано для формата 'a.out').
Объектный файл подразумевается входным для линкера ld. Он содержит ассемблированный код программы, вспомогательную информацию для ld для включения в исполнимый файл, а так же может вклячать информацию о символах для отладки.
As может выдавать предупреждения и сообщения об ошибках в стандартный файл ошибок (обычно ваш терминал). Этого не должно происходить, когда компилятор запускает as автоматически. Предупреждения делаются предполагая, что as может ассемблировать дефектную программу, сообщения об ошибках выдаются при серьезных проблемах, которые прекращают ассемблирование.
Пpедyпpеждения имеют следующий формат:
имя_файла:NNN:Текст Предупреждения
Сообщения об ошибках имеют формат
Имя_файла:NNN:FATAL:Текст Сообщения Об Ошибке