[deliverable/linux.git] / drivers / acpi / tables / tbget.c

/******************************************************************************
 *
 * Module Name: tbget - ACPI Table get* routines
 *
 *****************************************************************************/

/*
 * Copyright (C) 2000 - 2006, R. Byron Moore
 * 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.
 */

#include <acpi/acpi.h>
#include <acpi/actables.h>

#define _COMPONENT          ACPI_TABLES
ACPI_MODULE_NAME("tbget")

/* Local prototypes */
static acpi_status
acpi_tb_get_this_table(struct acpi_pointer *address,
		       struct acpi_table_header *header,
		       struct acpi_table_desc *table_info);

static acpi_status
acpi_tb_table_override(struct acpi_table_header *header,
		       struct acpi_table_desc *table_info);

/*******************************************************************************
 *
 * FUNCTION:    acpi_tb_get_table
 *
 * PARAMETERS:  Address             - Address of table to retrieve.  Can be
 *                                    Logical or Physical
 *              table_info          - Where table info is returned
 *
 * RETURN:      None
 *
 * DESCRIPTION: Get entire table of unknown size.
 *
 ******************************************************************************/

acpi_status
acpi_tb_get_table(struct acpi_pointer *address,
		  struct acpi_table_desc *table_info)
{
	acpi_status status;
	struct acpi_table_header header;

	ACPI_FUNCTION_TRACE("tb_get_table");

	/* Get the header in order to get signature and table size */

	status = acpi_tb_get_table_header(address, &header);
	if (ACPI_FAILURE(status)) {
		return_ACPI_STATUS(status);
	}

	/* Get the entire table */

	status = acpi_tb_get_table_body(address, &header, table_info);
	if (ACPI_FAILURE(status)) {
		ACPI_EXCEPTION((AE_INFO, status,
				"Could not get ACPI table (size %X)",
				header.length));
		return_ACPI_STATUS(status);
	}

	return_ACPI_STATUS(AE_OK);
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_tb_get_table_header
 *
 * PARAMETERS:  Address             - Address of table to retrieve.  Can be
 *                                    Logical or Physical
 *              return_header       - Where the table header is returned
 *
 * RETURN:      Status
 *
 * DESCRIPTION: Get an ACPI table header.  Works in both physical or virtual
 *              addressing mode.  Works with both physical or logical pointers.
 *              Table is either copied or mapped, depending on the pointer
 *              type and mode of the processor.
 *
 ******************************************************************************/

acpi_status
acpi_tb_get_table_header(struct acpi_pointer *address,
			 struct acpi_table_header *return_header)
{
	acpi_status status = AE_OK;
	struct acpi_table_header *header = NULL;

	ACPI_FUNCTION_TRACE("tb_get_table_header");

	/*
	 * Flags contains the current processor mode (Virtual or Physical
	 * addressing) The pointer_type is either Logical or Physical
	 */
	switch (address->pointer_type) {
	case ACPI_PHYSMODE_PHYSPTR:
	case ACPI_LOGMODE_LOGPTR:

		/* Pointer matches processor mode, copy the header */

		ACPI_MEMCPY(return_header, address->pointer.logical,
			    sizeof(struct acpi_table_header));
		break;

	case ACPI_LOGMODE_PHYSPTR:

		/* Create a logical address for the physical pointer */

		status = acpi_os_map_memory(address->pointer.physical,
					    sizeof(struct acpi_table_header),
					    (void *)&header);
		if (ACPI_FAILURE(status)) {
			return_ACPI_STATUS(status);
		}

		/* Copy header and delete mapping */

		ACPI_MEMCPY(return_header, header,
			    sizeof(struct acpi_table_header));
		acpi_os_unmap_memory(header, sizeof(struct acpi_table_header));
		break;

	default:

		ACPI_ERROR((AE_INFO, "Invalid address flags %X",
			    address->pointer_type));
		return_ACPI_STATUS(AE_BAD_PARAMETER);
	}

	ACPI_DEBUG_PRINT((ACPI_DB_TABLES, "Table Signature: [%4.4s]\n",
			  return_header->signature));

