/******************************************************************************

 *

 * Name: acpixf.h - External interfaces to the ACPI subsystem

 *

 *****************************************************************************/

/*

 * Copyright (C) 2000 - 2018, Intel Corp.

 * All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions

 * are met:

 * 1. Redistributions of source code must retain the above copyright

 *    notice, this list of conditions, and the following disclaimer,

 *    without modification.

 * 2. Redistributions in binary form must reproduce at minimum a disclaimer

 *    substantially similar to the "NO WARRANTY" disclaimer below

 *    ("Disclaimer") and any redistribution must be conditioned upon

 *    including a substantially similar Disclaimer requirement for further

 *    binary redistribution.

 * 3. Neither the names of the above-listed copyright holders nor the names

 *    of any contributors may be used to endorse or promote products derived

 *    from this software without specific prior written permission.

 *

 * Alternatively, this software may be distributed under the terms of the

 * GNU General Public License ("GPL") version 2 as published by the Free

 * Software Foundation.

 *

 * NO WARRANTY

 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR

 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS

 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,

 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING

 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

 * POSSIBILITY OF SUCH DAMAGES.

 */

#ifndef __ACXFACE_H__

#define __ACXFACE_H__

/* Current ACPICA subsystem version in YYYYMMDD format */

#define ACPI_CA_VERSION                 0x20180629

#include "acconfig.h"

#include "actypes.h"

#include "actbl.h"

#include "acbuffer.h"

/*****************************************************************************

 *

 * Macros used for ACPICA globals and configuration

 *

 ****************************************************************************/

/*

 * Ensure that global variables are defined and initialized only once.

 *

 * The use of these macros allows for a single list of globals (here)

 * in order to simplify maintenance of the code.

 */

#ifdef DEFINE_ACPI_GLOBALS

#define ACPI_GLOBAL(type,name) \

    extern type name; \

    type name

#define ACPI_INIT_GLOBAL(type,name,value) \

    type name=value

#else

#ifndef ACPI_GLOBAL

#define ACPI_GLOBAL(type,name) \

    extern type name

#endif

#ifndef ACPI_INIT_GLOBAL

#define ACPI_INIT_GLOBAL(type,name,value) \

    extern type name

#endif

#endif

/*

 * These macros configure the various ACPICA interfaces. They are

 * useful for generating stub inline functions for features that are

 * configured out of the current kernel or ACPICA application.

 */

#ifndef ACPI_EXTERNAL_RETURN_STATUS

#define ACPI_EXTERNAL_RETURN_STATUS(Prototype) \

    Prototype;

#endif

#ifndef ACPI_EXTERNAL_RETURN_OK

#define ACPI_EXTERNAL_RETURN_OK(Prototype) \

    Prototype;

#endif

#ifndef ACPI_EXTERNAL_RETURN_VOID

#define ACPI_EXTERNAL_RETURN_VOID(Prototype) \

    Prototype;

#endif

#ifndef ACPI_EXTERNAL_RETURN_UINT32

#define ACPI_EXTERNAL_RETURN_UINT32(Prototype) \

    Prototype;

#endif

#ifndef ACPI_EXTERNAL_RETURN_PTR

#define ACPI_EXTERNAL_RETURN_PTR(Prototype) \

    Prototype;

#endif

/*****************************************************************************

 *

 * Public globals and runtime configuration options

 *

 ****************************************************************************/

