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

   1 .TH sh_flowtime.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 sh_flowtime.d - snoop Bourne shell execution with flow and delta times.
   4 .SH SYNOPSIS
   5 .B sh_flowtime.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
  14 DELTAs:
  15 ->              previous line to the start of this function
  16 <-              previous line to the end of this function
  17 >               previous line to the end of this builtin
  18 |               previous line to the end of this command
  19
  20 See sh_flowinfo.d for more verbose and more straightforward delta times.
  21
  22 Filename and function names are printed if available.
  23 .SH OS
  24 Any
  25 .SH STABILITY
  26 Evolving - uses the DTrace Shell provider, which may change
  27 as additional features are introduced. Check Shell/Readme
  28 to see what version these scripts are based on.
  29 .SH EXAMPLES
  30 .TP
  31 Default output,
  32 #
  33 .B sh_flowtime.d
  34 .PP
  35 .SH FIELDS
  36 .TP
  37 C
  38 CPU-id
  39 .TP
  40 TIME(us)
  41 Time since boot, us
  42 .TP
  43 FILE
  44 Filename that this function belongs to
  45 .TP
  46 NAME
  47 Shell function or builtin name
  48 .SH LEGEND
  49 .TP
  50 \->
  51 function entry
  52 .TP
  53 <\-
  54 function return
  55 .TP
  56 >
  57 builtin
  58 .TP
  59 |
  60 external command
  61 .SH WARNING
  62 Watch the first column carefully, it prints the CPU-id. If it
  63 changes, then it is very likely that the output has been shuffled.
  64 .PP
  65 .SH DOCUMENTATION
  66 See the DTraceToolkit for further documentation under the
  67 Examples, Notes and Docs directories. The example files may be
  68 especially useful as they aim to demonstrate how to interpret
  69 the output.
  70 .SH EXIT
  71 sh_flowtime.d will run until Ctrl-C is hit.
  72 .SH AUTHOR
  73 Brendan Gregg
  74 [CA, USA]
  75 .SH SEE ALSO
  76 dtrace(1M)