	return_ACPI_STATUS(AE_OK);
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_tb_get_table_body
 *
 * PARAMETERS:  Address             - Address of table to retrieve.  Can be
 *                                    Logical or Physical
 *              Header              - Header of the table to retrieve
 *              table_info          - Where the table info is returned
 *
 * RETURN:      Status
 *
 * DESCRIPTION: Get an entire ACPI table with support to allow the host OS to
 *              replace the table with a newer version (table override.)
 *              Works in both physical or virtual
 *              addressing mode.  Works with both physical or logical pointers.
 *              Table is either copied or mapped, depending on the pointer
 *              type and mode of the processor.
 *
 ******************************************************************************/

acpi_status
acpi_tb_get_table_body(struct acpi_pointer *address,
		       struct acpi_table_header *header,
		       struct acpi_table_desc *table_info)
{
	acpi_status status;

	ACPI_FUNCTION_TRACE("tb_get_table_body");

	if (!table_info || !address) {
		return_ACPI_STATUS(AE_BAD_PARAMETER);
	}

	/* Attempt table override. */

	status = acpi_tb_table_override(header, table_info);
	if (ACPI_SUCCESS(status)) {
		/* Table was overridden by the host OS */

		return_ACPI_STATUS(status);
	}

	/* No override, get the original table */

	status = acpi_tb_get_this_table(address, header, table_info);
	return_ACPI_STATUS(status);
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_tb_table_override
 *
 * PARAMETERS:  Header              - Pointer to table header
 *              table_info          - Return info if table is overridden
 *
 * RETURN:      None
 *
 * DESCRIPTION: Attempts override of current table with a new one if provided
 *              by the host OS.
 *
 ******************************************************************************/

static acpi_status
acpi_tb_table_override(struct acpi_table_header *header,
		       struct acpi_table_desc *table_info)
{
	struct acpi_table_header *new_table;
	acpi_status status;
	struct acpi_pointer address;

	ACPI_FUNCTION_TRACE("tb_table_override");

	/*
	 * The OSL will examine the header and decide whether to override this
	 * table.  If it decides to override, a table will be returned in new_table,
	 * which we will then copy.
	 */
	status = acpi_os_table_override(header, &new_table);
	if (ACPI_FAILURE(status)) {
		/* Some severe error from the OSL, but we basically ignore it */

		ACPI_EXCEPTION((AE_INFO, status,
				"Could not override ACPI table"));
		return_ACPI_STATUS(status);
	}

	if (!new_table) {
		/* No table override */

		return_ACPI_STATUS(AE_NO_ACPI_TABLES);
	}

	/*
	 * We have a new table to override the old one.  Get a copy of
	 * the new one.  We know that the new table has a logical pointer.
	 */
	address.pointer_type = ACPI_LOGICAL_POINTER | ACPI_LOGICAL_ADDRESSING;
	address.pointer.logical = new_table;

	status = acpi_tb_get_this_table(&address, new_table, table_info);
	if (ACPI_FAILURE(status)) {
		ACPI_EXCEPTION((AE_INFO, status, "Could not copy ACPI table"));
		return_ACPI_STATUS(status);
	}

	/* Copy the table info */

	ACPI_INFO((AE_INFO, "Table [%4.4s] replaced by host OS",
		   table_info->pointer->signature));

	return_ACPI_STATUS(AE_OK);
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_tb_get_this_table
 *
 * PARAMETERS:  Address             - Address of table to retrieve.  Can be
 *                                    Logical or Physical
 *              Header              - Header of the table to retrieve
 *              table_info          - Where the table info is returned
 *
 * RETURN:      Status
 *
 * DESCRIPTION: Get an entire ACPI table.  Works in both physical or virtual
 *              addressing mode.  Works with both physical or logical pointers.
 *              Table is either copied or mapped, depending on the pointer
 *              type and mode of the processor.
 *
 ******************************************************************************/

static acpi_status
acpi_tb_get_this_table(struct acpi_pointer *address,
		       struct acpi_table_header *header,
		       struct acpi_table_desc *table_info)
{
	struct acpi_table_header *full_table = NULL;
	u8 allocation;
	acpi_status status = AE_OK;

	ACPI_FUNCTION_TRACE("tb_get_this_table");

