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

   1 .TH xvmstat 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 xvmstat \- extended vmstat demo in DTrace. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B xvmstat
   6 [interval [count]]
   7 .SH DESCRIPTION
   8 This has been written to demonstrate fetching similar data as vmstat
   9 from DTrace, with a few extra fields.
  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 - needs various kernel symbols.
  17 .SH EXAMPLES
  18 .TP
  19 Print virtual memory statistics every second,
  20 #
  21 .B xvmstat
  22 .TP
  23 Print every 5 seconds, 6 times,
  24 #
  25 .B xvmstat
  26 5 6
  27 .PP
  28 .SH FIELDS
  29 .TP
  30 w
  31 swapped out LWPs, number
  32 .TP
  33 swap
  34 virtual memory free, Mb
  35 .TP
  36 free
  37 free RAM, Mb
  38 .TP
  39 re
  40 page reclaims, pages
  41 .TP
  42 maj
  43 major faults, pages
  44 .TP
  45 mf
  46 minor faults, pages
  47 .TP
  48 cow
  49 copy-on-write faults, pages
  50 .TP
  51 pro
  52 protection faults, pages
  53 sr
  54 scan rate, pages
  55 .TP
  56 epi
  57 executable page ins, pages
  58 .TP
  59 epo
  60 executable page outs, pages
  61 .TP
  62 epf
  63 executable frees, pages
  64 .TP
  65 api
  66 anonymous page ins, pages
  67 .TP
  68 apo
  69 anonymous page outs, pages
  70 .TP
  71 apf
  72 anonymous frees, pages
  73 .TP
  74 fpi
  75 filesystem page ins, pages
  76 .TP
  77 fpo
  78 filesystem page outs, pages
  79 .TP
  80 fpf
  81 filesystem frees, pages
  82 .PP
  83 .SH NOTES
  84 Most of the statistics are in units of pages, unlike the
  85 original vmstat command which sometimes uses kilobytes.
  86
  87 All page values are per second values.
  88
  89 As this program does not use Kstat, there is no summary since boot line.
  90
  91 Free RAM is both free free + cache free.
  92 .PP
  93 .SH DOCUMENTATION
  94 See the DTraceToolkit for further documentation under the
  95 Docs directory. The DTraceToolkit docs may include full worked
  96 examples with verbose descriptions explaining the output.
  97 .SH EXIT
  98 xvmstat will run until Ctrl\-C is hit, or until the count argument
  99 has been satisfied.
 100 .SH AUTHOR
 101 Brendan Gregg
 102 [Sydney, Australia]
 103 .SH SEE ALSO
 104 vmstat(1M), dtrace(1M)