patch-2.4.0-test3 linux/drivers/acpi/tables/tbinstal.c
Next file: linux/drivers/acpi/tables/tbtable.c
Previous file: linux/drivers/acpi/tables/tbget.c
Back to the patch index
Back to the overall index
- Lines: 534
- Date:
Wed Jul 5 11:23:13 2000
- Orig file:
v2.4.0-test2/linux/drivers/acpi/tables/tbinstal.c
- Orig date:
Wed Dec 31 16:00:00 1969
diff -u --recursive --new-file v2.4.0-test2/linux/drivers/acpi/tables/tbinstal.c linux/drivers/acpi/tables/tbinstal.c
@@ -0,0 +1,533 @@
+
+/******************************************************************************
+ *
+ * Module Name: tbinstal - ACPI table installation and removal
+ *
+ *****************************************************************************/
+
+/*
+ * Copyright (C) 2000 R. Byron Moore
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ */
+
+
+#include "acpi.h"
+#include "hardware.h"
+#include "tables.h"
+
+
+#define _COMPONENT TABLE_MANAGER
+ MODULE_NAME ("tbinstal");
+
+
+/*******************************************************************************
+ *
+ * FUNCTION: Acpi_tb_install_table
+ *
+ * PARAMETERS: Table_ptr - Input buffer pointer, optional
+ * Table_info - Return value from Acpi_tb_get_table
+ *
+ * RETURN: Status
+ *
+ * DESCRIPTION: Load and validate all tables other than the RSDT. The RSDT must
+ * already be loaded and validated.
+ * Install the table into the global data structs.
+ *
+ ******************************************************************************/
+
+ACPI_STATUS
+acpi_tb_install_table (
+ char *table_ptr,
+ ACPI_TABLE_DESC *table_info)
+{
+ ACPI_TABLE_TYPE table_type;
+ ACPI_TABLE_HEADER *table_header;
+ ACPI_STATUS status;
+
+
+ /*
+ * Check the table signature and make sure it is recognized
+ * Also checks the header checksum
+ */
+
+ status = acpi_tb_recognize_table (table_ptr, table_info);
+ if (ACPI_FAILURE (status)) {
+ return (status);
+ }
+
+ /* Table type is returned by Recognize_table */
+
+ table_type = table_info->type;
+ table_header = table_info->pointer;
+
+ /* Lock tables while installing */
+
+ acpi_cm_acquire_mutex (ACPI_MTX_TABLES);
+
+ /* Install the table into the global data structure */
+
+ status = acpi_tb_init_table_descriptor (table_info->type, table_info);
+ if (ACPI_FAILURE (status)) {
+ return (status);
+ }
+
+ acpi_cm_release_mutex (ACPI_MTX_TABLES);
+ return (AE_OK);
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION: Acpi_tb_recognize_table
+ *
+ * PARAMETERS: Table_ptr - Input buffer pointer, optional
+ * Table_info - Return value from Acpi_tb_get_table
+ *
+ * RETURN: Status
+ *
+ * DESCRIPTION: Check a table signature for a match against known table types
+ *
+ * NOTE: All table pointers are validated as follows:
+ * 1) Table pointer must point to valid physical memory
+ * 2) Signature must be 4 ASCII chars, even if we don't recognize the
+ * name
+ * 3) Table must be readable for length specified in the header
+ * 4) Table checksum must be valid (with the exception of the FACS
+ * which has no checksum for some odd reason)
+ *
+ ******************************************************************************/
+
+ACPI_STATUS
+acpi_tb_recognize_table (
+ char *table_ptr,
+ ACPI_TABLE_DESC *table_info)
+{
+ ACPI_TABLE_HEADER *table_header;
+ ACPI_STATUS status;
+ ACPI_TABLE_TYPE table_type = 0;
+ u32 i;
+
+
+ /* Ensure that we have a valid table pointer */
+
+ table_header = (ACPI_TABLE_HEADER *) table_info->pointer;
+ if (!table_header) {
+ return (AE_BAD_PARAMETER);
+ }
+
+ /*
+ * Search for a signature match among the known table types
+ * Start at index one -> Skip the RSDP
+ */
+
+ status = AE_SUPPORT;
+ for (i = 1; i < NUM_ACPI_TABLES; i++) {
+ if (!STRNCMP (table_header->signature,
+ acpi_gbl_acpi_table_data[i].signature,
+ acpi_gbl_acpi_table_data[i].sig_length))
+ {
+ /*
+ * Found a signature match, get the pertinent info from the
+ * Table_data structure
+ */
+
+ table_type = i;
+ status = acpi_gbl_acpi_table_data[i].status;
+
+ break;
+ }
+ }
+
+ /* Return the table type and length via the info struct */
+
+ table_info->type = (u8) table_type;
+ table_info->length = table_header->length;
+
+
+ /*
+ * Validate checksum for _most_ tables,
+ * even the ones whose signature we don't recognize
+ */
+
+ if (table_type != ACPI_TABLE_FACS) {
+ /* But don't abort if the checksum is wrong */
+ /* TBD: [Future] make this a configuration option? */
+
+ acpi_tb_verify_table_checksum (table_header);
+ }
+
+ /*
+ * An AE_SUPPORT means that the table was not recognized.
+ * We basically ignore this; just print a debug message
+ */
+
+
+ return (status);
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION: Acpi_tb_init_table_descriptor
+ *
+ * PARAMETERS: Table_type - The type of the table
+ * Table_info - A table info struct
+ *
+ * RETURN: None.
+ *
+ * DESCRIPTION: Install a table into the global data structs.
+ *
+ ******************************************************************************/
+
+ACPI_STATUS
+acpi_tb_init_table_descriptor (
+ ACPI_TABLE_TYPE table_type,
+ ACPI_TABLE_DESC *table_info)
+{
+ ACPI_TABLE_DESC *list_head;
+ ACPI_TABLE_DESC *table_desc;
+
+
+ /*
+ * Install the table into the global data structure
+ */
+
+ list_head = &acpi_gbl_acpi_tables[table_type];
+ table_desc = list_head;
+
+
+ /*
+ * Two major types of tables: 1) Only one instance is allowed. This
+ * includes most ACPI tables such as the DSDT. 2) Multiple instances of
+ * the table are allowed. This includes SSDT and PSDTs.
+ */
+
+ if (acpi_gbl_acpi_table_data[table_type].flags == ACPI_TABLE_SINGLE) {
+ /*
+ * Only one table allowed, just update the list head
+ */
+
+ if (list_head->pointer) {
+ return (AE_EXIST);
+ }
+
+ table_desc->count = 1;
+ }
+
+
+ else {
+ /*
+ * Multiple tables allowed for this table type, we must link
+ * the new table in to the list of tables of this type.
+ */
+
+ if (list_head->pointer) {
+ table_desc = acpi_cm_callocate (sizeof (ACPI_TABLE_DESC));
+ if (!table_desc) {
+ return (AE_NO_MEMORY);
+ }
+
+ list_head->count++;
+
+ /* Update the original previous */
+
+ list_head->prev->next = table_desc;
+
+ /* Update new entry */
+
+ table_desc->prev = list_head->prev;
+ table_desc->next = (ACPI_TABLE_DESC *) list_head;
+
+ /* Update list head */
+
+ list_head->prev = table_desc;
+ }
+
+ else {
+ table_desc->count = 1;
+ }
+ }
+
+
+ /* Common initialization of the table descriptor */
+
+ table_desc->pointer = table_info->pointer;
+ table_desc->base_pointer = table_info->base_pointer;
+ table_desc->length = table_info->length;
+ table_desc->allocation = table_info->allocation;
+ table_desc->aml_pointer = (u8 *) (table_desc->pointer + 1),
+ table_desc->aml_length = (u32) (table_desc->length -
+ (u32) sizeof (ACPI_TABLE_HEADER));
+ table_desc->table_id = acpi_cm_allocate_owner_id (OWNER_TYPE_TABLE);
+ table_desc->loaded_into_namespace = FALSE;
+
+ /*
+ * Set the appropriate global pointer (if there is one) to point to the
+ * newly installed table
+ */
+
+ if (acpi_gbl_acpi_table_data[table_type].global_ptr) {
+ *(acpi_gbl_acpi_table_data[table_type].global_ptr) = table_info->pointer;
+ }
+
+
+ /* Return Data */
+
+ table_info->table_id = table_desc->table_id;
+ table_info->installed_desc = table_desc;
+
+ return (AE_OK);
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION: Acpi_tb_delete_acpi_tables
+ *
+ * PARAMETERS: None.
+ *
+ * RETURN: None.
+ *
+ * DESCRIPTION: Delete all internal ACPI tables
+ *
+ ******************************************************************************/
+
+void
+acpi_tb_delete_acpi_tables (void)
+{
+ u32 i;
+
+
+ /*
+ * Free memory allocated for ACPI tables
+ * Memory can either be mapped or allocated
+ */
+
+ for (i = 0; i < ACPI_TABLE_MAX; i++) {
+ acpi_tb_delete_acpi_table (i);
+ }
+
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION: Acpi_tb_delete_acpi_table
+ *
+ * PARAMETERS: Type - The table type to be deleted
+ *
+ * RETURN: None.
+ *
+ * DESCRIPTION: Delete an internal ACPI table
+ * Locks the ACPI table mutex
+ *
+ ******************************************************************************/
+
+void
+acpi_tb_delete_acpi_table (
+ ACPI_TABLE_TYPE type)
+{
+
+ if (type > ACPI_TABLE_MAX) {
+ return;
+ }
+
+
+ acpi_cm_acquire_mutex (ACPI_MTX_TABLES);
+
+ /* Free the table */
+
+ acpi_tb_free_acpi_tables_of_type (&acpi_gbl_acpi_tables[type]);
+
+
+ /* Clear the appropriate "typed" global table pointer */
+
+ switch (type)
+ {
+ case ACPI_TABLE_RSDP:
+ acpi_gbl_RSDP = NULL;
+ break;
+
+ case ACPI_TABLE_APIC:
+ acpi_gbl_APIC = NULL;
+ break;
+
+ case ACPI_TABLE_DSDT:
+ acpi_gbl_DSDT = NULL;
+ break;
+
+ case ACPI_TABLE_FACP:
+ acpi_gbl_FACP = NULL;
+ break;
+
+ case ACPI_TABLE_FACS:
+ acpi_gbl_FACS = NULL;
+ break;
+
+ case ACPI_TABLE_PSDT:
+ break;
+
+ case ACPI_TABLE_RSDT:
+ acpi_gbl_RSDT = NULL;
+ break;
+
+ case ACPI_TABLE_SSDT:
+ break;
+
+ case ACPI_TABLE_SBST:
+ acpi_gbl_SBST = NULL;
+
+ default:
+ break;
+ }
+
+ acpi_cm_release_mutex (ACPI_MTX_TABLES);
+
+ return;
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION: Acpi_tb_delete_single_table
+ *
+ * PARAMETERS: Table_info - A table info struct
+ *
+ * RETURN: None.
+ *
+ * DESCRIPTION: Free the memory associated with an internal ACPI table that
+ * is either installed or has never been installed.
+ * Table mutex should be locked.
+ *
+ ******************************************************************************/
+
+ACPI_TABLE_DESC *
+acpi_tb_delete_single_table (
+ ACPI_TABLE_DESC *table_desc)
+{
+ ACPI_TABLE_DESC *next_desc;
+
+
+ if (!table_desc) {
+ return (NULL);
+ }
+
+
+ /* Unlink the descriptor */
+
+ if (table_desc->prev) {
+ table_desc->prev->next = table_desc->next;
+ }
+
+ if (table_desc->next) {
+ table_desc->next->prev = table_desc->prev;
+ }
+
+
+ /* Free the memory allocated for the table itself */
+
+ if (table_desc->pointer) {
+ /* Valid table, determine type of memory allocation */
+
+ switch (table_desc->allocation)
+ {
+
+ case ACPI_MEM_NOT_ALLOCATED:
+
+ break;
+
+
+ case ACPI_MEM_ALLOCATED:
+
+ acpi_cm_free (table_desc->base_pointer);
+ break;
+
+
+ case ACPI_MEM_MAPPED:
+
+ acpi_os_unmap_memory (table_desc->base_pointer, table_desc->length);
+ break;
+ }
+ }
+
+
+ /* Free the table descriptor (Don't delete the list head, tho) */
+
+
+ if ((table_desc->prev) == (table_desc->next)) {
+
+ next_desc = NULL;
+
+ /* Clear the list head */
+
+ table_desc->pointer = NULL;
+ table_desc->length = 0;
+ table_desc->count = 0;
+
+ }
+
+ else {
+ /* Free the table descriptor */
+
+ next_desc = table_desc->next;
+ acpi_cm_free (table_desc);
+ }
+
+
+ return (next_desc);
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION: Acpi_tb_free_acpi_tables_of_type
+ *
+ * PARAMETERS: Table_info - A table info struct
+ *
+ * RETURN: None.
+ *
+ * DESCRIPTION: Free the memory associated with an internal ACPI table
+ * Table mutex should be locked.
+ *
+ ******************************************************************************/
+
+void
+acpi_tb_free_acpi_tables_of_type (
+ ACPI_TABLE_DESC *list_head)
+{
+ ACPI_TABLE_DESC *table_desc;
+ u32 count;
+ u32 i;
+
+
+ /* Get the head of the list */
+
+ table_desc = list_head;
+ count = list_head->count;
+
+ /*
+ * Walk the entire list, deleting both the allocated tables
+ * and the table descriptors
+ */
+
+ for (i = 0; i < count; i++) {
+ table_desc = acpi_tb_delete_single_table (table_desc);
+ }
+
+ return;
+}
+
+
FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)