/*

 * Enable "slack mode" of the AML interpreter?  Default is FALSE, and the

 * interpreter strictly follows the ACPI specification. Setting to TRUE

 * allows the interpreter to ignore certain errors and/or bad AML constructs.

 *

 * Currently, these features are enabled by this flag:

 *

 * 1) Allow "implicit return" of last value in a control method

 * 2) Allow access beyond the end of an operation region

 * 3) Allow access to uninitialized locals/args (auto-init to integer 0)

 * 4) Allow ANY object type to be a source operand for the Store() operator

 * 5) Allow unresolved references (invalid target name) in package objects

 * 6) Enable warning messages for behavior that is not ACPI spec compliant

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_EnableInterpreterSlack, FALSE);

/*

 * Automatically serialize all methods that create named objects? Default

 * is TRUE, meaning that all NonSerialized methods are scanned once at

 * table load time to determine those that create named objects. Methods

 * that create named objects are marked Serialized in order to prevent

 * possible run-time problems if they are entered by more than one thread.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_AutoSerializeMethods, TRUE);

/*

 * Create the predefined _OSI method in the namespace? Default is TRUE

 * because ACPICA is fully compatible with other ACPI implementations.

 * Changing this will revert ACPICA (and machine ASL) to pre-OSI behavior.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_CreateOsiMethod, TRUE);

/*

 * Optionally use default values for the ACPI register widths. Set this to

 * TRUE to use the defaults, if an FADT contains incorrect widths/lengths.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_UseDefaultRegisterWidths, TRUE);

/*

 * Whether or not to validate (map) an entire table to verify

 * checksum/duplication in early stage before install. Set this to TRUE to

 * allow early table validation before install it to the table manager.

 * Note that enabling this option causes errors to happen in some OSPMs

 * during early initialization stages. Default behavior is to allow such

 * validation.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_EnableTableValidation, TRUE);

/*

 * Optionally enable output from the AML Debug Object.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_EnableAmlDebugObject, FALSE);

/*

 * Optionally copy the entire DSDT to local memory (instead of simply

 * mapping it.) There are some BIOSs that corrupt or replace the original

 * DSDT, creating the need for this option. Default is FALSE, do not copy

 * the DSDT.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_CopyDsdtLocally, FALSE);

/*

 * Optionally ignore an XSDT if present and use the RSDT instead.

 * Although the ACPI specification requires that an XSDT be used instead

 * of the RSDT, the XSDT has been found to be corrupt or ill-formed on

 * some machines. Default behavior is to use the XSDT if present.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_DoNotUseXsdt, FALSE);

/*

 * Optionally support group module level code.

 * NOTE, this is essentially obsolete and will be removed soon

 * (01/2018).

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_GroupModuleLevelCode, FALSE);

/*

 * Optionally support module level code by parsing an entire table as

 * a method as it is loaded. Default is TRUE.

 * NOTE, this is essentially obsolete and will be removed soon

 * (01/2018).

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_ExecuteTablesAsMethods, TRUE);

/*

 * Optionally use 32-bit FADT addresses if and when there is a conflict

 * (address mismatch) between the 32-bit and 64-bit versions of the

 * address. Although ACPICA adheres to the ACPI specification which

 * requires the use of the corresponding 64-bit address if it is non-zero,

 * some machines have been found to have a corrupted non-zero 64-bit

 * address. Default is FALSE, do not favor the 32-bit addresses.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_Use32BitFadtAddresses, FALSE);

/*

 * Optionally use 32-bit FACS table addresses.

 * It is reported that some platforms fail to resume from system suspending

 * if 64-bit FACS table address is selected:

 * https://bugzilla.kernel.org/show_bug.cgi?id=74021

 * Default is TRUE, favor the 32-bit addresses.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_Use32BitFacsAddresses, TRUE);

/*

 * Optionally truncate I/O addresses to 16 bits. Provides compatibility

 * with other ACPI implementations. NOTE: During ACPICA initialization,

 * this value is set to TRUE if any Windows OSI strings have been

 * requested by the BIOS.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_TruncateIoAddresses, FALSE);

/*

 * Disable runtime checking and repair of values returned by control methods.

 * Use only if the repair is causing a problem on a particular machine.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_DisableAutoRepair, FALSE);

/*

 * Optionally do not install any SSDTs from the RSDT/XSDT during initialization.

 * This can be useful for debugging ACPI problems on some machines.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_DisableSsdtTableInstall, FALSE);

/*

 * Optionally enable runtime namespace override.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_RuntimeNamespaceOverride, TRUE);

/*

 * We keep track of the latest version of Windows that has been requested by

 * the BIOS. ACPI 5.0.

 */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_OsiData, 0);

