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

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)