VirtualBox

source: vbox/trunk/include/VBox/param.h@ 18618

Last change on this file since 18618 was 18617, checked in by vboxsync, 16 years ago

PGM,EM: Handle out of memory situations more gracefully - part 1. New debugger commands: .pgmerror and .pgmerroroff.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 4.5 KB
Line 
1/** @file
2 * VirtualBox Parameter Definitions.
3 */
4
5/*
6 * Copyright (C) 2006-2007 Sun Microsystems, Inc.
7 *
8 * This file is part of VirtualBox Open Source Edition (OSE), as
9 * available from http://www.virtualbox.org. This file is free software;
10 * you can redistribute it and/or modify it under the terms of the GNU
11 * General Public License (GPL) as published by the Free Software
12 * Foundation, in version 2 as it comes in the "COPYING" file of the
13 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15 *
16 * The contents of this file may alternatively be used under the terms
17 * of the Common Development and Distribution License Version 1.0
18 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
19 * VirtualBox OSE distribution, in which case the provisions of the
20 * CDDL are applicable instead of those of the GPL.
21 *
22 * You may elect to license modified versions of this file under the
23 * terms and conditions of either the GPL or the CDDL or both.
24 *
25 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
26 * Clara, CA 95054 USA or visit http://www.sun.com if you need
27 * additional information or have any questions.
28 */
29
30#ifndef ___VBox_param_h
31#define ___VBox_param_h
32
33#include <iprt/param.h>
34#include <iprt/cdefs.h>
35
36
37/** @defgroup grp_vbox_param VBox Parameter Definition
38 * @{
39 */
40
41/** The maximum number of pages that can be allocated and mapped
42 * by various MM, PGM and SUP APIs. */
43#define VBOX_MAX_ALLOC_PAGE_COUNT (128U * _1M / PAGE_SIZE)
44
45
46/** @defgroup grp_vbox_param_mm Memory Monitor Parameters
47 * @ingroup grp_vbox_param
48 * @{
49 */
50/** Initial address of Hypervisor Memory Area.
51 * MUST BE PAGE TABLE ALIGNED! */
52#define MM_HYPER_AREA_ADDRESS UINT32_C(0xa0000000)
53
54/** The max size of the hypervisor memory area. */
55#define MM_HYPER_AREA_MAX_SIZE (40U * _1M) /**< @todo Readjust when floating RAMRANGEs have been implemented. Used to be 20 * _1MB */
56
57/** Maximum number of bytes we can dynamically map into the hypervisor region.
58 * This must be a power of 2 number of pages!
59 */
60#define MM_HYPER_DYNAMIC_SIZE (16U * PAGE_SIZE)
61
62/** The minimum guest RAM size in bytes. */
63#define MM_RAM_MIN UINT32_C(0x00400000)
64/** The maximum guest RAM size in bytes. */
65#if HC_ARCH_BITS == 64 && defined(VBOX_WITH_NEW_PHYS_CODE)
66# define MM_RAM_MAX UINT64_C(0x400000000)
67#else
68# define MM_RAM_MAX UINT64_C(0x0E0000000)
69#endif
70/** The minimum guest RAM size in MBs. */
71#define MM_RAM_MIN_IN_MB UINT32_C(4)
72/** The maximum guest RAM size in MBs. */
73#if HC_ARCH_BITS == 64 && defined(VBOX_WITH_NEW_PHYS_CODE)
74# define MM_RAM_MAX_IN_MB UINT32_C(16384)
75#else
76# define MM_RAM_MAX_IN_MB UINT32_C(3584)
77#endif
78/** The default size of the below 4GB RAM hole. */
79#define MM_RAM_HOLE_SIZE_DEFAULT (512U * _1M)
80/** @} */
81
82
83/** @defgroup grp_vbox_param_pgm Page Manager Parameters
84 * @ingroup grp_vbox_param
85 * @{
86 */
87/** The number of handy pages.
88 * This should be a power of two. */
89#define PGM_HANDY_PAGES 128
90/** The threshold at which allocation of more handy pages is flagged. */
91#define PGM_HANDY_PAGES_SET_FF 32
92/** The threshold at which we will allocate more when in ring-3.
93 * This is must be smaller than both PGM_HANDY_PAGES_SET_FF and
94 * PGM_HANDY_PAGES_MIN. */
95#define PGM_HANDY_PAGES_R3_ALLOC 8
96/** The threshold at which we will allocate more when in ring-0 or raw mode.
97 * The idea is that we should never go below this threshold while in ring-0 or
98 * raw mode because of PGM_HANDY_PAGES_RZ_TO_R3. However, should this happen and
99 * we are actually out of memory, we will have 8 page to get out of whatever
100 * code we're executing.
101 *
102 * This is must be smaller than both PGM_HANDY_PAGES_SET_FF and
103 * PGM_HANDY_PAGES_MIN. */
104#define PGM_HANDY_PAGES_RZ_ALLOC 8
105/** The threshold at which we force return to R3 ASAP.
106 * The idea is that this should be large enough to get out of any code and up to
107 * the main EM loop when we are out of memory.
108 * This must be less or equal to PGM_HANDY_PAGES_MIN. */
109#define PGM_HANDY_PAGES_RZ_TO_R3 24
110/** The minimum number of handy pages (after allocation).
111 * This must be greater or equal to PGM_HANDY_PAGES_SET_FF.
112 * Another name would be PGM_HANDY_PAGES_EXTRA_RESERVATION or _PARANOIA. :-) */
113#define PGM_HANDY_PAGES_MIN 32
114/** @} */
115
116
117/** @defgroup grp_vbox_param_vmm VMM Parameters
118 * @ingroup grp_vbox_param
119 * @{
120 */
121/** VMM stack size. */
122#define VMM_STACK_SIZE 8192U
123/** @} */
124
125
126/** @} */
127
128#endif
129
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette