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



NAME
       viua-readelf - inspect ELF files containing Viua VM bytecode

SYNOPSIS
       viua readelf [options] [--] elf-file

DESCRIPTION
       viua  readelf  is used to inspect ELF files containing Viua VM bytecode
       to see what symbols they contain, sizes of various  sections  and  seg‐
       ments, etc.

       Any  output of the inspection is printed to the standard output stream.
       Standard error stream is reserved for error reports.

OPTIONS
   Common options
       --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
       -a, --all
           Show all available information.

       -h, --file-header
           Inspect the ELF header.

       -l, --program-headers, --segments
           Inspect the segment headers.

       -S, --section-headers, --sections
           Inspect the section headers.

       -g, --section-groups
           Inspect the section groups.

       -t, --section-details
           Show detailed section information. Implies --section-headers.

       -s, --symbols, --syms
           Show the symbol table, if the file contains any.

       --dynamic-symbols, --dyn-syms
           Show the dynamic symbol table, if the file contains any.

       -e, --headers
           Show all headers. Equivalent to -h -l -S.

EXIT STATUS
       0   Successful inspection
       1   No file given; file does not exist, or cannot be opened
       2   File is not a Viua ELF


ENVIRONMENT
       No environment variables are used.

FILES
       elf-file is open read-only, and must be a valid  ELF  (either  an  exe‐
       cutable or a library) file produced by the Viua toolchain.

SEE ALSO
       readelf(1).

       elf(5).

       Web site
           ‹https://viuavm.org›

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

VIUA VM
       Part of the viua(1) toolchain.