pbc_disassemble(1)

pbc_disassemble1

Parrot bytecode disassembler

Usage

pbc_disassemble [-bh?] [{--bare | --header-only}] [-o outfile] [file.pbc]

Overview

"pbc_disassemble" translates Parrot bytecode ("PBC") into Parrot assembly language ("PASM").

"file.pbc" is the bytecode file to disassemble. If a file is not specified, the bytecode will be read from "stdin". Additionally, if the "-o" switch is not given, the output is displayed to "stdout".

Options

-?, --help

Displays usage and help information.

-b, --bare

Displays bare PASM without the header and left column.

-h, --header-only

Displays only the constants table header.

-o filename, --output filename

Writes output to "filename".

Static functions

"int main(int argc, const char *argv[])"

Execution entry point. Starts up an interpreter, loads the bytecode from the command-line, and disassembles it.

"static void help(void)"

Prints out the user help information and exits.

"static void show_last_error_and_exit(Parrot_PMC interp)"

Prints out the "interp"'s last error and exits.

Releases

3 releases since Debian 6.0 (Squeeze); the text changed 2 times.

  1. 6.0
  2. 7
  3. 8

--bare since Debian 7 (Wheezy); --header-only since Debian 7 (Wheezy); --help since Debian 7 (Wheezy); --output since Debian 7 (Wheezy); -? since Debian 7 (Wheezy); -b since Debian 7 (Wheezy); -h since Debian 7 (Wheezy); -o since Debian 7 (Wheezy).

History

Initial version by Daniel Grunblatt on 2002.5.26.

Florian Ragwitz: Moved POD documentation that's not necessary to know how to actually run the disassembler to normal C comments (Wed, 16 Nov 2005).

Reini Urban: Renamed from disassemble to pbc_disassemble (2008-07-03).
Add options: help, -h, -o, --debug, --bare (2009-01-29)
Force option 1 for passing version check (2009-03-07)

Kevin Polulak (soh_cah_toa): Updated to use embedding API, moved source file
to frontend/pbc_disassemble, and cleaned up
source code and perldoc. (2011-06-19)

From parrot-devel 6.6.0-1 in Debian 8 (Jessie). Parsed by carta from the page's man source.