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

   1 .TH sh_syscolors.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 sh_syscolors.d - trace Bourne shell flow plus syscalls, in color.
   4 .SH SYNOPSIS
   5 .B sh_syscolors.d
   6 { \-p PID | \-c cmd }
   7 .SH DESCRIPTION
   8 This watches shell function entries and returns, and indents child
   9 function calls. Shell builtins, commands and lines are also printed.
  10
  11 The filename for syscalls may be printed as the shell name, if the
  12 script was invoked using the form "shell filename" rather than running
  13 the script with an interpreter line.
  14 .SH OS
  15 Any
  16 .SH STABILITY
  17 Evolving - uses the DTrace Shell provider, which may change
  18 as additional features are introduced. Check Shell/Readme
  19 to see what version these scripts are based on.
  20 .SH EXAMPLES
  21 .TP
  22 Default output,
  23 #
  24 .B sh_syscolors.d
  25 .PP
  26 .SH FIELDS
  27 .TP
  28 C
  29 CPU-id
  30 .TP
  31 PID
  32 Process ID
  33 .TP
  34 DELTA(us)
  35 Elapsed time from previous line to this line
  36 .TP
  37 FILE
  38 Filename of the shell script
  39 .TP
  40 LINE
  41 Line number of filename
  42 .TP
  43 TYPE
  44 Type of call (func/builtin/cmd/line/shell)
  45 .TP
  46 NAME
  47 Shell function, builtin or command name
  48 .SH WARNING
  49 Watch the first column carefully, it prints the CPU-id. If it
  50 changes, then it is very likely that the output has been shuffled.
  51 .PP
  52 .SH DOCUMENTATION
  53 See the DTraceToolkit for further documentation under the
  54 Examples, Notes and Docs directories. The example files may be
  55 especially useful as they aim to demonstrate how to interpret
  56 the output.
  57 .SH EXIT
  58 sh_syscolors.d will run until Ctrl-C is hit.
  59 .SH AUTHOR
  60 Brendan Gregg
  61 [CA, USA]
  62 .SH SEE ALSO
  63 dtrace(1M)