utglobal.c 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739
  1. /******************************************************************************
  2. *
  3. * Module Name: utglobal - Global variables for the ACPI subsystem
  4. *
  5. *****************************************************************************/
  6. /*
  7. * Copyright (C) 2000 - 2007, R. Byron Moore
  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. #define DEFINE_ACPI_GLOBALS
  43. #include <acpi/acpi.h>
  44. #include <acpi/acnamesp.h>
  45. ACPI_EXPORT_SYMBOL(acpi_gbl_FADT)
  46. #define _COMPONENT ACPI_UTILITIES
  47. ACPI_MODULE_NAME("utglobal")
  48. /*******************************************************************************
  49. *
  50. * Static global variable initialization.
  51. *
  52. ******************************************************************************/
  53. /*
  54. * We want the debug switches statically initialized so they
  55. * are already set when the debugger is entered.
  56. */
  57. /* Debug switch - level and trace mask */
  58. u32 acpi_dbg_level = ACPI_DEBUG_DEFAULT;
  59. /* Debug switch - layer (component) mask */
  60. u32 acpi_dbg_layer = ACPI_COMPONENT_DEFAULT | ACPI_ALL_DRIVERS;
  61. u32 acpi_gbl_nesting_level = 0;
  62. /* Debugger globals */
  63. u8 acpi_gbl_db_terminate_threads = FALSE;
  64. u8 acpi_gbl_abort_method = FALSE;
  65. u8 acpi_gbl_method_executing = FALSE;
  66. /* System flags */
  67. u32 acpi_gbl_startup_flags = 0;
  68. /* System starts uninitialized */
  69. u8 acpi_gbl_shutdown = TRUE;
  70. const char *acpi_gbl_sleep_state_names[ACPI_S_STATE_COUNT] = {
  71. "\\_S0_",
  72. "\\_S1_",
  73. "\\_S2_",
  74. "\\_S3_",
  75. "\\_S4_",
  76. "\\_S5_"
  77. };
  78. const char *acpi_gbl_highest_dstate_names[4] = {
  79. "_S1D",
  80. "_S2D",
  81. "_S3D",
  82. "_S4D"
  83. };
  84. /*******************************************************************************
  85. *
  86. * FUNCTION: acpi_format_exception
  87. *
  88. * PARAMETERS: Status - The acpi_status code to be formatted
  89. *
  90. * RETURN: A string containing the exception text. A valid pointer is
  91. * always returned.
  92. *
  93. * DESCRIPTION: This function translates an ACPI exception into an ASCII string
  94. * It is here instead of utxface.c so it is always present.
  95. *
  96. ******************************************************************************/
  97. const char *acpi_format_exception(acpi_status status)
  98. {
  99. const char *exception = NULL;
  100. ACPI_FUNCTION_ENTRY();
  101. exception = acpi_ut_validate_exception(status);
  102. if (!exception) {
  103. /* Exception code was not recognized */
  104. ACPI_ERROR((AE_INFO,
  105. "Unknown exception code: 0x%8.8X", status));
  106. exception = "UNKNOWN_STATUS_CODE";
  107. }
  108. return (ACPI_CAST_PTR(const char, exception));
  109. }
  110. ACPI_EXPORT_SYMBOL(acpi_format_exception)
  111. /*******************************************************************************
  112. *
  113. * Namespace globals
  114. *
  115. ******************************************************************************/
  116. /*
  117. * Predefined ACPI Names (Built-in to the Interpreter)
  118. *
  119. * NOTES:
  120. * 1) _SB_ is defined to be a device to allow \_SB_._INI to be run
  121. * during the initialization sequence.
  122. * 2) _TZ_ is defined to be a thermal zone in order to allow ASL code to
  123. * perform a Notify() operation on it.
  124. */
  125. const struct acpi_predefined_names acpi_gbl_pre_defined_names[] = {
  126. {"_GPE", ACPI_TYPE_LOCAL_SCOPE, NULL},
  127. {"_PR_", ACPI_TYPE_LOCAL_SCOPE, NULL},
  128. {"_SB_", ACPI_TYPE_DEVICE, NULL},
  129. {"_SI_", ACPI_TYPE_LOCAL_SCOPE, NULL},
  130. {"_TZ_", ACPI_TYPE_THERMAL, NULL},
  131. {"_REV", ACPI_TYPE_INTEGER, (char *)ACPI_CA_SUPPORT_LEVEL},
  132. {"_OS_", ACPI_TYPE_STRING, ACPI_OS_NAME},
  133. {"_GL_", ACPI_TYPE_MUTEX, (char *)1},
  134. #if !defined (ACPI_NO_METHOD_EXECUTION) || defined (ACPI_CONSTANT_EVAL_ONLY)
  135. {"_OSI", ACPI_TYPE_METHOD, (char *)1},
  136. #endif
  137. /* Table terminator */
  138. {NULL, ACPI_TYPE_ANY, NULL}
  139. };
  140. /*
  141. * Properties of the ACPI Object Types, both internal and external.
  142. * The table is indexed by values of acpi_object_type
  143. */
  144. const u8 acpi_gbl_ns_properties[] = {
  145. ACPI_NS_NORMAL, /* 00 Any */
  146. ACPI_NS_NORMAL, /* 01 Number */
  147. ACPI_NS_NORMAL, /* 02 String */
  148. ACPI_NS_NORMAL, /* 03 Buffer */
  149. ACPI_NS_NORMAL, /* 04 Package */
  150. ACPI_NS_NORMAL, /* 05 field_unit */
  151. ACPI_NS_NEWSCOPE, /* 06 Device */
  152. ACPI_NS_NORMAL, /* 07 Event */
  153. ACPI_NS_NEWSCOPE, /* 08 Method */
  154. ACPI_NS_NORMAL, /* 09 Mutex */
  155. ACPI_NS_NORMAL, /* 10 Region */
  156. ACPI_NS_NEWSCOPE, /* 11 Power */
  157. ACPI_NS_NEWSCOPE, /* 12 Processor */
  158. ACPI_NS_NEWSCOPE, /* 13 Thermal */
  159. ACPI_NS_NORMAL, /* 14 buffer_field */
  160. ACPI_NS_NORMAL, /* 15 ddb_handle */
  161. ACPI_NS_NORMAL, /* 16 Debug Object */
  162. ACPI_NS_NORMAL, /* 17 def_field */
  163. ACPI_NS_NORMAL, /* 18 bank_field */
  164. ACPI_NS_NORMAL, /* 19 index_field */
  165. ACPI_NS_NORMAL, /* 20 Reference */
  166. ACPI_NS_NORMAL, /* 21 Alias */
  167. ACPI_NS_NORMAL, /* 22 method_alias */
  168. ACPI_NS_NORMAL, /* 23 Notify */
  169. ACPI_NS_NORMAL, /* 24 Address Handler */
  170. ACPI_NS_NEWSCOPE | ACPI_NS_LOCAL, /* 25 Resource Desc */
  171. ACPI_NS_NEWSCOPE | ACPI_NS_LOCAL, /* 26 Resource Field */
  172. ACPI_NS_NEWSCOPE, /* 27 Scope */
  173. ACPI_NS_NORMAL, /* 28 Extra */
  174. ACPI_NS_NORMAL, /* 29 Data */
  175. ACPI_NS_NORMAL /* 30 Invalid */
  176. };
  177. /* Hex to ASCII conversion table */
  178. static const char acpi_gbl_hex_to_ascii[] = {
  179. '0', '1', '2', '3', '4', '5', '6', '7',
  180. '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'
  181. };
  182. /*******************************************************************************
  183. *
  184. * FUNCTION: acpi_ut_hex_to_ascii_char
  185. *
  186. * PARAMETERS: Integer - Contains the hex digit
  187. * Position - bit position of the digit within the
  188. * integer (multiple of 4)
  189. *
  190. * RETURN: The converted Ascii character
  191. *
  192. * DESCRIPTION: Convert a hex digit to an Ascii character
  193. *
  194. ******************************************************************************/
  195. char acpi_ut_hex_to_ascii_char(acpi_integer integer, u32 position)
  196. {
  197. return (acpi_gbl_hex_to_ascii[(integer >> position) & 0xF]);
  198. }
  199. /******************************************************************************
  200. *
  201. * Event and Hardware globals
  202. *
  203. ******************************************************************************/
  204. struct acpi_bit_register_info acpi_gbl_bit_register_info[ACPI_NUM_BITREG] = {
  205. /* Name Parent Register Register Bit Position Register Bit Mask */
  206. /* ACPI_BITREG_TIMER_STATUS */ {ACPI_REGISTER_PM1_STATUS,
  207. ACPI_BITPOSITION_TIMER_STATUS,
  208. ACPI_BITMASK_TIMER_STATUS},
  209. /* ACPI_BITREG_BUS_MASTER_STATUS */ {ACPI_REGISTER_PM1_STATUS,
  210. ACPI_BITPOSITION_BUS_MASTER_STATUS,
  211. ACPI_BITMASK_BUS_MASTER_STATUS},
  212. /* ACPI_BITREG_GLOBAL_LOCK_STATUS */ {ACPI_REGISTER_PM1_STATUS,
  213. ACPI_BITPOSITION_GLOBAL_LOCK_STATUS,
  214. ACPI_BITMASK_GLOBAL_LOCK_STATUS},
  215. /* ACPI_BITREG_POWER_BUTTON_STATUS */ {ACPI_REGISTER_PM1_STATUS,
  216. ACPI_BITPOSITION_POWER_BUTTON_STATUS,
  217. ACPI_BITMASK_POWER_BUTTON_STATUS},
  218. /* ACPI_BITREG_SLEEP_BUTTON_STATUS */ {ACPI_REGISTER_PM1_STATUS,
  219. ACPI_BITPOSITION_SLEEP_BUTTON_STATUS,
  220. ACPI_BITMASK_SLEEP_BUTTON_STATUS},
  221. /* ACPI_BITREG_RT_CLOCK_STATUS */ {ACPI_REGISTER_PM1_STATUS,
  222. ACPI_BITPOSITION_RT_CLOCK_STATUS,
  223. ACPI_BITMASK_RT_CLOCK_STATUS},
  224. /* ACPI_BITREG_WAKE_STATUS */ {ACPI_REGISTER_PM1_STATUS,
  225. ACPI_BITPOSITION_WAKE_STATUS,
  226. ACPI_BITMASK_WAKE_STATUS},
  227. /* ACPI_BITREG_PCIEXP_WAKE_STATUS */ {ACPI_REGISTER_PM1_STATUS,
  228. ACPI_BITPOSITION_PCIEXP_WAKE_STATUS,
  229. ACPI_BITMASK_PCIEXP_WAKE_STATUS},
  230. /* ACPI_BITREG_TIMER_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
  231. ACPI_BITPOSITION_TIMER_ENABLE,
  232. ACPI_BITMASK_TIMER_ENABLE},
  233. /* ACPI_BITREG_GLOBAL_LOCK_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
  234. ACPI_BITPOSITION_GLOBAL_LOCK_ENABLE,
  235. ACPI_BITMASK_GLOBAL_LOCK_ENABLE},
  236. /* ACPI_BITREG_POWER_BUTTON_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
  237. ACPI_BITPOSITION_POWER_BUTTON_ENABLE,
  238. ACPI_BITMASK_POWER_BUTTON_ENABLE},
  239. /* ACPI_BITREG_SLEEP_BUTTON_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
  240. ACPI_BITPOSITION_SLEEP_BUTTON_ENABLE,
  241. ACPI_BITMASK_SLEEP_BUTTON_ENABLE},
  242. /* ACPI_BITREG_RT_CLOCK_ENABLE */ {ACPI_REGISTER_PM1_ENABLE,
  243. ACPI_BITPOSITION_RT_CLOCK_ENABLE,
  244. ACPI_BITMASK_RT_CLOCK_ENABLE},
  245. /* ACPI_BITREG_WAKE_ENABLE */ {ACPI_REGISTER_PM1_ENABLE, 0, 0},
  246. /* ACPI_BITREG_PCIEXP_WAKE_DISABLE */ {ACPI_REGISTER_PM1_ENABLE,
  247. ACPI_BITPOSITION_PCIEXP_WAKE_DISABLE,
  248. ACPI_BITMASK_PCIEXP_WAKE_DISABLE},
  249. /* ACPI_BITREG_SCI_ENABLE */ {ACPI_REGISTER_PM1_CONTROL,
  250. ACPI_BITPOSITION_SCI_ENABLE,
  251. ACPI_BITMASK_SCI_ENABLE},
  252. /* ACPI_BITREG_BUS_MASTER_RLD */ {ACPI_REGISTER_PM1_CONTROL,
  253. ACPI_BITPOSITION_BUS_MASTER_RLD,
  254. ACPI_BITMASK_BUS_MASTER_RLD},
  255. /* ACPI_BITREG_GLOBAL_LOCK_RELEASE */ {ACPI_REGISTER_PM1_CONTROL,
  256. ACPI_BITPOSITION_GLOBAL_LOCK_RELEASE,
  257. ACPI_BITMASK_GLOBAL_LOCK_RELEASE},
  258. /* ACPI_BITREG_SLEEP_TYPE_A */ {ACPI_REGISTER_PM1_CONTROL,
  259. ACPI_BITPOSITION_SLEEP_TYPE_X,
  260. ACPI_BITMASK_SLEEP_TYPE_X},
  261. /* ACPI_BITREG_SLEEP_TYPE_B */ {ACPI_REGISTER_PM1_CONTROL,
  262. ACPI_BITPOSITION_SLEEP_TYPE_X,
  263. ACPI_BITMASK_SLEEP_TYPE_X},
  264. /* ACPI_BITREG_SLEEP_ENABLE */ {ACPI_REGISTER_PM1_CONTROL,
  265. ACPI_BITPOSITION_SLEEP_ENABLE,
  266. ACPI_BITMASK_SLEEP_ENABLE},
  267. /* ACPI_BITREG_ARB_DIS */ {ACPI_REGISTER_PM2_CONTROL,
  268. ACPI_BITPOSITION_ARB_DISABLE,
  269. ACPI_BITMASK_ARB_DISABLE}
  270. };
  271. struct acpi_fixed_event_info acpi_gbl_fixed_event_info[ACPI_NUM_FIXED_EVENTS] = {
  272. /* ACPI_EVENT_PMTIMER */ {ACPI_BITREG_TIMER_STATUS,
  273. ACPI_BITREG_TIMER_ENABLE,
  274. ACPI_BITMASK_TIMER_STATUS,
  275. ACPI_BITMASK_TIMER_ENABLE},
  276. /* ACPI_EVENT_GLOBAL */ {ACPI_BITREG_GLOBAL_LOCK_STATUS,
  277. ACPI_BITREG_GLOBAL_LOCK_ENABLE,
  278. ACPI_BITMASK_GLOBAL_LOCK_STATUS,
  279. ACPI_BITMASK_GLOBAL_LOCK_ENABLE},
  280. /* ACPI_EVENT_POWER_BUTTON */ {ACPI_BITREG_POWER_BUTTON_STATUS,
  281. ACPI_BITREG_POWER_BUTTON_ENABLE,
  282. ACPI_BITMASK_POWER_BUTTON_STATUS,
  283. ACPI_BITMASK_POWER_BUTTON_ENABLE},
  284. /* ACPI_EVENT_SLEEP_BUTTON */ {ACPI_BITREG_SLEEP_BUTTON_STATUS,
  285. ACPI_BITREG_SLEEP_BUTTON_ENABLE,
  286. ACPI_BITMASK_SLEEP_BUTTON_STATUS,
  287. ACPI_BITMASK_SLEEP_BUTTON_ENABLE},
  288. /* ACPI_EVENT_RTC */ {ACPI_BITREG_RT_CLOCK_STATUS,
  289. ACPI_BITREG_RT_CLOCK_ENABLE,
  290. ACPI_BITMASK_RT_CLOCK_STATUS,
  291. ACPI_BITMASK_RT_CLOCK_ENABLE},
  292. };
  293. /*******************************************************************************
  294. *
  295. * FUNCTION: acpi_ut_get_region_name
  296. *
  297. * PARAMETERS: None.
  298. *
  299. * RETURN: Status
  300. *
  301. * DESCRIPTION: Translate a Space ID into a name string (Debug only)
  302. *
  303. ******************************************************************************/
  304. /* Region type decoding */
  305. const char *acpi_gbl_region_types[ACPI_NUM_PREDEFINED_REGIONS] = {
  306. "SystemMemory",
  307. "SystemIO",
  308. "PCI_Config",
  309. "EmbeddedControl",
  310. "SMBus",
  311. "CMOS",
  312. "PCIBARTarget",
  313. "DataTable"
  314. };
  315. char *acpi_ut_get_region_name(u8 space_id)
  316. {
  317. if (space_id >= ACPI_USER_REGION_BEGIN) {
  318. return ("UserDefinedRegion");
  319. } else if (space_id >= ACPI_NUM_PREDEFINED_REGIONS) {
  320. return ("InvalidSpaceId");
  321. }
  322. return (ACPI_CAST_PTR(char, acpi_gbl_region_types[space_id]));
  323. }
  324. /*******************************************************************************
  325. *
  326. * FUNCTION: acpi_ut_get_event_name
  327. *
  328. * PARAMETERS: None.
  329. *
  330. * RETURN: Status
  331. *
  332. * DESCRIPTION: Translate a Event ID into a name string (Debug only)
  333. *
  334. ******************************************************************************/
  335. /* Event type decoding */
  336. static const char *acpi_gbl_event_types[ACPI_NUM_FIXED_EVENTS] = {
  337. "PM_Timer",
  338. "GlobalLock",
  339. "PowerButton",
  340. "SleepButton",
  341. "RealTimeClock",
  342. };
  343. char *acpi_ut_get_event_name(u32 event_id)
  344. {
  345. if (event_id > ACPI_EVENT_MAX) {
  346. return ("InvalidEventID");
  347. }
  348. return (ACPI_CAST_PTR(char, acpi_gbl_event_types[event_id]));
  349. }
  350. /*******************************************************************************
  351. *
  352. * FUNCTION: acpi_ut_get_type_name
  353. *
  354. * PARAMETERS: None.
  355. *
  356. * RETURN: Status
  357. *
  358. * DESCRIPTION: Translate a Type ID into a name string (Debug only)
  359. *
  360. ******************************************************************************/
  361. /*
  362. * Elements of acpi_gbl_ns_type_names below must match
  363. * one-to-one with values of acpi_object_type
  364. *
  365. * The type ACPI_TYPE_ANY (Untyped) is used as a "don't care" when searching;
  366. * when stored in a table it really means that we have thus far seen no
  367. * evidence to indicate what type is actually going to be stored for this entry.
  368. */
  369. static const char acpi_gbl_bad_type[] = "UNDEFINED";
  370. /* Printable names of the ACPI object types */
  371. static const char *acpi_gbl_ns_type_names[] = {
  372. /* 00 */ "Untyped",
  373. /* 01 */ "Integer",
  374. /* 02 */ "String",
  375. /* 03 */ "Buffer",
  376. /* 04 */ "Package",
  377. /* 05 */ "FieldUnit",
  378. /* 06 */ "Device",
  379. /* 07 */ "Event",
  380. /* 08 */ "Method",
  381. /* 09 */ "Mutex",
  382. /* 10 */ "Region",
  383. /* 11 */ "Power",
  384. /* 12 */ "Processor",
  385. /* 13 */ "Thermal",
  386. /* 14 */ "BufferField",
  387. /* 15 */ "DdbHandle",
  388. /* 16 */ "DebugObject",
  389. /* 17 */ "RegionField",
  390. /* 18 */ "BankField",
  391. /* 19 */ "IndexField",
  392. /* 20 */ "Reference",
  393. /* 21 */ "Alias",
  394. /* 22 */ "MethodAlias",
  395. /* 23 */ "Notify",
  396. /* 24 */ "AddrHandler",
  397. /* 25 */ "ResourceDesc",
  398. /* 26 */ "ResourceFld",
  399. /* 27 */ "Scope",
  400. /* 28 */ "Extra",
  401. /* 29 */ "Data",
  402. /* 30 */ "Invalid"
  403. };
  404. char *acpi_ut_get_type_name(acpi_object_type type)
  405. {
  406. if (type > ACPI_TYPE_INVALID) {
  407. return (ACPI_CAST_PTR(char, acpi_gbl_bad_type));
  408. }
  409. return (ACPI_CAST_PTR(char, acpi_gbl_ns_type_names[type]));
  410. }
  411. char *acpi_ut_get_object_type_name(union acpi_operand_object *obj_desc)
  412. {
  413. if (!obj_desc) {
  414. return ("[NULL Object Descriptor]");
  415. }
  416. return (acpi_ut_get_type_name(ACPI_GET_OBJECT_TYPE(obj_desc)));
  417. }
  418. /*******************************************************************************
  419. *
  420. * FUNCTION: acpi_ut_get_node_name
  421. *
  422. * PARAMETERS: Object - A namespace node
  423. *
  424. * RETURN: Pointer to a string
  425. *
  426. * DESCRIPTION: Validate the node and return the node's ACPI name.
  427. *
  428. ******************************************************************************/
  429. char *acpi_ut_get_node_name(void *object)
  430. {
  431. struct acpi_namespace_node *node = (struct acpi_namespace_node *)object;
  432. /* Must return a string of exactly 4 characters == ACPI_NAME_SIZE */
  433. if (!object) {
  434. return ("NULL");
  435. }
  436. /* Check for Root node */
  437. if ((object == ACPI_ROOT_OBJECT) || (object == acpi_gbl_root_node)) {
  438. return ("\"\\\" ");
  439. }
  440. /* Descriptor must be a namespace node */
  441. if (ACPI_GET_DESCRIPTOR_TYPE(node) != ACPI_DESC_TYPE_NAMED) {
  442. return ("####");
  443. }
  444. /* Name must be a valid ACPI name */
  445. if (!acpi_ut_valid_acpi_name(node->name.integer)) {
  446. node->name.integer = acpi_ut_repair_name(node->name.ascii);
  447. }
  448. /* Return the name */
  449. return (node->name.ascii);
  450. }
  451. /*******************************************************************************
  452. *
  453. * FUNCTION: acpi_ut_get_descriptor_name
  454. *
  455. * PARAMETERS: Object - An ACPI object
  456. *
  457. * RETURN: Pointer to a string
  458. *
  459. * DESCRIPTION: Validate object and return the descriptor type
  460. *
  461. ******************************************************************************/
  462. /* Printable names of object descriptor types */
  463. static const char *acpi_gbl_desc_type_names[] = {
  464. /* 00 */ "Invalid",
  465. /* 01 */ "Cached",
  466. /* 02 */ "State-Generic",
  467. /* 03 */ "State-Update",
  468. /* 04 */ "State-Package",
  469. /* 05 */ "State-Control",
  470. /* 06 */ "State-RootParseScope",
  471. /* 07 */ "State-ParseScope",
  472. /* 08 */ "State-WalkScope",
  473. /* 09 */ "State-Result",
  474. /* 10 */ "State-Notify",
  475. /* 11 */ "State-Thread",
  476. /* 12 */ "Walk",
  477. /* 13 */ "Parser",
  478. /* 14 */ "Operand",
  479. /* 15 */ "Node"
  480. };
  481. char *acpi_ut_get_descriptor_name(void *object)
  482. {
  483. if (!object) {
  484. return ("NULL OBJECT");
  485. }
  486. if (ACPI_GET_DESCRIPTOR_TYPE(object) > ACPI_DESC_TYPE_MAX) {
  487. return (ACPI_CAST_PTR(char, acpi_gbl_bad_type));
  488. }
  489. return (ACPI_CAST_PTR(char,
  490. acpi_gbl_desc_type_names[ACPI_GET_DESCRIPTOR_TYPE
  491. (object)]));
  492. }
  493. #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
  494. /*
  495. * Strings and procedures used for debug only
  496. */
  497. /*******************************************************************************
  498. *
  499. * FUNCTION: acpi_ut_get_mutex_name
  500. *
  501. * PARAMETERS: mutex_id - The predefined ID for this mutex.
  502. *
  503. * RETURN: String containing the name of the mutex. Always returns a valid
  504. * pointer.
  505. *
  506. * DESCRIPTION: Translate a mutex ID into a name string (Debug only)
  507. *
  508. ******************************************************************************/
  509. char *acpi_ut_get_mutex_name(u32 mutex_id)
  510. {
  511. if (mutex_id > ACPI_MAX_MUTEX) {
  512. return ("Invalid Mutex ID");
  513. }
  514. return (acpi_gbl_mutex_names[mutex_id]);
  515. }
  516. #endif
  517. /*******************************************************************************
  518. *
  519. * FUNCTION: acpi_ut_valid_object_type
  520. *
  521. * PARAMETERS: Type - Object type to be validated
  522. *
  523. * RETURN: TRUE if valid object type, FALSE otherwise
  524. *
  525. * DESCRIPTION: Validate an object type
  526. *
  527. ******************************************************************************/
  528. u8 acpi_ut_valid_object_type(acpi_object_type type)
  529. {
  530. if (type > ACPI_TYPE_LOCAL_MAX) {
  531. /* Note: Assumes all TYPEs are contiguous (external/local) */
  532. return (FALSE);
  533. }
  534. return (TRUE);
  535. }
  536. /*******************************************************************************
  537. *
  538. * FUNCTION: acpi_ut_init_globals
  539. *
  540. * PARAMETERS: None
  541. *
  542. * RETURN: None
  543. *
  544. * DESCRIPTION: Init library globals. All globals that require specific
  545. * initialization should be initialized here!
  546. *
  547. ******************************************************************************/
  548. void acpi_ut_init_globals(void)
  549. {
  550. acpi_status status;
  551. u32 i;
  552. ACPI_FUNCTION_TRACE(ut_init_globals);
  553. /* Create all memory caches */
  554. status = acpi_ut_create_caches();
  555. if (ACPI_FAILURE(status)) {
  556. return;
  557. }
  558. /* Mutex locked flags */
  559. for (i = 0; i < ACPI_NUM_MUTEX; i++) {
  560. acpi_gbl_mutex_info[i].mutex = NULL;
  561. acpi_gbl_mutex_info[i].thread_id = ACPI_MUTEX_NOT_ACQUIRED;
  562. acpi_gbl_mutex_info[i].use_count = 0;
  563. }
  564. for (i = 0; i < ACPI_NUM_OWNERID_MASKS; i++) {
  565. acpi_gbl_owner_id_mask[i] = 0;
  566. }
  567. acpi_gbl_owner_id_mask[ACPI_NUM_OWNERID_MASKS - 1] = 0x80000000; /* Last ID is never valid */
  568. /* GPE support */
  569. acpi_gpe_count = 0;
  570. acpi_gbl_gpe_xrupt_list_head = NULL;
  571. acpi_gbl_gpe_fadt_blocks[0] = NULL;
  572. acpi_gbl_gpe_fadt_blocks[1] = NULL;
  573. /* Global notify handlers */
  574. acpi_gbl_system_notify.handler = NULL;
  575. acpi_gbl_device_notify.handler = NULL;
  576. acpi_gbl_exception_handler = NULL;
  577. acpi_gbl_init_handler = NULL;
  578. /* Global Lock support */
  579. acpi_gbl_global_lock_semaphore = NULL;
  580. acpi_gbl_global_lock_mutex = NULL;
  581. acpi_gbl_global_lock_acquired = FALSE;
  582. acpi_gbl_global_lock_handle = 0;
  583. /* Miscellaneous variables */
  584. acpi_gbl_cm_single_step = FALSE;
  585. acpi_gbl_db_terminate_threads = FALSE;
  586. acpi_gbl_shutdown = FALSE;
  587. acpi_gbl_ns_lookup_count = 0;
  588. acpi_gbl_ps_find_count = 0;
  589. acpi_gbl_acpi_hardware_present = TRUE;
  590. acpi_gbl_last_owner_id_index = 0;
  591. acpi_gbl_next_owner_id_offset = 0;
  592. acpi_gbl_trace_method_name = 0;
  593. acpi_gbl_trace_dbg_level = 0;
  594. acpi_gbl_trace_dbg_layer = 0;
  595. acpi_gbl_debugger_configuration = DEBUGGER_THREADING;
  596. acpi_gbl_db_output_flags = ACPI_DB_CONSOLE_OUTPUT;
  597. /* Hardware oriented */
  598. acpi_gbl_events_initialized = FALSE;
  599. acpi_gbl_system_awake_and_running = TRUE;
  600. /* Namespace */
  601. acpi_gbl_root_node = NULL;
  602. acpi_gbl_root_node_struct.name.integer = ACPI_ROOT_NAME;
  603. acpi_gbl_root_node_struct.descriptor_type = ACPI_DESC_TYPE_NAMED;
  604. acpi_gbl_root_node_struct.type = ACPI_TYPE_DEVICE;
  605. acpi_gbl_root_node_struct.child = NULL;
  606. acpi_gbl_root_node_struct.peer = NULL;
  607. acpi_gbl_root_node_struct.object = NULL;
  608. acpi_gbl_root_node_struct.flags = ANOBJ_END_OF_PEER_LIST;
  609. #ifdef ACPI_DEBUG_OUTPUT
  610. acpi_gbl_lowest_stack_pointer = ACPI_SIZE_MAX;
  611. #endif
  612. #ifdef ACPI_DBG_TRACK_ALLOCATIONS
  613. acpi_gbl_display_final_mem_stats = FALSE;
  614. #endif
  615. return_VOID;
  616. }
  617. ACPI_EXPORT_SYMBOL(acpi_dbg_level)
  618. ACPI_EXPORT_SYMBOL(acpi_dbg_layer)
  619. ACPI_EXPORT_SYMBOL(acpi_gpe_count)