VirtualBox

source: vbox/trunk/include/VBox/vmm.h@ 19469

Last change on this file since 19469 was 19468, checked in by vboxsync, 16 years ago

VMM: better SIPI sending, reschedule to R3 as needed

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 11.5 KB
Line 
1/** @file
2 * VMM - The Virtual Machine Monitor.
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_vmm_h
31#define ___VBox_vmm_h
32
33#include <VBox/cdefs.h>
34#include <VBox/types.h>
35#include <VBox/vmapi.h>
36#include <VBox/sup.h>
37#include <iprt/stdarg.h>
38
39__BEGIN_DECLS
40
41/** @defgroup grp_vmm The Virtual Machine Monitor API
42 * @{
43 */
44
45/**
46 * World switcher identifiers.
47 */
48typedef enum VMMSWITCHER
49{
50 /** The usual invalid 0. */
51 VMMSWITCHER_INVALID = 0,
52 /** Switcher for 32-bit host to 32-bit shadow paging. */
53 VMMSWITCHER_32_TO_32,
54 /** Switcher for 32-bit host paging to PAE shadow paging. */
55 VMMSWITCHER_32_TO_PAE,
56 /** Switcher for 32-bit host paging to AMD64 shadow paging. */
57 VMMSWITCHER_32_TO_AMD64,
58 /** Switcher for PAE host to 32-bit shadow paging. */
59 VMMSWITCHER_PAE_TO_32,
60 /** Switcher for PAE host to PAE shadow paging. */
61 VMMSWITCHER_PAE_TO_PAE,
62 /** Switcher for PAE host paging to AMD64 shadow paging. */
63 VMMSWITCHER_PAE_TO_AMD64,
64 /** Switcher for AMD64 host paging to 32-bit shadow paging. */
65 VMMSWITCHER_AMD64_TO_32,
66 /** Switcher for AMD64 host paging to PAE shadow paging. */
67 VMMSWITCHER_AMD64_TO_PAE,
68 /** Switcher for AMD64 host paging to AMD64 shadow paging. */
69 VMMSWITCHER_AMD64_TO_AMD64,
70 /** Used to make a count for array declarations and suchlike. */
71 VMMSWITCHER_MAX,
72 /** The usual 32-bit paranoia. */
73 VMMSWITCHER_32BIT_HACK = 0x7fffffff
74} VMMSWITCHER;
75
76
77/**
78 * VMMGCCallHost operations.
79 */
80typedef enum VMMCALLHOST
81{
82 /** Invalid operation. */
83 VMMCALLHOST_INVALID = 0,
84 /** Acquire the PDM lock. */
85 VMMCALLHOST_PDM_LOCK,
86 /** Call PDMR3QueueFlushWorker. */
87 VMMCALLHOST_PDM_QUEUE_FLUSH,
88 /** Acquire the PGM lock. */
89 VMMCALLHOST_PGM_LOCK,
90 /** Grow the PGM shadow page pool. */
91 VMMCALLHOST_PGM_POOL_GROW,
92 /** Maps a chunk into ring-3. */
93 VMMCALLHOST_PGM_MAP_CHUNK,
94 /** Allocates more handy pages. */
95 VMMCALLHOST_PGM_ALLOCATE_HANDY_PAGES,
96 /** Replay the REM handler notifications. */
97 VMMCALLHOST_REM_REPLAY_HANDLER_NOTIFICATIONS,
98 /** Flush the GC/R0 logger. */
99 VMMCALLHOST_VMM_LOGGER_FLUSH,
100 /** Set the VM error message. */
101 VMMCALLHOST_VM_SET_ERROR,
102 /** Set the VM runtime error message. */
103 VMMCALLHOST_VM_SET_RUNTIME_ERROR,
104 /** Signal a ring 0 assertion. */
105 VMMCALLHOST_VM_R0_ASSERTION,
106 /** Ring switch to force preemption. */
107 VMMCALLHOST_VM_R0_PREEMPT,
108 /** The usual 32-bit hack. */
109 VMMCALLHOST_32BIT_HACK = 0x7fffffff
110} VMMCALLHOST;
111
112VMMDECL(RTRCPTR) VMMGetStackRC(PVM pVM);
113VMMDECL(VMCPUID) VMMGetCpuId(PVM pVM);
114VMMDECL(PVMCPU) VMMGetCpu(PVM pVM);
115VMMDECL(PVMCPU) VMMGetCpu0(PVM pVM);
116VMMDECL(PVMCPU) VMMGetCpuById(PVM pVM, VMCPUID idCpu);
117VMMDECL(uint32_t) VMMGetSvnRev(void);
118VMMDECL(VMMSWITCHER) VMMGetSwitcher(PVM pVM);
119
120/** @def VMMIsHwVirtExtForced
121 * Checks if forced to use the hardware assisted virtualization extensions.
122 *
123 * This is intended for making setup decisions where we can save resources when
124 * using hardware assisted virtualization.
125 *
126 * @returns true / false.
127 * @param pVM Pointer to the shared VM structure. */
128#define VMMIsHwVirtExtForced(pVM) ((pVM)->fHwVirtExtForced)
129
130
131#ifdef IN_RING3
132/** @defgroup grp_vmm_r3 The VMM Host Context Ring 3 API
133 * @ingroup grp_vmm
134 * @{
135 */
136VMMR3DECL(int) VMMR3Init(PVM pVM);
137VMMR3DECL(int) VMMR3InitCPU(PVM pVM);
138VMMR3DECL(int) VMMR3InitFinalize(PVM pVM);
139VMMR3DECL(int) VMMR3InitR0(PVM pVM);
140VMMR3DECL(int) VMMR3InitRC(PVM pVM);
141VMMR3DECL(int) VMMR3Term(PVM pVM);
142VMMR3DECL(int) VMMR3TermCPU(PVM pVM);
143VMMR3DECL(void) VMMR3Relocate(PVM pVM, RTGCINTPTR offDelta);
144VMMR3DECL(int) VMMR3UpdateLoggers(PVM pVM);
145VMMR3DECL(const char *) VMMR3GetRZAssertMsg1(PVM pVM);
146VMMR3DECL(const char *) VMMR3GetRZAssertMsg2(PVM pVM);
147VMMR3DECL(int) VMMR3GetImportRC(PVM pVM, const char *pszSymbol, PRTRCPTR pRCPtrValue);
148VMMR3DECL(int) VMMR3SelectSwitcher(PVM pVM, VMMSWITCHER enmSwitcher);
149VMMR3DECL(int) VMMR3DisableSwitcher(PVM pVM);
150VMMR3DECL(RTR0PTR) VMMR3GetHostToGuestSwitcher(PVM pVM, VMMSWITCHER enmSwitcher);
151VMMR3DECL(int) VMMR3RawRunGC(PVM pVM, PVMCPU pVCpu);
152VMMR3DECL(int) VMMR3HwAccRunGC(PVM pVM, PVMCPU pVCpu);
153VMMR3DECL(int) VMMR3CallRC(PVM pVM, RTRCPTR RCPtrEntry, unsigned cArgs, ...);
154VMMR3DECL(int) VMMR3CallRCV(PVM pVM, RTRCPTR RCPtrEntry, unsigned cArgs, va_list args);
155VMMR3DECL(int) VMMR3CallR0(PVM pVM, uint32_t uOperation, uint64_t u64Arg, PSUPVMMR0REQHDR pReqHdr);
156VMMR3DECL(int) VMMR3ResumeHyper(PVM pVM, PVMCPU pVCpu);
157VMMR3DECL(void) VMMR3FatalDump(PVM pVM, PVMCPU pVCpu, int rcErr);
158VMMR3DECL(void) VMMR3YieldSuspend(PVM pVM);
159VMMR3DECL(void) VMMR3YieldStop(PVM pVM);
160VMMR3DECL(void) VMMR3YieldResume(PVM pVM);
161VMMR3DECL(void) VMMR3SendSipi(PVM pVM, VMCPUID idCpu, uint32_t uVector);
162/** @} */
163#endif /* IN_RING3 */
164
165
166/** @defgroup grp_vmm_r0 The VMM Host Context Ring 0 API
167 * @ingroup grp_vmm
168 * @{
169 */
170
171/**
172 * The VMMR0Entry() codes.
173 */
174typedef enum VMMR0OPERATION
175{
176 /** Run guest context. */
177 VMMR0_DO_RAW_RUN = SUP_VMMR0_DO_RAW_RUN,
178 /** Run guest code using the available hardware acceleration technology. */
179 VMMR0_DO_HWACC_RUN = SUP_VMMR0_DO_HWACC_RUN,
180 /** Official NOP that we use for profiling. */
181 VMMR0_DO_NOP = SUP_VMMR0_DO_NOP,
182 /** Official slow iocl NOP that we use for profiling. */
183 VMMR0_DO_SLOW_NOP,
184
185 /** Ask the GVMM to create a new VM. */
186 VMMR0_DO_GVMM_CREATE_VM,
187 /** Ask the GVMM to destroy the VM. */
188 VMMR0_DO_GVMM_DESTROY_VM,
189 /** Call GVMMR0SchedHalt(). */
190 VMMR0_DO_GVMM_SCHED_HALT,
191 /** Call GVMMR0SchedWakeUp(). */
192 VMMR0_DO_GVMM_SCHED_WAKE_UP,
193 /** Call GVMMR0SchedPoke(). */
194 VMMR0_DO_GVMM_SCHED_POKE,
195 /** Call GVMMR0SchedWakeUpAndPokeCpus(). */
196 VMMR0_DO_GVMM_SCHED_WAKE_UP_AND_POKE_CPUS,
197 /** Call GVMMR0SchedPoll(). */
198 VMMR0_DO_GVMM_SCHED_POLL,
199 /** Call GVMMR0QueryStatistics(). */
200 VMMR0_DO_GVMM_QUERY_STATISTICS,
201 /** Call GVMMR0ResetStatistics(). */
202 VMMR0_DO_GVMM_RESET_STATISTICS,
203 /** Call GVMMR0RegisterVCpu(). */
204 VMMR0_DO_GVMM_REGISTER_VMCPU,
205
206 /** Call VMMR0 Per VM Init. */
207 VMMR0_DO_VMMR0_INIT,
208 /** Call VMMR0 Per VM Termination. */
209 VMMR0_DO_VMMR0_TERM,
210 /** Setup the hardware accelerated raw-mode session. */
211 VMMR0_DO_HWACC_SETUP_VM,
212 /** Attempt to enable or disable hardware accelerated raw-mode. */
213 VMMR0_DO_HWACC_ENABLE,
214 /** Calls function in the hypervisor.
215 * The caller must setup the hypervisor context so the call will be performed.
216 * The difference between VMMR0_DO_RUN_GC and this one is the handling of
217 * the return GC code. The return code will not be interpreted by this operation.
218 */
219 VMMR0_DO_CALL_HYPERVISOR,
220
221 /** Call PGMR0PhysAllocateHandyPages(). */
222 VMMR0_DO_PGM_ALLOCATE_HANDY_PAGES,
223
224 /** Call GMMR0InitialReservation(). */
225 VMMR0_DO_GMM_INITIAL_RESERVATION,
226 /** Call GMMR0UpdateReservation(). */
227 VMMR0_DO_GMM_UPDATE_RESERVATION,
228 /** Call GMMR0AllocatePages(). */
229 VMMR0_DO_GMM_ALLOCATE_PAGES,
230 /** Call GMMR0FreePages(). */
231 VMMR0_DO_GMM_FREE_PAGES,
232 /** Call GMMR0BalloonedPages(). */
233 VMMR0_DO_GMM_BALLOONED_PAGES,
234 /** Call GMMR0DeflatedBalloon(). */
235 VMMR0_DO_GMM_DEFLATED_BALLOON,
236 /** Call GMMR0MapUnmapChunk(). */
237 VMMR0_DO_GMM_MAP_UNMAP_CHUNK,
238 /** Call GMMR0SeedChunk(). */
239 VMMR0_DO_GMM_SEED_CHUNK,
240
241 /** Set a GVMM or GMM configuration value. */
242 VMMR0_DO_GCFGM_SET_VALUE,
243 /** Query a GVMM or GMM configuration value. */
244 VMMR0_DO_GCFGM_QUERY_VALUE,
245
246 /** The start of the R0 service operations. */
247 VMMR0_DO_SRV_START,
248 /** Call INTNETR0Open(). */
249 VMMR0_DO_INTNET_OPEN,
250 /** Call INTNETR0IfClose(). */
251 VMMR0_DO_INTNET_IF_CLOSE,
252 /** Call INTNETR0IfGetRing3Buffer(). */
253 VMMR0_DO_INTNET_IF_GET_RING3_BUFFER,
254 /** Call INTNETR0IfSetPromiscuousMode(). */
255 VMMR0_DO_INTNET_IF_SET_PROMISCUOUS_MODE,
256 /** Call INTNETR0IfSetMacAddress(). */
257 VMMR0_DO_INTNET_IF_SET_MAC_ADDRESS,
258 /** Call INTNETR0IfSetActive(). */
259 VMMR0_DO_INTNET_IF_SET_ACTIVE,
260 /** Call INTNETR0IfSend(). */
261 VMMR0_DO_INTNET_IF_SEND,
262 /** Call INTNETR0IfWait(). */
263 VMMR0_DO_INTNET_IF_WAIT,
264 /** The end of the R0 service operations. */
265 VMMR0_DO_SRV_END,
266
267 /** Official call we use for testing Ring-0 APIs. */
268 VMMR0_DO_TESTS,
269 /** Test the 32->64 bits switcher. */
270 VMMR0_DO_TEST_SWITCHER3264,
271
272 /** The usual 32-bit type blow up. */
273 VMMR0_DO_32BIT_HACK = 0x7fffffff
274} VMMR0OPERATION;
275
276
277/**
278 * Request buffer for VMMR0_DO_GCFGM_SET_VALUE and VMMR0_DO_GCFGM_QUERY_VALUE.
279 * @todo Move got GCFGM.h when it's implemented.
280 */
281typedef struct GCFGMVALUEREQ
282{
283 /** The request header.*/
284 SUPVMMR0REQHDR Hdr;
285 /** The support driver session handle. */
286 PSUPDRVSESSION pSession;
287 /** The value.
288 * This is input for the set request and output for the query. */
289 uint64_t u64Value;
290 /** The variable name.
291 * This is fixed sized just to make things simple for the mock-up. */
292 char szName[48];
293} GCFGMVALUEREQ;
294/** Pointer to a VMMR0_DO_GCFGM_SET_VALUE and VMMR0_DO_GCFGM_QUERY_VALUE request buffer.
295 * @todo Move got GCFGM.h when it's implemented.
296 */
297typedef GCFGMVALUEREQ *PGCFGMVALUEREQ;
298
299VMMR0DECL(int) VMMR0EntryInt(PVM pVM, VMMR0OPERATION enmOperation, void *pvArg);
300VMMR0DECL(void) VMMR0EntryFast(PVM pVM, VMCPUID idCpu, VMMR0OPERATION enmOperation);
301VMMR0DECL(int) VMMR0EntryEx(PVM pVM, VMCPUID idCpu, VMMR0OPERATION enmOperation, PSUPVMMR0REQHDR pReq, uint64_t u64Arg, PSUPDRVSESSION);
302VMMR0DECL(int) VMMR0TermVM(PVM pVM, PGVM pGVM);
303VMMR0DECL(int) VMMR0CallHost(PVM pVM, VMMCALLHOST enmOperation, uint64_t uArg);
304VMMR0DECL(void) VMMR0LogFlushDisable(PVMCPU pVCpu);
305VMMR0DECL(void) VMMR0LogFlushEnable(PVMCPU pVCpu);
306
307/** @} */
308
309
310#ifdef IN_RC
311/** @defgroup grp_vmm_rc The VMM Raw-Mode Context API
312 * @ingroup grp_vmm
313 * @{
314 */
315VMMRCDECL(int) VMMGCEntry(PVM pVM, unsigned uOperation, unsigned uArg, ...);
316VMMRCDECL(void) VMMGCGuestToHost(PVM pVM, int rc);
317VMMRCDECL(int) VMMGCCallHost(PVM pVM, VMMCALLHOST enmOperation, uint64_t uArg);
318VMMRCDECL(bool) VMMGCLogDisable(PVM pVM);
319VMMRCDECL(void) VMMGCLogRestore(PVM pVM, bool fLog);
320VMMRCDECL(void) VMMGCLogFlushIfFull(PVM pVM);
321/** @} */
322#endif /* IN_RC */
323
324
325/** @} */
326__END_DECLS
327
328#endif
329
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