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

   1 .TH sh_flow.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 sh_flow.d - snoop Bourne shell execution showing function flow using DTrace.
   4 .SH SYNOPSIS
   5 .B sh_flow.d
   6
   7 .SH DESCRIPTION
   8 This traces shell activity from all Bourne shells on the system that are
   9 running with sh provider support.
  10
  11 This watches shell function entries and returns, and indents child
  12 function calls. Shell builtins are also printed.
  13 .SH OS
  14 Any
  15 .SH STABILITY
  16 Evolving - uses the DTrace Shell provider, which may change
  17 as additional features are introduced. Check Shell/Readme
  18 to see what version these scripts are based on.
  19 .SH EXAMPLES
  20 .TP
  21 Default output,
  22 #
  23 .B sh_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 function belongs to
  35 .TP
  36 NAME
  37 Shell function, builtin or command name
  38 .SH LEGEND
  39 .TP
  40 \->
  41 function entry
  42 .TP
  43 <\-
  44 function return
  45 .TP
  46 >
  47 builtin
  48 .TP
  49 |
  50 external command
  51 .SH WARNING
  52 Watch the first column carefully, it prints the CPU-id. If it
  53 changes, then it is very likely that the output has been shuffled.
  54 .PP
  55 .SH DOCUMENTATION
  56 See the DTraceToolkit for further documentation under the
  57 Examples, Notes and Docs directories. The example files may be
  58 especially useful as they aim to demonstrate how to interpret
  59 the output.
  60 .SH EXIT
  61 sh_flow.d will run until Ctrl-C is hit.
  62 .SH AUTHOR
  63 Brendan Gregg
  64 [CA, USA]
  65 .SH SEE ALSO
  66 dtrace(1M)