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



NAME
       viua-dis - the Viua VM disassembler

SYNOPSIS
       viua dis -i instruction
       viua dis [--no-demangle kind] [--out output] input

DESCRIPTION
       Disassemble ELF files produced by the Viua toolchain.

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
           Put the disassembly in the output file instead of writing it to the
           standard output stream.

       -i, --instruction=instruction
           Disassemble a single instruction instead of a file. This option may
           be  specified  more  than  once to disassemble more single instruc‐
           tions.

       -N, --no-demangle=kind
           The following table describes what kind of instructions will not be
           demangled for each value of kind:

       ┌──────┬──────────────────────────────────────────────────────────────┐
       │ kind │ prevents demangling of...                                    │
       ├──────┼──────────────────────────────────────────────────────────────┤
       │ li   │ integer loads into a single li pseudoinstruction             │
       ├──────┼──────────────────────────────────────────────────────────────┤
       │ mem  │ memory operations                                            │
       ├──────┼──────────────────────────────────────────────────────────────┤
       │ any  │ any pseudoinstruction                                        │
       └──────┴──────────────────────────────────────────────────────────────┘


EXIT STATUS
       0   Successful program execution
       1   Invalid input


FILES
       input    An ELF file containing Viua bytecode. The input file  is  open
                read-only.
       output   The  output  file  will  contain Viua assembly language source
                code if the disassembler ran successfully.


SEE ALSO
       viua-asm(1), viua-readelf(1).

       Web site
           ‹https://viuavm.org›

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

VIUA VM
       Part of the viua(1) toolchain.