yasm - Интернет в облаке

ПРОГРАММА:

ИМЯ

yasm - Модульный ассемблер Yasm

СИНТАКСИС

ясм [-f формат] [-o Outfile] [другими кредита...] {вводить}

ясм -h

ОПИСАНИЕ

Модульный ассемблер Yasm - это портативный ассемблер с возможностью перенастройки, написанный под «новым»
(2 или 3 пункта) Лицензия BSD. Yasm в настоящее время поддерживает наборы инструкций x86 и AMD64,
принимает синтаксис ассемблера NASM и GAS, выводит двоичные файлы, ELF32, ELF64, COFF, Win32 и
Форматирует объекты Win64 и генерирует исходную отладочную информацию в STABS, DWARF 2 и
Форматы CodeView 8.

YASM состоит из ясм команда, libyasm, основная серверная библиотека и большое количество
модулей. В настоящее время libyasm и загружаемые модули статически встроены в ясм
исполняемый файл.

" ясм команда собирает файл infile и направляет вывод в файл Outfile if
указано. Если Outfile не указано, ясм получит имя выходного файла по умолчанию из
имя входного файла, обычно добавляя .o или .obj, или удаляя все расширения
для необработанного двоичного файла. В противном случае имя выходного файла будет yasm.out.

При вызове с вводить из "-", ясм собирает стандартный ввод и направляет вывод на
файла Outfile, или yasm.out, если нет Outfile указан.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

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

Общие Возможности
-a арка or --arch =арка: Выбрать целевую архитектуру
Выбирает целевую архитектуру. Архитектура по умолчанию - «x86», которая поддерживает
И IA-32, и производные, и наборы инструкций AMD64. Чтобы распечатать список
доступных архитектур для стандартного вывода, используйте «справку» как арка. Посмотреть yasm_arch(7) для
список поддерживаемых архитектур.

-f формат or --oformat =формат: Выбрать формат объекта
Выбирает формат выходного объекта. Формат объекта по умолчанию - «корзина», который представляет собой плоский
форматировать двоичный файл без перемещения. Чтобы распечатать список доступных форматов объектов на
стандартный вывод, используйте "help" как формат. Посмотреть yasm_objfmts(7) для списка поддерживаемых
форматы объектов.

-g отлаживать or --dformat =отлаживать: Выбрать формат отладки
Выбирает формат отладки для отладочной информации. Может использоваться отладочная информация
отладчиком, чтобы связать исполняемый код с исходным файлом или получить данные
информация о структуре и типе. Доступные форматы отладки различаются для разных объектов
форматы; ясм выдаст ошибку при выборе недопустимой комбинации. Объект по умолчанию
формат выбирается форматом объекта. Чтобы распечатать список доступных отладок
форматы для стандартного вывода, используйте «справку» как отлаживать. Посмотреть yasm_dbgfmts(7) для списка
поддерживаемые форматы отладки.

-L список or --lformat =список: Выбрать формат файла списка
Выбирает формат / стиль файла списка вывода. Файлы списков обычно смешивают
исходный код с машинным кодом, сгенерированный ассемблером. Список по умолчанию
формат - «nasm», который имитирует формат файла списка NASM. Чтобы распечатать список доступных
перечислить форматы файлов для стандартного вывода, используйте «справку» как список.

-l список or --list =список: Укажите имя списка
Задает имя файла выходного списка. Если этот параметр не используется, файл списка отсутствует.
генерируется.

-m машина or --machine =машина: Выбрать архитектуру целевой машины
Выбирает архитектуру целевой машины. По сути, подтип выбранных
архитектура, тип машины выбирает между основными подмножествами архитектуры. Для
Например, для архитектуры «x86» двумя доступными машинами являются «x86», т.е.
используется для IA-32 и производного 32-разрядного набора инструкций, а также для amd64, который используется
для 64-битного набора команд. Это дифференцирование требуется для генерации
правильный объектный файл для форматов перемещаемых объектов, таких как COFF и ELF. Чтобы распечатать
список доступных машин для данной архитектуры для стандартного вывода, используйте «помощь» как
машина и данная архитектура с использованием -a арка. Посмотреть yasm_arch(7) для получения более подробной информации.

-o имя файла or --objfile =имя файла: Укажите имя файла объекта
Задает имя выходного файла, заменяя любое имя по умолчанию, созданное Yasm.

-p синтаксический анализатор or --parser =синтаксический анализатор: Выбрать парсер
Выбирает синтаксический анализатор (синтаксис ассемблера). Парсер по умолчанию - «nasm», который
имитирует синтаксис NASM, Netwide Assembler. Другой доступный парсер - «газ»,
который имитирует синтаксис GNU AS. Чтобы распечатать список доступных парсеров в стандартный
вывод, используйте «помощь» как синтаксический анализатор. Посмотреть yasm_parsers(7) список поддерживаемых парсеров.