	/*
	 * Flags contains the current processor mode (Virtual or Physical
	 * addressing) The pointer_type is either Logical or Physical
	 */
	switch (address->pointer_type) {
	case ACPI_PHYSMODE_PHYSPTR:
	case ACPI_LOGMODE_LOGPTR:

		/* Pointer matches processor mode, copy the table to a new buffer */

		full_table = ACPI_MEM_ALLOCATE(header->length);
		if (!full_table) {
			ACPI_ERROR((AE_INFO,
				    "Could not allocate table memory for [%4.4s] length %X",
				    header->signature, header->length));
			return_ACPI_STATUS(AE_NO_MEMORY);
		}

		/* Copy the entire table (including header) to the local buffer */

		ACPI_MEMCPY(full_table, address->pointer.logical,
			    header->length);

		/* Save allocation type */

		allocation = ACPI_MEM_ALLOCATED;
		break;

	case ACPI_LOGMODE_PHYSPTR:

		/*
		 * Just map the table's physical memory
		 * into our address space.
		 */
		status = acpi_os_map_memory(address->pointer.physical,
					    (acpi_size) header->length,
					    (void *)&full_table);
		if (ACPI_FAILURE(status)) {
			ACPI_ERROR((AE_INFO,
				    "Could not map memory for table [%4.4s] at %8.8X%8.8X for length %X",
				    header->signature,
				    ACPI_FORMAT_UINT64(address->pointer.
						       physical),
				    header->length));
			return (status);
		}

		/* Save allocation type */

		allocation = ACPI_MEM_MAPPED;
		break;

	default:

		ACPI_ERROR((AE_INFO, "Invalid address flags %X",
			    address->pointer_type));
		return_ACPI_STATUS(AE_BAD_PARAMETER);
	}

	/*
	 * Validate checksum for _most_ tables,
	 * even the ones whose signature we don't recognize
	 */
	if (table_info->type != ACPI_TABLE_FACS) {
		status = acpi_tb_verify_table_checksum(full_table);

#if (!ACPI_CHECKSUM_ABORT)
		if (ACPI_FAILURE(status)) {
			/* Ignore the error if configuration says so */

			status = AE_OK;
		}
#endif
	}

	/* Return values */

	table_info->pointer = full_table;
	table_info->length = (acpi_size) header->length;
	table_info->allocation = allocation;

	ACPI_DEBUG_PRINT((ACPI_DB_INFO,
			  "Found table [%4.4s] at %8.8X%8.8X, mapped/copied to %p\n",
			  full_table->signature,
			  ACPI_FORMAT_UINT64(address->pointer.physical),
			  full_table));

