utdecode.c File Reference

#include "acpi.h"
#include "accommon.h"
#include "acnamesp.h"
#include "amlcode.h"

Include dependency graph for utdecode.c:

Go to the source code of this file.

Macros
#define	_COMPONENT   ACPI_UTILITIES

Functions
const char *	AcpiUtGetRegionName (UINT8 SpaceId)
const char *	AcpiUtGetEventName (UINT32 EventId)
const char *	AcpiUtGetTypeName (ACPI_OBJECT_TYPE Type)
const char *	AcpiUtGetObjectTypeName (ACPI_OPERAND_OBJECT *ObjDesc)
const char *	AcpiUtGetNodeName (void *Object)
const char *	AcpiUtGetDescriptorName (void *Object)
const char *	AcpiUtGetReferenceName (ACPI_OPERAND_OBJECT *Object)
const char *	AcpiUtGetMutexName (UINT32 MutexId)
BOOLEAN	AcpiUtValidObjectType (ACPI_OBJECT_TYPE Type)

Variables
const UINT8	AcpiGbl_NsProperties [ACPI_NUM_NS_TYPES]
const char *	AcpiGbl_RegionTypes [ACPI_NUM_PREDEFINED_REGIONS]
static const char *	AcpiGbl_EventTypes [ACPI_NUM_FIXED_EVENTS]
static const char	AcpiGbl_BadType [] = "UNDEFINED"
static const char *	AcpiGbl_NsTypeNames []
static const char *	AcpiGbl_DescTypeNames []
static const char *	AcpiGbl_RefClassNames []
static const char *	AcpiGbl_MutexNames [ACPI_NUM_MUTEX]

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_UTILITIES

Definition at line 49 of file utdecode.c.

Function Documentation

AcpiUtGetDescriptorName()

const char * AcpiUtGetDescriptorName

(

void *

Object

)

Definition at line 382 of file utdecode.c.

{
 
    if (!Object)
    {
        return ("NULL OBJECT");
    }
 
    if (ACPI_GET_DESCRIPTOR_TYPE (Object) > ACPI_DESC_TYPE_MAX)
    {
        return ("Not a Descriptor");
    }
 
    return (AcpiGbl_DescTypeNames[ACPI_GET_DESCRIPTOR_TYPE (Object)]);
}

Referenced by AcpiDsInitBufferField(), AcpiExResolveMultiple(), AcpiExResolveOperands(), AcpiNsAttachObject(), AcpiNsLookup(), AcpiUtDeleteObjectDesc(), AcpiUtGetObjectTypeName(), and AcpiUtValidInternalObject().

AcpiUtGetEventName()

const char * AcpiUtGetEventName

(

UINT32

EventId

)

Definition at line 175 of file utdecode.c.

{
 
    if (EventId > ACPI_EVENT_MAX)
    {
        return ("InvalidEventID");
    }
 
    return (AcpiGbl_EventTypes[EventId]);
}

Referenced by AcpiDisableEvent(), AcpiEnableEvent(), AcpiEvFixedEventDispatch(), AcpiInstallFixedEventHandler(), and AcpiRemoveFixedEventHandler().

AcpiUtGetMutexName()

const char * AcpiUtGetMutexName

(

UINT32

MutexId

)

Definition at line 479 of file utdecode.c.

{
 
    if (MutexId > ACPI_MAX_MUTEX)
    {
        return ("Invalid Mutex ID");
    }
 
    return (AcpiGbl_MutexNames[MutexId]);
}

Referenced by AcpiUtAcquireMutex(), and AcpiUtReleaseMutex().

AcpiUtGetNodeName()

const char * AcpiUtGetNodeName

(

void *

Object

)

Definition at line 306 of file utdecode.c.

