cddl/contrib/dtracetoolkit/Man/man1m/hotuser.1m

   1 .TH hotuser 1m   "$Date:: 2007-09-24 #$" "USER COMMANDS"
   2 .SH NAME
   3 hotuser - sample on-CPU user-level functions and libraries.
   4 .SH SYNOPSIS
   5 .B hotuser
   6 [\-hl] { \-c command | \-p PID }
   7 .SH DESCRIPTION
   8 This samples the on-CPU function at 1001 Hertz, for a simple yet
   9 effective user-level profiling tool for sampling exclusive function time.
  10 The output will identify which function is on the CPU the most - which
  11 is the hottest. See Notes/ALLexclusive_notes.txt for an explanation of
  12 exclusive time.
  13 .SH OS
  14 Solaris
  15 .SH STABILITY
  16 stable - Written using Perl and DTrace (Solaris 10 03/05)
  17 .SH EXAMPLES
  18 .TP
  19 Sample user functions from PID 81,
  20 #
  21 .B hotuser
  22 \-p 81
  23 .TP
  24 Sample user libraries from PID 81,
  25 #
  26 .B hotuser
  27 \-lp 81
  28 .TP
  29 Sample Xorg,
  30 #
  31 .B hotuser
  32 `pgrep \-n Xorg`
  33 .PP
  34 .SH DOCUMENTATION
  35 See the DTraceToolkit for further documentation under the
  36 Docs directory. The DTraceToolkit docs may include full worked
  37 examples with verbose descriptions explaining the output.
  38 .SH EXIT
  39 hotuser will run until Ctrl-C is hit.
  40 .SH AUTHOR
  41 Brendan Gregg
  42 [CA, USA]
  43 .SH SEE ALSO
  44 dtrace(1M), hotkernel(1M)