MMInternal.h@ 6529

Last change on this file since 6529 was 6529, checked in by vboxsync, 17 years ago
mmr3 -> mmR3.
Property svn:eol-style set to `native` Property svn:keywords set to `Id`
File size: 22.2 KB

Line
1	/* $Id: MMInternal.h 6529 2008-01-28 14:58:18Z vboxsync $ */
2	/** @file
3	* MM - Internal header file.
4	*/
5
6	/*
7	* Copyright (C) 2006-2007 innotek GmbH
8	*
9	* This file is part of VirtualBox Open Source Edition (OSE), as
10	* available from http://www.virtualbox.org. This file is free software;
11	* you can redistribute it and/or modify it under the terms of the GNU
12	* General Public License (GPL) as published by the Free Software
13	* Foundation, in version 2 as it comes in the "COPYING" file of the
14	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16	*/
17
18	#ifndef ___MMInternal_h
19	#define ___MMInternal_h
20
21	#include <VBox/cdefs.h>
22	#include <VBox/types.h>
23	#include <VBox/sup.h>
24	#include <VBox/stam.h>
25	#include <iprt/avl.h>
26	#include <iprt/critsect.h>
27
28
29	#if !defined(IN_MM_R3) && !defined(IN_MM_R0) && !defined(IN_MM_GC)
30	# error "Not in MM! This is an internal header!"
31	#endif
32
33
34	/** @defgroup grp_mm_int Internals
35	* @internal
36	* @ingroup grp_mm
37	* @{
38	*/
39
40	/** @name VM Ring-3 Heap Internals
41	* @{
42	*/
43
44	/** @def MMR3HEAP_WITH_STATISTICS
45	* Enable MMR3Heap statistics.
46	*/
47	#if !defined(MMR3HEAP_WITH_STATISTICS) && defined(VBOX_WITH_STATISTICS)
48	# define MMR3HEAP_WITH_STATISTICS
49	#endif
50
51	/** @def MMR3HEAP_SIZE_ALIGNMENT
52	* The allocation size alignment of the MMR3Heap.
53	*/
54	#define MMR3HEAP_SIZE_ALIGNMENT 16
55
56	/**
57	* Heap statistics record.
58	* There is one global and one per allocation tag.
59	*/
60	typedef struct MMHEAPSTAT
61	{
62	/** Core avl node, key is the tag. */
63	AVLULNODECORE Core;
64	/** Pointer to the heap the memory belongs to. */
65	struct MMHEAP *pHeap;
66	#ifdef MMR3HEAP_WITH_STATISTICS
67	/** Number of allocation. */
68	uint64_t cAllocations;
69	/** Number of reallocations. */
70	uint64_t cReallocations;
71	/** Number of frees. */
72	uint64_t cFrees;
73	/** Failures. */
74	uint64_t cFailures;
75	/** Number of bytes allocated (sum). */
76	uint64_t cbAllocated;
77	/** Number of bytes freed. */
78	uint64_t cbFreed;
79	/** Number of bytes currently allocated. */
80	size_t cbCurAllocated;
81	#endif
82	} MMHEAPSTAT;
83	/** Pointer to heap statistics record. */
84	typedef MMHEAPSTAT *PMMHEAPSTAT;
85
86
87
88	/**
89	* Additional heap block header for relating allocations to the VM.
90	*/
91	typedef struct MMHEAPHDR
92	{
93	/** Pointer to the next record. */
94	struct MMHEAPHDR *pNext;
95	/** Pointer to the previous record. */
96	struct MMHEAPHDR *pPrev;
97	/** Pointer to the heap statistics record.
98	* (Where the a PVM can be found.) */
99	PMMHEAPSTAT pStat;
100	/** Size of the allocation (including this header). */
101	size_t cbSize;
102	} MMHEAPHDR;
103	/** Pointer to MM heap header. */
104	typedef MMHEAPHDR *PMMHEAPHDR;
105
106
107	/** MM Heap structure. */
108	typedef struct MMHEAP
109	{
110	/** Lock protecting the heap. */
111	RTCRITSECT Lock;
112	/** Heap block list head. */
113	PMMHEAPHDR pHead;
114	/** Heap block list tail. */
115	PMMHEAPHDR pTail;
116	/** Heap per tag statistics tree. */
117	PAVLULNODECORE pStatTree;
118	/** The VM handle. */
119	PVM pVM;
120	/** Heap global statistics. */
121	MMHEAPSTAT Stat;
122	} MMHEAP;
123	/** Pointer to MM Heap structure. */
124	typedef MMHEAP *PMMHEAP;
125
126	/** @} */
127
128
129
130	/** @name Hypervisor Heap Internals
131	* @{
132	*/
133
134	/** @def MMHYPER_HEAP_FREE_DELAY
135	* If defined, it indicates the number of frees that should be delayed.
136	*/
137	#if defined(__DOXYGEN__)
138	# define MMHYPER_HEAP_FREE_DELAY 64
139	#endif
140
141	/** @def MMHYPER_HEAP_FREE_POISON
142	* If defined, it indicates that freed memory should be poisoned
143	* with the value it has.
144	*/
145	#if defined(VBOX_STRICT) \|\| defined(__DOXYGEN__)
146	# define MMHYPER_HEAP_FREE_POISON 0xCB
147	#endif
148
149	/**
150	* Hypervisor heap statistics record.
151	* There is one global and one per allocation tag.
152	*/
153	typedef struct MMHYPERSTAT
154	{
155	/** Core avl node, key is the tag.
156	* @todo The type is wrong! Get your lazy a$$ over and create that offsetted uint32_t version we need here! */
157	AVLOGCPHYSNODECORE Core;
158	/** Aligning the 64-bit fields on a 64-bit line. */
159	uint32_t u32Padding0;
160	/** Indicator for whether these statistics are registered with STAM or not. */
161	bool fRegistered;
162	/** Number of allocation. */
163	uint64_t cAllocations;
164	/** Number of frees. */
165	uint64_t cFrees;
166	/** Failures. */
167	uint64_t cFailures;
168	/** Number of bytes allocated (sum). */
169	uint64_t cbAllocated;
170	/** Number of bytes freed (sum). */
171	uint64_t cbFreed;
172	/** Number of bytes currently allocated. */
173	uint32_t cbCurAllocated;
174	/** Max number of bytes allocated. */
175	uint32_t cbMaxAllocated;
176	} MMHYPERSTAT;
177	/** Pointer to hypervisor heap statistics record. */
178	typedef MMHYPERSTAT *PMMHYPERSTAT;
179
180	/**
181	* Hypervisor heap chunk.
182	*/
183	typedef struct MMHYPERCHUNK
184	{
185	/** Previous block in the list of all blocks.
186	* This is relative to the start of the heap. */
187	uint32_t offNext;
188	/** Offset to the previous block relative to this one. */
189	int32_t offPrev;
190	/** The statistics record this allocation belongs to (self relative). */
191	int32_t offStat;
192	/** Offset to the heap block (self relative). */
193	int32_t offHeap;
194	} MMHYPERCHUNK;
195	/** Pointer to a hypervisor heap chunk. */
196	typedef MMHYPERCHUNK *PMMHYPERCHUNK;
197
198
199	/**
200	* Hypervisor heap chunk.
201	*/
202	typedef struct MMHYPERCHUNKFREE
203	{
204	/** Main list. */
205	MMHYPERCHUNK core;
206	/** Offset of the next chunk in the list of free nodes. */
207	uint32_t offNext;
208	/** Offset of the previous chunk in the list of free nodes. */
209	int32_t offPrev;
210	/** Size of the block. */
211	uint32_t cb;
212	} MMHYPERCHUNKFREE;
213	/** Pointer to a free hypervisor heap chunk. */
214	typedef MMHYPERCHUNKFREE *PMMHYPERCHUNKFREE;
215
216
217	/**
218	* The hypervisor heap.
219	*/
220	typedef struct MMHYPERHEAP
221	{
222	/** The typical magic (MMHYPERHEAP_MAGIC). */
223	uint32_t u32Magic;
224	/** The heap size. (This structure is not included!) */
225	uint32_t cbHeap;
226	/** The HC Ring-3 address of the VM. */
227	R3PTRTYPE(PVM) pVMHC;
228	/** The HC Ring-3 address of the heap. */
229	R3R0PTRTYPE(uint8_t *) pbHeapHC;
230	/** The GC address of the heap. */
231	GCPTRTYPE(uint8_t *) pbHeapGC;
232	/** The GC address of the VM. */
233	GCPTRTYPE(PVM) pVMGC;
234	/** The amount of free memory in the heap. */
235	uint32_t cbFree;
236	/** Offset of the first free chunk in the heap.
237	* The offset is relative to the start of the heap. */
238	uint32_t offFreeHead;
239	/** Offset of the last free chunk in the heap.
240	* The offset is relative to the start of the heap. */
241	uint32_t offFreeTail;
242	/** Offset of the first page aligned block in the heap.
243	* The offset is equal to cbHeap initially. */
244	uint32_t offPageAligned;
245	/** Tree of hypervisor heap statistics. */
246	AVLOGCPHYSTREE HyperHeapStatTree;
247	#ifdef MMHYPER_HEAP_FREE_DELAY
248	/** Where to insert the next free. */
249	uint32_t iDelayedFree;
250	/** Array of delayed frees. Circular. Offsets relative to this structure. */
251	struct
252	{
253	/** The free caller address. */
254	RTUINTPTR uCaller;
255	/** The offset of the freed chunk. */
256	uint32_t offChunk;
257	} aDelayedFrees[MMHYPER_HEAP_FREE_DELAY];
258	#else
259	/** Padding the structure to a 64-bit aligned size. */
260	uint32_t u32Padding0;
261	#endif
262	} MMHYPERHEAP;
263	/** Pointer to the hypervisor heap. */
264	typedef MMHYPERHEAP *PMMHYPERHEAP;
265
266	/** Magic value for MMHYPERHEAP. (C. S. Lewis) */
267	#define MMHYPERHEAP_MAGIC 0x18981129
268
269
270	/**
271	* Hypervisor heap minimum alignment (16 bytes).
272	*/
273	#define MMHYPER_HEAP_ALIGN_MIN 16
274
275	/**
276	* The aligned size of the the MMHYPERHEAP structure.
277	*/
278	#define MMYPERHEAP_HDR_SIZE RT_ALIGN_Z(sizeof(MMHYPERHEAP), MMHYPER_HEAP_ALIGN_MIN * 4)
279
280	/** @name Hypervisor heap chunk flags.
281	* The flags are put in the first bits of the MMHYPERCHUNK::offPrev member.
282	* These bits aren't used anyway because of the chunk minimal alignment (16 bytes).
283	* @{ */
284	/** The chunk is free. (The code ASSUMES this is 0!) */
285	#define MMHYPERCHUNK_FLAGS_FREE 0x0
286	/** The chunk is in use. */
287	#define MMHYPERCHUNK_FLAGS_USED 0x1
288	/** The type mask. */
289	#define MMHYPERCHUNK_FLAGS_TYPE_MASK 0x1
290	/** The flag mask */
291	#define MMHYPERCHUNK_FLAGS_MASK 0x1
292
293	/** Checks if the chunk is free. */
294	#define MMHYPERCHUNK_ISFREE(pChunk) ( (((pChunk)->offPrev) & MMHYPERCHUNK_FLAGS_TYPE_MASK) == MMHYPERCHUNK_FLAGS_FREE )
295	/** Checks if the chunk is used. */
296	#define MMHYPERCHUNK_ISUSED(pChunk) ( (((pChunk)->offPrev) & MMHYPERCHUNK_FLAGS_TYPE_MASK) == MMHYPERCHUNK_FLAGS_USED )
297	/** Toggles FREE/USED flag of a chunk. */
298	#define MMHYPERCHUNK_SET_TYPE(pChunk, type) do { (pChunk)->offPrev = ((pChunk)->offPrev & ~MMHYPERCHUNK_FLAGS_TYPE_MASK) \| ((type) & MMHYPERCHUNK_FLAGS_TYPE_MASK); } while (0)
299
300	/** Gets the prev offset without the flags. */
301	#define MMHYPERCHUNK_GET_OFFPREV(pChunk) ((int32_t)((pChunk)->offPrev & ~MMHYPERCHUNK_FLAGS_MASK))
302	/** Sets the prev offset without changing the flags. */
303	#define MMHYPERCHUNK_SET_OFFPREV(pChunk, off) do { (pChunk)->offPrev = (off) \| ((pChunk)->offPrev & MMHYPERCHUNK_FLAGS_MASK); } while (0)
304	#if 0
305	/** Clears one or more flags. */
306	#define MMHYPERCHUNK_FLAGS_OP_CLEAR(pChunk, fFlags) do { ((pChunk)->offPrev) &= ~((fFlags) & MMHYPERCHUNK_FLAGS_MASK); } while (0)
307	/** Sets one or more flags. */
308	#define MMHYPERCHUNK_FLAGS_OP_SET(pChunk, fFlags) do { ((pChunk)->offPrev) \|= ((fFlags) & MMHYPERCHUNK_FLAGS_MASK); } while (0)
309	/** Checks if one is set. */
310	#define MMHYPERCHUNK_FLAGS_OP_ISSET(pChunk, fFlag) (!!(((pChunk)->offPrev) & ((fFlag) & MMHYPERCHUNK_FLAGS_MASK)))
311	#endif
312	/** @} */
313
314	/** @} */
315
316
317	/** @name Page Pool Internals
318	* @{
319	*/
320
321	/**
322	* Page sub pool
323	*
324	* About the allocation of this structrue. To keep the number of heap blocks,
325	* the number of heap calls, and fragmentation low we allocate all the data
326	* related to a MMPAGESUBPOOL node in one chunk. That means that after the
327	* bitmap (which is of variable size) comes the SUPPAGE records and then
328	* follows the lookup tree nodes.
329	*/
330	typedef struct MMPAGESUBPOOL
331	{
332	/** Pointer to next sub pool. */
333	struct MMPAGESUBPOOL *pNext;
334	/** Pointer to next sub pool in the free chain.
335	* This is NULL if we're not in the free chain or at the end of it. */
336	struct MMPAGESUBPOOL *pNextFree;
337	/** Pointer to array of lock ranges.
338	* This is allocated together with the MMPAGESUBPOOL and thus needs no freeing.
339	* It follows immediately after the bitmap.
340	* The reserved field is a pointer to this structure.
341	*/
342	PSUPPAGE paPhysPages;
343	/** Pointer to the first page. */
344	void *pvPages;
345	/** Size of the subpool. */
346	unsigned cPages;
347	/** Number of free pages. */
348	unsigned cPagesFree;
349	/** The allocation bitmap.
350	* This may extend beyond the end of the defined array size.
351	*/
352	unsigned auBitmap[1];
353	/* ... SUPPAGE aRanges[1]; */
354	} MMPAGESUBPOOL;
355	/** Pointer to page sub pool. */
356	typedef MMPAGESUBPOOL *PMMPAGESUBPOOL;
357
358	/**
359	* Page pool.
360	*/
361	typedef struct MMPAGEPOOL
362	{
363	/** List of subpools. */
364	PMMPAGESUBPOOL pHead;
365	/** Head of subpools with free pages. */
366	PMMPAGESUBPOOL pHeadFree;
367	/** AVLPV tree for looking up HC virtual addresses.
368	* The tree contains MMLOOKUPVIRTPP records.
369	*/
370	PAVLPVNODECORE pLookupVirt;
371	/** Tree for looking up HC physical addresses.
372	* The tree contains MMLOOKUPPHYSHC records.
373	*/
374	AVLHCPHYSTREE pLookupPhys;
375	/** Pointer to the VM this pool belongs. */
376	PVM pVM;
377	/** Flag indicating the allocation method.
378	* Set: SUPLowAlloc().
379	* Clear: SUPPageAlloc() + SUPPageLock(). */
380	bool fLow;
381	/** Number of subpools. */
382	uint32_t cSubPools;
383	/** Number of pages in pool. */
384	uint32_t cPages;
385	#ifdef VBOX_WITH_STATISTICS
386	/** Number of free pages in pool. */
387	uint32_t cFreePages;
388	/** Number of alloc calls. */
389	STAMCOUNTER cAllocCalls;
390	/** Number of free calls. */
391	STAMCOUNTER cFreeCalls;
392	/** Number of to phys conversions. */
393	STAMCOUNTER cToPhysCalls;
394	/** Number of to virtual conversions. */
395	STAMCOUNTER cToVirtCalls;
396	/** Number of real errors. */
397	STAMCOUNTER cErrors;
398	#endif
399	} MMPAGEPOOL;
400	/** Pointer to page pool. */
401	typedef MMPAGEPOOL *PMMPAGEPOOL;
402
403	/**
404	* Lookup record for HC virtual memory in the page pool.
405	*/
406	typedef struct MMPPLOOKUPHCPTR
407	{
408	/** The key is virtual address. */
409	AVLPVNODECORE Core;
410	/** Pointer to subpool if lookup record for a pool. */
411	struct MMPAGESUBPOOL *pSubPool;
412	} MMPPLOOKUPHCPTR;
413	/** Pointer to virtual memory lookup record. */
414	typedef MMPPLOOKUPHCPTR *PMMPPLOOKUPHCPTR;
415
416	/**
417	* Lookup record for HC physical memory.
418	*/
419	typedef struct MMPPLOOKUPHCPHYS
420	{
421	/** The key is physical address. */
422	AVLHCPHYSNODECORE Core;
423	/** Pointer to SUPPAGE record for this physical address. */
424	PSUPPAGE pPhysPage;
425	} MMPPLOOKUPHCPHYS;
426	/** Pointer to physical memory lookup record. */
427	typedef MMPPLOOKUPHCPHYS *PMMPPLOOKUPHCPHYS;
428
429	/** @} */
430
431
432
433	/**
434	* Type of memory that's locked.
435	*/
436	typedef enum MMLOCKEDTYPE
437	{
438	/** Hypervisor: Ring-3 memory locked by MM. */
439	MM_LOCKED_TYPE_HYPER,
440	/** Hypervisor: Ring-3 memory locked by MM that shouldn't be freed up. */
441	MM_LOCKED_TYPE_HYPER_NOFREE,
442	/** Hypervisor: Pre-locked ring-3 pages. */
443	MM_LOCKED_TYPE_HYPER_PAGES,
444	/** Guest: Physical VM memory (RAM & MMIO2). */
445	MM_LOCKED_TYPE_PHYS
446	} MMLOCKEDTYPE;
447	/** Pointer to memory type. */
448	typedef MMLOCKEDTYPE *PMMLOCKEDTYPE;
449
450
451	/**
452	* Converts a SUPPAGE pointer to a MMLOCKEDMEM pointer.
453	* @returns Pointer to the MMLOCKEDMEM record the range is associated with.
454	* @param pSupPage Pointer to SUPPAGE structure managed by MM.
455	*/
456	#define MM_SUPRANGE_TO_MMLOCKEDMEM(pSupPage) ((PMMLOCKEDMEM)pSupPage->uReserved)
457
458
459	/**
460	* Locked memory record.
461	*/
462	typedef struct MMLOCKEDMEM
463	{
464	/** Address (host mapping). */
465	void *pv;
466	/** Size. */
467	size_t cb;
468	/** Next record. */
469	struct MMLOCKEDMEM *pNext;
470	/** Record type. */
471	MMLOCKEDTYPE eType;
472	/** Type specific data. */
473	union
474	{
475	/** Data for MM_LOCKED_TYPE_HYPER, MM_LOCKED_TYPE_HYPER_NOFREE and MM_LOCKED_TYPE_HYPER_PAGES. */
476	struct
477	{
478	unsigned uNothing;
479	} hyper;
480
481	/** Data for MM_LOCKED_TYPE_PHYS. */
482	struct
483	{
484	/** The GC physical address.
485	* (Assuming that this is a linear range of GC physical pages.)
486	*/
487	RTGCPHYS GCPhys;
488	} phys;
489	} u;
490
491	/** Physical Page Array. (Variable length.)
492	* The uReserved field contains pointer to the MMLOCKMEM record.
493	* Use the macro MM_SUPPAGE_TO_MMLOCKEDMEM() to convert.
494	*
495	* For MM_LOCKED_TYPE_PHYS the low 12 bits of the pvPhys member
496	* are bits (MM_RAM_FLAGS_*) and not part of the physical address.
497	*/
498	SUPPAGE aPhysPages[1];
499	} MMLOCKEDMEM;
500	/** Pointer to locked memory. */
501	typedef MMLOCKEDMEM *PMMLOCKEDMEM;
502
503
504	/**
505	* A registered Rom range.
506	*
507	* This is used to track ROM registrations both for debug reasons
508	* and for resetting shadow ROM at reset.
509	*
510	* This is allocated of the MMR3Heap and thus only accessibel from ring-3.
511	*/
512	typedef struct MMROMRANGE
513	{
514	/** Pointer to the next */
515	struct MMROMRANGE *pNext;
516	/** Address of the range. */
517	RTGCPHYS GCPhys;
518	/** Size of the range. */
519	uint32_t cbRange;
520	/** Shadow ROM? */
521	bool fShadow;
522	/** Is the shadow ROM currently wriable? */
523	bool fWritable;
524	/** The address of the virgin ROM image for shadow ROM. */
525	const void *pvBinary;
526	/** The address of the guest RAM that's shadowing the ROM. (lazy bird) */
527	void *pvCopy;
528	/** The ROM description. */
529	const char *pszDesc;
530	} MMROMRANGE;
531	/** Pointer to a ROM range. */
532	typedef MMROMRANGE *PMMROMRANGE;
533
534
535	/**
536	* Hypervisor memory mapping type.
537	*/
538	typedef enum MMLOOKUPHYPERTYPE
539	{
540	/** Invalid record. This is used for record which are incomplete. */
541	MMLOOKUPHYPERTYPE_INVALID = 0,
542	/** Mapping of locked memory. */
543	MMLOOKUPHYPERTYPE_LOCKED,
544	/** Mapping of contiguous HC physical memory. */
545	MMLOOKUPHYPERTYPE_HCPHYS,
546	/** Mapping of contiguous GC physical memory. */
547	MMLOOKUPHYPERTYPE_GCPHYS,
548	/** Dynamic mapping area (MMR3HyperReserve).
549	* A conversion will require to check what's in the page table for the pages. */
550	MMLOOKUPHYPERTYPE_DYNAMIC
551	} MMLOOKUPHYPERTYPE;
552
553	/**
554	* Lookup record for the hypervisor memory area.
555	*/
556	typedef struct MMLOOKUPHYPER
557	{
558	/** Byte offset from the start of this record to the next.
559	* If the value is NIL_OFFSET the chain is terminated. */
560	int32_t offNext;
561	/** Offset into the hypvervisor memory area. */
562	uint32_t off;
563	/** Size of this part. */
564	uint32_t cb;
565	/** Locking type. */
566	MMLOOKUPHYPERTYPE enmType;
567	/** Type specific data */
568	union
569	{
570	/** Locked memory. */
571	struct
572	{
573	/** Host context pointer. */
574	R3PTRTYPE(void *) pvHC;
575	/** Host context ring-0 pointer. */
576	RTR0PTR pvR0;
577	/** Pointer to the locked mem record. */
578	R3PTRTYPE(PMMLOCKEDMEM) pLockedMem;
579	} Locked;
580
581	/** Contiguous physical memory. */
582	struct
583	{
584	/** Host context pointer. */
585	R3PTRTYPE(void *) pvHC;
586	/** HC physical address corresponding to pvHC. */
587	RTHCPHYS HCPhys;
588	} HCPhys;
589	/** Contiguous guest physical memory. */
590	struct
591	{
592	/** HC physical address corresponding to pvHC. */
593	RTGCPHYS GCPhys;
594	} GCPhys;
595	} u;
596	/** Description. */
597	R3PTRTYPE(const char *) pszDesc;
598	} MMLOOKUPHYPER;
599	/** Pointer to a hypervisor memory lookup record. */
600	typedef MMLOOKUPHYPER *PMMLOOKUPHYPER;
601
602
603	/**
604	* Converts a MM pointer into a VM pointer.
605	* @returns Pointer to the VM structure the MM is part of.
606	* @param pMM Pointer to MM instance data.
607	*/
608	#define MM2VM(pMM) ( (PVM)((char*)pMM - pMM->offVM) )
609
610
611	/**
612	* MM Data (part of VM)
613	*/
614	typedef struct MM
615	{
616	/** Offset to the VM structure.
617	* See MM2VM(). */
618	RTINT offVM;
619
620	/** Set if PGM has been initialized and we can safely call PGMR3Map(). */
621	bool fPGMInitialized;
622	#if GC_ARCH_BITS == 64 \|\| HC_ARCH_BITS == 64
623	uint32_t u32Padding1; /*< alignment padding. /
624	#endif
625
626	/** Lookup list for the Hypervisor Memory Area.
627	* The offset is relative to the start of the heap.
628	* Use pHyperHeapHC or pHyperHeapGC to calculate the address.
629	*/
630	RTUINT offLookupHyper;
631
632	/** The offset of the next static mapping in the Hypervisor Memory Area. */
633	RTUINT offHyperNextStatic;
634	/** The size of the HMA.
635	* Starts at 12MB and will be fixed late in the init process. */
636	RTUINT cbHyperArea;
637
638	/** Guest address of the Hypervisor Memory Area. */
639	RTGCPTR pvHyperAreaGC;
640
641	/** The hypervisor heap (GC Ptr). */
642	GCPTRTYPE(PMMHYPERHEAP) pHyperHeapGC;
643	/** The hypervisor heap (HC Ptr). */
644	R3R0PTRTYPE(PMMHYPERHEAP) pHyperHeapHC;
645
646	/** List of memory locks. (HC only) */
647	R3PTRTYPE(PMMLOCKEDMEM) pLockedMem;
648
649	/** Page pool. (HC only) */
650	R3R0PTRTYPE(PMMPAGEPOOL) pPagePool;
651	/** Page pool pages in low memory. (HC only) */
652	R3R0PTRTYPE(PMMPAGEPOOL) pPagePoolLow;
653
654	/** Pointer to the dummy page.
655	* The dummy page is a paranoia thingy used for instance for pure MMIO RAM ranges
656	* to make sure any bugs will not harm whatever the system stores in the first
657	* physical page. */
658	R3PTRTYPE(void *) pvDummyPage;
659	/** Physical address of the dummy page. */
660	RTHCPHYS HCPhysDummyPage;
661
662	/** Size of the currently allocated guest RAM.
663	* Mark that this is the actual size, not the end address. */
664	RTUINT cbRAMSize;
665	/** Size of the base RAM in bytes. */
666	RTUINT cbRamBase;
667	/** Pointer to the base RAM. */
668	R3PTRTYPE(void *) pvRamBaseHC;
669	/** The head of the ROM ranges. */
670	R3PTRTYPE(PMMROMRANGE) pRomHead;
671
672	/** Pointer to the MM R3 Heap. */
673	R3PTRTYPE(PMMHEAP) pHeap;
674
675	} MM;
676	/** Pointer to MM Data (part of VM). */
677	typedef MM *PMM;
678
679	__BEGIN_DECLS
680
681
682	int mmR3PagePoolInit(PVM pVM);
683	void mmR3PagePoolTerm(PVM pVM);
684
685	int mmR3HeapCreate(PVM pVM, PMMHEAP *ppHeap);
686	void mmR3HeapDestroy(PMMHEAP pHeap);
687
688	int mmR3HyperInit(PVM pVM);
689	int mmR3HyperInitPaging(PVM pVM);
690
691	int mmR3LockMem(PVM pVM, void pv, size_t cb, MMLOCKEDTYPE eType, PMMLOCKEDMEM ppLockedMem, bool fSilentFailure);
692	int mmR3MapLocked(PVM pVM, PMMLOCKEDMEM pLockedMem, RTGCPTR Addr, unsigned iPage, size_t cPages, unsigned fFlags);
693
694	const char *mmR3GetTagName(MMTAG enmTag);
695
696	void mmR3PhysRomReset(PVM pVM);
697
698	/**
699	* Converts a pool address to a physical address.
700	* The specified allocation type must match with the address.
701	*
702	* @returns Physical address.
703	* @returns NIL_RTHCPHYS if not found or eType is not matching.
704	* @param pPool Pointer to the page pool.
705	* @param pv The address to convert.
706	* @thread The Emulation Thread.
707	*/
708	MMDECL(RTHCPHYS) mmPagePoolPtr2Phys(PMMPAGEPOOL pPool, void *pv);
709
710	/**
711	* Converts a pool physical address to a linear address.
712	* The specified allocation type must match with the address.
713	*
714	* @returns Physical address.
715	* @returns NULL if not found or eType is not matching.
716	* @param pPool Pointer to the page pool.
717	* @param HCPhys The address to convert.
718	* @thread The Emulation Thread.
719	*/
720	MMDECL(void *) mmPagePoolPhys2Ptr(PMMPAGEPOOL pPool, RTHCPHYS HCPhys);
721
722	__END_DECLS
723
724	/** @} */
725
726	#endif

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/src/VBox/VMM/MMInternal.h@ 6529

Download in other formats: