VIUA-ASM(1) Viua VM Manual VIUA-ASM(1)
NAME viua-asm - the Viua VM assembler SYNOPSIS viua asm [options] [--out output] [--] source DESCRIPTION viua 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). OPTIONS Common 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 FILES source 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 ALSO viua-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/viuavmVIUA VM Part of the viua(1) toolchain.