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

   1 .TH sampleproc 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 sampleproc \- sample processes on the CPUs. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B sampleproc [hertz]
   6 .SH DESCRIPTION
   7 This program samples which process is on each CPU, at a particular
   8 configurable rate. This can be used as an estimate for which process
   9 is consuming the most CPU time.
  10
  11 Since this uses DTrace, only the root user or users with the
  12 dtrace_kernel privilege can run this command.
  13 .SH OS
  14 Solaris
  15 .SH STABILITY
  16 unstable - uses the ncpus_online kernel symbol.
  17 .SH EXAMPLES
  18 .TP
  19 Sample at 100 hertz,
  20 #
  21 .B sampleproc
  22 .TP
  23 Sample at 400 hertz,
  24 #
  25 .B sampleproc
  26 400
  27 .PP
  28 .SH FIELDS
  29 .TP
  30 PID
  31 process ID
  32 .TP
  33 COMMAND
  34 command name
  35 .TP
  36 COUNT
  37 number of samples
  38 .TP
  39 PERCENT
  40 percent of CPU usage
  41 .PP
  42 .SH BASED ON
  43 /usr/demo/dtrace/prof.d
  44 .PP
  45 .SH DOCUMENTATION
  46 DTrace Guide "profile Provider" chapter (docs.sun.com)
  47
  48 See the DTraceToolkit for further documentation under the
  49 Docs directory. The DTraceToolkit docs may include full worked
  50 examples with verbose descriptions explaining the output.
  51 .SH EXIT
  52 sampleproc will sample until Ctrl\-C is hit.
  53 .SH SEE ALSO
  54 dtrace(1M)
  55