VIUA-VM(1)                      Viua VM Manual                      VIUA-VM(1)



NAME
       viua-vm - the Viua virtual machine

SYNOPSIS
       viua vm [options] [--] executable [args...]
       viua vm [options]

DESCRIPTION
       viua vm is the interpreter for ELF files containing Viua bytecode.

       If any args are present they are forwarded to the main function defined
       by the executable, and made available as a string vector.

       Standard  input and standard output streams are not used by the VM. The
       program being executed has direct, uninterrupted, and unfiltered access
       to both of them.

       Standard error stream is  used  by  the  virtual  machine,  unless  the
       VIUA_VM_TRACE_FD  environment  variable is defined (see the ENVIRONMENT
       section). By default, the  virtual  machine  uses  the  standard  error
       stream  for  its  diagnostic  and  error  messages, and execution trace
       recording.

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
       The VM has no options specific to itself, but see the ENVIRONMENT  sec‐
       tion.

EXIT STATUS
       0       Successful program execution
       1       Error during execution
       other   The  executable  may set any exit code. The exit code's meaning
               depends on the executed program.


ENVIRONMENT
       VIUA_VM_TRACE_FD=fd
           The file descriptor to be used for  trace  output  instead  of  the
           standard  error  stream.  Trace  output  contains  a human-readable
           stream of all executed instructions,  as  well  as  the  output  of
           ebreak instructions.

       VIUA_VM_PID_SEED=seed
           Set  seed  of  PIDs to be seed, which must be a valid IPv6 address.
           The high 64 bits identify a virtual machine instance, and  the  low
           64 bits are used as a counter to assign PIDs to processes.

           By default, the seed is [fe80::].

FILES
       executable  is  open read-only, and must be a valid executable ELF file
       containing Viua bytecode.

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

       readelf(1).

       Web site
           ‹https://viuavm.org›

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

VIUA VM
       Part of the viua(1) toolchain.