2005-04-17 02:20:36 +04:00
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
*
|
|
|
|
* Module Name: exmutex - ASL Mutex Acquire/Release functions
|
|
|
|
*
|
|
|
|
*****************************************************************************/
|
|
|
|
|
|
|
|
/*
|
2012-01-12 09:27:23 +04:00
|
|
|
* Copyright (C) 2000 - 2012, Intel Corp.
|
2005-04-17 02:20:36 +04:00
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions
|
|
|
|
* are met:
|
|
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions, and the following disclaimer,
|
|
|
|
* without modification.
|
|
|
|
* 2. Redistributions in binary form must reproduce at minimum a disclaimer
|
|
|
|
* substantially similar to the "NO WARRANTY" disclaimer below
|
|
|
|
* ("Disclaimer") and any redistribution must be conditioned upon
|
|
|
|
* including a substantially similar Disclaimer requirement for further
|
|
|
|
* binary redistribution.
|
|
|
|
* 3. Neither the names of the above-listed copyright holders nor the names
|
|
|
|
* of any contributors may be used to endorse or promote products derived
|
|
|
|
* from this software without specific prior written permission.
|
|
|
|
*
|
|
|
|
* Alternatively, this software may be distributed under the terms of the
|
|
|
|
* GNU General Public License ("GPL") version 2 as published by the Free
|
|
|
|
* Software Foundation.
|
|
|
|
*
|
|
|
|
* NO WARRANTY
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
|
|
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
|
|
* HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
|
|
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
|
|
|
|
* IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
|
|
* POSSIBILITY OF SUCH DAMAGES.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <acpi/acpi.h>
|
2009-01-09 08:30:03 +03:00
|
|
|
#include "accommon.h"
|
|
|
|
#include "acinterp.h"
|
|
|
|
#include "acevents.h"
|
2005-04-17 02:20:36 +04:00
|
|
|
|
|
|
|
#define _COMPONENT ACPI_EXECUTER
|
2005-08-05 08:44:28 +04:00
|
|
|
ACPI_MODULE_NAME("exmutex")
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2005-04-19 06:49:35 +04:00
|
|
|
/* Local prototypes */
|
|
|
|
static void
|
2005-08-05 08:44:28 +04:00
|
|
|
acpi_ex_link_mutex(union acpi_operand_object *obj_desc,
|
|
|
|
struct acpi_thread_state *thread);
|
2005-04-17 02:20:36 +04:00
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_ex_unlink_mutex
|
|
|
|
*
|
|
|
|
* PARAMETERS: obj_desc - The mutex to be unlinked
|
|
|
|
*
|
2005-04-19 06:49:35 +04:00
|
|
|
* RETURN: None
|
2005-04-17 02:20:36 +04:00
|
|
|
*
|
ACPI: ACPICA 20060421
Removed a device initialization optimization introduced in
20051216 where the _STA method was not run unless an _INI
was also present for the same device. This optimization
could cause problems because it could allow _INI methods
to be run within a not-present device subtree (If a
not-present device had no _INI, _STA would not be run,
the not-present status would not be discovered, and the
children of the device would be incorrectly traversed.)
Implemented a new _STA optimization where namespace
subtrees that do not contain _INI are identified and
ignored during device initialization. Selectively running
_STA can significantly improve boot time on large machines
(with assistance from Len Brown.)
Implemented support for the device initialization case
where the returned _STA flags indicate a device not-present
but functioning. In this case, _INI is not run, but the
device children are examined for presence, as per the
ACPI specification.
Implemented an additional change to the IndexField support
in order to conform to MS behavior. The value written to
the Index Register is not simply a byte offset, it is a
byte offset in units of the access width of the parent
Index Field. (Fiodor Suietov)
Defined and deployed a new OSL interface,
acpi_os_validate_address(). This interface is called during
the creation of all AML operation regions, and allows
the host OS to exert control over what addresses it will
allow the AML code to access. Operation Regions whose
addresses are disallowed will cause a runtime exception
when they are actually accessed (will not affect or abort
table loading.)
Defined and deployed a new OSL interface,
acpi_os_validate_interface(). This interface allows the host OS
to match the various "optional" interface/behavior strings
for the _OSI predefined control method as appropriate
(with assistance from Bjorn Helgaas.)
Restructured and corrected various problems in the
exception handling code paths within DsCallControlMethod
and DsTerminateControlMethod in dsmethod (with assistance
from Takayoshi Kochi.)
Modified the Linux source converter to ignore quoted string
literals while converting identifiers from mixed to lower
case. This will correct problems with the disassembler
and other areas where such strings must not be modified.
The ACPI_FUNCTION_* macros no longer require quotes around
the function name. This allows the Linux source converter
to convert the names, now that the converter ignores
quoted strings.
Signed-off-by: Bob Moore <robert.moore@intel.com>
Signed-off-by: Len Brown <len.brown@intel.com>
2006-04-22 01:15:00 +04:00
|
|
|
* DESCRIPTION: Remove a mutex from the "AcquiredMutex" list
|
2005-04-17 02:20:36 +04:00
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
2007-05-10 07:01:59 +04:00
|
|
|
void acpi_ex_unlink_mutex(union acpi_operand_object *obj_desc)
|
2005-04-17 02:20:36 +04:00
|
|
|
{
|
2007-05-10 07:01:59 +04:00
|
|
|
struct acpi_thread_state *thread = obj_desc->mutex.owner_thread;
|
|
|
|
|
2005-04-17 02:20:36 +04:00
|
|
|
if (!thread) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Doubly linked list */
|
|
|
|
|
|
|
|
if (obj_desc->mutex.next) {
|
|
|
|
(obj_desc->mutex.next)->mutex.prev = obj_desc->mutex.prev;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (obj_desc->mutex.prev) {
|
|
|
|
(obj_desc->mutex.prev)->mutex.next = obj_desc->mutex.next;
|
2009-05-21 06:02:34 +04:00
|
|
|
|
|
|
|
/*
|
2010-04-01 07:04:54 +04:00
|
|
|
* Migrate the previous sync level associated with this mutex to
|
|
|
|
* the previous mutex on the list so that it may be preserved.
|
|
|
|
* This handles the case where several mutexes have been acquired
|
|
|
|
* at the same level, but are not released in opposite order.
|
2009-05-21 06:02:34 +04:00
|
|
|
*/
|
|
|
|
(obj_desc->mutex.prev)->mutex.original_sync_level =
|
|
|
|
obj_desc->mutex.original_sync_level;
|
2005-08-05 08:44:28 +04:00
|
|
|
} else {
|
2005-04-17 02:20:36 +04:00
|
|
|
thread->acquired_mutex_list = obj_desc->mutex.next;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_ex_link_mutex
|
|
|
|
*
|
2010-04-01 07:04:54 +04:00
|
|
|
* PARAMETERS: obj_desc - The mutex to be linked
|
|
|
|
* Thread - Current executing thread object
|
2005-04-17 02:20:36 +04:00
|
|
|
*
|
2005-04-19 06:49:35 +04:00
|
|
|
* RETURN: None
|
2005-04-17 02:20:36 +04:00
|
|
|
*
|
ACPI: ACPICA 20060421
Removed a device initialization optimization introduced in
20051216 where the _STA method was not run unless an _INI
was also present for the same device. This optimization
could cause problems because it could allow _INI methods
to be run within a not-present device subtree (If a
not-present device had no _INI, _STA would not be run,
the not-present status would not be discovered, and the
children of the device would be incorrectly traversed.)
Implemented a new _STA optimization where namespace
subtrees that do not contain _INI are identified and
ignored during device initialization. Selectively running
_STA can significantly improve boot time on large machines
(with assistance from Len Brown.)
Implemented support for the device initialization case
where the returned _STA flags indicate a device not-present
but functioning. In this case, _INI is not run, but the
device children are examined for presence, as per the
ACPI specification.
Implemented an additional change to the IndexField support
in order to conform to MS behavior. The value written to
the Index Register is not simply a byte offset, it is a
byte offset in units of the access width of the parent
Index Field. (Fiodor Suietov)
Defined and deployed a new OSL interface,
acpi_os_validate_address(). This interface is called during
the creation of all AML operation regions, and allows
the host OS to exert control over what addresses it will
allow the AML code to access. Operation Regions whose
addresses are disallowed will cause a runtime exception
when they are actually accessed (will not affect or abort
table loading.)
Defined and deployed a new OSL interface,
acpi_os_validate_interface(). This interface allows the host OS
to match the various "optional" interface/behavior strings
for the _OSI predefined control method as appropriate
(with assistance from Bjorn Helgaas.)
Restructured and corrected various problems in the
exception handling code paths within DsCallControlMethod
and DsTerminateControlMethod in dsmethod (with assistance
from Takayoshi Kochi.)
Modified the Linux source converter to ignore quoted string
literals while converting identifiers from mixed to lower
case. This will correct problems with the disassembler
and other areas where such strings must not be modified.
The ACPI_FUNCTION_* macros no longer require quotes around
the function name. This allows the Linux source converter
to convert the names, now that the converter ignores
quoted strings.
Signed-off-by: Bob Moore <robert.moore@intel.com>
Signed-off-by: Len Brown <len.brown@intel.com>
2006-04-22 01:15:00 +04:00
|
|
|
* DESCRIPTION: Add a mutex to the "AcquiredMutex" list for this walk
|
2005-04-17 02:20:36 +04:00
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
2005-04-19 06:49:35 +04:00
|
|
|
static void
|
2005-08-05 08:44:28 +04:00
|
|
|
acpi_ex_link_mutex(union acpi_operand_object *obj_desc,
|
|
|
|
struct acpi_thread_state *thread)
|
2005-04-17 02:20:36 +04:00
|
|
|
{
|
2005-08-05 08:44:28 +04:00
|
|
|
union acpi_operand_object *list_head;
|
2005-04-17 02:20:36 +04:00
|
|
|
|
|
|
|
list_head = thread->acquired_mutex_list;
|
|
|
|
|
|
|
|
/* This object will be the first object in the list */
|
|
|
|
|
|
|
|
obj_desc->mutex.prev = NULL;
|
|
|
|
obj_desc->mutex.next = list_head;
|
|
|
|
|
|
|
|
/* Update old first object to point back to this object */
|
|
|
|
|
|
|
|
if (list_head) {
|
|
|
|
list_head->mutex.prev = obj_desc;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Update list head */
|
|
|
|
|
|
|
|
thread->acquired_mutex_list = obj_desc;
|
|
|
|
}
|
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_ex_acquire_mutex_object
|
|
|
|
*
|
2010-04-01 07:04:54 +04:00
|
|
|
* PARAMETERS: Timeout - Timeout in milliseconds
|
2008-04-10 19:06:37 +04:00
|
|
|
* obj_desc - Mutex object
|
2010-04-01 07:04:54 +04:00
|
|
|
* thread_id - Current thread state
|
2008-04-10 19:06:37 +04:00
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
2008-04-10 19:06:37 +04:00
|
|
|
* DESCRIPTION: Acquire an AML mutex, low-level interface. Provides a common
|
|
|
|
* path that supports multiple acquires by the same thread.
|
|
|
|
*
|
|
|
|
* MUTEX: Interpreter must be locked
|
|
|
|
*
|
|
|
|
* NOTE: This interface is called from three places:
|
|
|
|
* 1) From acpi_ex_acquire_mutex, via an AML Acquire() operator
|
|
|
|
* 2) From acpi_ex_acquire_global_lock when an AML Field access requires the
|
|
|
|
* global lock
|
|
|
|
* 3) From the external interface, acpi_acquire_global_lock
|
2008-04-10 19:06:37 +04:00
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
acpi_status
|
|
|
|
acpi_ex_acquire_mutex_object(u16 timeout,
|
|
|
|
union acpi_operand_object *obj_desc,
|
|
|
|
acpi_thread_id thread_id)
|
|
|
|
{
|
|
|
|
acpi_status status;
|
|
|
|
|
|
|
|
ACPI_FUNCTION_TRACE_PTR(ex_acquire_mutex_object, obj_desc);
|
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
if (!obj_desc) {
|
|
|
|
return_ACPI_STATUS(AE_BAD_PARAMETER);
|
|
|
|
}
|
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
/* Support for multiple acquires by the owning thread */
|
|
|
|
|
|
|
|
if (obj_desc->mutex.thread_id == thread_id) {
|
|
|
|
/*
|
|
|
|
* The mutex is already owned by this thread, just increment the
|
|
|
|
* acquisition depth
|
|
|
|
*/
|
|
|
|
obj_desc->mutex.acquisition_depth++;
|
|
|
|
return_ACPI_STATUS(AE_OK);
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Acquire the mutex, wait if necessary. Special case for Global Lock */
|
|
|
|
|
|
|
|
if (obj_desc == acpi_gbl_global_lock_mutex) {
|
|
|
|
status = acpi_ev_acquire_global_lock(timeout);
|
|
|
|
} else {
|
|
|
|
status = acpi_ex_system_wait_mutex(obj_desc->mutex.os_mutex,
|
|
|
|
timeout);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (ACPI_FAILURE(status)) {
|
|
|
|
|
|
|
|
/* Includes failure from a timeout on time_desc */
|
|
|
|
|
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
/* Acquired the mutex: update mutex object */
|
2008-04-10 19:06:37 +04:00
|
|
|
|
|
|
|
obj_desc->mutex.thread_id = thread_id;
|
|
|
|
obj_desc->mutex.acquisition_depth = 1;
|
|
|
|
obj_desc->mutex.original_sync_level = 0;
|
|
|
|
obj_desc->mutex.owner_thread = NULL; /* Used only for AML Acquire() */
|
|
|
|
|
|
|
|
return_ACPI_STATUS(AE_OK);
|
|
|
|
}
|
|
|
|
|
2005-04-17 02:20:36 +04:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_ex_acquire_mutex
|
|
|
|
*
|
2005-04-19 06:49:35 +04:00
|
|
|
* PARAMETERS: time_desc - Timeout integer
|
|
|
|
* obj_desc - Mutex object
|
|
|
|
* walk_state - Current method execution state
|
2005-04-17 02:20:36 +04:00
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
|
|
|
* DESCRIPTION: Acquire an AML mutex
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
acpi_status
|
2005-08-05 08:44:28 +04:00
|
|
|
acpi_ex_acquire_mutex(union acpi_operand_object *time_desc,
|
|
|
|
union acpi_operand_object *obj_desc,
|
|
|
|
struct acpi_walk_state *walk_state)
|
2005-04-17 02:20:36 +04:00
|
|
|
{
|
2005-08-05 08:44:28 +04:00
|
|
|
acpi_status status;
|
2005-04-17 02:20:36 +04:00
|
|
|
|
ACPI: ACPICA 20060421
Removed a device initialization optimization introduced in
20051216 where the _STA method was not run unless an _INI
was also present for the same device. This optimization
could cause problems because it could allow _INI methods
to be run within a not-present device subtree (If a
not-present device had no _INI, _STA would not be run,
the not-present status would not be discovered, and the
children of the device would be incorrectly traversed.)
Implemented a new _STA optimization where namespace
subtrees that do not contain _INI are identified and
ignored during device initialization. Selectively running
_STA can significantly improve boot time on large machines
(with assistance from Len Brown.)
Implemented support for the device initialization case
where the returned _STA flags indicate a device not-present
but functioning. In this case, _INI is not run, but the
device children are examined for presence, as per the
ACPI specification.
Implemented an additional change to the IndexField support
in order to conform to MS behavior. The value written to
the Index Register is not simply a byte offset, it is a
byte offset in units of the access width of the parent
Index Field. (Fiodor Suietov)
Defined and deployed a new OSL interface,
acpi_os_validate_address(). This interface is called during
the creation of all AML operation regions, and allows
the host OS to exert control over what addresses it will
allow the AML code to access. Operation Regions whose
addresses are disallowed will cause a runtime exception
when they are actually accessed (will not affect or abort
table loading.)
Defined and deployed a new OSL interface,
acpi_os_validate_interface(). This interface allows the host OS
to match the various "optional" interface/behavior strings
for the _OSI predefined control method as appropriate
(with assistance from Bjorn Helgaas.)
Restructured and corrected various problems in the
exception handling code paths within DsCallControlMethod
and DsTerminateControlMethod in dsmethod (with assistance
from Takayoshi Kochi.)
Modified the Linux source converter to ignore quoted string
literals while converting identifiers from mixed to lower
case. This will correct problems with the disassembler
and other areas where such strings must not be modified.
The ACPI_FUNCTION_* macros no longer require quotes around
the function name. This allows the Linux source converter
to convert the names, now that the converter ignores
quoted strings.
Signed-off-by: Bob Moore <robert.moore@intel.com>
Signed-off-by: Len Brown <len.brown@intel.com>
2006-04-22 01:15:00 +04:00
|
|
|
ACPI_FUNCTION_TRACE_PTR(ex_acquire_mutex, obj_desc);
|
2005-04-17 02:20:36 +04:00
|
|
|
|
|
|
|
if (!obj_desc) {
|
2005-08-05 08:44:28 +04:00
|
|
|
return_ACPI_STATUS(AE_BAD_PARAMETER);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
2010-04-01 07:04:54 +04:00
|
|
|
/* Must have a valid thread state struct */
|
2005-04-17 02:20:36 +04:00
|
|
|
|
|
|
|
if (!walk_state->thread) {
|
2006-01-28 00:43:00 +03:00
|
|
|
ACPI_ERROR((AE_INFO,
|
|
|
|
"Cannot acquire Mutex [%4.4s], null thread info",
|
|
|
|
acpi_ut_get_node_name(obj_desc->mutex.node)));
|
2005-08-05 08:44:28 +04:00
|
|
|
return_ACPI_STATUS(AE_AML_INTERNAL);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
2008-04-10 19:06:37 +04:00
|
|
|
* Current sync level must be less than or equal to the sync level of the
|
2006-06-24 01:04:00 +04:00
|
|
|
* mutex. This mechanism provides some deadlock prevention
|
2005-04-17 02:20:36 +04:00
|
|
|
*/
|
|
|
|
if (walk_state->thread->current_sync_level > obj_desc->mutex.sync_level) {
|
2006-01-28 00:43:00 +03:00
|
|
|
ACPI_ERROR((AE_INFO,
|
2010-03-05 12:56:40 +03:00
|
|
|
"Cannot acquire Mutex [%4.4s], current SyncLevel is too large (%u)",
|
2006-06-24 01:04:00 +04:00
|
|
|
acpi_ut_get_node_name(obj_desc->mutex.node),
|
|
|
|
walk_state->thread->current_sync_level));
|
2005-08-05 08:44:28 +04:00
|
|
|
return_ACPI_STATUS(AE_AML_MUTEX_ORDER);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
status = acpi_ex_acquire_mutex_object((u16) time_desc->integer.value,
|
|
|
|
obj_desc,
|
|
|
|
walk_state->thread->thread_id);
|
|
|
|
if (ACPI_SUCCESS(status) && obj_desc->mutex.acquisition_depth == 1) {
|
2008-04-10 19:06:37 +04:00
|
|
|
|
|
|
|
/* Save Thread object, original/current sync levels */
|
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
obj_desc->mutex.owner_thread = walk_state->thread;
|
|
|
|
obj_desc->mutex.original_sync_level =
|
|
|
|
walk_state->thread->current_sync_level;
|
|
|
|
walk_state->thread->current_sync_level =
|
|
|
|
obj_desc->mutex.sync_level;
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
/* Link the mutex to the current thread for force-unlock at method exit */
|
|
|
|
|
|
|
|
acpi_ex_link_mutex(obj_desc, walk_state->thread);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
2007-02-02 19:48:18 +03:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_ex_release_mutex_object
|
|
|
|
*
|
|
|
|
* PARAMETERS: obj_desc - The object descriptor for this op
|
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
|
|
|
* DESCRIPTION: Release a previously acquired Mutex, low level interface.
|
2008-04-10 19:06:37 +04:00
|
|
|
* Provides a common path that supports multiple releases (after
|
|
|
|
* previous multiple acquires) by the same thread.
|
|
|
|
*
|
|
|
|
* MUTEX: Interpreter must be locked
|
|
|
|
*
|
|
|
|
* NOTE: This interface is called from three places:
|
|
|
|
* 1) From acpi_ex_release_mutex, via an AML Acquire() operator
|
|
|
|
* 2) From acpi_ex_release_global_lock when an AML Field access requires the
|
|
|
|
* global lock
|
|
|
|
* 3) From the external interface, acpi_release_global_lock
|
2008-04-10 19:06:37 +04:00
|
|
|
*
|
|
|
|
******************************************************************************/
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
acpi_status acpi_ex_release_mutex_object(union acpi_operand_object *obj_desc)
|
|
|
|
{
|
|
|
|
acpi_status status = AE_OK;
|
2006-10-02 08:00:00 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
ACPI_FUNCTION_TRACE(ex_release_mutex_object);
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
if (obj_desc->mutex.acquisition_depth == 0) {
|
|
|
|
return (AE_NOT_ACQUIRED);
|
|
|
|
}
|
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
/* Match multiple Acquires with multiple Releases */
|
|
|
|
|
|
|
|
obj_desc->mutex.acquisition_depth--;
|
|
|
|
if (obj_desc->mutex.acquisition_depth != 0) {
|
|
|
|
|
|
|
|
/* Just decrement the depth and return */
|
|
|
|
|
|
|
|
return_ACPI_STATUS(AE_OK);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
if (obj_desc->mutex.owner_thread) {
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
/* Unlink the mutex from the owner's list */
|
|
|
|
|
|
|
|
acpi_ex_unlink_mutex(obj_desc);
|
|
|
|
obj_desc->mutex.owner_thread = NULL;
|
|
|
|
}
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
/* Release the mutex, special case for Global Lock */
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
if (obj_desc == acpi_gbl_global_lock_mutex) {
|
|
|
|
status = acpi_ev_release_global_lock();
|
|
|
|
} else {
|
|
|
|
acpi_os_release_mutex(obj_desc->mutex.os_mutex);
|
|
|
|
}
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
/* Clear mutex info */
|
|
|
|
|
2010-09-15 09:55:13 +04:00
|
|
|
obj_desc->mutex.thread_id = 0;
|
2008-04-10 19:06:37 +04:00
|
|
|
return_ACPI_STATUS(status);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_ex_release_mutex
|
|
|
|
*
|
|
|
|
* PARAMETERS: obj_desc - The object descriptor for this op
|
2005-04-19 06:49:35 +04:00
|
|
|
* walk_state - Current method execution state
|
2005-04-17 02:20:36 +04:00
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
|
|
|
* DESCRIPTION: Release a previously acquired Mutex.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
acpi_status
|
2005-08-05 08:44:28 +04:00
|
|
|
acpi_ex_release_mutex(union acpi_operand_object *obj_desc,
|
|
|
|
struct acpi_walk_state *walk_state)
|
2005-04-17 02:20:36 +04:00
|
|
|
{
|
2007-02-02 19:48:18 +03:00
|
|
|
acpi_status status = AE_OK;
|
2009-05-21 06:02:34 +04:00
|
|
|
u8 previous_sync_level;
|
2010-03-05 12:59:54 +03:00
|
|
|
struct acpi_thread_state *owner_thread;
|
2005-04-17 02:20:36 +04:00
|
|
|
|
ACPI: ACPICA 20060421
Removed a device initialization optimization introduced in
20051216 where the _STA method was not run unless an _INI
was also present for the same device. This optimization
could cause problems because it could allow _INI methods
to be run within a not-present device subtree (If a
not-present device had no _INI, _STA would not be run,
the not-present status would not be discovered, and the
children of the device would be incorrectly traversed.)
Implemented a new _STA optimization where namespace
subtrees that do not contain _INI are identified and
ignored during device initialization. Selectively running
_STA can significantly improve boot time on large machines
(with assistance from Len Brown.)
Implemented support for the device initialization case
where the returned _STA flags indicate a device not-present
but functioning. In this case, _INI is not run, but the
device children are examined for presence, as per the
ACPI specification.
Implemented an additional change to the IndexField support
in order to conform to MS behavior. The value written to
the Index Register is not simply a byte offset, it is a
byte offset in units of the access width of the parent
Index Field. (Fiodor Suietov)
Defined and deployed a new OSL interface,
acpi_os_validate_address(). This interface is called during
the creation of all AML operation regions, and allows
the host OS to exert control over what addresses it will
allow the AML code to access. Operation Regions whose
addresses are disallowed will cause a runtime exception
when they are actually accessed (will not affect or abort
table loading.)
Defined and deployed a new OSL interface,
acpi_os_validate_interface(). This interface allows the host OS
to match the various "optional" interface/behavior strings
for the _OSI predefined control method as appropriate
(with assistance from Bjorn Helgaas.)
Restructured and corrected various problems in the
exception handling code paths within DsCallControlMethod
and DsTerminateControlMethod in dsmethod (with assistance
from Takayoshi Kochi.)
Modified the Linux source converter to ignore quoted string
literals while converting identifiers from mixed to lower
case. This will correct problems with the disassembler
and other areas where such strings must not be modified.
The ACPI_FUNCTION_* macros no longer require quotes around
the function name. This allows the Linux source converter
to convert the names, now that the converter ignores
quoted strings.
Signed-off-by: Bob Moore <robert.moore@intel.com>
Signed-off-by: Len Brown <len.brown@intel.com>
2006-04-22 01:15:00 +04:00
|
|
|
ACPI_FUNCTION_TRACE(ex_release_mutex);
|
2005-04-17 02:20:36 +04:00
|
|
|
|
|
|
|
if (!obj_desc) {
|
2005-08-05 08:44:28 +04:00
|
|
|
return_ACPI_STATUS(AE_BAD_PARAMETER);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
2010-03-05 12:59:54 +03:00
|
|
|
owner_thread = obj_desc->mutex.owner_thread;
|
|
|
|
|
2005-04-17 02:20:36 +04:00
|
|
|
/* The mutex must have been previously acquired in order to release it */
|
|
|
|
|
2010-03-05 12:59:54 +03:00
|
|
|
if (!owner_thread) {
|
2006-01-28 00:43:00 +03:00
|
|
|
ACPI_ERROR((AE_INFO,
|
|
|
|
"Cannot release Mutex [%4.4s], not acquired",
|
|
|
|
acpi_ut_get_node_name(obj_desc->mutex.node)));
|
2005-08-05 08:44:28 +04:00
|
|
|
return_ACPI_STATUS(AE_AML_MUTEX_NOT_ACQUIRED);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
2010-02-03 01:37:56 +03:00
|
|
|
/* Must have a valid thread. */
|
2009-12-11 10:31:40 +03:00
|
|
|
if (!walk_state->thread) {
|
|
|
|
ACPI_ERROR((AE_INFO,
|
|
|
|
"Cannot release Mutex [%4.4s], null thread info",
|
|
|
|
acpi_ut_get_node_name(obj_desc->mutex.node)));
|
|
|
|
return_ACPI_STATUS(AE_AML_INTERNAL);
|
|
|
|
}
|
|
|
|
|
2005-04-17 02:20:36 +04:00
|
|
|
/*
|
|
|
|
* The Mutex is owned, but this thread must be the owner.
|
|
|
|
* Special case for Global Lock, any thread can release
|
|
|
|
*/
|
2010-03-05 12:59:54 +03:00
|
|
|
if ((owner_thread->thread_id != walk_state->thread->thread_id) &&
|
|
|
|
(obj_desc != acpi_gbl_global_lock_mutex)) {
|
2006-01-28 00:43:00 +03:00
|
|
|
ACPI_ERROR((AE_INFO,
|
2010-09-15 09:55:13 +04:00
|
|
|
"Thread %u cannot release Mutex [%4.4s] acquired by thread %u",
|
|
|
|
(u32)walk_state->thread->thread_id,
|
2006-01-28 00:43:00 +03:00
|
|
|
acpi_ut_get_node_name(obj_desc->mutex.node),
|
2010-09-15 09:55:13 +04:00
|
|
|
(u32)owner_thread->thread_id));
|
2005-08-05 08:44:28 +04:00
|
|
|
return_ACPI_STATUS(AE_AML_NOT_OWNER);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
2009-05-21 06:04:33 +04:00
|
|
|
* The sync level of the mutex must be equal to the current sync level. In
|
|
|
|
* other words, the current level means that at least one mutex at that
|
|
|
|
* level is currently being held. Attempting to release a mutex of a
|
|
|
|
* different level can only mean that the mutex ordering rule is being
|
|
|
|
* violated. This behavior is clarified in ACPI 4.0 specification.
|
2005-04-17 02:20:36 +04:00
|
|
|
*/
|
2010-03-05 12:59:54 +03:00
|
|
|
if (obj_desc->mutex.sync_level != owner_thread->current_sync_level) {
|
2006-01-28 00:43:00 +03:00
|
|
|
ACPI_ERROR((AE_INFO,
|
2010-03-05 12:56:40 +03:00
|
|
|
"Cannot release Mutex [%4.4s], SyncLevel mismatch: mutex %u current %u",
|
2008-04-10 19:06:37 +04:00
|
|
|
acpi_ut_get_node_name(obj_desc->mutex.node),
|
|
|
|
obj_desc->mutex.sync_level,
|
|
|
|
walk_state->thread->current_sync_level));
|
2005-08-05 08:44:28 +04:00
|
|
|
return_ACPI_STATUS(AE_AML_MUTEX_ORDER);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
2009-05-21 06:02:34 +04:00
|
|
|
/*
|
|
|
|
* Get the previous sync_level from the head of the acquired mutex list.
|
|
|
|
* This handles the case where several mutexes at the same level have been
|
|
|
|
* acquired, but are not released in reverse order.
|
|
|
|
*/
|
|
|
|
previous_sync_level =
|
2010-03-05 12:59:54 +03:00
|
|
|
owner_thread->acquired_mutex_list->mutex.original_sync_level;
|
2009-05-21 06:02:34 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
status = acpi_ex_release_mutex_object(obj_desc);
|
2009-05-21 06:04:33 +04:00
|
|
|
if (ACPI_FAILURE(status)) {
|
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
if (obj_desc->mutex.acquisition_depth == 0) {
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2009-05-21 06:04:33 +04:00
|
|
|
/* Restore the previous sync_level */
|
2008-04-10 19:06:37 +04:00
|
|
|
|
2010-03-05 12:59:54 +03:00
|
|
|
owner_thread->current_sync_level = previous_sync_level;
|
2008-04-10 19:06:37 +04:00
|
|
|
}
|
2010-04-01 07:04:54 +04:00
|
|
|
|
2005-08-05 08:44:28 +04:00
|
|
|
return_ACPI_STATUS(status);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_ex_release_all_mutexes
|
|
|
|
*
|
2010-04-01 07:04:54 +04:00
|
|
|
* PARAMETERS: Thread - Current executing thread object
|
2005-04-17 02:20:36 +04:00
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
2005-04-19 06:49:35 +04:00
|
|
|
* DESCRIPTION: Release all mutexes held by this thread
|
2005-04-17 02:20:36 +04:00
|
|
|
*
|
2007-02-02 19:48:21 +03:00
|
|
|
* NOTE: This function is called as the thread is exiting the interpreter.
|
|
|
|
* Mutexes are not released when an individual control method is exited, but
|
|
|
|
* only when the parent thread actually exits the interpreter. This allows one
|
|
|
|
* method to acquire a mutex, and a different method to release it, as long as
|
|
|
|
* this is performed underneath a single parent control method.
|
|
|
|
*
|
2005-04-17 02:20:36 +04:00
|
|
|
******************************************************************************/
|
|
|
|
|
2005-08-05 08:44:28 +04:00
|
|
|
void acpi_ex_release_all_mutexes(struct acpi_thread_state *thread)
|
2005-04-17 02:20:36 +04:00
|
|
|
{
|
2005-08-05 08:44:28 +04:00
|
|
|
union acpi_operand_object *next = thread->acquired_mutex_list;
|
2007-02-02 19:48:18 +03:00
|
|
|
union acpi_operand_object *obj_desc;
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2005-08-05 08:44:28 +04:00
|
|
|
ACPI_FUNCTION_ENTRY();
|
2005-04-17 02:20:36 +04:00
|
|
|
|
|
|
|
/* Traverse the list of owned mutexes, releasing each one */
|
|
|
|
|
|
|
|
while (next) {
|
2007-02-02 19:48:18 +03:00
|
|
|
obj_desc = next;
|
|
|
|
next = obj_desc->mutex.next;
|
|
|
|
|
|
|
|
obj_desc->mutex.prev = NULL;
|
|
|
|
obj_desc->mutex.next = NULL;
|
2007-02-02 19:48:21 +03:00
|
|
|
obj_desc->mutex.acquisition_depth = 0;
|
2007-02-02 19:48:18 +03:00
|
|
|
|
|
|
|
/* Release the mutex, special case for Global Lock */
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2008-04-10 19:06:37 +04:00
|
|
|
if (obj_desc == acpi_gbl_global_lock_mutex) {
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2007-02-02 19:48:18 +03:00
|
|
|
/* Ignore errors */
|
2005-04-17 02:20:36 +04:00
|
|
|
|
2007-02-02 19:48:18 +03:00
|
|
|
(void)acpi_ev_release_global_lock();
|
|
|
|
} else {
|
|
|
|
acpi_os_release_mutex(obj_desc->mutex.os_mutex);
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
/* Mark mutex unowned */
|
|
|
|
|
2007-05-10 07:01:59 +04:00
|
|
|
obj_desc->mutex.owner_thread = NULL;
|
2010-09-15 09:55:13 +04:00
|
|
|
obj_desc->mutex.thread_id = 0;
|
2005-04-17 02:20:36 +04:00
|
|
|
|
|
|
|
/* Update Thread sync_level (Last mutex is the important one) */
|
|
|
|
|
2007-02-02 19:48:18 +03:00
|
|
|
thread->current_sync_level =
|
|
|
|
obj_desc->mutex.original_sync_level;
|
2005-04-17 02:20:36 +04:00
|
|
|
}
|
|
|
|
}
|