VIUA(1)                         Viua VM Manual                         VIUA(1)



NAME
       viua - the entry point of the Viua VM toolchain

SYNOPSIS
       viua tool [options...] [operands...]

       viua [tool] --version [--verbose]
       viua [tool] --built-with

       viua --help [tool]
       viua [tool] --help
       viua help [tool]

       viua --prefix

DESCRIPTION
       The frontend script for the Viua toolchain, dispatching commands to in‐
       ternal executables. For example, the following command

           ]$ viua asm --out foo.o foo.asm

       will execute

           /usr/local/libexec/viua/asm --out foo.o foo.asm

       if the toolchain has been installed into the /usr/local prefix. The in‐
       ternal  executables  can  be  used directly, but using them through the
       viua frontend is more convenient.

       Why even use a frontend script? To avoit polluting PATH with  viua-foo,
       viua-bar,  viua-baz,  etc  commands;  and to allow having multiple Viua
       versions installed in parallel.

       The following tools are available:

       •   asm - the assembler
       •   ld - the linker
       •   vm - the interpreter
       •   dis - the disassembler
       •   readelf - the ELF inspector

       See their respective man pages eg, viua-asm(1), for more information.

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
       --prefix
           Display the currently used prefix.

EXIT STATUS
       0   Successful program execution
       1   Error during program execution

       The internal tools report different exit codes and to  signal  specific
       conditions. See their respective man pages for more information.

SEE ALSO
       viua-asm(1), viua-dis(1), viua-ld(1), viua-readelf(1), viua-vm(1).

       Web site
           ‹https://viuavm.org›

       Source code repository
           ‹https://git.sr.ht/~maelkum/viuavm›

VIUA VM
       Part of the viua(1) toolchain.