SUPDRV.h revision d0d2b0c8f3a61896d483a4405ebfed9baa2ca058
4778ff543a041ac356d6e661cc9b66c3fafa2092Adam Moore/* $Revision$ */
4778ff543a041ac356d6e661cc9b66c3fafa2092Adam Moore/** @file
2c5ce90c334a2d0f18474e85c93b424b6ec9daaaAdam Moore * VirtualBox Support Driver - Internal header.
4778ff543a041ac356d6e661cc9b66c3fafa2092Adam Moore */
2c5ce90c334a2d0f18474e85c93b424b6ec9daaaAdam Moore
4778ff543a041ac356d6e661cc9b66c3fafa2092Adam Moore/*
c4e6d94ea429e473a6732b6eb5e0fc980e822881Adam Moore * Copyright (C) 2006-2007 Sun Microsystems, Inc.
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore *
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * This file is part of VirtualBox Open Source Edition (OSE), as
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * available from http://www.virtualbox.org. This file is free software;
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore * you can redistribute it and/or modify it under the terms of the GNU
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * General Public License (GPL) as published by the Free Software
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * Foundation, in version 2 as it comes in the "COPYING" file of the
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore *
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore * The contents of this file may alternatively be used under the terms
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * of the Common Development and Distribution License Version 1.0
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore * VirtualBox OSE distribution, in which case the provisions of the
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * CDDL are applicable instead of those of the GPL.
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore *
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * You may elect to license modified versions of this file under the
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * terms and conditions of either the GPL or the CDDL or both.
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore *
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * Clara, CA 95054 USA or visit http://www.sun.com if you need
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore * additional information or have any questions.
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore */
9fb523cf517ad4d6a53ae9f461d672cba63835d2Adam Moore
9fb523cf517ad4d6a53ae9f461d672cba63835d2Adam Moore#ifndef ___SUPDRV_h
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore#define ___SUPDRV_h
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore/*******************************************************************************
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore* Header Files *
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore*******************************************************************************/
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore#include <VBox/cdefs.h>
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore#include <VBox/types.h>
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore#include <iprt/assert.h>
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore#include <iprt/asm.h>
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore#include <VBox/sup.h>
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore#ifdef USE_NEW_OS_INTERFACE
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# define USE_NEW_OS_INTERFACE_FOR_MM
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore# define USE_NEW_OS_INTERFACE_FOR_GIP
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore# undef USE_NEW_OS_INTERFACE_FOR_LOW
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore#endif
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore#if defined(USE_NEW_OS_INTERFACE) || defined(USE_NEW_OS_INTERFACE_FOR_LOW) || defined(USE_NEW_OS_INTERFACE_FOR_MM) || defined(USE_NEW_OS_INTERFACE_FOR_GIP)
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore# include <iprt/memobj.h>
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore# include <iprt/time.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <iprt/timer.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <iprt/string.h>
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore# include <iprt/err.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore#endif
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore#if defined(RT_OS_WINDOWS)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore __BEGIN_DECLS
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# if (_MSC_VER >= 1400) && !defined(VBOX_WITH_PATCHED_DDK)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# define _InterlockedExchange _InterlockedExchange_StupidDDKVsCompilerCrap
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore# define _InterlockedExchangeAdd _InterlockedExchangeAdd_StupidDDKVsCompilerCrap
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# define _InterlockedCompareExchange _InterlockedCompareExchange_StupidDDKVsCompilerCrap
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# define _InterlockedAddLargeStatistic _InterlockedAddLargeStatistic_StupidDDKVsCompilerCrap
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <ntddk.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# undef _InterlockedExchange
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# undef _InterlockedExchangeAdd
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# undef _InterlockedCompareExchange
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# undef _InterlockedAddLargeStatistic
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# else
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <ntddk.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# endif
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <memory.h>
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore# define memcmp(a,b,c) mymemcmp(a,b,c)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore int VBOXCALL mymemcmp(const void *, const void *, size_t);
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore __END_DECLS
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore#elif defined(RT_OS_LINUX)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <linux/autoconf.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <linux/version.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# if defined(CONFIG_MODVERSIONS) && !defined(MODVERSIONS)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# define MODVERSIONS
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# if LINUX_VERSION_CODE < KERNEL_VERSION(2, 5, 71)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <linux/modversions.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# endif
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore# endif
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# if LINUX_VERSION_CODE > KERNEL_VERSION(2, 6, 0)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# undef ALIGN
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# endif
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# ifndef KBUILD_STR
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# if LINUX_VERSION_CODE < KERNEL_VERSION(2, 6, 16)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# define KBUILD_STR(s) s
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# else
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# define KBUILD_STR(s) #s
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# endif
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# endif
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore# include <linux/string.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <linux/spinlock.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <linux/slab.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <asm/semaphore.h>
87b084086b5937585acc7e091b2f1951e94d9145Adam Moore# include <linux/timer.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# if 0
87b084086b5937585acc7e091b2f1951e94d9145Adam Moore# include <linux/hrtimer.h>
87b084086b5937585acc7e091b2f1951e94d9145Adam Moore# define VBOX_HRTIMER
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# endif
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore#elif defined(RT_OS_DARWIN)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <libkern/libkern.h>
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore# include <iprt/string.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore#elif defined(RT_OS_OS2)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore#elif defined(RT_OS_FREEBSD)
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <sys/libkern.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore# include <iprt/string.h>
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore
d4dbc3afb5bb9cfd13490b358dc37bf951104ca7Adam Moore#elif defined(RT_OS_SOLARIS)
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore# include <sys/cmn_err.h>
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore# include <iprt/string.h>
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore#else
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore# error "unsupported OS."
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore#endif
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore#include "SUPDRVIOC.h"
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore/*******************************************************************************
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore* Defined Constants And Macros *
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore*******************************************************************************/
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore/*
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * Hardcoded cookies.
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore */
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore#define BIRD 0x64726962 /* 'bird' */
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore#define BIRD_INV 0x62697264 /* 'drib' */
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore
91ff24e65531ce8bf171340d9384182f8c168af3Adam Moore
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore/*
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * Win32
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore */
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore#if defined(RT_OS_WINDOWS)
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore
87d6b0a14cce52c4faa4b78fc9878eb553dab0d5Adam Moore/* debug printf */
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore# define OSDBGPRINT(a) DbgPrint a
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore
efa57736d44cf446f1661497a8645bd388b493fbAdam Moore/** Maximum number of bytes we try to lock down in one go.
efa57736d44cf446f1661497a8645bd388b493fbAdam Moore * This is supposed to have a limit right below 256MB, but this appears
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * to actually be much lower. The values here have been determined experimentally.
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore */
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore#ifdef RT_ARCH_X86
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore# define MAX_LOCK_MEM_SIZE (32*1024*1024) /* 32mb */
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore#endif
ba2701ee03e94104edf19911ee0989f8cee11088Adam Moore#ifdef RT_ARCH_AMD64
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore# define MAX_LOCK_MEM_SIZE (24*1024*1024) /* 24mb */
ba2701ee03e94104edf19911ee0989f8cee11088Adam Moore#endif
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore/*
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore * Linux
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore */
1b298c6f0ef597aa4ab0b8bcb25430b6c9a87749Adam Moore#elif defined(RT_OS_LINUX)
c4e6d94ea429e473a6732b6eb5e0fc980e822881Adam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/* check kernel version */
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore#if LINUX_VERSION_CODE < KERNEL_VERSION(2, 4, 0)
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore# error Unsupported kernel version!
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore#endif
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore__BEGIN_DECLS
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Mooreint linux_dprintf(const char *format, ...);
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore__END_DECLS
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/* debug printf */
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore# define OSDBGPRINT(a) printk a
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/*
9fb523cf517ad4d6a53ae9f461d672cba63835d2Adam Moore * Darwin
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore */
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore#elif defined(RT_OS_DARWIN)
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/* debug printf */
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore# define OSDBGPRINT(a) printf a
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/*
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore * OS/2
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore */
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore#elif defined(RT_OS_OS2)
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/* No log API in OS/2 only COM port. */
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore# define OSDBGPRINT(a) SUPR0Printf a
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/*
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore * FreeBSD
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore */
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore#elif defined(RT_OS_FREEBSD)
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/* No log API in OS/2 only COM port. */
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore# define OSDBGPRINT(a) printf a
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
9fb523cf517ad4d6a53ae9f461d672cba63835d2Adam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/*
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore * Solaris
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore */
9fb523cf517ad4d6a53ae9f461d672cba63835d2Adam Moore#elif defined(RT_OS_SOLARIS)
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore# define OSDBGPRINT(a) SUPR0Printf a
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
9fb523cf517ad4d6a53ae9f461d672cba63835d2Adam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore#else
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/** @todo other os'es */
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore# error "OS interface defines is not done for this OS!"
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore#endif
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore
3395e5fc071521d4e6b258ef4c7c0ef38601b94eAdam Moore/* dprintf */
c4e6d94ea429e473a6732b6eb5e0fc980e822881Adam Moore#if (defined(DEBUG) && !defined(NO_LOGGING)) || defined(RT_OS_FREEBSD)
# ifdef LOG_TO_COM
# include <VBox/log.h>
# define dprintf(a) RTLogComPrintf a
# else
# define dprintf(a) OSDBGPRINT(a)
# endif
#else
# define dprintf(a) do {} while (0)
#endif
/* dprintf2 - extended logging. */
#if defined(RT_OS_DARWIN) || defined(RT_OS_OS2) || defined(RT_OS_FREEBSD)
# define dprintf2 dprintf
#else
# define dprintf2(a) do { } while (0)
#endif
/*
* Error codes.
*/
/** Invalid parameter. */
#define SUPDRV_ERR_GENERAL_FAILURE (-1)
/** Invalid parameter. */
#define SUPDRV_ERR_INVALID_PARAM (-2)
/** Invalid magic or cookie. */
#define SUPDRV_ERR_INVALID_MAGIC (-3)
/** Invalid loader handle. */
#define SUPDRV_ERR_INVALID_HANDLE (-4)
/** Failed to lock the address range. */
#define SUPDRV_ERR_LOCK_FAILED (-5)
/** Invalid memory pointer. */
#define SUPDRV_ERR_INVALID_POINTER (-6)
/** Failed to patch the IDT. */
#define SUPDRV_ERR_IDT_FAILED (-7)
/** Memory allocation failed. */
#define SUPDRV_ERR_NO_MEMORY (-8)
/** Already loaded. */
#define SUPDRV_ERR_ALREADY_LOADED (-9)
/** Permission denied. */
#define SUPDRV_ERR_PERMISSION_DENIED (-10)
/** Version mismatch. */
#define SUPDRV_ERR_VERSION_MISMATCH (-11)
/*******************************************************************************
* Structures and Typedefs *
*******************************************************************************/
/** Pointer to the device extension. */
typedef struct SUPDRVDEVEXT *PSUPDRVDEVEXT;
#ifdef RT_OS_LINUX
# ifdef VBOX_HRTIMER
typedef struct hrtimer VBOXKTIMER;
# else
typedef struct timer_list VBOXKTIMER;
# endif
typedef VBOXKTIMER *PVBOXKTIMER;
#endif
#ifdef VBOX_WITH_IDT_PATCHING
/**
* An IDT Entry.
*/
typedef struct SUPDRVIDTE
{
/** Low offset word. */
uint32_t u16OffsetLow : 16;
/** Segment Selector. */
uint32_t u16SegSel : 16;
#ifdef RT_ARCH_AMD64
/** Interrupt Stack Table index. */
uint32_t u3IST : 3;
/** Reserved, ignored. */
uint32_t u5Reserved : 5;
#else
/** Reserved. */
uint32_t u5Reserved : 5;
/** IDT Type part one (not used for task gate). */
uint32_t u3Type1 : 3;
#endif
/** IDT Type part two. */
uint32_t u5Type2 : 5;
/** Descriptor Privilege level. */
uint32_t u2DPL : 2;
/** Present flag. */
uint32_t u1Present : 1;
/** High offset word. */
uint32_t u16OffsetHigh : 16;
#ifdef RT_ARCH_AMD64
/** The upper top part of the address. */
uint32_t u32OffsetTop;
/** Reserved dword for qword (aligning the struct), ignored. */
uint32_t u32Reserved;
#endif
} SUPDRVIDTE, *PSUPDRVIDTE;
/** The u5Type2 value for an interrupt gate. */
#define SUPDRV_IDTE_TYPE2_INTERRUPT_GATE 0x0e
/**
* Patch code.
*/
typedef struct SUPDRVPATCH
{
#define SUPDRV_PATCH_CODE_SIZE 0x50
/** Patch code. */
uint8_t auCode[SUPDRV_PATCH_CODE_SIZE];
/** Changed IDT entry (for parnoid UnpatchIdt()). */
SUPDRVIDTE ChangedIdt;
/** Saved IDT entry. */
SUPDRVIDTE SavedIdt;
/** Pointer to the IDT.
* We ASSUME the IDT is not re(al)located after bootup and use this as key
* for the patches rather than processor number. This prevents some
* stupid nesting stuff from happening in case of processors sharing the
* IDT.
* We're fucked if the processors have different physical mapping for
* the(se) page(s), but we'll find that out soon enough in VBOX_STRICT mode.
*/
void *pvIdt;
/** Pointer to the IDT entry. */
SUPDRVIDTE volatile *pIdtEntry;
/** Usage counter. */
uint32_t volatile cUsage;
/** The offset into auCode of the VMMR0Entry fixup. */
uint16_t offVMMR0EntryFixup;
/** The offset into auCode of the stub function. */
uint16_t offStub;
/** Pointer to the next patch. */
struct SUPDRVPATCH * volatile pNext;
} SUPDRVPATCH, *PSUPDRVPATCH;
/**
* Usage record for a patch.
*/
typedef struct SUPDRVPATCHUSAGE
{
/** Next in the chain. */
struct SUPDRVPATCHUSAGE * volatile pNext;
/** The patch this usage applies to. */
PSUPDRVPATCH pPatch;
/** Usage count. */
uint32_t volatile cUsage;
} SUPDRVPATCHUSAGE, *PSUPDRVPATCHUSAGE;
#endif /* VBOX_WITH_IDT_PATCHING */
/**
* Memory reference types.
*/
typedef enum
{
/** Unused entry */
MEMREF_TYPE_UNUSED = 0,
/** Locked memory (r3 mapping only). */
MEMREF_TYPE_LOCKED,
/** Continous memory block (r3 and r0 mapping). */
MEMREF_TYPE_CONT,
/** Low memory block (r3 and r0 mapping). */
MEMREF_TYPE_LOW,
/** Memory block (r3 and r0 mapping). */
MEMREF_TYPE_MEM,
/** Locked memory (r3 mapping only) allocated by the support driver. */
MEMREF_TYPE_LOCKED_SUP,
/** Blow the type up to 32-bit and mark the end. */
MEMREG_TYPE_32BIT_HACK = 0x7fffffff
} SUPDRVMEMREFTYPE, *PSUPDRVMEMREFTYPE;
/**
* Structure used for tracking memory a session
* references in one way or another.
*/
typedef struct SUPDRVMEMREF
{
#ifdef USE_NEW_OS_INTERFACE_FOR_MM
/** The memory object handle. */
RTR0MEMOBJ MemObj;
/** The ring-3 mapping memory object handle. */
RTR0MEMOBJ MapObjR3;
/** Type of memory. */
SUPDRVMEMREFTYPE eType;
#else /* !USE_NEW_OS_INTERFACE_FOR_MM */
/** Pointer to the R0 mapping of the memory.
* Set to NULL if N/A. */
void *pvR0;
/** Pointer to the R3 mapping of the memory.
* Set to NULL if N/A. */
RTR3PTR pvR3;
/** Size of the locked memory. */
unsigned cb;
/** Type of memory. */
SUPDRVMEMREFTYPE eType;
/** memory type specific information. */
union
{
struct
{
#if defined(RT_OS_WINDOWS)
/** Pointer to memory descriptor list (MDL). */
PMDL *papMdl;
unsigned cMdls;
#elif defined(RT_OS_LINUX)
struct page **papPages;
unsigned cPages;
#else
# error "Either no target was defined or we haven't ported the driver to the target yet."
#endif
} locked;
struct
{
#if defined(RT_OS_WINDOWS)
/** Pointer to memory descriptor list (MDL). */
PMDL pMdl;
#elif defined(RT_OS_LINUX)
struct page *paPages;
unsigned cPages;
#else
# error "Either no target was defined or we haven't ported the driver to the target yet."
#endif
} cont;
struct
{
#if defined(RT_OS_WINDOWS)
/** Pointer to memory descriptor list (MDL). */
PMDL pMdl;
#elif defined(RT_OS_LINUX)
/** Pointer to the array of page pointers. */
struct page **papPages;
/** Number of pages in papPages. */
unsigned cPages;
#else
# error "Either no target was defined or we haven't ported the driver to the target yet."
#endif
} mem;
#if defined(USE_NEW_OS_INTERFACE_FOR_LOW)
struct
{
/** The memory object handle. */
RTR0MEMOBJ MemObj;
/** The ring-3 mapping memory object handle. */
RTR0MEMOBJ MapObjR3;
} iprt;
#endif
} u;
#endif /* !USE_NEW_OS_INTERFACE_FOR_MM */
} SUPDRVMEMREF, *PSUPDRVMEMREF;
/**
* Bundle of locked memory ranges.
*/
typedef struct SUPDRVBUNDLE
{
/** Pointer to the next bundle. */
struct SUPDRVBUNDLE * volatile pNext;
/** Referenced memory. */
SUPDRVMEMREF aMem[64];
/** Number of entries used. */
uint32_t volatile cUsed;
} SUPDRVBUNDLE, *PSUPDRVBUNDLE;
/**
* Loaded image.
*/
typedef struct SUPDRVLDRIMAGE
{
/** Next in chain. */
struct SUPDRVLDRIMAGE * volatile pNext;
/** Pointer to the image. */
void *pvImage;
/** Pointer to the optional module initialization callback. */
PFNR0MODULEINIT pfnModuleInit;
/** Pointer to the optional module termination callback. */
PFNR0MODULETERM pfnModuleTerm;
/** Size of the image. */
uint32_t cbImage;
/** The offset of the symbol table. */
uint32_t offSymbols;
/** The number of entries in the symbol table. */
uint32_t cSymbols;
/** The offset of the string table. */
uint32_t offStrTab;
/** Size of the string table. */
uint32_t cbStrTab;
/** The ldr image state. (IOCtl code of last opration.) */
uint32_t uState;
/** Usage count. */
uint32_t volatile cUsage;
/** Image name. */
char szName[32];
} SUPDRVLDRIMAGE, *PSUPDRVLDRIMAGE;
/** Image usage record. */
typedef struct SUPDRVLDRUSAGE
{
/** Next in chain. */
struct SUPDRVLDRUSAGE * volatile pNext;
/** The image. */
PSUPDRVLDRIMAGE pImage;
/** Load count. */
uint32_t volatile cUsage;
} SUPDRVLDRUSAGE, *PSUPDRVLDRUSAGE;
/**
* Registered object.
* This takes care of reference counting and tracking data for access checks.
*/
typedef struct SUPDRVOBJ
{
/** Magic value (SUPDRVOBJ_MAGIC). */
uint32_t u32Magic;
/** The object type. */
SUPDRVOBJTYPE enmType;
/** Pointer to the next in the global list. */
struct SUPDRVOBJ * volatile pNext;
/** Pointer to the object destructor.
* This may be set to NULL if the image containing the destructor get unloaded. */
PFNSUPDRVDESTRUCTOR pfnDestructor;
/** User argument 1. */
void *pvUser1;
/** User argument 2. */
void *pvUser2;
/** The total sum of all per-session usage. */
uint32_t volatile cUsage;
/** The creator user id. */
RTUID CreatorUid;
/** The creator group id. */
RTGID CreatorGid;
/** The creator process id. */
RTPROCESS CreatorProcess;
} SUPDRVOBJ, *PSUPDRVOBJ;
/** Magic number for SUPDRVOBJ::u32Magic. (Dame Agatha Mary Clarissa Christie). */
#define SUPDRVOBJ_MAGIC 0x18900915
/**
* The per-session object usage record.
*/
typedef struct SUPDRVUSAGE
{
/** Pointer to the next in the list. */
struct SUPDRVUSAGE * volatile pNext;
/** Pointer to the object we're recording usage for. */
PSUPDRVOBJ pObj;
/** The usage count. */
uint32_t volatile cUsage;
} SUPDRVUSAGE, *PSUPDRVUSAGE;
/**
* Per session data.
* This is mainly for memory tracking.
*/
typedef struct SUPDRVSESSION
{
/** Pointer to the device extension. */
PSUPDRVDEVEXT pDevExt;
/** Session Cookie. */
uint32_t u32Cookie;
/** Load usage records. (protected by SUPDRVDEVEXT::mtxLdr) */
PSUPDRVLDRUSAGE volatile pLdrUsage;
#ifdef VBOX_WITH_IDT_PATCHING
/** Patch usage records. (protected by SUPDRVDEVEXT::SpinLock) */
PSUPDRVPATCHUSAGE volatile pPatchUsage;
#endif
/** The VM associated with the session. */
PVM pVM;
/** List of generic usage records. (protected by SUPDRVDEVEXT::SpinLock) */
PSUPDRVUSAGE volatile pUsage;
/** Spinlock protecting the bundles and the GIP members. */
RTSPINLOCK Spinlock;
#ifdef USE_NEW_OS_INTERFACE_FOR_GIP
/** The ring-3 mapping of the GIP (readonly). */
RTR0MEMOBJ GipMapObjR3;
#else
/** The read-only usermode mapping address of the GID.
* This is NULL if the GIP hasn't been mapped. */
PSUPGLOBALINFOPAGE pGip;
#endif
/** Set if the session is using the GIP. */
uint32_t fGipReferenced;
/** Bundle of locked memory objects. */
SUPDRVBUNDLE Bundle;
/** The user id of the session. (Set by the OS part.) */
RTUID Uid;
/** The group id of the session. (Set by the OS part.) */
RTGID Gid;
/** The process (id) of the session. (Set by the OS part.) */
RTPROCESS Process;
/** Which process this session is associated with. */
RTR0PROCESS R0Process;
#if defined(RT_OS_OS2)
/** The system file number of this session. */
uint16_t sfn;
uint16_t Alignment; /**< Alignment */
#endif
#if defined(RT_OS_DARWIN) || defined(RT_OS_OS2) || defined(RT_OS_SOLARIS)
/** Pointer to the next session with the same hash. */
PSUPDRVSESSION pNextHash;
#endif
} SUPDRVSESSION;
/**
* Device extension.
*/
typedef struct SUPDRVDEVEXT
{
/** Spinlock to serialize the initialization,
* usage counting and destruction of the IDT entry override and objects. */
RTSPINLOCK Spinlock;
#ifdef VBOX_WITH_IDT_PATCHING
/** List of patches. */
PSUPDRVPATCH volatile pIdtPatches;
/** List of patches Free. */
PSUPDRVPATCH volatile pIdtPatchesFree;
#endif
/** List of registered objects. Protected by the spinlock. */
PSUPDRVOBJ volatile pObjs;
/** List of free object usage records. */
PSUPDRVUSAGE volatile pUsageFree;
/** Global cookie. */
uint32_t u32Cookie;
/** The IDT entry number.
* Only valid if pIdtPatches is set. */
uint8_t volatile u8Idt;
/** Loader mutex.
* This protects pvVMMR0, pvVMMR0Entry, pImages and SUPDRVSESSION::pLdrUsage. */
RTSEMFASTMUTEX mtxLdr;
/** VMM Module 'handle'.
* 0 if the code VMM isn't loaded and Idt are nops. */
void * volatile pvVMMR0;
/** VMMR0EntryInt() pointer. */
DECLR0CALLBACKMEMBER(int, pfnVMMR0EntryInt, (PVM pVM, unsigned uOperation, void *pvArg));
/** VMMR0EntryFast() pointer. */
DECLR0CALLBACKMEMBER(int, pfnVMMR0EntryFast, (PVM pVM, unsigned uOperation));
/** VMMR0EntryEx() pointer. */
DECLR0CALLBACKMEMBER(int, pfnVMMR0EntryEx, (PVM pVM, unsigned uOperation, PSUPVMMR0REQHDR pReq, uint64_t u64Arg));
/** Linked list of loaded code. */
PSUPDRVLDRIMAGE volatile pLdrImages;
/** GIP mutex.
* Any changes to any of the GIP members requires ownership of this mutex,
* except on driver init and termination. */
RTSEMFASTMUTEX mtxGip;
/** Pointer to the Global Info Page (GIP). */
PSUPGLOBALINFOPAGE pGip;
/** The physical address of the GIP. */
RTHCPHYS HCPhysGip;
/** Number of processes using the GIP.
* (The updates are suspend while cGipUsers is 0.)*/
uint32_t volatile cGipUsers;
#ifdef USE_NEW_OS_INTERFACE_FOR_GIP
/** The ring-0 memory object handle for the GIP page. */
RTR0MEMOBJ GipMemObj;
/** The GIP timer handle. */
PRTTIMER pGipTimer;
/** If non-zero we've successfully called RTTimerRequestSystemGranularity(). */
uint32_t u32SystemTimerGranularityGrant;
/** The CPU id of the GIP master.
* This CPU is responsible for the updating the common GIP data. */
RTCPUID volatile idGipMaster;
#else
# ifdef RT_OS_WINDOWS
/** The GIP timer object. */
KTIMER GipTimer;
/** The GIP DPC object associated with GipTimer. */
KDPC GipDpc;
/** The GIP DPC objects for updating per-cpu data. */
KDPC aGipCpuDpcs[MAXIMUM_PROCESSORS];
/** Pointer to the MDL for the pGip page. */
PMDL pGipMdl;
/** GIP timer interval (ms). */
ULONG ulGipTimerInterval;
/** Current CPU affinity mask. */
KAFFINITY uAffinityMask;
# endif
# ifdef RT_OS_LINUX
/** The last jiffies. */
unsigned long ulLastJiffies;
/** The last mono time stamp. */
uint64_t volatile u64LastMonotime;
/** Set when GIP is suspended to prevent the timers from re-registering themselves). */
uint8_t volatile fGIPSuspended;
# ifdef CONFIG_SMP
/** Array of per CPU data for SUPGIPMODE_ASYNC_TSC. */
struct LINUXCPU
{
/** The last mono time stamp. */
uint64_t volatile u64LastMonotime;
/** The last jiffies. */
unsigned long ulLastJiffies;
/** The Linux Process ID. */
unsigned iSmpProcessorId;
/** The per cpu timer. */
VBOXKTIMER Timer;
} aCPUs[256];
# endif
# endif /* LINUX */
#endif /* !USE_NEW_OS_INTERFACE_FOR_GIP */
} SUPDRVDEVEXT;
__BEGIN_DECLS
/*******************************************************************************
* OS Specific Functions *
*******************************************************************************/
void VBOXCALL supdrvOSObjInitCreator(PSUPDRVOBJ pObj, PSUPDRVSESSION pSession);
bool VBOXCALL supdrvOSObjCanAccess(PSUPDRVOBJ pObj, PSUPDRVSESSION pSession, const char *pszObjName, int *prc);
#ifndef USE_NEW_OS_INTERFACE_FOR_MM
int VBOXCALL supdrvOSLockMemOne(PSUPDRVMEMREF pMem, PSUPPAGE paPages);
void VBOXCALL supdrvOSUnlockMemOne(PSUPDRVMEMREF pMem);
int VBOXCALL supdrvOSContAllocOne(PSUPDRVMEMREF pMem, PRTR0PTR ppvR0, PRTR3PTR ppvR3, PRTHCPHYS pHCPhys);
void VBOXCALL supdrvOSContFreeOne(PSUPDRVMEMREF pMem);
int VBOXCALL supdrvOSLowAllocOne(PSUPDRVMEMREF pMem, PRTR0PTR ppvR0, PRTR3PTR ppvR3, PSUPPAGE paPages);
void VBOXCALL supdrvOSLowFreeOne(PSUPDRVMEMREF pMem);
int VBOXCALL supdrvOSMemAllocOne(PSUPDRVMEMREF pMem, PRTR0PTR ppvR0, PRTR3PTR ppvR3);
void VBOXCALL supdrvOSMemGetPages(PSUPDRVMEMREF pMem, PSUPPAGE paPages);
void VBOXCALL supdrvOSMemFreeOne(PSUPDRVMEMREF pMem);
#endif
#ifndef USE_NEW_OS_INTERFACE_FOR_GIP
int VBOXCALL supdrvOSGipMap(PSUPDRVDEVEXT pDevExt, PSUPGLOBALINFOPAGE *ppGip);
int VBOXCALL supdrvOSGipUnmap(PSUPDRVDEVEXT pDevExt, PSUPGLOBALINFOPAGE pGip);
void VBOXCALL supdrvOSGipResume(PSUPDRVDEVEXT pDevExt);
void VBOXCALL supdrvOSGipSuspend(PSUPDRVDEVEXT pDevExt);
#endif
#ifdef RT_OS_WINDOWS /** @todo remove when RTMpGetCount() has been fixed. */
unsigned VBOXCALL supdrvOSGetCPUCount(PSUPDRVDEVEXT pDevExt);
#endif
bool VBOXCALL supdrvOSGetForcedAsyncTscMode(PSUPDRVDEVEXT pDevExt);
/*******************************************************************************
* Shared Functions *
*******************************************************************************/
int VBOXCALL supdrvIOCtl(uintptr_t uIOCtl, PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, PSUPREQHDR pReqHdr);
int VBOXCALL supdrvIOCtlFast(uintptr_t uIOCtl, PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession);
int VBOXCALL supdrvInitDevExt(PSUPDRVDEVEXT pDevExt);
void VBOXCALL supdrvDeleteDevExt(PSUPDRVDEVEXT pDevExt);
int VBOXCALL supdrvCreateSession(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION *ppSession);
void VBOXCALL supdrvCloseSession(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession);
void VBOXCALL supdrvCleanupSession(PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession);
int VBOXCALL supdrvGipInit(PSUPDRVDEVEXT pDevExt, PSUPGLOBALINFOPAGE pGip, RTHCPHYS HCPhys, uint64_t u64NanoTS, unsigned uUpdateHz);
void VBOXCALL supdrvGipTerm(PSUPGLOBALINFOPAGE pGip);
void VBOXCALL supdrvGipUpdate(PSUPGLOBALINFOPAGE pGip, uint64_t u64NanoTS);
void VBOXCALL supdrvGipUpdatePerCpu(PSUPGLOBALINFOPAGE pGip, uint64_t u64NanoTS, unsigned iCpu);
bool VBOXCALL supdrvDetermineAsyncTsc(uint64_t *pu64DiffCores);
__END_DECLS
#endif