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

   1 .TH dvmstat 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 dvmstat \- vmstat by PID/name/command. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B dvmstat
   6 { \-p PID | \-n name | command }
   7 .SH DESCRIPTION
   8 This program provides vmstat like data for one particular PID, a
   9 process name, or when running a command. It prints statistics
  10 every second.
  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 Solaris
  16 .SH STABILITY
  17 stable - needs the vminfo provider.
  18 .SH OPTIONS
  19 .TP
  20 \-p PID
  21 examine this Process ID
  22 .TP
  23 \-n name
  24 examine processes with this name
  25 .PP
  26 .SH EXAMPLES
  27 .TP
  28 examine PID 1871,
  29 #
  30 .B dvmstat
  31 \-p 1871
  32 .TP
  33 examine processes called "tar",
  34 #
  35 .B dvmstat
  36 \-n tar
  37 .TP
  38 run and examine "df -h",
  39 #
  40 .B dvmstat
  41 df -h
  42 .PP
  43 .SH FIELDS
  44 .TP
  45 re
  46 page reclaims, Kbytes
  47 .TP
  48 maj
  49 major faults, Kbytes
  50 .TP
  51 mf
  52 minor faults, Kbytes
  53 .TP
  54 fr
  55 page frees, Kbytes
  56 .TP
  57 epi
  58 executable page ins, Kbytes
  59 .TP
  60 epo
  61 executable page outs, Kbytes
  62 .TP
  63 api
  64 anonymous page ins, Kbytes
  65 .TP
  66 apo
  67 anonymous page outs, Kbytes
  68 .TP
  69 fpi
  70 filesystem page ins, Kbytes
  71 .TP
  72 fpo
  73 filesystem page outs, Kbytes
  74 .TP
  75 sy
  76 system calls, number
  77 .PP
  78 .SH NOTES
  79 Most of the statistics are in units of kilobytes, unlike the
  80 original vmstat command which sometimes uses pages.
  81 .PP
  82 .SH DOCUMENTATION
  83 See the DTraceToolkit for further documentation under the
  84 Docs directory. The DTraceToolkit docs may include full worked
  85 examples with verbose descriptions explaining the output.
  86 .SH EXIT
  87 dvmstat will run until Ctrl\-C is hit, or the command it is
  88 examining ends.
  89 .SH AUTHOR
  90 Brendan Gregg
  91 [Sydney, Australia]
  92 .SH SEE ALSO
  93 dtrace(1M), vmstat(1M)