Subversion Repositories Kolibri OS

#include "acpi.h"

#include "accommon.h"

#include "acdebug.h"

#include "acdisasm.h"

#define _COMPONENT          ACPI_CA_DEBUGGER

        ACPI_MODULE_NAME    ("dbcmds")

/* Local prototypes */

static ACPI_STATUS

AcpiDbIntegrityWalk (

    ACPI_HANDLE             ObjHandle,

    UINT32                  NestingLevel,

    void                    *Context,

    void                    **ReturnValue);

static ACPI_STATUS

AcpiDbWalkAndMatchName (

    ACPI_HANDLE             ObjHandle,

    UINT32                  NestingLevel,

    void                    *Context,

    void                    **ReturnValue);

static ACPI_STATUS

AcpiDbWalkForReferences (

    ACPI_HANDLE             ObjHandle,

    UINT32                  NestingLevel,

    void                    *Context,

    void                    **ReturnValue);

static ACPI_STATUS

AcpiDbWalkForSpecificObjects (

    ACPI_HANDLE             ObjHandle,

    UINT32                  NestingLevel,

/*

 * Arguments for the Objects command

 * These object types map directly to the ACPI_TYPES

 */

static ARGUMENT_INFO        AcpiDbObjectTypes [] =

{

    {"ANY"},

    {"INTEGERS"},

    {"STRINGS"},

    {"BUFFERS"},

    {"PACKAGES"},

    {"FIELDS"},

    {"DEVICES"},

    {"EVENTS"},

    {"METHODS"},

    {"MUTEXES"},

    {"REGIONS"},

    {"POWERRESOURCES"},

    {"PROCESSORS"},

    {"THERMALZONES"},

    {"BUFFERFIELDS"},

    {"DDBHANDLES"},

    {"DEBUG"},

    {"REGIONFIELDS"},

    {"BANKFIELDS"},

    {"INDEXFIELDS"},

    {"REFERENCES"},

    {"ALIAS"},

    {NULL}           /* Must be null terminated */

};

}

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

 *

 * FUNCTION:    AcpiDbWalkForReferences

 *

 * PARAMETERS:  Callback from WalkNamespace

 *

 * RETURN:      Status

 *

 * DESCRIPTION: Check if this namespace object refers to the target object

 *              that is passed in as the context value.

 *

 * Note: Currently doesn't check subobjects within the Node's object

 *

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

static ACPI_STATUS

AcpiDbWalkForReferences (

    ACPI_HANDLE             ObjHandle,

    UINT32                  NestingLevel,

    void                    *Context,

    void                    **ReturnValue)

{

    ACPI_OPERAND_OBJECT     *ObjDesc = (ACPI_OPERAND_OBJECT  *) Context;

    ACPI_NAMESPACE_NODE     *Node = (ACPI_NAMESPACE_NODE *) ObjHandle;

    /* Check for match against the namespace node itself */

    if (Node == (void *) ObjDesc)

    {

        AcpiOsPrintf ("Object is a Node [%4.4s]\n",

            AcpiUtGetNodeName (Node));

    }

    /* Check for match against the object attached to the node */

    if (AcpiNsGetAttachedObject (Node) == ObjDesc)

    {

        AcpiOsPrintf ("Reference at Node->Object %p [%4.4s]\n",

            Node, AcpiUtGetNodeName (Node));

    }

    return (AE_OK);

}

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

 *

 * FUNCTION:    AcpiDbFindReferences

 *

 * PARAMETERS:  ObjectArg       - String with hex value of the object

 *

 * RETURN:      None

 *

 * DESCRIPTION: Search namespace for all references to the input object

 *

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

void

AcpiDbFindReferences (

    char                    *ObjectArg)