/*

 * ACPI 5.0 introduces the concept of a "reduced hardware platform", meaning

 * that the ACPI hardware is no longer required. A flag in the FADT indicates

 * a reduced HW machine, and that flag is duplicated here for convenience.

 */

ACPI_INIT_GLOBAL (BOOLEAN,          AcpiGbl_ReducedHardware, FALSE);

/*

 * Maximum timeout for While() loop iterations before forced method abort.

 * This mechanism is intended to prevent infinite loops during interpreter

 * execution within a host kernel.

 */

ACPI_INIT_GLOBAL (UINT32,           AcpiGbl_MaxLoopIterations, ACPI_MAX_LOOP_TIMEOUT);

/*

 * Optionally ignore AE_NOT_FOUND errors from named reference package elements

 * during DSDT/SSDT table loading. This reduces error "noise" in platforms

 * whose firmware is carrying around a bunch of unused package objects that

 * refer to non-existent named objects. However, If the AML actually tries to

 * use such a package, the unresolved element(s) will be replaced with NULL

 * elements.

 */

ACPI_INIT_GLOBAL (BOOLEAN,          AcpiGbl_IgnorePackageResolutionErrors, FALSE);

/*

 * This mechanism is used to trace a specified AML method. The method is

 * traced each time it is executed.

 */

ACPI_INIT_GLOBAL (UINT32,           AcpiGbl_TraceFlags, 0);

ACPI_INIT_GLOBAL (const char *,     AcpiGbl_TraceMethodName, NULL);

ACPI_INIT_GLOBAL (UINT32,           AcpiGbl_TraceDbgLevel, ACPI_TRACE_LEVEL_DEFAULT);

ACPI_INIT_GLOBAL (UINT32,           AcpiGbl_TraceDbgLayer, ACPI_TRACE_LAYER_DEFAULT);

/*

 * Runtime configuration of debug output control masks. We want the debug

 * switches statically initialized so they are already set when the debugger

 * is entered.

 */

#ifdef ACPI_DEBUG_OUTPUT

ACPI_INIT_GLOBAL (UINT32,           AcpiDbgLevel, ACPI_DEBUG_DEFAULT);

#else

ACPI_INIT_GLOBAL (UINT32,           AcpiDbgLevel, ACPI_NORMAL_DEFAULT);

#endif

ACPI_INIT_GLOBAL (UINT32,           AcpiDbgLayer, ACPI_COMPONENT_DEFAULT);

/* Optionally enable timer output with Debug Object output */

ACPI_INIT_GLOBAL (UINT8,            AcpiGbl_DisplayDebugTimer, FALSE);

/*

 * Debugger command handshake globals. Host OSes need to access these

 * variables to implement their own command handshake mechanism.

 */

#ifdef ACPI_DEBUGGER

ACPI_INIT_GLOBAL (BOOLEAN,          AcpiGbl_MethodExecuting, FALSE);

ACPI_GLOBAL (char,                  AcpiGbl_DbLineBuf[ACPI_DB_LINE_BUFFER_SIZE]);

#endif

/*

 * Other miscellaneous globals

 */

ACPI_GLOBAL (ACPI_TABLE_FADT,       AcpiGbl_FADT);

ACPI_GLOBAL (UINT32,                AcpiCurrentGpeCount);

ACPI_GLOBAL (BOOLEAN,               AcpiGbl_SystemAwakeAndRunning);

/*****************************************************************************

 *

 * ACPICA public interface configuration.

 *

 * Interfaces that are configured out of the ACPICA build are replaced

 * by inlined stubs by default.

 *

 ****************************************************************************/

/*

 * Hardware-reduced prototypes (default: Not hardware reduced).

 *

 * All ACPICA hardware-related interfaces that use these macros will be

 * configured out of the ACPICA build if the ACPI_REDUCED_HARDWARE flag

 * is set to TRUE.

 *

 * Note: This static build option for reduced hardware is intended to

 * reduce ACPICA code size if desired or necessary. However, even if this

 * option is not specified, the runtime behavior of ACPICA is dependent

 * on the actual FADT reduced hardware flag (HW_REDUCED_ACPI). If set,

 * the flag will enable similar behavior -- ACPICA will not attempt

 * to access any ACPI-relate hardware (SCI, GPEs, Fixed Events, etc.)

 */

