system_cmds/vm_stat.tproj/vm_stat.1

   1 .\" Copyright (c) 1997, Apple Computer, Inc.  All rights reserved.
   2 .\"
   3 .Dd August 13, 1997
   4 .Dt VM_STAT 1
   5 .Os "Mac OS X"
   6 .Sh NAME
   7 .Nm vm_stat
   8 .Nd show Mach virtual memory statistics
   9 .Sh SYNOPSIS
  10 .Nm vm_stat
  11 .Oo
  12 .Op Fl c Ar count
  13 .Ar interval
  14 .Oc
  15 .Sh DESCRIPTION
  16 .Nm vm_stat
  17 displays Mach virtual memory statistics.  If the optional
  18 .Ar interval
  19 is specified, then
  20 .Nm vm_stat
  21 will display the statistics every
  22 .Ar interval
  23 seconds.  In this case, each line of output displays the change in
  24 each statistic (an
  25 .Ar interval
  26 count of 1 displays the values per second).  However, the first line
  27 of output following each banner displays the system-wide totals for
  28 each statistic.
  29 If a
  30 .Ar count
  31 is provided, the command will terminate after
  32 .Ar count
  33 intervals.
  34 The following values are displayed:
  35 .Bl -tag -width indent
  36 .It Pages free
  37 the total number of free pages in the system.
  38 .It Pages active
  39 the total number of pages currently in use and pageable.
  40 .It Pages inactive
  41 the total number of pages on the inactive list.
  42 .It Pages speculative
  43 the total number of pages on the speculative list.
  44 .It Pages throttled
  45 the total number of pages on the throttled list (not wired but not pageable).
  46 .It Pages wired down
  47 the total number of pages wired down.  That is, pages that cannot be
  48 paged out.
  49 .It Pages purgeable
  50 the total number of purgeable pages.
  51 .It Translation faults
  52 the number of times the "vm_fault" routine has been called.
  53 .It Pages copy-on-write
  54 the number of faults that caused a page to be
  55 copied (generally caused by copy-on-write faults).
  56 .It Pages zero filled
  57 the total number of pages that have been zero-filled on demand.
  58 .It Pages reactivated
  59 the total number of pages that have been moved from the inactive list
  60 to the active list (reactivated).
  61 .It Pages purged
  62 the total number of pages that have been purged.
  63 .It File-backed pages
  64 the total number of pages that are file-backed (non-swap)
  65 .It Anonymous pages
  66 the total number of pages that are anonymous
  67 .It Uncompressed pages
  68 the total number of pages (uncompressed) held within the compressor
  69 .It Pages used by VM compressor:
  70 the number of pages used to store compressed VM pages.
  71 .It Pages decompressed
  72 the total number of pages that have been decompressed by the VM compressor.
  73 .It Pages compressed
  74 the total number of pages that have been compressed by the VM compressor.
  75 .It Pageins
  76 the total number of requests for pages from a pager (such as the inode pager).
  77 .It Pageouts
  78 the total number of pages that have been paged out.
  79 .It Swapins
  80 the total number of compressed pages that have been swapped out to disk.
  81 .It Swapouts
  82 the total number of compressed pages that have been swapped back in from disk.
  83 .El
  84 .Pp
  85 If
  86 .Ar interval
  87 is not specified, then
  88 .Nm vm_stat
  89 displays all accumulated statistics along with the page size.