1/* 2 * Copyright (c) 2000-2006 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#if 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#if 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#if 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