1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
|
/* $Id: iprt.h $ */
/** @file
* IPRT - Internal header for miscellaneous global defs and types.
*/
/*
* Copyright (C) 2009-2020 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* you can redistribute it and/or modify it under the terms of the GNU
* General Public License (GPL) 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.
*
* The contents of this file may alternatively be used under the terms
* of the Common Development and Distribution License Version 1.0
* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
* VirtualBox OSE distribution, in which case the provisions of the
* CDDL are applicable instead of those of the GPL.
*
* You may elect to license modified versions of this file under the
* terms and conditions of either the GPL or the CDDL or both.
*/
#ifndef IPRT_INCLUDED_INTERNAL_iprt_h
#define IPRT_INCLUDED_INTERNAL_iprt_h
#ifndef RT_WITHOUT_PRAGMA_ONCE
# pragma once
#endif
#include <iprt/cdefs.h>
#include <iprt/types.h>
/** @def RT_EXPORT_SYMBOL
* This define is really here just for the linux kernel.
* @param Name The symbol name.
*/
#if defined(RT_OS_LINUX) \
&& defined(IN_RING0) \
&& defined(MODULE) \
&& !defined(RT_NO_EXPORT_SYMBOL)
# define bool linux_bool /* see r0drv/linux/the-linux-kernel.h */
# include <linux/version.h>
# if LINUX_VERSION_CODE >= KERNEL_VERSION(2, 6, 33)
# include <generated/autoconf.h>
# else
# ifndef AUTOCONF_INCLUDED
# include <linux/autoconf.h>
# endif
# endif
# if defined(CONFIG_MODVERSIONS) && !defined(MODVERSIONS)
# define MODVERSIONS
# if LINUX_VERSION_CODE < KERNEL_VERSION(2, 5, 71)
# include <linux/modversions.h>
# endif
# endif
# include <linux/module.h>
# undef bool
# define RT_EXPORT_SYMBOL(Name) EXPORT_SYMBOL(Name)
#else
# define RT_EXPORT_SYMBOL(Name) extern int g_rtExportSymbolDummyVariable
#endif
/** @def RT_MORE_STRICT
* Enables more assertions in IPRT. */
#if !defined(RT_MORE_STRICT) && (defined(DEBUG) || defined(RT_STRICT) || defined(DOXYGEN_RUNNING)) && !defined(RT_OS_WINDOWS) /** @todo enable on windows after testing */
# define RT_MORE_STRICT
#endif
/** @def RT_ASSERT_PREEMPT_CPUID_VAR
* Partner to RT_ASSERT_PREEMPT_CPUID_VAR. Declares and initializes a variable
* idAssertCpu to NIL_RTCPUID if preemption is enabled and to RTMpCpuId if
* disabled. When RT_MORE_STRICT isn't defined it declares an uninitialized
* dummy variable.
*
* Requires iprt/mp.h and iprt/asm.h.
*/
/** @def RT_ASSERT_PREEMPT_CPUID
* Asserts that we didn't change CPU since RT_ASSERT_PREEMPT_CPUID_VAR if
* preemption is disabled. Will also detect changes in preemption
* disable/enable status. This is a noop when RT_MORE_STRICT isn't defined. */
#ifdef RT_MORE_STRICT
# define RT_ASSERT_PREEMPT_CPUID_VAR() \
RTCPUID const idAssertCpu = RTThreadPreemptIsEnabled(NIL_RTTHREAD) ? NIL_RTCPUID : RTMpCpuId()
# define RT_ASSERT_PREEMPT_CPUID() \
do \
{ \
RTCPUID const idAssertCpuNow = RTThreadPreemptIsEnabled(NIL_RTTHREAD) ? NIL_RTCPUID : RTMpCpuId(); \
AssertMsg(idAssertCpu == idAssertCpuNow, ("%#x, %#x\n", idAssertCpu, idAssertCpuNow)); \
} while (0)
#else
# define RT_ASSERT_PREEMPT_CPUID_VAR() RTCPUID idAssertCpuDummy
# define RT_ASSERT_PREEMPT_CPUID() NOREF(idAssertCpuDummy)
#endif
/** @def RT_ASSERT_PREEMPT_CPUID_SPIN_ACQUIRED
* Extended version of RT_ASSERT_PREEMPT_CPUID for use before
* RTSpinlockAcquired* returns. This macro works the idCpuOwner and idAssertCpu
* members of the spinlock instance data. */
#ifdef RT_MORE_STRICT
# define RT_ASSERT_PREEMPT_CPUID_SPIN_ACQUIRED(pThis) \
do \
{ \
RTCPUID const idAssertCpuNow = RTMpCpuId(); \
AssertMsg(idAssertCpu == idAssertCpuNow || idAssertCpu == NIL_RTCPUID, ("%#x, %#x\n", idAssertCpu, idAssertCpuNow)); \
(pThis)->idAssertCpu = idAssertCpu; \
(pThis)->idCpuOwner = idAssertCpuNow; \
} while (0)
#else
# define RT_ASSERT_PREEMPT_CPUID_SPIN_ACQUIRED(pThis) NOREF(idAssertCpuDummy)
#endif
/** @def RT_ASSERT_PREEMPT_CPUID_SPIN_RELEASE_VARS
* Extended version of RT_ASSERT_PREEMPT_CPUID_VAR for use with
* RTSpinlockRelease* returns. */
#ifdef RT_MORE_STRICT
# define RT_ASSERT_PREEMPT_CPUID_SPIN_RELEASE_VARS() RTCPUID idAssertCpu
#else
# define RT_ASSERT_PREEMPT_CPUID_SPIN_RELEASE_VARS() RTCPUID idAssertCpuDummy
#endif
/** @def RT_ASSERT_PREEMPT_CPUID_SPIN_RELEASE
* Extended version of RT_ASSERT_PREEMPT_CPUID for use in RTSpinlockRelease*
* before calling the native API for releasing the spinlock. It must be
* teamed up with RT_ASSERT_PREEMPT_CPUID_SPIN_ACQUIRED. */
#ifdef RT_MORE_STRICT
# define RT_ASSERT_PREEMPT_CPUID_SPIN_RELEASE(pThis) \
do \
{ \
RTCPUID const idCpuOwner = (pThis)->idCpuOwner; \
RTCPUID const idAssertCpuNow = RTMpCpuId(); \
AssertMsg(idCpuOwner == idAssertCpuNow, ("%#x, %#x\n", idCpuOwner, idAssertCpuNow)); \
(pThis)->idCpuOwner = NIL_RTCPUID; \
idAssertCpu = (pThis)->idAssertCpu; \
(pThis)->idAssertCpu = NIL_RTCPUID; \
} while (0)
#else
# define RT_ASSERT_PREEMPT_CPUID_SPIN_RELEASE(pThis) NOREF(idAssertCpuDummy)
#endif
/** @def RT_ASSERT_PREEMPT_CPUID_DISABLE
* For use in RTThreadPreemptDisable implementations after having disabled
* preemption. Requires iprt/mp.h. */
#ifdef RT_MORE_STRICT
# define RT_ASSERT_PREEMPT_CPUID_DISABLE(pStat) \
do \
{ \
Assert((pStat)->idCpu == NIL_RTCPUID); \
(pStat)->idCpu = RTMpCpuId(); \
} while (0)
#else
# define RT_ASSERT_PREEMPT_CPUID_DISABLE(pStat) \
Assert((pStat)->idCpu == NIL_RTCPUID)
#endif
/** @def RT_ASSERT_PREEMPT_CPUID_RESTORE
* For use in RTThreadPreemptRestore implementations before restoring
* preemption. Requires iprt/mp.h. */
#ifdef RT_MORE_STRICT
# define RT_ASSERT_PREEMPT_CPUID_RESTORE(pStat) \
do \
{ \
RTCPUID const idAssertCpuNow = RTMpCpuId(); \
AssertMsg((pStat)->idCpu == idAssertCpuNow, ("%#x, %#x\n", (pStat)->idCpu, idAssertCpuNow)); \
(pStat)->idCpu = NIL_RTCPUID; \
} while (0)
#else
# define RT_ASSERT_PREEMPT_CPUID_RESTORE(pStat) do { } while (0)
#endif
/** @def RT_ASSERT_INTS_ON
* Asserts that interrupts are disabled when RT_MORE_STRICT is defined. */
#ifdef RT_MORE_STRICT
# if defined(RT_ARCH_AMD64) || defined(RT_ARCH_X86)
# define RT_ASSERT_INTS_ON() Assert(ASMIntAreEnabled())
# else /* PORTME: Add architecture/platform specific test. */
# define RT_ASSERT_INTS_ON() Assert(RTThreadPreemptIsEnabled(NIL_RTTHREAD))
# endif
#else
# define RT_ASSERT_INTS_ON() do { } while (0)
#endif
/** @def RT_ASSERT_PREEMPTIBLE
* Asserts that preemption hasn't been disabled (using
* RTThreadPreemptDisable) when RT_MORE_STRICT is defined. */
#ifdef RT_MORE_STRICT
# define RT_ASSERT_PREEMPTIBLE() Assert(RTThreadPreemptIsEnabled(NIL_RTTHREAD))
#else
# define RT_ASSERT_PREEMPTIBLE() do { } while (0)
#endif
RT_C_DECLS_BEGIN
#ifdef RT_OS_OS2
uint32_t rtR0SemWaitOs2ConvertTimeout(uint32_t fFlags, uint64_t uTimeout);
#endif
RT_C_DECLS_END
#endif /* !IPRT_INCLUDED_INTERNAL_iprt_h */
|