{
    ACPI_NAMESPACE_NODE     *Node = (ACPI_NAMESPACE_NODE *) Object;
 
 
    /* Must return a string of exactly 4 characters == ACPI_NAMESEG_SIZE */
 
    if (!Object)
    {
        return ("NULL");
    }
 
    /* Check for Root node */
 
    if ((Object == ACPI_ROOT_OBJECT) ||
        (Object == AcpiGbl_RootNode))
    {
        return ("\"\\\" ");
    }
 
    /* Descriptor must be a namespace node */
 
    if (ACPI_GET_DESCRIPTOR_TYPE (Node) != ACPI_DESC_TYPE_NAMED)
    {
        return ("####");
    }
 
    /*
     * Ensure name is valid. The name was validated/repaired when the node
     * was created, but make sure it has not been corrupted.
     */
    AcpiUtRepairName (Node->Name.Ascii);
 
    /* Return the name */
 
    return (Node->Name.Ascii);
}

Referenced by AcpiDsAutoSerializeMethod(), AcpiDsBeginMethodExecution(), AcpiDsGetBankFieldArguments(), AcpiDsGetBufferFieldArguments(), AcpiDsGetRegionArguments(), AcpiDsInitBufferField(), AcpiDsInitOneObject(), AcpiDsLoad1BeginOp(), AcpiDsLoad2BeginOp(), AcpiDsRestartControlMethod(), AcpiDsScopeStackPop(), AcpiDsScopeStackPush(), AcpiEvAddressSpaceDispatch(), AcpiEvAsynchExecuteGpeMethod(), AcpiEvAttachRegion(), AcpiEvInstallSpaceHandler(), AcpiEvPciConfigRegionSetup(), AcpiEvQueueNotifyRequest(), AcpiExAcquireMutex(), AcpiExPrepFieldValue(), AcpiExReleaseMutex(), AcpiExResolveMultiple(), AcpiExSetupRegion(), AcpiNsAttachObject(), AcpiNsDetachObject(), AcpiNsHandleToName(), AcpiNsInitOneObject(), AcpiNsInstallNode(), AcpiNsLookup(), AcpiNsSearchOneScope(), AcpiNsSearchParentTree(), AcpiUtAddAddressRange(), AcpiUtEvaluateObject(), AcpiUtExecute_STA(), AcpiUtExecutePowerMethods(), and AcpiUtRemoveAddressRange().

AcpiUtGetObjectTypeName()

const char * AcpiUtGetObjectTypeName

(

ACPI_OPERAND_OBJECT *

ObjDesc

)

Definition at line 264 of file utdecode.c.

{
    ACPI_FUNCTION_TRACE (UtGetObjectTypeName);
 
 
    if (!ObjDesc)
    {
        ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Null Object Descriptor\n"));
        return_STR ("[NULL Object Descriptor]");
    }
 
    /* These descriptor types share a common area */
 
    if ((ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) != ACPI_DESC_TYPE_OPERAND) &&
        (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) != ACPI_DESC_TYPE_NAMED))
    {
        ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
            "Invalid object descriptor type: 0x%2.2X [%s] (%p)\n",
            ACPI_GET_DESCRIPTOR_TYPE (ObjDesc),
            AcpiUtGetDescriptorName (ObjDesc), ObjDesc));
 
        return_STR ("Invalid object");
    }
 
    return_STR (AcpiUtGetTypeName (ObjDesc->Common.Type));
}

Referenced by AcpiDsInitBufferField(), AcpiDsObjStackPush(), AcpiDsResultPop(), AcpiDsResultPush(), AcpiExConvertToTargetType(), AcpiExDoDebugObject(), AcpiExGetObjectReference(), AcpiExResolveNodeToValue(), AcpiExResolveObject(), AcpiExResolveOperands(), AcpiExSetupRegion(), AcpiExStore(), AcpiExStoreDirectToNode(), AcpiExStoreObjectToIndex(), AcpiExStoreObjectToNode(), AcpiExStoreObjectToObject(), AcpiExWriteSerialBus(), AcpiNsCheckObjectType(), AcpiNsEvaluate(), AcpiNsRepairNullElement(), AcpiNsSimpleRepair(), AcpiNsWrapWithPackage(), AcpiRsCreatePciRoutingTable(), AcpiUtDeleteInternalObj(), AcpiUtEvaluateObject(), AcpiUtGetSimpleObjectSize(), and AcpiUtUpdateRefCount().

