Home | History | Annotate | Line # | Download | only in include
      1 /******************************************************************************
      2  *
      3  * Name: acpixf.h - External interfaces to the ACPI subsystem
      4  *
      5  *****************************************************************************/
      6 
      7 /*
      8  * Copyright (C) 2000 - 2025, Intel Corp.
      9  * All rights reserved.
     10  *
     11  * Redistribution and use in source and binary forms, with or without
     12  * modification, are permitted provided that the following conditions
     13  * are met:
     14  * 1. Redistributions of source code must retain the above copyright
     15  *    notice, this list of conditions, and the following disclaimer,
     16  *    without modification.
     17  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  *    including a substantially similar Disclaimer requirement for further
     21  *    binary redistribution.
     22  * 3. Neither the names of the above-listed copyright holders nor the names
     23  *    of any contributors may be used to endorse or promote products derived
     24  *    from this software without specific prior written permission.
     25  *
     26  * Alternatively, this software may be distributed under the terms of the
     27  * GNU General Public License ("GPL") version 2 as published by the Free
     28  * Software Foundation.
     29  *
     30  * NO WARRANTY
     31  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     34  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  * POSSIBILITY OF SUCH DAMAGES.
     42  */
     43 
     44 #ifndef __ACXFACE_H__
     45 #define __ACXFACE_H__
     46 
     47 /* Current ACPICA subsystem version in YYYYMMDD format */
     48 
     49 #define ACPI_CA_VERSION                 0x20251212
     50 
     51 #include "acconfig.h"
     52 #include "actypes.h"
     53 #include "actbl.h"
     54 #include "acbuffer.h"
     55 
     56 
     57 /*****************************************************************************
     58  *
     59  * Macros used for ACPICA globals and configuration
     60  *
     61  ****************************************************************************/
     62 
     63 /*
     64  * Ensure that global variables are defined and initialized only once.
     65  *
     66  * The use of these macros allows for a single list of globals (here)
     67  * in order to simplify maintenance of the code.
     68  */
     69 #ifdef DEFINE_ACPI_GLOBALS
     70 #define ACPI_GLOBAL(type,name) \
     71     extern type name; \
     72     type name
     73 
     74 #define ACPI_INIT_GLOBAL(type,name,value) \
     75     type name=value
     76 
     77 #else
     78 #ifndef ACPI_GLOBAL
     79 #define ACPI_GLOBAL(type,name) \
     80     extern type name
     81 #endif
     82 
     83 #ifndef ACPI_INIT_GLOBAL
     84 #define ACPI_INIT_GLOBAL(type,name,value) \
     85     extern type name
     86 #endif
     87 #endif
     88 
     89 /*
     90  * These macros configure the various ACPICA interfaces. They are
     91  * useful for generating stub inline functions for features that are
     92  * configured out of the current kernel or ACPICA application.
     93  */
     94 #ifndef ACPI_EXTERNAL_RETURN_STATUS
     95 #define ACPI_EXTERNAL_RETURN_STATUS(Prototype) \
     96     Prototype;
     97 #endif
     98 
     99 #ifndef ACPI_EXTERNAL_RETURN_OK
    100 #define ACPI_EXTERNAL_RETURN_OK(Prototype) \
    101     Prototype;
    102 #endif
    103 
    104 #ifndef ACPI_EXTERNAL_RETURN_VOID
    105 #define ACPI_EXTERNAL_RETURN_VOID(Prototype) \
    106     Prototype;
    107 #endif
    108 
    109 #ifndef ACPI_EXTERNAL_RETURN_UINT32
    110 #define ACPI_EXTERNAL_RETURN_UINT32(Prototype) \
    111     Prototype;
    112 #endif
    113 
    114 #ifndef ACPI_EXTERNAL_RETURN_PTR
    115 #define ACPI_EXTERNAL_RETURN_PTR(Prototype) \
    116     Prototype;
    117 #endif
    118 
    119 
    120 /*****************************************************************************
    121  *
    122  * Public globals and runtime configuration options
    123  *
    124  ****************************************************************************/
    125 
    126 /*
    127  * Enable "slack mode" of the AML interpreter?  Default is FALSE, and the
    128  * interpreter strictly follows the ACPI specification. Setting to TRUE
    129  * allows the interpreter to ignore certain errors and/or bad AML constructs.
    130  *
    131  * Currently, these features are enabled by this flag:
    132  *
    133  * 1) Allow "implicit return" of last value in a control method
    134  * 2) Allow access beyond the end of an operation region
    135  * 3) Allow access to uninitialized locals/args (auto-init to integer 0)
    136  * 4) Allow ANY object type to be a source operand for the Store() operator
    137  * 5) Allow unresolved references (invalid target name) in package objects
    138  * 6) Enable warning messages for behavior that is not ACPI spec compliant
    139  */
    140 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_EnableInterpreterSlack, FALSE);
    141 
    142 /*
    143  * Automatically serialize all methods that create named objects? Default
    144  * is TRUE, meaning that all NonSerialized methods are scanned once at
    145  * table load time to determine those that create named objects. Methods
    146  * that create named objects are marked Serialized in order to prevent
    147  * possible run-time problems if they are entered by more than one thread.
    148  */
    149 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_AutoSerializeMethods, TRUE);
    150 
    151 /*
    152  * Create the predefined _OSI method in the namespace? Default is TRUE
    153  * because ACPICA is fully compatible with other ACPI implementations.
    154  * Changing this will revert ACPICA (and machine ASL) to pre-OSI behavior.
    155  */
    156 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_CreateOsiMethod, TRUE);
    157 
    158 /*
    159  * Optionally use default values for the ACPI register widths. Set this to
    160  * TRUE to use the defaults, if an FADT contains incorrect widths/lengths.
    161  */
    162 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_UseDefaultRegisterWidths, TRUE);
    163 
    164 /*
    165  * Whether or not to validate (map) an entire table to verify
    166  * checksum/duplication in early stage before install. Set this to TRUE to
    167  * allow early table validation before install it to the table manager.
    168  * Note that enabling this option causes errors to happen in some OSPMs
    169  * during early initialization stages. Default behavior is to allow such
    170  * validation.
    171  */
    172 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_EnableTableValidation, TRUE);
    173 
    174 /*
    175  * Optionally enable output from the AML Debug Object.
    176  */
    177 ACPI_INIT_GLOBAL (_Bool,            AcpiGbl_EnableAmlDebugObject, FALSE);
    178 
    179 /*
    180  * Optionally copy the entire DSDT to local memory (instead of simply
    181  * mapping it.) There are some BIOSs that corrupt or replace the original
    182  * DSDT, creating the need for this option. Default is FALSE, do not copy
    183  * the DSDT.
    184  */
    185 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_CopyDsdtLocally, FALSE);
    186 
    187 /*
    188  * Optionally ignore an XSDT if present and use the RSDT instead.
    189  * Although the ACPI specification requires that an XSDT be used instead
    190  * of the RSDT, the XSDT has been found to be corrupt or ill-formed on
    191  * some machines. Default behavior is to use the XSDT if present.
    192  */
    193 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_DoNotUseXsdt, FALSE);
    194 
    195 /*
    196  * Optionally use 32-bit FADT addresses if and when there is a conflict
    197  * (address mismatch) between the 32-bit and 64-bit versions of the
    198  * address. Although ACPICA adheres to the ACPI specification which
    199  * requires the use of the corresponding 64-bit address if it is non-zero,
    200  * some machines have been found to have a corrupted non-zero 64-bit
    201  * address. Default is FALSE, do not favor the 32-bit addresses.
    202  */
    203 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_Use32BitFadtAddresses, FALSE);
    204 
    205 /*
    206  * Optionally use 32-bit FACS table addresses.
    207  * It is reported that some platforms fail to resume from system suspending
    208  * if 64-bit FACS table address is selected:
    209  * https://bugzilla.kernel.org/show_bug.cgi?id=74021
    210  * Default is TRUE, favor the 32-bit addresses.
    211  */
    212 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_Use32BitFacsAddresses, TRUE);
    213 
    214 /*
    215  * Optionally truncate I/O addresses to 16 bits. Provides compatibility
    216  * with other ACPI implementations. NOTE: During ACPICA initialization,
    217  * this value is set to TRUE if any Windows OSI strings have been
    218  * requested by the BIOS.
    219  */
    220 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_TruncateIoAddresses, FALSE);
    221 
    222 /*
    223  * Disable runtime checking and repair of values returned by control methods.
    224  * Use only if the repair is causing a problem on a particular machine.
    225  */
    226 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_DisableAutoRepair, FALSE);
    227 
    228 /*
    229  * Optionally do not install any SSDTs from the RSDT/XSDT during initialization.
    230  * This can be useful for debugging ACPI problems on some machines.
    231  */
    232 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_DisableSsdtTableInstall, FALSE);
    233 
    234 /*
    235  * Optionally enable runtime namespace override.
    236  */
    237 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_RuntimeNamespaceOverride, TRUE);
    238 
    239 /*
    240  * We keep track of the latest version of Windows that has been requested by
    241  * the BIOS. ACPI 5.0.
    242  */
    243 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_OsiData, 0);
    244 
    245 /*
    246  * ACPI 5.0 introduces the concept of a "reduced hardware platform", meaning
    247  * that the ACPI hardware is no longer required. A flag in the FADT indicates
    248  * a reduced HW machine, and that flag is duplicated here for convenience.
    249  */
    250 ACPI_INIT_GLOBAL (BOOLEAN,          AcpiGbl_ReducedHardware, FALSE);
    251 
    252 /*
    253  * ACPI Global Lock is mainly used for systems with SMM, so no-SMM systems
    254  * (such as LoongArch) may not have and not use Global Lock.
    255  */
    256 ACPI_INIT_GLOBAL (BOOLEAN,          AcpiGbl_UseGlobalLock, TRUE);
    257 
    258 /*
    259  * Maximum timeout for While() loop iterations before forced method abort.
    260  * This mechanism is intended to prevent infinite loops during interpreter
    261  * execution within a host kernel.
    262  */
    263 ACPI_INIT_GLOBAL (UINT32,           AcpiGbl_MaxLoopIterations, ACPI_MAX_LOOP_TIMEOUT);
    264 
    265 /*
    266  * Optionally ignore AE_NOT_FOUND errors from named reference package elements
    267  * during DSDT/SSDT table loading. This reduces error "noise" in platforms
    268  * whose firmware is carrying around a bunch of unused package objects that
    269  * refer to non-existent named objects. However, If the AML actually tries to
    270  * use such a package, the unresolved element(s) will be replaced with NULL
    271  * elements.
    272  */
    273 ACPI_INIT_GLOBAL (BOOLEAN,          AcpiGbl_IgnorePackageResolutionErrors, FALSE);
    274 
    275 /*
    276  * This mechanism is used to trace a specified AML method. The method is
    277  * traced each time it is executed.
    278  */
    279 ACPI_INIT_GLOBAL (UINT32,           AcpiGbl_TraceFlags, 0);
    280 ACPI_INIT_GLOBAL (const char *,     AcpiGbl_TraceMethodName, NULL);
    281 ACPI_INIT_GLOBAL (UINT32,           AcpiGbl_TraceDbgLevel, ACPI_TRACE_LEVEL_DEFAULT);
    282 ACPI_INIT_GLOBAL (UINT32,           AcpiGbl_TraceDbgLayer, ACPI_TRACE_LAYER_DEFAULT);
    283 
    284 /*
    285  * Runtime configuration of debug output control masks. We want the debug
    286  * switches statically initialized so they are already set when the debugger
    287  * is entered.
    288  */
    289 #if defined(ACPI_DEBUG_OUTPUT) && defined(ACPI_DEBUG_TRACE)
    290 ACPI_INIT_GLOBAL (UINT32,           AcpiDbgLevel, ACPI_DEBUG_DEFAULT);
    291 #else
    292 ACPI_INIT_GLOBAL (UINT32,           AcpiDbgLevel, ACPI_NORMAL_DEFAULT);
    293 #endif
    294 ACPI_INIT_GLOBAL (UINT32,           AcpiDbgLayer, ACPI_COMPONENT_DEFAULT);
    295 
    296 /* Optionally enable timer output with Debug Object output */
    297 
    298 ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_DisplayDebugTimer, FALSE);
    299 
    300 /*
    301  * Debugger command handshake globals. Host OSes need to access these
    302  * variables to implement their own command handshake mechanism.
    303  */
    304 #ifdef ACPI_DEBUGGER
    305 ACPI_INIT_GLOBAL (BOOLEAN,          AcpiGbl_MethodExecuting, FALSE);
    306 ACPI_GLOBAL (char,                  AcpiGbl_DbLineBuf[ACPI_DB_LINE_BUFFER_SIZE]);
    307 #endif
    308 
    309 /*
    310  * Other miscellaneous globals
    311  */
    312 ACPI_GLOBAL (ACPI_TABLE_FADT,       AcpiGbl_FADT);
    313 ACPI_GLOBAL (UINT32,                AcpiCurrentGpeCount);
    314 ACPI_GLOBAL (BOOLEAN,               AcpiGbl_SystemAwakeAndRunning);
    315 
    316 
    317 /*****************************************************************************
    318  *
    319  * ACPICA public interface configuration.
    320  *
    321  * Interfaces that are configured out of the ACPICA build are replaced
    322  * by inlined stubs by default.
    323  *
    324  ****************************************************************************/
    325 
    326 /*
    327  * Hardware-reduced prototypes (default: Not hardware reduced).
    328  *
    329  * All ACPICA hardware-related interfaces that use these macros will be
    330  * configured out of the ACPICA build if the ACPI_REDUCED_HARDWARE flag
    331  * is set to TRUE.
    332  *
    333  * Note: This static build option for reduced hardware is intended to
    334  * reduce ACPICA code size if desired or necessary. However, even if this
    335  * option is not specified, the runtime behavior of ACPICA is dependent
    336  * on the actual FADT reduced hardware flag (HW_REDUCED_ACPI). If set,
    337  * the flag will enable similar behavior -- ACPICA will not attempt
    338  * to access any ACPI-relate hardware (SCI, GPEs, Fixed Events, etc.)
    339  */
    340 #if (!ACPI_REDUCED_HARDWARE)
    341 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \
    342     ACPI_EXTERNAL_RETURN_STATUS(Prototype)
    343 
    344 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \
    345     ACPI_EXTERNAL_RETURN_OK(Prototype)
    346 
    347 #define ACPI_HW_DEPENDENT_RETURN_UINT32(prototype) \
    348     ACPI_EXTERNAL_RETURN_UINT32(prototype)
    349 
    350 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \
    351     ACPI_EXTERNAL_RETURN_VOID(Prototype)
    352 
    353 #else
    354 #define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \
    355     static ACPI_INLINE Prototype {return(AE_NOT_CONFIGURED);}
    356 
    357 #define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \
    358     static ACPI_INLINE Prototype {return(AE_OK);}
    359 
    360 #define ACPI_HW_DEPENDENT_RETURN_UINT32(prototype) \
    361     static ACPI_INLINE prototype {return(0);}
    362 
    363 #define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \
    364     static ACPI_INLINE Prototype {return;}
    365 
    366 #endif /* !ACPI_REDUCED_HARDWARE */
    367 
    368 
    369 /*
    370  * Error message prototypes (default: error messages enabled).
    371  *
    372  * All interfaces related to error and warning messages
    373  * will be configured out of the ACPICA build if the
    374  * ACPI_NO_ERROR_MESSAGE flag is defined.
    375  */
    376 #ifndef ACPI_NO_ERROR_MESSAGES
    377 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \
    378     Prototype;
    379 
    380 #else
    381 #define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \
    382     static ACPI_INLINE Prototype {return;}
    383 
    384 #endif /* ACPI_NO_ERROR_MESSAGES */
    385 
    386 
    387 /*
    388  * Debugging output prototypes (default: no debug output).
    389  *
    390  * All interfaces related to debug output messages
    391  * will be configured out of the ACPICA build unless the
    392  * ACPI_DEBUG_OUTPUT flag is defined.
    393  */
    394 #ifdef ACPI_DEBUG_OUTPUT
    395 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \
    396     Prototype;
    397 
    398 #else
    399 #define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \
    400     static ACPI_INLINE Prototype {return;}
    401 
    402 #endif /* ACPI_DEBUG_OUTPUT */
    403 
    404 
    405 /*
    406  * Application prototypes
    407  *
    408  * All interfaces used by application will be configured
    409  * out of the ACPICA build unless the ACPI_APPLICATION
    410  * flag is defined.
    411  */
    412 #ifdef ACPI_APPLICATION
    413 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \
    414     Prototype;
    415 
    416 #else
    417 #define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \
    418     static ACPI_INLINE Prototype {return;}
    419 
    420 #endif /* ACPI_APPLICATION */
    421 
    422 
    423 /*
    424  * Debugger prototypes
    425  *
    426  * All interfaces used by debugger will be configured
    427  * out of the ACPICA build unless the ACPI_DEBUGGER
    428  * flag is defined.
    429  */
    430 #ifdef ACPI_DEBUGGER
    431 #define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \
    432     ACPI_EXTERNAL_RETURN_OK(Prototype)
    433 
    434 #define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \
    435     ACPI_EXTERNAL_RETURN_VOID(Prototype)
    436 
    437 #else
    438 #define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \
    439     static ACPI_INLINE Prototype {return(AE_OK);}
    440 
    441 #define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \
    442     static ACPI_INLINE Prototype {return;}
    443 
    444 #endif /* ACPI_DEBUGGER */
    445 
    446 
    447 /*****************************************************************************
    448  *
    449  * ACPICA public interface prototypes
    450  *
    451  ****************************************************************************/
    452 
    453 /*
    454  * Initialization
    455  */
    456 ACPI_EXTERNAL_RETURN_STATUS (
    457 ACPI_STATUS ACPI_INIT_FUNCTION
    458 AcpiInitializeTables (
    459     ACPI_TABLE_DESC         *InitialStorage,
    460     UINT32                  InitialTableCount,
    461     BOOLEAN                 AllowResize))
    462 
    463 ACPI_EXTERNAL_RETURN_STATUS (
    464 ACPI_STATUS ACPI_INIT_FUNCTION
    465 AcpiInitializeSubsystem (
    466     void))
    467 
    468 ACPI_EXTERNAL_RETURN_STATUS (
    469 ACPI_STATUS ACPI_INIT_FUNCTION
    470 AcpiEnableSubsystem (
    471     UINT32                  Flags))
    472 
    473 ACPI_EXTERNAL_RETURN_STATUS (
    474 ACPI_STATUS ACPI_INIT_FUNCTION
    475 AcpiInitializeObjects (
    476     UINT32                  Flags))
    477 
    478 ACPI_EXTERNAL_RETURN_STATUS (
    479 ACPI_STATUS ACPI_INIT_FUNCTION
    480 AcpiTerminate (
    481     void))
    482 
    483 
    484 /*
    485  * Miscellaneous global interfaces
    486  */
    487 ACPI_HW_DEPENDENT_RETURN_STATUS (
    488 ACPI_STATUS
    489 AcpiEnable (
    490     void))
    491 
    492 ACPI_HW_DEPENDENT_RETURN_STATUS (
    493 ACPI_STATUS
    494 AcpiDisable (
    495     void))
    496 
    497 ACPI_EXTERNAL_RETURN_STATUS (
    498 ACPI_STATUS
    499 AcpiSubsystemStatus (
    500     void))
    501 
    502 ACPI_EXTERNAL_RETURN_STATUS (
    503 ACPI_STATUS
    504 AcpiGetSystemInfo (
    505     ACPI_BUFFER             *RetBuffer))
    506 
    507 ACPI_EXTERNAL_RETURN_STATUS (
    508 ACPI_STATUS
    509 AcpiGetStatistics (
    510     ACPI_STATISTICS         *Stats))
    511 
    512 ACPI_EXTERNAL_RETURN_PTR (
    513 const char *
    514 AcpiFormatException (
    515     ACPI_STATUS             Exception))
    516 
    517 ACPI_EXTERNAL_RETURN_STATUS (
    518 ACPI_STATUS
    519 AcpiPurgeCachedObjects (
    520     void))
    521 
    522 ACPI_EXTERNAL_RETURN_STATUS (
    523 ACPI_STATUS
    524 AcpiInstallInterface (
    525     ACPI_STRING             InterfaceName))
    526 
    527 ACPI_EXTERNAL_RETURN_STATUS (
    528 ACPI_STATUS
    529 AcpiRemoveInterface (
    530     ACPI_STRING             InterfaceName))
    531 
    532 ACPI_EXTERNAL_RETURN_STATUS (
    533 ACPI_STATUS
    534 AcpiUpdateInterfaces (
    535     UINT8                   Action))
    536 
    537 ACPI_EXTERNAL_RETURN_UINT32 (
    538 UINT32
    539 AcpiCheckAddressRange (
    540     ACPI_ADR_SPACE_TYPE     SpaceId,
    541     ACPI_PHYSICAL_ADDRESS   Address,
    542     ACPI_SIZE               Length,
    543     BOOLEAN                 Warn))
    544 
    545 ACPI_EXTERNAL_RETURN_STATUS (
    546 ACPI_STATUS
    547 AcpiDecodePldBuffer (
    548     UINT8                   *InBuffer,
    549     ACPI_SIZE               Length,
    550     ACPI_PLD_INFO           **ReturnBuffer))
    551 
    552 
    553 /*
    554  * ACPI table load/unload interfaces
    555  */
    556 ACPI_EXTERNAL_RETURN_STATUS (
    557 ACPI_STATUS ACPI_INIT_FUNCTION
    558 AcpiInstallTable (
    559     ACPI_TABLE_HEADER       *Table))
    560 
    561 ACPI_EXTERNAL_RETURN_STATUS (
    562 ACPI_STATUS ACPI_INIT_FUNCTION
    563 AcpiInstallPhysicalTable (
    564     ACPI_PHYSICAL_ADDRESS   Address))
    565 
    566 ACPI_EXTERNAL_RETURN_STATUS (
    567 ACPI_STATUS
    568 AcpiLoadTable (
    569     ACPI_TABLE_HEADER       *Table,
    570     UINT32                  *TableIdx))
    571 
    572 ACPI_EXTERNAL_RETURN_STATUS (
    573 ACPI_STATUS
    574 AcpiUnloadTable (
    575     UINT32                  TableIndex))
    576 
    577 ACPI_EXTERNAL_RETURN_STATUS (
    578 ACPI_STATUS
    579 AcpiUnloadParentTable (
    580     ACPI_HANDLE             Object))
    581 
    582 ACPI_EXTERNAL_RETURN_STATUS (
    583 ACPI_STATUS ACPI_INIT_FUNCTION
    584 AcpiLoadTables (
    585     void))
    586 
    587 
    588 /*
    589  * ACPI table manipulation interfaces
    590  */
    591 ACPI_EXTERNAL_RETURN_STATUS (
    592 ACPI_STATUS ACPI_INIT_FUNCTION
    593 AcpiReallocateRootTable (
    594     void))
    595 
    596 ACPI_EXTERNAL_RETURN_STATUS (
    597 ACPI_STATUS ACPI_INIT_FUNCTION
    598 AcpiFindRootPointer (
    599     ACPI_PHYSICAL_ADDRESS   *RsdpAddress))
    600 
    601 ACPI_EXTERNAL_RETURN_STATUS (
    602 ACPI_STATUS
    603 AcpiGetTableHeader (
    604     ACPI_CONST_STRING       Signature,
    605     UINT32                  Instance,
    606     ACPI_TABLE_HEADER       *OutTableHeader))
    607 
    608 ACPI_EXTERNAL_RETURN_STATUS (
    609 ACPI_STATUS
    610 AcpiGetTable (
    611     ACPI_CONST_STRING       Signature,
    612     UINT32                  Instance,
    613     ACPI_TABLE_HEADER       **OutTable))
    614 
    615 ACPI_EXTERNAL_RETURN_VOID (
    616 void
    617 AcpiPutTable (
    618     ACPI_TABLE_HEADER       *Table))
    619 
    620 ACPI_EXTERNAL_RETURN_STATUS (
    621 ACPI_STATUS
    622 AcpiGetTableByIndex (
    623     UINT32                  TableIndex,
    624     ACPI_TABLE_HEADER       **OutTable))
    625 
    626 ACPI_EXTERNAL_RETURN_STATUS (
    627 ACPI_STATUS
    628 AcpiInstallTableHandler (
    629     ACPI_TABLE_HANDLER      Handler,
    630     void                    *Context))
    631 
    632 ACPI_EXTERNAL_RETURN_STATUS (
    633 ACPI_STATUS
    634 AcpiRemoveTableHandler (
    635     ACPI_TABLE_HANDLER      Handler))
    636 
    637 
    638 /*
    639  * Namespace and name interfaces
    640  */
    641 ACPI_EXTERNAL_RETURN_STATUS (
    642 ACPI_STATUS
    643 AcpiWalkNamespace (
    644     ACPI_OBJECT_TYPE        Type,
    645     ACPI_HANDLE             StartObject,
    646     UINT32                  MaxDepth,
    647     ACPI_WALK_CALLBACK      DescendingCallback,
    648     ACPI_WALK_CALLBACK      AscendingCallback,
    649     void                    *Context,
    650     void                    **ReturnValue))
    651 
    652 ACPI_EXTERNAL_RETURN_STATUS (
    653 ACPI_STATUS
    654 AcpiGetDevices (
    655     char                    *HID,
    656     ACPI_WALK_CALLBACK      UserFunction,
    657     void                    *Context,
    658     void                    **ReturnValue))
    659 
    660 ACPI_EXTERNAL_RETURN_STATUS (
    661 ACPI_STATUS
    662 AcpiGetName (
    663     ACPI_HANDLE             Object,
    664     UINT32                  NameType,
    665     ACPI_BUFFER             *RetPathPtr))
    666 
    667 ACPI_EXTERNAL_RETURN_STATUS (
    668 ACPI_STATUS
    669 AcpiGetHandle (
    670     ACPI_HANDLE             Parent,
    671     const char              *Pathname,
    672     ACPI_HANDLE             *RetHandle))
    673 
    674 ACPI_EXTERNAL_RETURN_STATUS (
    675 ACPI_STATUS
    676 AcpiAttachData (
    677     ACPI_HANDLE             Object,
    678     ACPI_OBJECT_HANDLER     Handler,
    679     void                    *Data))
    680 
    681 ACPI_EXTERNAL_RETURN_STATUS (
    682 ACPI_STATUS
    683 AcpiDetachData (
    684     ACPI_HANDLE             Object,
    685     ACPI_OBJECT_HANDLER     Handler))
    686 
    687 ACPI_EXTERNAL_RETURN_STATUS (
    688 ACPI_STATUS
    689 AcpiGetData (
    690     ACPI_HANDLE             Object,
    691     ACPI_OBJECT_HANDLER     Handler,
    692     void                    **Data))
    693 
    694 ACPI_EXTERNAL_RETURN_STATUS (
    695 ACPI_STATUS
    696 AcpiDebugTrace (
    697     const char              *Name,
    698     UINT32                  DebugLevel,
    699     UINT32                  DebugLayer,
    700     UINT32                  Flags))
    701 
    702 
    703 /*
    704  * Object manipulation and enumeration
    705  */
    706 ACPI_EXTERNAL_RETURN_STATUS (
    707 ACPI_STATUS
    708 AcpiEvaluateObject (
    709     ACPI_HANDLE             Object,
    710     ACPI_CONST_STRING       Pathname,
    711     ACPI_OBJECT_LIST        *ParameterObjects,
    712     ACPI_BUFFER             *ReturnObjectBuffer))
    713 
    714 ACPI_EXTERNAL_RETURN_STATUS (
    715 ACPI_STATUS
    716 AcpiEvaluateObjectTyped (
    717     ACPI_HANDLE             Object,
    718     ACPI_CONST_STRING       Pathname,
    719     ACPI_OBJECT_LIST        *ExternalParams,
    720     ACPI_BUFFER             *ReturnBuffer,
    721     ACPI_OBJECT_TYPE        ReturnType))
    722 
    723 ACPI_EXTERNAL_RETURN_STATUS (
    724 ACPI_STATUS
    725 AcpiGetObjectInfo (
    726     ACPI_HANDLE             Object,
    727     ACPI_DEVICE_INFO        **ReturnBuffer))
    728 
    729 ACPI_EXTERNAL_RETURN_STATUS (
    730 ACPI_STATUS
    731 AcpiInstallMethod (
    732     UINT8                   *Buffer))
    733 
    734 ACPI_EXTERNAL_RETURN_STATUS (
    735 ACPI_STATUS
    736 AcpiGetNextObject (
    737     ACPI_OBJECT_TYPE        Type,
    738     ACPI_HANDLE             Parent,
    739     ACPI_HANDLE             Child,
    740     ACPI_HANDLE             *OutHandle))
    741 
    742 ACPI_EXTERNAL_RETURN_STATUS (
    743 ACPI_STATUS
    744 AcpiGetType (
    745     ACPI_HANDLE             Object,
    746     ACPI_OBJECT_TYPE        *OutType))
    747 
    748 ACPI_EXTERNAL_RETURN_STATUS (
    749 ACPI_STATUS
    750 AcpiGetParent (
    751     ACPI_HANDLE             Object,
    752     ACPI_HANDLE             *OutHandle))
    753 
    754 
    755 /*
    756  * Handler interfaces
    757  */
    758 ACPI_EXTERNAL_RETURN_STATUS (
    759 ACPI_STATUS
    760 AcpiInstallInitializationHandler (
    761     ACPI_INIT_HANDLER       Handler,
    762     UINT32                  Function))
    763 
    764 ACPI_HW_DEPENDENT_RETURN_STATUS (
    765 ACPI_STATUS
    766 AcpiInstallSciHandler (
    767     ACPI_SCI_HANDLER        Address,
    768     void                    *Context))
    769 
    770 ACPI_HW_DEPENDENT_RETURN_STATUS (
    771 ACPI_STATUS
    772 AcpiRemoveSciHandler (
    773     ACPI_SCI_HANDLER        Address))
    774 
    775 ACPI_HW_DEPENDENT_RETURN_STATUS (
    776 ACPI_STATUS
    777 AcpiInstallGlobalEventHandler (
    778     ACPI_GBL_EVENT_HANDLER  Handler,
    779     void                    *Context))
    780 
    781 ACPI_HW_DEPENDENT_RETURN_STATUS (
    782 ACPI_STATUS
    783 AcpiInstallFixedEventHandler (
    784     UINT32                  AcpiEvent,
    785     ACPI_EVENT_HANDLER      Handler,
    786     void                    *Context))
    787 
    788 ACPI_HW_DEPENDENT_RETURN_STATUS (
    789 ACPI_STATUS
    790 AcpiRemoveFixedEventHandler (
    791     UINT32                  AcpiEvent,
    792     ACPI_EVENT_HANDLER      Handler))
    793 
    794 ACPI_HW_DEPENDENT_RETURN_STATUS (
    795 ACPI_STATUS
    796 AcpiInstallGpeHandler (
    797     ACPI_HANDLE             GpeDevice,
    798     UINT32                  GpeNumber,
    799     UINT32                  Type,
    800     ACPI_GPE_HANDLER        Address,
    801     void                    *Context))
    802 
    803 ACPI_HW_DEPENDENT_RETURN_STATUS (
    804 ACPI_STATUS
    805 AcpiInstallGpeRawHandler (
    806     ACPI_HANDLE             GpeDevice,
    807     UINT32                  GpeNumber,
    808     UINT32                  Type,
    809     ACPI_GPE_HANDLER        Address,
    810     void                    *Context))
    811 
    812 ACPI_HW_DEPENDENT_RETURN_STATUS (
    813 ACPI_STATUS
    814 AcpiRemoveGpeHandler (
    815     ACPI_HANDLE             GpeDevice,
    816     UINT32                  GpeNumber,
    817     ACPI_GPE_HANDLER        Address))
    818 
    819 ACPI_EXTERNAL_RETURN_STATUS (
    820 ACPI_STATUS
    821 AcpiInstallNotifyHandler (
    822     ACPI_HANDLE             Device,
    823     UINT32                  HandlerType,
    824     ACPI_NOTIFY_HANDLER     Handler,
    825     void                    *Context))
    826 
    827 ACPI_EXTERNAL_RETURN_STATUS (
    828 ACPI_STATUS
    829 AcpiRemoveNotifyHandler (
    830     ACPI_HANDLE             Device,
    831     UINT32                  HandlerType,
    832     ACPI_NOTIFY_HANDLER     Handler))
    833 
    834 ACPI_EXTERNAL_RETURN_STATUS (
    835 ACPI_STATUS
    836 AcpiInstallAddressSpaceHandler (
    837     ACPI_HANDLE             Device,
    838     ACPI_ADR_SPACE_TYPE     SpaceId,
    839     ACPI_ADR_SPACE_HANDLER  Handler,
    840     ACPI_ADR_SPACE_SETUP    Setup,
    841     void                    *Context))
    842 
    843 ACPI_EXTERNAL_RETURN_STATUS (
    844 ACPI_STATUS
    845 AcpiInstallAddressSpaceHandlerNo_Reg(
    846     ACPI_HANDLE             Device,
    847     ACPI_ADR_SPACE_TYPE     SpaceId,
    848     ACPI_ADR_SPACE_HANDLER  Handler,
    849     ACPI_ADR_SPACE_SETUP    Setup,
    850     void                    *Context))
    851 
    852 ACPI_EXTERNAL_RETURN_STATUS (
    853 ACPI_STATUS
    854 AcpiExecuteRegMethods (
    855     ACPI_HANDLE             Device,
    856     ACPI_ADR_SPACE_TYPE     SpaceId))
    857 
    858 ACPI_EXTERNAL_RETURN_STATUS (
    859 ACPI_STATUS
    860 AcpiRemoveAddressSpaceHandler (
    861     ACPI_HANDLE             Device,
    862     ACPI_ADR_SPACE_TYPE     SpaceId,
    863     ACPI_ADR_SPACE_HANDLER  Handler))
    864 
    865 ACPI_EXTERNAL_RETURN_STATUS (
    866 ACPI_STATUS
    867 AcpiInstallExceptionHandler (
    868     ACPI_EXCEPTION_HANDLER  Handler))
    869 
    870 ACPI_EXTERNAL_RETURN_STATUS (
    871 ACPI_STATUS
    872 AcpiInstallInterfaceHandler (
    873     ACPI_INTERFACE_HANDLER  Handler))
    874 
    875 
    876 /*
    877  * Global Lock interfaces
    878  */
    879 ACPI_HW_DEPENDENT_RETURN_STATUS (
    880 ACPI_STATUS
    881 AcpiAcquireGlobalLock (
    882     UINT16                  Timeout,
    883     UINT32                  *Handle))
    884 
    885 ACPI_HW_DEPENDENT_RETURN_STATUS (
    886 ACPI_STATUS
    887 AcpiReleaseGlobalLock (
    888     UINT32                  Handle))
    889 
    890 
    891 /*
    892  * Interfaces to AML mutex objects
    893  */
    894 ACPI_EXTERNAL_RETURN_STATUS (
    895 ACPI_STATUS
    896 AcpiAcquireMutex (
    897     ACPI_HANDLE             Handle,
    898     ACPI_STRING             Pathname,
    899     UINT16                  Timeout))
    900 
    901 ACPI_EXTERNAL_RETURN_STATUS (
    902 ACPI_STATUS
    903 AcpiReleaseMutex (
    904     ACPI_HANDLE             Handle,
    905     ACPI_STRING             Pathname))
    906 
    907 
    908 /*
    909  * Fixed Event interfaces
    910  */
    911 ACPI_HW_DEPENDENT_RETURN_STATUS (
    912 ACPI_STATUS
    913 AcpiEnableEvent (
    914     UINT32                  Event,
    915     UINT32                  Flags))
    916 
    917 ACPI_HW_DEPENDENT_RETURN_STATUS (
    918 ACPI_STATUS
    919 AcpiDisableEvent (
    920     UINT32                  Event,
    921     UINT32                  Flags))
    922 
    923 ACPI_HW_DEPENDENT_RETURN_STATUS (
    924 ACPI_STATUS
    925 AcpiClearEvent (
    926     UINT32                  Event))
    927 
    928 ACPI_HW_DEPENDENT_RETURN_STATUS (
    929 ACPI_STATUS
    930 AcpiGetEventStatus (
    931     UINT32                  Event,
    932     ACPI_EVENT_STATUS       *EventStatus))
    933 
    934 
    935 /*
    936  * General Purpose Event (GPE) Interfaces
    937  */
    938 ACPI_HW_DEPENDENT_RETURN_STATUS (
    939 ACPI_STATUS
    940 AcpiUpdateAllGpes (
    941     void))
    942 
    943 ACPI_HW_DEPENDENT_RETURN_STATUS (
    944 ACPI_STATUS
    945 AcpiEnableGpe (
    946     ACPI_HANDLE             GpeDevice,
    947     UINT32                  GpeNumber))
    948 
    949 ACPI_HW_DEPENDENT_RETURN_STATUS (
    950 ACPI_STATUS
    951 AcpiDisableGpe (
    952     ACPI_HANDLE             GpeDevice,
    953     UINT32                  GpeNumber))
    954 
    955 ACPI_HW_DEPENDENT_RETURN_STATUS (
    956 ACPI_STATUS
    957 AcpiClearGpe (
    958     ACPI_HANDLE             GpeDevice,
    959     UINT32                  GpeNumber))
    960 
    961 ACPI_HW_DEPENDENT_RETURN_STATUS (
    962 ACPI_STATUS
    963 AcpiSetGpe (
    964     ACPI_HANDLE             GpeDevice,
    965     UINT32                  GpeNumber,
    966     UINT8                   Action))
    967 
    968 ACPI_HW_DEPENDENT_RETURN_STATUS (
    969 ACPI_STATUS
    970 AcpiFinishGpe (
    971     ACPI_HANDLE             GpeDevice,
    972     UINT32                  GpeNumber))
    973 
    974 ACPI_HW_DEPENDENT_RETURN_STATUS (
    975 ACPI_STATUS
    976 AcpiMaskGpe (
    977     ACPI_HANDLE             GpeDevice,
    978     UINT32                  GpeNumber,
    979     BOOLEAN                 IsMasked))
    980 
    981 ACPI_HW_DEPENDENT_RETURN_STATUS (
    982 ACPI_STATUS
    983 AcpiMarkGpeForWake (
    984     ACPI_HANDLE             GpeDevice,
    985     UINT32                  GpeNumber))
    986 
    987 ACPI_HW_DEPENDENT_RETURN_STATUS (
    988 ACPI_STATUS
    989 AcpiSetupGpeForWake (
    990     ACPI_HANDLE             ParentDevice,
    991     ACPI_HANDLE             GpeDevice,
    992     UINT32                  GpeNumber))
    993 
    994 ACPI_HW_DEPENDENT_RETURN_STATUS (
    995 ACPI_STATUS
    996 AcpiSetGpeWakeMask (
    997     ACPI_HANDLE             GpeDevice,
    998     UINT32                  GpeNumber,
    999     UINT8                   Action))
   1000 
   1001 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1002 ACPI_STATUS
   1003 AcpiGetGpeStatus (
   1004     ACPI_HANDLE             GpeDevice,
   1005     UINT32                  GpeNumber,
   1006     ACPI_EVENT_STATUS       *EventStatus))
   1007 
   1008 ACPI_HW_DEPENDENT_RETURN_UINT32 (
   1009 UINT32
   1010 AcpiDispatchGpe (
   1011     ACPI_HANDLE             GpeDevice,
   1012     UINT32                  GpeNumber))
   1013 
   1014 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1015 ACPI_STATUS
   1016 AcpiDisableAllGpes (
   1017     void))
   1018 
   1019 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1020 ACPI_STATUS
   1021 AcpiEnableAllRuntimeGpes (
   1022     void))
   1023 
   1024 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1025 ACPI_STATUS
   1026 AcpiEnableAllWakeupGpes (
   1027     void))
   1028 
   1029 ACPI_HW_DEPENDENT_RETURN_UINT32 (
   1030     UINT32                  AcpiAnyGpeStatusSet (
   1031     void))
   1032 
   1033 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1034 ACPI_STATUS
   1035 AcpiGetGpeDevice (
   1036     UINT32                  GpeIndex,
   1037     ACPI_HANDLE             *GpeDevice))
   1038 
   1039 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1040 ACPI_STATUS
   1041 AcpiInstallGpeBlock (
   1042     ACPI_HANDLE             GpeDevice,
   1043     ACPI_GENERIC_ADDRESS    *GpeBlockAddress,
   1044     UINT32                  RegisterCount,
   1045     UINT32                  InterruptNumber))
   1046 
   1047 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1048 ACPI_STATUS
   1049 AcpiRemoveGpeBlock (
   1050     ACPI_HANDLE             GpeDevice))
   1051 
   1052 
   1053 /*
   1054  * Resource interfaces
   1055  */
   1056 typedef
   1057 ACPI_STATUS (*ACPI_WALK_RESOURCE_CALLBACK) (
   1058     ACPI_RESOURCE           *Resource,
   1059     void                    *Context);
   1060 
   1061 ACPI_EXTERNAL_RETURN_STATUS (
   1062 ACPI_STATUS
   1063 AcpiGetVendorResource (
   1064     ACPI_HANDLE             Device,
   1065     char                    *Name,
   1066     ACPI_VENDOR_UUID        *Uuid,
   1067     ACPI_BUFFER             *RetBuffer))
   1068 
   1069 ACPI_EXTERNAL_RETURN_STATUS (
   1070 ACPI_STATUS
   1071 AcpiGetCurrentResources (
   1072     ACPI_HANDLE             Device,
   1073     ACPI_BUFFER             *RetBuffer))
   1074 
   1075 ACPI_EXTERNAL_RETURN_STATUS (
   1076 ACPI_STATUS
   1077 AcpiGetPossibleResources (
   1078     ACPI_HANDLE             Device,
   1079     ACPI_BUFFER             *RetBuffer))
   1080 
   1081 ACPI_EXTERNAL_RETURN_STATUS (
   1082 ACPI_STATUS
   1083 AcpiGetEventResources (
   1084     ACPI_HANDLE             DeviceHandle,
   1085     ACPI_BUFFER             *RetBuffer))
   1086 
   1087 ACPI_EXTERNAL_RETURN_STATUS (
   1088 ACPI_STATUS
   1089 AcpiWalkResourceBuffer (
   1090     ACPI_BUFFER                 *Buffer,
   1091     ACPI_WALK_RESOURCE_CALLBACK UserFunction,
   1092     void                        *Context))
   1093 
   1094 ACPI_EXTERNAL_RETURN_STATUS (
   1095 ACPI_STATUS
   1096 AcpiWalkResources (
   1097     ACPI_HANDLE                 Device,
   1098     const char                  *Name,
   1099     ACPI_WALK_RESOURCE_CALLBACK UserFunction,
   1100     void                        *Context))
   1101 
   1102 ACPI_EXTERNAL_RETURN_STATUS (
   1103 ACPI_STATUS
   1104 AcpiSetCurrentResources (
   1105     ACPI_HANDLE             Device,
   1106     ACPI_BUFFER             *InBuffer))
   1107 
   1108 ACPI_EXTERNAL_RETURN_STATUS (
   1109 ACPI_STATUS
   1110 AcpiGetIrqRoutingTable (
   1111     ACPI_HANDLE             Device,
   1112     ACPI_BUFFER             *RetBuffer))
   1113 
   1114 ACPI_EXTERNAL_RETURN_STATUS (
   1115 ACPI_STATUS
   1116 AcpiResourceToAddress64 (
   1117     ACPI_RESOURCE           *Resource,
   1118     ACPI_RESOURCE_ADDRESS64 *Out))
   1119 
   1120 ACPI_EXTERNAL_RETURN_STATUS (
   1121 ACPI_STATUS
   1122 AcpiBufferToResource (
   1123     UINT8                   *AmlBuffer,
   1124     UINT16                  AmlBufferLength,
   1125     ACPI_RESOURCE           **ResourcePtr))
   1126 
   1127 
   1128 /*
   1129  * Hardware (ACPI device) interfaces
   1130  */
   1131 ACPI_EXTERNAL_RETURN_STATUS (
   1132 ACPI_STATUS
   1133 AcpiReset (
   1134     void))
   1135 
   1136 ACPI_EXTERNAL_RETURN_STATUS (
   1137 ACPI_STATUS
   1138 AcpiRead (
   1139     UINT64                  *Value,
   1140     ACPI_GENERIC_ADDRESS    *Reg))
   1141 
   1142 ACPI_EXTERNAL_RETURN_STATUS (
   1143 ACPI_STATUS
   1144 AcpiWrite (
   1145     UINT64                  Value,
   1146     ACPI_GENERIC_ADDRESS    *Reg))
   1147 
   1148 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1149 ACPI_STATUS
   1150 AcpiReadBitRegister (
   1151     UINT32                  RegisterId,
   1152     UINT32                  *ReturnValue))
   1153 
   1154 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1155 ACPI_STATUS
   1156 AcpiWriteBitRegister (
   1157     UINT32                  RegisterId,
   1158     UINT32                  Value))
   1159 
   1160 
   1161 /*
   1162  * Sleep/Wake interfaces
   1163  */
   1164 ACPI_EXTERNAL_RETURN_STATUS (
   1165 ACPI_STATUS
   1166 AcpiGetSleepTypeData (
   1167     UINT8                   SleepState,
   1168     UINT8                   *Slp_TypA,
   1169     UINT8                   *Slp_TypB))
   1170 
   1171 ACPI_EXTERNAL_RETURN_STATUS (
   1172 ACPI_STATUS
   1173 AcpiEnterSleepStatePrep (
   1174     UINT8                   SleepState))
   1175 
   1176 ACPI_EXTERNAL_RETURN_STATUS (
   1177 ACPI_STATUS
   1178 AcpiEnterSleepState (
   1179     UINT8                   SleepState))
   1180 
   1181 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1182 ACPI_STATUS
   1183 AcpiEnterSleepStateS4bios (
   1184     void))
   1185 
   1186 ACPI_EXTERNAL_RETURN_STATUS (
   1187 ACPI_STATUS
   1188 AcpiLeaveSleepStatePrep (
   1189     UINT8                   SleepState))
   1190 
   1191 ACPI_EXTERNAL_RETURN_STATUS (
   1192 ACPI_STATUS
   1193 AcpiLeaveSleepState (
   1194     UINT8                   SleepState))
   1195 
   1196 ACPI_EXTERNAL_RETURN_STATUS (
   1197 ACPI_STATUS
   1198 AcpiSetFirmwareWakingVector (
   1199     ACPI_PHYSICAL_ADDRESS   PhysicalAddress,
   1200     ACPI_PHYSICAL_ADDRESS   PhysicalAddress64))
   1201 
   1202 
   1203 /*
   1204  * ACPI Timer interfaces
   1205  */
   1206 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1207 ACPI_STATUS
   1208 AcpiGetTimerResolution (
   1209     UINT32                  *Resolution))
   1210 
   1211 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1212 ACPI_STATUS
   1213 AcpiGetTimer (
   1214     UINT32                  *Ticks))
   1215 
   1216 ACPI_HW_DEPENDENT_RETURN_STATUS (
   1217 ACPI_STATUS
   1218 AcpiGetTimerDuration (
   1219     UINT32                  StartTicks,
   1220     UINT32                  EndTicks,
   1221     UINT32                  *TimeElapsed))
   1222 
   1223 
   1224 /*
   1225  * Error/Warning output
   1226  */
   1227 ACPI_MSG_DEPENDENT_RETURN_VOID (
   1228 ACPI_PRINTF_LIKE(3)
   1229 void ACPI_INTERNAL_VAR_XFACE
   1230 AcpiError (
   1231     const char              *ModuleName,
   1232     UINT32                  LineNumber,
   1233     const char              *Format,
   1234     ...))
   1235 
   1236 ACPI_MSG_DEPENDENT_RETURN_VOID (
   1237 ACPI_PRINTF_LIKE(4)
   1238 void  ACPI_INTERNAL_VAR_XFACE
   1239 AcpiException (
   1240     const char              *ModuleName,
   1241     UINT32                  LineNumber,
   1242     ACPI_STATUS             Status,
   1243     const char              *Format,
   1244     ...))
   1245 
   1246 ACPI_MSG_DEPENDENT_RETURN_VOID (
   1247 ACPI_PRINTF_LIKE(3)
   1248 void ACPI_INTERNAL_VAR_XFACE
   1249 AcpiWarning (
   1250     const char              *ModuleName,
   1251     UINT32                  LineNumber,
   1252     const char              *Format,
   1253     ...))
   1254 
   1255 ACPI_MSG_DEPENDENT_RETURN_VOID (
   1256 ACPI_PRINTF_LIKE(1)
   1257 void ACPI_INTERNAL_VAR_XFACE
   1258 AcpiInfo (
   1259     const char              *Format,
   1260     ...))
   1261 
   1262 ACPI_MSG_DEPENDENT_RETURN_VOID (
   1263 ACPI_PRINTF_LIKE(3)
   1264 void ACPI_INTERNAL_VAR_XFACE
   1265 AcpiBiosError (
   1266     const char              *ModuleName,
   1267     UINT32                  LineNumber,
   1268     const char              *Format,
   1269     ...))
   1270 
   1271 ACPI_MSG_DEPENDENT_RETURN_VOID (
   1272 ACPI_PRINTF_LIKE(4)
   1273 void  ACPI_INTERNAL_VAR_XFACE
   1274 AcpiBiosException (
   1275     const char              *ModuleName,
   1276     UINT32                  LineNumber,
   1277     ACPI_STATUS             Status,
   1278     const char              *Format,
   1279     ...))
   1280 
   1281 ACPI_MSG_DEPENDENT_RETURN_VOID (
   1282 ACPI_PRINTF_LIKE(3)
   1283 void ACPI_INTERNAL_VAR_XFACE
   1284 AcpiBiosWarning (
   1285     const char              *ModuleName,
   1286     UINT32                  LineNumber,
   1287     const char              *Format,
   1288     ...))
   1289 
   1290 
   1291 /*
   1292  * Debug output
   1293  */
   1294 ACPI_DBG_DEPENDENT_RETURN_VOID (
   1295 ACPI_PRINTF_LIKE(6)
   1296 void ACPI_INTERNAL_VAR_XFACE
   1297 AcpiDebugPrint (
   1298     UINT32                  RequestedDebugLevel,
   1299     UINT32                  LineNumber,
   1300     const char              *FunctionName,
   1301     const char              *ModuleName,
   1302     UINT32                  ComponentId,
   1303     const char              *Format,
   1304     ...))
   1305 
   1306 ACPI_DBG_DEPENDENT_RETURN_VOID (
   1307 ACPI_PRINTF_LIKE(6)
   1308 void ACPI_INTERNAL_VAR_XFACE
   1309 AcpiDebugPrintRaw (
   1310     UINT32                  RequestedDebugLevel,
   1311     UINT32                  LineNumber,
   1312     const char              *FunctionName,
   1313     const char              *ModuleName,
   1314     UINT32                  ComponentId,
   1315     const char              *Format,
   1316     ...))
   1317 
   1318 ACPI_DBG_DEPENDENT_RETURN_VOID (
   1319 void
   1320 AcpiTracePoint (
   1321     ACPI_TRACE_EVENT_TYPE   Type,
   1322     BOOLEAN                 Begin,
   1323     UINT8                   *Aml,
   1324     char                    *Pathname))
   1325 
   1326 ACPI_STATUS
   1327 AcpiInitializeDebugger (
   1328     void);
   1329 
   1330 void
   1331 AcpiTerminateDebugger (
   1332     void);
   1333 
   1334 void
   1335 AcpiRunDebugger (
   1336     char                    *BatchBuffer);
   1337 
   1338 void
   1339 AcpiSetDebuggerThreadId (
   1340     ACPI_THREAD_ID          ThreadId);
   1341 
   1342 #endif /* __ACXFACE_H__ */
   1343