SUPDrvInternal.h@ 57378

Last change on this file since 57378 was 57378, checked in by vboxsync, 9 years ago
SUPDrv: Modified SUP_IOCTL_LDR_LOAD to return an error string, major support driver version bump, and removed the long obsolete VMMR0EntryInt.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 39.0 KB

Line
1	/* $Id: SUPDrvInternal.h 57378 2015-08-17 11:54:27Z vboxsync $ */
2	/** @file
3	* VirtualBox Support Driver - Internal header.
4	*/
5
6	/*
7	* Copyright (C) 2006-2015 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 ___SUPDrvInternal_h
28	#define ___SUPDrvInternal_h
29
30
31	/*******************************************************************************
32	* Header Files *
33	*******************************************************************************/
34	#include <VBox/cdefs.h>
35	#include <VBox/types.h>
36	#include <VBox/sup.h>
37
38	#include <iprt/assert.h>
39	#include <iprt/list.h>
40	#include <iprt/memobj.h>
41	#include <iprt/time.h>
42	#include <iprt/timer.h>
43	#include <iprt/string.h>
44	#include <iprt/err.h>
45
46	#ifdef SUPDRV_AGNOSTIC
47	/* do nothing */
48
49	#elif defined(RT_OS_WINDOWS)
50	RT_C_DECLS_BEGIN
51	# if (_MSC_VER >= 1400) && !defined(VBOX_WITH_PATCHED_DDK)
52	# define _InterlockedExchange _InterlockedExchange_StupidDDKVsCompilerCrap
53	# define _InterlockedExchangeAdd _InterlockedExchangeAdd_StupidDDKVsCompilerCrap
54	# define _InterlockedCompareExchange _InterlockedCompareExchange_StupidDDKVsCompilerCrap
55	# define _InterlockedAddLargeStatistic _InterlockedAddLargeStatistic_StupidDDKVsCompilerCrap
56	# define _interlockedbittestandset _interlockedbittestandset_StupidDDKVsCompilerCrap
57	# define _interlockedbittestandreset _interlockedbittestandreset_StupidDDKVsCompilerCrap
58	# define _interlockedbittestandset64 _interlockedbittestandset64_StupidDDKVsCompilerCrap
59	# define _interlockedbittestandreset64 _interlockedbittestandreset64_StupidDDKVsCompilerCrap
60	# pragma warning(disable : 4163)
61	# include <iprt/nt/nt.h>
62	# pragma warning(default : 4163)
63	# undef _InterlockedExchange
64	# undef _InterlockedExchangeAdd
65	# undef _InterlockedCompareExchange
66	# undef _InterlockedAddLargeStatistic
67	# undef _interlockedbittestandset
68	# undef _interlockedbittestandreset
69	# undef _interlockedbittestandset64
70	# undef _interlockedbittestandreset64
71	# else
72	# include <iprt/nt/nt.h>
73	# endif
74	# include <memory.h>
75	RT_C_DECLS_END
76
77	#elif defined(RT_OS_LINUX)
78	# include <linux/version.h>
79	# if LINUX_VERSION_CODE >= KERNEL_VERSION(2, 6, 33)
80	# include <generated/autoconf.h>
81	# else
82	# ifndef AUTOCONF_INCLUDED
83	# include <linux/autoconf.h>
84	# endif
85	# endif
86	# if defined(CONFIG_MODVERSIONS) && !defined(MODVERSIONS)
87	# define MODVERSIONS
88	# if LINUX_VERSION_CODE < KERNEL_VERSION(2, 5, 71)
89	# include <linux/modversions.h>
90	# endif
91	# endif
92	# if LINUX_VERSION_CODE > KERNEL_VERSION(2, 6, 0)
93	# undef ALIGN
94	# endif
95	# ifndef KBUILD_STR
96	# if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 16)
97	# define KBUILD_STR(s) s
98	# else
99	# define KBUILD_STR(s) #s
100	# endif
101	# endif
102	# include <linux/string.h>
103	# include <linux/spinlock.h>
104	# include <linux/slab.h>
105	# if LINUX_VERSION_CODE >= KERNEL_VERSION(2, 6, 27)
106	# include <linux/semaphore.h>
107	# else /* older kernels */
108	# include <asm/semaphore.h>
109	# endif /* older kernels */
110	# include <linux/timer.h>
111
112	#elif defined(RT_OS_DARWIN)
113	# include <libkern/libkern.h>
114	# include <iprt/string.h>
115
116	#elif defined(RT_OS_OS2)
117
118	#elif defined(RT_OS_FREEBSD)
119	# define memset libkern_memset /** @todo these are just hacks to get it compiling, check out later. */
120	# define memcmp libkern_memcmp
121	# define strchr libkern_strchr
122	# define strrchr libkern_strrchr
123	# define ffsl libkern_ffsl
124	# define fls libkern_fls
125	# define flsl libkern_flsl
126	# include <sys/libkern.h>
127	# undef memset
128	# undef memcmp
129	# undef strchr
130	# undef strrchr
131	# undef ffs
132	# undef ffsl
133	# undef fls
134	# undef flsl
135	# include <iprt/string.h>
136
137	#elif defined(RT_OS_SOLARIS)
138	# include <sys/cmn_err.h>
139	# include <iprt/string.h>
140
141	#else
142	# error "unsupported OS."
143	#endif
144
145	#include "SUPDrvIOC.h"
146	#include "SUPDrvIDC.h"
147
148
149
150	/*******************************************************************************
151	* Defined Constants And Macros *
152	*******************************************************************************/
153	/*
154	* Hardcoded cookies.
155	*/
156	#define BIRD 0x64726962 /* 'bird' */
157	#define BIRD_INV 0x62697264 /* 'drib' */
158
159
160	#ifdef RT_OS_WINDOWS
161	/** Use a normal mutex for the loader so we remain at the same IRQL after
162	* taking it.
163	* @todo fix the mutex implementation on linux and make this the default. */
164	# define SUPDRV_USE_MUTEX_FOR_LDR
165
166	/** Use a normal mutex for the GIP so we remain at the same IRQL after
167	* taking it.
168	* @todo fix the mutex implementation on linux and make this the default. */
169	# define SUPDRV_USE_MUTEX_FOR_GIP
170	#endif
171
172
173	/**
174	* OS debug print macro.
175	*/
176	#define OSDBGPRINT(a) SUPR0Printf a
177
178	/** Debug printf macro shared with the ring-3 part. */
179	#ifdef DEBUG_bird
180	# define SUP_DPRINTF(a) SUPR0Printf a
181	#else
182	# define SUP_DPRINTF(a) do { } while (0)
183	#endif
184
185
186	/** @name Context values for the per-session handle tables.
187	* The context value is used to distinguish between the different kinds of
188	* handles, making the handle table API do all the work.
189	* @{ */
190	/** Handle context value for single release event handles. */
191	#define SUPDRV_HANDLE_CTX_EVENT ((void *)(uintptr_t)(SUPDRVOBJTYPE_SEM_EVENT))
192	/** Handle context value for multiple release event handles. */
193	#define SUPDRV_HANDLE_CTX_EVENT_MULTI ((void *)(uintptr_t)(SUPDRVOBJTYPE_SEM_EVENT_MULTI))
194	/** @} */
195
196
197	/**
198	* Validates a session pointer.
199	*
200	* @returns true/false accordingly.
201	* @param pSession The session.
202	*/
203	#define SUP_IS_SESSION_VALID(pSession) \
204	( VALID_PTR(pSession) \
205	&& pSession->u32Cookie == BIRD_INV)
206
207	/**
208	* Validates a device extension pointer.
209	*
210	* @returns true/false accordingly.
211	* @param pDevExt The device extension.
212	*/
213	#define SUP_IS_DEVEXT_VALID(pDevExt) \
214	( VALID_PTR(pDevExt)\
215	&& pDevExt->u32Cookie == BIRD)
216
217
218	/** @def SUPDRV_WITH_MSR_PROBER
219	* Enables the SUP_IOCTL_MSR_PROBER function.
220	* By default, only enabled in DEBUG builds as it's a sensitive feature.
221	*/
222	#if defined(DEBUG) && !defined(SUPDRV_WITH_MSR_PROBER) && !defined(SUPDRV_WITHOUT_MSR_PROBER)
223	# define SUPDRV_WITH_MSR_PROBER
224	#endif
225
226	/** @def SUPDRV_WITHOUT_MSR_PROBER
227	* Executive overide for disabling the SUP_IOCTL_MSR_PROBER function.
228	*/
229	#ifdef SUPDRV_WITHOUT_MSR_PROBER
230	# undef SUPDRV_WITH_MSR_PROBER
231	#endif
232
233	#if 1
234	/** Use a dedicated kernel thread to service TSC-delta measurement requests.
235	* @todo Test on servers with many CPUs and sockets. */
236	#define SUPDRV_USE_TSC_DELTA_THREAD
237	#endif
238
239	/*******************************************************************************
240	* Structures and Typedefs *
241	*******************************************************************************/
242	/** Pointer to the device extension. */
243	typedef struct SUPDRVDEVEXT *PSUPDRVDEVEXT;
244
245	#ifdef SUPDRV_USE_TSC_DELTA_THREAD
246	/**
247	* TSC-delta measurement thread state machine.
248	*/
249	typedef enum SUPDRVTSCDELTATHREADSTATE
250	{
251	/** Uninitialized/invalid value. */
252	kTscDeltaThreadState_Invalid = 0,
253	/** The thread is being created.
254	* Next state: Listening, Butchered, Terminating */
255	kTscDeltaThreadState_Creating,
256	/** The thread is listening for events.
257	* Previous state: Creating, Measuring
258	* Next state: WaitAndMeasure, Butchered, Terminated */
259	kTscDeltaThreadState_Listening,
260	/** The thread is sleeping before starting a measurement.
261	* Previous state: Listening, Measuring
262	* Next state: Measuring, Butchered, Terminating
263	* @remarks The thread won't enter this state on its own, it is put into this
264	* state by the GIP timer, the CPU online callback and by the
265	* SUP_IOCTL_TSC_DELTA_MEASURE code. */
266	kTscDeltaThreadState_WaitAndMeasure,
267	/** The thread is currently servicing a measurement request.
268	* Previous state: WaitAndMeasure
269	* Next state: Listening, WaitAndMeasure, Terminate */
270	kTscDeltaThreadState_Measuring,
271	/** The thread is terminating.
272	* @remarks The thread won't enter this state on its own, is put into this state
273	* by supdrvTscDeltaTerm. */
274	kTscDeltaThreadState_Terminating,
275	/** The thread is butchered due to an unexpected error.
276	* Previous State: Creating, Listening, WaitAndMeasure */
277	kTscDeltaThreadState_Butchered,
278	/** The thread is destroyed (final).
279	* Previous state: Terminating */
280	kTscDeltaThreadState_Destroyed,
281	/** The usual 32-bit blowup hack. */
282	kTscDeltaThreadState_32BitHack = 0x7fffffff
283	} SUPDRVTSCDELTATHREADSTATE;
284	#endif /* SUPDRV_USE_TSC_DELTA_THREAD */
285
286	/**
287	* Memory reference types.
288	*/
289	typedef enum
290	{
291	/** Unused entry */
292	MEMREF_TYPE_UNUSED = 0,
293	/** Locked memory (r3 mapping only). */
294	MEMREF_TYPE_LOCKED,
295	/** Continuous memory block (r3 and r0 mapping). */
296	MEMREF_TYPE_CONT,
297	/** Low memory block (r3 and r0 mapping). */
298	MEMREF_TYPE_LOW,
299	/** Memory block (r3 and r0 mapping). */
300	MEMREF_TYPE_MEM,
301	/** Locked memory (r3 mapping only) allocated by the support driver. */
302	MEMREF_TYPE_PAGE,
303	/** Blow the type up to 32-bit and mark the end. */
304	MEMREF_TYPE_32BIT_HACK = 0x7fffffff
305	} SUPDRVMEMREFTYPE, *PSUPDRVMEMREFTYPE;
306
307
308	/**
309	* Structure used for tracking memory a session
310	* references in one way or another.
311	*/
312	typedef struct SUPDRVMEMREF
313	{
314	/** The memory object handle. */
315	RTR0MEMOBJ MemObj;
316	/** The ring-3 mapping memory object handle. */
317	RTR0MEMOBJ MapObjR3;
318	/** Type of memory. */
319	SUPDRVMEMREFTYPE eType;
320	} SUPDRVMEMREF, *PSUPDRVMEMREF;
321
322
323	/**
324	* Bundle of locked memory ranges.
325	*/
326	typedef struct SUPDRVBUNDLE
327	{
328	/** Pointer to the next bundle. */
329	struct SUPDRVBUNDLE * volatile pNext;
330	/** Referenced memory. */
331	SUPDRVMEMREF aMem[64];
332	/** Number of entries used. */
333	uint32_t volatile cUsed;
334	} SUPDRVBUNDLE, *PSUPDRVBUNDLE;
335
336
337	/**
338	* Loaded image.
339	*/
340	typedef struct SUPDRVLDRIMAGE
341	{
342	/** Next in chain. */
343	struct SUPDRVLDRIMAGE * volatile pNext;
344	/** Pointer to the image. */
345	void *pvImage;
346	/** Pointer to the allocated image buffer.
347	* pvImage is 32-byte aligned or it may governed by the native loader (this
348	* member is NULL then). */
349	void *pvImageAlloc;
350	/** Size of the image including the tables. This is mainly for verification
351	* of the load request. */
352	uint32_t cbImageWithTabs;
353	/** Size of the image. */
354	uint32_t cbImageBits;
355	/** The number of entries in the symbol table. */
356	uint32_t cSymbols;
357	/** Pointer to the symbol table. */
358	PSUPLDRSYM paSymbols;
359	/** The offset of the string table. */
360	char *pachStrTab;
361	/** Size of the string table. */
362	uint32_t cbStrTab;
363	/** Pointer to the optional module initialization callback. */
364	PFNR0MODULEINIT pfnModuleInit;
365	/** Pointer to the optional module termination callback. */
366	PFNR0MODULETERM pfnModuleTerm;
367	/** Service request handler. This is NULL for non-service modules. */
368	PFNSUPR0SERVICEREQHANDLER pfnServiceReqHandler;
369	/** The ldr image state. (IOCtl code of last operation.) */
370	uint32_t uState;
371	/** Usage count. */
372	uint32_t volatile cUsage;
373	/** Pointer to the device extension. */
374	struct SUPDRVDEVEXT *pDevExt;
375	#ifdef RT_OS_WINDOWS
376	/** The section object for the loaded image (fNative=true). */
377	void *pvNtSectionObj;
378	/** Lock object. */
379	RTR0MEMOBJ hMemLock;
380	#endif
381	#if defined(RT_OS_SOLARIS) && defined(VBOX_WITH_NATIVE_SOLARIS_LOADING)
382	/** The Solaris module ID. */
383	int idSolMod;
384	/** Pointer to the module control structure. */
385	struct modctl *pSolModCtl;
386	#endif
387	/** Whether it's loaded by the native loader or not. */
388	bool fNative;
389	/** Image name. */
390	char szName[32];
391	} SUPDRVLDRIMAGE, *PSUPDRVLDRIMAGE;
392
393
394	/** Image usage record. */
395	typedef struct SUPDRVLDRUSAGE
396	{
397	/** Next in chain. */
398	struct SUPDRVLDRUSAGE * volatile pNext;
399	/** The image. */
400	PSUPDRVLDRIMAGE pImage;
401	/** Load count. */
402	uint32_t volatile cUsage;
403	} SUPDRVLDRUSAGE, *PSUPDRVLDRUSAGE;
404
405
406	/**
407	* Component factory registration record.
408	*/
409	typedef struct SUPDRVFACTORYREG
410	{
411	/** Pointer to the next registration. */
412	struct SUPDRVFACTORYREG *pNext;
413	/** Pointer to the registered factory. */
414	PCSUPDRVFACTORY pFactory;
415	/** The session owning the factory.
416	* Used for deregistration and session cleanup. */
417	PSUPDRVSESSION pSession;
418	/** Length of the name. */
419	size_t cchName;
420	} SUPDRVFACTORYREG;
421	/** Pointer to a component factory registration record. */
422	typedef SUPDRVFACTORYREG *PSUPDRVFACTORYREG;
423	/** Pointer to a const component factory registration record. */
424	typedef SUPDRVFACTORYREG const *PCSUPDRVFACTORYREG;
425
426
427	/**
428	* Registered object.
429	* This takes care of reference counting and tracking data for access checks.
430	*/
431	typedef struct SUPDRVOBJ
432	{
433	/** Magic value (SUPDRVOBJ_MAGIC). */
434	uint32_t u32Magic;
435	/** The object type. */
436	SUPDRVOBJTYPE enmType;
437	/** Pointer to the next in the global list. */
438	struct SUPDRVOBJ * volatile pNext;
439	/** Pointer to the object destructor.
440	* This may be set to NULL if the image containing the destructor get unloaded. */
441	PFNSUPDRVDESTRUCTOR pfnDestructor;
442	/** User argument 1. */
443	void *pvUser1;
444	/** User argument 2. */
445	void *pvUser2;
446	/** The total sum of all per-session usage. */
447	uint32_t volatile cUsage;
448	/** The creator user id. */
449	RTUID CreatorUid;
450	/** The creator group id. */
451	RTGID CreatorGid;
452	/** The creator process id. */
453	RTPROCESS CreatorProcess;
454	} SUPDRVOBJ, *PSUPDRVOBJ;
455
456	/** Magic number for SUPDRVOBJ::u32Magic. (Dame Agatha Mary Clarissa Christie). */
457	#define SUPDRVOBJ_MAGIC UINT32_C(0x18900915)
458	/** Dead number magic for SUPDRVOBJ::u32Magic. */
459	#define SUPDRVOBJ_MAGIC_DEAD UINT32_C(0x19760112)
460
461	/**
462	* The per-session object usage record.
463	*/
464	typedef struct SUPDRVUSAGE
465	{
466	/** Pointer to the next in the list. */
467	struct SUPDRVUSAGE * volatile pNext;
468	/** Pointer to the object we're recording usage for. */
469	PSUPDRVOBJ pObj;
470	/** The usage count. */
471	uint32_t volatile cUsage;
472	} SUPDRVUSAGE, *PSUPDRVUSAGE;
473
474
475	/**
476	* Per session data.
477	* This is mainly for memory tracking.
478	*/
479	typedef struct SUPDRVSESSION
480	{
481	/** Pointer to the device extension. */
482	PSUPDRVDEVEXT pDevExt;
483	/** Session Cookie. */
484	uint32_t u32Cookie;
485	/** Set if is an unrestricted session, clear if restricted. */
486	bool fUnrestricted;
487
488	/** Set if we're in the hash table, clear if not. Protected by the hash
489	* table spinlock. */
490	bool fInHashTable;
491	/** Reference counter. */
492	uint32_t volatile cRefs;
493	/** Pointer to the next session with the same hash (common hash table).
494	* Protected by the hash table spinlock. */
495	PSUPDRVSESSION pCommonNextHash;
496	/** Pointer to the OS specific session pointer, if available and in use.
497	* This is atomically set and cleared as the session is inserted and removed
498	* from the hash table (protected by the session hash table spinlock). */
499	PSUPDRVSESSION *ppOsSessionPtr;
500	/** The process (id) of the session. */
501	RTPROCESS Process;
502	/** Which process this session is associated with.
503	* This is NIL_RTR0PROCESS for kernel sessions and valid for user ones. */
504	RTR0PROCESS R0Process;
505
506	/** The VM associated with the session. */
507	PVM pVM;
508	/** Handle table for IPRT semaphore wrapper APIs.
509	* This takes care of its own locking in an IRQ safe manner. */
510	RTHANDLETABLE hHandleTable;
511	/** Load usage records. (protected by SUPDRVDEVEXT::mtxLdr) */
512	PSUPDRVLDRUSAGE volatile pLdrUsage;
513
514	/** Spinlock protecting the bundles, the GIP members and the
515	* fProcessCleanupDone flag. It continues to be valid until the last
516	* reference to the session is released. */
517	RTSPINLOCK Spinlock;
518	/** The ring-3 mapping of the GIP (readonly). */
519	RTR0MEMOBJ GipMapObjR3;
520	/** Set if the session is using the GIP. */
521	uint32_t fGipReferenced;
522	/** Bundle of locked memory objects. */
523	SUPDRVBUNDLE Bundle;
524	/** List of generic usage records. (protected by SUPDRVDEVEXT::SpinLock) */
525	PSUPDRVUSAGE volatile pUsage;
526
527	/** The user id of the session. (Set by the OS part.) */
528	RTUID Uid;
529	/** The group id of the session. (Set by the OS part.) */
530	RTGID Gid;
531	/** Per session tracer specfic data. */
532	uintptr_t uTracerData;
533	/** The thread currently actively talking to the tracer. (One at the time!) */
534	RTNATIVETHREAD hTracerCaller;
535	/** List of tracepoint providers associated with the session
536	* (SUPDRVTPPROVIDER). */
537	RTLISTANCHOR TpProviders;
538	/** The number of providers in TpProviders. */
539	uint32_t cTpProviders;
540	/** The number of threads active in supdrvIOCtl_TracerUmodProbeFire or
541	* SUPR0TracerUmodProbeFire. */
542	uint32_t volatile cTpProbesFiring;
543	/** User tracepoint modules (PSUPDRVTRACKERUMOD). */
544	RTLISTANCHOR TpUmods;
545	/** The user tracepoint module lookup table. */
546	struct SUPDRVTRACERUMOD *apTpLookupTable[32];
547	/** Whether this is a GIP test-mode client session or not. */
548	bool fGipTestMode;
549	#ifndef SUPDRV_AGNOSTIC
550	# if defined(RT_OS_DARWIN)
551	/** Pointer to the associated org_virtualbox_SupDrvClient object. */
552	void *pvSupDrvClient;
553	/** Whether this session has been opened or not. */
554	bool fOpened;
555	# endif
556	# if defined(RT_OS_OS2)
557	/** The system file number of this session. */
558	uint16_t sfn;
559	uint16_t Alignment; /*< Alignment /
560	# endif
561	# if defined(RT_OS_DARWIN) \|\| defined(RT_OS_OS2) \|\| defined(RT_OS_SOLARIS)
562	/** Pointer to the next session with the same hash. */
563	PSUPDRVSESSION pNextHash;
564	# endif
565	# if defined(RT_OS_WINDOWS) && defined(VBOX_WITH_HARDENING)
566	/** Pointer to the process protection structure for this session. */
567	struct SUPDRVNTPROTECT *pNtProtect;
568	# endif
569	#endif /* !SUPDRV_AGNOSTIC */
570	} SUPDRVSESSION;
571
572
573	/**
574	* Device extension.
575	*/
576	typedef struct SUPDRVDEVEXT
577	{
578	/** Global cookie. */
579	uint32_t u32Cookie;
580	/** The actual size of SUPDRVSESSION. (SUPDRV_AGNOSTIC) */
581	uint32_t cbSession;
582
583	/** Spinlock to serialize the initialization, usage counting and objects.
584	* This is IRQ safe because we want to be able signal semaphores from the
585	* special HM context (and later maybe interrupt handlers), so we must be able
586	* to reference and dereference handles when IRQs are disabled. */
587	RTSPINLOCK Spinlock;
588
589	/** List of registered objects. Protected by the spinlock. */
590	PSUPDRVOBJ volatile pObjs;
591	/** List of free object usage records. */
592	PSUPDRVUSAGE volatile pUsageFree;
593
594	/** Loader mutex.
595	* This protects pvVMMR0, pvVMMR0Entry, pImages and SUPDRVSESSION::pLdrUsage. */
596	#ifdef SUPDRV_USE_MUTEX_FOR_LDR
597	RTSEMMUTEX mtxLdr;
598	#else
599	RTSEMFASTMUTEX mtxLdr;
600	#endif
601
602	/** VMM Module 'handle'.
603	* 0 if the code VMM isn't loaded and Idt are nops. */
604	void * volatile pvVMMR0;
605	/** VMMR0EntryFast() pointer. */
606	DECLR0CALLBACKMEMBER(void, pfnVMMR0EntryFast, (PVM pVM, VMCPUID idCpu, unsigned uOperation));
607	/** VMMR0EntryEx() pointer. */
608	DECLR0CALLBACKMEMBER(int, pfnVMMR0EntryEx, (PVM pVM, VMCPUID idCpu, unsigned uOperation, PSUPVMMR0REQHDR pReq, uint64_t u64Arg, PSUPDRVSESSION pSession));
609
610	/** Linked list of loaded code. */
611	PSUPDRVLDRIMAGE volatile pLdrImages;
612	/** Set if the image loading interface got disabled after loading all needed images */
613	bool fLdrLockedDown;
614
615	/** @name These members for detecting whether an API caller is in ModuleInit.
616	* Certain APIs are only permitted from ModuleInit, like for instance tracepoint
617	* registration.
618	* @{ */
619	/** The image currently executing its ModuleInit. */
620	PSUPDRVLDRIMAGE volatile pLdrInitImage;
621	/** The thread currently executing a ModuleInit function. */
622	RTNATIVETHREAD volatile hLdrInitThread;
623	/** @} */
624
625	/** Number of times someone reported bad execution context via SUPR0BadContext.
626	* (This is times EFLAGS.AC is zero when we expected it to be 1.) */
627	uint32_t volatile cBadContextCalls;
628
629	/** GIP mutex.
630	* Any changes to any of the GIP members requires ownership of this mutex,
631	* except on driver init and termination. */
632	#ifdef SUPDRV_USE_MUTEX_FOR_GIP
633	RTSEMMUTEX mtxGip;
634	#else
635	RTSEMFASTMUTEX mtxGip;
636	#endif
637	/** GIP spinlock protecting GIP members during Mp events.
638	* This is IRQ safe since be may get MP callbacks in contexts where IRQs are
639	* disabled (on some platforms). */
640	RTSPINLOCK hGipSpinlock;
641	/** Pointer to the Global Info Page (GIP). */
642	PSUPGLOBALINFOPAGE pGip;
643	/** The physical address of the GIP. */
644	RTHCPHYS HCPhysGip;
645	/** Number of processes using the GIP.
646	* (The updates are suspend while cGipUsers is 0.)*/
647	uint32_t volatile cGipUsers;
648	/** The ring-0 memory object handle for the GIP page. */
649	RTR0MEMOBJ GipMemObj;
650	/** The GIP timer handle. */
651	PRTTIMER pGipTimer;
652	/** If non-zero we've successfully called RTTimerRequestSystemGranularity(). */
653	uint32_t u32SystemTimerGranularityGrant;
654	/** The CPU id of the GIP master.
655	* This CPU is responsible for the updating the common GIP data and it is
656	* the one used to calculate TSC deltas relative to.
657	* (The initial master will have a 0 zero value, but it it goes offline the
658	* new master may have a non-zero value.) */
659	RTCPUID volatile idGipMaster;
660
661	/** Component factory mutex.
662	* This protects pComponentFactoryHead and component factory querying. */
663	RTSEMFASTMUTEX mtxComponentFactory;
664	/** The head of the list of registered component factories. */
665	PSUPDRVFACTORYREG pComponentFactoryHead;
666
667	/** Lock protecting The tracer members. */
668	RTSEMFASTMUTEX mtxTracer;
669	/** List of tracer providers (SUPDRVTPPROVIDER). */
670	RTLISTANCHOR TracerProviderList;
671	/** List of zombie tracer providers (SUPDRVTPPROVIDER). */
672	RTLISTANCHOR TracerProviderZombieList;
673	/** Pointer to the tracer registration record. */
674	PCSUPDRVTRACERREG pTracerOps;
675	/** The ring-0 session of a native tracer provider. */
676	PSUPDRVSESSION pTracerSession;
677	/** The image containing the tracer. */
678	PSUPDRVLDRIMAGE pTracerImage;
679	/** The tracer helpers. */
680	SUPDRVTRACERHLP TracerHlp;
681	/** The number of session having opened the tracer currently. */
682	uint32_t cTracerOpens;
683	/** The number of threads currently calling into the tracer. */
684	uint32_t volatile cTracerCallers;
685	/** Set if the tracer is being unloaded. */
686	bool fTracerUnloading;
687	/** Hash table for user tracer modules (SUPDRVVTGCOPY). */
688	RTLISTANCHOR aTrackerUmodHash[128];
689
690	/** @name Session Handle Table.
691	* @{ */
692	/** Spinlock protecting apSessionHashTab, cSessions,
693	* SUPDRVSESSION::ppOsSessionPtr, SUPDRVSESSION::pCommonNextHash, and possibly
694	* others depending on the OS. */
695	RTSPINLOCK hSessionHashTabSpinlock;
696	/** Session hash table hash table. The size of this table must make sense in
697	* comparison to GVMM_MAX_HANDLES. */
698	PSUPDRVSESSION apSessionHashTab[HC_ARCH_BITS == 64 ? 8191 : 127];
699	/** The number of open sessions. */
700	int32_t cSessions;
701	/** @} */
702
703	/** @name Invariant TSC frequency refinement.
704	* @{ */
705	/** Nanosecond timestamp at the start of the TSC frequency refinement phase. */
706	uint64_t nsStartInvarTscRefine;
707	/** TSC reading at the start of the TSC frequency refinement phase. */
708	uint64_t uTscStartInvarTscRefine;
709	/** The CPU id of the CPU that u64TscAnchor was measured on. */
710	RTCPUID idCpuInvarTscRefine;
711	/** Pointer to the timer used to refine the TSC frequency. */
712	PRTTIMER pInvarTscRefineTimer;
713	/** Stop the timer on the next tick because we saw a power event. */
714	bool volatile fInvTscRefinePowerEvent;
715	/** @} */
716
717	/** @name TSC-delta measurement.
718	* @{ */
719	/** Number of online/offline events, incremented each time a CPU goes online
720	* or offline. */
721	uint32_t volatile cMpOnOffEvents;
722	/** TSC-delta measurement mutext.
723	* At the moment, we don't want to have more than one measurement going on at
724	* any one time. We might be using broadcast IPIs which are heavy and could
725	* perhaps get in each others way. */
726	#ifdef SUPDRV_USE_MUTEX_FOR_GIP
727	RTSEMMUTEX mtxTscDelta;
728	#else
729	RTSEMFASTMUTEX mtxTscDelta;
730	#endif
731	/** The set of CPUs we need to take measurements for. */
732	RTCPUSET TscDeltaCpuSet;
733	/** The set of CPUs we have completed taken measurements for. */
734	RTCPUSET TscDeltaObtainedCpuSet;
735	/** @} */
736
737	#ifdef SUPDRV_USE_TSC_DELTA_THREAD
738	/** @name TSC-delta measurement thread.
739	* @{ */
740	/** Spinlock protecting enmTscDeltaThreadState. */
741	RTSPINLOCK hTscDeltaSpinlock;
742	/** TSC-delta measurement thread. */
743	RTTHREAD hTscDeltaThread;
744	/** The event signalled during state changes to the TSC-delta thread. */
745	RTSEMEVENT hTscDeltaEvent;
746	/** The state of the TSC-delta measurement thread. */
747	SUPDRVTSCDELTATHREADSTATE enmTscDeltaThreadState;
748	/** Thread timeout time before rechecking state in ms. */
749	RTMSINTERVAL cMsTscDeltaTimeout;
750	/** Whether the TSC-delta measurement was successful. */
751	int32_t volatile rcTscDelta;
752	/** Tell the thread we want TSC-deltas for all CPUs with retries. */
753	bool fTscThreadRecomputeAllDeltas;
754	/** @} */
755	#endif
756
757	/** @name GIP test mode.
758	* @{ */
759	/** Reference counter for GIP test-mode sessions. */
760	uint32_t cGipTestModeRefs;
761	/** Cache of TSC frequency before enabling test-mode on invariant GIP systems. */
762	uint64_t uGipTestModeInvariantCpuHz;
763	/** @} */
764
765	/*
766	* Note! The non-agnostic bits must be at the very end of the structure!
767	*/
768	#ifndef SUPDRV_AGNOSTIC
769	# ifdef RT_OS_WINDOWS
770	/** Callback object returned by ExCreateCallback. */
771	PCALLBACK_OBJECT pObjPowerCallback;
772	/** Callback handle returned by ExRegisterCallback. */
773	PVOID hPowerCallback;
774	# endif
775	#endif
776	} SUPDRVDEVEXT;
777
778	/** Calculates the index into g_apSessionHashTab.*/
779	#define SUPDRV_SESSION_HASH(a_pid) ( (a_pid) % RT_ELEMENTS(((SUPDRVDEVEXT *)NULL)->apSessionHashTab) )
780
781
782	RT_C_DECLS_BEGIN
783
784	/*******************************************************************************
785	* OS Specific Functions *
786	*******************************************************************************/
787	/**
788	* Called to clean up the session structure before it's freed.
789	*
790	* @param pDevExt The device globals.
791	* @param pSession The session that's being cleaned up.
792	*/
793	void VBOXCALL supdrvOSCleanupSession(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession);
794
795	/**
796	* Called to let the OS specfic code perform additional insertion work while
797	* still under the protection of the hash table spinlock.
798	*
799	* @param pDevExt The device globals.
800	* @param pSession The session that was inserted.
801	* @param pvUser User context specified to the insert call.
802	*/
803	void VBOXCALL supdrvOSSessionHashTabInserted(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, void *pvUser);
804
805	/**
806	* Called to let the OS specfic code perform additional removal work while still
807	* under the protection of the hash table spinlock.
808	*
809	* @param pDevExt The device globals.
810	* @param pSession The session that was removed.
811	* @param pvUser User context specified to the remove call.
812	*/
813	void VBOXCALL supdrvOSSessionHashTabRemoved(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, void *pvUser);
814
815	void VBOXCALL supdrvOSObjInitCreator(PSUPDRVOBJ pObj, PSUPDRVSESSION pSession);
816	bool VBOXCALL supdrvOSObjCanAccess(PSUPDRVOBJ pObj, PSUPDRVSESSION pSession, const char pszObjName, int prc);
817	bool VBOXCALL supdrvOSGetForcedAsyncTscMode(PSUPDRVDEVEXT pDevExt);
818	bool VBOXCALL supdrvOSAreCpusOfflinedOnSuspend(void);
819	bool VBOXCALL supdrvOSAreTscDeltasInSync(void);
820	int VBOXCALL supdrvOSEnableVTx(bool fEnabled);
821	RTCCUINTREG VBOXCALL supdrvOSChangeCR4(RTCCUINTREG fOrMask, RTCCUINTREG fAndMask);
822	bool VBOXCALL supdrvOSSuspendVTxOnCpu(void);
823	void VBOXCALL supdrvOSResumeVTxOnCpu(bool fSuspended);
824
825	/**
826	* Try open the image using the native loader.
827	*
828	* @returns IPRT status code.
829	* @retval VERR_NOT_SUPPORTED if native loading isn't supported.
830	*
831	* @param pDevExt The device globals.
832	* @param pImage The image handle. pvImage should be set on
833	* success, pvImageAlloc can also be set if
834	* appropriate.
835	* @param pszFilename The file name - UTF-8, may containing UNIX
836	* slashes on non-UNIX systems.
837	*/
838	int VBOXCALL supdrvOSLdrOpen(PSUPDRVDEVEXT pDevExt, PSUPDRVLDRIMAGE pImage, const char *pszFilename);
839
840	/**
841	* Notification call indicating that a image is being opened for the first time.
842	*
843	* Can be used to log the load address of the image.
844	*
845	* @param pDevExt The device globals.
846	* @param pImage The image handle.
847	*/
848	void VBOXCALL supdrvOSLdrNotifyOpened(PSUPDRVDEVEXT pDevExt, PSUPDRVLDRIMAGE pImage);
849
850	/**
851	* Validates an entry point address.
852	*
853	* Called before supdrvOSLdrLoad.
854	*
855	* @returns IPRT status code.
856	* @param pDevExt The device globals.
857	* @param pImage The image data (still in the open state).
858	* @param pv The address within the image.
859	* @param pbImageBits The image bits as loaded by ring-3.
860	*/
861	int VBOXCALL supdrvOSLdrValidatePointer(PSUPDRVDEVEXT pDevExt, PSUPDRVLDRIMAGE pImage,
862	void pv, const uint8_t pbImageBits);
863
864	/**
865	* Load the image.
866	*
867	* @returns IPRT status code.
868	* @param pDevExt The device globals.
869	* @param pImage The image data (up to date). Adjust entrypoints
870	* and exports if necessary.
871	* @param pbImageBits The image bits as loaded by ring-3.
872	* @param pReq Pointer to the request packet so that the VMMR0
873	* entry points can be adjusted.
874	*/
875	int VBOXCALL supdrvOSLdrLoad(PSUPDRVDEVEXT pDevExt, PSUPDRVLDRIMAGE pImage, const uint8_t *pbImageBits, PSUPLDRLOAD pReq);
876
877
878	/**
879	* Unload the image.
880	*
881	* @param pDevExt The device globals.
882	* @param pImage The image data (mostly still valid).
883	*/
884	void VBOXCALL supdrvOSLdrUnload(PSUPDRVDEVEXT pDevExt, PSUPDRVLDRIMAGE pImage);
885
886
887	#ifdef SUPDRV_WITH_MSR_PROBER
888
889	/**
890	* Tries to read an MSR.
891	*
892	* @returns One of the listed VBox status codes.
893	* @retval VINF_SUCCESS if read successfully, value in *puValue.
894	* @retval VERR_ACCESS_DENIED if we couldn't read it (GP).
895	* @retval VERR_NOT_SUPPORTED if not supported.
896	*
897	* @param uMsr The MSR to read from.
898	* @param idCpu The CPU to read the MSR on. NIL_RTCPUID
899	* indicates any suitable CPU.
900	* @param puValue Where to return the value.
901	*/
902	int VBOXCALL supdrvOSMsrProberRead(uint32_t uMsr, RTCPUID idCpu, uint64_t *puValue);
903
904	/**
905	* Tries to write an MSR.
906	*
907	* @returns One of the listed VBox status codes.
908	* @retval VINF_SUCCESS if written successfully.
909	* @retval VERR_ACCESS_DENIED if we couldn't write the value to it (GP).
910	* @retval VERR_NOT_SUPPORTED if not supported.
911	*
912	* @param uMsr The MSR to write to.
913	* @param idCpu The CPU to write the MSR on. NIL_RTCPUID
914	* indicates any suitable CPU.
915	* @param uValue The value to write.
916	*/
917	int VBOXCALL supdrvOSMsrProberWrite(uint32_t uMsr, RTCPUID idCpu, uint64_t uValue);
918
919	/**
920	* Tries to modify an MSR value.
921	*
922	* @returns One of the listed VBox status codes.
923	* @retval VINF_SUCCESS if succeeded.
924	* @retval VERR_NOT_SUPPORTED if not supported.
925	*
926	* @param idCpu The CPU to modify the MSR on. NIL_RTCPUID
927	* indicates any suitable CPU.
928	* @param pReq The request packet with input arguments and
929	* where to store the results.
930	*/
931	int VBOXCALL supdrvOSMsrProberModify(RTCPUID idCpu, PSUPMSRPROBER pReq);
932
933	#endif /* SUPDRV_WITH_MSR_PROBER */
934
935	#if defined(RT_OS_DARWIN)
936	int VBOXCALL supdrvDarwinResumeSuspendedKbds(void);
937	#endif
938
939	/*******************************************************************************
940	* Shared Functions *
941	*******************************************************************************/
942	/* SUPDrv.c */
943	int VBOXCALL supdrvIOCtl(uintptr_t uIOCtl, PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, PSUPREQHDR pReqHdr, size_t cbReq);
944	int VBOXCALL supdrvIOCtlFast(uintptr_t uIOCtl, VMCPUID idCpu, PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession);
945	int VBOXCALL supdrvIDC(uintptr_t uIOCtl, PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, PSUPDRVIDCREQHDR pReqHdr);
946	int VBOXCALL supdrvInitDevExt(PSUPDRVDEVEXT pDevExt, size_t cbSession);
947	void VBOXCALL supdrvDeleteDevExt(PSUPDRVDEVEXT pDevExt);
948	int VBOXCALL supdrvCreateSession(PSUPDRVDEVEXT pDevExt, bool fUser, bool fUnrestricted, PSUPDRVSESSION *ppSession);
949	int VBOXCALL supdrvSessionHashTabInsert(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, PSUPDRVSESSION ppOsSessionPtr, void pvUser);
950	int VBOXCALL supdrvSessionHashTabRemove(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, void *pvUser);
951	PSUPDRVSESSION VBOXCALL supdrvSessionHashTabLookup(PSUPDRVDEVEXT pDevExt, RTPROCESS Process, RTR0PROCESS R0Process,
952	PSUPDRVSESSION *ppOsSessionPtr);
953	uint32_t VBOXCALL supdrvSessionRetain(PSUPDRVSESSION pSession);
954	uint32_t VBOXCALL supdrvSessionRelease(PSUPDRVSESSION pSession);
955	void VBOXCALL supdrvBadContext(PSUPDRVDEVEXT pDevExt, const char pszFile, uint32_t uLine, const char pszExtra);
956	int VBOXCALL supdrvQueryVTCapsInternal(uint32_t *pfCaps);
957	int VBOXCALL supdrvLdrLoadError(int rc, PSUPLDRLOAD pReq, const char *pszFormat, ...);
958
959	/* SUPDrvGip.cpp */
960	int VBOXCALL supdrvGipCreate(PSUPDRVDEVEXT pDevExt);
961	void VBOXCALL supdrvGipDestroy(PSUPDRVDEVEXT pDevExt);
962	int VBOXCALL supdrvIOCtl_TscDeltaMeasure(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, PSUPTSCDELTAMEASURE pReq);
963	int VBOXCALL supdrvIOCtl_TscRead(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, PSUPTSCREAD pReq);
964	int VBOXCALL supdrvIOCtl_GipSetFlags(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, uint32_t fOrMask, uint32_t fAndMask);
965
966
967	/* SUPDrvTracer.cpp */
968	int VBOXCALL supdrvTracerInit(PSUPDRVDEVEXT pDevExt);
969	void VBOXCALL supdrvTracerTerm(PSUPDRVDEVEXT pDevExt);
970	void VBOXCALL supdrvTracerModuleUnloading(PSUPDRVDEVEXT pDevExt, PSUPDRVLDRIMAGE pImage);
971	void VBOXCALL supdrvTracerCleanupSession(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession);
972	int VBOXCALL supdrvIOCtl_TracerUmodRegister(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession,
973	RTR3PTR R3PtrVtgHdr, RTUINTPTR uVtgHdrAddr,
974	RTR3PTR R3PtrStrTab, uint32_t cbStrTab,
975	const char *pszModName, uint32_t fFlags);
976	int VBOXCALL supdrvIOCtl_TracerUmodDeregister(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, RTR3PTR R3PtrVtgHdr);
977	void VBOXCALL supdrvIOCtl_TracerUmodProbeFire(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, PSUPDRVTRACERUSRCTX pCtx);
978	int VBOXCALL supdrvIOCtl_TracerOpen(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, uint32_t uCookie, uintptr_t uArg);
979	int VBOXCALL supdrvIOCtl_TracerClose(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession);
980	int VBOXCALL supdrvIOCtl_TracerIOCtl(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, uintptr_t uCmd, uintptr_t uArg, int32_t *piRetVal);
981	extern PFNRT g_pfnSupdrvProbeFireKernel;
982	DECLASM(void) supdrvTracerProbeFireStub(void);
983
984	#ifdef VBOX_WITH_NATIVE_DTRACE
985	const SUPDRVTRACERREG * VBOXCALL supdrvDTraceInit(void);
986	#endif
987
988	RT_C_DECLS_END
989
990	#endif
991

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

source: vbox/trunk/src/VBox/HostDrivers/Support/SUPDrvInternal.h@ 57378

Download in other formats: