osfmk/man/vm_statistics.html

   1 <h2>vm_statistics</h2>
   2 <hr>
   3 <p>
   4 <strong>Structure</strong> - Defines statistics for the kernel's use of virtual memory.
   5 <h3>SYNOPSIS</h3>
   6 <pre>
   7 <strong>struct vm_statistics</strong>
   8 <strong>{</strong>
   9        <strong>integer_t</strong>       <var>free_count</var><strong>;</strong>
  10        <strong>integer_t</strong>       <var>active_count</var><strong>;</strong>
  11        <strong>integer_t</strong>       <var>inactive_count</var><strong>;</strong>
  12        <strong>integer_t</strong>       <var>wire_count</var><strong>;</strong>
  13        <strong>integer_t</strong>       <var>zero_fill_count</var><strong>;</strong>
  14        <strong>integer_t</strong>       <var>reactivations</var><strong>;</strong>
  15        <strong>integer_t</strong>       <var>pageins</var><strong>;</strong>
  16        <strong>integer_t</strong>       <var>pageouts</var><strong>;</strong>
  17        <strong>integer_t</strong>       <var>faults</var><strong>;</strong>
  18        <strong>integer_t</strong>       <var>cow_faults</var><strong>;</strong>
  19        <strong>integer_t</strong>       <var>lookups</var><strong>;</strong>
  20        <strong>integer_t</strong>       <var>hits</var><strong>;</strong>
  21 <strong>};</strong>
  22
  23 <strong>typedef struct vm_statistics* vm_statistics_t;</strong>
  24 </pre>
  25 <h3>FIELDS</h3>
  26 <dl>
  27 <dt> <var>free_count</var>
  28 <dd>
  29 The total number of free pages in the system.
  30 <p>
  31 <dt> <var>active_count</var>
  32 <dd>
  33 The total number of pages currently in use and pageable.
  34 <p>
  35 <dt> <var>inactive_count</var>
  36 <dd>
  37 The number of inactive pages.
  38 <p>
  39 <dt> <var>wire_count</var>
  40 <dd>
  41 The number of pages that are wired in memory and cannot be paged
  42 out.
  43 <p>
  44 <dt> <var>zero_fill_count</var>
  45 <dd>
  46 The number of zero-fill pages.
  47 <p>
  48 <dt> <var>reactivations</var>
  49 <dd>
  50 The number of reactivated pages.
  51 <p>
  52 <dt> <var>pageins</var>
  53 <dd>
  54 The number of requests for pages from a pager (such as the i-node
  55 pager).
  56 <p>
  57 <dt> <var>pageouts</var>
  58 <dd>
  59 The number of pages that have been paged out.
  60 <p>
  61 <dt> <var>faults</var>
  62 <dd>
  63 The number of times the <strong>vm_fault</strong> routine has been called.
  64 <p>
  65 <dt> <var>cow_faults</var>
  66 <dd>
  67 The number of copy-on-write faults.
  68 <p>
  69 <dt> <var>lookups</var>
  70 <dd>
  71 The number of object cache lookups.
  72 <p>
  73 <dt> <var>hits</var>
  74 <dd>
  75 The number of object cache hits.
  76 </dl>
  77 <h3>DESCRIPTION</h3>
  78 <p>
  79 The <strong>vm_statistics</strong> structure defines the statistics
  80 available on the kernel's use of
  81 virtual memory.  The statistics record virtual memory usage since
  82 the kernel was booted.
  83 <p>
  84 For related information for a specific task, see the <strong>task_basic_info</strong>
  85 structure.
  86 <h3>NOTES</h3>
  87 <p>
  88 This structure is machine word length specific because of the memory sizes
  89 returned.
  90 <h3>RELATED INFORMATION</h3>
  91 <p>
  92 Functions:
  93 <a href="task_info.html"><strong>task_info</strong></a>,
  94 <a href="host_page_size.html"><strong>host_page_size</strong></a>.
  95 <p>
  96 Data Structures:
  97 <a href="task_basic_info.html"><strong>task_basic_info</strong></a>.
  98