patch-2.4.0-test3 linux/drivers/acpi/tables/tbxface.c

• Lines: 353
• Date: Wed Jul 5 11:23:13 2000
• Orig file: v2.4.0-test2/linux/drivers/acpi/tables/tbxface.c
• Orig date: Wed Dec 31 16:00:00 1969

diff -u --recursive --new-file v2.4.0-test2/linux/drivers/acpi/tables/tbxface.c linux/drivers/acpi/tables/tbxface.c
@@ -0,0 +1,352 @@
+
+/******************************************************************************
+ *
+ * Module Name: tbxface - Public interfaces to the ACPI subsystem
+ *                         ACPI table oriented interfaces
+ *
+ *****************************************************************************/
+
+/*
+ *  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 "namesp.h"
+#include "interp.h"
+#include "tables.h"
+
+
+#define _COMPONENT          TABLE_MANAGER
+	 MODULE_NAME         ("tbxface");
+
+
+/*******************************************************************************
+ *
+ * FUNCTION:    Acpi_load_firmware_tables
+ *
+ * PARAMETERS:  None
+ *
+ * RETURN:      Status
+ *
+ * DESCRIPTION: This function is called to load the ACPI tables from BIOS
+ *
+ ******************************************************************************/
+
+ACPI_STATUS
+acpi_load_firmware_tables (void)
+{
+	ACPI_STATUS             status = AE_OK;
+	u32                     number_of_tables = 0;
+
+
+	/* Get the RSDT first */
+
+	status = acpi_tb_get_table_rsdt (&number_of_tables);
+	if (status != AE_OK) {
+		goto error_exit;
+	}
+
+
+	/* Now get the rest of the tables */
+
+	status = acpi_tb_get_all_tables (number_of_tables, NULL);
+	if (status != AE_OK) {
+		goto error_exit;
+	}
+
+
+	return (AE_OK);
+
+
+error_exit:
+	return (status);
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION:    Acpi_load_table
+ *
+ * PARAMETERS:  Table_ptr       - pointer to a buffer containing the entire
+ *                                table to be loaded
+ *
+ * RETURN:      Status
+ *
+ * DESCRIPTION: This function is called to load a table from the caller's
+ *              buffer.  The buffer must contain an entire ACPI Table including
+ *              a valid header.  The header fields will be verified, and if it
+ *              is determined that the table is invalid, the call will fail.
+ *
+ *              If the call fails an appropriate status will be returned.
+ *
+ ******************************************************************************/
+
+ACPI_STATUS
+acpi_load_table (
+	ACPI_TABLE_HEADER       *table_ptr)
+{
+	ACPI_STATUS             status;
+	ACPI_TABLE_DESC         table_info;
+
+
+	if (!table_ptr) {
+		return AE_BAD_PARAMETER;
+	}
+
+	/* Copy the table to a local buffer */
+
+	status = acpi_tb_get_table (NULL, ((char *) table_ptr), &table_info);
+	if (ACPI_FAILURE (status)) {
+		return (status);
+	}
+
+	/* Install the new table into the local data structures */
+
+	status = acpi_tb_install_table (NULL, &table_info);
+	if (ACPI_FAILURE (status)) {
+		/* TBD: [Errors] must free table allocated by Acpi_tb_get_table */
+	}
+
+	return (status);
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION:    Acpi_unload_table
+ *
+ * PARAMETERS:  Table_type    - Type of table to be unloaded
+ *
+ * RETURN:      Status
+ *
+ * DESCRIPTION: This routine is used to force the unload of a table
+ *
+ ******************************************************************************/
+
+ACPI_STATUS
+acpi_unload_table (
+	ACPI_TABLE_TYPE         table_type)
+{
+	ACPI_TABLE_DESC         *list_head;
+
+
+	/* Parameter validation */
+
+	if (table_type > ACPI_TABLE_MAX) {
+		return (AE_BAD_PARAMETER);
+	}
+
+
+	/* Find all tables of the requested type */
+
+	list_head = &acpi_gbl_acpi_tables[table_type];
+	do
+	{
+		/* Delete the entire namespace under this table NTE */
+
+		acpi_ns_delete_namespace_by_owner (list_head->table_id);
+
+		/* Delete (or unmap) the actual table */
+
+		acpi_tb_delete_acpi_table (table_type);
+
+	} while (list_head != &acpi_gbl_acpi_tables[table_type]);
+
+	return (AE_OK);
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION:    Acpi_get_table_header
+ *
+ * PARAMETERS:  Table_type      - one of the defined table types
+ *              Instance        - the non zero instance of the table, allows
+ *                                support for multiple tables of the same type
+ *                                see Acpi_gbl_Acpi_table_flag
+ *              Out_table_header - pointer to the ACPI_TABLE_HEADER if successful
+ *
+ * DESCRIPTION: This function is called to get an ACPI table header.  The caller
+ *              supplies an pointer to a data area sufficient to contain an ACPI
+ *              ACPI_TABLE_HEADER structure.
+ *
+ *              The header contains a length field that can be used to determine
+ *              the size of the buffer needed to contain the entire table.  This
+ *              function is not valid for the RSD PTR table since it does not
+ *              have a standard header and is fixed length.
+ *
+ *              If the operation fails for any reason an appropriate status will
+ *              be returned and the contents of Out_table_header are undefined.
+ *
+ ******************************************************************************/
+
+ACPI_STATUS
+acpi_get_table_header (
+	ACPI_TABLE_TYPE         table_type,
+	u32                     instance,
+	ACPI_TABLE_HEADER       *out_table_header)
+{
+	ACPI_TABLE_HEADER       *tbl_ptr;
+	ACPI_STATUS             status;
+
+
+	status = AE_OK;
+
+	if ((instance == 0)                 ||
+		(table_type == ACPI_TABLE_RSDP) ||
+		(!out_table_header))
+	{
+		return (AE_BAD_PARAMETER);
+	}
+
+	/* Check the table type and instance */
+
+	if ((table_type > ACPI_TABLE_MAX)   ||
+		(acpi_gbl_acpi_table_data[table_type].flags == ACPI_TABLE_SINGLE &&
+		 instance > 1))
+	{
+		return (AE_BAD_PARAMETER);
+	}
+
+
+	/* Get a pointer to the entire table */
+
+	status = acpi_tb_get_table_ptr (table_type, instance, &tbl_ptr);
+	if (status != AE_OK) {
+		return (status);
+	}
+
+	/*
+	 * The function will return a NULL pointer if the table is not loaded
+	 */
+	if (tbl_ptr == NULL) {
+		return (AE_NOT_EXIST);
+	}
+
+	/*
+	 * Copy the header to the caller's buffer
+	 */
+	MEMCPY ((void *) out_table_header, (void *) tbl_ptr,
+			 sizeof (ACPI_TABLE_HEADER));
+
+	return (status);
+}
+
+
+/*******************************************************************************
+ *
+ * FUNCTION:    Acpi_get_table
+ *
+ * PARAMETERS:  Table_type      - one of the defined table types
+ *              Instance        - the non zero instance of the table, allows
+ *                                support for multiple tables of the same type
+ *                                see Acpi_gbl_Acpi_table_flag
+ *              Ret_buffer      - pointer to a structure containing a buffer to
+ *                                receive the table
+ *
+ * RETURN:      Status
+ *
+ * DESCRIPTION: This function is called to get an ACPI table.  The caller
+ *              supplies an Out_buffer large enough to contain the entire ACPI
+ *              table.  The caller should call the Acpi_get_table_header function
+ *              first to determine the buffer size needed.  Upon completion
+ *              the Out_buffer->Length field will indicate the number of bytes
+ *              copied into the Out_buffer->Buf_ptr buffer. This table will be
+ *              a complete table including the header.
+ *
+ *              If the operation fails an appropriate status will be returned
+ *              and the contents of Out_buffer are undefined.
+ *
+ ******************************************************************************/
+
+ACPI_STATUS
+acpi_get_table (
+	ACPI_TABLE_TYPE         table_type,
+	u32                     instance,
+	ACPI_BUFFER             *ret_buffer)
+{
+	ACPI_TABLE_HEADER       *tbl_ptr;
+	ACPI_STATUS             status;
+	u32                     ret_buf_len;
+
+
+	status = AE_OK;
+
+	/*
+	 *  Must have a buffer
+	 */
+	if ((instance == 0)                 ||
+		(!ret_buffer)                   ||
+		(!ret_buffer->pointer)          ||
+		(!ret_buffer->length))
+	{
+		return (AE_BAD_PARAMETER);
+	}
+
+	/* Check the table type and instance */
+
+	if ((table_type > ACPI_TABLE_MAX)   ||
+		(acpi_gbl_acpi_table_data[table_type].flags == ACPI_TABLE_SINGLE &&
+		 instance > 1))
+	{
+		return (AE_BAD_PARAMETER);
+	}
+
+
+	/* Get a pointer to the entire table */
+
+	status = acpi_tb_get_table_ptr (table_type, instance, &tbl_ptr);
+	if (status != AE_OK) {
+		return (status);
+	}
+
+	/*
+	 * The function will return a NULL pointer if the table is not loaded
+	 */
+	if (tbl_ptr == NULL) {
+		return (AE_NOT_EXIST);
+	}
+
+	/*
+	 * Got a table ptr, assume it's ok and copy it to the user's buffer
+	 */
+	if (table_type == ACPI_TABLE_RSDP) {
+		/*
+		 *  RSD PTR is the only "table" without a header
+		 */
+		ret_buf_len = sizeof (ROOT_SYSTEM_DESCRIPTOR_POINTER);
+	}
+	else {
+		ret_buf_len = tbl_ptr->length;
+	}
+
+	/*
+	 * Verify we have space in the caller's buffer for the table
+	 */
+	if (ret_buffer->length < ret_buf_len) {
+		ret_buffer->length = ret_buf_len;
+		return (AE_BUFFER_OVERFLOW);
+	}
+
+	ret_buffer->length = ret_buf_len;
+
+	MEMCPY ((void *) ret_buffer->pointer, (void *) tbl_ptr, ret_buf_len);
+
+	return (AE_OK);
+}
+