#if (!ACPI_REDUCED_HARDWARE)

#define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \

    ACPI_EXTERNAL_RETURN_STATUS(Prototype)

#define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \

    ACPI_EXTERNAL_RETURN_OK(Prototype)

#define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \

    ACPI_EXTERNAL_RETURN_VOID(Prototype)

#else

#define ACPI_HW_DEPENDENT_RETURN_STATUS(Prototype) \

    static ACPI_INLINE Prototype {return(AE_NOT_CONFIGURED);}

#define ACPI_HW_DEPENDENT_RETURN_OK(Prototype) \

    static ACPI_INLINE Prototype {return(AE_OK);}

#define ACPI_HW_DEPENDENT_RETURN_VOID(Prototype) \

    static ACPI_INLINE Prototype {return;}

#endif /* !ACPI_REDUCED_HARDWARE */

/*

 * Error message prototypes (default: error messages enabled).

 *

 * All interfaces related to error and warning messages

 * will be configured out of the ACPICA build if the

 * ACPI_NO_ERROR_MESSAGE flag is defined.

 */

#ifndef ACPI_NO_ERROR_MESSAGES

#define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \

    Prototype;

#else

#define ACPI_MSG_DEPENDENT_RETURN_VOID(Prototype) \

    static ACPI_INLINE Prototype {return;}

#endif /* ACPI_NO_ERROR_MESSAGES */

/*

 * Debugging output prototypes (default: no debug output).

 *

 * All interfaces related to debug output messages

 * will be configured out of the ACPICA build unless the

 * ACPI_DEBUG_OUTPUT flag is defined.

 */

#ifdef ACPI_DEBUG_OUTPUT

#define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \

    Prototype;

#else

#define ACPI_DBG_DEPENDENT_RETURN_VOID(Prototype) \

    static ACPI_INLINE Prototype {return;}

#endif /* ACPI_DEBUG_OUTPUT */

/*

 * Application prototypes

 *

 * All interfaces used by application will be configured

 * out of the ACPICA build unless the ACPI_APPLICATION

 * flag is defined.

 */

#ifdef ACPI_APPLICATION

#define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \

    Prototype;

#else

#define ACPI_APP_DEPENDENT_RETURN_VOID(Prototype) \

    static ACPI_INLINE Prototype {return;}

#endif /* ACPI_APPLICATION */

/*

 * Debugger prototypes

 *

 * All interfaces used by debugger will be configured

 * out of the ACPICA build unless the ACPI_DEBUGGER

 * flag is defined.

 */

#ifdef ACPI_DEBUGGER

#define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \

    ACPI_EXTERNAL_RETURN_OK(Prototype)

#define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \

    ACPI_EXTERNAL_RETURN_VOID(Prototype)

#else

#define ACPI_DBR_DEPENDENT_RETURN_OK(Prototype) \

    static ACPI_INLINE Prototype {return(AE_OK);}

#define ACPI_DBR_DEPENDENT_RETURN_VOID(Prototype) \

    static ACPI_INLINE Prototype {return;}

#endif /* ACPI_DEBUGGER */

/*****************************************************************************

 *

 * ACPICA public interface prototypes

 *

 ****************************************************************************/

/*

 * Initialization

 */

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS ACPI_INIT_FUNCTION

AcpiInitializeTables (

    ACPI_TABLE_DESC         *InitialStorage,

    UINT32                  InitialTableCount,

    BOOLEAN                 AllowResize))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS ACPI_INIT_FUNCTION

AcpiInitializeSubsystem (

    void))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS ACPI_INIT_FUNCTION

AcpiEnableSubsystem (

    UINT32                  Flags))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS ACPI_INIT_FUNCTION

AcpiInitializeObjects (

    UINT32                  Flags))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS ACPI_INIT_FUNCTION

AcpiTerminate (

    void))

