acenv.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393
  1. /******************************************************************************
  2. *
  3. * Name: acenv.h - Host and compiler configuration
  4. *
  5. *****************************************************************************/
  6. /*
  7. * Copyright (C) 2000 - 2013, 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. /*
  45. * Environment configuration. The purpose of this file is to interface ACPICA
  46. * to the local environment. This includes compiler-specific, OS-specific,
  47. * and machine-specific configuration.
  48. */
  49. /* Types for ACPI_MUTEX_TYPE */
  50. #define ACPI_BINARY_SEMAPHORE 0
  51. #define ACPI_OSL_MUTEX 1
  52. /* Types for DEBUGGER_THREADING */
  53. #define DEBUGGER_SINGLE_THREADED 0
  54. #define DEBUGGER_MULTI_THREADED 1
  55. /******************************************************************************
  56. *
  57. * Configuration for ACPI tools and utilities
  58. *
  59. *****************************************************************************/
  60. /* iASL configuration */
  61. #ifdef ACPI_ASL_COMPILER
  62. #define ACPI_APPLICATION
  63. #define ACPI_DISASSEMBLER
  64. #define ACPI_DEBUG_OUTPUT
  65. #define ACPI_CONSTANT_EVAL_ONLY
  66. #define ACPI_LARGE_NAMESPACE_NODE
  67. #define ACPI_DATA_TABLE_DISASSEMBLY
  68. #define ACPI_SINGLE_THREADED
  69. #endif
  70. /* acpi_exec configuration. Multithreaded with full AML debugger */
  71. #ifdef ACPI_EXEC_APP
  72. #define ACPI_APPLICATION
  73. #define ACPI_FULL_DEBUG
  74. #define ACPI_MUTEX_DEBUG
  75. #define ACPI_DBG_TRACK_ALLOCATIONS
  76. #endif
  77. /* acpi_names configuration. Single threaded with debugger output enabled. */
  78. #ifdef ACPI_NAMES_APP
  79. #define ACPI_DEBUGGER
  80. #define ACPI_APPLICATION
  81. #define ACPI_SINGLE_THREADED
  82. #endif
  83. /*
  84. * acpi_bin/acpi_help/acpi_src configuration. All single threaded, with
  85. * no debug output.
  86. */
  87. #if (defined ACPI_BIN_APP) || \
  88. (defined ACPI_SRC_APP) || \
  89. (defined ACPI_XTRACT_APP)
  90. #define ACPI_APPLICATION
  91. #define ACPI_SINGLE_THREADED
  92. #endif
  93. #ifdef ACPI_HELP_APP
  94. #define ACPI_APPLICATION
  95. #define ACPI_SINGLE_THREADED
  96. #define ACPI_NO_ERROR_MESSAGES
  97. #endif
  98. /* Linkable ACPICA library */
  99. #ifdef ACPI_LIBRARY
  100. #define ACPI_USE_LOCAL_CACHE
  101. #define ACPI_FUTURE_USAGE
  102. #endif
  103. /* Common for all ACPICA applications */
  104. #ifdef ACPI_APPLICATION
  105. #define ACPI_USE_SYSTEM_CLIBRARY
  106. #define ACPI_USE_LOCAL_CACHE
  107. #endif
  108. /* Common debug support */
  109. #ifdef ACPI_FULL_DEBUG
  110. #define ACPI_DEBUGGER
  111. #define ACPI_DEBUG_OUTPUT
  112. #define ACPI_DISASSEMBLER
  113. #endif
  114. /*! [Begin] no source code translation */
  115. /******************************************************************************
  116. *
  117. * Host configuration files. The compiler configuration files are included
  118. * by the host files.
  119. *
  120. *****************************************************************************/
  121. #if defined(_LINUX) || defined(__linux__)
  122. #include <acpi/platform/aclinux.h>
  123. #elif defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
  124. #include "acfreebsd.h"
  125. #elif defined(__NetBSD__)
  126. #include "acnetbsd.h"
  127. #elif defined(__sun)
  128. #include "acsolaris.h"
  129. #elif defined(MODESTO)
  130. #include "acmodesto.h"
  131. #elif defined(NETWARE)
  132. #include "acnetware.h"
  133. #elif defined(_CYGWIN)
  134. #include "accygwin.h"
  135. #elif defined(WIN32)
  136. #include "acwin.h"
  137. #elif defined(WIN64)
  138. #include "acwin64.h"
  139. #elif defined(_WRS_LIB_BUILD)
  140. #include "acvxworks.h"
  141. #elif defined(__OS2__)
  142. #include "acos2.h"
  143. #elif defined(_AED_EFI)
  144. #include "acefi.h"
  145. #elif defined(__HAIKU__)
  146. #include "achaiku.h"
  147. #else
  148. /* Unknown environment */
  149. #error Unknown target environment
  150. #endif
  151. /*! [End] no source code translation !*/
  152. /******************************************************************************
  153. *
  154. * Setup defaults for the required symbols that were not defined in one of
  155. * the host/compiler files above.
  156. *
  157. *****************************************************************************/
  158. /* 64-bit data types */
  159. #ifndef COMPILER_DEPENDENT_INT64
  160. #define COMPILER_DEPENDENT_INT64 long long
  161. #endif
  162. #ifndef COMPILER_DEPENDENT_UINT64
  163. #define COMPILER_DEPENDENT_UINT64 unsigned long long
  164. #endif
  165. /* Type of mutex supported by host. Default is binary semaphores. */
  166. #ifndef ACPI_MUTEX_TYPE
  167. #define ACPI_MUTEX_TYPE ACPI_BINARY_SEMAPHORE
  168. #endif
  169. /* Global Lock acquire/release */
  170. #ifndef ACPI_ACQUIRE_GLOBAL_LOCK
  171. #define ACPI_ACQUIRE_GLOBAL_LOCK(Glptr, acquired) acquired = 1
  172. #endif
  173. #ifndef ACPI_RELEASE_GLOBAL_LOCK
  174. #define ACPI_RELEASE_GLOBAL_LOCK(Glptr, pending) pending = 0
  175. #endif
  176. /* Flush CPU cache - used when going to sleep. Wbinvd or similar. */
  177. #ifndef ACPI_FLUSH_CPU_CACHE
  178. #define ACPI_FLUSH_CPU_CACHE()
  179. #endif
  180. /* "inline" keywords - configurable since inline is not standardized */
  181. #ifndef ACPI_INLINE
  182. #define ACPI_INLINE
  183. #endif
  184. /*
  185. * Configurable calling conventions:
  186. *
  187. * ACPI_SYSTEM_XFACE - Interfaces to host OS (handlers, threads)
  188. * ACPI_EXTERNAL_XFACE - External ACPI interfaces
  189. * ACPI_INTERNAL_XFACE - Internal ACPI interfaces
  190. * ACPI_INTERNAL_VAR_XFACE - Internal variable-parameter list interfaces
  191. */
  192. #ifndef ACPI_SYSTEM_XFACE
  193. #define ACPI_SYSTEM_XFACE
  194. #endif
  195. #ifndef ACPI_EXTERNAL_XFACE
  196. #define ACPI_EXTERNAL_XFACE
  197. #endif
  198. #ifndef ACPI_INTERNAL_XFACE
  199. #define ACPI_INTERNAL_XFACE
  200. #endif
  201. #ifndef ACPI_INTERNAL_VAR_XFACE
  202. #define ACPI_INTERNAL_VAR_XFACE
  203. #endif
  204. /*
  205. * Debugger threading model
  206. * Use single threaded if the entire subsystem is contained in an application
  207. * Use multiple threaded when the subsystem is running in the kernel.
  208. *
  209. * By default the model is single threaded if ACPI_APPLICATION is set,
  210. * multi-threaded if ACPI_APPLICATION is not set.
  211. */
  212. #ifndef DEBUGGER_THREADING
  213. #ifdef ACPI_APPLICATION
  214. #define DEBUGGER_THREADING DEBUGGER_SINGLE_THREADED
  215. #else
  216. #define DEBUGGER_THREADING DEBUGGER_MULTI_THREADED
  217. #endif
  218. #endif /* !DEBUGGER_THREADING */
  219. /******************************************************************************
  220. *
  221. * C library configuration
  222. *
  223. *****************************************************************************/
  224. /*
  225. * ACPI_USE_SYSTEM_CLIBRARY - Define this if linking to an actual C library.
  226. * Otherwise, local versions of string/memory functions will be used.
  227. * ACPI_USE_STANDARD_HEADERS - Define this if linking to a C library and
  228. * the standard header files may be used.
  229. *
  230. * The ACPICA subsystem only uses low level C library functions that do not call
  231. * operating system services and may therefore be inlined in the code.
  232. *
  233. * It may be necessary to tailor these include files to the target
  234. * generation environment.
  235. */
  236. #ifdef ACPI_USE_SYSTEM_CLIBRARY
  237. /* Use the standard C library headers. We want to keep these to a minimum. */
  238. #ifdef ACPI_USE_STANDARD_HEADERS
  239. /* Use the standard headers from the standard locations */
  240. #include <stdarg.h>
  241. #include <stdlib.h>
  242. #include <string.h>
  243. #include <ctype.h>
  244. #endif /* ACPI_USE_STANDARD_HEADERS */
  245. /* We will be linking to the standard Clib functions */
  246. #define ACPI_STRSTR(s1,s2) strstr((s1), (s2))
  247. #define ACPI_STRCHR(s1,c) strchr((s1), (c))
  248. #define ACPI_STRLEN(s) (acpi_size) strlen((s))
  249. #define ACPI_STRCPY(d,s) (void) strcpy((d), (s))
  250. #define ACPI_STRNCPY(d,s,n) (void) strncpy((d), (s), (acpi_size)(n))
  251. #define ACPI_STRNCMP(d,s,n) strncmp((d), (s), (acpi_size)(n))
  252. #define ACPI_STRCMP(d,s) strcmp((d), (s))
  253. #define ACPI_STRCAT(d,s) (void) strcat((d), (s))
  254. #define ACPI_STRNCAT(d,s,n) strncat((d), (s), (acpi_size)(n))
  255. #define ACPI_STRTOUL(d,s,n) strtoul((d), (s), (acpi_size)(n))
  256. #define ACPI_MEMCMP(s1,s2,n) memcmp((const char *)(s1), (const char *)(s2), (acpi_size)(n))
  257. #define ACPI_MEMCPY(d,s,n) (void) memcpy((d), (s), (acpi_size)(n))
  258. #define ACPI_MEMSET(d,s,n) (void) memset((d), (s), (acpi_size)(n))
  259. #define ACPI_TOUPPER(i) toupper((int) (i))
  260. #define ACPI_TOLOWER(i) tolower((int) (i))
  261. #define ACPI_IS_XDIGIT(i) isxdigit((int) (i))
  262. #define ACPI_IS_DIGIT(i) isdigit((int) (i))
  263. #define ACPI_IS_SPACE(i) isspace((int) (i))
  264. #define ACPI_IS_UPPER(i) isupper((int) (i))
  265. #define ACPI_IS_PRINT(i) isprint((int) (i))
  266. #define ACPI_IS_ALPHA(i) isalpha((int) (i))
  267. #else
  268. /******************************************************************************
  269. *
  270. * Not using native C library, use local implementations
  271. *
  272. *****************************************************************************/
  273. /*
  274. * Use local definitions of C library macros and functions. These function
  275. * implementations may not be as efficient as an inline or assembly code
  276. * implementation provided by a native C library, but they are functionally
  277. * equivalent.
  278. */
  279. #ifndef va_arg
  280. #ifndef _VALIST
  281. #define _VALIST
  282. typedef char *va_list;
  283. #endif /* _VALIST */
  284. /* Storage alignment properties */
  285. #define _AUPBND (sizeof (acpi_native_int) - 1)
  286. #define _ADNBND (sizeof (acpi_native_int) - 1)
  287. /* Variable argument list macro definitions */
  288. #define _bnd(X, bnd) (((sizeof (X)) + (bnd)) & (~(bnd)))
  289. #define va_arg(ap, T) (*(T *)(((ap) += (_bnd (T, _AUPBND))) - (_bnd (T,_ADNBND))))
  290. #define va_end(ap) (ap = (va_list) NULL)
  291. #define va_start(ap, A) (void) ((ap) = (((char *) &(A)) + (_bnd (A,_AUPBND))))
  292. #endif /* va_arg */
  293. /* Use the local (ACPICA) definitions of the clib functions */
  294. #define ACPI_STRSTR(s1,s2) acpi_ut_strstr ((s1), (s2))
  295. #define ACPI_STRCHR(s1,c) acpi_ut_strchr ((s1), (c))
  296. #define ACPI_STRLEN(s) (acpi_size) acpi_ut_strlen ((s))
  297. #define ACPI_STRCPY(d,s) (void) acpi_ut_strcpy ((d), (s))
  298. #define ACPI_STRNCPY(d,s,n) (void) acpi_ut_strncpy ((d), (s), (acpi_size)(n))
  299. #define ACPI_STRNCMP(d,s,n) acpi_ut_strncmp ((d), (s), (acpi_size)(n))
  300. #define ACPI_STRCMP(d,s) acpi_ut_strcmp ((d), (s))
  301. #define ACPI_STRCAT(d,s) (void) acpi_ut_strcat ((d), (s))
  302. #define ACPI_STRNCAT(d,s,n) acpi_ut_strncat ((d), (s), (acpi_size)(n))
  303. #define ACPI_STRTOUL(d,s,n) acpi_ut_strtoul ((d), (s), (acpi_size)(n))
  304. #define ACPI_MEMCMP(s1,s2,n) acpi_ut_memcmp((const char *)(s1), (const char *)(s2), (acpi_size)(n))
  305. #define ACPI_MEMCPY(d,s,n) (void) acpi_ut_memcpy ((d), (s), (acpi_size)(n))
  306. #define ACPI_MEMSET(d,v,n) (void) acpi_ut_memset ((d), (v), (acpi_size)(n))
  307. #define ACPI_TOUPPER(c) acpi_ut_to_upper ((int) (c))
  308. #define ACPI_TOLOWER(c) acpi_ut_to_lower ((int) (c))
  309. #endif /* ACPI_USE_SYSTEM_CLIBRARY */
  310. #endif /* __ACENV_H__ */