utglobal.c revision 571909175b4f9a1ef15ec4afead6d6d463dbe760
2N/A/****************************************************************************** 2N/A * Module Name: utglobal - Global variables for the ACPI subsystem 2N/A *****************************************************************************/ 2N/A/****************************************************************************** 2N/A * 1. Copyright Notice 2N/A * Some or all of this work - Copyright (c) 1999 - 2009, Intel Corp. 2N/A * All rights reserved. 2N/A * 2.1. This is your license from Intel Corp. under its intellectual property 2N/A * rights. You may have additional license terms from the party that provided 2N/A * you this software, covering your right to use that party's intellectual 2N/A * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a 2N/A * copy of the source code appearing in this file ("Covered Code") an 2N/A * irrevocable, perpetual, worldwide license under Intel's copyrights in the 2N/A * base code distributed originally by Intel ("Original Intel Code") to copy, 2N/A * make derivatives, distribute, use and display any portion of the Covered 2N/A * Code in any form, with the right to sublicense such rights; and 2N/A * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent 2N/A * license (with the right to sublicense), under only those claims of Intel 2N/A * patents that are infringed by the Original Intel Code, to make, use, sell, 2N/A * offer to sell, and import the Covered Code and derivative works thereof 2N/A * solely to the minimum extent necessary to exercise the above copyright 2N/A * license, and in no event shall the patent license extend to any additions 2N/A * to or modifications of the Original Intel Code. No other license or right 2N/A * is granted directly or by implication, estoppel or otherwise; 2N/A * The above copyright and patent license is granted only if the following 2N/A * conditions are met: 2N/A * 3.1. Redistribution of Source with Rights to Further Distribute Source. 2N/A * Redistribution of source code of any substantial portion of the Covered 2N/A * Code or modification with rights to further distribute source must include 2N/A * the above Copyright Notice, the above License, this list of Conditions, 2N/A * and the following Disclaimer and Export Compliance provision. In addition, 2N/A * Licensee must cause all Covered Code to which Licensee contributes to 2N/A * contain a file documenting the changes Licensee made to create that Covered 2N/A * Code and the date of any change. Licensee must include in that file the 2N/A * documentation of any changes made by any predecessor Licensee. Licensee 2N/A * must include a prominent statement that the modification is derived, 2N/A * directly or indirectly, from Original Intel Code. 2N/A * 3.2. Redistribution of Source with no Rights to Further Distribute Source. 2N/A * Redistribution of source code of any substantial portion of the Covered 2N/A * Code or modification without rights to further distribute source must 2N/A * include the following Disclaimer and Export Compliance provision in the 2N/A * documentation and/or other materials provided with distribution. In 2N/A * addition, Licensee may not authorize further sublicense of source of any 2N/A * portion of the Covered Code, and must include terms to the effect that the 2N/A * license from Licensee to its licensee is limited to the intellectual 2N/A * property embodied in the software Licensee provides to its licensee, and 2N/A * not to intellectual property embodied in modifications its licensee may 2N/A * 3.3. Redistribution of Executable. Redistribution in executable form of any 2N/A * substantial portion of the Covered Code or modification must reproduce the 2N/A * above Copyright Notice, and the following Disclaimer and Export Compliance 2N/A * provision in the documentation and/or other materials provided with the 2N/A * 3.4. Intel retains all right, title, and interest in and to the Original 2N/A * 3.5. Neither the name Intel nor any other trademark owned or controlled by 2N/A * Intel shall be used in advertising or otherwise to promote the sale, use or 2N/A * other dealings in products derived from or relating to the Covered Code 2N/A * without prior written authorization from Intel. 2N/A * 4. Disclaimer and Export Compliance 2N/A * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED 2N/A * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE 2N/A * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE, 2N/A * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY 2N/A * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY 2N/A * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A 2N/A * PARTICULAR PURPOSE. 2N/A * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES 2N/A * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR 2N/A * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT, 2N/A * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY 2N/A * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL 2N/A * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS 2N/A * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY 2N/A * 4.3. Licensee shall not export, either directly or indirectly, any of this 2N/A * software or system incorporating such software without first obtaining any 2N/A * required license or other approval from the U. S. Department of Commerce or 2N/A * any other agency or department of the United States Government. In the 2N/A * event Licensee exports any such software from the United States or 2N/A * re-exports any such software from a foreign destination, Licensee shall 2N/A * compliance with all laws, regulations, orders, or other restrictions of the 2N/A * U.S. Export Administration Regulations. Licensee agrees that neither it nor 2N/A * software, or service, directly or indirectly, to any country for which the 2N/A * United States government or any agency thereof requires an export license, 2N/A * other governmental approval, or letter of assurance, without first obtaining 2N/A * such license, approval or letter. 2N/A *****************************************************************************/ 2N/A/******************************************************************************* 2N/A * Static global variable initialization. 2N/A ******************************************************************************/ 2N/A * We want the debug switches statically initialized so they 2N/A * are already set when the debugger is entered. 2N/A/* Debug switch - level and trace mask */ 2N/A/* Debug switch - layer (component) mask */ 2N/A/* Debugger globals */ 2N/A/* System starts uninitialized */ 2N/A/******************************************************************************* 2N/A * FUNCTION: AcpiFormatException 2N/A * PARAMETERS: Status - The ACPI_STATUS code to be formatted 2N/A * RETURN: A string containing the exception text. A valid pointer is 2N/A * DESCRIPTION: This function translates an ACPI exception into an ASCII string 2N/A ******************************************************************************/ 2N/A /* Exception code was not recognized */ 2N/A/******************************************************************************* 2N/A ******************************************************************************/ 2N/A * Predefined ACPI Names (Built-in to the Interpreter) 2N/A * 1) _SB_ is defined to be a device to allow \_SB_._INI to be run 2N/A * during the initialization sequence. 2N/A * 2) _TZ_ is defined to be a thermal zone in order to allow ASL code to 2N/A * perform a Notify() operation on it. 2N/A /* Table terminator */ 2N/A * Properties of the ACPI Object Types, both internal and external. 2N/A * The table is indexed by values of ACPI_OBJECT_TYPE 2N/A/* Hex to ASCII conversion table */ 2N/A '0',
'1',
'2',
'3',
'4',
'5',
'6',
'7',
2N/A '8',
'9',
'A',
'B',
'C',
'D',
'E',
'F' 2N/A/******************************************************************************* 2N/A * FUNCTION: AcpiUtHexToAsciiChar 2N/A * PARAMETERS: Integer - Contains the hex digit 2N/A * Position - bit position of the digit within the 2N/A * integer (multiple of 4) 2N/A * RETURN: The converted Ascii character 2N/A * DESCRIPTION: Convert a hex digit to an Ascii character 2N/A ******************************************************************************/ 2N/A/****************************************************************************** 2N/A * Event and Hardware globals 2N/A ******************************************************************************/ 2N/A /* Name Parent Register Register Bit Position Register Bit Mask */ 2N/A/******************************************************************************* 2N/A * FUNCTION: AcpiUtGetRegionName 2N/A * DESCRIPTION: Translate a Space ID into a name string (Debug only) 2N/A ******************************************************************************/ 2N/A/* Region type decoding */ 2N/A return (
"UserDefinedRegion");
2N/A return (
"InvalidSpaceId");
2N/A/******************************************************************************* 2N/A * FUNCTION: AcpiUtGetEventName 2N/A * DESCRIPTION: Translate a Event ID into a name string (Debug only) 2N/A ******************************************************************************/ 2N/A/* Event type decoding */ 2N/A return (
"InvalidEventID");
2N/A/******************************************************************************* 2N/A * FUNCTION: AcpiUtGetTypeName 2N/A * DESCRIPTION: Translate a Type ID into a name string (Debug only) 2N/A ******************************************************************************/ 2N/A * Elements of AcpiGbl_NsTypeNames below must match 2N/A * one-to-one with values of ACPI_OBJECT_TYPE 2N/A * The type ACPI_TYPE_ANY (Untyped) is used as a "don't care" when searching; 2N/A * when stored in a table it really means that we have thus far seen no 2N/A * evidence to indicate what type is actually going to be stored for this entry. 2N/A/* Printable names of the ACPI object types */ 2N/A /* 05 */ "FieldUnit",
2N/A /* 12 */ "Processor",
2N/A /* 14 */ "BufferField",
2N/A /* 15 */ "DdbHandle",
2N/A /* 16 */ "DebugObject",
2N/A /* 17 */ "RegionField",
2N/A /* 18 */ "BankField",
2N/A /* 19 */ "IndexField",
2N/A /* 20 */ "Reference",
2N/A /* 22 */ "MethodAlias",
2N/A /* 24 */ "AddrHandler",
2N/A /* 25 */ "ResourceDesc",
2N/A /* 26 */ "ResourceFld",
2N/A return (
"[NULL Object Descriptor]");
2N/A/******************************************************************************* 2N/A * FUNCTION: AcpiUtGetNodeName 2N/A * PARAMETERS: Object - A namespace node 2N/A * RETURN: Pointer to a string 2N/A * DESCRIPTION: Validate the node and return the node's ACPI name. 2N/A ******************************************************************************/ 2N/A /* Must return a string of exactly 4 characters == ACPI_NAME_SIZE */ 2N/A /* Check for Root node */ 2N/A /* Descriptor must be a namespace node */ 2N/A * was created, but make sure it has not been corrupted. 2N/A /* Return the name */ 2N/A/******************************************************************************* 2N/A * FUNCTION: AcpiUtGetDescriptorName * PARAMETERS: Object - An ACPI object * RETURN: Pointer to a string * DESCRIPTION: Validate object and return the descriptor type ******************************************************************************/ /* Printable names of object descriptor types */ /* 02 */ "State-Generic",
/* 04 */ "State-Package",
/* 05 */ "State-Control",
/* 06 */ "State-RootParseScope",
/* 07 */ "State-ParseScope",
/* 08 */ "State-WalkScope",
/******************************************************************************* * FUNCTION: AcpiUtGetReferenceName * PARAMETERS: Object - An ACPI reference object * RETURN: Pointer to a string * DESCRIPTION: Decode a reference object sub-type to a string. ******************************************************************************/ /* Printable names of reference object sub-types */ return (
"Not an Operand object");
return (
"Not a Reference object");
return (
"Unknown Reference class");
* Strings and procedures used for debug only /******************************************************************************* * FUNCTION: AcpiUtGetMutexName * PARAMETERS: MutexId - The predefined ID for this mutex. * RETURN: String containing the name of the mutex. Always returns a valid * DESCRIPTION: Translate a mutex ID into a name string (Debug only) ******************************************************************************/ return (
"Invalid Mutex ID");
/******************************************************************************* * FUNCTION: AcpiUtGetNotifyName * PARAMETERS: NotifyValue - Value from the Notify() request * RETURN: String corresponding to the Notify Value. * DESCRIPTION: Translate a Notify Value to a notify namestring. ******************************************************************************/ /* Names for Notify() values, used for debug output */ else /* Greater or equal to 0x80 */ return (
"**Device Specific**");
/******************************************************************************* * FUNCTION: AcpiUtValidObjectType * PARAMETERS: Type - Object type to be validated * RETURN: TRUE if valid object type, FALSE otherwise * DESCRIPTION: Validate an object type ******************************************************************************/ /******************************************************************************* * FUNCTION: AcpiUtInitGlobals * DESCRIPTION: Init library globals. All globals that require specific * initialization should be initialized here! ******************************************************************************/ /* Create all memory caches */ /* Last OwnerID is never valid */ /* Global Lock support */ /* Miscellaneous variables */