VIUA-ASM(1) Viua VM Manual VIUA-ASM(1)
NAME
viua-asm - the Viua VM assembler
SYNOPSISviua asm [options] [--out output] [--] sourceDESCRIPTIONviua asm is a tool that converts Viua assembly source code into relo‐
catable ELF files to be consumed by the virtual machine's linker ie,
viua-ld(1).
OPTIONSCommon options-h, --help
Show the man page.
--version
Show version information.
-v, --verbose
Show verbose output.
--built-with
Show what the toolchain has been built with.
Tool options-o, --out=output
Write produced ELF file into output file instead of the default
source.o file.
--dump=what
Dump results of intermediate stages of the assembler's work. The
what argument can be either of:
• lex-raw to dump raw token stream
• lex-cooked to dump processed token stream
• ast to dump the abstract syntax tree of the source code
The --dump option may be specified multiple times to request the
dump of more than one stage.
EXIT STATUS
0 Successful program execution
1 Error during assembly
FILESsource The assembler opens its input file read-only. The file must
contain valid Viua VM assembly source code.
output The assembler outputs a single relocatable ELF file.
Note on ELF files produced by Viua
The output is a valid ELF file and as such can be inspected using the
regular readelf(1) program.
Viua toolchain also includes viua-readelf(1) ie, a version of read‐elf(1) specialised for Viua ELFs and capable of displaying the informa‐
tion in them with more detail.
SEE ALSOviua-dis(1), viua-ld(1), viua-readelf(1).
viua-asm(5).
readelf(1), elf(5).
Web site
‹https://viuavm.org›
Source code repository
‹https://git.sr.ht/~maelkum/viuavm›
VIUA VM
Part of the viua(1) toolchain.