mirror of
https://github.com/acpica/acpica/
synced 2025-02-24 01:14:46 +03:00
Control method lookup and execution
date 99.06.01.18.11.00; author rmoore1; state Exp;
This commit is contained in:
aystarik
parent
4fa3caec7b
commit
990846a82c
@ -1,586 +1,489 @@
|
||||
/*******************************************************************************
|
||||
|
||||
/******************************************************************************
|
||||
*
|
||||
* Module Name: nsexec - ACPI control method lookup and execution
|
||||
*
|
||||
* Module Name: nseval - Object evaluation interfaces -- includes control
|
||||
* method lookup and execution.
|
||||
* $Revision: 1.129 $
|
||||
*
|
||||
******************************************************************************/
|
||||
*****************************************************************************/
|
||||
|
||||
/******************************************************************************
|
||||
*
|
||||
* 1. Copyright Notice
|
||||
*
|
||||
* Some or all of this work - Copyright (c) 1999 - 2004, Intel Corp.
|
||||
* All rights reserved.
|
||||
* Some or all of this work - Copyright (c) 1999, Intel Corp. All rights
|
||||
* reserved.
|
||||
*
|
||||
* 2. License
|
||||
*
|
||||
* 2.1. Intel grants, free of charge, to any person ("Licensee") obtaining a
|
||||
* copy of the source code appearing in this file ("Covered Code") a license
|
||||
* under Intel's copyrights in the base code distributed originally by Intel
|
||||
* ("Original Intel Code") to copy, make derivatives, distribute, use and
|
||||
* display any portion of the Covered Code in any form; and
|
||||
*
|
||||
* 2.1. This is your license from Intel Corp. under its intellectual property
|
||||
* rights. You may have additional license terms from the party that provided
|
||||
* you this software, covering your right to use that party's intellectual
|
||||
* property rights.
|
||||
* 2.2. Intel grants Licensee a non-exclusive and non-transferable patent
|
||||
* license (without the right to sublicense), under only those claims of Intel
|
||||
* patents that are infringed by the Original Intel Code, to make, use, sell,
|
||||
* offer to sell, and import the Covered Code and derivative works thereof
|
||||
* solely to the minimum extent necessary to exercise the above copyright
|
||||
* license, and in no event shall the patent license extend to any additions to
|
||||
* or modifications of the Original Intel Code. No other license or right is
|
||||
* granted directly or by implication, estoppel or otherwise;
|
||||
*
|
||||
* 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
|
||||
* copy of the source code appearing in this file ("Covered Code") an
|
||||
* irrevocable, perpetual, worldwide license under Intel's copyrights in the
|
||||
* base code distributed originally by Intel ("Original Intel Code") to copy,
|
||||
* make derivatives, distribute, use and display any portion of the Covered
|
||||
* Code in any form, with the right to sublicense such rights; and
|
||||
*
|
||||
* 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
|
||||
* license (with the right to sublicense), under only those claims of Intel
|
||||
* patents that are infringed by the Original Intel Code, to make, use, sell,
|
||||
* offer to sell, and import the Covered Code and derivative works thereof
|
||||
* solely to the minimum extent necessary to exercise the above copyright
|
||||
* license, and in no event shall the patent license extend to any additions
|
||||
* to or modifications of the Original Intel Code. No other license or right
|
||||
* is granted directly or by implication, estoppel or otherwise;
|
||||
*
|
||||
* The above copyright and patent license is granted only if the following
|
||||
* the above copyright and patent license is granted only if the following
|
||||
* conditions are met:
|
||||
*
|
||||
* 3. Conditions
|
||||
* 3. Conditions
|
||||
*
|
||||
* 3.1. Redistribution of Source with Rights to Further Distribute Source.
|
||||
* Redistribution of source code of any substantial portion of the Covered
|
||||
* Code or modification with rights to further distribute source must include
|
||||
* the above Copyright Notice, the above License, this list of Conditions,
|
||||
* and the following Disclaimer and Export Compliance provision. In addition,
|
||||
* Licensee must cause all Covered Code to which Licensee contributes to
|
||||
* contain a file documenting the changes Licensee made to create that Covered
|
||||
* Code and the date of any change. Licensee must include in that file the
|
||||
* documentation of any changes made by any predecessor Licensee. Licensee
|
||||
* must include a prominent statement that the modification is derived,
|
||||
* directly or indirectly, from Original Intel Code.
|
||||
* 3.1. Redistribution of source code of any substantial portion of the Covered
|
||||
* Code or modification must include the above Copyright Notice, the above
|
||||
* License, this list of Conditions, and the following Disclaimer and Export
|
||||
* Compliance provision. In addition, Licensee must cause all Covered Code to
|
||||
* which Licensee contributes to contain a file documenting the changes
|
||||
* Licensee made to create that Covered Code and the date of any change.
|
||||
* Licensee must include in that file the documentation of any changes made by
|
||||
* any predecessor Licensee. Licensee must include a prominent statement that
|
||||
* the modification is derived, directly or indirectly, from Original Intel
|
||||
* Code.
|
||||
*
|
||||
* 3.2. Redistribution of Source with no Rights to Further Distribute Source.
|
||||
* Redistribution of source code of any substantial portion of the Covered
|
||||
* Code or modification without rights to further distribute source must
|
||||
* include the following Disclaimer and Export Compliance provision in the
|
||||
* documentation and/or other materials provided with distribution. In
|
||||
* addition, Licensee may not authorize further sublicense of source of any
|
||||
* portion of the Covered Code, and must include terms to the effect that the
|
||||
* license from Licensee to its licensee is limited to the intellectual
|
||||
* property embodied in the software Licensee provides to its licensee, and
|
||||
* not to intellectual property embodied in modifications its licensee may
|
||||
* make.
|
||||
|
||||
* 3.2. Redistribution in binary form of any substantial portion of the Covered
|
||||
* Code or modification must reproduce the above Copyright Notice, and the
|
||||
* following Disclaimer and Export Compliance provision in the documentation
|
||||
* and/or other materials provided with the distribution.
|
||||
*
|
||||
* 3.3. Redistribution of Executable. Redistribution in executable form of any
|
||||
* substantial portion of the Covered Code or modification must reproduce the
|
||||
* above Copyright Notice, and the following Disclaimer and Export Compliance
|
||||
* provision in the documentation and/or other materials provided with the
|
||||
* distribution.
|
||||
*
|
||||
* 3.4. Intel retains all right, title, and interest in and to the Original
|
||||
* 3.3. Intel retains all right, title, and interest in and to the Original
|
||||
* Intel Code.
|
||||
*
|
||||
* 3.5. Neither the name Intel nor any other trademark owned or controlled by
|
||||
* Intel shall be used in advertising or otherwise to promote the sale, use or
|
||||
* other dealings in products derived from or relating to the Covered Code
|
||||
* 3.4. Neither the name Intel nor any other trademark owned or controlled by
|
||||
* Intel shall be used in advertising or otherwise to promote the sale, use or
|
||||
* other dealings in products derived from or relating to the Covered Code
|
||||
* without prior written authorization from Intel.
|
||||
*
|
||||
* 4. Disclaimer and Export Compliance
|
||||
*
|
||||
* 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
|
||||
* HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
|
||||
* IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
|
||||
* INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
|
||||
* UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
|
||||
* IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
|
||||
* PARTICULAR PURPOSE.
|
||||
* 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
|
||||
* HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
|
||||
* IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
|
||||
* INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
|
||||
* UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
|
||||
* IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
|
||||
* PARTICULAR PURPOSE.
|
||||
*
|
||||
* 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
|
||||
* OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
|
||||
* COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
|
||||
* SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
|
||||
* CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
|
||||
* HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
|
||||
* SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
|
||||
* 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
|
||||
* OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
|
||||
* COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
|
||||
* SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
|
||||
* CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
|
||||
* HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
|
||||
* SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
|
||||
* LIMITED REMEDY.
|
||||
*
|
||||
* 4.3. Licensee shall not export, either directly or indirectly, any of this
|
||||
* software or system incorporating such software without first obtaining any
|
||||
* required license or other approval from the U. S. Department of Commerce or
|
||||
* any other agency or department of the United States Government. In the
|
||||
* event Licensee exports any such software from the United States or
|
||||
* re-exports any such software from a foreign destination, Licensee shall
|
||||
* ensure that the distribution and export/re-export of the software is in
|
||||
* compliance with all laws, regulations, orders, or other restrictions of the
|
||||
* U.S. Export Administration Regulations. Licensee agrees that neither it nor
|
||||
* any of its subsidiaries will export/re-export any technical data, process,
|
||||
* software, or service, directly or indirectly, to any country for which the
|
||||
* United States government or any agency thereof requires an export license,
|
||||
* other governmental approval, or letter of assurance, without first obtaining
|
||||
* such license, approval or letter.
|
||||
* 4.3. Licensee shall not export, either directly or indirectly, any of this
|
||||
* software or system incorporating such software without first obtaining any
|
||||
* required license or other approval from the U. S. Department of Commerce or
|
||||
* any other agency or department of the United States Government. In the
|
||||
* event Licensee exports any such software from the United States or re-
|
||||
* exports any such software from a foreign destination, Licensee shall ensure
|
||||
* that the distribution and export/re-export of the software is in compliance
|
||||
* with all laws, regulations, orders, or other restrictions of the U.S. Export
|
||||
* Administration Regulations. Licensee agrees that neither it nor any of its
|
||||
* subsidiaries will export/re-export any technical data, process, software, or
|
||||
* service, directly or indirectly, to any country for which the United States
|
||||
* government or any agency thereof requires an export license, other
|
||||
* governmental approval, or letter of assurance, without first obtaining such
|
||||
* license, approval or letter.
|
||||
*
|
||||
*****************************************************************************/
|
||||
|
||||
#define __NSEVAL_C__
|
||||
|
||||
#include "acpi.h"
|
||||
#include "acparser.h"
|
||||
#include "acinterp.h"
|
||||
#include "acnamesp.h"
|
||||
#define __NSEXEC_C__
|
||||
|
||||
#include <acpi.h>
|
||||
#include <amlcode.h>
|
||||
#include <interpreter.h>
|
||||
#include <namespace.h>
|
||||
#include <string.h>
|
||||
|
||||
|
||||
#define _COMPONENT ACPI_NAMESPACE
|
||||
ACPI_MODULE_NAME ("nseval")
|
||||
#define _THIS_MODULE "nsexec.c"
|
||||
#define _COMPONENT NAMESPACE
|
||||
|
||||
|
||||
/*******************************************************************************
|
||||
static ST_KEY_DESC_TABLE KDT[] = {
|
||||
{"0000", 'I', "Package stack not empty at method exit", "Package stack not empty at method exit"},
|
||||
{"0001", '1', "Method stack not empty at method exit", "Method stack not empty at method exit"},
|
||||
{"0002", 'I', "Object stack not empty at method exit", "Object stack not empty at method exit"},
|
||||
{"0003", '1', "Descriptor Allocation Failure", "Descriptor Allocation Failure"},
|
||||
{NULL, 'I', NULL, NULL}
|
||||
};
|
||||
|
||||
|
||||
|
||||
/****************************************************************************
|
||||
*
|
||||
* FUNCTION: AcpiNsEvaluateRelative
|
||||
* FUNCTION: AcpiExecuteRelativeMethod
|
||||
*
|
||||
* PARAMETERS: Pathname - Name of method to execute, If NULL, the
|
||||
* PARAMETERS: Handle - Handle of containing object
|
||||
* *MethodName - Name of method to execute, If NULL, the
|
||||
* handle is the object to execute
|
||||
* Info - Method info block
|
||||
* *ReturnObject - Where to put method's return value (if
|
||||
* any). If NULL, no value is returned.
|
||||
* **Params - List of parameters to pass to
|
||||
* method, terminated by NULL.
|
||||
* Params itself may be NULL
|
||||
* if no parameters are being
|
||||
* passed.
|
||||
*
|
||||
* RETURN: Status
|
||||
*
|
||||
* DESCRIPTION: Find and execute the requested method using the handle as a
|
||||
* scope
|
||||
*
|
||||
* MUTEX: Locks Namespace
|
||||
*
|
||||
******************************************************************************/
|
||||
****************************************************************************/
|
||||
|
||||
ACPI_STATUS
|
||||
AcpiNsEvaluateRelative (
|
||||
char *Pathname,
|
||||
ACPI_PARAMETER_INFO *Info)
|
||||
AcpiExecuteRelativeMethod (NsHandle Handle,
|
||||
char * MethodName,
|
||||
OBJECT_DESCRIPTOR *ReturnObject,
|
||||
OBJECT_DESCRIPTOR **Params)
|
||||
{
|
||||
ACPI_STATUS Status;
|
||||
ACPI_NAMESPACE_NODE *Node = NULL;
|
||||
ACPI_GENERIC_STATE *ScopeInfo;
|
||||
char *InternalPath = NULL;
|
||||
char NameBuffer[PATHNAME_MAX];
|
||||
ACPI_STATUS Status;
|
||||
UINT32 MaxObjectPathLength = PATHNAME_MAX - 1;
|
||||
|
||||
|
||||
ACPI_FUNCTION_TRACE ("NsEvaluateRelative");
|
||||
|
||||
FUNCTION_TRACE ("AcpiExecuteRelativeMethod");
|
||||
|
||||
/*
|
||||
* Must have a valid object handle
|
||||
* Must have a valid handle
|
||||
*/
|
||||
if (!Info || !Info->Node)
|
||||
if (!Handle)
|
||||
{
|
||||
return_ACPI_STATUS (AE_BAD_PARAMETER);
|
||||
}
|
||||
|
||||
/* Build an internal name string for the method */
|
||||
|
||||
Status = AcpiNsInternalizeName (Pathname, &InternalPath);
|
||||
if (ACPI_FAILURE (Status))
|
||||
{
|
||||
return_ACPI_STATUS (Status);
|
||||
}
|
||||
|
||||
ScopeInfo = AcpiUtCreateGenericState ();
|
||||
if (!ScopeInfo)
|
||||
{
|
||||
goto Cleanup1;
|
||||
}
|
||||
|
||||
/* Get the prefix handle and Node */
|
||||
|
||||
Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
|
||||
if (ACPI_FAILURE (Status))
|
||||
{
|
||||
goto Cleanup;
|
||||
}
|
||||
|
||||
Info->Node = AcpiNsMapHandleToNode (Info->Node);
|
||||
if (!Info->Node)
|
||||
{
|
||||
(void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
|
||||
Status = AE_BAD_PARAMETER;
|
||||
goto Cleanup;
|
||||
}
|
||||
|
||||
/* Lookup the name in the namespace */
|
||||
|
||||
ScopeInfo->Scope.Node = Info->Node;
|
||||
Status = AcpiNsLookup (ScopeInfo, InternalPath, ACPI_TYPE_ANY,
|
||||
ACPI_IMODE_EXECUTE, ACPI_NS_NO_UPSEARCH, NULL,
|
||||
&Node);
|
||||
|
||||
(void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
|
||||
|
||||
if (ACPI_FAILURE (Status))
|
||||
{
|
||||
ACPI_DEBUG_PRINT ((ACPI_DB_NAMES, "Object [%s] not found [%s]\n",
|
||||
Pathname, AcpiFormatException (Status)));
|
||||
goto Cleanup;
|
||||
FUNCTION_EXIT;
|
||||
return AE_BAD_PARAMETER;
|
||||
}
|
||||
|
||||
/*
|
||||
* Now that we have a handle to the object, we can attempt to evaluate it.
|
||||
* If the caller specified a method then it must be a path relative to
|
||||
* the object indicated by the handle we need to reserve space in the
|
||||
* buffer to append the CM name later
|
||||
*/
|
||||
ACPI_DEBUG_PRINT ((ACPI_DB_NAMES, "%s [%p] Value %p\n",
|
||||
Pathname, Node, AcpiNsGetAttachedObject (Node)));
|
||||
if (MethodName)
|
||||
{
|
||||
/*
|
||||
* We will append the method name to the device pathname
|
||||
*/
|
||||
MaxObjectPathLength -= (strlen (MethodName) + 1);
|
||||
}
|
||||
|
||||
Info->Node = Node;
|
||||
Status = AcpiNsEvaluateByHandle (Info);
|
||||
/*
|
||||
* Get the device pathname
|
||||
*/
|
||||
Status = NsHandleToPathname (Handle, MaxObjectPathLength, NameBuffer);
|
||||
if (Status != AE_OK)
|
||||
{
|
||||
/*
|
||||
* Failed the conversion
|
||||
*/
|
||||
FUNCTION_EXIT;
|
||||
return Status;
|
||||
}
|
||||
|
||||
ACPI_DEBUG_PRINT ((ACPI_DB_NAMES, "*** Completed eval of object %s ***\n",
|
||||
Pathname));
|
||||
/*
|
||||
* If the caller specified a method then it must be a path relative to
|
||||
* the object indicated by the handle
|
||||
*/
|
||||
if (MethodName)
|
||||
{
|
||||
/*
|
||||
* Append the method name to the device pathname
|
||||
* (Path separator is a period)
|
||||
*/
|
||||
strcat (NameBuffer, ".");
|
||||
strcat (NameBuffer, MethodName);
|
||||
}
|
||||
|
||||
Cleanup:
|
||||
AcpiUtDeleteGenericState (ScopeInfo);
|
||||
/*
|
||||
* Execute the method
|
||||
*/
|
||||
Status = AcpiExecuteMethod (NameBuffer, ReturnObject, Params);
|
||||
|
||||
Cleanup1:
|
||||
ACPI_MEM_FREE (InternalPath);
|
||||
return_ACPI_STATUS (Status);
|
||||
FUNCTION_EXIT;
|
||||
return Status;
|
||||
}
|
||||
|
||||
|
||||
/*******************************************************************************
|
||||
/****************************************************************************
|
||||
*
|
||||
* FUNCTION: AcpiNsEvaluateByName
|
||||
* FUNCTION: AcpiExecuteMethod
|
||||
*
|
||||
* PARAMETERS: Pathname - Fully qualified pathname to the object
|
||||
* Info - Contains:
|
||||
* ReturnObject - Where to put method's return value (if
|
||||
* PARAMETERS: *MethodName - Name of method to execute
|
||||
* *ReturnObject - Where to put method's return value (if
|
||||
* any). If NULL, no value is returned.
|
||||
* Params - List of parameters to pass to the method,
|
||||
* terminated by NULL. Params itself may be
|
||||
* NULL if no parameters are being passed.
|
||||
* **Params - List of parameters to pass to
|
||||
* method, terminated by NULL.
|
||||
* Params itself may be NULL
|
||||
* if no parameters are being
|
||||
* passed.
|
||||
*
|
||||
* RETURN: Status
|
||||
*
|
||||
* DESCRIPTION: Find and execute the requested method passing the given
|
||||
* parameters
|
||||
*
|
||||
* MUTEX: Locks Namespace
|
||||
*
|
||||
******************************************************************************/
|
||||
****************************************************************************/
|
||||
|
||||
ACPI_STATUS
|
||||
AcpiNsEvaluateByName (
|
||||
char *Pathname,
|
||||
ACPI_PARAMETER_INFO *Info)
|
||||
AcpiExecuteMethod (char * MethodName, OBJECT_DESCRIPTOR *ReturnObject,
|
||||
OBJECT_DESCRIPTOR **Params)
|
||||
{
|
||||
ACPI_STATUS Status;
|
||||
char *InternalPath = NULL;
|
||||
ACPI_STATUS Status = AE_ERROR;
|
||||
nte *MethodPtr = NULL;
|
||||
OBJECT_DESCRIPTOR *ObjDesc;
|
||||
|
||||
|
||||
ACPI_FUNCTION_TRACE ("NsEvaluateByName");
|
||||
|
||||
|
||||
/* Build an internal name string for the method */
|
||||
FUNCTION_TRACE ("AcpiExecuteMethod");
|
||||
|
||||
Status = AcpiNsInternalizeName (Pathname, &InternalPath);
|
||||
if (ACPI_FAILURE (Status))
|
||||
|
||||
/* Parameter validation */
|
||||
|
||||
if (!RootObject->Scope)
|
||||
{
|
||||
return_ACPI_STATUS (Status);
|
||||
}
|
||||
|
||||
Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
|
||||
if (ACPI_FAILURE (Status))
|
||||
{
|
||||
goto Cleanup;
|
||||
}
|
||||
|
||||
/* Lookup the name in the namespace */
|
||||
|
||||
Status = AcpiNsLookup (NULL, InternalPath, ACPI_TYPE_ANY,
|
||||
ACPI_IMODE_EXECUTE, ACPI_NS_NO_UPSEARCH, NULL,
|
||||
&Info->Node);
|
||||
|
||||
(void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
|
||||
|
||||
if (ACPI_FAILURE (Status))
|
||||
{
|
||||
ACPI_DEBUG_PRINT ((ACPI_DB_NAMES,
|
||||
"Object at [%s] was not found, status=%.4X\n",
|
||||
Pathname, Status));
|
||||
goto Cleanup;
|
||||
}
|
||||
|
||||
/*
|
||||
* Now that we have a handle to the object, we can attempt to evaluate it.
|
||||
*/
|
||||
ACPI_DEBUG_PRINT ((ACPI_DB_NAMES, "%s [%p] Value %p\n",
|
||||
Pathname, Info->Node, AcpiNsGetAttachedObject (Info->Node)));
|
||||
|
||||
Status = AcpiNsEvaluateByHandle (Info);
|
||||
|
||||
ACPI_DEBUG_PRINT ((ACPI_DB_NAMES, "*** Completed eval of object %s ***\n",
|
||||
Pathname));
|
||||
|
||||
|
||||
Cleanup:
|
||||
|
||||
/* Cleanup */
|
||||
|
||||
if (InternalPath)
|
||||
{
|
||||
ACPI_MEM_FREE (InternalPath);
|
||||
}
|
||||
|
||||
return_ACPI_STATUS (Status);
|
||||
}
|
||||
|
||||
|
||||
/*******************************************************************************
|
||||
*
|
||||
* FUNCTION: AcpiNsEvaluateByHandle
|
||||
*
|
||||
* PARAMETERS: Handle - Method Node to execute
|
||||
* Params - List of parameters to pass to the method,
|
||||
* terminated by NULL. Params itself may be
|
||||
* NULL if no parameters are being passed.
|
||||
* ParamType - Type of Parameter list
|
||||
* ReturnObject - Where to put method's return value (if
|
||||
* any). If NULL, no value is returned.
|
||||
*
|
||||
* RETURN: Status
|
||||
*
|
||||
* DESCRIPTION: Execute the requested method passing the given parameters
|
||||
*
|
||||
* MUTEX: Locks Namespace
|
||||
*
|
||||
******************************************************************************/
|
||||
|
||||
ACPI_STATUS
|
||||
AcpiNsEvaluateByHandle (
|
||||
ACPI_PARAMETER_INFO *Info)
|
||||
{
|
||||
ACPI_STATUS Status;
|
||||
|
||||
|
||||
ACPI_FUNCTION_TRACE ("NsEvaluateByHandle");
|
||||
|
||||
|
||||
/* Check if namespace has been initialized */
|
||||
|
||||
if (!AcpiGbl_RootNode)
|
||||
{
|
||||
return_ACPI_STATUS (AE_NO_NAMESPACE);
|
||||
}
|
||||
|
||||
/* Parameter Validation */
|
||||
|
||||
if (!Info)
|
||||
{
|
||||
return_ACPI_STATUS (AE_BAD_PARAMETER);
|
||||
}
|
||||
|
||||
/* Initialize the return value to an invalid object */
|
||||
|
||||
Info->ReturnObject = NULL;
|
||||
|
||||
/* Get the prefix handle and Node */
|
||||
|
||||
Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
|
||||
if (ACPI_FAILURE (Status))
|
||||
{
|
||||
return_ACPI_STATUS (Status);
|
||||
}
|
||||
|
||||
Info->Node = AcpiNsMapHandleToNode (Info->Node);
|
||||
if (!Info->Node)
|
||||
{
|
||||
(void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
|
||||
return_ACPI_STATUS (AE_BAD_PARAMETER);
|
||||
}
|
||||
|
||||
/*
|
||||
* For a method alias, we must grab the actual method node so that proper
|
||||
* scoping context will be established before execution.
|
||||
*/
|
||||
if (AcpiNsGetType (Info->Node) == ACPI_TYPE_LOCAL_METHOD_ALIAS)
|
||||
{
|
||||
Info->Node = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, Info->Node->Object);
|
||||
}
|
||||
|
||||
/*
|
||||
* Two major cases here:
|
||||
* 1) The object is an actual control method -- execute it.
|
||||
* 2) The object is not a method -- just return it's current value
|
||||
*
|
||||
* In both cases, the namespace is unlocked by the AcpiNs* procedure
|
||||
*/
|
||||
if (AcpiNsGetType (Info->Node) == ACPI_TYPE_METHOD)
|
||||
{
|
||||
/*
|
||||
* Case 1) We have an actual control method to execute
|
||||
/*
|
||||
* If the name space has not been initialized, the Method has surely
|
||||
* not been defined and there is nothing to execute.
|
||||
*/
|
||||
Status = AcpiNsExecuteControlMethod (Info);
|
||||
}
|
||||
else
|
||||
{
|
||||
/*
|
||||
* Case 2) Object is NOT a method, just return its current value
|
||||
*/
|
||||
Status = AcpiNsGetObjectValue (Info);
|
||||
|
||||
DEBUG_PRINT (ACPI_ERROR, ("Name space not initialized ==> method not defined\n"));
|
||||
FUNCTION_EXIT;
|
||||
return AE_NO_NAMESPACE;
|
||||
}
|
||||
|
||||
/*
|
||||
* Check if there is a return value on the stack that must be dealt with
|
||||
*/
|
||||
if (Status == AE_CTRL_RETURN_VALUE)
|
||||
if (!MethodName)
|
||||
{
|
||||
/* Map AE_CTRL_RETURN_VALUE to AE_OK, we are done with it */
|
||||
|
||||
Status = AE_OK;
|
||||
DEBUG_PRINT (ACPI_ERROR, ("AcpiExecuteMethod: MethodName is NULL\n"));
|
||||
FUNCTION_EXIT;
|
||||
return AE_BAD_PARAMETER;
|
||||
}
|
||||
|
||||
/*
|
||||
* Namespace was unlocked by the handling AcpiNs* function, so we
|
||||
* just return
|
||||
*/
|
||||
return_ACPI_STATUS (Status);
|
||||
}
|
||||
|
||||
|
||||
/*******************************************************************************
|
||||
*
|
||||
* FUNCTION: AcpiNsExecuteControlMethod
|
||||
*
|
||||
* PARAMETERS: Info - Method info block (w/params)
|
||||
*
|
||||
* RETURN: Status
|
||||
*
|
||||
* DESCRIPTION: Execute the requested method passing the given parameters
|
||||
*
|
||||
* MUTEX: Assumes namespace is locked
|
||||
*
|
||||
******************************************************************************/
|
||||
|
||||
ACPI_STATUS
|
||||
AcpiNsExecuteControlMethod (
|
||||
ACPI_PARAMETER_INFO *Info)
|
||||
{
|
||||
ACPI_STATUS Status;
|
||||
ACPI_OPERAND_OBJECT *ObjDesc;
|
||||
|
||||
|
||||
ACPI_FUNCTION_TRACE ("NsExecuteControlMethod");
|
||||
|
||||
|
||||
/* Verify that there is a method associated with this object */
|
||||
|
||||
ObjDesc = AcpiNsGetAttachedObject (Info->Node);
|
||||
if (!ObjDesc)
|
||||
if (ReturnObject)
|
||||
{
|
||||
ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "No attached method object\n"));
|
||||
/* Initialize the return value */
|
||||
|
||||
(void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
|
||||
return_ACPI_STATUS (AE_NULL_OBJECT);
|
||||
memset (ReturnObject, 0, sizeof (OBJECT_DESCRIPTOR));
|
||||
}
|
||||
|
||||
ACPI_DUMP_PATHNAME (Info->Node, "Execute Method:",
|
||||
ACPI_LV_INFO, _COMPONENT);
|
||||
if (RootObject->Scope && MethodName)
|
||||
{
|
||||
/* Root and MethodName valid */
|
||||
|
||||
ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Method at AML address %p Length %X\n",
|
||||
ObjDesc->Method.AmlStart + 1, ObjDesc->Method.AmlLength - 1));
|
||||
|
||||
/*
|
||||
* Unlock the namespace before execution. This allows namespace access
|
||||
* via the external Acpi* interfaces while a method is being executed.
|
||||
* However, any namespace deletion must acquire both the namespace and
|
||||
* interpreter locks to ensure that no thread is using the portion of the
|
||||
* namespace that is being deleted.
|
||||
*/
|
||||
Status = AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
|
||||
if (ACPI_FAILURE (Status))
|
||||
{
|
||||
return_ACPI_STATUS (Status);
|
||||
}
|
||||
|
||||
/*
|
||||
* Execute the method via the interpreter. The interpreter is locked
|
||||
* here before calling into the AML parser
|
||||
*/
|
||||
Status = AcpiExEnterInterpreter ();
|
||||
if (ACPI_FAILURE (Status))
|
||||
{
|
||||
return_ACPI_STATUS (Status);
|
||||
}
|
||||
|
||||
Status = AcpiPsxExecute (Info);
|
||||
AcpiExExitInterpreter ();
|
||||
|
||||
return_ACPI_STATUS (Status);
|
||||
}
|
||||
|
||||
|
||||
/*******************************************************************************
|
||||
*
|
||||
* FUNCTION: AcpiNsGetObjectValue
|
||||
*
|
||||
* PARAMETERS: Info - Method info block (w/params)
|
||||
*
|
||||
* RETURN: Status
|
||||
*
|
||||
* DESCRIPTION: Return the current value of the object
|
||||
*
|
||||
* MUTEX: Assumes namespace is locked, leaves namespace unlocked
|
||||
*
|
||||
******************************************************************************/
|
||||
|
||||
ACPI_STATUS
|
||||
AcpiNsGetObjectValue (
|
||||
ACPI_PARAMETER_INFO *Info)
|
||||
{
|
||||
ACPI_STATUS Status = AE_OK;
|
||||
ACPI_NAMESPACE_NODE *ResolvedNode = Info->Node;
|
||||
|
||||
|
||||
ACPI_FUNCTION_TRACE ("NsGetObjectValue");
|
||||
|
||||
|
||||
/*
|
||||
* Objects require additional resolution steps (e.g., the Node may be a
|
||||
* field that must be read, etc.) -- we can't just grab the object out of
|
||||
* the node.
|
||||
*/
|
||||
|
||||
/*
|
||||
* Use ResolveNodeToValue() to get the associated value. This call always
|
||||
* deletes ObjDesc (allocated above).
|
||||
*
|
||||
* NOTE: we can get away with passing in NULL for a walk state because
|
||||
* ObjDesc is guaranteed to not be a reference to either a method local or
|
||||
* a method argument (because this interface can only be called from the
|
||||
* AcpiEvaluate external interface, never called from a running method.)
|
||||
*
|
||||
* Even though we do not directly invoke the interpreter for this, we must
|
||||
* enter it because we could access an opregion. The opregion access code
|
||||
* assumes that the interpreter is locked.
|
||||
*
|
||||
* We must release the namespace lock before entering the intepreter.
|
||||
*/
|
||||
Status = AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
|
||||
if (ACPI_FAILURE (Status))
|
||||
{
|
||||
return_ACPI_STATUS (Status);
|
||||
}
|
||||
|
||||
Status = AcpiExEnterInterpreter ();
|
||||
if (ACPI_SUCCESS (Status))
|
||||
{
|
||||
Status = AcpiExResolveNodeToValue (&ResolvedNode, NULL);
|
||||
/*
|
||||
* If AcpiExResolveNodeToValue() succeeded, the return value was placed
|
||||
* in ResolvedNode.
|
||||
*/
|
||||
AcpiExExitInterpreter ();
|
||||
|
||||
if (ACPI_SUCCESS (Status))
|
||||
if (MethodName[0] != '\\' || MethodName[1] != '/')
|
||||
{
|
||||
Status = AE_CTRL_RETURN_VALUE;
|
||||
Info->ReturnObject = ACPI_CAST_PTR
|
||||
(ACPI_OPERAND_OBJECT, ResolvedNode);
|
||||
ACPI_DEBUG_PRINT ((ACPI_DB_NAMES, "Returning object %p [%s]\n",
|
||||
Info->ReturnObject,
|
||||
AcpiUtGetObjectTypeName (Info->ReturnObject)));
|
||||
MethodName = NsInternalizeName (MethodName);
|
||||
}
|
||||
|
||||
/* See comment near top of file re significance of FETCH_VALUES */
|
||||
|
||||
#ifdef FETCH_VALUES
|
||||
Status = NsEnter (MethodName, TYPE_Any, MODE_Exec, (NsHandle *) &MethodPtr);
|
||||
#else
|
||||
Status = NsEnter (MethodName, TYPE_Method, MODE_Exec, (NsHandle *) &MethodPtr);
|
||||
#endif
|
||||
|
||||
if (Status != AE_OK)
|
||||
{
|
||||
DEBUG_PRINT (ACPI_INFO, ("Method [%s] was not found, status=%.4X\n",
|
||||
MethodName, Status));
|
||||
}
|
||||
}
|
||||
|
||||
/* Namespace is unlocked */
|
||||
if (RootObject->Scope && MethodName && (Status == AE_OK))
|
||||
{
|
||||
/* Root, MethodName, and Method valid */
|
||||
|
||||
return_ACPI_STATUS (Status);
|
||||
#ifdef FETCH_VALUES
|
||||
if (NsGetType (MethodPtr) == TYPE_Method)
|
||||
{
|
||||
/* Method points to a method name */
|
||||
|
||||
DEBUG_PRINT (ACPI_INFO,
|
||||
("[%s Method %p Value %p\n",
|
||||
MethodName, MethodPtr, MethodPtr->Value));
|
||||
|
||||
if (MethodPtr->Value)
|
||||
{
|
||||
DEBUG_PRINT (ACPI_INFO,
|
||||
("Offset %x Length %lx]\n",
|
||||
((meth *) MethodPtr->Value)->Offset + 1,
|
||||
((meth *) MethodPtr->Value)->Length - 1));
|
||||
}
|
||||
|
||||
else
|
||||
{
|
||||
DEBUG_PRINT (ACPI_INFO, ("*Undefined*]\n"));
|
||||
}
|
||||
#endif
|
||||
|
||||
/*
|
||||
* Here if not FETCH_VALUES (and hence only Method was looked for), or
|
||||
* FETCH_VALUES and the name found was in fact a Method. In either
|
||||
* case, set the current scope to that of the Method, and execute it.
|
||||
*/
|
||||
|
||||
if (!MethodPtr->Value)
|
||||
{
|
||||
DEBUG_PRINT (ACPI_ERROR, ("Method is undefined\n"));
|
||||
}
|
||||
|
||||
else
|
||||
{
|
||||
NsDumpPathname (MethodPtr->Scope, "AcpiExecuteMethod: Setting scope to",
|
||||
TRACE_NAMES, _COMPONENT);
|
||||
|
||||
/* Reset the current scope to the beginning of scope stack */
|
||||
|
||||
CurrentScope = &ScopeStack[0];
|
||||
|
||||
/* Push current scope on scope stack and make Method->Scope current */
|
||||
|
||||
NsPushCurrentScope (MethodPtr->Scope, TYPE_Method);
|
||||
|
||||
NsDumpPathname (MethodPtr, "AcpiExecuteMethod: Executing",
|
||||
TRACE_NAMES, _COMPONENT);
|
||||
|
||||
DEBUG_PRINT (TRACE_NAMES, ("At offset %8XH\n",
|
||||
((meth *) MethodPtr->Value)->Offset + 1));
|
||||
|
||||
AmlClearPkgStack ();
|
||||
ObjStackTop = 0; /* Clear object stack */
|
||||
|
||||
|
||||
/*
|
||||
* Excecute the method here
|
||||
*/
|
||||
Status = AmlExecuteMethod (
|
||||
((meth *) MethodPtr->Value)->Offset + 1,
|
||||
((meth *) MethodPtr->Value)->Length - 1,
|
||||
Params);
|
||||
|
||||
if (AmlPackageNested ())
|
||||
{
|
||||
/* Package stack not empty at method exit and should be */
|
||||
|
||||
REPORT_INFO (&KDT[0]);
|
||||
}
|
||||
|
||||
if (AmlGetMethodDepth () > -1)
|
||||
{
|
||||
/* Method stack not empty at method exit and should be */
|
||||
|
||||
REPORT_ERROR (&KDT[1]);
|
||||
}
|
||||
|
||||
if (ObjStackTop)
|
||||
{
|
||||
/* Object stack is not empty at method exit and should be */
|
||||
|
||||
REPORT_INFO (&KDT[2]);
|
||||
AmlDumpStack (MODE_Exec, "Remaining Object Stack entries", -1, "");
|
||||
}
|
||||
|
||||
DEBUG_PRINT (ACPI_INFO, ("*** Completed execution of method %s ***\n",
|
||||
MethodName));
|
||||
}
|
||||
|
||||
#ifdef FETCH_VALUES
|
||||
}
|
||||
|
||||
else
|
||||
{
|
||||
/*
|
||||
* Method points to a name that is not a method
|
||||
* Here if FETCH_VALUES and the name found was not a Method.
|
||||
* Return its value.
|
||||
*/
|
||||
ObjDesc = AllocateObjectDesc (&KDT[3]);
|
||||
if (ObjDesc)
|
||||
{
|
||||
/* Construct a descriptor pointing to the name */
|
||||
|
||||
ObjDesc->Lvalue.ValType = (UINT8) TYPE_Lvalue;
|
||||
ObjDesc->Lvalue.OpCode = (UINT8) AML_NameOp;
|
||||
ObjDesc->Lvalue.Ref = (void *) MethodPtr;
|
||||
|
||||
/*
|
||||
* Put it on the stack, and use AmlGetRvalue() to get the value.
|
||||
* Note that ObjStackTop points to the top valid entry, not to
|
||||
* the first unused position.
|
||||
*/
|
||||
|
||||
LocalDeleteObject ((OBJECT_DESCRIPTOR **) &ObjStack[ObjStackTop]);
|
||||
ObjStack[ObjStackTop] = (void *) ObjDesc;
|
||||
|
||||
/* This causes ObjDesc (allocated above) to always be deleted */
|
||||
|
||||
Status = AmlGetRvalue ((OBJECT_DESCRIPTOR **) &ObjStack[ObjStackTop]);
|
||||
|
||||
/*
|
||||
* If AmlGetRvalue() succeeded, treat the top stack entry as
|
||||
* a return value.
|
||||
*/
|
||||
|
||||
if (AE_OK == Status)
|
||||
{
|
||||
Status = AE_RETURN_VALUE;
|
||||
}
|
||||
}
|
||||
|
||||
else
|
||||
{
|
||||
/* Descriptor allocation failure */
|
||||
|
||||
Status = AE_NO_MEMORY;
|
||||
}
|
||||
}
|
||||
#endif
|
||||
|
||||
|
||||
|
||||
/* TBD: Unecessary mapping? */
|
||||
|
||||
if (AE_AML_ERROR == Status)
|
||||
{
|
||||
Status = AE_ERROR;
|
||||
}
|
||||
|
||||
if (AE_RETURN_VALUE == Status)
|
||||
{
|
||||
/*
|
||||
* If the Method returned a value and the caller provided a place
|
||||
* to store a returned value, Copy the returned value to the object
|
||||
* descriptor provided by the caller.
|
||||
*/
|
||||
|
||||
if (ReturnObject)
|
||||
{
|
||||
(*ReturnObject) = *((OBJECT_DESCRIPTOR *) ObjStack[ObjStackTop]);
|
||||
}
|
||||
|
||||
/*
|
||||
* TBD: do we ever want to delete this???
|
||||
* There are clearly cases that we don't and this will fault
|
||||
*/
|
||||
|
||||
/* OsdFree (ObjStack[ObjStackTop]); */
|
||||
|
||||
Status = AE_OK;
|
||||
}
|
||||
}
|
||||
|
||||
FUNCTION_EXIT;
|
||||
return Status;
|
||||
}
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user