1 .\"
2 .\" Mach Operating System
3 .\" Copyright (c) 1991,1990 Carnegie Mellon University
4 .\" All Rights Reserved.
5 .\"
6 .\" Permission to use, copy, modify and distribute this software and its
7 .\" documentation is hereby granted, provided that both the copyright
8 .\" notice and this permission notice appear in all copies of the
9 .\" software, derivative works or modified versions, and any portions
10 .\" thereof, and that both notices appear in supporting documentation.
11 .\"
12 .\" CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
13 .\" CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
14 .\" ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
15 .\"
16 .\" Carnegie Mellon requests users of this software to return to
17 .\"
18 .\" Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
19 .\" School of Computer Science
20 .\" Carnegie Mellon University
21 .\" Pittsburgh PA 15213-3890
22 .\"
23 .\" any improvements or extensions that they make and grant Carnegie Mellon
24 .\" the rights to redistribute these changes.
25 .\"
26 .\"
27 .\" HISTORY
28 .\" $Log: vm_statistics.man,v $
29 .\" Revision 2.5 93/03/18 15:17:07 mrt
30 .\" corrected types
31 .\" [93/03/12 16:55:44 lli]
32 .\"
33 .\" Revision 2.4 91/05/14 17:16:37 mrt
34 .\" Correcting copyright
35 .\"
36 .\" Revision 2.3 91/02/14 14:16:45 mrt
37 .\" Changed to new Mach copyright
38 .\" [91/02/12 18:17:45 mrt]
39 .\"
40 .\" Revision 2.2 90/08/07 18:48:18 rpd
41 .\" Created.
42 .\"
43 .TH vm_statistics 2 9/19/86
44 .CM 4
45 .SH NAME
46 .nf
47 vm_statistics \- returns virtual memory statistics for the system
48 .SH SYNOPSIS
49 .nf
50 .ft B
51 #include <mach.h>
52
53 struct vm_statistics {
54 long pagesize; /* page size in bytes */
55 long free_count; /* # of pages free */
56 long active_count; /* # of pages active */
57 long inactive_count; /* # of pages inactive */
58 long wire_count; /* # of pages wired down */
59 long zero_fill_count; /* # of zero fill pages */
60 long reactivations; /* # of pages reactivated */
61 long pageins; /* # of pageins */
62 long pageouts; /* # of pageouts */
63 long faults; /* # of faults */
64 long cow_faults; /* # of copy-on-writes */
65 long lookups; /* object cache lookups */
66 long hits; /* object cache hits */
67 };
68
69 typedef struct vm_statistics vm_statistics_data_t;
70
71 .nf
72 .ft B
73 kern_return_t vm_statistics(target_task, vm_stats)
74 mach_port_t target_task;
75 vm_statistics_data_t *vm_stats; /* out */
76
77
78 .fi
79 .ft P
80 .SH ARGUMENTS
81 .TP 15
82 .B
83 target_task
84 Task which is requesting statistics.
85 .TP 15
86 .B
87 vm_stats
88 The structure that will receive the statistics.
89
90 .SH DESCRIPTION
91 .B vm_statistics
92 returns the statistics about the kernel's use of virtual memory
93 since the kernel was booted.
94 .B pagesize
95 can also be found as a global variable
96 .B vm_page_size
97 which
98 is set at task initialization and remains constant for the life of the task.
99
100 .SH DIAGNOSTICS
101 .TP 25
102 KERN_SUCCESS
103
Cache object: 8dbfe2bb2d723b4c49f26b3cac9a6b72
|