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

   1 .TH cpuwalk.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 cpuwalk.d \- Measure which CPUs a process runs on. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B cpuwalk.d [duration]
   6 .SH DESCRIPTION
   7 This program is for multi-CPU servers, and can help identify if a process
   8 is running on multiple CPUs concurrently or not.
   9
  10 A duration may be specified in seconds.
  11
  12 Since this uses DTrace, only the root user or users with the
  13 dtrace_kernel privilege can run this command.
  14 .SH OS
  15 Any
  16 .SH STABILITY
  17 stable.
  18 .SH EXAMPLES
  19 .TP
  20 this runs until Ctrl\-C is hit,
  21 #
  22 .B cpuwalk.d
  23 .PP
  24 .TP
  25 run for 5 seconds,
  26 #
  27 .B cpuwalk.d
  28 5
  29 .PP
  30 .SH FIELDS
  31 .TP
  32 PID
  33 process ID
  34 .TP
  35 CMD
  36 process name
  37 .TP
  38 value
  39 CPU id
  40 .TP
  41 count
  42 number of samples (sample at 100 hz)
  43 .PP
  44 .SH DOCUMENTATION
  45 See the DTraceToolkit for further documentation under the
  46 Docs directory. The DTraceToolkit docs may include full worked
  47 examples with verbose descriptions explaining the output.
  48 .SH EXIT
  49 cpuwalk.d will run until Ctrl\-C is hit, or the duration specified
  50 is reached.
  51 .SH SEE ALSO
  52 threaded.d(1M), dtrace(1M)
  53