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/viuavmVIUA VM Part of the viua(1) toolchain.