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

   1 .TH zvmstat 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 zvmstat \- print vmstat style info per Zone. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B zvmstat
   6 [\-t] [interval [count]]
   7 .SH DESCRIPTION
   8 This program must be run from the global zone as root.
   9
  10 Since this uses DTrace, only the root user or users with the
  11 dtrace_kernel privilege can run this command.
  12 .SH OS
  13 Solaris
  14 .SH STABILITY
  15 stable - needs the syscall and vminfo providers.
  16 .SH OPTIONS
  17 .TP
  18 \-t
  19 Print timestamps, string
  20 .TP
  21 interval
  22 Duration for each sample, seconds. default is 1.
  23 .TP
  24 count
  25 Number of samples. default is 1.
  26 .PP
  27 .SH EXAMPLES
  28 .TP
  29 Print virtual memory statistics every second,
  30 #
  31 .B zvmstat
  32 .TP
  33 Print every 5 seconds, 6 times,
  34 #
  35 .B zvmstat
  36 5 6
  37 .PP
  38 .SH FIELDS
  39 .TP
  40 ZONE
  41 zonename
  42 .TP
  43 re
  44 page reclaims, pages
  45 .TP
  46 mf
  47 minor faults, pages
  48 .TP
  49 fr
  50 pages freed, pages
  51 .TP
  52 sr
  53 scan rate, pages
  54 .TP
  55 epi
  56 executable page ins, pages
  57 .TP
  58 epo
  59 executable page outs, pages
  60 .TP
  61 epf
  62 executable frees, pages
  63 .TP
  64 api
  65 anonymous page ins, pages
  66 .TP
  67 apo
  68 anonymous page outs, pages
  69 .TP
  70 apf
  71 anonymous frees, pages
  72 .TP
  73 fpi
  74 filesystem page ins, pages
  75 .TP
  76 fpo
  77 filesystem page outs, pages
  78 .TP
  79 fpf
  80 filesystem frees, pages
  81 .PP
  82 .SH NOTES
  83 Most of the statistics are in units of pages, unlike the
  84 original vmstat command which sometimes uses kilobytes.
  85
  86 All page values are a total for the sample duration.
  87
  88 As this program does not use Kstat, there is no summary since boot line.
  89 .PP
  90 .SH DOCUMENTATION
  91 See the DTraceToolkit for further documentation under the
  92 Docs directory. The DTraceToolkit docs may include full worked
  93 examples with verbose descriptions explaining the output.
  94 .SH EXIT
  95 zvmstat will run until Ctrl\-C is hit, or until the count argument
  96 has been satisfied.
  97 .SH AUTHOR
  98 Brendan Gregg
  99 [Sydney, Australia]
 100 .SH SEE ALSO
 101 vmstat(1M), dtrace(1M)