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/viuavm›

VIUA VM
       Part of the viua(1) toolchain.