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

   1 .TH pl_syscolors.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 pl_syscolors.d - trace Perl subroutine flow plus syscalls, in color.
   4 .SH SYNOPSIS
   5 .B pl_syscolors.d
   6 { \-p PID | \-c cmd }
   7 .SH DESCRIPTION
   8 This watches Perl subroutine entries and returns, and indents child
   9 subroutine calls.
  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_syscolors.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/syscall)
  43 .TP
  44 NAME
  45 Perl subroutine or syscall name
  46 .SH WARNING
  47 Watch the first column carefully, it prints the CPU-id. If it
  48 changes, then it is very likely that the output has been shuffled.
  49 .PP
  50 .SH DOCUMENTATION
  51 See the DTraceToolkit for further documentation under the
  52 Examples, Notes and Docs directories. The example files may be
  53 especially useful as they aim to demonstrate how to interpret
  54 the output.
  55 .SH EXIT
  56 pl_syscolors.d will run until Ctrl-C is hit.
  57 .SH AUTHOR
  58 Brendan Gregg
  59 [CA, USA]
  60 .SH SEE ALSO
  61 dtrace(1M)