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

   1 .TH sh_pidcolors.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 sh_pidcolors.d - Demonstration of deeper DTrace Bourne shell analysis.
   4 .SH SYNOPSIS
   5 .B sh_pidcolors.d
   6 { \-p PID | \-c cmd }
   7 .SH DESCRIPTION
   8 This extends sh_syscolors.d by including some "pid" provider tracing
   9 as a starting point for deeper analysis. Currently it adds the probes,
  10
  11 pid$target:a.out:e*:entry,
  12 pid$target:a.out:e*:return
  13
  14 which means, all functions from the /usr/bin/sh binary that begin with
  15 the letter "e". This adds about 34 probes. Customise it to whichever
  16 parts of /usr/bin/sh or the system libraries you are interested in.
  17
  18 The filename for syscalls may be printed as the shell name, if the
  19 script was invoked using the form "shell filename" rather than running
  20 the script with an interpreter line.
  21 .SH OS
  22 Any
  23 .SH STABILITY
  24 Evolving - uses the DTrace Shell provider, which may change
  25 as additional features are introduced. Check Shell/Readme
  26 to see what version these scripts are based on.
  27 .SH EXAMPLES
  28 .TP
  29 Default output,
  30 #
  31 .B sh_pidcolors.d
  32 .PP
  33 .SH FIELDS
  34 .TP
  35 C
  36 CPU-id
  37 .TP
  38 PID
  39 Process ID
  40 .TP
  41 DELTA(us)
  42 Elapsed time from previous line to this line
  43 .TP
  44 FILE
  45 Filename of the shell script
  46 .TP
  47 LINE
  48 Line number of filename
  49 .TP
  50 TYPE
  51 Type of call (func/builtin/cmd/line/shell)
  52 .TP
  53 NAME
  54 Shell function, builtin or command name
  55 .SH WARNING
  56 Watch the first column carefully, it prints the CPU-id. If it
  57 changes, then it is very likely that the output has been shuffled.
  58 .PP
  59 .SH DOCUMENTATION
  60 See the DTraceToolkit for further documentation under the
  61 Examples, Notes and Docs directories. The example files may be
  62 especially useful as they aim to demonstrate how to interpret
  63 the output.
  64 .SH EXIT
  65 sh_pidcolors.d will run until Ctrl-C is hit.
  66 .SH AUTHOR
  67 Brendan Gregg
  68 [CA, USA]
  69 .SH SEE ALSO
  70 dtrace(1M)