acenv.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374
  1. /******************************************************************************
  2. *
  3. * Name: acenv.h - Generation environment specific items
  4. *
  5. *****************************************************************************/
  6. /*
  7. * Copyright (C) 2000 - 2008, Intel Corp.
  8. * All rights reserved.
  9. *
  10. * Redistribution and use in source and binary forms, with or without
  11. * modification, are permitted provided that the following conditions
  12. * are met:
  13. * 1. Redistributions of source code must retain the above copyright
  14. * notice, this list of conditions, and the following disclaimer,
  15. * without modification.
  16. * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  17. * substantially similar to the "NO WARRANTY" disclaimer below
  18. * ("Disclaimer") and any redistribution must be conditioned upon
  19. * including a substantially similar Disclaimer requirement for further
  20. * binary redistribution.
  21. * 3. Neither the names of the above-listed copyright holders nor the names
  22. * of any contributors may be used to endorse or promote products derived
  23. * from this software without specific prior written permission.
  24. *
  25. * Alternatively, this software may be distributed under the terms of the
  26. * GNU General Public License ("GPL") version 2 as published by the Free
  27. * Software Foundation.
  28. *
  29. * NO WARRANTY
  30. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  31. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  32. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
  33. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  34. * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  35. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  36. * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  37. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  38. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  39. * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  40. * POSSIBILITY OF SUCH DAMAGES.
  41. */
  42. #ifndef __ACENV_H__
  43. #define __ACENV_H__
  44. /* Types for ACPI_MUTEX_TYPE */
  45. #define ACPI_BINARY_SEMAPHORE 0
  46. #define ACPI_OSL_MUTEX 1
  47. /* Types for DEBUGGER_THREADING */
  48. #define DEBUGGER_SINGLE_THREADED 0
  49. #define DEBUGGER_MULTI_THREADED 1
  50. /******************************************************************************
  51. *
  52. * Configuration for ACPI tools and utilities
  53. *
  54. *****************************************************************************/
  55. #ifdef ACPI_LIBRARY
  56. /*
  57. * Note: The non-debug version of the acpi_library does not contain any
  58. * debug support, for minimal size. The debug version uses ACPI_FULL_DEBUG
  59. */
  60. #define ACPI_USE_LOCAL_CACHE
  61. #endif
  62. #ifdef ACPI_ASL_COMPILER
  63. #define ACPI_DEBUG_OUTPUT
  64. #define ACPI_APPLICATION
  65. #define ACPI_DISASSEMBLER
  66. #define ACPI_CONSTANT_EVAL_ONLY
  67. #define ACPI_LARGE_NAMESPACE_NODE
  68. #define ACPI_DATA_TABLE_DISASSEMBLY
  69. #endif
  70. #ifdef ACPI_EXEC_APP
  71. #undef DEBUGGER_THREADING
  72. #define DEBUGGER_THREADING DEBUGGER_SINGLE_THREADED
  73. #define ACPI_FULL_DEBUG
  74. #define ACPI_APPLICATION
  75. #define ACPI_DEBUGGER
  76. #define ACPI_MUTEX_DEBUG
  77. #define ACPI_DBG_TRACK_ALLOCATIONS
  78. #endif
  79. #ifdef ACPI_APPLICATION
  80. #define ACPI_USE_SYSTEM_CLIBRARY
  81. #define ACPI_USE_LOCAL_CACHE
  82. #endif
  83. #ifdef ACPI_FULL_DEBUG
  84. #define ACPI_DEBUGGER
  85. #define ACPI_DEBUG_OUTPUT
  86. #define ACPI_DISASSEMBLER
  87. #endif
  88. /*
  89. * Environment configuration. The purpose of this file is to interface to the
  90. * local generation environment.
  91. *
  92. * 1) ACPI_USE_SYSTEM_CLIBRARY - Define this if linking to an actual C library.
  93. * Otherwise, local versions of string/memory functions will be used.
  94. * 2) ACPI_USE_STANDARD_HEADERS - Define this if linking to a C library and
  95. * the standard header files may be used.
  96. *
  97. * The ACPI subsystem only uses low level C library functions that do not call
  98. * operating system services and may therefore be inlined in the code.
  99. *
  100. * It may be necessary to tailor these include files to the target
  101. * generation environment.
  102. *
  103. *
  104. * Functions and constants used from each header:
  105. *
  106. * string.h: memcpy
  107. * memset
  108. * strcat
  109. * strcmp
  110. * strcpy
  111. * strlen
  112. * strncmp
  113. * strncat
  114. * strncpy
  115. *
  116. * stdlib.h: strtoul
  117. *
  118. * stdarg.h: va_list
  119. * va_arg
  120. * va_start
  121. * va_end
  122. *
  123. */
  124. /*! [Begin] no source code translation */
  125. #if defined(_LINUX) || defined(__linux__)
  126. #include "aclinux.h"
  127. #elif defined(_AED_EFI)
  128. #include "acefi.h"
  129. #elif defined(WIN32)
  130. #include "acwin.h"
  131. #elif defined(WIN64)
  132. #include "acwin64.h"
  133. #elif defined(MSDOS) /* Must appear after WIN32 and WIN64 check */
  134. #include "acdos16.h"
  135. #elif defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
  136. #include "acfreebsd.h"
  137. #elif defined(__NetBSD__)
  138. #include "acnetbsd.h"
  139. #elif defined(MODESTO)
  140. #include "acmodesto.h"
  141. #elif defined(NETWARE)
  142. #include "acnetware.h"
  143. #elif defined(__sun)
  144. #include "acsolaris.h"
  145. #else
  146. /* All other environments */
  147. #define ACPI_USE_STANDARD_HEADERS
  148. #define COMPILER_DEPENDENT_INT64 long long
  149. #define COMPILER_DEPENDENT_UINT64 unsigned long long
  150. #endif
  151. /*! [End] no source code translation !*/
  152. /******************************************************************************
  153. *
  154. * Miscellaneous configuration
  155. *
  156. *****************************************************************************/
  157. /*
  158. * Are mutexes supported by the host? default is no, use binary semaphores.
  159. */
  160. #ifndef ACPI_MUTEX_TYPE
  161. #define ACPI_MUTEX_TYPE ACPI_BINARY_SEMAPHORE
  162. #endif
  163. /*
  164. * Debugger threading model
  165. * Use single threaded if the entire subsystem is contained in an application
  166. * Use multiple threaded when the subsystem is running in the kernel.
  167. *
  168. * By default the model is single threaded if ACPI_APPLICATION is set,
  169. * multi-threaded if ACPI_APPLICATION is not set.
  170. */
  171. #ifndef DEBUGGER_THREADING
  172. #ifdef ACPI_APPLICATION
  173. #define DEBUGGER_THREADING DEBUGGER_SINGLE_THREADED
  174. #else
  175. #define DEBUGGER_THREADING DEBUGGER_MULTI_THREADED
  176. #endif
  177. #endif /* !DEBUGGER_THREADING */
  178. /******************************************************************************
  179. *
  180. * C library configuration
  181. *
  182. *****************************************************************************/
  183. #define ACPI_IS_ASCII(c) ((c) < 0x80)
  184. #ifdef ACPI_USE_SYSTEM_CLIBRARY
  185. /*
  186. * Use the standard C library headers.
  187. * We want to keep these to a minimum.
  188. */
  189. #ifdef ACPI_USE_STANDARD_HEADERS
  190. /*
  191. * Use the standard headers from the standard locations
  192. */
  193. #include <stdarg.h>
  194. #include <stdlib.h>
  195. #include <string.h>
  196. #include <ctype.h>
  197. #endif /* ACPI_USE_STANDARD_HEADERS */
  198. /*
  199. * We will be linking to the standard Clib functions
  200. */
  201. #define ACPI_STRSTR(s1,s2) strstr((s1), (s2))
  202. #define ACPI_STRCHR(s1,c) strchr((s1), (c))
  203. #define ACPI_STRLEN(s) (acpi_size) strlen((s))
  204. #define ACPI_STRCPY(d,s) (void) strcpy((d), (s))
  205. #define ACPI_STRNCPY(d,s,n) (void) strncpy((d), (s), (acpi_size)(n))
  206. #define ACPI_STRNCMP(d,s,n) strncmp((d), (s), (acpi_size)(n))
  207. #define ACPI_STRCMP(d,s) strcmp((d), (s))
  208. #define ACPI_STRCAT(d,s) (void) strcat((d), (s))
  209. #define ACPI_STRNCAT(d,s,n) strncat((d), (s), (acpi_size)(n))
  210. #define ACPI_STRTOUL(d,s,n) strtoul((d), (s), (acpi_size)(n))
  211. #define ACPI_MEMCMP(s1,s2,n) memcmp((const char *)(s1), (const char *)(s2), (acpi_size)(n))
  212. #define ACPI_MEMCPY(d,s,n) (void) memcpy((d), (s), (acpi_size)(n))
  213. #define ACPI_MEMSET(d,s,n) (void) memset((d), (s), (acpi_size)(n))
  214. #define ACPI_TOUPPER(i) toupper((int) (i))
  215. #define ACPI_TOLOWER(i) tolower((int) (i))
  216. #define ACPI_IS_XDIGIT(i) isxdigit((int) (i))
  217. #define ACPI_IS_DIGIT(i) isdigit((int) (i))
  218. #define ACPI_IS_SPACE(i) isspace((int) (i))
  219. #define ACPI_IS_UPPER(i) isupper((int) (i))
  220. #define ACPI_IS_PRINT(i) isprint((int) (i))
  221. #define ACPI_IS_ALPHA(i) isalpha((int) (i))
  222. #else
  223. /******************************************************************************
  224. *
  225. * Not using native C library, use local implementations
  226. *
  227. *****************************************************************************/
  228. /*
  229. * Use local definitions of C library macros and functions
  230. * NOTE: The function implementations may not be as efficient
  231. * as an inline or assembly code implementation provided by a
  232. * native C library.
  233. */
  234. #ifndef va_arg
  235. #ifndef _VALIST
  236. #define _VALIST
  237. typedef char *va_list;
  238. #endif /* _VALIST */
  239. /*
  240. * Storage alignment properties
  241. */
  242. #define _AUPBND (sizeof (acpi_native_int) - 1)
  243. #define _ADNBND (sizeof (acpi_native_int) - 1)
  244. /*
  245. * Variable argument list macro definitions
  246. */
  247. #define _bnd(X, bnd) (((sizeof (X)) + (bnd)) & (~(bnd)))
  248. #define va_arg(ap, T) (*(T *)(((ap) += (_bnd (T, _AUPBND))) - (_bnd (T,_ADNBND))))
  249. #define va_end(ap) (void) 0
  250. #define va_start(ap, A) (void) ((ap) = (((char *) &(A)) + (_bnd (A,_AUPBND))))
  251. #endif /* va_arg */
  252. #define ACPI_STRSTR(s1,s2) acpi_ut_strstr ((s1), (s2))
  253. #define ACPI_STRCHR(s1,c) acpi_ut_strchr ((s1), (c))
  254. #define ACPI_STRLEN(s) (acpi_size) acpi_ut_strlen ((s))
  255. #define ACPI_STRCPY(d,s) (void) acpi_ut_strcpy ((d), (s))
  256. #define ACPI_STRNCPY(d,s,n) (void) acpi_ut_strncpy ((d), (s), (acpi_size)(n))
  257. #define ACPI_STRNCMP(d,s,n) acpi_ut_strncmp ((d), (s), (acpi_size)(n))
  258. #define ACPI_STRCMP(d,s) acpi_ut_strcmp ((d), (s))
  259. #define ACPI_STRCAT(d,s) (void) acpi_ut_strcat ((d), (s))
  260. #define ACPI_STRNCAT(d,s,n) acpi_ut_strncat ((d), (s), (acpi_size)(n))
  261. #define ACPI_STRTOUL(d,s,n) acpi_ut_strtoul ((d), (s), (acpi_size)(n))
  262. #define ACPI_MEMCMP(s1,s2,n) acpi_ut_memcmp((const char *)(s1), (const char *)(s2), (acpi_size)(n))
  263. #define ACPI_MEMCPY(d,s,n) (void) acpi_ut_memcpy ((d), (s), (acpi_size)(n))
  264. #define ACPI_MEMSET(d,v,n) (void) acpi_ut_memset ((d), (v), (acpi_size)(n))
  265. #define ACPI_TOUPPER acpi_ut_to_upper
  266. #define ACPI_TOLOWER acpi_ut_to_lower
  267. #endif /* ACPI_USE_SYSTEM_CLIBRARY */
  268. /******************************************************************************
  269. *
  270. * Assembly code macros
  271. *
  272. *****************************************************************************/
  273. /*
  274. * Handle platform- and compiler-specific assembly language differences.
  275. * These should already have been defined by the platform includes above.
  276. *
  277. * Notes:
  278. * 1) Interrupt 3 is used to break into a debugger
  279. * 2) Interrupts are turned off during ACPI register setup
  280. */
  281. /* Unrecognized compiler, use defaults */
  282. #ifndef ACPI_ASM_MACROS
  283. /*
  284. * Calling conventions:
  285. *
  286. * ACPI_SYSTEM_XFACE - Interfaces to host OS (handlers, threads)
  287. * ACPI_EXTERNAL_XFACE - External ACPI interfaces
  288. * ACPI_INTERNAL_XFACE - Internal ACPI interfaces
  289. * ACPI_INTERNAL_VAR_XFACE - Internal variable-parameter list interfaces
  290. */
  291. #define ACPI_SYSTEM_XFACE
  292. #define ACPI_EXTERNAL_XFACE
  293. #define ACPI_INTERNAL_XFACE
  294. #define ACPI_INTERNAL_VAR_XFACE
  295. #define ACPI_ASM_MACROS
  296. #define BREAKPOINT3
  297. #define ACPI_DISABLE_IRQS()
  298. #define ACPI_ENABLE_IRQS()
  299. #define ACPI_ACQUIRE_GLOBAL_LOCK(Glptr, acq)
  300. #define ACPI_RELEASE_GLOBAL_LOCK(Glptr, acq)
  301. #endif /* ACPI_ASM_MACROS */
  302. #ifdef ACPI_APPLICATION
  303. /* Don't want software interrupts within a ring3 application */
  304. #undef BREAKPOINT3
  305. #define BREAKPOINT3
  306. #endif
  307. /******************************************************************************
  308. *
  309. * Compiler-specific information is contained in the compiler-specific
  310. * headers.
  311. *
  312. *****************************************************************************/
  313. #endif /* __ACENV_H__ */