spinlock.h revision b1e4a6ea2daf00ed7ad30f29a6fcafcedb69a3ac
/** @file
* InnoTek Portable Runtime - Spinlocks.
*/
/*
* Copyright (C) 2006 InnoTek Systemberatung GmbH
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* General Public License as published by the Free Software Foundation,
* in version 2 as it comes in the "COPYING" file of the VirtualBox OSE
* distribution. VirtualBox OSE is distributed in the hope that it will
* be useful, but WITHOUT ANY WARRANTY of any kind.
*
* If you received this file as part of a commercial VirtualBox
* distribution, then only the terms of your commercial VirtualBox
* license agreement apply instead of the previous paragraph.
*/
#ifndef __iprt_spinlock_h__
#define __iprt_spinlock_h__
/** @defgroup grp_rt_spinlock RTSpinlock - Spinlocks
* @ingroup grp_rt
* @{
*/
/**
* Temporary spinlock state variable.
* All members are undefined and highly platform specific.
*/
typedef struct RTSPINLOCKTMP
{
#ifdef IN_RING0
# ifdef __LINUX__
/** The saved [R|E]FLAGS. */
unsigned long flFlags;
# define RTSPINLOCKTMP_INITIALIZER { 0 }
/** The saved [R|E]FLAGS. */
/** The KIRQL. */
unsigned char uchIrqL;
# define RTSPINLOCKTMP_INITIALIZER { 0, 0 }
/** The saved [R|E]FLAGS. */
unsigned long flFlags;
# define RTSPINLOCKTMP_INITIALIZER { 0 }
# elif defined(__DARWIN__)
/** The saved [R|E]FLAGS. */
# define RTSPINLOCKTMP_INITIALIZER { 0 }
/** The saved [R|E]FLAGS. (dummy) */
# define RTSPINLOCKTMP_INITIALIZER { 0 }
# else
# error "Your OS is not supported.\n"
/** The saved [R|E]FLAGS. */
# endif
#else /* !IN_RING0 */
/** The saved [R|E]FLAGS.
* (RT spinlocks will by definition disable interrupts.) */
# define RTSPINLOCKTMP_INITIALIZER { 0 }
#endif /* !IN_RING0 */
/** Pointer to a temporary spinlock state variable. */
typedef RTSPINLOCKTMP *PRTSPINLOCKTMP;
/** Pointer to a const temporary spinlock state variable. */
typedef const RTSPINLOCKTMP *PCRTSPINLOCKTMP;
/** @def RTSPINLOCKTMP_INITIALIZER
* What to assign to a RTSPINLOCKTMP at definition.
*/
#ifdef __DOXYGEN__
# define RTSPINLOCKTMP_INITIALIZER
#endif
/**
* Creates a spinlock.
*
* @returns iprt status code.
* @param pSpinlock Where to store the spinlock handle.
*/
/**
* Destroys a spinlock created by RTSpinlockCreate().
*
* @returns iprt status code.
* @param Spinlock Spinlock returned by RTSpinlockCreate().
*/
/**
* Acquires the spinlock.
* Interrupts are disabled upon return.
*
* @param Spinlock The spinlock to acquire.
* @param pTmp Where to save the state.
*/
/**
* Releases the spinlock.
*
* @param Spinlock The spinlock to acquire.
* @param pTmp The state to restore. (This better be the same as for the RTSpinlockAcquire() call!)
*/
/**
* Acquires the spinlock.
*
* @param Spinlock The spinlock to acquire.
* @param pTmp Where to save the state.
*/
/**
* Releases the spinlock.
*
* @param Spinlock The spinlock to acquire.
* @param pTmp The state to restore. (This better be the same as for the RTSpinlockAcquire() call!)
*/
/** @} */
#endif