1/*
2 * Copyright (c) 2000-2016 Apple Computer, Inc. All rights reserved.
3 *
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5 *
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
14 *
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
17 *
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
25 *
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27 */
28/*
29 * @OSF_COPYRIGHT@
30 */
31/*
32 * File: mach/vm_region.h
33 *
34 * Define the attributes of a task's memory region
35 *
36 */
37
38#ifndef _MACH_VM_REGION_H_
39#define _MACH_VM_REGION_H_
40
41#include <mach/boolean.h>
42#include <mach/vm_prot.h>
43#include <mach/vm_inherit.h>
44#include <mach/vm_behavior.h>
45#include <mach/vm_types.h>
46#include <mach/message.h>
47#include <mach/machine/vm_param.h>
48#include <mach/machine/vm_types.h>
49#include <mach/memory_object_types.h>
50
51#include <sys/cdefs.h>
52
53#pragma pack(4)
54
55// LP64todo: all the current tools are 32bit, obviously never worked for 64b
56// so probably should be a real 32b ID vs. ptr.
57// Current users just check for equality
58typedef uint32_t vm32_object_id_t;
59
60/*
61 * Types defined:
62 *
63 * vm_region_info_t memory region attributes
64 */
65
66#define VM_REGION_INFO_MAX (1024)
67typedef int *vm_region_info_t;
68typedef int *vm_region_info_64_t;
69typedef int *vm_region_recurse_info_t;
70typedef int *vm_region_recurse_info_64_t;
71typedef int vm_region_flavor_t;
72typedef int vm_region_info_data_t[VM_REGION_INFO_MAX];
73
74#define VM_REGION_BASIC_INFO_64 9
75struct vm_region_basic_info_64 {
76 vm_prot_t protection;
77 vm_prot_t max_protection;
78 vm_inherit_t inheritance;
79 boolean_t shared;
80 boolean_t reserved;
81 memory_object_offset_t offset;
82 vm_behavior_t behavior;
83 unsigned short user_wired_count;
84};
85typedef struct vm_region_basic_info_64 *vm_region_basic_info_64_t;
86typedef struct vm_region_basic_info_64 vm_region_basic_info_data_64_t;
87
88#define VM_REGION_BASIC_INFO_COUNT_64 ((mach_msg_type_number_t) \
89 (sizeof(vm_region_basic_info_data_64_t)/sizeof(int)))
90
91/*
92 * Passing VM_REGION_BASIC_INFO to vm_region_64
93 * automatically converts it to a VM_REGION_BASIC_INFO_64.
94 * Please use that explicitly instead.
95 */
96#define VM_REGION_BASIC_INFO 10
97
98/*
99 * This is the legacy basic info structure. It is
100 * deprecated because it passes only a 32-bit memory object
101 * offset back - too small for many larger objects (e.g. files).
102 */
103struct vm_region_basic_info {
104 vm_prot_t protection;
105 vm_prot_t max_protection;
106 vm_inherit_t inheritance;
107 boolean_t shared;
108 boolean_t reserved;
109 uint32_t offset; /* too small for a real offset */
110 vm_behavior_t behavior;
111 unsigned short user_wired_count;
112};
113
114typedef struct vm_region_basic_info *vm_region_basic_info_t;
115typedef struct vm_region_basic_info vm_region_basic_info_data_t;
116
117#define VM_REGION_BASIC_INFO_COUNT ((mach_msg_type_number_t) \
118 (sizeof(vm_region_basic_info_data_t)/sizeof(int)))
119
120#define SM_COW 1
121#define SM_PRIVATE 2
122#define SM_EMPTY 3
123#define SM_SHARED 4
124#define SM_TRUESHARED 5
125#define SM_PRIVATE_ALIASED 6
126#define SM_SHARED_ALIASED 7
127#define SM_LARGE_PAGE 8
128
129/*
130 * For submap info, the SM flags above are overlayed when a submap
131 * is encountered. The field denotes whether or not machine level mapping
132 * information is being shared. PTE's etc. When such sharing is taking
133 * place the value returned is SM_TRUESHARED otherwise SM_PRIVATE is passed
134 * back.
135 */
136
137#ifdef MACH_KERNEL_PRIVATE
138#define VM_REGION_EXTENDED_INFO__legacy 11
139struct vm_region_extended_info__legacy {
140 vm_prot_t protection;
141 unsigned int user_tag;
142 unsigned int pages_resident;
143 unsigned int pages_shared_now_private;
144 unsigned int pages_swapped_out;
145 unsigned int pages_dirtied;
146 unsigned int ref_count;
147 unsigned short shadow_depth;
148 unsigned char external_pager;
149 unsigned char share_mode;
150 /*
151 * XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX
152 * DO NOT EXTEND THIS DATA STRUCTURE.
153 * IT IS NOW ABANDONED AND REPLACED WITH vm_region_extended_info BELOW.
154 * XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX XXX
155 */
156};
157#define VM_REGION_EXTENDED_INFO_COUNT__legacy \
158 ((mach_msg_type_number_t) \
159 (sizeof (struct vm_region_extended_info__legacy) / \
160 sizeof (natural_t)))
161#endif /* MACH_KERNEL_PRIVATE */
162
163
164
165#define VM_REGION_EXTENDED_INFO 13
166struct vm_region_extended_info {
167 vm_prot_t protection;
168 unsigned int user_tag;
169 unsigned int pages_resident;
170 unsigned int pages_shared_now_private;
171 unsigned int pages_swapped_out;
172 unsigned int pages_dirtied;
173 unsigned int ref_count;
174 unsigned short shadow_depth;
175 unsigned char external_pager;
176 unsigned char share_mode;
177 unsigned int pages_reusable;
178};
179typedef struct vm_region_extended_info *vm_region_extended_info_t;
180typedef struct vm_region_extended_info vm_region_extended_info_data_t;
181#define VM_REGION_EXTENDED_INFO_COUNT \
182 ((mach_msg_type_number_t) \
183 (sizeof (vm_region_extended_info_data_t) / sizeof (natural_t)))
184
185
186
187
188#define VM_REGION_TOP_INFO 12
189
190struct vm_region_top_info {
191 unsigned int obj_id;
192 unsigned int ref_count;
193 unsigned int private_pages_resident;
194 unsigned int shared_pages_resident;
195 unsigned char share_mode;
196};
197
198typedef struct vm_region_top_info *vm_region_top_info_t;
199typedef struct vm_region_top_info vm_region_top_info_data_t;
200
201#define VM_REGION_TOP_INFO_COUNT \
202 ((mach_msg_type_number_t) \
203 (sizeof(vm_region_top_info_data_t) / sizeof(natural_t)))
204
205
206
207/*
208 * vm_region_submap_info will return information on a submap or object.
209 * The user supplies a nesting level on the call. When a walk of the
210 * user's map is done and a submap is encountered, the nesting count is
211 * checked. If the nesting count is greater than 1 the submap is entered and
212 * the offset relative to the address in the base map is examined. If the
213 * nesting count is zero, the information on the submap is returned.
214 * The caller may thus learn about a submap and its contents by judicious
215 * choice of the base map address and nesting count. The nesting count
216 * allows penetration of recursively mapped submaps. If a submap is
217 * encountered as a mapped entry of another submap, the caller may bump
218 * the nesting count and call vm_region_recurse again on the target address
219 * range. The "is_submap" field tells the caller whether or not a submap
220 * has been encountered.
221 *
222 * Object only fields are filled in through a walking of the object shadow
223 * chain (where one is present), and a walking of the resident page queue.
224 *
225 */
226
227struct vm_region_submap_info {
228 vm_prot_t protection; /* present access protection */
229 vm_prot_t max_protection; /* max avail through vm_prot */
230 vm_inherit_t inheritance;/* behavior of map/obj on fork */
231 uint32_t offset; /* offset into object/map */
232 unsigned int user_tag; /* user tag on map entry */
233 unsigned int pages_resident; /* only valid for objects */
234 unsigned int pages_shared_now_private; /* only for objects */
235 unsigned int pages_swapped_out; /* only for objects */
236 unsigned int pages_dirtied; /* only for objects */
237 unsigned int ref_count; /* obj/map mappers, etc */
238 unsigned short shadow_depth; /* only for obj */
239 unsigned char external_pager; /* only for obj */
240 unsigned char share_mode; /* see enumeration */
241 boolean_t is_submap; /* submap vs obj */
242 vm_behavior_t behavior; /* access behavior hint */
243 vm32_object_id_t object_id; /* obj/map name, not a handle */
244 unsigned short user_wired_count;
245};
246
247typedef struct vm_region_submap_info *vm_region_submap_info_t;
248typedef struct vm_region_submap_info vm_region_submap_info_data_t;
249
250#define VM_REGION_SUBMAP_INFO_COUNT \
251 ((mach_msg_type_number_t) \
252 (sizeof(vm_region_submap_info_data_t) / sizeof(natural_t)))
253
254struct vm_region_submap_info_64 {
255 vm_prot_t protection; /* present access protection */
256 vm_prot_t max_protection; /* max avail through vm_prot */
257 vm_inherit_t inheritance;/* behavior of map/obj on fork */
258 memory_object_offset_t offset; /* offset into object/map */
259 unsigned int user_tag; /* user tag on map entry */
260 unsigned int pages_resident; /* only valid for objects */
261 unsigned int pages_shared_now_private; /* only for objects */
262 unsigned int pages_swapped_out; /* only for objects */
263 unsigned int pages_dirtied; /* only for objects */
264 unsigned int ref_count; /* obj/map mappers, etc */
265 unsigned short shadow_depth; /* only for obj */
266 unsigned char external_pager; /* only for obj */
267 unsigned char share_mode; /* see enumeration */
268 boolean_t is_submap; /* submap vs obj */
269 vm_behavior_t behavior; /* access behavior hint */
270 vm32_object_id_t object_id; /* obj/map name, not a handle */
271 unsigned short user_wired_count;
272 unsigned int pages_reusable;
273};
274
275typedef struct vm_region_submap_info_64 *vm_region_submap_info_64_t;
276typedef struct vm_region_submap_info_64 vm_region_submap_info_data_64_t;
277
278#define VM_REGION_SUBMAP_INFO_V1_SIZE \
279 (sizeof (vm_region_submap_info_data_64_t))
280#define VM_REGION_SUBMAP_INFO_V0_SIZE \
281 (VM_REGION_SUBMAP_INFO_V1_SIZE - \
282 sizeof (unsigned int) /* pages_reusable */)
283
284#define VM_REGION_SUBMAP_INFO_V1_COUNT_64 \
285 ((mach_msg_type_number_t) \
286 (VM_REGION_SUBMAP_INFO_V1_SIZE / sizeof (natural_t)))
287#define VM_REGION_SUBMAP_INFO_V0_COUNT_64 \
288 ((mach_msg_type_number_t) \
289 (VM_REGION_SUBMAP_INFO_V0_SIZE / sizeof (natural_t)))
290
291/* set this to the latest version */
292#define VM_REGION_SUBMAP_INFO_COUNT_64 VM_REGION_SUBMAP_INFO_V1_COUNT_64
293
294struct vm_region_submap_short_info_64 {
295 vm_prot_t protection; /* present access protection */
296 vm_prot_t max_protection; /* max avail through vm_prot */
297 vm_inherit_t inheritance;/* behavior of map/obj on fork */
298 memory_object_offset_t offset; /* offset into object/map */
299 unsigned int user_tag; /* user tag on map entry */
300 unsigned int ref_count; /* obj/map mappers, etc */
301 unsigned short shadow_depth; /* only for obj */
302 unsigned char external_pager; /* only for obj */
303 unsigned char share_mode; /* see enumeration */
304 boolean_t is_submap; /* submap vs obj */
305 vm_behavior_t behavior; /* access behavior hint */
306 vm32_object_id_t object_id; /* obj/map name, not a handle */
307 unsigned short user_wired_count;
308};
309
310typedef struct vm_region_submap_short_info_64 *vm_region_submap_short_info_64_t;
311typedef struct vm_region_submap_short_info_64 vm_region_submap_short_info_data_64_t;
312
313#define VM_REGION_SUBMAP_SHORT_INFO_COUNT_64 \
314 ((mach_msg_type_number_t) \
315 (sizeof (vm_region_submap_short_info_data_64_t) / sizeof (natural_t)))
316
317
318
319struct mach_vm_read_entry {
320 mach_vm_address_t address;
321 mach_vm_size_t size;
322};
323
324struct vm_read_entry {
325 vm_address_t address;
326 vm_size_t size;
327};
328
329#ifdef VM32_SUPPORT
330struct vm32_read_entry {
331 vm32_address_t address;
332 vm32_size_t size;
333};
334#endif
335
336
337#define VM_MAP_ENTRY_MAX (256)
338
339typedef struct mach_vm_read_entry mach_vm_read_entry_t[VM_MAP_ENTRY_MAX];
340typedef struct vm_read_entry vm_read_entry_t[VM_MAP_ENTRY_MAX];
341#ifdef VM32_SUPPORT
342typedef struct vm32_read_entry vm32_read_entry_t[VM_MAP_ENTRY_MAX];
343#endif
344
345#pragma pack()
346
347
348#define VM_PAGE_INFO_MAX
349typedef int *vm_page_info_t;
350typedef int vm_page_info_data_t[VM_PAGE_INFO_MAX];
351typedef int vm_page_info_flavor_t;
352
353#define VM_PAGE_INFO_BASIC 1
354struct vm_page_info_basic {
355 int disposition;
356 int ref_count;
357 vm_object_id_t object_id;
358 memory_object_offset_t offset;
359 int depth;
360 int __pad; /* pad to 64-bit boundary */
361};
362typedef struct vm_page_info_basic *vm_page_info_basic_t;
363typedef struct vm_page_info_basic vm_page_info_basic_data_t;
364
365#define VM_PAGE_INFO_BASIC_COUNT ((mach_msg_type_number_t) \
366 (sizeof(vm_page_info_basic_data_t)/sizeof(int)))
367
368
369#endif /*_MACH_VM_REGION_H_*/
370