utobject.c File Reference

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

Include dependency graph for utobject.c:

Go to the source code of this file.

Macros
#define	_COMPONENT   ACPI_UTILITIES

Functions
static ACPI_STATUS	AcpiUtGetSimpleObjectSize (ACPI_OPERAND_OBJECT *Obj, ACPI_SIZE *ObjLength)
static ACPI_STATUS	AcpiUtGetPackageObjectSize (ACPI_OPERAND_OBJECT *Obj, ACPI_SIZE *ObjLength)
static ACPI_STATUS	AcpiUtGetElementLength (UINT8 ObjectType, ACPI_OPERAND_OBJECT *SourceObject, ACPI_GENERIC_STATE *State, void *Context)
ACPI_OPERAND_OBJECT *	AcpiUtCreateInternalObjectDbg (const char *ModuleName, UINT32 LineNumber, UINT32 ComponentId, ACPI_OBJECT_TYPE Type)
ACPI_OPERAND_OBJECT *	AcpiUtCreatePackageObject (UINT32 Count)
ACPI_OPERAND_OBJECT *	AcpiUtCreateIntegerObject (UINT64 InitialValue)
ACPI_OPERAND_OBJECT *	AcpiUtCreateBufferObject (ACPI_SIZE BufferSize)
ACPI_OPERAND_OBJECT *	AcpiUtCreateStringObject (ACPI_SIZE StringSize)
BOOLEAN	AcpiUtValidInternalObject (void *Object)
void *	AcpiUtAllocateObjectDescDbg (const char *ModuleName, UINT32 LineNumber, UINT32 ComponentId)
void	AcpiUtDeleteObjectDesc (ACPI_OPERAND_OBJECT *Object)
ACPI_STATUS	AcpiUtGetObjectSize (ACPI_OPERAND_OBJECT *InternalObject, ACPI_SIZE *ObjLength)

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_UTILITIES

Definition at line 49 of file utobject.c.

Function Documentation

AcpiUtAllocateObjectDescDbg()

void * AcpiUtAllocateObjectDescDbg	(	const char *	ModuleName,
		UINT32	LineNumber,
		UINT32	ComponentId
	)

Definition at line 429 of file utobject.c.

{
    ACPI_OPERAND_OBJECT     *Object;
 
 
    ACPI_FUNCTION_TRACE (UtAllocateObjectDescDbg);
 
 
    Object = AcpiOsAcquireObject (AcpiGbl_OperandCache);
    if (!Object)
    {
        ACPI_ERROR ((ModuleName, LineNumber,
            "Could not allocate an object descriptor"));
 
        return_PTR (NULL);
    }
 
    /* Mark the descriptor type */
 
    ACPI_SET_DESCRIPTOR_TYPE (Object, ACPI_DESC_TYPE_OPERAND);
 
    ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "%p Size %X\n",
        Object, (UINT32) sizeof (ACPI_OPERAND_OBJECT)));
 
    return_PTR (Object);
}

Referenced by AcpiUtCreateInternalObjectDbg().

AcpiUtCreateBufferObject()

ACPI_OPERAND_OBJECT * AcpiUtCreateBufferObject

(

ACPI_SIZE

BufferSize

)

Definition at line 258 of file utobject.c.

{
    ACPI_OPERAND_OBJECT     *BufferDesc;
    UINT8                   *Buffer = NULL;
 
 
    ACPI_FUNCTION_TRACE_U32 (UtCreateBufferObject, BufferSize);
 
 
    /* Create a new Buffer object */
 
    BufferDesc = AcpiUtCreateInternalObject (ACPI_TYPE_BUFFER);
    if (!BufferDesc)
    {
        return_PTR (NULL);
    }
 
    /* Create an actual buffer only if size > 0 */
 
    if (BufferSize > 0)
    {
        /* Allocate the actual buffer */
 
        Buffer = ACPI_ALLOCATE_ZEROED (BufferSize);
        if (!Buffer)
        {
            ACPI_ERROR ((AE_INFO, "Could not allocate size %u",
                (UINT32) BufferSize));
 
            AcpiUtRemoveReference (BufferDesc);
            return_PTR (NULL);
        }
    }
 
    /* Complete buffer object initialization */
 
    BufferDesc->Buffer.Flags |= AOPOBJ_DATA_VALID;
    BufferDesc->Buffer.Pointer = Buffer;
    BufferDesc->Buffer.Length = (UINT32) BufferSize;
 
    /* Return the new buffer descriptor */
 
    return_PTR (BufferDesc);
}