AcpiUtGetReferenceName()

const char * AcpiUtGetReferenceName

(

ACPI_OPERAND_OBJECT *

Object

)

Definition at line 426 of file utdecode.c.

{
 
    if (!Object)
    {
        return ("NULL Object");
    }
 
    if (ACPI_GET_DESCRIPTOR_TYPE (Object) != ACPI_DESC_TYPE_OPERAND)
    {
        return ("Not an Operand object");
    }
 
    if (Object->Common.Type != ACPI_TYPE_LOCAL_REFERENCE)
    {
        return ("Not a Reference object");
    }
 
    if (Object->Reference.Class > ACPI_REFCLASS_MAX)
    {
        return ("Unknown Reference class");
    }
 
    return (AcpiGbl_RefClassNames[Object->Reference.Class]);
}

Referenced by AcpiExDoDebugObject(), AcpiExResolveOperands(), AcpiNsCheckReference(), and AcpiUtGetSimpleObjectSize().

AcpiUtGetRegionName()

const char * AcpiUtGetRegionName

(

UINT8

SpaceId

)

Definition at line 125 of file utdecode.c.

{
 
    if (SpaceId >= ACPI_USER_REGION_BEGIN)
    {
        return ("UserDefinedRegion");
    }
    else if (SpaceId == ACPI_ADR_SPACE_DATA_TABLE)
    {
        return ("DataTable");
    }
    else if (SpaceId == ACPI_ADR_SPACE_FIXED_HARDWARE)
    {
        return ("FunctionalFixedHW");
    }
    else if (SpaceId >= ACPI_NUM_PREDEFINED_REGIONS)
    {
        return ("InvalidSpaceId");
    }
 
    return (AcpiGbl_RegionTypes[SpaceId]);
}

Referenced by AcpiEvAddressSpaceDispatch(), AcpiEvAttachRegion(), AcpiEvDetachRegion(), AcpiEvExecuteRegMethods(), AcpiEvInitializeRegion(), AcpiEvInstallHandler(), AcpiEvInstallSpaceHandler(), AcpiExAccessRegion(), AcpiExCreateRegion(), AcpiHwRead(), AcpiHwWrite(), AcpiRemoveAddressSpaceHandler(), and AcpiUtCheckAddressRange().

AcpiUtGetTypeName()

const char * AcpiUtGetTypeName

(

ACPI_OBJECT_TYPE

Type

)

Definition at line 250 of file utdecode.c.

{
 
    if (Type > ACPI_TYPE_INVALID)
    {
        return (AcpiGbl_BadType);
    }
 
    return (AcpiGbl_NsTypeNames[Type]);
}

Referenced by AcpiDsExecBeginOp(), AcpiDsLoad1BeginOp(), AcpiDsLoad1EndOp(), AcpiDsLoad2BeginOp(), AcpiDsLoad2EndOp(), AcpiDsMethodDataSetValue(), AcpiDsScopeStackClear(), AcpiDsScopeStackPop(), AcpiDsScopeStackPush(), AcpiEvaluateObjectTyped(), AcpiEvQueueNotifyRequest(), AcpiExCheckObjectType(), AcpiExConvertToObjectTypeString(), AcpiExConvertToTargetType(), AcpiExDoDebugObject(), AcpiExOpcode_1A_0T_1R(), AcpiExOpcode_2A_0T_0R(), AcpiExPrepFieldValue(), AcpiExResolveNodeToValue(), AcpiExResolveObject(), AcpiExStoreDirectToNode(), AcpiExStoreObjectToNode(), AcpiExWriteDataToField(), AcpiExWriteGpio(), AcpiNsCheckAcpiCompliance(), AcpiNsCheckArgumentCount(), AcpiNsCheckArgumentTypes(), AcpiNsCheckObjectType(), AcpiNsEvaluate(), AcpiNsInitOneObject(), AcpiNsInstallNode(), AcpiNsLookup(), AcpiNsSearchOneScope(), AcpiNsSearchParentTree(), AcpiUtCopyEsimpleToIsimple(), AcpiUtCopyIsimpleToEsimple(), AcpiUtCreateInternalObjectDbg(), and AcpiUtGetObjectTypeName().

