VirtualBox

source: vbox/trunk/include/VBox/vmm/gvmm.h@ 75507

Last change on this file since 75507 was 72778, checked in by vboxsync, 6 years ago

VMM,SUPDrv,IPRT: Redirect ring-0 release logging on EMTs to VBox.log.

  • VMM: Added release ring-0 logging on EMTs that writes to VBox.log.
  • IPRT: Made 'msprog' and 'timeprog' work for ring-0 logging on EMTs.
  • IPRT: Removed RTLogSetCustomPrefixCallbackForR0.
  • VMM: Removed vmmR0LoggerPrefix that was assoicated with the above API.
  • IPRT Fixed missing log prefix on the first log line.
  • SUPDrv: Turns out we require actual code for SUPR0GetDefaultLogRelInstanceEx and SUPR0GetDefaultLogInstanceEx.

Note! Requires updating the support driver.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id Revision
File size: 9.7 KB
Line 
1/* $Id: gvmm.h 72778 2018-06-29 20:02:35Z vboxsync $ */
2/** @file
3 * GVMM - The Global VM Manager.
4 */
5
6/*
7 * Copyright (C) 2007-2017 Oracle Corporation
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 * The contents of this file may alternatively be used under the terms
18 * of the Common Development and Distribution License Version 1.0
19 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
20 * VirtualBox OSE distribution, in which case the provisions of the
21 * CDDL are applicable instead of those of the GPL.
22 *
23 * You may elect to license modified versions of this file under the
24 * terms and conditions of either the GPL or the CDDL or both.
25 */
26
27#ifndef ___VBox_vmm_gvmm_h
28#define ___VBox_vmm_gvmm_h
29
30#include <VBox/types.h>
31#include <VBox/sup.h>
32#include <iprt/cpuset.h> /* RTCPUSET_MAX_CPUS */
33
34
35RT_C_DECLS_BEGIN
36
37/** @defgroup grp_gvmm GVMM - The Global VM Manager.
38 * @ingroup grp_vmm
39 * @{
40 */
41
42/** @def IN_GVMM_R0
43 * Used to indicate whether we're inside the same link module as the ring 0
44 * part of the Global VM Manager or not.
45 */
46#ifdef DOXYGEN_RUNNING
47# define IN_GVMM_R0
48#endif
49/** @def GVMMR0DECL
50 * Ring 0 VM export or import declaration.
51 * @param type The return type of the function declaration.
52 */
53#ifdef IN_GVMM_R0
54# define GVMMR0DECL(type) DECLEXPORT(type) VBOXCALL
55#else
56# define GVMMR0DECL(type) DECLIMPORT(type) VBOXCALL
57#endif
58
59/** @def NIL_GVM_HANDLE
60 * The nil GVM VM handle value (VM::hSelf).
61 */
62#define NIL_GVM_HANDLE 0
63
64
65/**
66 * The scheduler statistics
67 */
68typedef struct GVMMSTATSSCHED
69{
70 /** The number of calls to GVMMR0SchedHalt. */
71 uint64_t cHaltCalls;
72 /** The number of times we did go to sleep in GVMMR0SchedHalt. */
73 uint64_t cHaltBlocking;
74 /** The number of times we timed out in GVMMR0SchedHalt. */
75 uint64_t cHaltTimeouts;
76 /** The number of times we didn't go to sleep in GVMMR0SchedHalt. */
77 uint64_t cHaltNotBlocking;
78 /** The number of wake ups done during GVMMR0SchedHalt. */
79 uint64_t cHaltWakeUps;
80
81 /** The number of calls to GVMMR0WakeUp. */
82 uint64_t cWakeUpCalls;
83 /** The number of times the EMT thread wasn't actually halted when GVMMR0WakeUp
84 * was called. */
85 uint64_t cWakeUpNotHalted;
86 /** The number of wake ups done during GVMMR0WakeUp (not counting the explicit
87 * one). */
88 uint64_t cWakeUpWakeUps;
89
90 /** The number of calls to GVMMR0Poke. */
91 uint64_t cPokeCalls;
92 /** The number of times the EMT thread wasn't actually busy when
93 * GVMMR0Poke was called. */
94 uint64_t cPokeNotBusy;
95
96 /** The number of calls to GVMMR0SchedPoll. */
97 uint64_t cPollCalls;
98 /** The number of times the EMT has halted in a GVMMR0SchedPoll call. */
99 uint64_t cPollHalts;
100 /** The number of wake ups done during GVMMR0SchedPoll. */
101 uint64_t cPollWakeUps;
102
103 uint64_t u64Alignment; /**< padding */
104} GVMMSTATSSCHED;
105/** Pointer to the GVMM scheduler statistics. */
106typedef GVMMSTATSSCHED *PGVMMSTATSSCHED;
107
108/**
109 * Per host cpu statistics.
110 */
111typedef struct GVMMSTATSHOSTCPU
112{
113 /** The CPU ID. */
114 RTCPUID idCpu;
115 /** The CPU's set index. */
116 uint32_t idxCpuSet;
117 /** The desired PPT frequency. */
118 uint32_t uDesiredHz;
119 /** The current PPT timer frequency. */
120 uint32_t uTimerHz;
121 /** The number of times the PPT was changed. */
122 uint32_t cChanges;
123 /** The number of times the PPT was started. */
124 uint32_t cStarts;
125} GVMMSTATSHOSTCPU;
126/** Pointer to the GVMM per host CPU statistics. */
127typedef GVMMSTATSHOSTCPU *PGVMMSTATSHOSTCPU;
128
129/**
130 * The GVMM statistics.
131 */
132typedef struct GVMMSTATS
133{
134 /** The VM statistics if a VM was specified. */
135 GVMMSTATSSCHED SchedVM;
136 /** The sum statistics of all VMs accessible to the caller. */
137 GVMMSTATSSCHED SchedSum;
138 /** The number of VMs accessible to the caller. */
139 uint32_t cVMs;
140 /** The number of emulation threads in those VMs. */
141 uint32_t cEMTs;
142 /** Padding. */
143 uint32_t u32Padding;
144 /** The number of valid entries in aHostCpus. */
145 uint32_t cHostCpus;
146 /** Per host CPU statistics. */
147 GVMMSTATSHOSTCPU aHostCpus[RTCPUSET_MAX_CPUS];
148} GVMMSTATS;
149/** Pointer to the GVMM statistics. */
150typedef GVMMSTATS *PGVMMSTATS;
151/** Const pointer to the GVMM statistics. */
152typedef const GVMMSTATS *PCGVMMSTATS;
153
154
155
156GVMMR0DECL(int) GVMMR0Init(void);
157GVMMR0DECL(void) GVMMR0Term(void);
158GVMMR0DECL(int) GVMMR0SetConfig(PSUPDRVSESSION pSession, const char *pszName, uint64_t u64Value);
159GVMMR0DECL(int) GVMMR0QueryConfig(PSUPDRVSESSION pSession, const char *pszName, uint64_t *pu64Value);
160
161GVMMR0DECL(int) GVMMR0CreateVM(PSUPDRVSESSION pSession, uint32_t cCpus, PVM *ppVM);
162GVMMR0DECL(int) GVMMR0InitVM(PGVM pGVM);
163GVMMR0DECL(void) GVMMR0DoneInitVM(PGVM pGVM);
164GVMMR0DECL(bool) GVMMR0DoingTermVM(PGVM pGVM);
165GVMMR0DECL(int) GVMMR0DestroyVM(PGVM pGVM, PVM pVM);
166GVMMR0DECL(int) GVMMR0RegisterVCpu(PGVM pGVM, PVM pVM, VMCPUID idCpu);
167GVMMR0DECL(int) GVMMR0DeregisterVCpu(PGVM pGVM, PVM pVM, VMCPUID idCpu);
168GVMMR0DECL(PGVM) GVMMR0ByHandle(uint32_t hGVM);
169GVMMR0DECL(PGVM) GVMMR0FastGetGVMByVM(PVM pVM);
170GVMMR0DECL(int) GVMMR0ValidateGVMandVM(PGVM pGVM, PVM pVM);
171GVMMR0DECL(int) GVMMR0ValidateGVMandVMandEMT(PGVM pGVM, PVM pVM, VMCPUID idCpu);
172GVMMR0DECL(PVM) GVMMR0GetVMByEMT(RTNATIVETHREAD hEMT);
173GVMMR0DECL(PGVMCPU) GVMMR0GetGVCpuByEMT(RTNATIVETHREAD hEMT);
174GVMMR0DECL(int) GVMMR0SchedHalt(PGVM pGVM, PVM pVM, VMCPUID idCpu, uint64_t u64ExpireGipTime);
175GVMMR0DECL(int) GVMMR0SchedWakeUp(PGVM pGVM, PVM pVM, VMCPUID idCpu);
176GVMMR0DECL(int) GVMMR0SchedWakeUpEx(PGVM pGVM, PVM pVM, VMCPUID idCpu, bool fTakeUsedLock);
177GVMMR0DECL(int) GVMMR0SchedWakeUpNoGVMNoLock(PVM pVM, VMCPUID idCpu);
178GVMMR0DECL(int) GVMMR0SchedPoke(PGVM pGVM, PVM pVM, VMCPUID idCpu);
179GVMMR0DECL(int) GVMMR0SchedPokeEx(PGVM pGVM, PVM pVM, VMCPUID idCpu, bool fTakeUsedLock);
180GVMMR0DECL(int) GVMMR0SchedPokeNoGVMNoLock(PVM pVM, VMCPUID idCpu);
181GVMMR0DECL(int) GVMMR0SchedWakeUpAndPokeCpus(PGVM pGVM, PVM pVM, PCVMCPUSET pSleepSet, PCVMCPUSET pPokeSet);
182GVMMR0DECL(int) GVMMR0SchedPoll(PGVM pGVM, PVM pVM, VMCPUID idCpu, bool fYield);
183GVMMR0DECL(void) GVMMR0SchedUpdatePeriodicPreemptionTimer(PVM pVM, RTCPUID idHostCpu, uint32_t uHz);
184GVMMR0DECL(int) GVMMR0QueryStatistics(PGVMMSTATS pStats, PSUPDRVSESSION pSession, PGVM pGVM, PVM pVM);
185GVMMR0DECL(int) GVMMR0ResetStatistics(PCGVMMSTATS pStats, PSUPDRVSESSION pSession, PGVM pGVM, PVM pVM);
186
187
188/**
189 * Request packet for calling GVMMR0CreateVM.
190 */
191typedef struct GVMMCREATEVMREQ
192{
193 /** The request header. */
194 SUPVMMR0REQHDR Hdr;
195 /** The support driver session. (IN) */
196 PSUPDRVSESSION pSession;
197 /** Number of virtual CPUs for the new VM. (IN) */
198 uint32_t cCpus;
199 /** Pointer to the ring-3 mapping of the shared VM structure on return. (OUT) */
200 PVMR3 pVMR3;
201 /** Pointer to the ring-0 mapping of the shared VM structure on return. (OUT) */
202 PVMR0 pVMR0;
203} GVMMCREATEVMREQ;
204/** Pointer to a GVMMR0CreateVM request packet. */
205typedef GVMMCREATEVMREQ *PGVMMCREATEVMREQ;
206
207GVMMR0DECL(int) GVMMR0CreateVMReq(PGVMMCREATEVMREQ pReq, PSUPDRVSESSION pSession);
208
209
210/**
211 * Request buffer for GVMMR0SchedWakeUpAndPokeCpusReq / VMMR0_DO_GVMM_SCHED_WAKE_UP_AND_POKE_CPUS.
212 * @see GVMMR0SchedWakeUpAndPokeCpus.
213 */
214typedef struct GVMMSCHEDWAKEUPANDPOKECPUSREQ /* nice and unreadable... */
215{
216 /** The header. */
217 SUPVMMR0REQHDR Hdr;
218 /** The sleeper set. */
219 VMCPUSET SleepSet;
220 /** The set of virtual CPUs to poke. */
221 VMCPUSET PokeSet;
222} GVMMSCHEDWAKEUPANDPOKECPUSREQ;
223/** Pointer to a GVMMR0QueryStatisticsReq / VMMR0_DO_GVMM_QUERY_STATISTICS request buffer. */
224typedef GVMMSCHEDWAKEUPANDPOKECPUSREQ *PGVMMSCHEDWAKEUPANDPOKECPUSREQ;
225
226GVMMR0DECL(int) GVMMR0SchedWakeUpAndPokeCpusReq(PGVM pGVM, PVM pVM, PGVMMSCHEDWAKEUPANDPOKECPUSREQ pReq);
227
228
229/**
230 * Request buffer for GVMMR0QueryStatisticsReq / VMMR0_DO_GVMM_QUERY_STATISTICS.
231 * @see GVMMR0QueryStatistics.
232 */
233typedef struct GVMMQUERYSTATISTICSSREQ
234{
235 /** The header. */
236 SUPVMMR0REQHDR Hdr;
237 /** The support driver session. */
238 PSUPDRVSESSION pSession;
239 /** The statistics. */
240 GVMMSTATS Stats;
241} GVMMQUERYSTATISTICSSREQ;
242/** Pointer to a GVMMR0QueryStatisticsReq / VMMR0_DO_GVMM_QUERY_STATISTICS request buffer. */
243typedef GVMMQUERYSTATISTICSSREQ *PGVMMQUERYSTATISTICSSREQ;
244
245GVMMR0DECL(int) GVMMR0QueryStatisticsReq(PGVM pGVM, PVM pVM, PGVMMQUERYSTATISTICSSREQ pReq, PSUPDRVSESSION pSession);
246
247
248/**
249 * Request buffer for GVMMR0ResetStatisticsReq / VMMR0_DO_GVMM_RESET_STATISTICS.
250 * @see GVMMR0ResetStatistics.
251 */
252typedef struct GVMMRESETSTATISTICSSREQ
253{
254 /** The header. */
255 SUPVMMR0REQHDR Hdr;
256 /** The support driver session. */
257 PSUPDRVSESSION pSession;
258 /** The statistics to reset.
259 * Any non-zero entry will be reset (if permitted). */
260 GVMMSTATS Stats;
261} GVMMRESETSTATISTICSSREQ;
262/** Pointer to a GVMMR0ResetStatisticsReq / VMMR0_DO_GVMM_RESET_STATISTICS request buffer. */
263typedef GVMMRESETSTATISTICSSREQ *PGVMMRESETSTATISTICSSREQ;
264
265GVMMR0DECL(int) GVMMR0ResetStatisticsReq(PGVM pGVM, PVM pVM, PGVMMRESETSTATISTICSSREQ pReq, PSUPDRVSESSION pSession);
266
267
268/** @} */
269
270RT_C_DECLS_END
271
272#endif
273
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