[1] | 1 | /** @file
|
---|
| 2 | * VMM - The Virtual Machine Monitor.
|
---|
| 3 | */
|
---|
| 4 |
|
---|
| 5 | /*
|
---|
[8155] | 6 | * Copyright (C) 2006-2007 Sun Microsystems, Inc.
|
---|
[1] | 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
|
---|
[5999] | 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.
|
---|
[8155] | 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.
|
---|
[1] | 28 | */
|
---|
| 29 |
|
---|
[3632] | 30 | #ifndef ___VBox_vmm_h
|
---|
| 31 | #define ___VBox_vmm_h
|
---|
[1] | 32 |
|
---|
| 33 | #include <VBox/cdefs.h>
|
---|
| 34 | #include <VBox/types.h>
|
---|
| 35 | #include <VBox/vmapi.h>
|
---|
[4811] | 36 | #include <VBox/sup.h>
|
---|
[321] | 37 | #include <iprt/stdarg.h>
|
---|
[1] | 38 |
|
---|
| 39 | __BEGIN_DECLS
|
---|
| 40 |
|
---|
| 41 | /** @defgroup grp_vmm The Virtual Machine Monitor API
|
---|
| 42 | * @{
|
---|
| 43 | */
|
---|
| 44 |
|
---|
| 45 | /**
|
---|
| 46 | * World switcher identifiers.
|
---|
| 47 | */
|
---|
| 48 | typedef 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 PAE shadow paging. */
|
---|
| 65 | VMMSWITCHER_AMD64_TO_PAE,
|
---|
| 66 | /** Switcher for AMD64 host paging to AMD64 shadow paging. */
|
---|
| 67 | VMMSWITCHER_AMD64_TO_AMD64,
|
---|
| 68 | /** Used to make a count for array declarations and suchlike. */
|
---|
| 69 | VMMSWITCHER_MAX,
|
---|
| 70 | /** The usual 32-bit paranoia. */
|
---|
| 71 | VMMSWITCHER_32BIT_HACK = 0x7fffffff
|
---|
| 72 | } VMMSWITCHER;
|
---|
| 73 |
|
---|
| 74 |
|
---|
| 75 | /**
|
---|
| 76 | * VMMGCCallHost operations.
|
---|
| 77 | */
|
---|
| 78 | typedef enum VMMCALLHOST
|
---|
| 79 | {
|
---|
| 80 | /** Invalid operation. */
|
---|
| 81 | VMMCALLHOST_INVALID = 0,
|
---|
| 82 | /** Acquire the PDM lock. */
|
---|
| 83 | VMMCALLHOST_PDM_LOCK,
|
---|
| 84 | /** Call PDMR3QueueFlushWorker. */
|
---|
| 85 | VMMCALLHOST_PDM_QUEUE_FLUSH,
|
---|
| 86 | /** Acquire the PGM lock. */
|
---|
| 87 | VMMCALLHOST_PGM_LOCK,
|
---|
| 88 | /** Grow the PGM shadow page pool. */
|
---|
| 89 | VMMCALLHOST_PGM_POOL_GROW,
|
---|
[4689] | 90 | /** Maps a chunk into ring-3. */
|
---|
| 91 | VMMCALLHOST_PGM_MAP_CHUNK,
|
---|
[4738] | 92 | /** Allocates more handy pages. */
|
---|
| 93 | VMMCALLHOST_PGM_ALLOCATE_HANDY_PAGES,
|
---|
[6528] | 94 | #ifndef VBOX_WITH_NEW_PHYS_CODE
|
---|
[1] | 95 | /** Dynamically allocate physical guest RAM. */
|
---|
| 96 | VMMCALLHOST_PGM_RAM_GROW_RANGE,
|
---|
[4799] | 97 | #endif
|
---|
[1] | 98 | /** Replay the REM handler notifications. */
|
---|
| 99 | VMMCALLHOST_REM_REPLAY_HANDLER_NOTIFICATIONS,
|
---|
| 100 | /** Flush the GC/R0 logger. */
|
---|
| 101 | VMMCALLHOST_VMM_LOGGER_FLUSH,
|
---|
| 102 | /** Set the VM error message. */
|
---|
| 103 | VMMCALLHOST_VM_SET_ERROR,
|
---|
[234] | 104 | /** Set the VM runtime error message. */
|
---|
| 105 | VMMCALLHOST_VM_SET_RUNTIME_ERROR,
|
---|
[4917] | 106 | /** Signal a ring 0 hypervisor assertion. */
|
---|
| 107 | VMMCALLHOST_VM_R0_HYPER_ASSERTION,
|
---|
[1] | 108 | /** The usual 32-bit hack. */
|
---|
| 109 | VMMCALLHOST_32BIT_HACK = 0x7fffffff
|
---|
| 110 | } VMMCALLHOST;
|
---|
| 111 |
|
---|
| 112 |
|
---|
| 113 |
|
---|
| 114 | /**
|
---|
| 115 | * Gets the bottom of the hypervisor stack - GC Ptr.
|
---|
| 116 | * I.e. the returned address is not actually writable.
|
---|
| 117 | *
|
---|
| 118 | * @returns bottom of the stack.
|
---|
| 119 | * @param pVM The VM handle.
|
---|
| 120 | */
|
---|
| 121 | RTGCPTR VMMGetStackGC(PVM pVM);
|
---|
| 122 |
|
---|
| 123 | /**
|
---|
| 124 | * Gets the bottom of the hypervisor stack - HC Ptr.
|
---|
| 125 | * I.e. the returned address is not actually writable.
|
---|
| 126 | *
|
---|
| 127 | * @returns bottom of the stack.
|
---|
| 128 | * @param pVM The VM handle.
|
---|
| 129 | */
|
---|
| 130 | RTHCPTR VMMGetHCStack(PVM pVM);
|
---|
| 131 |
|
---|
| 132 |
|
---|
| 133 |
|
---|
| 134 | #ifdef IN_RING3
|
---|
| 135 | /** @defgroup grp_vmm_r3 The VMM Host Context Ring 3 API
|
---|
| 136 | * @ingroup grp_vmm
|
---|
| 137 | * @{
|
---|
| 138 | */
|
---|
| 139 |
|
---|
| 140 | /**
|
---|
| 141 | * Initializes the VMM.
|
---|
| 142 | *
|
---|
| 143 | * @returns VBox status code.
|
---|
| 144 | * @param pVM The VM to operate on.
|
---|
| 145 | */
|
---|
| 146 | VMMR3DECL(int) VMMR3Init(PVM pVM);
|
---|
| 147 |
|
---|
| 148 | /**
|
---|
| 149 | * Ring-3 init finalizing.
|
---|
| 150 | *
|
---|
| 151 | * @returns VBox status code.
|
---|
| 152 | * @param pVM The VM handle.
|
---|
| 153 | */
|
---|
| 154 | VMMR3DECL(int) VMMR3InitFinalize(PVM pVM);
|
---|
| 155 |
|
---|
| 156 | /**
|
---|
| 157 | * Initializes the R0 VMM.
|
---|
| 158 | *
|
---|
| 159 | * @returns VBox status code.
|
---|
| 160 | * @param pVM The VM to operate on.
|
---|
| 161 | */
|
---|
| 162 | VMMR3DECL(int) VMMR3InitR0(PVM pVM);
|
---|
| 163 |
|
---|
| 164 | /**
|
---|
| 165 | * Initializes the GC VMM.
|
---|
| 166 | *
|
---|
| 167 | * @returns VBox status code.
|
---|
| 168 | * @param pVM The VM to operate on.
|
---|
| 169 | */
|
---|
| 170 | VMMR3DECL(int) VMMR3InitGC(PVM pVM);
|
---|
| 171 |
|
---|
| 172 | /**
|
---|
| 173 | * Destroy the VMM bits.
|
---|
| 174 | *
|
---|
| 175 | * @returns VINF_SUCCESS.
|
---|
| 176 | * @param pVM The VM handle.
|
---|
| 177 | */
|
---|
| 178 | VMMR3DECL(int) VMMR3Term(PVM pVM);
|
---|
| 179 |
|
---|
| 180 | /**
|
---|
| 181 | * Applies relocations to data and code managed by this
|
---|
| 182 | * component. This function will be called at init and
|
---|
| 183 | * whenever the VMM need to relocate it self inside the GC.
|
---|
| 184 | *
|
---|
| 185 | * The VMM will need to apply relocations to the core code.
|
---|
| 186 | *
|
---|
| 187 | * @param pVM The VM handle.
|
---|
| 188 | * @param offDelta The relocation delta.
|
---|
| 189 | */
|
---|
| 190 | VMMR3DECL(void) VMMR3Relocate(PVM pVM, RTGCINTPTR offDelta);
|
---|
| 191 |
|
---|
| 192 | /**
|
---|
| 193 | * Updates the settings for the GC (and R0?) loggers.
|
---|
| 194 | *
|
---|
| 195 | * @returns VBox status code.
|
---|
| 196 | * @param pVM The VM handle.
|
---|
| 197 | */
|
---|
| 198 | VMMR3DECL(int) VMMR3UpdateLoggers(PVM pVM);
|
---|
| 199 |
|
---|
| 200 | /**
|
---|
| 201 | * Gets the pointer to g_szRTAssertMsg1 in GC.
|
---|
| 202 | * @returns Pointer to VMMGC::g_szRTAssertMsg1.
|
---|
| 203 | * Returns NULL if not present.
|
---|
| 204 | * @param pVM The VM handle.
|
---|
| 205 | */
|
---|
| 206 | VMMR3DECL(const char *) VMMR3GetGCAssertMsg1(PVM pVM);
|
---|
| 207 |
|
---|
| 208 | /**
|
---|
| 209 | * Gets the pointer to g_szRTAssertMsg2 in GC.
|
---|
| 210 | * @returns Pointer to VMMGC::g_szRTAssertMsg2.
|
---|
| 211 | * Returns NULL if not present.
|
---|
| 212 | * @param pVM The VM handle.
|
---|
| 213 | */
|
---|
| 214 | VMMR3DECL(const char *) VMMR3GetGCAssertMsg2(PVM pVM);
|
---|
| 215 |
|
---|
| 216 | /**
|
---|
| 217 | * Resolve a builtin GC symbol.
|
---|
| 218 | * Called by PDM when loading or relocating GC modules.
|
---|
| 219 | *
|
---|
| 220 | * @returns VBox status.
|
---|
| 221 | * @param pVM VM Handle.
|
---|
| 222 | * @param pszSymbol Symbol to resolv
|
---|
| 223 | * @param pGCPtrValue Where to store the symbol value.
|
---|
| 224 | * @remark This has to work before VMMR3Relocate() is called.
|
---|
| 225 | */
|
---|
| 226 | VMMR3DECL(int) VMMR3GetImportGC(PVM pVM, const char *pszSymbol, PRTGCPTR pGCPtrValue);
|
---|
| 227 |
|
---|
| 228 | /**
|
---|
| 229 | * Selects the switcher to be used for switching to GC.
|
---|
| 230 | *
|
---|
| 231 | * @returns VBox status code.
|
---|
| 232 | * @param pVM VM handle.
|
---|
| 233 | * @param enmSwitcher The new switcher.
|
---|
| 234 | * @remark This function may be called before the VMM is initialized.
|
---|
| 235 | */
|
---|
| 236 | VMMR3DECL(int) VMMR3SelectSwitcher(PVM pVM, VMMSWITCHER enmSwitcher);
|
---|
| 237 |
|
---|
| 238 | /**
|
---|
| 239 | * Disable the switcher logic permanently.
|
---|
| 240 | *
|
---|
| 241 | * @returns VBox status code.
|
---|
| 242 | * @param pVM VM handle.
|
---|
| 243 | */
|
---|
| 244 | VMMR3DECL(int) VMMR3DisableSwitcher(PVM pVM);
|
---|
| 245 |
|
---|
| 246 | /**
|
---|
| 247 | * Executes guest code.
|
---|
| 248 | *
|
---|
| 249 | * @param pVM VM handle.
|
---|
| 250 | */
|
---|
| 251 | VMMR3DECL(int) VMMR3RawRunGC(PVM pVM);
|
---|
| 252 |
|
---|
| 253 | /**
|
---|
| 254 | * Executes guest code (Intel VMX and AMD SVM).
|
---|
| 255 | *
|
---|
| 256 | * @param pVM VM handle.
|
---|
| 257 | */
|
---|
| 258 | VMMR3DECL(int) VMMR3HwAccRunGC(PVM pVM);
|
---|
| 259 |
|
---|
| 260 | /**
|
---|
| 261 | * Calls GC a function.
|
---|
| 262 | *
|
---|
| 263 | * @param pVM The VM handle.
|
---|
| 264 | * @param GCPtrEntry The GC function address.
|
---|
| 265 | * @param cArgs The number of arguments in the ....
|
---|
| 266 | * @param ... Arguments to the function.
|
---|
| 267 | */
|
---|
| 268 | VMMR3DECL(int) VMMR3CallGC(PVM pVM, RTGCPTR GCPtrEntry, unsigned cArgs, ...);
|
---|
| 269 |
|
---|
| 270 | /**
|
---|
| 271 | * Calls GC a function.
|
---|
| 272 | *
|
---|
| 273 | * @param pVM The VM handle.
|
---|
| 274 | * @param GCPtrEntry The GC function address.
|
---|
| 275 | * @param cArgs The number of arguments in the ....
|
---|
| 276 | * @param args Arguments to the function.
|
---|
| 277 | */
|
---|
| 278 | VMMR3DECL(int) VMMR3CallGCV(PVM pVM, RTGCPTR GCPtrEntry, unsigned cArgs, va_list args);
|
---|
| 279 |
|
---|
| 280 | /**
|
---|
| 281 | * Resumes executing hypervisor code when interrupted
|
---|
| 282 | * by a queue flush or a debug event.
|
---|
| 283 | *
|
---|
| 284 | * @returns VBox status code.
|
---|
| 285 | * @param pVM VM handle.
|
---|
| 286 | */
|
---|
| 287 | VMMR3DECL(int) VMMR3ResumeHyper(PVM pVM);
|
---|
| 288 |
|
---|
| 289 | /**
|
---|
| 290 | * Dumps the VM state on a fatal error.
|
---|
| 291 | *
|
---|
| 292 | * @param pVM VM Handle.
|
---|
| 293 | * @param rcErr VBox status code.
|
---|
| 294 | */
|
---|
| 295 | VMMR3DECL(void) VMMR3FatalDump(PVM pVM, int rcErr);
|
---|
| 296 |
|
---|
| 297 | /**
|
---|
| 298 | * Acquire global VM lock
|
---|
| 299 | *
|
---|
| 300 | * @returns VBox status code
|
---|
| 301 | * @param pVM The VM to operate on.
|
---|
| 302 | */
|
---|
| 303 | VMMR3DECL(int) VMMR3Lock(PVM pVM);
|
---|
| 304 |
|
---|
| 305 | /**
|
---|
| 306 | * Release global VM lock
|
---|
| 307 | *
|
---|
| 308 | * @returns VBox status code
|
---|
| 309 | * @param pVM The VM to operate on.
|
---|
| 310 | */
|
---|
| 311 | VMMR3DECL(int) VMMR3Unlock(PVM pVM);
|
---|
| 312 |
|
---|
| 313 | /**
|
---|
| 314 | * Return global VM lock owner
|
---|
| 315 | *
|
---|
| 316 | * @returns NIL_RTNATIVETHREAD -> no owner, otherwise thread id of owner
|
---|
| 317 | * @param pVM The VM to operate on.
|
---|
| 318 | */
|
---|
| 319 | VMMR3DECL(RTNATIVETHREAD) VMMR3LockGetOwner(PVM pVM);
|
---|
| 320 |
|
---|
| 321 | /**
|
---|
| 322 | * Checks if the current thread is the owner of the global VM lock.
|
---|
| 323 | *
|
---|
| 324 | * @returns true if owner.
|
---|
| 325 | * @returns false if not owner.
|
---|
| 326 | * @param pVM The VM to operate on.
|
---|
| 327 | */
|
---|
| 328 | VMMR3DECL(bool) VMMR3LockIsOwner(PVM pVM);
|
---|
| 329 |
|
---|
| 330 | /**
|
---|
| 331 | * Suspends the the CPU yielder.
|
---|
| 332 | *
|
---|
| 333 | * @param pVM The VM handle.
|
---|
| 334 | */
|
---|
| 335 | VMMR3DECL(void) VMMR3YieldSuspend(PVM pVM);
|
---|
| 336 |
|
---|
| 337 | /**
|
---|
| 338 | * Stops the the CPU yielder.
|
---|
| 339 | *
|
---|
| 340 | * @param pVM The VM handle.
|
---|
| 341 | */
|
---|
| 342 | VMMR3DECL(void) VMMR3YieldStop(PVM pVM);
|
---|
| 343 |
|
---|
| 344 | /**
|
---|
| 345 | * Resumes the CPU yielder when it has been a suspended or stopped.
|
---|
| 346 | *
|
---|
| 347 | * @param pVM The VM handle.
|
---|
| 348 | */
|
---|
| 349 | VMMR3DECL(void) VMMR3YieldResume(PVM pVM);
|
---|
| 350 |
|
---|
| 351 | /** @} */
|
---|
| 352 | #endif
|
---|
| 353 |
|
---|
| 354 | /** @defgroup grp_vmm_r0 The VMM Host Context Ring 0 API
|
---|
| 355 | * @ingroup grp_vmm
|
---|
| 356 | * @{
|
---|
| 357 | */
|
---|
| 358 |
|
---|
| 359 | /**
|
---|
| 360 | * The VMMR0Entry() codes.
|
---|
| 361 | */
|
---|
| 362 | typedef enum VMMR0OPERATION
|
---|
| 363 | {
|
---|
| 364 | /** Run guest context. */
|
---|
[4811] | 365 | VMMR0_DO_RAW_RUN = SUP_VMMR0_DO_RAW_RUN,
|
---|
[1] | 366 | /** Run guest code using the available hardware acceleration technology. */
|
---|
[4811] | 367 | VMMR0_DO_HWACC_RUN = SUP_VMMR0_DO_HWACC_RUN,
|
---|
| 368 | /** Official NOP that we use for profiling. */
|
---|
| 369 | VMMR0_DO_NOP = SUP_VMMR0_DO_NOP,
|
---|
| 370 |
|
---|
[5167] | 371 | /** Ask the GVMM to create a new VM. */
|
---|
[5031] | 372 | VMMR0_DO_GVMM_CREATE_VM,
|
---|
[5167] | 373 | /** Ask the GVMM to destroy the VM. */
|
---|
[5031] | 374 | VMMR0_DO_GVMM_DESTROY_VM,
|
---|
[5167] | 375 | /** Call GVMMR0SchedHalt(). */
|
---|
| 376 | VMMR0_DO_GVMM_SCHED_HALT,
|
---|
| 377 | /** Call GVMMR0SchedWakeUp(). */
|
---|
| 378 | VMMR0_DO_GVMM_SCHED_WAKE_UP,
|
---|
| 379 | /** Call GVMMR0SchedPoll(). */
|
---|
| 380 | VMMR0_DO_GVMM_SCHED_POLL,
|
---|
[5211] | 381 | /** Call GVMMR0QueryStatistics(). */
|
---|
| 382 | VMMR0_DO_GVMM_QUERY_STATISTICS,
|
---|
[5233] | 383 | /** Call GVMMR0ResetStatistics(). */
|
---|
| 384 | VMMR0_DO_GVMM_RESET_STATISTICS,
|
---|
[5167] | 385 |
|
---|
[1] | 386 | /** Call VMMR0 Per VM Init. */
|
---|
| 387 | VMMR0_DO_VMMR0_INIT,
|
---|
| 388 | /** Call VMMR0 Per VM Termination. */
|
---|
| 389 | VMMR0_DO_VMMR0_TERM,
|
---|
| 390 | /** Setup the hardware accelerated raw-mode session. */
|
---|
[397] | 391 | VMMR0_DO_HWACC_SETUP_VM,
|
---|
[7416] | 392 | /** Attempt to enable or disable hardware accelerated raw-mode. */
|
---|
| 393 | VMMR0_DO_HWACC_ENABLE,
|
---|
[1] | 394 | /** Calls function in the hypervisor.
|
---|
| 395 | * The caller must setup the hypervisor context so the call will be performed.
|
---|
| 396 | * The difference between VMMR0_DO_RUN_GC and this one is the handling of
|
---|
| 397 | * the return GC code. The return code will not be interpreted by this operation.
|
---|
| 398 | */
|
---|
| 399 | VMMR0_DO_CALL_HYPERVISOR,
|
---|
| 400 |
|
---|
[4738] | 401 | /** Call PGMR0PhysAllocateHandyPages(). */
|
---|
| 402 | VMMR0_DO_PGM_ALLOCATE_HANDY_PAGES,
|
---|
[5106] | 403 |
|
---|
| 404 | /** Call GMMR0InitialReservation(). */
|
---|
| 405 | VMMR0_DO_GMM_INITIAL_RESERVATION,
|
---|
| 406 | /** Call GMMR0UpdateReservation(). */
|
---|
| 407 | VMMR0_DO_GMM_UPDATE_RESERVATION,
|
---|
[4738] | 408 | /** Call GMMR0AllocatePages(). */
|
---|
| 409 | VMMR0_DO_GMM_ALLOCATE_PAGES,
|
---|
| 410 | /** Call GMMR0FreePages(). */
|
---|
| 411 | VMMR0_DO_GMM_FREE_PAGES,
|
---|
[5106] | 412 | /** Call GMMR0BalloonedPages(). */
|
---|
| 413 | VMMR0_DO_GMM_BALLOONED_PAGES,
|
---|
[5135] | 414 | /** Call GMMR0DeflatedBalloon(). */
|
---|
| 415 | VMMR0_DO_GMM_DEFLATED_BALLOON,
|
---|
[4738] | 416 | /** Call GMMR0MapUnmapChunk(). */
|
---|
| 417 | VMMR0_DO_GMM_MAP_UNMAP_CHUNK,
|
---|
| 418 | /** Call GMMR0SeedChunk(). */
|
---|
| 419 | VMMR0_DO_GMM_SEED_CHUNK,
|
---|
| 420 |
|
---|
[5240] | 421 | /** Set a GVMM or GMM configuration value. */
|
---|
| 422 | VMMR0_DO_GCFGM_SET_VALUE,
|
---|
| 423 | /** Query a GVMM or GMM configuration value. */
|
---|
| 424 | VMMR0_DO_GCFGM_QUERY_VALUE,
|
---|
[5211] | 425 |
|
---|
[1] | 426 | /** The start of the R0 service operations. */
|
---|
| 427 | VMMR0_DO_SRV_START,
|
---|
| 428 | /** Call INTNETR0Open(). */
|
---|
| 429 | VMMR0_DO_INTNET_OPEN,
|
---|
| 430 | /** Call INTNETR0IfClose(). */
|
---|
| 431 | VMMR0_DO_INTNET_IF_CLOSE,
|
---|
| 432 | /** Call INTNETR0IfGetRing3Buffer(). */
|
---|
| 433 | VMMR0_DO_INTNET_IF_GET_RING3_BUFFER,
|
---|
| 434 | /** Call INTNETR0IfSetPromiscuousMode(). */
|
---|
| 435 | VMMR0_DO_INTNET_IF_SET_PROMISCUOUS_MODE,
|
---|
| 436 | /** Call INTNETR0IfSend(). */
|
---|
| 437 | VMMR0_DO_INTNET_IF_SEND,
|
---|
| 438 | /** Call INTNETR0IfWait(). */
|
---|
| 439 | VMMR0_DO_INTNET_IF_WAIT,
|
---|
| 440 | /** The end of the R0 service operations. */
|
---|
| 441 | VMMR0_DO_SRV_END,
|
---|
| 442 |
|
---|
[397] | 443 | /** Official call we use for testing Ring-0 APIs. */
|
---|
| 444 | VMMR0_DO_TESTS,
|
---|
| 445 |
|
---|
[1] | 446 | /** The usual 32-bit type blow up. */
|
---|
| 447 | VMMR0_DO_32BIT_HACK = 0x7fffffff
|
---|
| 448 | } VMMR0OPERATION;
|
---|
| 449 |
|
---|
[5240] | 450 |
|
---|
[1] | 451 | /**
|
---|
[5240] | 452 | * Request buffer for VMMR0_DO_GCFGM_SET_VALUE and VMMR0_DO_GCFGM_QUERY_VALUE.
|
---|
| 453 | * @todo Move got GCFGM.h when it's implemented.
|
---|
| 454 | */
|
---|
| 455 | typedef struct GCFGMVALUEREQ
|
---|
| 456 | {
|
---|
| 457 | /** The request header.*/
|
---|
| 458 | SUPVMMR0REQHDR Hdr;
|
---|
| 459 | /** The support driver session handle. */
|
---|
| 460 | PSUPDRVSESSION pSession;
|
---|
| 461 | /** The value.
|
---|
| 462 | * This is input for the set request and output for the query. */
|
---|
| 463 | uint64_t u64Value;
|
---|
| 464 | /** The variable name.
|
---|
| 465 | * This is fixed sized just to make things simple for the mock-up. */
|
---|
| 466 | char szName[48];
|
---|
| 467 | } GCFGMVALUEREQ;
|
---|
| 468 | /** Pointer to a VMMR0_DO_GCFGM_SET_VALUE and VMMR0_DO_GCFGM_QUERY_VALUE request buffer.
|
---|
| 469 | * @todo Move got GCFGM.h when it's implemented.
|
---|
| 470 | */
|
---|
| 471 | typedef GCFGMVALUEREQ *PGCFGMVALUEREQ;
|
---|
| 472 |
|
---|
| 473 |
|
---|
| 474 | /**
|
---|
[4811] | 475 | * The Ring 0 entry point, called by the interrupt gate.
|
---|
| 476 | *
|
---|
| 477 | * @returns VBox status code.
|
---|
| 478 | * @param pVM The VM to operate on.
|
---|
| 479 | * @param enmOperation Which operation to execute.
|
---|
| 480 | * @param pvArg Argument to the operation.
|
---|
| 481 | * @remarks Assume called with interrupts disabled.
|
---|
| 482 | */
|
---|
| 483 | VMMR0DECL(int) VMMR0EntryInt(PVM pVM, VMMR0OPERATION enmOperation, void *pvArg);
|
---|
| 484 |
|
---|
| 485 | /**
|
---|
| 486 | * The Ring 0 entry point, called by the fast-ioctl path.
|
---|
| 487 | *
|
---|
| 488 | * @returns VBox status code.
|
---|
| 489 | * @param pVM The VM to operate on.
|
---|
| 490 | * @param enmOperation Which operation to execute.
|
---|
[4970] | 491 | * @remarks Assume called with interrupts _enabled_.
|
---|
[4811] | 492 | */
|
---|
| 493 | VMMR0DECL(int) VMMR0EntryFast(PVM pVM, VMMR0OPERATION enmOperation);
|
---|
| 494 |
|
---|
| 495 | /**
|
---|
[1] | 496 | * The Ring 0 entry point, called by the support library (SUP).
|
---|
| 497 | *
|
---|
| 498 | * @returns VBox status code.
|
---|
[4811] | 499 | * @param pVM The VM to operate on.
|
---|
| 500 | * @param enmOperation Which operation to execute.
|
---|
| 501 | * @param pReq This points to a SUPVMMR0REQHDR packet. Optional.
|
---|
| 502 | * @param u64Arg Some simple constant argument.
|
---|
| 503 | * @remarks Assume called with interrupts _enabled_.
|
---|
[1] | 504 | */
|
---|
[4811] | 505 | VMMR0DECL(int) VMMR0EntryEx(PVM pVM, VMMR0OPERATION enmOperation, PSUPVMMR0REQHDR pReq, uint64_t u64Arg);
|
---|
[1] | 506 |
|
---|
| 507 | /**
|
---|
| 508 | * Calls the ring-3 host code.
|
---|
| 509 | *
|
---|
| 510 | * @returns VBox status code of the ring-3 call.
|
---|
| 511 | * @param pVM The VM handle.
|
---|
| 512 | * @param enmOperation The operation.
|
---|
| 513 | * @param uArg The argument to the operation.
|
---|
| 514 | */
|
---|
| 515 | VMMR0DECL(int) VMMR0CallHost(PVM pVM, VMMCALLHOST enmOperation, uint64_t uArg);
|
---|
| 516 |
|
---|
| 517 | /** @} */
|
---|
| 518 |
|
---|
| 519 |
|
---|
| 520 | #ifdef IN_GC
|
---|
| 521 | /** @defgroup grp_vmm_gc The VMM Guest Context API
|
---|
| 522 | * @ingroup grp_vmm
|
---|
| 523 | * @{
|
---|
| 524 | */
|
---|
| 525 |
|
---|
| 526 | /**
|
---|
| 527 | * The GC entry point.
|
---|
| 528 | *
|
---|
| 529 | * @returns VBox status code.
|
---|
| 530 | * @param pVM The VM to operate on.
|
---|
| 531 | * @param uOperation Which operation to execute (VMMGCOPERATION).
|
---|
| 532 | * @param uArg Argument to that operation.
|
---|
[3123] | 533 | * @param ... Additional arguments.
|
---|
[1] | 534 | */
|
---|
[3123] | 535 | VMMGCDECL(int) VMMGCEntry(PVM pVM, unsigned uOperation, unsigned uArg, ...);
|
---|
[1] | 536 |
|
---|
| 537 | /**
|
---|
| 538 | * Switches from guest context to host context.
|
---|
| 539 | *
|
---|
| 540 | * @param pVM The VM handle.
|
---|
| 541 | * @param rc The status code.
|
---|
| 542 | */
|
---|
| 543 | VMMGCDECL(void) VMMGCGuestToHost(PVM pVM, int rc);
|
---|
| 544 |
|
---|
| 545 | /**
|
---|
| 546 | * Calls the ring-3 host code.
|
---|
| 547 | *
|
---|
| 548 | * @returns VBox status code of the ring-3 call.
|
---|
| 549 | * @param pVM The VM handle.
|
---|
| 550 | * @param enmOperation The operation.
|
---|
| 551 | * @param uArg The argument to the operation.
|
---|
| 552 | */
|
---|
| 553 | VMMGCDECL(int) VMMGCCallHost(PVM pVM, VMMCALLHOST enmOperation, uint64_t uArg);
|
---|
| 554 |
|
---|
| 555 | /** @} */
|
---|
| 556 | #endif
|
---|
| 557 |
|
---|
| 558 |
|
---|
| 559 | /** @} */
|
---|
| 560 | __END_DECLS
|
---|
| 561 |
|
---|
| 562 |
|
---|
| 563 | #endif
|
---|