summaryrefslogtreecommitdiffstats
path: root/drivers/acpi/tables/tbxface.c
diff options
context:
space:
mode:
Diffstat (limited to 'drivers/acpi/tables/tbxface.c')
-rw-r--r--drivers/acpi/tables/tbxface.c352
1 files changed, 352 insertions, 0 deletions
diff --git a/drivers/acpi/tables/tbxface.c b/drivers/acpi/tables/tbxface.c
new file mode 100644
index 000000000..ba650c114
--- /dev/null
+++ b/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);
+}
+
generated by cgit v1.2.3 (git 2.25.1) at 2024-11-10 08:41:43 +0000