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

   1 .TH threaded.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 threaded.d \- sample multi-threaded CPU usage. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B threaded.d
   6 .SH DESCRIPTION
   7 This measures thread IDs as a process runs across multiple CPUs.
   8 It is a simple script that can help determine if a multi-threaded
   9 application is effectively using it's threads, or if the threads have
  10 serialised. See the example file in Docs/Examples/threaded_example.txt
  11 for a demonstration.
  12
  13 Since this uses DTrace, only the root user or users with the
  14 dtrace_kernel privilege can run this command.
  15 .SH OS
  16 Any
  17 .SH STABILITY
  18 stable.
  19 .SH EXAMPLES
  20 .TP
  21 This runs until Ctrl\-C is hit.
  22 #
  23 .B threaded.d
  24 .PP
  25 .SH FIELDS
  26 .TP
  27 PID
  28 process ID
  29 .TP
  30 CMD
  31 process name
  32 .TP
  33 value
  34 thread ID
  35 .TP
  36 count
  37 number of samples
  38 .PP
  39 .SH SEE ALSO
  40 prstat \-L
  41 .PP
  42 .SH DOCUMENTATION
  43 See the DTraceToolkit for further documentation under the
  44 Docs directory. The DTraceToolkit docs may include full worked
  45 examples with verbose descriptions explaining the output.
  46 .SH EXIT
  47 threaded.d will run until Ctrl\-C is hit.
  48 .SH SEE ALSO
  49 dtrace(1M)
  50