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