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

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