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

   1 .TH pridist.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 pridist.d \- process priority distribution. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B pridist.d
   6 .SH DESCRIPTION
   7 This is a simple DTrace script that samples at 1000 Hz which process
   8 is on the CPUs, and what the priority is. A distribution plot is printed.
   9
  10 With priorities, the higher the priority the better chance the process
  11 (actually, thread) has of being scheduled.
  12
  13 This idea came from the script /usr/demo/dtrace/profpri.d, which
  14 produces similar output for one particular PID.
  15
  16 Since this uses DTrace, only the root user or users with the
  17 dtrace_kernel privilege can run this command.
  18 .SH OS
  19 Solaris
  20 .SH STABILITY
  21 stable.
  22 .SH EXAMPLES
  23 .TP
  24 This samples until Ctrl\-C is hit.
  25 #
  26 .B pridist.d
  27 .PP
  28 .SH FIELDS
  29 .TP
  30 CMD
  31 process name
  32 .TP
  33 PID
  34 process ID
  35 .TP
  36 value
  37 process priority
  38 .TP
  39 count
  40 number of samples of at least this priority
  41 .PP
  42 .SH BASED ON
  43 /usr/demo/dtrace/profpri.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 pridist.d will sample until Ctrl\-C is hit.
  53 .SH SEE ALSO
  54 dispadmin(1M), dtrace(1M)
  55