{

    ACPI_OPERAND_OBJECT     *ObjDesc;

    /* Convert string to object pointer */

    ObjDesc = ACPI_TO_POINTER (ACPI_STRTOUL (ObjectArg, NULL, 16));

    /* Search all nodes in namespace */

    (void) AcpiWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, ACPI_UINT32_MAX,

                    AcpiDbWalkForReferences, NULL, (void *) ObjDesc, NULL);

}

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

 *

 * FUNCTION:    AcpiDbWalkForPredefinedNames

 *

 * PARAMETERS:  Callback from WalkNamespace

 *

 * RETURN:      Status

 *

 * DESCRIPTION: Detect and display predefined ACPI names (names that start with

 *              an underscore)

 *

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

static ACPI_STATUS

AcpiDbWalkForPredefinedNames (

    ACPI_HANDLE             ObjHandle,

    UINT32                  NestingLevel,

    void                    *Context,

    void                    **ReturnValue)

{

    ACPI_NAMESPACE_NODE         *Node = (ACPI_NAMESPACE_NODE *) ObjHandle;

    UINT32                      *Count = (UINT32 *) Context;

    const ACPI_PREDEFINED_INFO  *Predefined;

    const ACPI_PREDEFINED_INFO  *Package = NULL;

    char                        *Pathname;

    Predefined = AcpiNsCheckForPredefinedName (Node);

    if (!Predefined)

    {

        return (AE_OK);

    }

    Pathname = AcpiNsGetExternalPathname (Node);

    if (!Pathname)

    {

        return (AE_OK);

    }

    /* If method returns a package, the info is in the next table entry */

    if (Predefined->Info.ExpectedBtypes & ACPI_BTYPE_PACKAGE)

    {

        Package = Predefined + 1;

    }

    AcpiOsPrintf ("%-32s arg %X ret %2.2X", Pathname,

        Predefined->Info.ParamCount, Predefined->Info.ExpectedBtypes);

    if (Package)

    {

        AcpiOsPrintf (" PkgType %2.2X ObjType %2.2X Count %2.2X",

            Package->RetInfo.Type, Package->RetInfo.ObjectType1,

            Package->RetInfo.Count1);

    }

    AcpiOsPrintf("\n");

    AcpiNsCheckParameterCount (Pathname, Node, ACPI_UINT32_MAX, Predefined);

    ACPI_FREE (Pathname);

    (*Count)++;

    return (AE_OK);

}

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

 *

 * FUNCTION:    AcpiDbCheckPredefinedNames

 *

 * PARAMETERS:  None

 *

 * RETURN:      None

 *

 * DESCRIPTION: Validate all predefined names in the namespace

 *

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

void

AcpiDbCheckPredefinedNames (

    void)

{

    UINT32                  Count = 0;

    /* Search all nodes in namespace */

    (void) AcpiWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, ACPI_UINT32_MAX,

                AcpiDbWalkForPredefinedNames, NULL, (void *) &Count, NULL);

    AcpiOsPrintf ("Found %u predefined names in the namespace\n", Count);

}

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

 *

 * FUNCTION:    AcpiDbWalkForExecute

 *

 * PARAMETERS:  Callback from WalkNamespace

 *

 * RETURN:      Status

 *

 * DESCRIPTION: Batch execution module. Currently only executes predefined

 *              ACPI names.

 *

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

static ACPI_STATUS

AcpiDbWalkForExecute (

    ACPI_HANDLE             ObjHandle,

    UINT32                  NestingLevel,

    void                    *Context,

    void                    **ReturnValue)

