utmutex.c File Reference

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

Include dependency graph for utmutex.c:

Go to the source code of this file.

Macros
#define	_COMPONENT   ACPI_UTILITIES

Functions
static ACPI_STATUS	AcpiUtCreateMutex (ACPI_MUTEX_HANDLE MutexId)
static void	AcpiUtDeleteMutex (ACPI_MUTEX_HANDLE MutexId)
ACPI_STATUS	AcpiUtMutexInitialize (void)
void	AcpiUtMutexTerminate (void)
ACPI_STATUS	AcpiUtAcquireMutex (ACPI_MUTEX_HANDLE MutexId)
ACPI_STATUS	AcpiUtReleaseMutex (ACPI_MUTEX_HANDLE MutexId)

Macro Definition Documentation

_COMPONENT

#define _COMPONENT   ACPI_UTILITIES

Definition at line 47 of file utmutex.c.

Function Documentation

AcpiUtAcquireMutex()

ACPI_STATUS AcpiUtAcquireMutex

(

ACPI_MUTEX_HANDLE

MutexId

)

Definition at line 256 of file utmutex.c.

{
    ACPI_STATUS             Status;
    ACPI_THREAD_ID          ThisThreadId;
 
 
    ACPI_FUNCTION_NAME (UtAcquireMutex);
 
 
    if (MutexId > ACPI_MAX_MUTEX)
    {
        return (AE_BAD_PARAMETER);
    }
 
    ThisThreadId = AcpiOsGetThreadId ();
 
#ifdef ACPI_MUTEX_DEBUG
    {
        UINT32                  i;
        /*
         * Mutex debug code, for internal debugging only.
         *
         * Deadlock prevention. Check if this thread owns any mutexes of value
         * greater than or equal to this one. If so, the thread has violated
         * the mutex ordering rule. This indicates a coding error somewhere in
         * the ACPI subsystem code.
         */
        for (i = MutexId; i < ACPI_NUM_MUTEX; i++)
        {
            if (AcpiGbl_MutexInfo[i].ThreadId == ThisThreadId)
            {
                if (i == MutexId)
                {
                    ACPI_ERROR ((AE_INFO,
                        "Mutex [%s] already acquired by this thread [%u]",
                        AcpiUtGetMutexName (MutexId),
                        (UINT32) ThisThreadId));
 
                    return (AE_ALREADY_ACQUIRED);
                }
 
                ACPI_ERROR ((AE_INFO,
                    "Invalid acquire order: Thread %u owns [%s], wants [%s]",
                    (UINT32) ThisThreadId, AcpiUtGetMutexName (i),
                    AcpiUtGetMutexName (MutexId)));
 
                return (AE_ACQUIRE_DEADLOCK);
            }
        }
    }
#endif
 
    ACPI_DEBUG_PRINT ((ACPI_DB_MUTEX,
        "Thread %u attempting to acquire Mutex [%s]\n",
        (UINT32) ThisThreadId, AcpiUtGetMutexName (MutexId)));
 
    Status = AcpiOsAcquireMutex (
        AcpiGbl_MutexInfo[MutexId].Mutex, ACPI_WAIT_FOREVER);
    if (ACPI_SUCCESS (Status))
    {
        ACPI_DEBUG_PRINT ((ACPI_DB_MUTEX,
            "Thread %u acquired Mutex [%s]\n",
            (UINT32) ThisThreadId, AcpiUtGetMutexName (MutexId)));
 
        AcpiGbl_MutexInfo[MutexId].UseCount++;
        AcpiGbl_MutexInfo[MutexId].ThreadId = ThisThreadId;
    }
    else
    {
        ACPI_EXCEPTION ((AE_INFO, Status,
            "Thread %u could not acquire Mutex [%s] (0x%X)",
            (UINT32) ThisThreadId, AcpiUtGetMutexName (MutexId), MutexId));
    }
 
    return (Status);
}

