utalloc.c File Reference

#include "acpi.h"
#include "accommon.h"
#include "acdebug.h"

Include dependency graph for utalloc.c:

Go to the source code of this file.

Macros
#define	_COMPONENT   ACPI_UTILITIES

Functions
void *	AcpiOsAllocateZeroed (ACPI_SIZE Size)
ACPI_STATUS	AcpiUtCreateCaches (void)
ACPI_STATUS	AcpiUtDeleteCaches (void)
ACPI_STATUS	AcpiUtValidateBuffer (ACPI_BUFFER *Buffer)
ACPI_STATUS	AcpiUtInitializeBuffer (ACPI_BUFFER *Buffer, ACPI_SIZE RequiredLength)

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_UTILITIES

Definition at line 48 of file utalloc.c.

Function Documentation

AcpiOsAllocateZeroed()

void * AcpiOsAllocateZeroed

(

ACPI_SIZE

Size

)

Definition at line 68 of file utalloc.c.

{
    void                    *Allocation;
 
 
    ACPI_FUNCTION_ENTRY ();
 
 
    Allocation = AcpiOsAllocate (Size);
    if (Allocation)
    {
        /* Clear the memory block */
 
        memset (Allocation, 0, Size);
    }
 
    return (Allocation);
}

AcpiUtCreateCaches()

ACPI_STATUS AcpiUtCreateCaches

(

void

)

Definition at line 104 of file utalloc.c.

{
    ACPI_STATUS             Status;
 
 
    /* Object Caches, for frequently used objects */
 
    Status = AcpiOsCreateCache ("Acpi-Namespace", sizeof (ACPI_NAMESPACE_NODE),
        ACPI_MAX_NAMESPACE_CACHE_DEPTH, &AcpiGbl_NamespaceCache);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    Status = AcpiOsCreateCache ("Acpi-State", sizeof (ACPI_GENERIC_STATE),
        ACPI_MAX_STATE_CACHE_DEPTH, &AcpiGbl_StateCache);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    Status = AcpiOsCreateCache ("Acpi-Parse", sizeof (ACPI_PARSE_OBJ_COMMON),
        ACPI_MAX_PARSE_CACHE_DEPTH, &AcpiGbl_PsNodeCache);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    Status = AcpiOsCreateCache ("Acpi-ParseExt", sizeof (ACPI_PARSE_OBJ_NAMED),
        ACPI_MAX_EXTPARSE_CACHE_DEPTH, &AcpiGbl_PsNodeExtCache);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    Status = AcpiOsCreateCache ("Acpi-Operand", sizeof (ACPI_OPERAND_OBJECT),
        ACPI_MAX_OBJECT_CACHE_DEPTH, &AcpiGbl_OperandCache);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
#ifdef ACPI_ASL_COMPILER
    /*
     * For use with the ASL-/ASL+ option. This cache keeps track of regular
     * 0xA9 0x01 comments.
     */
    Status = AcpiOsCreateCache ("Acpi-Comment", sizeof (ACPI_COMMENT_NODE),
        ACPI_MAX_COMMENT_CACHE_DEPTH, &AcpiGbl_RegCommentCache);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    /*
     * This cache keeps track of the starting addresses of where the comments
     * lie. This helps prevent duplication of comments.
     */
    Status = AcpiOsCreateCache ("Acpi-Comment-Addr", sizeof (ACPI_COMMENT_ADDR_NODE),
        ACPI_MAX_COMMENT_CACHE_DEPTH, &AcpiGbl_CommentAddrCache);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    /*
     * This cache will be used for nodes that represent files.
     */
    Status = AcpiOsCreateCache ("Acpi-File", sizeof (ACPI_FILE_NODE),
        ACPI_MAX_COMMENT_CACHE_DEPTH, &AcpiGbl_FileCache);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
#endif
 
 
#ifdef ACPI_DBG_TRACK_ALLOCATIONS
 
    /* Memory allocation lists */
 
    Status = AcpiUtCreateList ("Acpi-Global", 0,
        &AcpiGbl_GlobalList);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
 
    Status = AcpiUtCreateList ("Acpi-Namespace", sizeof (ACPI_NAMESPACE_NODE),
        &AcpiGbl_NsNodeList);
    if (ACPI_FAILURE (Status))
    {
        return (Status);
    }
#endif
 
    return (AE_OK);
}

Referenced by AcpiUtInitGlobals().

AcpiUtDeleteCaches()

ACPI_STATUS AcpiUtDeleteCaches

(

void

)

Definition at line 218 of file utalloc.c.