Referenced by AcpiExConcatTemplate(), AcpiExConvertToBuffer(), AcpiExDoConcatenate(), AcpiExReadDataFromField(), AcpiExReadSerialBus(), AcpiExWriteSerialBus(), AcpiNsConvertToBuffer(), AcpiNsConvertToResource(), AcpiNsConvertToUnicode(), AcpiNsRepair_FDE(), and AcpiNsRepairNullElement().

AcpiUtCreateIntegerObject()

ACPI_OPERAND_OBJECT * AcpiUtCreateIntegerObject

(

UINT64

InitialValue

)

Definition at line 223 of file utobject.c.

{
    ACPI_OPERAND_OBJECT     *IntegerDesc;
 
 
    ACPI_FUNCTION_TRACE (UtCreateIntegerObject);
 
 
    /* Create and initialize a new integer object */
 
    IntegerDesc = AcpiUtCreateInternalObject (ACPI_TYPE_INTEGER);
    if (!IntegerDesc)
    {
        return_PTR (NULL);
    }
 
    IntegerDesc->Integer.Value = InitialValue;
    return_PTR (IntegerDesc);
}

Referenced by AcpiDsMethodDataGetValue(), AcpiEvExecuteRegMethod(), AcpiExConvertToInteger(), AcpiExLoadTableOp(), AcpiExOpcode_0A_0T_1R(), AcpiExOpcode_1A_0T_1R(), AcpiExOpcode_6A_0T_1R(), AcpiExReadDataFromField(), AcpiNsConvertToInteger(), AcpiNsRepairNullElement(), AcpiPsExecuteMethod(), and AcpiPsParseAml().

AcpiUtCreateInternalObjectDbg()

ACPI_OPERAND_OBJECT * AcpiUtCreateInternalObjectDbg	(	const char *	ModuleName,
		UINT32	LineNumber,
		UINT32	ComponentId,
		ACPI_OBJECT_TYPE	Type
	)

Definition at line 94 of file utobject.c.

{
    ACPI_OPERAND_OBJECT     *Object;
    ACPI_OPERAND_OBJECT     *SecondObject;
 
 
    ACPI_FUNCTION_TRACE_STR (UtCreateInternalObjectDbg,
        AcpiUtGetTypeName (Type));
 
 
    /* Allocate the raw object descriptor */
 
    Object = AcpiUtAllocateObjectDescDbg (
        ModuleName, LineNumber, ComponentId);
    if (!Object)
    {
        return_PTR (NULL);
    }
 
    switch (Type)
    {
    case ACPI_TYPE_REGION:
    case ACPI_TYPE_BUFFER_FIELD:
    case ACPI_TYPE_LOCAL_BANK_FIELD:
 
        /* These types require a secondary object */
 
        SecondObject = AcpiUtAllocateObjectDescDbg (
            ModuleName, LineNumber, ComponentId);
        if (!SecondObject)
        {
            AcpiUtDeleteObjectDesc (Object);
            return_PTR (NULL);
        }
 
        SecondObject->Common.Type = ACPI_TYPE_LOCAL_EXTRA;
        SecondObject->Common.ReferenceCount = 1;
 
        /* Link the second object to the first */
 
        Object->Common.NextObject = SecondObject;
        break;
 
    default:
 
        /* All others have no secondary object */
        break;
    }
 
    /* Save the object type in the object descriptor */
 
    Object->Common.Type = (UINT8) Type;
 
    /* Init the reference count */
 
    Object->Common.ReferenceCount = 1;
 
    /* Any per-type initialization should go here */
 
    return_PTR (Object);
}

AcpiUtCreatePackageObject()

ACPI_OPERAND_OBJECT * AcpiUtCreatePackageObject