{

    ACPI_NAMESPACE_NODE     *Node = (ACPI_NAMESPACE_NODE *) ObjHandle;

    ACPI_EXECUTE_WALK       *Info = (ACPI_EXECUTE_WALK *) Context;

    ACPI_BUFFER             ReturnObj;

    ACPI_STATUS             Status;

    char                    *Pathname;

    UINT32                  i;

    ACPI_DEVICE_INFO        *ObjInfo;

    ACPI_OBJECT_LIST        ParamObjects;

    ACPI_OBJECT             Params[ACPI_METHOD_NUM_ARGS];

    const ACPI_PREDEFINED_INFO *Predefined;

    Predefined = AcpiNsCheckForPredefinedName (Node);

    if (!Predefined)

    {

        return (AE_OK);

    }

    if (Node->Type == ACPI_TYPE_LOCAL_SCOPE)

    {

        return (AE_OK);

    }

    Pathname = AcpiNsGetExternalPathname (Node);

    if (!Pathname)

    {

        return (AE_OK);

    }

    /* Get the object info for number of method parameters */

    Status = AcpiGetObjectInfo (ObjHandle, &ObjInfo);

    if (ACPI_FAILURE (Status))

    {

        return (Status);

    }

    ParamObjects.Pointer = NULL;

    ParamObjects.Count   = 0;

    if (ObjInfo->Type == ACPI_TYPE_METHOD)

    {

        /* Setup default parameters */

        for (i = 0; i < ObjInfo->ParamCount; i++)

        {

            Params[i].Type           = ACPI_TYPE_INTEGER;

            Params[i].Integer.Value  = 1;

        }

        ParamObjects.Pointer     = Params;

        ParamObjects.Count       = ObjInfo->ParamCount;

    }

    ACPI_FREE (ObjInfo);

    ReturnObj.Pointer = NULL;

    ReturnObj.Length = ACPI_ALLOCATE_BUFFER;

    /* Do the actual method execution */

    AcpiGbl_MethodExecuting = TRUE;

    Status = AcpiEvaluateObject (Node, NULL, &ParamObjects, &ReturnObj);

    AcpiOsPrintf ("%-32s returned %s\n", Pathname, AcpiFormatException (Status));

    AcpiGbl_MethodExecuting = FALSE;

    ACPI_FREE (Pathname);

    /* Ignore status from method execution */

    Status = AE_OK;

    /* Update count, check if we have executed enough methods */

    Info->Count++;

    if (Info->Count >= Info->MaxCount)

    {

        Status = AE_CTRL_TERMINATE;

    }

    return (Status);

}

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

 *

 * FUNCTION:    AcpiDbBatchExecute

 *

 * PARAMETERS:  CountArg            - Max number of methods to execute

 *

 * RETURN:      None

 *

 * DESCRIPTION: Namespace batch execution. Execute predefined names in the

 *              namespace, up to the max count, if specified.

 *

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

void

AcpiDbBatchExecute (

    char                    *CountArg)

{

    ACPI_EXECUTE_WALK       Info;

    Info.Count = 0;

    Info.MaxCount = ACPI_UINT32_MAX;

    if (CountArg)

    {

        Info.MaxCount = ACPI_STRTOUL (CountArg, NULL, 0);

    }

    /* Search all nodes in namespace */

    (void) AcpiWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, ACPI_UINT32_MAX,

                AcpiDbWalkForExecute, NULL, (void *) &Info, NULL);

    AcpiOsPrintf ("Executed %u predefined names in the namespace\n", Info.Count);

}

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

 *

 * FUNCTION:    AcpiDbSetMethodBreakpoint

 *

 * PARAMETERS:  Location            - AML offset of breakpoint

 *              WalkState           - Current walk info

 *              Op                  - Current Op (from parse walk)

 *

 * RETURN:      None

 *

 * DESCRIPTION: Set a breakpoint in a control method at the specified

 *              AML offset

 *

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

void

AcpiDbSetMethodBreakpoint (

    char                    *Location,

    ACPI_WALK_STATE         *WalkState,

    ACPI_PARSE_OBJECT       *Op)

{

    UINT32                  Address;

    if (!Op)

    {

        AcpiOsPrintf ("There is no method currently executing\n");

        return;

    }

    /* Get and verify the breakpoint address */

    Address = ACPI_STRTOUL (Location, NULL, 16);

    if (Address <= Op->Common.AmlOffset)

    {

        AcpiOsPrintf ("Breakpoint %X is beyond current address %X\n",

            Address, Op->Common.AmlOffset);

    }

    /* Save breakpoint in current walk */

    WalkState->UserBreakpoint = Address;

    AcpiOsPrintf ("Breakpoint set at AML offset %X\n", Address);

}

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

 *

 * FUNCTION:    AcpiDbSetMethodCallBreakpoint

 *

 * PARAMETERS:  Op                  - Current Op (from parse walk)

 *

 * RETURN:      None

 *

 * DESCRIPTION: Set a breakpoint in a control method at the specified

 *              AML offset

 *

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