/*

 * Miscellaneous global interfaces

 */

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiEnable (

    void))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiDisable (

    void))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiSubsystemStatus (

    void))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetSystemInfo (

    ACPI_BUFFER             *RetBuffer))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetStatistics (

    ACPI_STATISTICS         *Stats))

ACPI_EXTERNAL_RETURN_PTR (

const char *

AcpiFormatException (

    ACPI_STATUS             Exception))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiPurgeCachedObjects (

    void))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiInstallInterface (

    ACPI_STRING             InterfaceName))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiRemoveInterface (

    ACPI_STRING             InterfaceName))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiUpdateInterfaces (

    UINT8                   Action))

ACPI_EXTERNAL_RETURN_UINT32 (

UINT32

AcpiCheckAddressRange (

    ACPI_ADR_SPACE_TYPE     SpaceId,

    ACPI_PHYSICAL_ADDRESS   Address,

    ACPI_SIZE               Length,

    BOOLEAN                 Warn))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiDecodePldBuffer (

    UINT8                   *InBuffer,

    ACPI_SIZE               Length,

    ACPI_PLD_INFO           **ReturnBuffer))

/*

 * ACPI table load/unload interfaces

 */

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS ACPI_INIT_FUNCTION

AcpiInstallTable (

    ACPI_PHYSICAL_ADDRESS   Address,

    BOOLEAN                 Physical))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiLoadTable (

    ACPI_TABLE_HEADER       *Table))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiUnloadParentTable (

    ACPI_HANDLE             Object))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS ACPI_INIT_FUNCTION

AcpiLoadTables (

    void))

/*

 * ACPI table manipulation interfaces

 */

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS ACPI_INIT_FUNCTION

AcpiReallocateRootTable (

    void))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS ACPI_INIT_FUNCTION

AcpiFindRootPointer (

    ACPI_PHYSICAL_ADDRESS   *RsdpAddress))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetTableHeader (

    ACPI_STRING             Signature,

    UINT32                  Instance,

    ACPI_TABLE_HEADER       *OutTableHeader))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetTable (

    ACPI_STRING             Signature,

    UINT32                  Instance,

    ACPI_TABLE_HEADER       **OutTable))

ACPI_EXTERNAL_RETURN_VOID (

void

AcpiPutTable (

    ACPI_TABLE_HEADER       *Table))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetTableByIndex (

    UINT32                  TableIndex,

    ACPI_TABLE_HEADER       **OutTable))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiInstallTableHandler (

    ACPI_TABLE_HANDLER      Handler,

    void                    *Context))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiRemoveTableHandler (

    ACPI_TABLE_HANDLER      Handler))

/*

 * Namespace and name interfaces

 */

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiWalkNamespace (

    ACPI_OBJECT_TYPE        Type,

    ACPI_HANDLE             StartObject,

    UINT32                  MaxDepth,

    ACPI_WALK_CALLBACK      DescendingCallback,

    ACPI_WALK_CALLBACK      AscendingCallback,

    void                    *Context,

    void                    **ReturnValue))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetDevices (

    char                    *HID,

    ACPI_WALK_CALLBACK      UserFunction,

    void                    *Context,

    void                    **ReturnValue))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetName (

    ACPI_HANDLE             Object,

    UINT32                  NameType,

    ACPI_BUFFER             *RetPathPtr))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetHandle (

    ACPI_HANDLE             Parent,

    ACPI_STRING             Pathname,

    ACPI_HANDLE             *RetHandle))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiAttachData (

    ACPI_HANDLE             Object,

    ACPI_OBJECT_HANDLER     Handler,

    void                    *Data))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiDetachData (

    ACPI_HANDLE             Object,

    ACPI_OBJECT_HANDLER     Handler))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetData (

    ACPI_HANDLE             Object,

    ACPI_OBJECT_HANDLER     Handler,

    void                    **Data))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiDebugTrace (

    const char              *Name,

    UINT32                  DebugLevel,

    UINT32                  DebugLayer,

    UINT32                  Flags))