(

UINT32

Count

)

Definition at line 174 of file utobject.c.

{
    ACPI_OPERAND_OBJECT     *PackageDesc;
    ACPI_OPERAND_OBJECT     **PackageElements;
 
 
    ACPI_FUNCTION_TRACE_U32 (UtCreatePackageObject, Count);
 
 
    /* Create a new Package object */
 
    PackageDesc = AcpiUtCreateInternalObject (ACPI_TYPE_PACKAGE);
    if (!PackageDesc)
    {
        return_PTR (NULL);
    }
 
    /*
     * Create the element array. Count+1 allows the array to be null
     * terminated.
     */
    PackageElements = ACPI_ALLOCATE_ZEROED (
        ((ACPI_SIZE) Count + 1) * sizeof (void *));
    if (!PackageElements)
    {
        ACPI_FREE (PackageDesc);
        return_PTR (NULL);
    }
 
    PackageDesc->Package.Count = Count;
    PackageDesc->Package.Elements = PackageElements;
    return_PTR (PackageDesc);
}

Referenced by AcpiNsWrapWithPackage(), AcpiUtCopyEpackageToIpackage(), and AcpiUtCopyIelementToIelement().

AcpiUtCreateStringObject()

ACPI_OPERAND_OBJECT * AcpiUtCreateStringObject

(

ACPI_SIZE

StringSize

)

Definition at line 320 of file utobject.c.

{
    ACPI_OPERAND_OBJECT     *StringDesc;
    char                    *String;
 
 
    ACPI_FUNCTION_TRACE_U32 (UtCreateStringObject, StringSize);
 
 
    /* Create a new String object */
 
    StringDesc = AcpiUtCreateInternalObject (ACPI_TYPE_STRING);
    if (!StringDesc)
    {
        return_PTR (NULL);
    }
 
    /*
     * Allocate the actual string buffer -- (Size + 1) for NULL terminator.
     * NOTE: Zero-length strings are NULL terminated
     */
    String = ACPI_ALLOCATE_ZEROED (StringSize + 1);
    if (!String)
    {
        ACPI_ERROR ((AE_INFO, "Could not allocate size %u",
            (UINT32) StringSize));
 
        AcpiUtRemoveReference (StringDesc);
        return_PTR (NULL);
    }
 
    /* Complete string object initialization */
 
    StringDesc->String.Pointer = String;
    StringDesc->String.Length = (UINT32) StringSize;
 
    /* Return the new string descriptor */
 
    return_PTR (StringDesc);
}

Referenced by AcpiExConvertToObjectTypeString(), AcpiExConvertToString(), AcpiExDoConcatenate(), AcpiExOpcode_2A_1T_1R(), AcpiNsConvertToString(), AcpiNsRepair_HID(), and AcpiNsRepairNullElement().

AcpiUtDeleteObjectDesc()

void AcpiUtDeleteObjectDesc

(

ACPI_OPERAND_OBJECT *

Object

)

Definition at line 473 of file utobject.c.

{
    ACPI_FUNCTION_TRACE_PTR (UtDeleteObjectDesc, Object);
 
 
    /* Object must be of type ACPI_OPERAND_OBJECT */
 
    if (ACPI_GET_DESCRIPTOR_TYPE (Object) != ACPI_DESC_TYPE_OPERAND)
    {
        ACPI_ERROR ((AE_INFO,
            "%p is not an ACPI Operand object [%s]", Object,
            AcpiUtGetDescriptorName (Object)));
        return_VOID;
    }
 
    (void) AcpiOsReleaseObject (AcpiGbl_OperandCache, Object);
    return_VOID;
}

Referenced by AcpiDsBuildInternalBufferObj(), AcpiDsBuildInternalPackageObj(), AcpiDsCreateMethodMutex(), AcpiDsCreateOperand(), AcpiExPrepFieldValue(), AcpiUtCreateInternalObjectDbg(), and AcpiUtDeleteInternalObj().

AcpiUtGetElementLength()

static ACPI_STATUS AcpiUtGetElementLength ( UINT8  ObjectType, ACPI_OPERAND_OBJECT *  SourceObject, ACPI_GENERIC_STATE *  State, void *  Context  )