void

AcpiDbSetMethodCallBreakpoint (

    ACPI_PARSE_OBJECT       *Op)

{

    if (!Op)

    {

        AcpiOsPrintf ("There is no method currently executing\n");

        return;

    }

    AcpiGbl_StepToNextCall = TRUE;

}

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

 *

 * FUNCTION:    AcpiDbDisassembleAml

 *

 * PARAMETERS:  Statements          - Number of statements to disassemble

 *              Op                  - Current Op (from parse walk)

 *

 * RETURN:      None

 *

 * DESCRIPTION: Display disassembled AML (ASL) starting from Op for the number

 *              of statements specified.

 *

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

void

AcpiDbDisassembleAml (

    char                    *Statements,

    ACPI_PARSE_OBJECT       *Op)

{

    UINT32                  NumStatements = 8;

    if (!Op)

    {

        AcpiOsPrintf ("There is no method currently executing\n");

        return;

    }

    if (Statements)

    {

        NumStatements = ACPI_STRTOUL (Statements, NULL, 0);

    }

    AcpiDmDisassemble (NULL, Op, NumStatements);

}

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

 *

 * FUNCTION:    AcpiDbDisassembleMethod

 *

 * PARAMETERS:  Name            - Name of control method

 *

 * RETURN:      None

 *

 * DESCRIPTION: Display disassembled AML (ASL) starting from Op for the number

 *              of statements specified.

 *

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

ACPI_STATUS

AcpiDbDisassembleMethod (

    char                    *Name)

{

    ACPI_STATUS             Status;

    ACPI_PARSE_OBJECT       *Op;

    ACPI_WALK_STATE         *WalkState;

    ACPI_OPERAND_OBJECT     *ObjDesc;

    ACPI_NAMESPACE_NODE     *Method;

    Method = AcpiDbConvertToNode (Name);

    if (!Method)

    {

        return (AE_BAD_PARAMETER);

    }

    ObjDesc = Method->Object;

    Op = AcpiPsCreateScopeOp ();

    if (!Op)

    {

        return (AE_NO_MEMORY);

    }

    /* Create and initialize a new walk state */

    WalkState = AcpiDsCreateWalkState (0, Op, NULL, NULL);

    if (!WalkState)

    {

        return (AE_NO_MEMORY);

    }

    Status = AcpiDsInitAmlWalk (WalkState, Op, NULL,

                    ObjDesc->Method.AmlStart,

                    ObjDesc->Method.AmlLength, NULL, ACPI_IMODE_LOAD_PASS1);

    if (ACPI_FAILURE (Status))

    {

        return (Status);

    }

    /* Parse the AML */

    WalkState->ParseFlags &= ~ACPI_PARSE_DELETE_TREE;

    WalkState->ParseFlags |= ACPI_PARSE_DISASSEMBLE;

    Status = AcpiPsParseAml (WalkState);

    AcpiDmDisassemble (NULL, Op, 0);

    AcpiPsDeleteParseTree (Op);

    return (AE_OK);

}

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

 *

 * FUNCTION:    AcpiDbDumpNamespace

 *

 * PARAMETERS:  StartArg        - Node to begin namespace dump

 *              DepthArg        - Maximum tree depth to be dumped

 *

 * RETURN:      None

 *

 * DESCRIPTION: Dump entire namespace or a subtree.  Each node is displayed

 *              with type and other information.

 *

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

void

AcpiDbDumpNamespace (

    char                    *StartArg,

    char                    *DepthArg)

