cddl/contrib/dtracetoolkit/Man/man1m/pl_flow.d.1m

   1 .TH pl_flow.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 pl_flow.d - snoop Perl execution showing subroutine flow.
   4 .SH SYNOPSIS
   5 .B pl_flow.d
   6
   7 .SH DESCRIPTION
   8 This traces Perl activity from all Perl programs on the system
   9 running with Perl provider support.
  10
  11 This watches Perl subroutine entries and returns, and indents child
  12 subroutine calls.
  13 .SH OS
  14 Any
  15 .SH STABILITY
  16 Evolving - uses the DTrace Perl provider, which may change
  17 as additional features are introduced. Check Perl/Readme
  18 to see what version these scripts are based on.
  19 .SH EXAMPLES
  20 .TP
  21 Default output,
  22 #
  23 .B pl_flow.d
  24 .PP
  25 .SH FIELDS
  26 .TP
  27 C
  28 CPU-id
  29 .TP
  30 TIME(us)
  31 Time since boot, us
  32 .TP
  33 FILE
  34 Filename that this subroutine belongs to
  35 .TP
  36 SUB
  37 Subroutine name
  38 .SH LEGEND
  39 .TP
  40 \->
  41 subroutine entry
  42 .TP
  43 <\-
  44 subroutine return
  45 .SH WARNING
  46 Watch the first column carefully, it prints the CPU-id. If it
  47 changes, then it is very likely that the output has been shuffled.
  48 .PP
  49 .SH DOCUMENTATION
  50 See the DTraceToolkit for further documentation under the
  51 Examples, Notes and Docs directories. The example files may be
  52 especially useful as they aim to demonstrate how to interpret
  53 the output.
  54 .SH EXIT
  55 pl_flow.d will run until Ctrl-C is hit.
  56 .SH AUTHOR
  57 Brendan Gregg
  58 [CA, USA]
  59 .SH SEE ALSO
  60 dtrace(1M)