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 .Op Ar interval
  12 .Sh DESCRIPTION
  13 .Nm vm_stat
  14 displays Mach virtual memory statistics.  If the optional
  15 .Ar interval
  16 is specified, then
  17 .Nm vm_stat
  18 will display the statistics every
  19 .Ar interval
  20 seconds.  In this case, each line of output displays the change in
  21 each statistic (an
  22 .Ar interval
  23 count of 1 displays the values per second).  However, the first line
  24 of output following each banner displays the system-wide totals for
  25 each statistic.  The following values are displayed:
  26 .Bl -tag -width indent
  27 .It Pages free
  28 the total number of free pages in the system.
  29 .It Pages active
  30 the total number of pages currently in use and pageable.
  31 .It Pages inactive
  32 the total number of pages on the inactive list.
  33 .It Pages wired down
  34 the total number of pages wired down.  That is, pages that cannot be
  35 paged out.
  36 .It Translation faults
  37 the number of times the "vm_fault" routine has been called.
  38 .It Pages copy-on-write
  39 the number of faults that caused a page to be
  40 copied (generally caused by copy-on-write faults).
  41 .It Pages zero filled
  42 the total number of pages that have been zero-filled on demand.
  43 .It Pages reactivated
  44 the total number of pages that have been moved from the inactive list
  45 to the active list (reactivated).
  46 .It Pageins
  47 the number of requests for pages from a pager (such as the inode pager).
  48 .It Pageouts
  49 the number of pages that have been paged out.
  50 .El
  51 .Pp
  52 If
  53 .Ar interval
  54 is not specified, then
  55 .Nm vm_stat
  56 displays all accumulated statistics along with the page size and the
  57 object cache performance.