{

    ACPI_HANDLE             SubtreeEntry = AcpiGbl_RootNode;

    UINT32                  MaxDepth = ACPI_UINT32_MAX;

    /* No argument given, just start at the root and dump entire namespace */

    if (StartArg)

    {

        SubtreeEntry = AcpiDbConvertToNode (StartArg);

        if (!SubtreeEntry)

        {

            return;

        }

        /* Now we can check for the depth argument */

        if (DepthArg)

        {

            MaxDepth = ACPI_STRTOUL (DepthArg, NULL, 0);

        }

    }

    AcpiDbSetOutputDestination (ACPI_DB_DUPLICATE_OUTPUT);

    AcpiOsPrintf ("ACPI Namespace (from %4.4s (%p) subtree):\n",

        ((ACPI_NAMESPACE_NODE *) SubtreeEntry)->Name.Ascii, SubtreeEntry);

    /* Display the subtree */

    AcpiDbSetOutputDestination (ACPI_DB_REDIRECTABLE_OUTPUT);

    AcpiNsDumpObjects (ACPI_TYPE_ANY, ACPI_DISPLAY_SUMMARY, MaxDepth,

        ACPI_OWNER_ID_MAX, SubtreeEntry);

    AcpiDbSetOutputDestination (ACPI_DB_CONSOLE_OUTPUT);

}

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

 *

 * FUNCTION:    AcpiDbDumpNamespaceByOwner

 *

 * PARAMETERS:  OwnerArg        - Owner ID whose nodes will be displayed

 *              DepthArg        - Maximum tree depth to be dumped

 *

 * RETURN:      None

 *

 * DESCRIPTION: Dump elements of the namespace that are owned by the OwnerId.

 *

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

void

AcpiDbDumpNamespaceByOwner (

    char                    *OwnerArg,

    char                    *DepthArg)

{

    ACPI_HANDLE             SubtreeEntry = AcpiGbl_RootNode;

    UINT32                  MaxDepth = ACPI_UINT32_MAX;

    ACPI_OWNER_ID           OwnerId;

    OwnerId = (ACPI_OWNER_ID) ACPI_STRTOUL (OwnerArg, NULL, 0);

    /* Now we can check for the depth argument */

    if (DepthArg)

    {

        MaxDepth = ACPI_STRTOUL (DepthArg, NULL, 0);

    }

    AcpiDbSetOutputDestination (ACPI_DB_DUPLICATE_OUTPUT);

    AcpiOsPrintf ("ACPI Namespace by owner %X:\n", OwnerId);

    /* Display the subtree */

    AcpiDbSetOutputDestination (ACPI_DB_REDIRECTABLE_OUTPUT);

    AcpiNsDumpObjects (ACPI_TYPE_ANY, ACPI_DISPLAY_SUMMARY, MaxDepth, OwnerId,

        SubtreeEntry);

    AcpiDbSetOutputDestination (ACPI_DB_CONSOLE_OUTPUT);

}

 *

 *

    char                    *IndexArg,

    char                    Type;

    UINT32                  Index;

    ACPI_WALK_STATE         *WalkState;

    ACPI_STATUS             Status;

    ACPI_NAMESPACE_NODE     *Node;

    /* Validate TypeArg */

    if ((Type != 'L') &&

        AcpiOsPrintf ("Invalid SET operand: %s\n", TypeArg);

    Value = ACPI_STRTOUL (ValueArg, NULL, 16);

    if (Type == 'N')

        Node = AcpiDbConvertToNode (IndexArg);

        {

            AcpiOsPrintf ("Can only set Integer nodes\n");

            return;

        }

        ObjDesc->Integer.Value = Value;

        return;

    }

    Index = ACPI_STRTOUL (IndexArg, NULL, 16);

    }

    /* Create and initialize the new object */

    ObjDesc = AcpiUtCreateIntegerObject ((UINT64) Value);

    if (!ObjDesc)

    {

        AcpiOsPrintf ("Could not create an internal object\n");

        return;

    }

    /* Store the new object into the target */

    switch (Type)

    {

    case 'A':

        /* Set a method argument */

        if (Index > ACPI_METHOD_MAX_ARG)

        {

            AcpiOsPrintf ("Arg%u - Invalid argument name\n", Index);

            goto Cleanup;

        }

        Status = AcpiDsStoreObjectToLocal (ACPI_REFCLASS_ARG, Index, ObjDesc,

                    WalkState);

        if (ACPI_FAILURE (Status))

        {

            goto Cleanup;

        }

        ObjDesc = WalkState->Arguments[Index].Object;

        AcpiOsPrintf ("Arg%u: ", Index);

        AcpiDmDisplayInternalObject (ObjDesc, WalkState);

        break;

    case 'L':

        /* Set a method local */

        if (Index > ACPI_METHOD_MAX_LOCAL)

        {

            AcpiOsPrintf ("Local%u - Invalid local variable name\n", Index);

            goto Cleanup;

        }

        Status = AcpiDsStoreObjectToLocal (ACPI_REFCLASS_LOCAL, Index, ObjDesc,

                    WalkState);

        if (ACPI_FAILURE (Status))

        {

            goto Cleanup;

        }

        ObjDesc = WalkState->LocalVariables[Index].Object;

        AcpiOsPrintf ("Local%u: ", Index);

        break;

    default:

        break;

    }