static

Definition at line 646 of file utobject.c.

{
    ACPI_STATUS             Status = AE_OK;
    ACPI_PKG_INFO           *Info = (ACPI_PKG_INFO *) Context;
    ACPI_SIZE               ObjectSpace;
 
 
    switch (ObjectType)
    {
    case ACPI_COPY_TYPE_SIMPLE:
        /*
         * Simple object - just get the size (Null object/entry is handled
         * here also) and sum it into the running package length
         */
        Status = AcpiUtGetSimpleObjectSize (SourceObject, &ObjectSpace);
        if (ACPI_FAILURE (Status))
        {
            return (Status);
        }
 
        Info->Length += ObjectSpace;
        break;
 
    case ACPI_COPY_TYPE_PACKAGE:
 
        /* Package object - nothing much to do here, let the walk handle it */
 
        Info->NumPackages++;
        State->Pkg.ThisTargetObj = NULL;
        break;
 
    default:
 
        /* No other types allowed */
 
        return (AE_BAD_PARAMETER);
    }
 
    return (Status);
}

Referenced by AcpiUtGetPackageObjectSize().

AcpiUtGetObjectSize()

ACPI_STATUS AcpiUtGetObjectSize	(	ACPI_OPERAND_OBJECT *	InternalObject,
		ACPI_SIZE *	ObjLength
	)

Definition at line 762 of file utobject.c.

{
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    if ((ACPI_GET_DESCRIPTOR_TYPE (InternalObject) ==
            ACPI_DESC_TYPE_OPERAND) &&
        (InternalObject->Common.Type == ACPI_TYPE_PACKAGE))
    {
        Status = AcpiUtGetPackageObjectSize (InternalObject, ObjLength);
    }
    else
    {
        Status = AcpiUtGetSimpleObjectSize (InternalObject, ObjLength);
    }
 
    return (Status);
}

Referenced by AcpiEvaluateObject().

AcpiUtGetPackageObjectSize()

static ACPI_STATUS AcpiUtGetPackageObjectSize ( ACPI_OPERAND_OBJECT *  Obj, ACPI_SIZE *  ObjLength  )

static

Definition at line 710 of file utobject.c.

{
    ACPI_STATUS             Status;
    ACPI_PKG_INFO           Info;
 
 
    ACPI_FUNCTION_TRACE_PTR (UtGetPackageObjectSize, InternalObject);
 
 
    Info.Length = 0;
    Info.ObjectSpace = 0;
    Info.NumPackages = 1;
 
    Status = AcpiUtWalkPackageTree (
        InternalObject, NULL, AcpiUtGetElementLength, &Info);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /*
     * We have handled all of the objects in all levels of the package.
     * just add the length of the package objects themselves.
     * Round up to the next machine word.
     */
    Info.Length += ACPI_ROUND_UP_TO_NATIVE_WORD (
        sizeof (ACPI_OBJECT)) * (ACPI_SIZE) Info.NumPackages;
 
    /* Return the total package length */
 
    *ObjLength = Info.Length;
    return_ACPI_STATUS (Status);
}

Referenced by AcpiUtGetObjectSize().

AcpiUtGetSimpleObjectSize()

static ACPI_STATUS AcpiUtGetSimpleObjectSize ( ACPI_OPERAND_OBJECT *  Obj, ACPI_SIZE *  ObjLength  )

static

Definition at line 512 of file utobject.c.

