10Sstevel@tonic-gate /******************************************************************************
20Sstevel@tonic-gate  *
30Sstevel@tonic-gate  * Name: acutils.h -- prototypes for the common (subsystem-wide) procedures
40Sstevel@tonic-gate  *
50Sstevel@tonic-gate  *****************************************************************************/
60Sstevel@tonic-gate 
70Sstevel@tonic-gate /******************************************************************************
80Sstevel@tonic-gate  *
90Sstevel@tonic-gate  * 1. Copyright Notice
100Sstevel@tonic-gate  *
11*9980SDana.Myers@Sun.COM  * Some or all of this work - Copyright (c) 1999 - 2009, Intel Corp.
120Sstevel@tonic-gate  * All rights reserved.
130Sstevel@tonic-gate  *
140Sstevel@tonic-gate  * 2. License
150Sstevel@tonic-gate  *
160Sstevel@tonic-gate  * 2.1. This is your license from Intel Corp. under its intellectual property
170Sstevel@tonic-gate  * rights.  You may have additional license terms from the party that provided
180Sstevel@tonic-gate  * you this software, covering your right to use that party's intellectual
190Sstevel@tonic-gate  * property rights.
200Sstevel@tonic-gate  *
210Sstevel@tonic-gate  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
220Sstevel@tonic-gate  * copy of the source code appearing in this file ("Covered Code") an
230Sstevel@tonic-gate  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
240Sstevel@tonic-gate  * base code distributed originally by Intel ("Original Intel Code") to copy,
250Sstevel@tonic-gate  * make derivatives, distribute, use and display any portion of the Covered
260Sstevel@tonic-gate  * Code in any form, with the right to sublicense such rights; and
270Sstevel@tonic-gate  *
280Sstevel@tonic-gate  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
290Sstevel@tonic-gate  * license (with the right to sublicense), under only those claims of Intel
300Sstevel@tonic-gate  * patents that are infringed by the Original Intel Code, to make, use, sell,
310Sstevel@tonic-gate  * offer to sell, and import the Covered Code and derivative works thereof
320Sstevel@tonic-gate  * solely to the minimum extent necessary to exercise the above copyright
330Sstevel@tonic-gate  * license, and in no event shall the patent license extend to any additions
340Sstevel@tonic-gate  * to or modifications of the Original Intel Code.  No other license or right
350Sstevel@tonic-gate  * is granted directly or by implication, estoppel or otherwise;
360Sstevel@tonic-gate  *
370Sstevel@tonic-gate  * The above copyright and patent license is granted only if the following
380Sstevel@tonic-gate  * conditions are met:
390Sstevel@tonic-gate  *
400Sstevel@tonic-gate  * 3. Conditions
410Sstevel@tonic-gate  *
420Sstevel@tonic-gate  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
430Sstevel@tonic-gate  * Redistribution of source code of any substantial portion of the Covered
440Sstevel@tonic-gate  * Code or modification with rights to further distribute source must include
450Sstevel@tonic-gate  * the above Copyright Notice, the above License, this list of Conditions,
460Sstevel@tonic-gate  * and the following Disclaimer and Export Compliance provision.  In addition,
470Sstevel@tonic-gate  * Licensee must cause all Covered Code to which Licensee contributes to
480Sstevel@tonic-gate  * contain a file documenting the changes Licensee made to create that Covered
490Sstevel@tonic-gate  * Code and the date of any change.  Licensee must include in that file the
500Sstevel@tonic-gate  * documentation of any changes made by any predecessor Licensee.  Licensee
510Sstevel@tonic-gate  * must include a prominent statement that the modification is derived,
520Sstevel@tonic-gate  * directly or indirectly, from Original Intel Code.
530Sstevel@tonic-gate  *
540Sstevel@tonic-gate  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
550Sstevel@tonic-gate  * Redistribution of source code of any substantial portion of the Covered
560Sstevel@tonic-gate  * Code or modification without rights to further distribute source must
570Sstevel@tonic-gate  * include the following Disclaimer and Export Compliance provision in the
580Sstevel@tonic-gate  * documentation and/or other materials provided with distribution.  In
590Sstevel@tonic-gate  * addition, Licensee may not authorize further sublicense of source of any
600Sstevel@tonic-gate  * portion of the Covered Code, and must include terms to the effect that the
610Sstevel@tonic-gate  * license from Licensee to its licensee is limited to the intellectual
620Sstevel@tonic-gate  * property embodied in the software Licensee provides to its licensee, and
630Sstevel@tonic-gate  * not to intellectual property embodied in modifications its licensee may
640Sstevel@tonic-gate  * make.
650Sstevel@tonic-gate  *
660Sstevel@tonic-gate  * 3.3. Redistribution of Executable. Redistribution in executable form of any
670Sstevel@tonic-gate  * substantial portion of the Covered Code or modification must reproduce the
680Sstevel@tonic-gate  * above Copyright Notice, and the following Disclaimer and Export Compliance
690Sstevel@tonic-gate  * provision in the documentation and/or other materials provided with the
700Sstevel@tonic-gate  * distribution.
710Sstevel@tonic-gate  *
720Sstevel@tonic-gate  * 3.4. Intel retains all right, title, and interest in and to the Original
730Sstevel@tonic-gate  * Intel Code.
740Sstevel@tonic-gate  *
750Sstevel@tonic-gate  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
760Sstevel@tonic-gate  * Intel shall be used in advertising or otherwise to promote the sale, use or
770Sstevel@tonic-gate  * other dealings in products derived from or relating to the Covered Code
780Sstevel@tonic-gate  * without prior written authorization from Intel.
790Sstevel@tonic-gate  *
800Sstevel@tonic-gate  * 4. Disclaimer and Export Compliance
810Sstevel@tonic-gate  *
820Sstevel@tonic-gate  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
830Sstevel@tonic-gate  * HERE.  ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
840Sstevel@tonic-gate  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT,  ASSISTANCE,
850Sstevel@tonic-gate  * INSTALLATION, TRAINING OR OTHER SERVICES.  INTEL WILL NOT PROVIDE ANY
860Sstevel@tonic-gate  * UPDATES, ENHANCEMENTS OR EXTENSIONS.  INTEL SPECIFICALLY DISCLAIMS ANY
870Sstevel@tonic-gate  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
880Sstevel@tonic-gate  * PARTICULAR PURPOSE.
890Sstevel@tonic-gate  *
900Sstevel@tonic-gate  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
910Sstevel@tonic-gate  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
920Sstevel@tonic-gate  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
930Sstevel@tonic-gate  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
940Sstevel@tonic-gate  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
950Sstevel@tonic-gate  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.  THESE LIMITATIONS
960Sstevel@tonic-gate  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
970Sstevel@tonic-gate  * LIMITED REMEDY.
980Sstevel@tonic-gate  *
990Sstevel@tonic-gate  * 4.3. Licensee shall not export, either directly or indirectly, any of this
1000Sstevel@tonic-gate  * software or system incorporating such software without first obtaining any
1010Sstevel@tonic-gate  * required license or other approval from the U. S. Department of Commerce or
1020Sstevel@tonic-gate  * any other agency or department of the United States Government.  In the
1030Sstevel@tonic-gate  * event Licensee exports any such software from the United States or
1040Sstevel@tonic-gate  * re-exports any such software from a foreign destination, Licensee shall
1050Sstevel@tonic-gate  * ensure that the distribution and export/re-export of the software is in
1060Sstevel@tonic-gate  * compliance with all laws, regulations, orders, or other restrictions of the
1070Sstevel@tonic-gate  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
1080Sstevel@tonic-gate  * any of its subsidiaries will export/re-export any technical data, process,
1090Sstevel@tonic-gate  * software, or service, directly or indirectly, to any country for which the
1100Sstevel@tonic-gate  * United States government or any agency thereof requires an export license,
1110Sstevel@tonic-gate  * other governmental approval, or letter of assurance, without first obtaining
1120Sstevel@tonic-gate  * such license, approval or letter.
1130Sstevel@tonic-gate  *
1140Sstevel@tonic-gate  *****************************************************************************/
1150Sstevel@tonic-gate 
1160Sstevel@tonic-gate #ifndef _ACUTILS_H
1170Sstevel@tonic-gate #define _ACUTILS_H
1180Sstevel@tonic-gate 
1190Sstevel@tonic-gate 
1201560Smyers extern const UINT8                      AcpiGbl_ResourceAmlSizes[];
1211560Smyers 
1221560Smyers /* Strings used by the disassembler and debugger resource dump routines */
1231560Smyers 
1241560Smyers #if defined(ACPI_DISASSEMBLER) || defined (ACPI_DEBUGGER)
1251560Smyers 
1262623Smyers extern const char                       *AcpiGbl_BmDecode[];
1272623Smyers extern const char                       *AcpiGbl_ConfigDecode[];
1282623Smyers extern const char                       *AcpiGbl_ConsumeDecode[];
1292623Smyers extern const char                       *AcpiGbl_DecDecode[];
1302623Smyers extern const char                       *AcpiGbl_HeDecode[];
1312623Smyers extern const char                       *AcpiGbl_IoDecode[];
1322623Smyers extern const char                       *AcpiGbl_LlDecode[];
1332623Smyers extern const char                       *AcpiGbl_MaxDecode[];
1342623Smyers extern const char                       *AcpiGbl_MemDecode[];
1352623Smyers extern const char                       *AcpiGbl_MinDecode[];
1362623Smyers extern const char                       *AcpiGbl_MtpDecode[];
1372623Smyers extern const char                       *AcpiGbl_RngDecode[];
1382623Smyers extern const char                       *AcpiGbl_RwDecode[];
1392623Smyers extern const char                       *AcpiGbl_ShrDecode[];
1402623Smyers extern const char                       *AcpiGbl_SizDecode[];
1412623Smyers extern const char                       *AcpiGbl_TrsDecode[];
1422623Smyers extern const char                       *AcpiGbl_TtpDecode[];
1432623Smyers extern const char                       *AcpiGbl_TypDecode[];
1441560Smyers #endif
1451560Smyers 
1461560Smyers /* Types for Resource descriptor entries */
1471560Smyers 
1481560Smyers #define ACPI_INVALID_RESOURCE           0
1491560Smyers #define ACPI_FIXED_LENGTH               1
1501560Smyers #define ACPI_VARIABLE_LENGTH            2
1511560Smyers #define ACPI_SMALL_VARIABLE_LENGTH      3
1521560Smyers 
1530Sstevel@tonic-gate typedef
1542623Smyers ACPI_STATUS (*ACPI_WALK_AML_CALLBACK) (
1552623Smyers     UINT8                   *Aml,
1562623Smyers     UINT32                  Length,
1572623Smyers     UINT32                  Offset,
1582623Smyers     UINT8                   ResourceIndex,
1592623Smyers     void                    *Context);
1602623Smyers 
1612623Smyers typedef
1620Sstevel@tonic-gate ACPI_STATUS (*ACPI_PKG_CALLBACK) (
1630Sstevel@tonic-gate     UINT8                   ObjectType,
1640Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *SourceObject,
1650Sstevel@tonic-gate     ACPI_GENERIC_STATE      *State,
1660Sstevel@tonic-gate     void                    *Context);
1670Sstevel@tonic-gate 
1680Sstevel@tonic-gate typedef struct acpi_pkg_info
1690Sstevel@tonic-gate {
1700Sstevel@tonic-gate     UINT8                   *FreeSpace;
1710Sstevel@tonic-gate     ACPI_SIZE               Length;
1720Sstevel@tonic-gate     UINT32                  ObjectSpace;
1730Sstevel@tonic-gate     UINT32                  NumPackages;
1740Sstevel@tonic-gate 
1750Sstevel@tonic-gate } ACPI_PKG_INFO;
1760Sstevel@tonic-gate 
1770Sstevel@tonic-gate #define REF_INCREMENT       (UINT16) 0
1780Sstevel@tonic-gate #define REF_DECREMENT       (UINT16) 1
1790Sstevel@tonic-gate #define REF_FORCE_DELETE    (UINT16) 2
1800Sstevel@tonic-gate 
1810Sstevel@tonic-gate /* AcpiUtDumpBuffer */
1820Sstevel@tonic-gate 
1830Sstevel@tonic-gate #define DB_BYTE_DISPLAY     1
1840Sstevel@tonic-gate #define DB_WORD_DISPLAY     2
1850Sstevel@tonic-gate #define DB_DWORD_DISPLAY    4
1860Sstevel@tonic-gate #define DB_QWORD_DISPLAY    8
1870Sstevel@tonic-gate 
1880Sstevel@tonic-gate 
1890Sstevel@tonic-gate /*
1900Sstevel@tonic-gate  * utglobal - Global data structures and procedures
1910Sstevel@tonic-gate  */
1927851SDana.Myers@Sun.COM ACPI_STATUS
1930Sstevel@tonic-gate AcpiUtInitGlobals (
1940Sstevel@tonic-gate     void);
1950Sstevel@tonic-gate 
1960Sstevel@tonic-gate #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
1970Sstevel@tonic-gate 
1980Sstevel@tonic-gate char *
1990Sstevel@tonic-gate AcpiUtGetMutexName (
2000Sstevel@tonic-gate     UINT32                  MutexId);
2010Sstevel@tonic-gate 
2027851SDana.Myers@Sun.COM const char *
2037851SDana.Myers@Sun.COM AcpiUtGetNotifyName (
2047851SDana.Myers@Sun.COM     UINT32                  NotifyValue);
2057851SDana.Myers@Sun.COM 
2060Sstevel@tonic-gate #endif
2070Sstevel@tonic-gate 
2080Sstevel@tonic-gate char *
2090Sstevel@tonic-gate AcpiUtGetTypeName (
2100Sstevel@tonic-gate     ACPI_OBJECT_TYPE        Type);
2110Sstevel@tonic-gate 
2120Sstevel@tonic-gate char *
2130Sstevel@tonic-gate AcpiUtGetNodeName (
2140Sstevel@tonic-gate     void                    *Object);
2150Sstevel@tonic-gate 
2160Sstevel@tonic-gate char *
2170Sstevel@tonic-gate AcpiUtGetDescriptorName (
2180Sstevel@tonic-gate     void                    *Object);
2190Sstevel@tonic-gate 
2207851SDana.Myers@Sun.COM const char *
2217851SDana.Myers@Sun.COM AcpiUtGetReferenceName (
2227851SDana.Myers@Sun.COM     ACPI_OPERAND_OBJECT     *Object);
2237851SDana.Myers@Sun.COM 
2240Sstevel@tonic-gate char *
2250Sstevel@tonic-gate AcpiUtGetObjectTypeName (
2260Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *ObjDesc);
2270Sstevel@tonic-gate 
2280Sstevel@tonic-gate char *
2290Sstevel@tonic-gate AcpiUtGetRegionName (
2300Sstevel@tonic-gate     UINT8                   SpaceId);
2310Sstevel@tonic-gate 
2320Sstevel@tonic-gate char *
2330Sstevel@tonic-gate AcpiUtGetEventName (
2340Sstevel@tonic-gate     UINT32                  EventId);
2350Sstevel@tonic-gate 
2360Sstevel@tonic-gate char
2370Sstevel@tonic-gate AcpiUtHexToAsciiChar (
2380Sstevel@tonic-gate     ACPI_INTEGER            Integer,
2390Sstevel@tonic-gate     UINT32                  Position);
2400Sstevel@tonic-gate 
2410Sstevel@tonic-gate BOOLEAN
2420Sstevel@tonic-gate AcpiUtValidObjectType (
2430Sstevel@tonic-gate     ACPI_OBJECT_TYPE        Type);
2440Sstevel@tonic-gate 
2450Sstevel@tonic-gate 
2460Sstevel@tonic-gate /*
2470Sstevel@tonic-gate  * utinit - miscellaneous initialization and shutdown
2480Sstevel@tonic-gate  */
2490Sstevel@tonic-gate ACPI_STATUS
2500Sstevel@tonic-gate AcpiUtHardwareInitialize (
2510Sstevel@tonic-gate     void);
2520Sstevel@tonic-gate 
2530Sstevel@tonic-gate void
2540Sstevel@tonic-gate AcpiUtSubsystemShutdown (
2550Sstevel@tonic-gate     void);
2560Sstevel@tonic-gate 
2570Sstevel@tonic-gate 
2580Sstevel@tonic-gate /*
2590Sstevel@tonic-gate  * utclib - Local implementations of C library functions
2600Sstevel@tonic-gate  */
2610Sstevel@tonic-gate #ifndef ACPI_USE_SYSTEM_CLIBRARY
2620Sstevel@tonic-gate 
2630Sstevel@tonic-gate ACPI_SIZE
2640Sstevel@tonic-gate AcpiUtStrlen (
2650Sstevel@tonic-gate     const char              *String);
2660Sstevel@tonic-gate 
2670Sstevel@tonic-gate char *
2680Sstevel@tonic-gate AcpiUtStrcpy (
2690Sstevel@tonic-gate     char                    *DstString,
2700Sstevel@tonic-gate     const char              *SrcString);
2710Sstevel@tonic-gate 
2720Sstevel@tonic-gate char *
2730Sstevel@tonic-gate AcpiUtStrncpy (
2740Sstevel@tonic-gate     char                    *DstString,
2750Sstevel@tonic-gate     const char              *SrcString,
2760Sstevel@tonic-gate     ACPI_SIZE               Count);
2770Sstevel@tonic-gate 
2780Sstevel@tonic-gate int
2790Sstevel@tonic-gate AcpiUtMemcmp (
2800Sstevel@tonic-gate     const char              *Buffer1,
2810Sstevel@tonic-gate     const char              *Buffer2,
2820Sstevel@tonic-gate     ACPI_SIZE               Count);
2830Sstevel@tonic-gate 
2840Sstevel@tonic-gate int
2850Sstevel@tonic-gate AcpiUtStrncmp (
2860Sstevel@tonic-gate     const char              *String1,
2870Sstevel@tonic-gate     const char              *String2,
2880Sstevel@tonic-gate     ACPI_SIZE               Count);
2890Sstevel@tonic-gate 
2900Sstevel@tonic-gate int
2910Sstevel@tonic-gate AcpiUtStrcmp (
2920Sstevel@tonic-gate     const char              *String1,
2930Sstevel@tonic-gate     const char              *String2);
2940Sstevel@tonic-gate 
2950Sstevel@tonic-gate char *
2960Sstevel@tonic-gate AcpiUtStrcat (
2970Sstevel@tonic-gate     char                    *DstString,
2980Sstevel@tonic-gate     const char              *SrcString);
2990Sstevel@tonic-gate 
3000Sstevel@tonic-gate char *
3010Sstevel@tonic-gate AcpiUtStrncat (
3020Sstevel@tonic-gate     char                    *DstString,
3030Sstevel@tonic-gate     const char              *SrcString,
3040Sstevel@tonic-gate     ACPI_SIZE               Count);
3050Sstevel@tonic-gate 
3060Sstevel@tonic-gate UINT32
3070Sstevel@tonic-gate AcpiUtStrtoul (
3080Sstevel@tonic-gate     const char              *String,
3090Sstevel@tonic-gate     char                    **Terminator,
3100Sstevel@tonic-gate     UINT32                  Base);
3110Sstevel@tonic-gate 
3120Sstevel@tonic-gate char *
3130Sstevel@tonic-gate AcpiUtStrstr (
3140Sstevel@tonic-gate     char                    *String1,
3150Sstevel@tonic-gate     char                    *String2);
3160Sstevel@tonic-gate 
3170Sstevel@tonic-gate void *
3180Sstevel@tonic-gate AcpiUtMemcpy (
3190Sstevel@tonic-gate     void                    *Dest,
3200Sstevel@tonic-gate     const void              *Src,
3210Sstevel@tonic-gate     ACPI_SIZE               Count);
3220Sstevel@tonic-gate 
3230Sstevel@tonic-gate void *
3240Sstevel@tonic-gate AcpiUtMemset (
3250Sstevel@tonic-gate     void                    *Dest,
3267851SDana.Myers@Sun.COM     UINT8                   Value,
3270Sstevel@tonic-gate     ACPI_SIZE               Count);
3280Sstevel@tonic-gate 
3290Sstevel@tonic-gate int
3300Sstevel@tonic-gate AcpiUtToUpper (
3310Sstevel@tonic-gate     int                     c);
3320Sstevel@tonic-gate 
3330Sstevel@tonic-gate int
3340Sstevel@tonic-gate AcpiUtToLower (
3350Sstevel@tonic-gate     int                     c);
3360Sstevel@tonic-gate 
3370Sstevel@tonic-gate extern const UINT8 _acpi_ctype[];
3380Sstevel@tonic-gate 
3390Sstevel@tonic-gate #define _ACPI_XA     0x00    /* extra alphabetic - not supported */
3400Sstevel@tonic-gate #define _ACPI_XS     0x40    /* extra space */
3410Sstevel@tonic-gate #define _ACPI_BB     0x00    /* BEL, BS, etc. - not supported */
3420Sstevel@tonic-gate #define _ACPI_CN     0x20    /* CR, FF, HT, NL, VT */
3430Sstevel@tonic-gate #define _ACPI_DI     0x04    /* '0'-'9' */
3440Sstevel@tonic-gate #define _ACPI_LO     0x02    /* 'a'-'z' */
3450Sstevel@tonic-gate #define _ACPI_PU     0x10    /* punctuation */
3460Sstevel@tonic-gate #define _ACPI_SP     0x08    /* space */
3470Sstevel@tonic-gate #define _ACPI_UP     0x01    /* 'A'-'Z' */
3480Sstevel@tonic-gate #define _ACPI_XD     0x80    /* '0'-'9', 'A'-'F', 'a'-'f' */
3490Sstevel@tonic-gate 
3500Sstevel@tonic-gate #define ACPI_IS_DIGIT(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_DI))
3510Sstevel@tonic-gate #define ACPI_IS_SPACE(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_SP))
3520Sstevel@tonic-gate #define ACPI_IS_XDIGIT(c) (_acpi_ctype[(unsigned char)(c)] & (_ACPI_XD))
3530Sstevel@tonic-gate #define ACPI_IS_UPPER(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_UP))
3540Sstevel@tonic-gate #define ACPI_IS_LOWER(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO))
3550Sstevel@tonic-gate #define ACPI_IS_PRINT(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO | _ACPI_UP | _ACPI_DI | _ACPI_SP | _ACPI_PU))
3560Sstevel@tonic-gate #define ACPI_IS_ALPHA(c)  (_acpi_ctype[(unsigned char)(c)] & (_ACPI_LO | _ACPI_UP))
3570Sstevel@tonic-gate 
358*9980SDana.Myers@Sun.COM #endif /* !ACPI_USE_SYSTEM_CLIBRARY */
359*9980SDana.Myers@Sun.COM 
360*9980SDana.Myers@Sun.COM #define ACPI_IS_ASCII(c)  ((c) < 0x80)
3610Sstevel@tonic-gate 
3620Sstevel@tonic-gate 
3630Sstevel@tonic-gate /*
3640Sstevel@tonic-gate  * utcopy - Object construction and conversion interfaces
3650Sstevel@tonic-gate  */
3660Sstevel@tonic-gate ACPI_STATUS
3670Sstevel@tonic-gate AcpiUtBuildSimpleObject(
3680Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Obj,
3690Sstevel@tonic-gate     ACPI_OBJECT             *UserObj,
3700Sstevel@tonic-gate     UINT8                   *DataSpace,
3710Sstevel@tonic-gate     UINT32                  *BufferSpaceUsed);
3720Sstevel@tonic-gate 
3730Sstevel@tonic-gate ACPI_STATUS
3740Sstevel@tonic-gate AcpiUtBuildPackageObject (
3750Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Obj,
3760Sstevel@tonic-gate     UINT8                   *Buffer,
3770Sstevel@tonic-gate     UINT32                  *SpaceUsed);
3780Sstevel@tonic-gate 
3790Sstevel@tonic-gate ACPI_STATUS
3800Sstevel@tonic-gate AcpiUtCopyIobjectToEobject (
3810Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Obj,
3820Sstevel@tonic-gate     ACPI_BUFFER             *RetBuffer);
3830Sstevel@tonic-gate 
3840Sstevel@tonic-gate ACPI_STATUS
3850Sstevel@tonic-gate AcpiUtCopyEobjectToIobject (
3860Sstevel@tonic-gate     ACPI_OBJECT             *Obj,
3870Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     **InternalObj);
3880Sstevel@tonic-gate 
3890Sstevel@tonic-gate ACPI_STATUS
3900Sstevel@tonic-gate AcpiUtCopyISimpleToIsimple (
3910Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *SourceObj,
3920Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *DestObj);
3930Sstevel@tonic-gate 
3940Sstevel@tonic-gate ACPI_STATUS
3950Sstevel@tonic-gate AcpiUtCopyIobjectToIobject (
3960Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *SourceDesc,
3970Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     **DestDesc,
3980Sstevel@tonic-gate     ACPI_WALK_STATE         *WalkState);
3990Sstevel@tonic-gate 
4000Sstevel@tonic-gate 
4010Sstevel@tonic-gate /*
4020Sstevel@tonic-gate  * utcreate - Object creation
4030Sstevel@tonic-gate  */
4040Sstevel@tonic-gate ACPI_STATUS
4050Sstevel@tonic-gate AcpiUtUpdateObjectReference (
4060Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Object,
4070Sstevel@tonic-gate     UINT16                  Action);
4080Sstevel@tonic-gate 
4090Sstevel@tonic-gate 
4100Sstevel@tonic-gate /*
4110Sstevel@tonic-gate  * utdebug - Debug interfaces
4120Sstevel@tonic-gate  */
4130Sstevel@tonic-gate void
4140Sstevel@tonic-gate AcpiUtInitStackPtrTrace (
4150Sstevel@tonic-gate     void);
4160Sstevel@tonic-gate 
4170Sstevel@tonic-gate void
4180Sstevel@tonic-gate AcpiUtTrackStackPtr (
4190Sstevel@tonic-gate     void);
4200Sstevel@tonic-gate 
4210Sstevel@tonic-gate void
4220Sstevel@tonic-gate AcpiUtTrace (
4230Sstevel@tonic-gate     UINT32                  LineNumber,
424941Smyers     const char              *FunctionName,
4257851SDana.Myers@Sun.COM     const char              *ModuleName,
426347Smyers     UINT32                  ComponentId);
4270Sstevel@tonic-gate 
4280Sstevel@tonic-gate void
4290Sstevel@tonic-gate AcpiUtTracePtr (
4300Sstevel@tonic-gate     UINT32                  LineNumber,
431941Smyers     const char              *FunctionName,
4327851SDana.Myers@Sun.COM     const char              *ModuleName,
433347Smyers     UINT32                  ComponentId,
4340Sstevel@tonic-gate     void                    *Pointer);
4350Sstevel@tonic-gate 
4360Sstevel@tonic-gate void
4370Sstevel@tonic-gate AcpiUtTraceU32 (
4380Sstevel@tonic-gate     UINT32                  LineNumber,
439941Smyers     const char              *FunctionName,
4407851SDana.Myers@Sun.COM     const char              *ModuleName,
441347Smyers     UINT32                  ComponentId,
4420Sstevel@tonic-gate     UINT32                  Integer);
4430Sstevel@tonic-gate 
4440Sstevel@tonic-gate void
4450Sstevel@tonic-gate AcpiUtTraceStr (
4460Sstevel@tonic-gate     UINT32                  LineNumber,
447941Smyers     const char              *FunctionName,
4487851SDana.Myers@Sun.COM     const char              *ModuleName,
449347Smyers     UINT32                  ComponentId,
4500Sstevel@tonic-gate     char                    *String);
4510Sstevel@tonic-gate 
4520Sstevel@tonic-gate void
4530Sstevel@tonic-gate AcpiUtExit (
4540Sstevel@tonic-gate     UINT32                  LineNumber,
455941Smyers     const char              *FunctionName,
4567851SDana.Myers@Sun.COM     const char              *ModuleName,
457347Smyers     UINT32                  ComponentId);
4580Sstevel@tonic-gate 
4590Sstevel@tonic-gate void
4600Sstevel@tonic-gate AcpiUtStatusExit (
4610Sstevel@tonic-gate     UINT32                  LineNumber,
462941Smyers     const char              *FunctionName,
4637851SDana.Myers@Sun.COM     const char              *ModuleName,
464347Smyers     UINT32                  ComponentId,
4650Sstevel@tonic-gate     ACPI_STATUS             Status);
4660Sstevel@tonic-gate 
4670Sstevel@tonic-gate void
4680Sstevel@tonic-gate AcpiUtValueExit (
4690Sstevel@tonic-gate     UINT32                  LineNumber,
470941Smyers     const char              *FunctionName,
4717851SDana.Myers@Sun.COM     const char              *ModuleName,
472347Smyers     UINT32                  ComponentId,
4730Sstevel@tonic-gate     ACPI_INTEGER            Value);
4740Sstevel@tonic-gate 
4750Sstevel@tonic-gate void
4760Sstevel@tonic-gate AcpiUtPtrExit (
4770Sstevel@tonic-gate     UINT32                  LineNumber,
478941Smyers     const char              *FunctionName,
4797851SDana.Myers@Sun.COM     const char              *ModuleName,
480347Smyers     UINT32                  ComponentId,
4810Sstevel@tonic-gate     UINT8                   *Ptr);
4820Sstevel@tonic-gate 
4830Sstevel@tonic-gate void
4840Sstevel@tonic-gate AcpiUtDumpBuffer (
4850Sstevel@tonic-gate     UINT8                   *Buffer,
4860Sstevel@tonic-gate     UINT32                  Count,
4870Sstevel@tonic-gate     UINT32                  Display,
4880Sstevel@tonic-gate     UINT32                  componentId);
4890Sstevel@tonic-gate 
4901560Smyers void
4912623Smyers AcpiUtDumpBuffer2 (
4922623Smyers     UINT8                   *Buffer,
4932623Smyers     UINT32                  Count,
4942623Smyers     UINT32                  Display);
4952623Smyers 
4962623Smyers void
4971560Smyers AcpiUtReportError (
4981560Smyers     char                    *ModuleName,
4991560Smyers     UINT32                  LineNumber);
5001560Smyers 
5011560Smyers void
5021560Smyers AcpiUtReportInfo (
5031560Smyers     char                    *ModuleName,
5041560Smyers     UINT32                  LineNumber);
5051560Smyers 
5061560Smyers void
5071560Smyers AcpiUtReportWarning (
5081560Smyers     char                    *ModuleName,
5091560Smyers     UINT32                  LineNumber);
5101560Smyers 
5110Sstevel@tonic-gate /*
5120Sstevel@tonic-gate  * utdelete - Object deletion and reference counts
5130Sstevel@tonic-gate  */
5140Sstevel@tonic-gate void
5150Sstevel@tonic-gate AcpiUtAddReference (
5160Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Object);
5170Sstevel@tonic-gate 
5180Sstevel@tonic-gate void
5190Sstevel@tonic-gate AcpiUtRemoveReference (
5200Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Object);
5210Sstevel@tonic-gate 
5220Sstevel@tonic-gate void
5230Sstevel@tonic-gate AcpiUtDeleteInternalPackageObject (
5240Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Object);
5250Sstevel@tonic-gate 
5260Sstevel@tonic-gate void
5270Sstevel@tonic-gate AcpiUtDeleteInternalSimpleObject (
5280Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Object);
5290Sstevel@tonic-gate 
5300Sstevel@tonic-gate void
5310Sstevel@tonic-gate AcpiUtDeleteInternalObjectList (
5320Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     **ObjList);
5330Sstevel@tonic-gate 
5340Sstevel@tonic-gate 
5350Sstevel@tonic-gate /*
5360Sstevel@tonic-gate  * uteval - object evaluation
5370Sstevel@tonic-gate  */
5380Sstevel@tonic-gate ACPI_STATUS
5390Sstevel@tonic-gate AcpiUtOsiImplementation (
5400Sstevel@tonic-gate     ACPI_WALK_STATE         *WalkState);
5410Sstevel@tonic-gate 
5420Sstevel@tonic-gate ACPI_STATUS
5430Sstevel@tonic-gate AcpiUtEvaluateObject (
5440Sstevel@tonic-gate     ACPI_NAMESPACE_NODE     *PrefixNode,
5450Sstevel@tonic-gate     char                    *Path,
5460Sstevel@tonic-gate     UINT32                  ExpectedReturnBtypes,
5470Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     **ReturnDesc);
5480Sstevel@tonic-gate 
5490Sstevel@tonic-gate ACPI_STATUS
5500Sstevel@tonic-gate AcpiUtEvaluateNumericObject (
5510Sstevel@tonic-gate     char                    *ObjectName,
5520Sstevel@tonic-gate     ACPI_NAMESPACE_NODE     *DeviceNode,
5530Sstevel@tonic-gate     ACPI_INTEGER            *Address);
5540Sstevel@tonic-gate 
5550Sstevel@tonic-gate ACPI_STATUS
5560Sstevel@tonic-gate AcpiUtExecute_HID (
5570Sstevel@tonic-gate     ACPI_NAMESPACE_NODE     *DeviceNode,
5580Sstevel@tonic-gate     ACPI_DEVICE_ID          *Hid);
5590Sstevel@tonic-gate 
5600Sstevel@tonic-gate ACPI_STATUS
5610Sstevel@tonic-gate AcpiUtExecute_CID (
5620Sstevel@tonic-gate     ACPI_NAMESPACE_NODE     *DeviceNode,
5630Sstevel@tonic-gate     ACPI_COMPATIBLE_ID_LIST **ReturnCidList);
5640Sstevel@tonic-gate 
5650Sstevel@tonic-gate ACPI_STATUS
5660Sstevel@tonic-gate AcpiUtExecute_STA (
5670Sstevel@tonic-gate     ACPI_NAMESPACE_NODE     *DeviceNode,
5680Sstevel@tonic-gate     UINT32                  *StatusFlags);
5690Sstevel@tonic-gate 
5700Sstevel@tonic-gate ACPI_STATUS
5710Sstevel@tonic-gate AcpiUtExecute_UID (
5720Sstevel@tonic-gate     ACPI_NAMESPACE_NODE     *DeviceNode,
5730Sstevel@tonic-gate     ACPI_DEVICE_ID          *Uid);
5740Sstevel@tonic-gate 
5750Sstevel@tonic-gate ACPI_STATUS
5760Sstevel@tonic-gate AcpiUtExecute_Sxds (
5770Sstevel@tonic-gate     ACPI_NAMESPACE_NODE     *DeviceNode,
5780Sstevel@tonic-gate     UINT8                   *Highest);
5790Sstevel@tonic-gate 
580*9980SDana.Myers@Sun.COM /*
581*9980SDana.Myers@Sun.COM  * utlock - reader/writer locks
582*9980SDana.Myers@Sun.COM  */
583*9980SDana.Myers@Sun.COM ACPI_STATUS
584*9980SDana.Myers@Sun.COM AcpiUtCreateRwLock (
585*9980SDana.Myers@Sun.COM     ACPI_RW_LOCK            *Lock);
586*9980SDana.Myers@Sun.COM 
587*9980SDana.Myers@Sun.COM void
588*9980SDana.Myers@Sun.COM AcpiUtDeleteRwLock (
589*9980SDana.Myers@Sun.COM     ACPI_RW_LOCK            *Lock);
590*9980SDana.Myers@Sun.COM 
591*9980SDana.Myers@Sun.COM ACPI_STATUS
592*9980SDana.Myers@Sun.COM AcpiUtAcquireReadLock (
593*9980SDana.Myers@Sun.COM     ACPI_RW_LOCK            *Lock);
594*9980SDana.Myers@Sun.COM 
595*9980SDana.Myers@Sun.COM ACPI_STATUS
596*9980SDana.Myers@Sun.COM AcpiUtReleaseReadLock (
597*9980SDana.Myers@Sun.COM     ACPI_RW_LOCK            *Lock);
598*9980SDana.Myers@Sun.COM 
599*9980SDana.Myers@Sun.COM ACPI_STATUS
600*9980SDana.Myers@Sun.COM AcpiUtAcquireWriteLock (
601*9980SDana.Myers@Sun.COM     ACPI_RW_LOCK            *Lock);
602*9980SDana.Myers@Sun.COM 
603*9980SDana.Myers@Sun.COM void
604*9980SDana.Myers@Sun.COM AcpiUtReleaseWriteLock (
605*9980SDana.Myers@Sun.COM     ACPI_RW_LOCK            *Lock);
606*9980SDana.Myers@Sun.COM 
6070Sstevel@tonic-gate 
6080Sstevel@tonic-gate /*
6090Sstevel@tonic-gate  * utobject - internal object create/delete/cache routines
6100Sstevel@tonic-gate  */
6110Sstevel@tonic-gate ACPI_OPERAND_OBJECT  *
6120Sstevel@tonic-gate AcpiUtCreateInternalObjectDbg (
6137851SDana.Myers@Sun.COM     const char              *ModuleName,
6140Sstevel@tonic-gate     UINT32                  LineNumber,
6150Sstevel@tonic-gate     UINT32                  ComponentId,
6160Sstevel@tonic-gate     ACPI_OBJECT_TYPE        Type);
6170Sstevel@tonic-gate 
6180Sstevel@tonic-gate void *
6190Sstevel@tonic-gate AcpiUtAllocateObjectDescDbg (
6207851SDana.Myers@Sun.COM     const char              *ModuleName,
6210Sstevel@tonic-gate     UINT32                  LineNumber,
6220Sstevel@tonic-gate     UINT32                  ComponentId);
6230Sstevel@tonic-gate 
624347Smyers #define AcpiUtCreateInternalObject(t)   AcpiUtCreateInternalObjectDbg (_AcpiModuleName,__LINE__,_COMPONENT,t)
625347Smyers #define AcpiUtAllocateObjectDesc()      AcpiUtAllocateObjectDescDbg (_AcpiModuleName,__LINE__,_COMPONENT)
6260Sstevel@tonic-gate 
6270Sstevel@tonic-gate void
6280Sstevel@tonic-gate AcpiUtDeleteObjectDesc (
6290Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Object);
6300Sstevel@tonic-gate 
6310Sstevel@tonic-gate BOOLEAN
6320Sstevel@tonic-gate AcpiUtValidInternalObject (
6330Sstevel@tonic-gate     void                    *Object);
6340Sstevel@tonic-gate 
6350Sstevel@tonic-gate ACPI_OPERAND_OBJECT *
6367851SDana.Myers@Sun.COM AcpiUtCreatePackageObject (
6377851SDana.Myers@Sun.COM     UINT32                  Count);
6387851SDana.Myers@Sun.COM 
6397851SDana.Myers@Sun.COM ACPI_OPERAND_OBJECT *
6400Sstevel@tonic-gate AcpiUtCreateBufferObject (
6410Sstevel@tonic-gate     ACPI_SIZE               BufferSize);
6420Sstevel@tonic-gate 
6430Sstevel@tonic-gate ACPI_OPERAND_OBJECT *
6440Sstevel@tonic-gate AcpiUtCreateStringObject (
6450Sstevel@tonic-gate     ACPI_SIZE               StringSize);
6460Sstevel@tonic-gate 
6470Sstevel@tonic-gate ACPI_STATUS
6480Sstevel@tonic-gate AcpiUtGetObjectSize(
6490Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Obj,
6500Sstevel@tonic-gate     ACPI_SIZE               *ObjLength);
6510Sstevel@tonic-gate 
6520Sstevel@tonic-gate 
6530Sstevel@tonic-gate /*
6540Sstevel@tonic-gate  * utstate - Generic state creation/cache routines
6550Sstevel@tonic-gate  */
6560Sstevel@tonic-gate void
6570Sstevel@tonic-gate AcpiUtPushGenericState (
6580Sstevel@tonic-gate     ACPI_GENERIC_STATE      **ListHead,
6590Sstevel@tonic-gate     ACPI_GENERIC_STATE      *State);
6600Sstevel@tonic-gate 
6610Sstevel@tonic-gate ACPI_GENERIC_STATE *
6620Sstevel@tonic-gate AcpiUtPopGenericState (
6630Sstevel@tonic-gate     ACPI_GENERIC_STATE      **ListHead);
6640Sstevel@tonic-gate 
6650Sstevel@tonic-gate 
6660Sstevel@tonic-gate ACPI_GENERIC_STATE *
6670Sstevel@tonic-gate AcpiUtCreateGenericState (
6680Sstevel@tonic-gate     void);
6690Sstevel@tonic-gate 
6700Sstevel@tonic-gate ACPI_THREAD_STATE *
6710Sstevel@tonic-gate AcpiUtCreateThreadState (
6720Sstevel@tonic-gate     void);
6730Sstevel@tonic-gate 
6740Sstevel@tonic-gate ACPI_GENERIC_STATE *
6750Sstevel@tonic-gate AcpiUtCreateUpdateState (
6760Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Object,
6770Sstevel@tonic-gate     UINT16                  Action);
6780Sstevel@tonic-gate 
6790Sstevel@tonic-gate ACPI_GENERIC_STATE *
6800Sstevel@tonic-gate AcpiUtCreatePkgState (
6810Sstevel@tonic-gate     void                    *InternalObject,
6820Sstevel@tonic-gate     void                    *ExternalObject,
6830Sstevel@tonic-gate     UINT16                  Index);
6840Sstevel@tonic-gate 
6850Sstevel@tonic-gate ACPI_STATUS
6860Sstevel@tonic-gate AcpiUtCreateUpdateStateAndPush (
6870Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *Object,
6880Sstevel@tonic-gate     UINT16                  Action,
6890Sstevel@tonic-gate     ACPI_GENERIC_STATE      **StateList);
6900Sstevel@tonic-gate 
6910Sstevel@tonic-gate ACPI_STATUS
6920Sstevel@tonic-gate AcpiUtCreatePkgStateAndPush (
6930Sstevel@tonic-gate     void                    *InternalObject,
6940Sstevel@tonic-gate     void                    *ExternalObject,
6950Sstevel@tonic-gate     UINT16                  Index,
6960Sstevel@tonic-gate     ACPI_GENERIC_STATE      **StateList);
6970Sstevel@tonic-gate 
6980Sstevel@tonic-gate ACPI_GENERIC_STATE *
6990Sstevel@tonic-gate AcpiUtCreateControlState (
7000Sstevel@tonic-gate     void);
7010Sstevel@tonic-gate 
7020Sstevel@tonic-gate void
7030Sstevel@tonic-gate AcpiUtDeleteGenericState (
7040Sstevel@tonic-gate     ACPI_GENERIC_STATE      *State);
7050Sstevel@tonic-gate 
7060Sstevel@tonic-gate 
7070Sstevel@tonic-gate /*
7080Sstevel@tonic-gate  * utmath
7090Sstevel@tonic-gate  */
7100Sstevel@tonic-gate ACPI_STATUS
7110Sstevel@tonic-gate AcpiUtDivide (
7120Sstevel@tonic-gate     ACPI_INTEGER            InDividend,
7130Sstevel@tonic-gate     ACPI_INTEGER            InDivisor,
7140Sstevel@tonic-gate     ACPI_INTEGER            *OutQuotient,
7150Sstevel@tonic-gate     ACPI_INTEGER            *OutRemainder);
7160Sstevel@tonic-gate 
7170Sstevel@tonic-gate ACPI_STATUS
7180Sstevel@tonic-gate AcpiUtShortDivide (
7190Sstevel@tonic-gate     ACPI_INTEGER            InDividend,
7200Sstevel@tonic-gate     UINT32                  Divisor,
7210Sstevel@tonic-gate     ACPI_INTEGER            *OutQuotient,
7220Sstevel@tonic-gate     UINT32                  *OutRemainder);
7230Sstevel@tonic-gate 
7240Sstevel@tonic-gate /*
7250Sstevel@tonic-gate  * utmisc
7260Sstevel@tonic-gate  */
7277851SDana.Myers@Sun.COM const char *
7287851SDana.Myers@Sun.COM AcpiUtValidateException (
7297851SDana.Myers@Sun.COM     ACPI_STATUS             Status);
7307851SDana.Myers@Sun.COM 
7312623Smyers BOOLEAN
7322623Smyers AcpiUtIsAmlTable (
7332623Smyers     ACPI_TABLE_HEADER       *Table);
7342623Smyers 
7350Sstevel@tonic-gate ACPI_STATUS
736347Smyers AcpiUtAllocateOwnerId (
737347Smyers     ACPI_OWNER_ID           *OwnerId);
738347Smyers 
739941Smyers void
740347Smyers AcpiUtReleaseOwnerId (
741941Smyers     ACPI_OWNER_ID           *OwnerId);
742347Smyers 
743347Smyers ACPI_STATUS
7440Sstevel@tonic-gate AcpiUtWalkPackageTree (
7450Sstevel@tonic-gate     ACPI_OPERAND_OBJECT     *SourceObject,
7460Sstevel@tonic-gate     void                    *TargetObject,
7470Sstevel@tonic-gate     ACPI_PKG_CALLBACK       WalkCallback,
7480Sstevel@tonic-gate     void                    *Context);
7490Sstevel@tonic-gate 
750941Smyers void
7510Sstevel@tonic-gate AcpiUtStrupr (
7520Sstevel@tonic-gate     char                    *SrcString);
7530Sstevel@tonic-gate 
7540Sstevel@tonic-gate void
7550Sstevel@tonic-gate AcpiUtPrintString (
7560Sstevel@tonic-gate     char                    *String,
7570Sstevel@tonic-gate     UINT8                   MaxLength);
7580Sstevel@tonic-gate 
7590Sstevel@tonic-gate BOOLEAN
7600Sstevel@tonic-gate AcpiUtValidAcpiName (
7610Sstevel@tonic-gate     UINT32                  Name);
7620Sstevel@tonic-gate 
7637851SDana.Myers@Sun.COM void
7642623Smyers AcpiUtRepairName (
7657851SDana.Myers@Sun.COM     char                    *Name);
7662623Smyers 
7670Sstevel@tonic-gate BOOLEAN
7682623Smyers AcpiUtValidAcpiChar (
7692623Smyers     char                    Character,
7707851SDana.Myers@Sun.COM     UINT32                  Position);
7710Sstevel@tonic-gate 
7720Sstevel@tonic-gate ACPI_STATUS
7730Sstevel@tonic-gate AcpiUtStrtoul64 (
7740Sstevel@tonic-gate     char                    *String,
7750Sstevel@tonic-gate     UINT32                  Base,
7760Sstevel@tonic-gate     ACPI_INTEGER            *RetInteger);
7770Sstevel@tonic-gate 
7780Sstevel@tonic-gate /* Values for Base above (16=Hex, 10=Decimal) */
7790Sstevel@tonic-gate 
7800Sstevel@tonic-gate #define ACPI_ANY_BASE        0
7810Sstevel@tonic-gate 
7822623Smyers UINT32
7832623Smyers AcpiUtDwordByteSwap (
7842623Smyers     UINT32                  Value);
7852623Smyers 
7862623Smyers void
7872623Smyers AcpiUtSetIntegerWidth (
7882623Smyers     UINT8                   Revision);
7892623Smyers 
7902623Smyers #ifdef ACPI_DEBUG_OUTPUT
7912623Smyers void
7922623Smyers AcpiUtDisplayInitPathname (
7932623Smyers     UINT8                   Type,
7942623Smyers     ACPI_NAMESPACE_NODE     *ObjHandle,
7952623Smyers     char                    *Path);
7962623Smyers #endif
7972623Smyers 
7982623Smyers 
7992623Smyers /*
8002623Smyers  * utresrc
8012623Smyers  */
8022623Smyers ACPI_STATUS
8032623Smyers AcpiUtWalkAmlResources (
8042623Smyers     UINT8                   *Aml,
8052623Smyers     ACPI_SIZE               AmlLength,
8062623Smyers     ACPI_WALK_AML_CALLBACK  UserFunction,
8072623Smyers     void                    *Context);
8082623Smyers 
8091560Smyers ACPI_STATUS
8101560Smyers AcpiUtValidateResource (
8111560Smyers     void                    *Aml,
8121560Smyers     UINT8                   *ReturnIndex);
8131560Smyers 
8141560Smyers UINT32
8151560Smyers AcpiUtGetDescriptorLength (
8161560Smyers     void                    *Aml);
8171560Smyers 
8181560Smyers UINT16
8191560Smyers AcpiUtGetResourceLength (
8201560Smyers     void                    *Aml);
8210Sstevel@tonic-gate 
8220Sstevel@tonic-gate UINT8
8231560Smyers AcpiUtGetResourceHeaderLength (
8241560Smyers     void                    *Aml);
8251560Smyers 
8261560Smyers UINT8
8271560Smyers AcpiUtGetResourceType (
8281560Smyers     void                    *Aml);
8291560Smyers 
8301560Smyers ACPI_STATUS
8311560Smyers AcpiUtGetResourceEndTag (
8321560Smyers     ACPI_OPERAND_OBJECT     *ObjDesc,
8331560Smyers     UINT8                   **EndTag);
8340Sstevel@tonic-gate 
8350Sstevel@tonic-gate 
8360Sstevel@tonic-gate /*
837347Smyers  * utmutex - mutex support
8380Sstevel@tonic-gate  */
839347Smyers ACPI_STATUS
840347Smyers AcpiUtMutexInitialize (
841347Smyers     void);
8420Sstevel@tonic-gate 
8430Sstevel@tonic-gate void
844347Smyers AcpiUtMutexTerminate (
845347Smyers     void);
846347Smyers 
847347Smyers ACPI_STATUS
848347Smyers AcpiUtAcquireMutex (
849347Smyers     ACPI_MUTEX_HANDLE       MutexId);
850347Smyers 
851347Smyers ACPI_STATUS
852347Smyers AcpiUtReleaseMutex (
853347Smyers     ACPI_MUTEX_HANDLE       MutexId);
854347Smyers 
8550Sstevel@tonic-gate 
856347Smyers /*
857347Smyers  * utalloc - memory allocation and object caching
858347Smyers  */
859347Smyers ACPI_STATUS
860347Smyers AcpiUtCreateCaches (
861347Smyers     void);
862347Smyers 
863347Smyers ACPI_STATUS
864347Smyers AcpiUtDeleteCaches (
865347Smyers     void);
8660Sstevel@tonic-gate 
8670Sstevel@tonic-gate ACPI_STATUS
8680Sstevel@tonic-gate AcpiUtValidateBuffer (
8690Sstevel@tonic-gate     ACPI_BUFFER             *Buffer);
8700Sstevel@tonic-gate 
8710Sstevel@tonic-gate ACPI_STATUS
8720Sstevel@tonic-gate AcpiUtInitializeBuffer (
8730Sstevel@tonic-gate     ACPI_BUFFER             *Buffer,
8740Sstevel@tonic-gate     ACPI_SIZE               RequiredLength);
8750Sstevel@tonic-gate 
8760Sstevel@tonic-gate void *
8770Sstevel@tonic-gate AcpiUtAllocate (
8780Sstevel@tonic-gate     ACPI_SIZE               Size,
8790Sstevel@tonic-gate     UINT32                  Component,
8807851SDana.Myers@Sun.COM     const char              *Module,
8810Sstevel@tonic-gate     UINT32                  Line);
8820Sstevel@tonic-gate 
8830Sstevel@tonic-gate void *
8842623Smyers AcpiUtAllocateZeroed (
8850Sstevel@tonic-gate     ACPI_SIZE               Size,
8860Sstevel@tonic-gate     UINT32                  Component,
8877851SDana.Myers@Sun.COM     const char              *Module,
8880Sstevel@tonic-gate     UINT32                  Line);
8890Sstevel@tonic-gate 
8900Sstevel@tonic-gate #ifdef ACPI_DBG_TRACK_ALLOCATIONS
8910Sstevel@tonic-gate void *
8920Sstevel@tonic-gate AcpiUtAllocateAndTrack (
8930Sstevel@tonic-gate     ACPI_SIZE               Size,
8940Sstevel@tonic-gate     UINT32                  Component,
8957851SDana.Myers@Sun.COM     const char              *Module,
8960Sstevel@tonic-gate     UINT32                  Line);
8970Sstevel@tonic-gate 
8980Sstevel@tonic-gate void *
8992623Smyers AcpiUtAllocateZeroedAndTrack (
9000Sstevel@tonic-gate     ACPI_SIZE               Size,
9010Sstevel@tonic-gate     UINT32                  Component,
9027851SDana.Myers@Sun.COM     const char              *Module,
9030Sstevel@tonic-gate     UINT32                  Line);
9040Sstevel@tonic-gate 
9050Sstevel@tonic-gate void
9060Sstevel@tonic-gate AcpiUtFreeAndTrack (
9070Sstevel@tonic-gate     void                    *Address,
9080Sstevel@tonic-gate     UINT32                  Component,
9097851SDana.Myers@Sun.COM     const char              *Module,
9100Sstevel@tonic-gate     UINT32                  Line);
9110Sstevel@tonic-gate 
9120Sstevel@tonic-gate void
9130Sstevel@tonic-gate AcpiUtDumpAllocationInfo (
9140Sstevel@tonic-gate     void);
9150Sstevel@tonic-gate 
9160Sstevel@tonic-gate void
9170Sstevel@tonic-gate AcpiUtDumpAllocations (
9180Sstevel@tonic-gate     UINT32                  Component,
9197851SDana.Myers@Sun.COM     const char              *Module);
9202623Smyers 
9212623Smyers ACPI_STATUS
9222623Smyers AcpiUtCreateList (
9232623Smyers     char                    *ListName,
9242623Smyers     UINT16                  ObjectSize,
9252623Smyers     ACPI_MEMORY_LIST        **ReturnCache);
9262623Smyers 
9272623Smyers 
9280Sstevel@tonic-gate #endif
9290Sstevel@tonic-gate 
9300Sstevel@tonic-gate #endif /* _ACUTILS_H */
931