AcpiUtValidObjectType()

BOOLEAN AcpiUtValidObjectType

(

ACPI_OBJECT_TYPE

Type

)

Definition at line 681 of file utdecode.c.

{
 
    if (Type > ACPI_TYPE_LOCAL_MAX)
    {
        /* Note: Assumes all TYPEs are contiguous (external/local) */
 
        return (FALSE);
    }
 
    return (TRUE);
}

Referenced by AcpiDsScopeStackPush(), AcpiExResolveOperands(), and AcpiNsLocal().

Variable Documentation

AcpiGbl_BadType

const char AcpiGbl_BadType[] = "UNDEFINED"

static

Definition at line 209 of file utdecode.c.

Referenced by AcpiUtGetTypeName().

AcpiGbl_DescTypeNames

const char* AcpiGbl_DescTypeNames[]

static

Initial value:

=
{
     "Not a Descriptor",
     "Cached Object",
     "State-Generic",
     "State-Update",
     "State-Package",
     "State-Control",
     "State-RootParseScope",
     "State-ParseScope",
     "State-WalkScope",
     "State-Result",
     "State-Notify",
     "State-Thread",
     "Tree Walk State",
     "Parse Tree Op",
     "Operand Object",
     "Namespace Node"
}

Definition at line 360 of file utdecode.c.

Referenced by AcpiUtGetDescriptorName().

AcpiGbl_EventTypes

const char* AcpiGbl_EventTypes[ACPI_NUM_FIXED_EVENTS]

static

Initial value:

=
{
    "PM_Timer",
    "GlobalLock",
    "PowerButton",
    "SleepButton",
    "RealTimeClock",
}

Definition at line 164 of file utdecode.c.

Referenced by AcpiUtGetEventName().

AcpiGbl_MutexNames

const char* AcpiGbl_MutexNames[ACPI_NUM_MUTEX]

static

Initial value:

=
{
    "ACPI_MTX_Interpreter",
    "ACPI_MTX_Namespace",
    "ACPI_MTX_Tables",
    "ACPI_MTX_Events",
    "ACPI_MTX_Caches",
    "ACPI_MTX_Memory",
}

Definition at line 468 of file utdecode.c.

Referenced by AcpiUtGetMutexName().

AcpiGbl_NsProperties

const UINT8 AcpiGbl_NsProperties[ACPI_NUM_NS_TYPES]

Definition at line 57 of file utdecode.c.

Referenced by AcpiNsLocal(), and AcpiNsOpensScope().

AcpiGbl_NsTypeNames

const char* AcpiGbl_NsTypeNames[]

static

Definition at line 213 of file utdecode.c.

Referenced by AcpiUtGetTypeName().

AcpiGbl_RefClassNames

const char* AcpiGbl_RefClassNames[]

static

Initial value:

=
{
     "Local",
     "Argument",
     "RefOf",
     "Index",
     "DdbHandle",
     "Named Object",
     "Debug"
}

Definition at line 414 of file utdecode.c.

Referenced by AcpiUtGetReferenceName().

AcpiGbl_RegionTypes

const char* AcpiGbl_RegionTypes[ACPI_NUM_PREDEFINED_REGIONS]

Initial value:

=
{
    "SystemMemory",       
    "SystemIO",           
    "PCI_Config",         
    "EmbeddedControl",    
    "SMBus",              
    "SystemCMOS",         
    "PCIBARTarget",       
    "IPMI",               
    "GeneralPurposeIo",   
    "GenericSerialBus",   
    "PCC",                
    "PlatformRtMechanism" 
}

Definition at line 107 of file utdecode.c.

Referenced by AcpiUtGetRegionName().