VIUA-VM(1) Viua VM Manual VIUA-VM(1)
NAME
viua-vm - the Viua virtual machine
SYNOPSISviua vm [options] [--] executable [args...]
viua vm [options]
DESCRIPTIONviua 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.
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
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.
ENVIRONMENTVIUA_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::].
FILESexecutable is open read-only, and must be a valid executable ELF file
containing Viua bytecode.
SEE ALSOviua-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.