2005-04-16 16:20:36 -06:00
|
|
|
/******************************************************************************
|
|
|
|
*
|
2013-04-11 18:24:53 -06:00
|
|
|
* Module Name: tbxface - ACPI table-oriented external interfaces
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
|
|
|
*****************************************************************************/
|
|
|
|
|
|
|
|
/*
|
2015-02-05 00:20:45 -07:00
|
|
|
* Copyright (C) 2000 - 2015, Intel Corp.
|
2005-04-16 16:20:36 -06: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.
|
|
|
|
*/
|
|
|
|
|
2013-10-28 19:29:51 -06:00
|
|
|
#define EXPORT_ACPI_INTERFACES
|
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
#include <acpi/acpi.h>
|
2009-01-08 22:30:03 -07:00
|
|
|
#include "accommon.h"
|
|
|
|
#include "actables.h"
|
2005-04-16 16:20:36 -06:00
|
|
|
|
|
|
|
#define _COMPONENT ACPI_TABLES
|
2005-08-04 22:44:28 -06:00
|
|
|
ACPI_MODULE_NAME("tbxface")
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:20 -07:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_allocate_root_table
|
|
|
|
*
|
|
|
|
* PARAMETERS: initial_table_count - Size of initial_table_array, in number of
|
|
|
|
* struct acpi_table_desc structures
|
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
2012-07-11 19:40:10 -06:00
|
|
|
* DESCRIPTION: Allocate a root table array. Used by iASL compiler and
|
2007-02-02 09:48:20 -07:00
|
|
|
* acpi_initialize_tables.
|
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
acpi_status acpi_allocate_root_table(u32 initial_table_count)
|
|
|
|
{
|
|
|
|
|
2010-04-26 21:16:14 -06:00
|
|
|
acpi_gbl_root_table_list.max_table_count = initial_table_count;
|
2007-02-02 09:48:20 -07:00
|
|
|
acpi_gbl_root_table_list.flags = ACPI_ROOT_ALLOW_RESIZE;
|
|
|
|
|
|
|
|
return (acpi_tb_resize_root_table_list());
|
|
|
|
}
|
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
2007-02-02 09:48:18 -07:00
|
|
|
* FUNCTION: acpi_initialize_tables
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
2007-02-02 09:48:18 -07:00
|
|
|
* PARAMETERS: initial_table_array - Pointer to an array of pre-allocated
|
|
|
|
* struct acpi_table_desc structures. If NULL, the
|
|
|
|
* array is dynamically allocated.
|
|
|
|
* initial_table_count - Size of initial_table_array, in number of
|
|
|
|
* struct acpi_table_desc structures
|
2013-04-11 18:24:53 -06:00
|
|
|
* allow_resize - Flag to tell Table Manager if resize of
|
2007-02-02 09:48:18 -07:00
|
|
|
* pre-allocated array is allowed. Ignored
|
|
|
|
* if initial_table_array is NULL.
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
2007-02-02 09:48:18 -07:00
|
|
|
* DESCRIPTION: Initialize the table manager, get the RSDP and RSDT/XSDT.
|
|
|
|
*
|
|
|
|
* NOTE: Allows static allocation of the initial table array in order
|
|
|
|
* to avoid the use of dynamic memory in confined environments
|
|
|
|
* such as the kernel boot sequence where it may not be available.
|
|
|
|
*
|
|
|
|
* If the host OS memory managers are initialized, use NULL for
|
|
|
|
* initial_table_array, and the table will be dynamically allocated.
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
|
|
|
******************************************************************************/
|
2007-02-02 09:48:18 -07:00
|
|
|
|
2007-02-02 09:48:19 -07:00
|
|
|
acpi_status __init
|
2007-02-02 09:48:20 -07:00
|
|
|
acpi_initialize_tables(struct acpi_table_desc * initial_table_array,
|
2007-02-02 09:48:18 -07:00
|
|
|
u32 initial_table_count, u8 allow_resize)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
2007-02-02 09:48:19 -07:00
|
|
|
acpi_physical_address rsdp_address;
|
2005-08-04 22:44:28 -06:00
|
|
|
acpi_status status;
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
ACPI_FUNCTION_TRACE(acpi_initialize_tables);
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
/*
|
2013-04-11 18:24:53 -06:00
|
|
|
* Setup the Root Table Array and allocate the table array
|
|
|
|
* if requested
|
2007-02-02 09:48:18 -07:00
|
|
|
*/
|
|
|
|
if (!initial_table_array) {
|
2007-02-02 09:48:20 -07:00
|
|
|
status = acpi_allocate_root_table(initial_table_count);
|
2007-02-02 09:48:18 -07:00
|
|
|
if (ACPI_FAILURE(status)) {
|
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
/* Root Table Array has been statically allocated by the host */
|
|
|
|
|
2015-07-01 00:45:11 -06:00
|
|
|
memset(initial_table_array, 0,
|
|
|
|
(acpi_size) initial_table_count *
|
|
|
|
sizeof(struct acpi_table_desc));
|
2007-02-02 09:48:19 -07:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
acpi_gbl_root_table_list.tables = initial_table_array;
|
2010-04-26 21:16:14 -06:00
|
|
|
acpi_gbl_root_table_list.max_table_count = initial_table_count;
|
2007-02-02 09:48:19 -07:00
|
|
|
acpi_gbl_root_table_list.flags = ACPI_ROOT_ORIGIN_UNKNOWN;
|
2007-02-02 09:48:18 -07:00
|
|
|
if (allow_resize) {
|
2007-02-02 09:48:19 -07:00
|
|
|
acpi_gbl_root_table_list.flags |=
|
|
|
|
ACPI_ROOT_ALLOW_RESIZE;
|
2007-02-02 09:48:18 -07:00
|
|
|
}
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:19 -07:00
|
|
|
/* Get the address of the RSDP */
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:19 -07:00
|
|
|
rsdp_address = acpi_os_get_root_pointer();
|
|
|
|
if (!rsdp_address) {
|
2007-02-02 09:48:18 -07:00
|
|
|
return_ACPI_STATUS(AE_NOT_FOUND);
|
|
|
|
}
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
/*
|
|
|
|
* Get the root table (RSDT or XSDT) and extract all entries to the local
|
|
|
|
* Root Table Array. This array contains the information of the RSDT/XSDT
|
|
|
|
* in a common, more useable format.
|
|
|
|
*/
|
2009-02-02 23:41:03 -07:00
|
|
|
status = acpi_tb_parse_root_table(rsdp_address);
|
2007-02-02 09:48:18 -07:00
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2013-10-28 19:30:10 -06:00
|
|
|
ACPI_EXPORT_SYMBOL_INIT(acpi_initialize_tables)
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_reallocate_root_table
|
|
|
|
*
|
|
|
|
* PARAMETERS: None
|
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
|
|
|
* DESCRIPTION: Reallocate Root Table List into dynamic memory. Copies the
|
|
|
|
* root list from the previously provided scratch area. Should
|
|
|
|
* be called once dynamic memory allocation is available in the
|
2012-09-13 10:29:06 -06:00
|
|
|
* kernel.
|
2007-02-02 09:48:18 -07:00
|
|
|
*
|
|
|
|
******************************************************************************/
|
2013-10-30 19:31:24 -06:00
|
|
|
acpi_status __init acpi_reallocate_root_table(void)
|
2007-02-02 09:48:18 -07:00
|
|
|
{
|
2012-09-13 10:29:06 -06:00
|
|
|
acpi_status status;
|
2007-02-02 09:48:18 -07:00
|
|
|
|
|
|
|
ACPI_FUNCTION_TRACE(acpi_reallocate_root_table);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Only reallocate the root table if the host provided a static buffer
|
|
|
|
* for the table array in the call to acpi_initialize_tables.
|
|
|
|
*/
|
2007-02-02 09:48:19 -07:00
|
|
|
if (acpi_gbl_root_table_list.flags & ACPI_ROOT_ORIGIN_ALLOCATED) {
|
2007-02-02 09:48:18 -07:00
|
|
|
return_ACPI_STATUS(AE_SUPPORT);
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
2012-09-13 10:29:06 -06:00
|
|
|
acpi_gbl_root_table_list.flags |= ACPI_ROOT_ALLOW_RESIZE;
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2012-09-13 10:29:06 -06:00
|
|
|
status = acpi_tb_resize_root_table_list();
|
|
|
|
return_ACPI_STATUS(status);
|
2007-02-02 09:48:18 -07:00
|
|
|
}
|
2007-05-09 21:34:35 -06:00
|
|
|
|
2013-10-28 19:30:10 -06:00
|
|
|
ACPI_EXPORT_SYMBOL_INIT(acpi_reallocate_root_table)
|
|
|
|
|
2009-02-18 00:03:30 -07:00
|
|
|
/*******************************************************************************
|
2007-02-02 09:48:18 -07:00
|
|
|
*
|
|
|
|
* FUNCTION: acpi_get_table_header
|
|
|
|
*
|
2012-07-11 19:40:10 -06:00
|
|
|
* PARAMETERS: signature - ACPI signature of needed table
|
|
|
|
* instance - Which instance (for SSDTs)
|
2007-02-02 09:48:22 -07:00
|
|
|
* out_table_header - The pointer to the table header to fill
|
2007-02-02 09:48:18 -07:00
|
|
|
*
|
|
|
|
* RETURN: Status and pointer to mapped table header
|
|
|
|
*
|
|
|
|
* DESCRIPTION: Finds an ACPI table header.
|
|
|
|
*
|
|
|
|
* NOTE: Caller is responsible in unmapping the header with
|
|
|
|
* acpi_os_unmap_memory
|
|
|
|
*
|
2009-02-18 00:03:30 -07:00
|
|
|
******************************************************************************/
|
2007-02-02 09:48:18 -07:00
|
|
|
acpi_status
|
|
|
|
acpi_get_table_header(char *signature,
|
2008-06-09 23:42:13 -06:00
|
|
|
u32 instance, struct acpi_table_header *out_table_header)
|
2007-02-02 09:48:18 -07:00
|
|
|
{
|
2014-04-03 22:38:18 -06:00
|
|
|
u32 i;
|
|
|
|
u32 j;
|
2007-02-02 09:48:22 -07:00
|
|
|
struct acpi_table_header *header;
|
2005-07-29 16:15:00 -06:00
|
|
|
|
2007-02-02 09:48:19 -07:00
|
|
|
/* Parameter validation */
|
|
|
|
|
|
|
|
if (!signature || !out_table_header) {
|
|
|
|
return (AE_BAD_PARAMETER);
|
|
|
|
}
|
|
|
|
|
2009-02-18 00:03:30 -07:00
|
|
|
/* Walk the root table list */
|
|
|
|
|
2010-04-26 21:16:14 -06:00
|
|
|
for (i = 0, j = 0; i < acpi_gbl_root_table_list.current_table_count;
|
|
|
|
i++) {
|
2007-02-02 09:48:18 -07:00
|
|
|
if (!ACPI_COMPARE_NAME
|
|
|
|
(&(acpi_gbl_root_table_list.tables[i].signature),
|
|
|
|
signature)) {
|
|
|
|
continue;
|
2005-07-29 16:15:00 -06:00
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
if (++j < instance) {
|
|
|
|
continue;
|
|
|
|
}
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:22 -07:00
|
|
|
if (!acpi_gbl_root_table_list.tables[i].pointer) {
|
2009-02-18 00:03:30 -07:00
|
|
|
if ((acpi_gbl_root_table_list.tables[i].flags &
|
|
|
|
ACPI_TABLE_ORIGIN_MASK) ==
|
2014-04-03 22:39:26 -06:00
|
|
|
ACPI_TABLE_ORIGIN_INTERNAL_PHYSICAL) {
|
2007-02-02 09:48:22 -07:00
|
|
|
header =
|
|
|
|
acpi_os_map_memory(acpi_gbl_root_table_list.
|
|
|
|
tables[i].address,
|
|
|
|
sizeof(struct
|
|
|
|
acpi_table_header));
|
|
|
|
if (!header) {
|
2012-10-30 20:26:01 -06:00
|
|
|
return (AE_NO_MEMORY);
|
2007-02-02 09:48:22 -07:00
|
|
|
}
|
2015-06-18 21:38:16 -06:00
|
|
|
|
2015-07-01 00:45:11 -06:00
|
|
|
memcpy(out_table_header, header,
|
|
|
|
sizeof(struct acpi_table_header));
|
2007-02-02 09:48:22 -07:00
|
|
|
acpi_os_unmap_memory(header,
|
|
|
|
sizeof(struct
|
|
|
|
acpi_table_header));
|
|
|
|
} else {
|
2012-10-30 20:26:01 -06:00
|
|
|
return (AE_NOT_FOUND);
|
2007-02-02 09:48:22 -07:00
|
|
|
}
|
|
|
|
} else {
|
2015-07-01 00:45:11 -06:00
|
|
|
memcpy(out_table_header,
|
|
|
|
acpi_gbl_root_table_list.tables[i].pointer,
|
|
|
|
sizeof(struct acpi_table_header));
|
2007-02-02 09:48:18 -07:00
|
|
|
}
|
|
|
|
return (AE_OK);
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
return (AE_NOT_FOUND);
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
ACPI_EXPORT_SYMBOL(acpi_get_table_header)
|
2006-10-02 22:00:00 -06:00
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
2009-02-07 16:39:41 -07:00
|
|
|
* FUNCTION: acpi_get_table_with_size
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
2012-07-11 19:40:10 -06:00
|
|
|
* PARAMETERS: signature - ACPI signature of needed table
|
|
|
|
* instance - Which instance (for SSDTs)
|
2007-02-02 09:48:18 -07:00
|
|
|
* out_table - Where the pointer to the table is returned
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
2013-04-11 18:24:53 -06:00
|
|
|
* RETURN: Status and pointer to the requested table
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
2013-04-11 18:24:53 -06:00
|
|
|
* DESCRIPTION: Finds and verifies an ACPI table. Table must be in the
|
|
|
|
* RSDT/XSDT.
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
2009-02-18 00:03:30 -07:00
|
|
|
******************************************************************************/
|
2007-02-02 09:48:18 -07:00
|
|
|
acpi_status
|
2009-02-07 16:39:41 -07:00
|
|
|
acpi_get_table_with_size(char *signature,
|
|
|
|
u32 instance, struct acpi_table_header **out_table,
|
|
|
|
acpi_size *tbl_size)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
2014-04-03 22:38:18 -06:00
|
|
|
u32 i;
|
|
|
|
u32 j;
|
2007-02-02 09:48:18 -07:00
|
|
|
acpi_status status;
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:19 -07:00
|
|
|
/* Parameter validation */
|
|
|
|
|
|
|
|
if (!signature || !out_table) {
|
|
|
|
return (AE_BAD_PARAMETER);
|
|
|
|
}
|
|
|
|
|
2009-02-18 00:03:30 -07:00
|
|
|
/* Walk the root table list */
|
|
|
|
|
2010-04-26 21:16:14 -06:00
|
|
|
for (i = 0, j = 0; i < acpi_gbl_root_table_list.current_table_count;
|
|
|
|
i++) {
|
2007-02-02 09:48:18 -07:00
|
|
|
if (!ACPI_COMPARE_NAME
|
|
|
|
(&(acpi_gbl_root_table_list.tables[i].signature),
|
|
|
|
signature)) {
|
|
|
|
continue;
|
|
|
|
}
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
if (++j < instance) {
|
|
|
|
continue;
|
|
|
|
}
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
status =
|
ACPICA: Tables: Clean up split INSTALLED/VALIDATED table state logics.
This patch is mainly a naming cleanup to clarify hidden logics, no
functional changes.
acpi_initialize_tables() is used by Linux to install table addresses for
early boot steps. During this stage, table addresses are mapped by
early_ioremap() mechanism which is different from the runtime IO mappings.
Thus it is not safe for ACPICA to keep mapped pointers in struct acpi_table_desc
structure during this stage.
In order to support this in ACPICA, table states are divided into
1. "INSTALLED" (where struct acpi_table_desc.Pointer is always NULL) and
2. "VALIDATED" (where struct acpi_table_desc.Pointer is always not NULL).
During acpi_initialize_tables(), table state are ensured to be "INSTALLED"
but not "VALIDATED". This logic is ensured by the original code in very
ambigious way. For example, currently acpi_tb_delete_table() is invoked in
some place to perform an uninstallation while it is invoked in other place
to perform an invalidation. They happen to work just because no one enters
the penalty where the 2 behaviours are not equivalent.
The naming cleanups are made in this patch:
A. For installation and validation:
There is code setting struct acpi_table_desc.Pointer first and delete it
immediately to keep the descriptor's state as "INSTALLED" during the
installation. This patch implements this in more direct way. After
applying it, struct acpi_table_desc.Pointer will never be set in
acpi_tb_install_table() and acpi_tb_override_table() as they are the only
functions invoked during acpi_initialize_tables(). This is achieved by:
1. Rename acpi_tb_verify_table() to acpi_tb_validate_table() to clarify this
change.
2. Rename acpi_tb_table_override() to acpi_tb_override_table() to keep nameing
consistencies as other APIs (verb. Table).
3. Stops setting struct acpi_table_desc.Pointer in acpi_tb_install_table() and
acpi_tb_table_override().
4. Introduce acpi_tb_acquire_table() to acquire the table pointer that is not
maintained in the struct acpi_table_desc of the global root table list and
rewrite acpi_tb_validate_table() using this new function to reduce
redundancies.
5. Replace the table pointer using the overridden table pointer in
acpi_tb_add_table(). As acpi_tb_add_table() is not invoked during early boot
stage, tables returned from this functions should be "VALIDATED". As
acpi_tb_override_table() is modified by this patch to return a "INSTALLED"
but not "VALIDATED" descriptor, to keep acpi_tb_add_table() unchanged,
struct acpi_table_desc.Pointer is filled in acpi_tb_add_table().
B. For invalidation and uninstallation:
The original code invalidate table by invoking acpi_tb_delete_table() here
and there, but actually this function should only be used to uninstall
tables. This can work just because its invocations are equivalent to
invalidation in some cases.
This patch splits acpi_tb_delete_table() into acpi_tb_invalidate_table() and
acpi_tb_uninstall_table() and cleans up the hidden logic using the new
APIs. This is achieved by:
1. Rename acpi_tb_delete_table() to acpi_tb_uninstall_table() as it is mainly
called before resetting struct acpi_table_desc.Address. Thus the table
descriptor is in "not INSTALLED" state. This patch enforces this by
setting struct acpi_table_desc.Address to NULL in this function.
2. Introduce acpi_tb_invalidate_table() to be the reversal of
acpi_tb_validate_table() and invoke it in acpi_tb_uninstall_table().
3. Introduce acpi_tb_release_table() to release the table pointer that is not
maintained in acpi_gbl_root_table_list and rewrite acpi_tb_invalidate_table()
using this new function to reduce redundancies.
After cleaning up, the maintainability of the internal APIs are also
improved:
1. acpi_tb_acquire_table: Acquire struct acpi_table_header according to
ACPI_TABLE_ORIGIN_xxx flags.
2. acpi_tb_release_table: Release struct acpi_table_header according to
ACPI_TABLE_ORIGIN_xxx flags.
3. acpi_tb_install_table: Make struct acpi_table_desc.Address not NULL according to
ACPI_TABLE_ORIGIN_xxx flags.
4. acpi_tb_uninstall_table: Make struct acpi_table_desc.Address NULL according to
ACPI_TABLE_ORIGIN_xxx flags.
5. acpi_tb_validate_table: Make struct acpi_table_desc.Pointer not NULL according to
ACPI_TABLE_ORIGIN_xxx flags.
6. acpi_tb_invalidate_table: Make struct acpi_table_desc.Pointer NULL according to
ACPI_TABLE_ORIGIN_xxx flags.
7. acpi_tb_override_table: Replace struct acpi_table_desc.Address and
struct acpi_table_desc.Flags. It only happens in
"INSTALLED" state.
The patch has been unit tested in acpi_exec by:
1. Initializing;
2. Executing exc_tbl ASLTS tests;
3. Executing "Load" command.
So that all original acpi_tb_install_table() and acpi_tb_override_table()
invocations are covered.
Known Issues:
1. Cleanup acpi_tb_add_table() to Kill Code Redundancies
Current implementation in acpi_tb_add_table() is not very clean, further
patch can rewrite acpi_tb_add_table() with ordered acpi_tb_install_table(),
acpi_tb_override_table() and acpi_tb_validate_table(). It is not done in this
patch so that it is easy for the reviewers to understand the changes in
this patch.
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>
2014-04-03 22:38:42 -06:00
|
|
|
acpi_tb_validate_table(&acpi_gbl_root_table_list.tables[i]);
|
2007-02-02 09:48:18 -07:00
|
|
|
if (ACPI_SUCCESS(status)) {
|
|
|
|
*out_table = acpi_gbl_root_table_list.tables[i].pointer;
|
2009-02-07 16:39:41 -07:00
|
|
|
*tbl_size = acpi_gbl_root_table_list.tables[i].length;
|
2007-02-02 09:48:18 -07:00
|
|
|
}
|
2006-07-07 18:44:38 -06:00
|
|
|
|
2007-02-02 09:48:19 -07:00
|
|
|
if (!acpi_gbl_permanent_mmap) {
|
2007-02-13 17:11:36 -07:00
|
|
|
acpi_gbl_root_table_list.tables[i].pointer = NULL;
|
2007-02-02 09:48:19 -07:00
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
return (status);
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
return (AE_NOT_FOUND);
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
2013-10-28 19:30:10 -06:00
|
|
|
|
2012-08-20 08:57:22 -06:00
|
|
|
ACPI_EXPORT_SYMBOL(acpi_get_table_with_size)
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2009-02-07 16:39:41 -07:00
|
|
|
acpi_status
|
|
|
|
acpi_get_table(char *signature,
|
|
|
|
u32 instance, struct acpi_table_header **out_table)
|
|
|
|
{
|
|
|
|
acpi_size tbl_size;
|
|
|
|
|
|
|
|
return acpi_get_table_with_size(signature,
|
|
|
|
instance, out_table, &tbl_size);
|
|
|
|
}
|
2013-10-28 19:30:10 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
ACPI_EXPORT_SYMBOL(acpi_get_table)
|
2006-10-02 22:00:00 -06:00
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
2007-02-02 09:48:18 -07:00
|
|
|
* FUNCTION: acpi_get_table_by_index
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
2007-02-02 09:48:18 -07:00
|
|
|
* PARAMETERS: table_index - Table index
|
2012-07-11 19:40:10 -06:00
|
|
|
* table - Where the pointer to the table is returned
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
2013-04-11 18:24:53 -06:00
|
|
|
* RETURN: Status and pointer to the requested table
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
2013-04-11 18:24:53 -06:00
|
|
|
* DESCRIPTION: Obtain a table by an index into the global table list. Used
|
|
|
|
* internally also.
|
2005-04-16 16:20:36 -06:00
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
acpi_status
|
2014-04-03 22:38:18 -06:00
|
|
|
acpi_get_table_by_index(u32 table_index, struct acpi_table_header ** table)
|
2005-04-16 16:20:36 -06:00
|
|
|
{
|
2005-08-04 22:44:28 -06:00
|
|
|
acpi_status status;
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
ACPI_FUNCTION_TRACE(acpi_get_table_by_index);
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:19 -07:00
|
|
|
/* Parameter validation */
|
|
|
|
|
|
|
|
if (!table) {
|
|
|
|
return_ACPI_STATUS(AE_BAD_PARAMETER);
|
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
(void)acpi_ut_acquire_mutex(ACPI_MTX_TABLES);
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
/* Validate index */
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2010-04-26 21:16:14 -06:00
|
|
|
if (table_index >= acpi_gbl_root_table_list.current_table_count) {
|
2007-02-02 09:48:18 -07:00
|
|
|
(void)acpi_ut_release_mutex(ACPI_MTX_TABLES);
|
2005-08-04 22:44:28 -06:00
|
|
|
return_ACPI_STATUS(AE_BAD_PARAMETER);
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
if (!acpi_gbl_root_table_list.tables[table_index].pointer) {
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
/* Table is not mapped, map it */
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
status =
|
ACPICA: Tables: Clean up split INSTALLED/VALIDATED table state logics.
This patch is mainly a naming cleanup to clarify hidden logics, no
functional changes.
acpi_initialize_tables() is used by Linux to install table addresses for
early boot steps. During this stage, table addresses are mapped by
early_ioremap() mechanism which is different from the runtime IO mappings.
Thus it is not safe for ACPICA to keep mapped pointers in struct acpi_table_desc
structure during this stage.
In order to support this in ACPICA, table states are divided into
1. "INSTALLED" (where struct acpi_table_desc.Pointer is always NULL) and
2. "VALIDATED" (where struct acpi_table_desc.Pointer is always not NULL).
During acpi_initialize_tables(), table state are ensured to be "INSTALLED"
but not "VALIDATED". This logic is ensured by the original code in very
ambigious way. For example, currently acpi_tb_delete_table() is invoked in
some place to perform an uninstallation while it is invoked in other place
to perform an invalidation. They happen to work just because no one enters
the penalty where the 2 behaviours are not equivalent.
The naming cleanups are made in this patch:
A. For installation and validation:
There is code setting struct acpi_table_desc.Pointer first and delete it
immediately to keep the descriptor's state as "INSTALLED" during the
installation. This patch implements this in more direct way. After
applying it, struct acpi_table_desc.Pointer will never be set in
acpi_tb_install_table() and acpi_tb_override_table() as they are the only
functions invoked during acpi_initialize_tables(). This is achieved by:
1. Rename acpi_tb_verify_table() to acpi_tb_validate_table() to clarify this
change.
2. Rename acpi_tb_table_override() to acpi_tb_override_table() to keep nameing
consistencies as other APIs (verb. Table).
3. Stops setting struct acpi_table_desc.Pointer in acpi_tb_install_table() and
acpi_tb_table_override().
4. Introduce acpi_tb_acquire_table() to acquire the table pointer that is not
maintained in the struct acpi_table_desc of the global root table list and
rewrite acpi_tb_validate_table() using this new function to reduce
redundancies.
5. Replace the table pointer using the overridden table pointer in
acpi_tb_add_table(). As acpi_tb_add_table() is not invoked during early boot
stage, tables returned from this functions should be "VALIDATED". As
acpi_tb_override_table() is modified by this patch to return a "INSTALLED"
but not "VALIDATED" descriptor, to keep acpi_tb_add_table() unchanged,
struct acpi_table_desc.Pointer is filled in acpi_tb_add_table().
B. For invalidation and uninstallation:
The original code invalidate table by invoking acpi_tb_delete_table() here
and there, but actually this function should only be used to uninstall
tables. This can work just because its invocations are equivalent to
invalidation in some cases.
This patch splits acpi_tb_delete_table() into acpi_tb_invalidate_table() and
acpi_tb_uninstall_table() and cleans up the hidden logic using the new
APIs. This is achieved by:
1. Rename acpi_tb_delete_table() to acpi_tb_uninstall_table() as it is mainly
called before resetting struct acpi_table_desc.Address. Thus the table
descriptor is in "not INSTALLED" state. This patch enforces this by
setting struct acpi_table_desc.Address to NULL in this function.
2. Introduce acpi_tb_invalidate_table() to be the reversal of
acpi_tb_validate_table() and invoke it in acpi_tb_uninstall_table().
3. Introduce acpi_tb_release_table() to release the table pointer that is not
maintained in acpi_gbl_root_table_list and rewrite acpi_tb_invalidate_table()
using this new function to reduce redundancies.
After cleaning up, the maintainability of the internal APIs are also
improved:
1. acpi_tb_acquire_table: Acquire struct acpi_table_header according to
ACPI_TABLE_ORIGIN_xxx flags.
2. acpi_tb_release_table: Release struct acpi_table_header according to
ACPI_TABLE_ORIGIN_xxx flags.
3. acpi_tb_install_table: Make struct acpi_table_desc.Address not NULL according to
ACPI_TABLE_ORIGIN_xxx flags.
4. acpi_tb_uninstall_table: Make struct acpi_table_desc.Address NULL according to
ACPI_TABLE_ORIGIN_xxx flags.
5. acpi_tb_validate_table: Make struct acpi_table_desc.Pointer not NULL according to
ACPI_TABLE_ORIGIN_xxx flags.
6. acpi_tb_invalidate_table: Make struct acpi_table_desc.Pointer NULL according to
ACPI_TABLE_ORIGIN_xxx flags.
7. acpi_tb_override_table: Replace struct acpi_table_desc.Address and
struct acpi_table_desc.Flags. It only happens in
"INSTALLED" state.
The patch has been unit tested in acpi_exec by:
1. Initializing;
2. Executing exc_tbl ASLTS tests;
3. Executing "Load" command.
So that all original acpi_tb_install_table() and acpi_tb_override_table()
invocations are covered.
Known Issues:
1. Cleanup acpi_tb_add_table() to Kill Code Redundancies
Current implementation in acpi_tb_add_table() is not very clean, further
patch can rewrite acpi_tb_add_table() with ordered acpi_tb_install_table(),
acpi_tb_override_table() and acpi_tb_validate_table(). It is not done in this
patch so that it is easy for the reviewers to understand the changes in
this patch.
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>
2014-04-03 22:38:42 -06:00
|
|
|
acpi_tb_validate_table(&acpi_gbl_root_table_list.
|
|
|
|
tables[table_index]);
|
2007-02-02 09:48:18 -07:00
|
|
|
if (ACPI_FAILURE(status)) {
|
|
|
|
(void)acpi_ut_release_mutex(ACPI_MTX_TABLES);
|
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
*table = acpi_gbl_root_table_list.tables[table_index].pointer;
|
|
|
|
(void)acpi_ut_release_mutex(ACPI_MTX_TABLES);
|
|
|
|
return_ACPI_STATUS(AE_OK);
|
2005-04-16 16:20:36 -06:00
|
|
|
}
|
|
|
|
|
2007-02-02 09:48:18 -07:00
|
|
|
ACPI_EXPORT_SYMBOL(acpi_get_table_by_index)
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2008-04-10 09:06:38 -06:00
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_install_table_handler
|
|
|
|
*
|
2012-07-11 19:40:10 -06:00
|
|
|
* PARAMETERS: handler - Table event handler
|
|
|
|
* context - Value passed to the handler on each event
|
2008-04-10 09:06:38 -06:00
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
2013-04-11 18:24:53 -06:00
|
|
|
* DESCRIPTION: Install a global table event handler.
|
2008-04-10 09:06:38 -06:00
|
|
|
*
|
|
|
|
******************************************************************************/
|
|
|
|
acpi_status
|
2013-01-12 08:29:38 -07:00
|
|
|
acpi_install_table_handler(acpi_table_handler handler, void *context)
|
2008-04-10 09:06:38 -06:00
|
|
|
{
|
|
|
|
acpi_status status;
|
|
|
|
|
|
|
|
ACPI_FUNCTION_TRACE(acpi_install_table_handler);
|
|
|
|
|
|
|
|
if (!handler) {
|
|
|
|
return_ACPI_STATUS(AE_BAD_PARAMETER);
|
|
|
|
}
|
|
|
|
|
|
|
|
status = acpi_ut_acquire_mutex(ACPI_MTX_EVENTS);
|
|
|
|
if (ACPI_FAILURE(status)) {
|
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Don't allow more than one handler */
|
|
|
|
|
|
|
|
if (acpi_gbl_table_handler) {
|
|
|
|
status = AE_ALREADY_EXISTS;
|
|
|
|
goto cleanup;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Install the handler */
|
|
|
|
|
|
|
|
acpi_gbl_table_handler = handler;
|
|
|
|
acpi_gbl_table_handler_context = context;
|
|
|
|
|
2013-10-28 19:30:02 -06:00
|
|
|
cleanup:
|
2008-04-10 09:06:38 -06:00
|
|
|
(void)acpi_ut_release_mutex(ACPI_MTX_EVENTS);
|
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
|
|
|
|
|
|
|
ACPI_EXPORT_SYMBOL(acpi_install_table_handler)
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
*
|
|
|
|
* FUNCTION: acpi_remove_table_handler
|
|
|
|
*
|
2012-07-11 19:40:10 -06:00
|
|
|
* PARAMETERS: handler - Table event handler that was installed
|
2008-04-10 09:06:38 -06:00
|
|
|
* previously.
|
|
|
|
*
|
|
|
|
* RETURN: Status
|
|
|
|
*
|
2013-04-11 18:24:53 -06:00
|
|
|
* DESCRIPTION: Remove a table event handler
|
2008-04-10 09:06:38 -06:00
|
|
|
*
|
|
|
|
******************************************************************************/
|
2013-01-12 08:29:38 -07:00
|
|
|
acpi_status acpi_remove_table_handler(acpi_table_handler handler)
|
2008-04-10 09:06:38 -06:00
|
|
|
{
|
|
|
|
acpi_status status;
|
|
|
|
|
|
|
|
ACPI_FUNCTION_TRACE(acpi_remove_table_handler);
|
|
|
|
|
|
|
|
status = acpi_ut_acquire_mutex(ACPI_MTX_EVENTS);
|
|
|
|
if (ACPI_FAILURE(status)) {
|
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Make sure that the installed handler is the same */
|
|
|
|
|
|
|
|
if (!handler || handler != acpi_gbl_table_handler) {
|
|
|
|
status = AE_BAD_PARAMETER;
|
|
|
|
goto cleanup;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Remove the handler */
|
|
|
|
|
|
|
|
acpi_gbl_table_handler = NULL;
|
|
|
|
|
2013-10-28 19:30:02 -06:00
|
|
|
cleanup:
|
2008-04-10 09:06:38 -06:00
|
|
|
(void)acpi_ut_release_mutex(ACPI_MTX_EVENTS);
|
|
|
|
return_ACPI_STATUS(status);
|
|
|
|
}
|
|
|
|
|
|
|
|
ACPI_EXPORT_SYMBOL(acpi_remove_table_handler)
|