Referenced by AcpiAnyGpeStatusSet(), AcpiAttachData(), AcpiCheckAddressRange(), AcpiDebugTrace(), AcpiDetachData(), AcpiDisableAllGpes(), AcpiEnableAllRuntimeGpes(), AcpiEnableAllWakeupGpes(), AcpiEvDeleteGpeBlock(), AcpiEvDetachRegion(), AcpiEvExecuteOrphanRegMethod(), AcpiEvGpeInitialize(), AcpiEvInitializeOpRegions(), AcpiEvInstallGpeBlock(), AcpiEvInstallGpeHandler(), AcpiEvInstallRegionHandlers(), AcpiEvUpdateGpes(), AcpiExEnterInterpreter(), AcpiGetData(), AcpiGetDevices(), AcpiGetName(), AcpiGetNextObject(), AcpiGetObjectInfo(), AcpiGetParent(), AcpiGetTable(), AcpiGetTableByIndex(), AcpiGetType(), AcpiInstallAddressSpaceHandler(), AcpiInstallExceptionHandler(), AcpiInstallFixedEventHandler(), AcpiInstallGlobalEventHandler(), AcpiInstallGpeBlock(), AcpiInstallMethod(), AcpiInstallNotifyHandler(), AcpiInstallSciHandler(), AcpiInstallTableHandler(), AcpiNsDeleteNamespaceByOwner(), AcpiNsDeleteNamespaceSubtree(), AcpiNsGetDeviceCallback(), AcpiNsGetNode(), AcpiNsRootInitialize(), AcpiNsTerminate(), AcpiNsWalkNamespace(), AcpiPutTable(), AcpiReallocateRootTable(), AcpiRemoveAddressSpaceHandler(), AcpiRemoveFixedEventHandler(), AcpiRemoveGpeBlock(), AcpiRemoveGpeHandler(), AcpiRemoveNotifyHandler(), AcpiRemoveSciHandler(), AcpiRemoveTableHandler(), AcpiTbAllocateOwnerId(), AcpiTbDeleteNamespaceByOwner(), AcpiTbFindTable(), AcpiTbGetOwnerId(), AcpiTbInstallStandardTable(), AcpiTbIsTableLoaded(), AcpiTbLoadNamespace(), AcpiTbReleaseOwnerId(), AcpiTbSetTableLoadedFlag(), AcpiTbTerminate(), AcpiUnloadParentTable(), AcpiUpdateAllGpes(), AcpiUtAllocateOwnerId(), AcpiUtReleaseOwnerId(), and AcpiWalkNamespace().

AcpiUtCreateMutex()

static ACPI_STATUS AcpiUtCreateMutex ( ACPI_MUTEX_HANDLE  MutexId )

static

Definition at line 194 of file utmutex.c.

{
    ACPI_STATUS             Status = AE_OK;
 
 
    ACPI_FUNCTION_TRACE_U32 (UtCreateMutex, MutexId);
 
 
    if (!AcpiGbl_MutexInfo[MutexId].Mutex)
    {
        Status = AcpiOsCreateMutex (&AcpiGbl_MutexInfo[MutexId].Mutex);
        AcpiGbl_MutexInfo[MutexId].ThreadId = ACPI_MUTEX_NOT_ACQUIRED;
        AcpiGbl_MutexInfo[MutexId].UseCount = 0;
    }
 
    return_ACPI_STATUS (Status);
}

Referenced by AcpiUtMutexInitialize().

AcpiUtDeleteMutex()

static void AcpiUtDeleteMutex ( ACPI_MUTEX_HANDLE  MutexId )

static

Definition at line 227 of file utmutex.c.

{
 
    ACPI_FUNCTION_TRACE_U32 (UtDeleteMutex, MutexId);
 
 
    AcpiOsDeleteMutex (AcpiGbl_MutexInfo[MutexId].Mutex);
 
    AcpiGbl_MutexInfo[MutexId].Mutex = NULL;
    AcpiGbl_MutexInfo[MutexId].ThreadId = ACPI_MUTEX_NOT_ACQUIRED;
 
    return_VOID;
}

Referenced by AcpiUtMutexTerminate().

AcpiUtMutexInitialize()

ACPI_STATUS AcpiUtMutexInitialize

(

void

)

Definition at line 75 of file utmutex.c.

{
    UINT32                  i;
    ACPI_STATUS             Status;
 
 
    ACPI_FUNCTION_TRACE (UtMutexInitialize);
 
 
    /* Create each of the predefined mutex objects */
 
    for (i = 0; i < ACPI_NUM_MUTEX; i++)
    {
        Status = AcpiUtCreateMutex (i);
        if (ACPI_FAILURE (Status))
        {
            return_ACPI_STATUS (Status);
        }
    }
 
    /* Create the spinlocks for use at interrupt level or for speed */
 
    Status = AcpiOsCreateLock (&AcpiGbl_GpeLock);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    Status = AcpiOsCreateLock (&AcpiGbl_HardwareLock);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    Status = AcpiOsCreateLock (&AcpiGbl_ReferenceCountLock);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /* Mutex for _OSI support */
 
    Status = AcpiOsCreateMutex (&AcpiGbl_OsiMutex);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    /* Create the reader/writer lock for namespace access */
 
    Status = AcpiUtCreateRwLock (&AcpiGbl_NamespaceRwLock);
    if (ACPI_FAILURE (Status))
    {
        return_ACPI_STATUS (Status);
    }
 
    return_ACPI_STATUS (Status);
}

Referenced by AcpiInitializeSubsystem().

AcpiUtMutexTerminate()

void AcpiUtMutexTerminate

(

void

)

Definition at line 150 of file utmutex.c.

{
    UINT32                  i;
 
 
    ACPI_FUNCTION_TRACE (UtMutexTerminate);
 
 
    /* Delete each predefined mutex object */
 
    for (i = 0; i < ACPI_NUM_MUTEX; i++)
    {
        AcpiUtDeleteMutex (i);
    }
 
    AcpiOsDeleteMutex (AcpiGbl_OsiMutex);
 
    /* Delete the spinlocks */
 
    AcpiOsDeleteLock (AcpiGbl_GpeLock);
    AcpiOsDeleteLock (AcpiGbl_HardwareLock);
    AcpiOsDeleteLock (AcpiGbl_ReferenceCountLock);
 
    /* Delete the reader/writer lock */
 
    AcpiUtDeleteRwLock (&AcpiGbl_NamespaceRwLock);
    return_VOID;
}

