.TH MCPU-AS 1 "Октябрь 2026" "LibMCPU" "Команды пользователя"

.SH ИМЯ
mcpu-as \- ассемблер исходного текста MCPU в перемещаемый объект MELF
.SH СИНТАКСИС
.B mcpu-as
.RI [ опции ] " -o output.o input.s"
.SH ОПИСАНИЕ
.B mcpu-as
читает один исходный файл ассемблера MCPU в UTF-8 и создаёт один перемещаемый
объект MELF
.BR ET_REL .
Отдельного режима compile-only нет: ET_REL является нормальным и единственным
объектным выходом ассемблера. Исходный файл и
.B -o
могут находиться в любом порядке.
.PP
Assembler записывает symbols, sections и relocations, явно заданные исходным
текстом; он не выбирает PROGRAM или MODEL и не синтезирует HLL CRT objects.
Final lifecycle ownership, automatic HLL CRT selection, STACK и HEAP program
headers определяются позднее командой
.BR mcpu-ld (1).
.SH ОПЦИИ
.TP
.BI -o " файл"
Записать объект в указанный файл. Опция обязательна.
.TP
.BR -v ", " --verbose
После успешной сборки вывести краткую сводку о созданном MELF ET_REL object.
По умолчанию успешный запуск ничего не выводит.
.TP
.BR -h ", " --help
Вывести справку и завершиться.
.TP
.B --version
Вывести имя программы, идентификатор инструментария MCPU и версию, затем завершить работу.
.TP
.B --dump-version
Вывести только номер версии пакета MCPU и завершить работу.
.SH УПРАВЛЕНИЕ ФЛАГАМИ PSW
Ассемблер принимает явные инструкции управления arithmetic/status flags:
.nf
SETF flag
CLRF flag
CLRCPUF
CLRMPUF
.fi
.PP
.B SETF
и
.B CLRF
принимают именованные флаги AF, CF, OF, SF, PF, ZF, RF, VF, DOMF, SNGF,
OVFF, UDFF, TLSF, PLSF, INDF и INXF, то есть PSW bits 0..15. HF, TF и IF
остаются допустимыми selectors для чтения через условные переходы, но этими
инструкциями не записываются; MODE является многобитовым полем и selector не
имеет.
.B CLRCPUF
очищает PSW[7:0], а
.B CLRMPUF
очищает PSW[15:8]. Обе инструкции сохраняют control/execution state выше bit 15.
.SH УПРАВЛЕНИЕ ИСХОДНОЙ ПОЗИЦИЕЙ
Ассемблер принимает директиву
.B #line
с десятичным номером строки и необязательным именем файла в кавычках. Она
предназначена для вывода препроцессора, меняет последующие позиции диагностик и
не записывается в MELF.
.SH СТАТУС ЗАВЕРШЕНИЯ
Ноль при успехе; ненулевое значение при синтаксической, семантической, I/O или
object-generation ошибке.
.SH ПРИМЕРЫ
.nf
mcpu-as -o main.o main.s
mcpu-as helper.s -o helper.o
.fi
.SH СМ. ТАКЖЕ
.BR mcpu-ld (1),
.BR mcpu-readelf (1),
.BR mcpu-objdump (1),
.BR libmcpu (7)