-r препроцесс or --preproc =препроцесс: Выбрать препроцессор
Выбирает препроцессор для использования с входным файлом перед его передачей синтаксическому анализатору.
Препроцессоры часто предоставляют макросы, которые не включены в основную
парсер. Препроцессор по умолчанию - «nasm», который представляет собой импортированную версию фактического
Препроцессор NASM. Также доступен «сырой» препроцессор, который просто пропускает
шаг предварительной обработки, передавая входной файл непосредственно синтаксическому анализатору. Чтобы распечатать список
доступных препроцессоров для стандартного вывода, используйте "help" как препроцесс.

-h or --Помогите: Распечатать сводку опций
Печатает сводку параметров вызова. Все остальные параметры игнорируются и не выводятся
файл создается.

--версия: Получить версию Yasm
Эта опция заставляет Yasm печатать номер версии Yasm, а также лицензию.
сводка к стандартному выводу. Все остальные параметры игнорируются, и выходной файл не сохраняется.
генерируется.

Предупреждение Возможности
-W варианты имеют две противоположные формы: -Wимя и -Нет-имя. Только нестандартные формы
показано здесь.

Параметры предупреждения обрабатываются в порядке, указанном в командной строке, поэтому, если -w is
последующей -Worphan-метки, все предупреждения отключены кроме для лейблов-сирот.

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

-Ошибка: Рассматривать предупреждения как ошибки
Эта опция заставляет Yasm рассматривать все предупреждения как ошибки. Обычно предупреждения не
предотвращать создание объектного файла и не приводить к состоянию выхода из строя
от ясм, тогда как ошибки есть. Эта опция делает предупреждения эквивалентными ошибкам в терминах
этого поведения.

-Wno-непризнанный-символ: Не предупреждать о нераспознанных вводимых символах
Заставляет Yasm не предупреждать о нераспознанных символах, обнаруженных во входных данных. Обычно Ясм
выдаст предупреждение для любого символа, отличного от ASCII, найденного во входном файле.

-Worphan-метки: Предупреждать о ярлыках, на которых отсутствует конечная опция
При использовании NASM-совместимого парсера заставляет Yasm предупреждать о метках, обнаруженных только на
строка без двоеточия в конце. Хотя это допустимые метки в синтаксисе NASM, они могут
быть непреднамеренным из-за опечаток или упорядочения макроопределений.

-X стиль: Изменить стиль сообщения об ошибках / предупреждениях
Выбирает определенный стиль вывода для сообщений об ошибках и предупреждениях. По умолчанию - «gnu».
стиль, который имитирует вывод GCC. Также доступен стиль «vc», который имитирует
вывод компилятора Microsoft Visual C ++.

Эта опция доступна для более естественной интеграции Yasm в среды IDE.
таких как Visual Studio или Emacs, позволяя IDE правильно распознавать
сообщение об ошибке / предупреждении как таковое и ссылка на некорректную строку исходного кода.

препроцессор Возможности
Хотя эти параметры препроцессора теоретически будут влиять на любой препроцессор, единственный
препроцессор в настоящее время в Yasm является препроцессором «nasm».

-D макрос [= значение]: Предварительное определение макроса
Предварительно определяет однострочный макрос. Значение не является обязательным (если значение не указано,
макрос все еще определен, но с пустым значением).

-e or --preproc-только: Только препроцессор
Останавливает сборку после этапа предварительной обработки; предварительно обработанный вывод отправляется на
указанное имя вывода или, если имя вывода не указано, стандартный вывод. Нет
объектный файл создается.

-I путь: Добавить путь к включаемому файлу
Добавляет каталог путь в путь поиска включаемых файлов. Путь поиска по умолчанию
включая только каталог, в котором находится исходный файл.

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

-U макрос: Отменить определение макроса
Отменяет определение однострочного макроса (может быть либо встроенным, либо определенным ранее
в командной строке с -D.

ПРИМЕРЫ

Чтобы собрать синтаксис NASM, 32-разрядный исходный код x86 source.asm в ELF-файл source.o, предупреждение на
сиротские ярлыки:

yasm -f elf32 -Worphan-метки source.asm

Чтобы собрать синтаксис NASM AMD64 source x.asm в файл Win64 object.obj:

yasm -f win64 -o объект.obj x.asm

Чтобы собрать уже предварительно обработанный синтаксис NASM x86 с исходным кодом y.asm в плоский двоичный файл y.com:

yasm -f bin -r raw -o y.com y.asm

ДИАГНОСТИКИ

" ясм Команда завершает работу с 0 в случае успеха и с отличным от нуля в случае возникновения ошибки.

СОВМЕСТИМОСТЬ

Синтаксический анализатор и препроцессор NASM от Yasm, хотя они стремятся быть максимально совместимыми
с NASM, имеют несколько несовместимостей из-за другой внутренней структуры YASM.

В синтаксическом анализаторе и препроцессоре GAS от Yasm отсутствует ряд функций, присутствующих в GNU AS.

ОГРАНИЧЕНИЯ

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

Карты символов не поддерживаются.

Используйте yasm онлайн с помощью сервисов onworks.net