{
#ifdef ACPI_DBG_TRACK_ALLOCATIONS
    char                    Buffer[7];
 
 
    if (AcpiGbl_DisplayFinalMemStats)
    {
        strcpy (Buffer, "MEMORY");
        (void) AcpiDbDisplayStatistics (Buffer);
    }
#endif
 
    (void) AcpiOsDeleteCache (AcpiGbl_NamespaceCache);
    AcpiGbl_NamespaceCache = NULL;
 
    (void) AcpiOsDeleteCache (AcpiGbl_StateCache);
    AcpiGbl_StateCache = NULL;
 
    (void) AcpiOsDeleteCache (AcpiGbl_OperandCache);
    AcpiGbl_OperandCache = NULL;
 
    (void) AcpiOsDeleteCache (AcpiGbl_PsNodeCache);
    AcpiGbl_PsNodeCache = NULL;
 
    (void) AcpiOsDeleteCache (AcpiGbl_PsNodeExtCache);
    AcpiGbl_PsNodeExtCache = NULL;
 
#ifdef ACPI_ASL_COMPILER
    (void) AcpiOsDeleteCache (AcpiGbl_RegCommentCache);
    AcpiGbl_RegCommentCache = NULL;
 
    (void) AcpiOsDeleteCache (AcpiGbl_CommentAddrCache);
    AcpiGbl_CommentAddrCache = NULL;
 
    (void) AcpiOsDeleteCache (AcpiGbl_FileCache);
    AcpiGbl_FileCache = NULL;
#endif
 
#ifdef ACPI_DBG_TRACK_ALLOCATIONS
 
    /* Debug only - display leftover memory allocation, if any */
 
    AcpiUtDumpAllocations (ACPI_UINT32_MAX, NULL);
 
    /* Free memory lists */
 
    AcpiOsFree (AcpiGbl_GlobalList);
    AcpiGbl_GlobalList = NULL;
 
    AcpiOsFree (AcpiGbl_NsNodeList);
    AcpiGbl_NsNodeList = NULL;
#endif
 
    return (AE_OK);
}

Referenced by AcpiUtSubsystemShutdown().

AcpiUtInitializeBuffer()

ACPI_STATUS AcpiUtInitializeBuffer	(	ACPI_BUFFER *	Buffer,
		ACPI_SIZE	RequiredLength
	)

Definition at line 336 of file utalloc.c.

{
    ACPI_SIZE               InputBufferLength;
 
 
    /* Parameter validation */
 
    if (!Buffer || !RequiredLength)
    {
        return (AE_BAD_PARAMETER);
    }
 
    /*
     * Buffer->Length is used as both an input and output parameter. Get the
     * input actual length and set the output required buffer length.
     */
    InputBufferLength = Buffer->Length;
    Buffer->Length = RequiredLength;
 
    /*
     * The input buffer length contains the actual buffer length, or the type
     * of buffer to be allocated by this routine.
     */
    switch (InputBufferLength)
    {
    case ACPI_NO_BUFFER:
 
        /* Return the exception (and the required buffer length) */
 
        return (AE_BUFFER_OVERFLOW);
 
    case ACPI_ALLOCATE_BUFFER:
        /*
         * Allocate a new buffer. We directectly call AcpiOsAllocate here to
         * purposefully bypass the (optionally enabled) internal allocation
         * tracking mechanism since we only want to track internal
         * allocations. Note: The caller should use AcpiOsFree to free this
         * buffer created via ACPI_ALLOCATE_BUFFER.
         */
        Buffer->Pointer = AcpiOsAllocate (RequiredLength);
        break;
 
    case ACPI_ALLOCATE_LOCAL_BUFFER:
 
        /* Allocate a new buffer with local interface to allow tracking */
 
        Buffer->Pointer = ACPI_ALLOCATE (RequiredLength);
        break;
 
    default:
 
        /* Existing buffer: Validate the size of the buffer */
 
        if (InputBufferLength < RequiredLength)
        {
            return (AE_BUFFER_OVERFLOW);
        }
        break;
    }
 
    /* Validate allocation from above or input buffer pointer */
 
    if (!Buffer->Pointer)
    {
        return (AE_NO_MEMORY);
    }
 
    /* Have a valid buffer, clear it */
 
    memset (Buffer->Pointer, 0, RequiredLength);
    return (AE_OK);
}

Referenced by AcpiEvaluateObject(), AcpiGetSystemInfo(), AcpiNsHandleToName(), AcpiNsHandleToPathname(), AcpiRsCreateAmlResources(), AcpiRsCreatePciRoutingTable(), AcpiRsCreateResourceList(), and AcpiRsMatchVendorResource().

AcpiUtValidateBuffer()

ACPI_STATUS AcpiUtValidateBuffer

(

ACPI_BUFFER *

Buffer

)

Definition at line 290 of file utalloc.c.

{
 
    /* Obviously, the structure pointer must be valid */
 
    if (!Buffer)
    {
        return (AE_BAD_PARAMETER);
    }
 
    /* Special semantics for the length */
 
    if ((Buffer->Length == ACPI_NO_BUFFER)              ||
        (Buffer->Length == ACPI_ALLOCATE_BUFFER)        ||
        (Buffer->Length == ACPI_ALLOCATE_LOCAL_BUFFER))
    {
        return (AE_OK);
    }
 
    /* Length is valid, the buffer pointer must be also */
 
    if (!Buffer->Pointer)
    {
        return (AE_BAD_PARAMETER);
    }
 
    return (AE_OK);
}

Referenced by AcpiGetName(), AcpiGetSystemInfo(), and AcpiRsValidateParameters().