Home | History | Annotate | Line # | Download | only in tables
tbfind.c revision 1.1.1.3 
      1 /******************************************************************************
      2  *
      3  * Module Name: tbfind   - find table
      4  *
      5  *****************************************************************************/
      6 
      7 /*
      8  * Copyright (C) 2000 - 2013, Intel Corp.
      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 
     44 #define __TBFIND_C__
     45 
     46 #include "acpi.h"
     47 #include "accommon.h"
     48 #include "actables.h"
     49 
     50 #define _COMPONENT          ACPI_TABLES
     51         ACPI_MODULE_NAME    ("tbfind")
     52 
     53 
     54 /*******************************************************************************
     55  *
     56  * FUNCTION:    AcpiTbFindTable
     57  *
     58  * PARAMETERS:  Signature           - String with ACPI table signature
     59  *              OemId               - String with the table OEM ID
     60  *              OemTableId          - String with the OEM Table ID
     61  *              TableIndex          - Where the table index is returned
     62  *
     63  * RETURN:      Status and table index
     64  *
     65  * DESCRIPTION: Find an ACPI table (in the RSDT/XSDT) that matches the
     66  *              Signature, OEM ID and OEM Table ID. Returns an index that can
     67  *              be used to get the table header or entire table.
     68  *
     69  ******************************************************************************/
     70 
     71 ACPI_STATUS
     72 AcpiTbFindTable (
     73     char                    *Signature,
     74     char                    *OemId,
     75     char                    *OemTableId,
     76     UINT32                  *TableIndex)
     77 {
     78     UINT32                  i;
     79     ACPI_STATUS             Status;
     80     ACPI_TABLE_HEADER       Header;
     81 
     82 
     83     ACPI_FUNCTION_TRACE (TbFindTable);
     84 
     85 
     86     /* Normalize the input strings */
     87 
     88     ACPI_MEMSET (&Header, 0, sizeof (ACPI_TABLE_HEADER));
     89     ACPI_MOVE_NAME (Header.Signature, Signature);
     90     ACPI_STRNCPY (Header.OemId, OemId, ACPI_OEM_ID_SIZE);
     91     ACPI_STRNCPY (Header.OemTableId, OemTableId, ACPI_OEM_TABLE_ID_SIZE);
     92 
     93     /* Search for the table */
     94 
     95     for (i = 0; i < AcpiGbl_RootTableList.CurrentTableCount; ++i)
     96     {
     97         if (ACPI_MEMCMP (&(AcpiGbl_RootTableList.Tables[i].Signature),
     98                             Header.Signature, ACPI_NAME_SIZE))
     99         {
    100             /* Not the requested table */
    101 
    102             continue;
    103         }
    104 
    105         /* Table with matching signature has been found */
    106 
    107         if (!AcpiGbl_RootTableList.Tables[i].Pointer)
    108         {
    109             /* Table is not currently mapped, map it */
    110 
    111             Status = AcpiTbVerifyTable (&AcpiGbl_RootTableList.Tables[i]);
    112             if (ACPI_FAILURE (Status))
    113             {
    114                 return_ACPI_STATUS (Status);
    115             }
    116 
    117             if (!AcpiGbl_RootTableList.Tables[i].Pointer)
    118             {
    119                 continue;
    120             }
    121         }
    122 
    123         /* Check for table match on all IDs */
    124 
    125         if (!ACPI_MEMCMP (AcpiGbl_RootTableList.Tables[i].Pointer->Signature,
    126                             Header.Signature, ACPI_NAME_SIZE) &&
    127             (!OemId[0] ||
    128              !ACPI_MEMCMP (AcpiGbl_RootTableList.Tables[i].Pointer->OemId,
    129                              Header.OemId, ACPI_OEM_ID_SIZE)) &&
    130             (!OemTableId[0] ||
    131              !ACPI_MEMCMP (AcpiGbl_RootTableList.Tables[i].Pointer->OemTableId,
    132                              Header.OemTableId, ACPI_OEM_TABLE_ID_SIZE)))
    133         {
    134             *TableIndex = i;
    135 
    136             ACPI_DEBUG_PRINT ((ACPI_DB_TABLES, "Found table [%4.4s]\n",
    137                 Header.Signature));
    138             return_ACPI_STATUS (AE_OK);
    139         }
    140     }
    141 
    142     return_ACPI_STATUS (AE_NOT_FOUND);
    143 }
    144