mirror of
https://github.com/edk2-porting/linux-next.git
synced 2024-12-22 12:14:01 +08:00
86dfc6f339
The original table handling code does not always verify checksums before
installing a table, this is because code to achieve this must be
implemented here and there in the redundant code blocks.
There are two stages during table initialization:
1. "INSTALLED" after acpi_tb_install_table() and acpi_tb_override_table(),
struct acpi_table_desc.Pointer is ensured to be NULL. This can be safely used
during OSPM's early boot stage.
2. "VALIDATED" after acpi_tb_validate_table(), struct acpi_table_desc.Pointer is
ensured to be not NULL. This must not be used during OSPM's early boot
stage.
This patch changes acpi_tb_add_table() into an early boot safe API to reduce
code redundancies by changing the table state that is returned by this
function from "VALIDATED" to "INSTALLED". Then the table verification
code can be done in a single place. Originally, the acpi_tb_add_table() can
only be used by dynamic table loadings that are executed after early boot
stage, it cannot be used by static table loadings that are executed in
early boot stage as:
1. The address of the table is a virtual address either maintained by
OSPMs who call acpi_load_table() or by ACPICA whenever "Load" or
"LoadTable" opcodes are executed, while during early boot stage,
physical address of the table should be used for table loading.
2. The API will ensure the state of the loaded table to be "VALIDATED"
while during early boot stage, tables maintained by root table list
should be kept as "INSTALLED".
To achieve this:
1. Rename acpi_tb_install_table() to acpi_tb_install_fixed_table() as it only
applies to DSDT/FACS installation. Rename acpi_tb_add_table() to
acpi_tb_install_non_fixed_table() as it will be applied to the installation
of the rest kinds of tables.
2. Introduce acpi_tb_install_table(), acpi_tb_install_and_override_table to collect
redudant code where their invocations actually have slight differences.
1. acpi_tb_install_table() is used to fill an struct acpi_table_desc where the
table length is known to the caller.
2. acpi_tb_install_and_override_table() is used to perform necessary
overriding before installation.
3. Change a parameter of acpi_tb_install_non_fixed_table() from struct acpi_table_desc
to acpi_physical_address to allow it to be invoked by static table
loadings. Also cleanup acpi_ex_load_op() and acpi_load_table() to accomodate
to the parameter change.
4. Invoke acpi_tb_install_non_fixed_table() for all table loadings other than
DSDT/FACS in acpi_tb_parse_root_table() to improve code maintainability
(logics are collected in the single function). Also delete useless code
from acpi_tb_parse_root_table().
5. Remove all acpi_tb_validate_table() from acpi_tb_install_non_fixed_table() and
acpi_tb_install_fixed_table() so that the table descriptor is kept in the
state of "INSTALLED" but not "VALIDATED" after returning from these
functions.
6. Introduce temporary struct acpi_table_desc (new_table_desc/old_table_desc) into
the functions to indicate a table descriptor that is not maintained by
acpi_gbl_root_table_list. Introduce acpi_tb_acquire_temporal_table() and
acpi_tb_release_temporal_table() to handle the use cases of such temporal
tables. They are only used for verified installation.
7. Introduce acpi_tb_verify_table() to validate table and verify table
checksum, also remove table checksum verification from
acpi_tb_validate_table(). Invoke acpi_tb_validate_table() in the functions
that will convert a table into "LOADED" state or invoke it from
acpi_get_table_XXX() APIs. Invoke acpi_tb_verify_table() on temporary
struct acpi_table_desc(s) that are going to be "INSTALLED".
8. Change acpi_tb_override_table() logic so that a temporary struct acpi_table_desc
will be overridden before installtion, this makes code simpler.
After applying the patch, tables are always installed after being
overridden and the table checksums are always verified before installation.
Signed-off-by: Lv Zheng <lv.zheng@intel.com>
Signed-off-by: Bob Moore <robert.moore@intel.com>
[rjw: Subject]
Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
154 lines
4.9 KiB
C
154 lines
4.9 KiB
C
/******************************************************************************
|
|
*
|
|
* Name: actables.h - ACPI table management
|
|
*
|
|
*****************************************************************************/
|
|
|
|
/*
|
|
* Copyright (C) 2000 - 2014, 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.
|
|
*/
|
|
|
|
#ifndef __ACTABLES_H__
|
|
#define __ACTABLES_H__
|
|
|
|
acpi_status acpi_allocate_root_table(u32 initial_table_count);
|
|
|
|
/*
|
|
* tbxfroot - Root pointer utilities
|
|
*/
|
|
acpi_status acpi_tb_validate_rsdp(struct acpi_table_rsdp *rsdp);
|
|
|
|
u8 *acpi_tb_scan_memory_for_rsdp(u8 *start_address, u32 length);
|
|
|
|
/*
|
|
* tbfadt - FADT parse/convert/validate
|
|
*/
|
|
void acpi_tb_parse_fadt(u32 table_index);
|
|
|
|
void acpi_tb_create_local_fadt(struct acpi_table_header *table, u32 length);
|
|
|
|
/*
|
|
* tbfind - find ACPI table
|
|
*/
|
|
acpi_status
|
|
acpi_tb_find_table(char *signature,
|
|
char *oem_id, char *oem_table_id, u32 *table_index);
|
|
|
|
/*
|
|
* tbinstal - Table removal and deletion
|
|
*/
|
|
acpi_status acpi_tb_resize_root_table_list(void);
|
|
|
|
acpi_status acpi_tb_validate_table(struct acpi_table_desc *table_desc);
|
|
|
|
void acpi_tb_invalidate_table(struct acpi_table_desc *table_desc);
|
|
|
|
acpi_status
|
|
acpi_tb_verify_table(struct acpi_table_desc *table_desc, char *signature);
|
|
|
|
void acpi_tb_override_table(struct acpi_table_desc *old_table_desc);
|
|
|
|
acpi_status
|
|
acpi_tb_acquire_table(struct acpi_table_desc *table_desc,
|
|
struct acpi_table_header **table_ptr,
|
|
u32 *table_length, u8 *table_flags);
|
|
|
|
void
|
|
acpi_tb_release_table(struct acpi_table_header *table,
|
|
u32 table_length, u8 table_flags);
|
|
|
|
acpi_status
|
|
acpi_tb_install_non_fixed_table(acpi_physical_address address,
|
|
u8 flags, u8 reload, u32 *table_index);
|
|
|
|
acpi_status
|
|
acpi_tb_store_table(acpi_physical_address address,
|
|
struct acpi_table_header *table,
|
|
u32 length, u8 flags, u32 *table_index);
|
|
|
|
void acpi_tb_uninstall_table(struct acpi_table_desc *table_desc);
|
|
|
|
void acpi_tb_terminate(void);
|
|
|
|
acpi_status acpi_tb_delete_namespace_by_owner(u32 table_index);
|
|
|
|
acpi_status acpi_tb_allocate_owner_id(u32 table_index);
|
|
|
|
acpi_status acpi_tb_release_owner_id(u32 table_index);
|
|
|
|
acpi_status acpi_tb_get_owner_id(u32 table_index, acpi_owner_id *owner_id);
|
|
|
|
u8 acpi_tb_is_table_loaded(u32 table_index);
|
|
|
|
void acpi_tb_set_table_loaded_flag(u32 table_index, u8 is_loaded);
|
|
|
|
/*
|
|
* tbutils - table manager utilities
|
|
*/
|
|
acpi_status acpi_tb_initialize_facs(void);
|
|
|
|
u8 acpi_tb_tables_loaded(void);
|
|
|
|
void
|
|
acpi_tb_print_table_header(acpi_physical_address address,
|
|
struct acpi_table_header *header);
|
|
|
|
u8 acpi_tb_checksum(u8 *buffer, u32 length);
|
|
|
|
acpi_status
|
|
acpi_tb_verify_checksum(struct acpi_table_header *table, u32 length);
|
|
|
|
void acpi_tb_check_dsdt_header(void);
|
|
|
|
struct acpi_table_header *acpi_tb_copy_dsdt(u32 table_index);
|
|
|
|
void
|
|
acpi_tb_install_table(struct acpi_table_desc *table_desc,
|
|
acpi_physical_address address,
|
|
u8 flags, struct acpi_table_header *table);
|
|
|
|
void
|
|
acpi_tb_install_and_override_table(u32 table_index,
|
|
struct acpi_table_desc *new_table_desc);
|
|
|
|
acpi_status
|
|
acpi_tb_install_fixed_table(acpi_physical_address address,
|
|
char *signature, u32 table_index);
|
|
|
|
acpi_status acpi_tb_parse_root_table(acpi_physical_address rsdp_address);
|
|
|
|
#endif /* __ACTABLES_H__ */
|