NAME

Perl Disassembly plugin for Devel::Trepan via B::Concise

SUMMARY

This adds a disassemble command to the Devel::Trepan debugger.

DESCRIPTION

disassemble [options] [subroutine|package-name ...]

options:

[-]-no-highlight
[-]-highight={plain|dark|light}
[-]-concise
[-]-basic
[-]-terse
[-]-linenoise
[-]-debug
[-]-compact
[-]-exec
[-]-tree
[-]-loose
[-]-vt
[-]-ascii
[-]-from <line-number>
[-]-to <line-number>

Disassembles the Perl interpreter OP tree using B::Concise.

Flags -from and -to respectively exclude lines less than or greater that the supplied line number. If no -to value is given and a subroutine or package is not given then the -to value is taken from the "listsize" value as a count, and the -from value is the current line.

Use set max list or show max list to see or set the number of lines to list.

-no-highlight will turn off syntax highlighting. -highlight=dark sets for a dark background, light for a light background and plain is the same as -no-highlight.

Other flags are are the corresponding B::Concise flags and that should be consulted for their meaning.

EXAMPLES

$ trepan.pl -e 1

(trepanpl): dissassemble
Package Main
  main program:
=>  LISTOP (0xa0dd208)
  	op_next		0
  	op_sibling	0
  	op_ppaddr	PL_ppaddr[OP_LEAVE]
  	op_type		185
  	op_flags	0001101: parenthesized, want kids, want void
  	op_private	64
  	op_first	0xa0e6f60
  	op_last		0xa0e7298
  OP (0xa0e6f60)
  	op_next		0xa0dd228
  	op_sibling	0xa0dd228
  	op_ppaddr	PL_ppaddr[OP_ENTER]
  	op_type		184
  	op_flags	0000000
  	op_private	0
  # 1: 1
  COP (0xa0dd228)
  	op_next		0xa0dd208
  	op_sibling	0xa0e7298
  	op_ppaddr	PL_ppaddr[OP_DBSTATE]
  	op_type		182
  	op_flags	0000001: want void
  	op_private	0	256
  OP (0xa0e7298)
  	op_next		0xa0dd208
  	op_sibling	0
  	op_ppaddr	PL_ppaddr[OP_NULL]
  	op_type		0
  	op_flags	0000001: want void
  	op_private	0

Above, the => indicates the next instruction to run.

By default disasm is an alias for disassemble. Here is the -tree option; --tree is okay too.

(trepanpl): disasm -tree

 main program:
 0xa0dd208-+-0xa0e6f60
           |-# 1:  1
 0xa0dd228
           `-0xa0e7298

Functions can be given:

(trepanpl): disasm -basic File::Basename::basename

 File::Basename::basename:
 UNOP (0x8ad1d00)
 	op_next		0
 	op_sibling	0
 	op_ppaddr	PL_ppaddr[OP_LEAVESUB]
 	op_type		174
 ...

Finally, you can limit the range of output using -from and/or -to:

(trepanpl): disasm -from 227 -to 236 -basic File::Basename::basename

See also:

list, and deparse, set highlight, set max list, and show max list.

AUTHORS

Rocky Bernstein

COPYRIGHT

Copyright (C) 2012, 2015 Rocky Bernstein <rocky@cpan.org>

This program is distributed WITHOUT ANY WARRANTY, including but not limited to the implied warranties of merchantability or fitness for a particular purpose.

The program is free software. You may distribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation (either version 2 or any later version) and the Perl Artistic License as published by O'Reilly Media, Inc. Please open the files named gpl-2.0.txt and Artistic for a copy of these licenses.