Referenced by AcpiTerminate().

AcpiUtReleaseMutex()

ACPI_STATUS AcpiUtReleaseMutex

(

ACPI_MUTEX_HANDLE

MutexId

)

Definition at line 348 of file utmutex.c.

{
    ACPI_FUNCTION_NAME (UtReleaseMutex);
 
 
    ACPI_DEBUG_PRINT ((ACPI_DB_MUTEX, "Thread %u releasing Mutex [%s]\n",
        (UINT32) AcpiOsGetThreadId (), AcpiUtGetMutexName (MutexId)));
 
    if (MutexId > ACPI_MAX_MUTEX)
    {
        return (AE_BAD_PARAMETER);
    }
 
    /*
     * Mutex must be acquired in order to release it!
     */
    if (AcpiGbl_MutexInfo[MutexId].ThreadId == ACPI_MUTEX_NOT_ACQUIRED)
    {
        ACPI_ERROR ((AE_INFO,
            "Mutex [%s] (0x%X) is not acquired, cannot release",
            AcpiUtGetMutexName (MutexId), MutexId));
 
        return (AE_NOT_ACQUIRED);
    }
 
#ifdef ACPI_MUTEX_DEBUG
    {
        UINT32                  i;
        /*
         * Mutex debug code, for internal debugging only.
         *
         * Deadlock prevention. Check if this thread owns any mutexes of value
         * greater than this one. If so, the thread has violated the mutex
         * ordering rule. This indicates a coding error somewhere in
         * the ACPI subsystem code.
         */
        for (i = MutexId; i < ACPI_NUM_MUTEX; i++)
        {
            if (AcpiGbl_MutexInfo[i].ThreadId == AcpiOsGetThreadId ())
            {
                if (i == MutexId)
                {
                    continue;
                }
 
                ACPI_ERROR ((AE_INFO,
                    "Invalid release order: owns [%s], releasing [%s]",
                    AcpiUtGetMutexName (i), AcpiUtGetMutexName (MutexId)));
 
                return (AE_RELEASE_DEADLOCK);
            }
        }
    }
#endif
 
    /* Mark unlocked FIRST */
 
    AcpiGbl_MutexInfo[MutexId].ThreadId = ACPI_MUTEX_NOT_ACQUIRED;
 
    AcpiOsReleaseMutex (AcpiGbl_MutexInfo[MutexId].Mutex);
    return (AE_OK);
}

Referenced by AcpiAnyGpeStatusSet(), AcpiAttachData(), AcpiCheckAddressRange(), AcpiDebugTrace(), AcpiDetachData(), AcpiDisableAllGpes(), AcpiEnableAllRuntimeGpes(), AcpiEnableAllWakeupGpes(), AcpiEvDeleteGpeBlock(), AcpiEvDetachRegion(), AcpiEvExecuteOrphanRegMethod(), AcpiEvGpeInitialize(), AcpiEvInitializeOpRegions(), AcpiEvInstallGpeBlock(), AcpiEvInstallGpeHandler(), AcpiEvInstallRegionHandlers(), AcpiEvUpdateGpes(), AcpiExExitInterpreter(), AcpiGetData(), AcpiGetDevices(), AcpiGetName(), AcpiGetNextObject(), AcpiGetObjectInfo(), AcpiGetParent(), AcpiGetTable(), AcpiGetTableByIndex(), AcpiGetType(), AcpiInstallAddressSpaceHandler(), AcpiInstallExceptionHandler(), AcpiInstallFixedEventHandler(), AcpiInstallGlobalEventHandler(), AcpiInstallGpeBlock(), AcpiInstallMethod(), AcpiInstallNotifyHandler(), AcpiInstallSciHandler(), AcpiInstallTableHandler(), AcpiNsDeleteNamespaceByOwner(), AcpiNsDeleteNamespaceSubtree(), AcpiNsGetDeviceCallback(), AcpiNsGetNode(), AcpiNsRootInitialize(), AcpiNsTerminate(), AcpiNsWalkNamespace(), AcpiPutTable(), AcpiReallocateRootTable(), AcpiRemoveAddressSpaceHandler(), AcpiRemoveFixedEventHandler(), AcpiRemoveGpeBlock(), AcpiRemoveGpeHandler(), AcpiRemoveNotifyHandler(), AcpiRemoveSciHandler(), AcpiRemoveTableHandler(), AcpiTbAllocateOwnerId(), AcpiTbDeleteNamespaceByOwner(), AcpiTbFindTable(), AcpiTbGetOwnerId(), AcpiTbInstallStandardTable(), AcpiTbIsTableLoaded(), AcpiTbLoadNamespace(), AcpiTbReleaseOwnerId(), AcpiTbSetTableLoadedFlag(), AcpiTbTerminate(), AcpiUnloadParentTable(), AcpiUpdateAllGpes(), AcpiUtAllocateOwnerId(), AcpiUtReleaseOwnerId(), and AcpiWalkNamespace().