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

   1 .TH sh_wasted.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 sh_wasted.d - measure Bourne shell elapsed times for "wasted" commands.
   4 .SH SYNOPSIS
   5 .B sh_wasted.d
   6 { \-p PID | \-c cmd }
   7 .SH DESCRIPTION
   8 This script measures "wasted" commands - those which are called externally
   9 but are in fact builtins to the shell. Ever seen a script which calls
  10 /usr/bin/echo needlessly? This script measures that cost.
  11
  12 Filename and call names are printed if available.
  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_wasted.d
  24 .PP
  25 .SH FIELDS
  26 .TP
  27 FILE
  28 Filename of the shell or shellscript
  29 .TP
  30 NAME
  31 Name of call
  32 .TP
  33 TIME
  34 Total elapsed time for calls (us)
  35 .SH IDEA
  36 Mike Shapiro
  37 .PP
  38 .SH DOCUMENTATION
  39 See the DTraceToolkit for further documentation under the
  40 Examples, Notes and Docs directories. The example files may be
  41 especially useful as they aim to demonstrate how to interpret
  42 the output.
  43 .SH EXIT
  44 sh_wasted.d will run until Ctrl-C is hit.
  45 .SH AUTHOR
  46 Brendan Gregg
  47 [CA, USA]
  48 .SH SEE ALSO
  49 dtrace(1M)