Cleanup:

    AcpiUtRemoveReference (ObjDesc);

}

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

 * FUNCTION:    AcpiDbWalkForSpecificObjects

 * PARAMETERS:  Callback from WalkNamespace

 *

 * RETURN:      Status

 *

 * DESCRIPTION: Display short info about objects in the namespace

 *

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

static ACPI_STATUS

AcpiDbWalkForSpecificObjects (

    ACPI_BUFFER             Buffer;

    ACPI_STATUS             Status;

    Info->Count++;

    /* Get and display the full pathname to this object */

    Buffer.Length = ACPI_ALLOCATE_LOCAL_BUFFER;

    Status = AcpiNsHandleToPathname (ObjHandle, &Buffer);

    if (ACPI_FAILURE (Status))

    {

        AcpiOsPrintf ("Could Not get pathname for object %p\n", ObjHandle);

        return (AE_OK);

    }

    AcpiOsPrintf ("%32s", (char *) Buffer.Pointer);

    ACPI_FREE (Buffer.Pointer);

    /* Dump short info about the object */

    (void) AcpiNsDumpOneObject (ObjHandle, NestingLevel, Info, NULL);

    return (AE_OK);

}

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

 *

 * FUNCTION:    AcpiDbDisplayObjects

 *

 * PARAMETERS:  ObjTypeArg          - Type of object to display

 *              DisplayCountArg     - Max depth to display

 *

 * RETURN:      None

 *

 * DESCRIPTION: Display objects in the namespace of the requested type

 *

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

ACPI_STATUS

AcpiDbDisplayObjects (

    char                    *ObjTypeArg,

    char                    *DisplayCountArg)

{

    ACPI_WALK_INFO          Info;

    ACPI_OBJECT_TYPE        Type;

    /* Get the object type */

    Type = AcpiDbMatchArgument (ObjTypeArg, AcpiDbObjectTypes);

    if (Type == ACPI_TYPE_NOT_FOUND)

    {

        AcpiOsPrintf ("Invalid or unsupported argument\n");

        return (AE_OK);

    }

    AcpiDbSetOutputDestination (ACPI_DB_DUPLICATE_OUTPUT);

    AcpiOsPrintf (

        "Objects of type [%s] defined in the current ACPI Namespace:\n",

        AcpiUtGetTypeName (Type));

    AcpiDbSetOutputDestination (ACPI_DB_REDIRECTABLE_OUTPUT);

    Info.Count = 0;

    Info.OwnerId = ACPI_OWNER_ID_MAX;

    Info.DebugLevel = ACPI_UINT32_MAX;

    Info.DisplayType = ACPI_DISPLAY_SUMMARY | ACPI_DISPLAY_SHORT;

    /* Walk the namespace from the root */

    (void) AcpiWalkNamespace (Type, ACPI_ROOT_OBJECT, ACPI_UINT32_MAX,

                AcpiDbWalkForSpecificObjects, NULL, (void *) &Info, NULL);

    AcpiOsPrintf (

        "\nFound %u objects of type [%s] in the current ACPI Namespace\n",

        Info.Count, AcpiUtGetTypeName (Type));

    AcpiDbSetOutputDestination (ACPI_DB_CONSOLE_OUTPUT);

    return (AE_OK);

}

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

 *

 * FUNCTION:    AcpiDbWalkAndMatchName

 *

 * PARAMETERS:  Callback from WalkNamespace

 *

 * RETURN:      Status

 *

 * DESCRIPTION: Find a particular name/names within the namespace.  Wildcards

 *              are supported -- '?' matches any character.

 *

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

