]> git.saurik.com Git - apple/xnu.git/blame - osfmk/man/vm_statistics.html
xnu-2422.1.72.tar.gz
[apple/xnu.git] / osfmk / man / vm_statistics.html
CommitLineData
13fec989
A
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>
29The total number of free pages in the system.
30<p>
31<dt> <var>active_count</var>
32<dd>
33The total number of pages currently in use and pageable.
34<p>
35<dt> <var>inactive_count</var>
36<dd>
37The number of inactive pages.
38<p>
39<dt> <var>wire_count</var>
40<dd>
41The number of pages that are wired in memory and cannot be paged
42out.
43<p>
44<dt> <var>zero_fill_count</var>
45<dd>
46The number of zero-fill pages.
47<p>
48<dt> <var>reactivations</var>
49<dd>
50The number of reactivated pages.
51<p>
52<dt> <var>pageins</var>
53<dd>
54The number of requests for pages from a pager (such as the i-node
55pager).
56<p>
57<dt> <var>pageouts</var>
58<dd>
59The number of pages that have been paged out.
60<p>
61<dt> <var>faults</var>
62<dd>
63The number of times the <strong>vm_fault</strong> routine has been called.
64<p>
65<dt> <var>cow_faults</var>
66<dd>
67The number of copy-on-write faults.
68<p>
69<dt> <var>lookups</var>
70<dd>
71The number of object cache lookups.
72<p>
73<dt> <var>hits</var>
74<dd>
75The number of object cache hits.
76</dl>
77<h3>DESCRIPTION</h3>
78<p>
79The <strong>vm_statistics</strong> structure defines the statistics
80available on the kernel's use of
81virtual memory. The statistics record virtual memory usage since
82the kernel was booted.
83<p>
84For related information for a specific task, see the <strong>task_basic_info</strong>
85structure.
86<h3>NOTES</h3>
87<p>
88This structure is machine word length specific because of the memory sizes
89returned.
90<h3>RELATED INFORMATION</h3>
91<p>
92Functions:
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>
96Data Structures:
97<a href="task_basic_info.html"><strong>task_basic_info</strong></a>.
98