{
    ACPI_SIZE               Length;
    ACPI_SIZE               Size;
    ACPI_STATUS             Status = AE_OK;
 
 
    ACPI_FUNCTION_TRACE_PTR (UtGetSimpleObjectSize, InternalObject);
 
 
    /* Start with the length of the (external) Acpi object */
 
    Length = sizeof (ACPI_OBJECT);
 
    /* A NULL object is allowed, can be a legal uninitialized package element */
 
    if (!InternalObject)
    {
        /*
         * Object is NULL, just return the length of ACPI_OBJECT
         * (A NULL ACPI_OBJECT is an object of all zeroes.)
         */
        *ObjLength = ACPI_ROUND_UP_TO_NATIVE_WORD (Length);
        return_ACPI_STATUS (AE_OK);
    }
 
    /* A Namespace Node should never appear here */
 
    if (ACPI_GET_DESCRIPTOR_TYPE (InternalObject) == ACPI_DESC_TYPE_NAMED)
    {
        /* A namespace node should never get here */
 
        ACPI_ERROR ((AE_INFO,
            "Received a namespace node [%4.4s] "
            "where an operand object is required",
            ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, InternalObject)->Name.Ascii));
        return_ACPI_STATUS (AE_AML_INTERNAL);
    }
 
    /*
     * The final length depends on the object type
     * Strings and Buffers are packed right up against the parent object and
     * must be accessed bytewise or there may be alignment problems on
     * certain processors
     */
    switch (InternalObject->Common.Type)
    {
    case ACPI_TYPE_STRING:
 
        Length += (ACPI_SIZE) InternalObject->String.Length + 1;
        break;
 
    case ACPI_TYPE_BUFFER:
 
        Length += (ACPI_SIZE) InternalObject->Buffer.Length;
        break;
 
    case ACPI_TYPE_INTEGER:
    case ACPI_TYPE_PROCESSOR:
    case ACPI_TYPE_POWER:
 
        /* No extra data for these types */
 
        break;
 
    case ACPI_TYPE_LOCAL_REFERENCE:
 
        switch (InternalObject->Reference.Class)
        {
        case ACPI_REFCLASS_NAME:
            /*
             * Get the actual length of the full pathname to this object.
             * The reference will be converted to the pathname to the object
             */
            Size = AcpiNsGetPathnameLength (InternalObject->Reference.Node);
            if (!Size)
            {
                return_ACPI_STATUS (AE_BAD_PARAMETER);
            }
 
            Length += ACPI_ROUND_UP_TO_NATIVE_WORD (Size);
            break;
 
        default:
            /*
             * No other reference opcodes are supported.
             * Notably, Locals and Args are not supported, but this may be
             * required eventually.
             */
            ACPI_ERROR ((AE_INFO, "Cannot convert to external object - "
                "unsupported Reference Class [%s] 0x%X in object %p",
                AcpiUtGetReferenceName (InternalObject),
                InternalObject->Reference.Class, InternalObject));
            Status = AE_TYPE;
            break;
        }
        break;
 
    default:
 
        ACPI_ERROR ((AE_INFO, "Cannot convert to external object - "
            "unsupported type [%s] 0x%X in object %p",
            AcpiUtGetObjectTypeName (InternalObject),
            InternalObject->Common.Type, InternalObject));
        Status = AE_TYPE;
        break;
    }
 
    /*
     * Account for the space required by the object rounded up to the next
     * multiple of the machine word size. This keeps each object aligned
     * on a machine word boundary. (preventing alignment faults on some
     * machines.)
     */
    *ObjLength = ACPI_ROUND_UP_TO_NATIVE_WORD (Length);
    return_ACPI_STATUS (Status);
}

Referenced by AcpiUtGetElementLength(), and AcpiUtGetObjectSize().

AcpiUtValidInternalObject()

BOOLEAN AcpiUtValidInternalObject

(

void *

Object

)

Definition at line 376 of file utobject.c.

{
 
    ACPI_FUNCTION_NAME (UtValidInternalObject);
 
 
    /* Check for a null pointer */
 
    if (!Object)
    {
        ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "**** Null Object Ptr\n"));
        return (FALSE);
    }
 
    /* Check the descriptor type field */
 
    switch (ACPI_GET_DESCRIPTOR_TYPE (Object))
    {
    case ACPI_DESC_TYPE_OPERAND:
 
        /* The object appears to be a valid ACPI_OPERAND_OBJECT */
 
        return (TRUE);
 
    default:
 
        ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
            "%p is not an ACPI operand obj [%s]\n",
            Object, AcpiUtGetDescriptorName (Object)));
        break;
    }
 
    return (FALSE);
}

Referenced by AcpiExDoDebugObject(), AcpiUtAddReference(), and AcpiUtRemoveReference().