/*

 * Object manipulation and enumeration

 */

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiEvaluateObject (

    ACPI_HANDLE             Object,

    ACPI_STRING             Pathname,

    ACPI_OBJECT_LIST        *ParameterObjects,

    ACPI_BUFFER             *ReturnObjectBuffer))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiEvaluateObjectTyped (

    ACPI_HANDLE             Object,

    ACPI_STRING             Pathname,

    ACPI_OBJECT_LIST        *ExternalParams,

    ACPI_BUFFER             *ReturnBuffer,

    ACPI_OBJECT_TYPE        ReturnType))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetObjectInfo (

    ACPI_HANDLE             Object,

    ACPI_DEVICE_INFO        **ReturnBuffer))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiInstallMethod (

    UINT8                   *Buffer))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetNextObject (

    ACPI_OBJECT_TYPE        Type,

    ACPI_HANDLE             Parent,

    ACPI_HANDLE             Child,

    ACPI_HANDLE             *OutHandle))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetType (

    ACPI_HANDLE             Object,

    ACPI_OBJECT_TYPE        *OutType))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiGetParent (

    ACPI_HANDLE             Object,

    ACPI_HANDLE             *OutHandle))

/*

 * Handler interfaces

 */

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiInstallInitializationHandler (

    ACPI_INIT_HANDLER       Handler,

    UINT32                  Function))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiInstallSciHandler (

    ACPI_SCI_HANDLER        Address,

    void                    *Context))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiRemoveSciHandler (

    ACPI_SCI_HANDLER        Address))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiInstallGlobalEventHandler (

    ACPI_GBL_EVENT_HANDLER  Handler,

    void                    *Context))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiInstallFixedEventHandler (

    UINT32                  AcpiEvent,

    ACPI_EVENT_HANDLER      Handler,

    void                    *Context))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiRemoveFixedEventHandler (

    UINT32                  AcpiEvent,

    ACPI_EVENT_HANDLER      Handler))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiInstallGpeHandler (

    ACPI_HANDLE             GpeDevice,

    UINT32                  GpeNumber,

    UINT32                  Type,

    ACPI_GPE_HANDLER        Address,

    void                    *Context))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiInstallGpeRawHandler (

    ACPI_HANDLE             GpeDevice,

    UINT32                  GpeNumber,

    UINT32                  Type,

    ACPI_GPE_HANDLER        Address,

    void                    *Context))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiRemoveGpeHandler (

    ACPI_HANDLE             GpeDevice,

    UINT32                  GpeNumber,

    ACPI_GPE_HANDLER        Address))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiInstallNotifyHandler (

    ACPI_HANDLE             Device,

    UINT32                  HandlerType,

    ACPI_NOTIFY_HANDLER     Handler,

    void                    *Context))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiRemoveNotifyHandler (

    ACPI_HANDLE             Device,

    UINT32                  HandlerType,

    ACPI_NOTIFY_HANDLER     Handler))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiInstallAddressSpaceHandler (

    ACPI_HANDLE             Device,

    ACPI_ADR_SPACE_TYPE     SpaceId,

    ACPI_ADR_SPACE_HANDLER  Handler,

    ACPI_ADR_SPACE_SETUP    Setup,

    void                    *Context))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiRemoveAddressSpaceHandler (

    ACPI_HANDLE             Device,

    ACPI_ADR_SPACE_TYPE     SpaceId,

    ACPI_ADR_SPACE_HANDLER  Handler))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiInstallExceptionHandler (

    ACPI_EXCEPTION_HANDLER  Handler))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiInstallInterfaceHandler (

    ACPI_INTERFACE_HANDLER  Handler))

/*

 * Global Lock interfaces

 */

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiAcquireGlobalLock (

    UINT16                  Timeout,

    UINT32                  *Handle))

ACPI_HW_DEPENDENT_RETURN_STATUS (

ACPI_STATUS

AcpiReleaseGlobalLock (

    UINT32                  Handle))

/*

 * Interfaces to AML mutex objects

 */

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS

AcpiAcquireMutex (

    ACPI_HANDLE             Handle,

    ACPI_STRING             Pathname,

    UINT16                  Timeout))

ACPI_EXTERNAL_RETURN_STATUS (

ACPI_STATUS