Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pbc_disassemble(1) [debian man page]

MAIN.C(1)						      Debian GNU/Linux manual							 MAIN.C(1)

NAME

       pbc_disassemble - parrot bytecode disassembler

SYNOPSIS

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

DESCRIPTION

       "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.

SEE ALSO

       src/embed.c and src/debug.c.

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)

Debian Project							    2011-10-29								 MAIN.C(1)

Check Out this Related Man Page

MAIN.C(1)						      Debian GNU/Linux manual							 MAIN.C(1)

NAME

       pbc_dump - Dump or convert Parrot bytecode (PBC) files

SYNOPSIS

	pbc_dump [-tdh] [--terse|--disassemble|--header-only] file.pbc

	pbc_dump -o converted.pbc file.pbc

DESCRIPTION

       A program to dump pack files to human readable form.

   Command-Line Options
       "-d"
	   Disassemble bytecode segments.

       "-h"
	   Dump the bytecode header only.

       "-t"
	   Terse output.

       "-o converted.pbc"
	   Repacks a PBC file into the platform's native binary format for better efficiency on reading non-native PBCs.

   Functions
       "static void const_dump(PARROT_INTERP, const PackFile_Segment *segp)"
	   Dump the constant table.

       "static void disas_dump(PARROT_INTERP, const PackFile_Segment *self)"
	   Disassemble and dump.

       "static void nums_dump(PARROT_INTERP, const PackFile_Segment *self)"
	   Disassembles and dumps op names and line numbers only.

       "static void null_dump(PARROT_INTERP, const PackFile_Segment *self)"
	   Produces no output for the given segment type.

       "static void null_dir_dump(PARROT_INTERP, const PackFile_Segment *self)"
	   Dumps all of the segments of the given PackFile_Directory, but produces no output for the directory itself.

       "static void PackFile_header_dump(PARROT_INTERP, PackFile *pf)"
	   Dump the header.

       "static void help(void)"
	   Print out the user help info.

       "int main(int argc, const char **argv)"
	   The run loop. Process the command-line arguments and dump accordingly.

SEE ALSO

       src/packdump.c.

Debian Project							    2012-01-08								 MAIN.C(1)
Man Page