	return_ACPI_STATUS(status);
}

/*******************************************************************************
 *
 * FUNCTION:    acpi_tb_get_table_ptr
 *
 * PARAMETERS:  table_type      - one of the defined table types
 *              Instance        - Which table of this type
 *              table_ptr_loc   - pointer to location to place the pointer for
 *                                return
 *
 * RETURN:      Status
 *
 * DESCRIPTION: This function is called to get the pointer to an ACPI table.
 *
 ******************************************************************************/

acpi_status
acpi_tb_get_table_ptr(acpi_table_type table_type,
		      u32 instance, struct acpi_table_header **table_ptr_loc)
{
	struct acpi_table_desc *table_desc;
	u32 i;

	ACPI_FUNCTION_TRACE("tb_get_table_ptr");

	if (!acpi_gbl_DSDT) {
		return_ACPI_STATUS(AE_NO_ACPI_TABLES);
	}

	if (table_type > ACPI_TABLE_MAX) {
		return_ACPI_STATUS(AE_BAD_PARAMETER);
	}

	/*
	 * For all table types (Single/Multiple), the first
	 * instance is always in the list head.
	 */
	if (instance == 1) {
		/* Get the first */

		*table_ptr_loc = NULL;
		if (acpi_gbl_table_lists[table_type].next) {
			*table_ptr_loc =
			    acpi_gbl_table_lists[table_type].next->pointer;
		}
		return_ACPI_STATUS(AE_OK);
	}

	/* Check for instance out of range */

	if (instance > acpi_gbl_table_lists[table_type].count) {
		return_ACPI_STATUS(AE_NOT_EXIST);
	}

	/* Walk the list to get the desired table
	 * Since the if (Instance == 1) check above checked for the
	 * first table, setting table_desc equal to the .Next member
	 * is actually pointing to the second table.  Therefore, we
	 * need to walk from the 2nd table until we reach the Instance
	 * that the user is looking for and return its table pointer.
	 */
	table_desc = acpi_gbl_table_lists[table_type].next;
	for (i = 2; i < instance; i++) {
		table_desc = table_desc->next;
	}

	/* We are now pointing to the requested table's descriptor */

	*table_ptr_loc = table_desc->pointer;

	return_ACPI_STATUS(AE_OK);
}
Commit	Line	Data
1da177e4 LT	1	/******************************************************************************
	2	*
	3	* Module Name: tbget - ACPI Table get* routines
	4	*
	5	*****************************************************************************/
	6
	7	/*
4a90c7e8	8	* Copyright (C) 2000 - 2006, R. Byron Moore
1da177e4 LT	9	* All rights reserved.
	10	*
	11	* Redistribution and use in source and binary forms, with or without
	12	* modification, are permitted provided that the following conditions
	13	* are met:
	14	* 1. Redistributions of source code must retain the above copyright
	15	* notice, this list of conditions, and the following disclaimer,
	16	* without modification.
	17	* 2. Redistributions in binary form must reproduce at minimum a disclaimer
	18	* substantially similar to the "NO WARRANTY" disclaimer below
	19	* ("Disclaimer") and any redistribution must be conditioned upon
	20	* including a substantially similar Disclaimer requirement for further
	21	* binary redistribution.
	22	* 3. Neither the names of the above-listed copyright holders nor the names
	23	* of any contributors may be used to endorse or promote products derived
	24	* from this software without specific prior written permission.
	25	*
	26	* Alternatively, this software may be distributed under the terms of the
	27	* GNU General Public License ("GPL") version 2 as published by the Free
	28	* Software Foundation.
	29	*
	30	* NO WARRANTY
	31	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
	32	* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
	33	* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
	34	* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
	35	* HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	36	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	37	* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	38	* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
	39	* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
	40	* IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
	41	* POSSIBILITY OF SUCH DAMAGES.
	42	*/
	43
1da177e4 LT	44	#include <acpi/acpi.h>
	45	#include <acpi/actables.h>
	46
1da177e4	47	#define _COMPONENT ACPI_TABLES
4be44fcd	48	ACPI_MODULE_NAME("tbget")
1da177e4	49
44f6c012	50	/* Local prototypes */
44f6c012	51	static acpi_status
4be44fcd LB	52	acpi_tb_get_this_table(struct acpi_pointer *address,
	53	struct acpi_table_header *header,
	54	struct acpi_table_desc *table_info);
44f6c012 RM	55
44f6c012 RM	56	static acpi_status
4be44fcd LB	57	acpi_tb_table_override(struct acpi_table_header *header,
4be44fcd LB	58	struct acpi_table_desc *table_info);
1da177e4 LT	59
	60	/*******************************************************************************
	61	*
	62	* FUNCTION: acpi_tb_get_table
	63	*
	64	* PARAMETERS: Address - Address of table to retrieve. Can be
	65	* Logical or Physical
	66	* table_info - Where table info is returned
	67	*
	68	* RETURN: None
	69	*
	70	* DESCRIPTION: Get entire table of unknown size.
	71	*
	72	******************************************************************************/
	73
	74	acpi_status
4be44fcd LB	75	acpi_tb_get_table(struct acpi_pointer *address,
4be44fcd LB	76	struct acpi_table_desc *table_info)
1da177e4	77	{
4be44fcd LB	78	acpi_status status;
4be44fcd LB	79	struct acpi_table_header header;
1da177e4	80
4be44fcd	81	ACPI_FUNCTION_TRACE("tb_get_table");
1da177e4	82
44f6c012 RM	83	/* Get the header in order to get signature and table size */
44f6c012 RM	84
4be44fcd LB	85	status = acpi_tb_get_table_header(address, &header);
	86	if (ACPI_FAILURE(status)) {
	87	return_ACPI_STATUS(status);
1da177e4 LT	88	}
	89
	90	/* Get the entire table */
	91
4be44fcd LB	92	status = acpi_tb_get_table_body(address, &header, table_info);
4be44fcd LB	93	if (ACPI_FAILURE(status)) {
b8e4d893 BM	94	ACPI_EXCEPTION((AE_INFO, status,
	95	"Could not get ACPI table (size %X)",
	96	header.length));
4be44fcd	97	return_ACPI_STATUS(status);
1da177e4 LT	98	}
1da177e4 LT	99
4be44fcd	100	return_ACPI_STATUS(AE_OK);
1da177e4 LT	101	}
1da177e4 LT	102
1da177e4 LT	103	/*******************************************************************************
	104	*
	105	* FUNCTION: acpi_tb_get_table_header
	106	*
	107	* PARAMETERS: Address - Address of table to retrieve. Can be
	108	* Logical or Physical
	109	* return_header - Where the table header is returned
	110	*
	111	* RETURN: Status
	112	*
	113	* DESCRIPTION: Get an ACPI table header. Works in both physical or virtual
	114	* addressing mode. Works with both physical or logical pointers.
	115	* Table is either copied or mapped, depending on the pointer
	116	* type and mode of the processor.
	117	*
	118	******************************************************************************/
	119
	120	acpi_status
4be44fcd LB	121	acpi_tb_get_table_header(struct acpi_pointer *address,
4be44fcd LB	122	struct acpi_table_header *return_header)
1da177e4	123	{
4be44fcd LB	124	acpi_status status = AE_OK;
4be44fcd LB	125	struct acpi_table_header *header = NULL;
1da177e4	126
4be44fcd	127	ACPI_FUNCTION_TRACE("tb_get_table_header");
1da177e4 LT	128
1da177e4 LT	129	/*
44f6c012 RM	130	* Flags contains the current processor mode (Virtual or Physical
44f6c012 RM	131	* addressing) The pointer_type is either Logical or Physical
1da177e4 LT	132	*/
	133	switch (address->pointer_type) {
	134	case ACPI_PHYSMODE_PHYSPTR:
	135	case ACPI_LOGMODE_LOGPTR:
	136
	137	/* Pointer matches processor mode, copy the header */
	138
4be44fcd LB	139	ACPI_MEMCPY(return_header, address->pointer.logical,
4be44fcd LB	140	sizeof(struct acpi_table_header));
1da177e4 LT	141	break;
1da177e4 LT	142
1da177e4 LT	143	case ACPI_LOGMODE_PHYSPTR:
1da177e4 LT	144
4be44fcd	145	/* Create a logical address for the physical pointer */
1da177e4	146
4be44fcd LB	147	status = acpi_os_map_memory(address->pointer.physical,
	148	sizeof(struct acpi_table_header),
	149	(void *)&header);
	150	if (ACPI_FAILURE(status)) {
4be44fcd	151	return_ACPI_STATUS(status);
1da177e4 LT	152	}
	153
	154	/* Copy header and delete mapping */
	155
4be44fcd LB	156	ACPI_MEMCPY(return_header, header,
	157	sizeof(struct acpi_table_header));
	158	acpi_os_unmap_memory(header, sizeof(struct acpi_table_header));
1da177e4 LT	159	break;
1da177e4 LT	160
1da177e4 LT	161	default:
1da177e4 LT	162
b8e4d893 BM	163	ACPI_ERROR((AE_INFO, "Invalid address flags %X",
b8e4d893 BM	164	address->pointer_type));
4be44fcd	165	return_ACPI_STATUS(AE_BAD_PARAMETER);
1da177e4 LT	166	}
1da177e4 LT	167
4be44fcd LB	168	ACPI_DEBUG_PRINT((ACPI_DB_TABLES, "Table Signature: [%4.4s]\n",
4be44fcd LB	169	return_header->signature));
1da177e4	170
4be44fcd	171	return_ACPI_STATUS(AE_OK);
1da177e4 LT	172	}
1da177e4 LT	173
1da177e4 LT	174	/*******************************************************************************
	175	*
	176	* FUNCTION: acpi_tb_get_table_body
	177	*
	178	* PARAMETERS: Address - Address of table to retrieve. Can be
	179	* Logical or Physical
	180	* Header - Header of the table to retrieve
	181	* table_info - Where the table info is returned
	182	*
	183	* RETURN: Status
	184	*
	185	* DESCRIPTION: Get an entire ACPI table with support to allow the host OS to
	186	* replace the table with a newer version (table override.)
	187	* Works in both physical or virtual
	188	* addressing mode. Works with both physical or logical pointers.
	189	* Table is either copied or mapped, depending on the pointer
	190	* type and mode of the processor.
	191	*
	192	******************************************************************************/
	193
	194	acpi_status
4be44fcd LB	195	acpi_tb_get_table_body(struct acpi_pointer *address,
	196	struct acpi_table_header *header,
	197	struct acpi_table_desc *table_info)
1da177e4	198	{
4be44fcd	199	acpi_status status;
1da177e4	200
4be44fcd	201	ACPI_FUNCTION_TRACE("tb_get_table_body");
1da177e4 LT	202
1da177e4 LT	203	if (!table_info \|\| !address) {
4be44fcd	204	return_ACPI_STATUS(AE_BAD_PARAMETER);
1da177e4 LT	205	}
1da177e4 LT	206
44f6c012 RM	207	/* Attempt table override. */
44f6c012 RM	208
4be44fcd LB	209	status = acpi_tb_table_override(header, table_info);
4be44fcd LB	210	if (ACPI_SUCCESS(status)) {
1da177e4 LT	211	/* Table was overridden by the host OS */
1da177e4 LT	212
4be44fcd	213	return_ACPI_STATUS(status);
1da177e4 LT	214	}
	215
	216	/* No override, get the original table */
	217
4be44fcd LB	218	status = acpi_tb_get_this_table(address, header, table_info);
4be44fcd LB	219	return_ACPI_STATUS(status);
1da177e4 LT	220	}
1da177e4 LT	221
1da177e4 LT	222	/*******************************************************************************
	223	*
	224	* FUNCTION: acpi_tb_table_override
	225	*
	226	* PARAMETERS: Header - Pointer to table header
	227	* table_info - Return info if table is overridden
	228	*
	229	* RETURN: None
	230	*
	231	* DESCRIPTION: Attempts override of current table with a new one if provided
	232	* by the host OS.
	233	*
	234	******************************************************************************/
	235
44f6c012	236	static acpi_status
4be44fcd LB	237	acpi_tb_table_override(struct acpi_table_header *header,
4be44fcd LB	238	struct acpi_table_desc *table_info)
1da177e4	239	{
4be44fcd LB	240	struct acpi_table_header *new_table;
	241	acpi_status status;
	242	struct acpi_pointer address;
1da177e4	243
4be44fcd	244	ACPI_FUNCTION_TRACE("tb_table_override");
1da177e4 LT	245
	246	/*
	247	* The OSL will examine the header and decide whether to override this
	248	* table. If it decides to override, a table will be returned in new_table,
	249	* which we will then copy.
	250	*/
4be44fcd LB	251	status = acpi_os_table_override(header, &new_table);
4be44fcd LB	252	if (ACPI_FAILURE(status)) {
1da177e4 LT	253	/* Some severe error from the OSL, but we basically ignore it */
1da177e4 LT	254
b8e4d893 BM	255	ACPI_EXCEPTION((AE_INFO, status,
b8e4d893 BM	256	"Could not override ACPI table"));
4be44fcd	257	return_ACPI_STATUS(status);
1da177e4 LT	258	}
	259
	260	if (!new_table) {
	261	/* No table override */
	262
4be44fcd	263	return_ACPI_STATUS(AE_NO_ACPI_TABLES);
1da177e4 LT	264	}
	265
	266	/*
	267	* We have a new table to override the old one. Get a copy of
	268	* the new one. We know that the new table has a logical pointer.
	269	*/
4be44fcd	270	address.pointer_type = ACPI_LOGICAL_POINTER \| ACPI_LOGICAL_ADDRESSING;
1da177e4 LT	271	address.pointer.logical = new_table;
1da177e4 LT	272
4be44fcd LB	273	status = acpi_tb_get_this_table(&address, new_table, table_info);
4be44fcd LB	274	if (ACPI_FAILURE(status)) {
b8e4d893	275	ACPI_EXCEPTION((AE_INFO, status, "Could not copy ACPI table"));
4be44fcd	276	return_ACPI_STATUS(status);
1da177e4 LT	277	}
	278
	279	/* Copy the table info */
	280
b8e4d893 BM	281	ACPI_INFO((AE_INFO, "Table [%4.4s] replaced by host OS",
b8e4d893 BM	282	table_info->pointer->signature));
1da177e4	283
4be44fcd	284	return_ACPI_STATUS(AE_OK);
1da177e4 LT	285	}
1da177e4 LT	286
1da177e4 LT	287	/*******************************************************************************
	288	*
	289	* FUNCTION: acpi_tb_get_this_table
	290	*
	291	* PARAMETERS: Address - Address of table to retrieve. Can be
	292	* Logical or Physical
	293	* Header - Header of the table to retrieve
	294	* table_info - Where the table info is returned
	295	*
	296	* RETURN: Status
	297	*
	298	* DESCRIPTION: Get an entire ACPI table. Works in both physical or virtual
	299	* addressing mode. Works with both physical or logical pointers.
	300	* Table is either copied or mapped, depending on the pointer
	301	* type and mode of the processor.
	302	*
	303	******************************************************************************/
	304
44f6c012	305	static acpi_status
4be44fcd LB	306	acpi_tb_get_this_table(struct acpi_pointer *address,
	307	struct acpi_table_header *header,
	308	struct acpi_table_desc *table_info)
1da177e4	309	{
4be44fcd LB	310	struct acpi_table_header *full_table = NULL;
	311	u8 allocation;
	312	acpi_status status = AE_OK;
1da177e4	313
4be44fcd	314	ACPI_FUNCTION_TRACE("tb_get_this_table");
1da177e4 LT	315
1da177e4 LT	316	/*
44f6c012 RM	317	* Flags contains the current processor mode (Virtual or Physical
44f6c012 RM	318	* addressing) The pointer_type is either Logical or Physical
1da177e4 LT	319	*/
	320	switch (address->pointer_type) {
	321	case ACPI_PHYSMODE_PHYSPTR:
	322	case ACPI_LOGMODE_LOGPTR:
	323
	324	/* Pointer matches processor mode, copy the table to a new buffer */
	325
4be44fcd	326	full_table = ACPI_MEM_ALLOCATE(header->length);
1da177e4	327	if (!full_table) {
b8e4d893 BM	328	ACPI_ERROR((AE_INFO,
	329	"Could not allocate table memory for [%4.4s] length %X",
	330	header->signature, header->length));
4be44fcd	331	return_ACPI_STATUS(AE_NO_MEMORY);
1da177e4 LT	332	}
	333
	334	/* Copy the entire table (including header) to the local buffer */
	335
4be44fcd LB	336	ACPI_MEMCPY(full_table, address->pointer.logical,
4be44fcd LB	337	header->length);
1da177e4 LT	338
	339	/* Save allocation type */
	340
	341	allocation = ACPI_MEM_ALLOCATED;
	342	break;
	343
1da177e4 LT	344	case ACPI_LOGMODE_PHYSPTR:
	345
	346	/*
	347	* Just map the table's physical memory
	348	* into our address space.
	349	*/
4be44fcd LB	350	status = acpi_os_map_memory(address->pointer.physical,
	351	(acpi_size) header->length,
	352	(void *)&full_table);
	353	if (ACPI_FAILURE(status)) {
b8e4d893 BM	354	ACPI_ERROR((AE_INFO,
	355	"Could not map memory for table [%4.4s] at %8.8X%8.8X for length %X",
	356	header->signature,
	357	ACPI_FORMAT_UINT64(address->pointer.
	358	physical),
	359	header->length));
1da177e4 LT	360	return (status);
	361	}
	362
	363	/* Save allocation type */
	364
	365	allocation = ACPI_MEM_MAPPED;
	366	break;
	367
1da177e4 LT	368	default:
1da177e4 LT	369
b8e4d893 BM	370	ACPI_ERROR((AE_INFO, "Invalid address flags %X",
b8e4d893 BM	371	address->pointer_type));
4be44fcd	372	return_ACPI_STATUS(AE_BAD_PARAMETER);
1da177e4 LT	373	}
	374
	375	/*
	376	* Validate checksum for _most_ tables,
	377	* even the ones whose signature we don't recognize
	378	*/
	379	if (table_info->type != ACPI_TABLE_FACS) {
4be44fcd	380	status = acpi_tb_verify_table_checksum(full_table);
1da177e4 LT	381
1da177e4 LT	382	#if (!ACPI_CHECKSUM_ABORT)
4be44fcd	383	if (ACPI_FAILURE(status)) {
1da177e4 LT	384	/* Ignore the error if configuration says so */
	385
	386	status = AE_OK;
	387	}
	388	#endif
	389	}
	390
	391	/* Return values */
	392
4be44fcd LB	393	table_info->pointer = full_table;
	394	table_info->length = (acpi_size) header->length;
	395	table_info->allocation = allocation;
1da177e4	396
4be44fcd LB	397	ACPI_DEBUG_PRINT((ACPI_DB_INFO,
	398	"Found table [%4.4s] at %8.8X%8.8X, mapped/copied to %p\n",
	399	full_table->signature,
	400	ACPI_FORMAT_UINT64(address->pointer.physical),
	401	full_table));
1da177e4	402
4be44fcd	403	return_ACPI_STATUS(status);
1da177e4 LT	404	}
1da177e4 LT	405
1da177e4 LT	406	/*******************************************************************************
	407	*
	408	* FUNCTION: acpi_tb_get_table_ptr
	409	*
	410	* PARAMETERS: table_type - one of the defined table types
	411	* Instance - Which table of this type
	412	* table_ptr_loc - pointer to location to place the pointer for
	413	* return
	414	*
	415	* RETURN: Status
	416	*
	417	* DESCRIPTION: This function is called to get the pointer to an ACPI table.
	418	*
	419	******************************************************************************/
	420
	421	acpi_status
4be44fcd LB	422	acpi_tb_get_table_ptr(acpi_table_type table_type,
4be44fcd LB	423	u32 instance, struct acpi_table_header **table_ptr_loc)
1da177e4	424	{
4be44fcd LB	425	struct acpi_table_desc *table_desc;
4be44fcd LB	426	u32 i;
1da177e4	427
4be44fcd	428	ACPI_FUNCTION_TRACE("tb_get_table_ptr");
1da177e4 LT	429
1da177e4 LT	430	if (!acpi_gbl_DSDT) {
4be44fcd	431	return_ACPI_STATUS(AE_NO_ACPI_TABLES);
1da177e4 LT	432	}
	433
	434	if (table_type > ACPI_TABLE_MAX) {
4be44fcd	435	return_ACPI_STATUS(AE_BAD_PARAMETER);
1da177e4 LT	436	}
	437
	438	/*
	439	* For all table types (Single/Multiple), the first
	440	* instance is always in the list head.
	441	*/
	442	if (instance == 1) {
	443	/* Get the first */
	444
	445	*table_ptr_loc = NULL;
	446	if (acpi_gbl_table_lists[table_type].next) {
4be44fcd LB	447	*table_ptr_loc =
4be44fcd LB	448	acpi_gbl_table_lists[table_type].next->pointer;
1da177e4	449	}
4be44fcd	450	return_ACPI_STATUS(AE_OK);
1da177e4 LT	451	}
1da177e4 LT	452
44f6c012 RM	453	/* Check for instance out of range */
44f6c012 RM	454
1da177e4	455	if (instance > acpi_gbl_table_lists[table_type].count) {
4be44fcd	456	return_ACPI_STATUS(AE_NOT_EXIST);
1da177e4 LT	457	}
	458
	459	/* Walk the list to get the desired table
	460	* Since the if (Instance == 1) check above checked for the
	461	* first table, setting table_desc equal to the .Next member
	462	* is actually pointing to the second table. Therefore, we
	463	* need to walk from the 2nd table until we reach the Instance
	464	* that the user is looking for and return its table pointer.
	465	*/
	466	table_desc = acpi_gbl_table_lists[table_type].next;
	467	for (i = 2; i < instance; i++) {
	468	table_desc = table_desc->next;
	469	}
	470
	471	/* We are now pointing to the requested table's descriptor */
	472
	473	*table_ptr_loc = table_desc->pointer;
	474
4be44fcd	475	return_ACPI_STATUS(AE_OK);
1da177e4	476	}