static ACPI_STATUS

AcpiDbWalkAndMatchName (

    ACPI_HANDLE             ObjHandle,

    UINT32                  NestingLevel,

    void                    *Context,

    void                    **ReturnValue)

{

    ACPI_STATUS             Status;

    char                    *RequestedName = (char *) Context;

    UINT32                  i;

    ACPI_BUFFER             Buffer;

    ACPI_WALK_INFO          Info;

    /* Check for a name match */

    for (i = 0; i < 4; i++)

    {

        /* Wildcard support */

        if ((RequestedName[i] != '?') &&

            (RequestedName[i] != ((ACPI_NAMESPACE_NODE *) ObjHandle)->Name.Ascii[i]))

        {

            /* No match, just exit */

            return (AE_OK);

        }

    }

    /* Get the full pathname to this object */

    Buffer.Length = ACPI_ALLOCATE_LOCAL_BUFFER;

    Status = AcpiNsHandleToPathname (ObjHandle, &Buffer);

    if (ACPI_FAILURE (Status))

    {

        AcpiOsPrintf ("Could Not get pathname for object %p\n", ObjHandle);

    }

    else

    {

        Info.OwnerId = ACPI_OWNER_ID_MAX;

        Info.DebugLevel = ACPI_UINT32_MAX;

        Info.DisplayType = ACPI_DISPLAY_SUMMARY | ACPI_DISPLAY_SHORT;

        AcpiOsPrintf ("%32s", (char *) Buffer.Pointer);

        (void) AcpiNsDumpOneObject (ObjHandle, NestingLevel, &Info, NULL);

        ACPI_FREE (Buffer.Pointer);

    }

    return (AE_OK);

}

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

 *

 * FUNCTION:    AcpiDbFindNameInNamespace

 *

 * PARAMETERS:  NameArg         - The 4-character ACPI name to find.

 *                                wildcards are supported.

 *

 * RETURN:      None

 *

 * DESCRIPTION: Search the namespace for a given name (with wildcards)

 *

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

ACPI_STATUS

AcpiDbFindNameInNamespace (

    char                    *NameArg)

{

    char                    AcpiName[5] = "____";

    char                    *AcpiNamePtr = AcpiName;

    if (ACPI_STRLEN (NameArg) > 4)

    {

        AcpiOsPrintf ("Name must be no longer than 4 characters\n");

        return (AE_OK);

    }

    /* Pad out name with underscores as necessary to create a 4-char name */

    AcpiUtStrupr (NameArg);

    while (*NameArg)

    {

        *AcpiNamePtr = *NameArg;

        AcpiNamePtr++;

        NameArg++;

    }

    /* Walk the namespace from the root */

    (void) AcpiWalkNamespace (ACPI_TYPE_ANY, ACPI_ROOT_OBJECT, ACPI_UINT32_MAX,

                        AcpiDbWalkAndMatchName, NULL, AcpiName, NULL);

    AcpiDbSetOutputDestination (ACPI_DB_CONSOLE_OUTPUT);

    return (AE_OK);

}

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

 *

 * FUNCTION:    AcpiDbSetScope

 *

 * PARAMETERS:  Name                - New scope path

 *

 * RETURN:      Status

 *

 * DESCRIPTION: Set the "current scope" as maintained by this utility.

AcpiDbSetScope (

    char                    *Name)

    ACPI_STATUS             Status;

    if (!Name || Name[0] == 0)

    {

    AcpiDbPrepNamestring (Name);

    if (Name[0] == '\\')

    {

        /* Validate new scope from the root */

                    &Node);

        {