mirror of
https://github.com/torvalds/linux.git
synced 2024-12-24 11:51:27 +00:00
de56ba95e8
ACPICA commit 0e24fb67cde08d7df7671d7d7b183490dc79707e The MLC (Module Level Code) is an ACPICA terminology describing the AML code out of any control method, its support is an indication of the interpreter behavior during the table loading. The original implementation of MLC in ACPICA had several issues: 1. Out of any control method, besides of the object creating opcodes, only the code blocks wrapped by "If/Else/While" opcodes were supported. 2. The supported MLC code blocks were executed after loading the table rather than being executed right in place. ============================================================ The demo of this order issue is as follows: Name (OBJ1, 1) If (CND1 == 1) { Name (OBJ2, 2) } Name (OBJ3, 3) The original MLC support created OBJ2 after OBJ3's creation. ============================================================ Other than these limitations, MLC support in ACPICA looks correct. And supporting this should be easy/natural for ACPICA, but enabling of this was blocked by some ACPICA internal and OSPM specific initialization order issues we've fixed recently. The wrong support started from the following false bug fixing commit: Commit:7f0c826a43
Subject: ACPICA: Add support for module-level executable AML code Commit:9a884ab64a
Subject: ACPICA: Add additional module-level code support ... We can confirm Windows interpreter behavior via reverse engineering means. It can be proven that not only If/Else/While wrapped code blocks, all opcodes can be executed at the module level, including operation region accesses. And it can be proven that the MLC should be executed right in place, not in such a deferred way executed after loading the table. And the above facts indeed reflect the spec words around ACPI definition block tables (DSDT/SSDT/...), the entire table and the Scope object is defined by the AML specification in BNF style as: AMLCode := def_block_header term_list def_scope := scope_op pkg_length name_string term_list The bodies of the scope opening terms (AMLCode/Scope) are all term_list, thus the table loading should be no difference than the control method evaluations as the body of the Method is also defined by the AML specification as term_list: def_method := method_op pkg_length name_string method_flags term_list The only difference is: after evaluating control method, created named objects may be freed due to no reference, while named objects created by the table loading should only be freed after unloading the table. So this patch follows the spec and the de-facto standard behavior, enables the new grammar (term_list) for the table loading. By doing so, beyond the fixes to the above issues, we can see additional differences comparing to the old grammar based table loading: 1. Originally, beyond the scope opening terms (AMLCode/Scope), If/Else/While wrapped code blocks under the scope creating terms (Device/power_resource/Processor/thermal_zone) are also supported as deferred MLC, which violates the spec defined grammar where object_list is enforced. With MLC support improved as non-deferred, the interpreter parses such scope creating terms as term_list rather object_list like the scope opening terms. After probing the Windows behavior and proving that it also parses these terms as term_list, we submitted an ECR (Engineering Change Request) to the ASWG (ACPI Specification Working Group) to clarify this. The ECR is titled as "ASL Grammar Clarification for Executable AML Opcodes" and has been accepted by the ASWG. The new grammar will appear in ACPI specification 6.2. 2. Originally, Buffer/Package/operation_region/create_XXXField/bank_field arguments are evaluated in a deferred way after loading the table. With MLC support improved, they are also parsed right in place during the table loading. This is also Windows compliant and the only difference is the removal of the debugging messages implemented before acpi_ds_execute_arguments(), see Link # [1] for the details. A previous commit should have ensured that acpi_check_address_range() won't regress. Note that enabling this feature may cause regressions due to long term Linux ACPI support on top of the wrong grammar. So this patch also prepares a global option to be used to roll back to the old grammar during the period between a regression is reported and the regression is root-cause-fixed. Lv Zheng. Link: https://bugzilla.kernel.org/show_bug.cgi?id=112911 # [1] Link: https://bugzilla.kernel.org/show_bug.cgi?id=117671 # [1] Link: https://bugzilla.kernel.org/show_bug.cgi?id=153541 # [1] Link: https://github.com/acpica/acpica/issues/122 Link: https://bugs.acpica.org/show_bug.cgi?id=963 Link: https://github.com/acpica/acpica/commit/0e24fb67 Reported-and-tested-by: Chris Bainbridge <chris.bainbridge@gmail.com> Reported-by: Ehsan <dashesy@gmail.com> Reported-and-tested-by: Dutch Guy <lucht_piloot@gmx.net> Tested-by: Mika Westerberg <mika.westerberg@linux.intel.com> Signed-off-by: Lv Zheng <lv.zheng@intel.com> Signed-off-by: Bob Moore <robert.moore@intel.com> Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
346 lines
10 KiB
C
346 lines
10 KiB
C
/******************************************************************************
|
|
*
|
|
* Module Name: nsload - namespace loading/expanding/contracting procedures
|
|
*
|
|
*****************************************************************************/
|
|
|
|
/*
|
|
* Copyright (C) 2000 - 2016, Intel Corp.
|
|
* 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>
|
|
#include "accommon.h"
|
|
#include "acnamesp.h"
|
|
#include "acdispat.h"
|
|
#include "actables.h"
|
|
|
|
#define _COMPONENT ACPI_NAMESPACE
|
|
ACPI_MODULE_NAME("nsload")
|
|
|
|
/* Local prototypes */
|
|
#ifdef ACPI_FUTURE_IMPLEMENTATION
|
|
acpi_status acpi_ns_unload_namespace(acpi_handle handle);
|
|
|
|
static acpi_status acpi_ns_delete_subtree(acpi_handle start_handle);
|
|
#endif
|
|
|
|
#ifndef ACPI_NO_METHOD_EXECUTION
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ns_load_table
|
|
*
|
|
* PARAMETERS: table_index - Index for table to be loaded
|
|
* node - Owning NS node
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: Load one ACPI table into the namespace
|
|
*
|
|
******************************************************************************/
|
|
|
|
acpi_status
|
|
acpi_ns_load_table(u32 table_index, struct acpi_namespace_node *node)
|
|
{
|
|
acpi_status status;
|
|
|
|
ACPI_FUNCTION_TRACE(ns_load_table);
|
|
|
|
/*
|
|
* Parse the table and load the namespace with all named
|
|
* objects found within. Control methods are NOT parsed
|
|
* at this time. In fact, the control methods cannot be
|
|
* parsed until the entire namespace is loaded, because
|
|
* if a control method makes a forward reference (call)
|
|
* to another control method, we can't continue parsing
|
|
* because we don't know how many arguments to parse next!
|
|
*/
|
|
status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
|
|
if (ACPI_FAILURE(status)) {
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
|
|
/* If table already loaded into namespace, just return */
|
|
|
|
if (acpi_tb_is_table_loaded(table_index)) {
|
|
status = AE_ALREADY_EXISTS;
|
|
goto unlock;
|
|
}
|
|
|
|
ACPI_DEBUG_PRINT((ACPI_DB_INFO,
|
|
"**** Loading table into namespace ****\n"));
|
|
|
|
status = acpi_tb_allocate_owner_id(table_index);
|
|
if (ACPI_FAILURE(status)) {
|
|
goto unlock;
|
|
}
|
|
|
|
status = acpi_ns_parse_table(table_index, node);
|
|
if (ACPI_SUCCESS(status)) {
|
|
acpi_tb_set_table_loaded_flag(table_index, TRUE);
|
|
} else {
|
|
/*
|
|
* On error, delete any namespace objects created by this table.
|
|
* We cannot initialize these objects, so delete them. There are
|
|
* a couple of expecially bad cases:
|
|
* AE_ALREADY_EXISTS - namespace collision.
|
|
* AE_NOT_FOUND - the target of a Scope operator does not
|
|
* exist. This target of Scope must already exist in the
|
|
* namespace, as per the ACPI specification.
|
|
*/
|
|
(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
|
|
acpi_ns_delete_namespace_by_owner(acpi_gbl_root_table_list.
|
|
tables[table_index].owner_id);
|
|
|
|
acpi_tb_release_owner_id(table_index);
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
|
|
unlock:
|
|
(void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
|
|
|
|
if (ACPI_FAILURE(status)) {
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
|
|
/*
|
|
* Now we can parse the control methods. We always parse
|
|
* them here for a sanity check, and if configured for
|
|
* just-in-time parsing, we delete the control method
|
|
* parse trees.
|
|
*/
|
|
ACPI_DEBUG_PRINT((ACPI_DB_INFO,
|
|
"**** Begin Table Object Initialization\n"));
|
|
|
|
status = acpi_ds_initialize_objects(table_index, node);
|
|
|
|
ACPI_DEBUG_PRINT((ACPI_DB_INFO,
|
|
"**** Completed Table Object Initialization\n"));
|
|
|
|
/*
|
|
* Execute any module-level code that was detected during the table load
|
|
* phase. Although illegal since ACPI 2.0, there are many machines that
|
|
* contain this type of code. Each block of detected executable AML code
|
|
* outside of any control method is wrapped with a temporary control
|
|
* method object and placed on a global list. The methods on this list
|
|
* are executed below.
|
|
*
|
|
* This case executes the module-level code for each table immediately
|
|
* after the table has been loaded. This provides compatibility with
|
|
* other ACPI implementations. Optionally, the execution can be deferred
|
|
* until later, see acpi_initialize_objects.
|
|
*/
|
|
if (!acpi_gbl_parse_table_as_term_list
|
|
&& !acpi_gbl_group_module_level_code) {
|
|
acpi_ns_exec_module_code_list();
|
|
}
|
|
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
|
|
#ifdef ACPI_OBSOLETE_FUNCTIONS
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_load_namespace
|
|
*
|
|
* PARAMETERS: None
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: Load the name space from what ever is pointed to by DSDT.
|
|
* (DSDT points to either the BIOS or a buffer.)
|
|
*
|
|
******************************************************************************/
|
|
|
|
acpi_status acpi_ns_load_namespace(void)
|
|
{
|
|
acpi_status status;
|
|
|
|
ACPI_FUNCTION_TRACE(acpi_load_name_space);
|
|
|
|
/* There must be at least a DSDT installed */
|
|
|
|
if (acpi_gbl_DSDT == NULL) {
|
|
ACPI_ERROR((AE_INFO, "DSDT is not in memory"));
|
|
return_ACPI_STATUS(AE_NO_ACPI_TABLES);
|
|
}
|
|
|
|
/*
|
|
* Load the namespace. The DSDT is required,
|
|
* but the SSDT and PSDT tables are optional.
|
|
*/
|
|
status = acpi_ns_load_table_by_type(ACPI_TABLE_ID_DSDT);
|
|
if (ACPI_FAILURE(status)) {
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
|
|
/* Ignore exceptions from these */
|
|
|
|
(void)acpi_ns_load_table_by_type(ACPI_TABLE_ID_SSDT);
|
|
(void)acpi_ns_load_table_by_type(ACPI_TABLE_ID_PSDT);
|
|
|
|
ACPI_DEBUG_PRINT_RAW((ACPI_DB_INIT,
|
|
"ACPI Namespace successfully loaded at root %p\n",
|
|
acpi_gbl_root_node));
|
|
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
#endif
|
|
|
|
#ifdef ACPI_FUTURE_IMPLEMENTATION
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ns_delete_subtree
|
|
*
|
|
* PARAMETERS: start_handle - Handle in namespace where search begins
|
|
*
|
|
* RETURNS Status
|
|
*
|
|
* DESCRIPTION: Walks the namespace starting at the given handle and deletes
|
|
* all objects, entries, and scopes in the entire subtree.
|
|
*
|
|
* Namespace/Interpreter should be locked or the subsystem should
|
|
* be in shutdown before this routine is called.
|
|
*
|
|
******************************************************************************/
|
|
|
|
static acpi_status acpi_ns_delete_subtree(acpi_handle start_handle)
|
|
{
|
|
acpi_status status;
|
|
acpi_handle child_handle;
|
|
acpi_handle parent_handle;
|
|
acpi_handle next_child_handle;
|
|
acpi_handle dummy;
|
|
u32 level;
|
|
|
|
ACPI_FUNCTION_TRACE(ns_delete_subtree);
|
|
|
|
parent_handle = start_handle;
|
|
child_handle = NULL;
|
|
level = 1;
|
|
|
|
/*
|
|
* Traverse the tree of objects until we bubble back up
|
|
* to where we started.
|
|
*/
|
|
while (level > 0) {
|
|
|
|
/* Attempt to get the next object in this scope */
|
|
|
|
status = acpi_get_next_object(ACPI_TYPE_ANY, parent_handle,
|
|
child_handle, &next_child_handle);
|
|
|
|
child_handle = next_child_handle;
|
|
|
|
/* Did we get a new object? */
|
|
|
|
if (ACPI_SUCCESS(status)) {
|
|
|
|
/* Check if this object has any children */
|
|
|
|
if (ACPI_SUCCESS
|
|
(acpi_get_next_object
|
|
(ACPI_TYPE_ANY, child_handle, NULL, &dummy))) {
|
|
/*
|
|
* There is at least one child of this object,
|
|
* visit the object
|
|
*/
|
|
level++;
|
|
parent_handle = child_handle;
|
|
child_handle = NULL;
|
|
}
|
|
} else {
|
|
/*
|
|
* No more children in this object, go back up to
|
|
* the object's parent
|
|
*/
|
|
level--;
|
|
|
|
/* Delete all children now */
|
|
|
|
acpi_ns_delete_children(child_handle);
|
|
|
|
child_handle = parent_handle;
|
|
status = acpi_get_parent(parent_handle, &parent_handle);
|
|
if (ACPI_FAILURE(status)) {
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Now delete the starting object, and we are done */
|
|
|
|
acpi_ns_remove_node(child_handle);
|
|
return_ACPI_STATUS(AE_OK);
|
|
}
|
|
|
|
/*******************************************************************************
|
|
*
|
|
* FUNCTION: acpi_ns_unload_name_space
|
|
*
|
|
* PARAMETERS: handle - Root of namespace subtree to be deleted
|
|
*
|
|
* RETURN: Status
|
|
*
|
|
* DESCRIPTION: Shrinks the namespace, typically in response to an undocking
|
|
* event. Deletes an entire subtree starting from (and
|
|
* including) the given handle.
|
|
*
|
|
******************************************************************************/
|
|
|
|
acpi_status acpi_ns_unload_namespace(acpi_handle handle)
|
|
{
|
|
acpi_status status;
|
|
|
|
ACPI_FUNCTION_TRACE(ns_unload_name_space);
|
|
|
|
/* Parameter validation */
|
|
|
|
if (!acpi_gbl_root_node) {
|
|
return_ACPI_STATUS(AE_NO_NAMESPACE);
|
|
}
|
|
|
|
if (!handle) {
|
|
return_ACPI_STATUS(AE_BAD_PARAMETER);
|
|
}
|
|
|
|
/* This function does the real work */
|
|
|
|
status = acpi_ns_delete_subtree(handle);
|
|
return_ACPI_STATUS(status);
|
|
}
|
|
#endif
|
|
#endif
|