drivers/acpi/acpica/tbinstal.c

   1 /******************************************************************************
   2  *
   3  * Module Name: tbinstal - ACPI table installation and removal
   4  *
   5  *****************************************************************************/
   6
   7 /*
   8  * Copyright (C) 2000 - 2014, 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 #include <acpi/acpi.h>
  45 #include "accommon.h"
  46 #include "actables.h"
  47
  48 #define _COMPONENT          ACPI_TABLES
  49 ACPI_MODULE_NAME("tbinstal")
  50
  51 /* Local prototypes */
  52 static u8
  53 acpi_tb_compare_tables(struct acpi_table_desc *table_desc, u32 table_index);
  54
  55 /*******************************************************************************
  56  *
  57  * FUNCTION:    acpi_tb_compare_tables
  58  *
  59  * PARAMETERS:  table_desc          - Table 1 descriptor to be compared
  60  *              table_index         - Index of table 2 to be compared
  61  *
  62  * RETURN:      TRUE if both tables are identical.
  63  *
  64  * DESCRIPTION: This function compares a table with another table that has
  65  *              already been installed in the root table list.
  66  *
  67  ******************************************************************************/
  68
  69 static u8
  70 acpi_tb_compare_tables(struct acpi_table_desc *table_desc, u32 table_index)
  71 {
  72         acpi_status status = AE_OK;
  73         u8 is_identical;
  74         struct acpi_table_header *table;
  75         u32 table_length;
  76         u8 table_flags;
  77
  78         status =
  79             acpi_tb_acquire_table(&acpi_gbl_root_table_list.tables[table_index],
  80                                   &table, &table_length, &table_flags);
  81         if (ACPI_FAILURE(status)) {
  82                 return (FALSE);
  83         }
  84
  85         /*
  86          * Check for a table match on the entire table length,
  87          * not just the header.
  88          */
  89         is_identical = (u8)((table_desc->length != table_length ||
  90                              ACPI_MEMCMP(table_desc->pointer, table,
  91                                          table_length)) ? FALSE : TRUE);
  92
  93         /* Release the acquired table */
  94
  95         acpi_tb_release_table(table, table_length, table_flags);
  96         return (is_identical);
  97 }
  98
  99 /*******************************************************************************
 100  *
 101  * FUNCTION:    acpi_tb_install_table_with_override
 102  *
 103  * PARAMETERS:  table_index             - Index into root table array
 104  *              new_table_desc          - New table descriptor to install
 105  *              override                - Whether override should be performed
 106  *
 107  * RETURN:      None
 108  *
 109  * DESCRIPTION: Install an ACPI table into the global data structure. The
 110  *              table override mechanism is called to allow the host
 111  *              OS to replace any table before it is installed in the root
 112  *              table array.
 113  *
 114  ******************************************************************************/
 115
 116 void
 117 acpi_tb_install_table_with_override(u32 table_index,
 118                                     struct acpi_table_desc *new_table_desc,
 119                                     u8 override)
 120 {
 121
 122         if (table_index >= acpi_gbl_root_table_list.current_table_count) {
 123                 return;
 124         }
 125
 126         /*
 127          * ACPI Table Override:
 128          *
 129          * Before we install the table, let the host OS override it with a new
 130          * one if desired. Any table within the RSDT/XSDT can be replaced,
 131          * including the DSDT which is pointed to by the FADT.
 132          */
 133         if (override) {
 134                 acpi_tb_override_table(new_table_desc);
 135         }
 136
 137         acpi_tb_init_table_descriptor(&acpi_gbl_root_table_list.
 138                                       tables[table_index],
 139                                       new_table_desc->address,
 140                                       new_table_desc->flags,
 141                                       new_table_desc->pointer);
 142
 143         acpi_tb_print_table_header(new_table_desc->address,
 144                                    new_table_desc->pointer);
 145
 146         /* Set the global integer width (based upon revision of the DSDT) */
 147
 148         if (table_index == ACPI_TABLE_INDEX_DSDT) {
 149                 acpi_ut_set_integer_width(new_table_desc->pointer->revision);
 150         }
 151 }
 152
 153 /*******************************************************************************
 154  *
 155  * FUNCTION:    acpi_tb_install_fixed_table
 156  *
 157  * PARAMETERS:  address                 - Physical address of DSDT or FACS
 158  *              signature               - Table signature, NULL if no need to
 159  *                                        match
 160  *              table_index             - Index into root table array
 161  *
 162  * RETURN:      Status
 163  *
 164  * DESCRIPTION: Install a fixed ACPI table (DSDT/FACS) into the global data
 165  *              structure.
 166  *
 167  ******************************************************************************/
 168
 169 acpi_status
 170 acpi_tb_install_fixed_table(acpi_physical_address address,
 171                             char *signature, u32 table_index)
 172 {
 173         struct acpi_table_desc new_table_desc;
 174         acpi_status status;
 175
 176         ACPI_FUNCTION_TRACE(tb_install_fixed_table);
 177
 178         if (!address) {
 179                 ACPI_ERROR((AE_INFO,
 180                             "Null physical address for ACPI table [%s]",
 181                             signature));
 182                 return (AE_NO_MEMORY);
 183         }
 184
 185         /* Fill a table descriptor for validation */
 186
 187         status = acpi_tb_acquire_temp_table(&new_table_desc, address,
 188                                             ACPI_TABLE_ORIGIN_INTERNAL_PHYSICAL);
 189         if (ACPI_FAILURE(status)) {
 190                 ACPI_ERROR((AE_INFO, "Could not acquire table length at %p",
 191                             ACPI_CAST_PTR(void, address)));
 192                 return_ACPI_STATUS(status);
 193         }
 194
 195         /* Validate and verify a table before installation */
 196
 197         status = acpi_tb_verify_temp_table(&new_table_desc, signature);
 198         if (ACPI_FAILURE(status)) {
 199                 goto release_and_exit;
 200         }
 201
 202         acpi_tb_install_table_with_override(table_index, &new_table_desc, TRUE);
 203
 204 release_and_exit:
 205
 206         /* Release the temporary table descriptor */
 207
 208         acpi_tb_release_temp_table(&new_table_desc);
 209         return_ACPI_STATUS(status);
 210 }
 211
 212 /*******************************************************************************
 213  *
 214  * FUNCTION:    acpi_tb_install_standard_table
 215  *
 216  * PARAMETERS:  address             - Address of the table (might be a virtual
 217  *                                    address depending on the table_flags)
 218  *              flags               - Flags for the table
 219  *              reload              - Whether reload should be performed
 220  *              override            - Whether override should be performed
 221  *              table_index         - Where the table index is returned
 222  *
 223  * RETURN:      Status
 224  *
 225  * DESCRIPTION: This function is called to install an ACPI table that is
 226  *              neither DSDT nor FACS (a "standard" table.)
 227  *              When this function is called by "Load" or "LoadTable" opcodes,
 228  *              or by acpi_load_table() API, the "Reload" parameter is set.
 229  *              After sucessfully returning from this function, table is
 230  *              "INSTALLED" but not "VALIDATED".
 231  *
 232  ******************************************************************************/
 233
 234 acpi_status
 235 acpi_tb_install_standard_table(acpi_physical_address address,
 236                                u8 flags,
 237                                u8 reload, u8 override, u32 *table_index)
 238 {
 239         u32 i;
 240         acpi_status status = AE_OK;
 241         struct acpi_table_desc new_table_desc;
 242
 243         ACPI_FUNCTION_TRACE(tb_install_standard_table);
 244
 245         /* Acquire a temporary table descriptor for validation */
 246
 247         status = acpi_tb_acquire_temp_table(&new_table_desc, address, flags);
 248         if (ACPI_FAILURE(status)) {
 249                 ACPI_ERROR((AE_INFO, "Could not acquire table length at %p",
 250                             ACPI_CAST_PTR(void, address)));
 251                 return_ACPI_STATUS(status);
 252         }
 253
 254         /*
 255          * Optionally do not load any SSDTs from the RSDT/XSDT. This can
 256          * be useful for debugging ACPI problems on some machines.
 257          */
 258         if (!reload &&
 259             acpi_gbl_disable_ssdt_table_install &&
 260             ACPI_COMPARE_NAME(&new_table_desc.signature, ACPI_SIG_SSDT)) {
 261                 ACPI_INFO((AE_INFO, "Ignoring installation of %4.4s at %p",
 262                            new_table_desc.signature.ascii, ACPI_CAST_PTR(void,
 263                                                                          address)));
 264                 goto release_and_exit;
 265         }
 266
 267         /* Validate and verify a table before installation */
 268
 269         status = acpi_tb_verify_temp_table(&new_table_desc, NULL);
 270         if (ACPI_FAILURE(status)) {
 271                 goto release_and_exit;
 272         }
 273
 274         if (reload) {
 275                 /*
 276                  * Validate the incoming table signature.
 277                  *
 278                  * 1) Originally, we checked the table signature for "SSDT" or "PSDT".
 279                  * 2) We added support for OEMx tables, signature "OEM".
 280                  * 3) Valid tables were encountered with a null signature, so we just
 281                  *    gave up on validating the signature, (05/2008).
 282                  * 4) We encountered non-AML tables such as the MADT, which caused
 283                  *    interpreter errors and kernel faults. So now, we once again allow
 284                  *    only "SSDT", "OEMx", and now, also a null signature. (05/2011).
 285                  */
 286                 if ((new_table_desc.signature.ascii[0] != 0x00) &&
 287                     (!ACPI_COMPARE_NAME
 288                      (&new_table_desc.signature, ACPI_SIG_SSDT))
 289                     && (ACPI_STRNCMP(new_table_desc.signature.ascii, "OEM", 3)))
 290                 {
 291                         ACPI_BIOS_ERROR((AE_INFO,
 292                                          "Table has invalid signature [%4.4s] (0x%8.8X), "
 293                                          "must be SSDT or OEMx",
 294                                          acpi_ut_valid_acpi_name(new_table_desc.
 295                                                                  signature.
 296                                                                  ascii) ?
 297                                          new_table_desc.signature.
 298                                          ascii : "????",
 299                                          new_table_desc.signature.integer));
 300
 301                         status = AE_BAD_SIGNATURE;
 302                         goto release_and_exit;
 303                 }
 304
 305                 /* Check if table is already registered */
 306
 307                 for (i = 0; i < acpi_gbl_root_table_list.current_table_count;
 308                      ++i) {
 309                         /*
 310                          * Check for a table match on the entire table length,
 311                          * not just the header.
 312                          */
 313                         if (!acpi_tb_compare_tables(&new_table_desc, i)) {
 314                                 continue;
 315                         }
 316
 317                         /*
 318                          * Note: the current mechanism does not unregister a table if it is
 319                          * dynamically unloaded. The related namespace entries are deleted,
 320                          * but the table remains in the root table list.
 321                          *
 322                          * The assumption here is that the number of different tables that
 323                          * will be loaded is actually small, and there is minimal overhead
 324                          * in just keeping the table in case it is needed again.
 325                          *
 326                          * If this assumption changes in the future (perhaps on large
 327                          * machines with many table load/unload operations), tables will
 328                          * need to be unregistered when they are unloaded, and slots in the
 329                          * root table list should be reused when empty.
 330                          */
 331                         if (acpi_gbl_root_table_list.tables[i].
 332                             flags & ACPI_TABLE_IS_LOADED) {
 333
 334                                 /* Table is still loaded, this is an error */
 335
 336                                 status = AE_ALREADY_EXISTS;
 337                                 goto release_and_exit;
 338                         } else {
 339                                 /*
 340                                  * Table was unloaded, allow it to be reloaded.
 341                                  * As we are going to return AE_OK to the caller, we should
 342                                  * take the responsibility of freeing the input descriptor.
 343                                  * Refill the input descriptor to ensure
 344                                  * acpi_tb_install_table_with_override() can be called again to
 345                                  * indicate the re-installation.
 346                                  */
 347                                 acpi_tb_uninstall_table(&new_table_desc);
 348                                 *table_index = i;
 349                                 (void)acpi_ut_release_mutex(ACPI_MTX_TABLES);
 350                                 return_ACPI_STATUS(AE_OK);
 351                         }
 352                 }
 353         }
 354
 355         /* Add the table to the global root table list */
 356
 357         status = acpi_tb_get_next_root_index(&i);
 358         if (ACPI_FAILURE(status)) {
 359                 goto release_and_exit;
 360         }
 361
 362         *table_index = i;
 363         acpi_tb_install_table_with_override(i, &new_table_desc, override);
 364
 365 release_and_exit:
 366
 367         /* Release the temporary table descriptor */
 368
 369         acpi_tb_release_temp_table(&new_table_desc);
 370         return_ACPI_STATUS(status);
 371 }
 372
 373 /*******************************************************************************
 374  *
 375  * FUNCTION:    acpi_tb_override_table
 376  *
 377  * PARAMETERS:  old_table_desc      - Validated table descriptor to be
 378  *                                    overridden
 379  *
 380  * RETURN:      None
 381  *
 382  * DESCRIPTION: Attempt table override by calling the OSL override functions.
 383  *              Note: If the table is overridden, then the entire new table
 384  *              is acquired and returned by this function.
 385  *              Before/after invocation, the table descriptor is in a state
 386  *              that is "VALIDATED".
 387  *
 388  ******************************************************************************/
 389
 390 void acpi_tb_override_table(struct acpi_table_desc *old_table_desc)
 391 {
 392         acpi_status status;
 393         char *override_type;
 394         struct acpi_table_desc new_table_desc;
 395         struct acpi_table_header *table;
 396         acpi_physical_address address;
 397         u32 length;
 398
 399         /* (1) Attempt logical override (returns a logical address) */
 400
 401         status = acpi_os_table_override(old_table_desc->pointer, &table);
 402         if (ACPI_SUCCESS(status) && table) {
 403                 acpi_tb_acquire_temp_table(&new_table_desc,
 404                                            ACPI_PTR_TO_PHYSADDR(table),
 405                                            ACPI_TABLE_ORIGIN_EXTERNAL_VIRTUAL);
 406                 override_type = "Logical";
 407                 goto finish_override;
 408         }
 409
 410         /* (2) Attempt physical override (returns a physical address) */
 411
 412         status = acpi_os_physical_table_override(old_table_desc->pointer,
 413                                                  &address, &length);
 414         if (ACPI_SUCCESS(status) && address && length) {
 415                 acpi_tb_acquire_temp_table(&new_table_desc, address,
 416                                            ACPI_TABLE_ORIGIN_INTERNAL_PHYSICAL);
 417                 override_type = "Physical";
 418                 goto finish_override;
 419         }
 420
 421         return;                 /* There was no override */
 422
 423 finish_override:
 424
 425         /* Validate and verify a table before overriding */
 426
 427         status = acpi_tb_verify_temp_table(&new_table_desc, NULL);
 428         if (ACPI_FAILURE(status)) {
 429                 return;
 430         }
 431
 432         ACPI_INFO((AE_INFO, "%4.4s " ACPI_PRINTF_UINT
 433                    " %s table override, new table: " ACPI_PRINTF_UINT,
 434                    old_table_desc->signature.ascii,
 435                    ACPI_FORMAT_TO_UINT(old_table_desc->address),
 436                    override_type, ACPI_FORMAT_TO_UINT(new_table_desc.address)));
 437
 438         /* We can now uninstall the original table */
 439
 440         acpi_tb_uninstall_table(old_table_desc);
 441
 442         /*
 443          * Replace the original table descriptor and keep its state as
 444          * "VALIDATED".
 445          */
 446         acpi_tb_init_table_descriptor(old_table_desc, new_table_desc.address,
 447                                       new_table_desc.flags,
 448                                       new_table_desc.pointer);
 449         acpi_tb_validate_temp_table(old_table_desc);
 450
 451         /* Release the temporary table descriptor */
 452
 453         acpi_tb_release_temp_table(&new_table_desc);
 454 }
 455
 456 /*******************************************************************************
 457  *
 458  * FUNCTION:    acpi_tb_store_table
 459  *
 460  * PARAMETERS:  address             - Table address
 461  *              table               - Table header
 462  *              length              - Table length
 463  *              flags               - Install flags
 464  *              table_index         - Where the table index is returned
 465  *
 466  * RETURN:      Status and table index.
 467  *
 468  * DESCRIPTION: Add an ACPI table to the global table list
 469  *
 470  ******************************************************************************/
 471
 472 acpi_status
 473 acpi_tb_store_table(acpi_physical_address address,
 474                     struct acpi_table_header * table,
 475                     u32 length, u8 flags, u32 *table_index)
 476 {
 477         acpi_status status;
 478         struct acpi_table_desc *table_desc;
 479
 480         status = acpi_tb_get_next_root_index(table_index);
 481         if (ACPI_FAILURE(status)) {
 482                 return (status);
 483         }
 484
 485         /* Initialize added table */
 486
 487         table_desc = &acpi_gbl_root_table_list.tables[*table_index];
 488         acpi_tb_init_table_descriptor(table_desc, address, flags, table);
 489         table_desc->pointer = table;
 490         return (AE_OK);
 491 }
 492
 493 /*******************************************************************************
 494  *
 495  * FUNCTION:    acpi_tb_uninstall_table
 496  *
 497  * PARAMETERS:  table_desc          - Table descriptor
 498  *
 499  * RETURN:      None
 500  *
 501  * DESCRIPTION: Delete one internal ACPI table
 502  *
 503  ******************************************************************************/
 504
 505 void acpi_tb_uninstall_table(struct acpi_table_desc *table_desc)
 506 {
 507
 508         ACPI_FUNCTION_TRACE(tb_uninstall_table);
 509
 510         /* Table must be installed */
 511
 512         if (!table_desc->address) {
 513                 return_VOID;
 514         }
 515
 516         acpi_tb_invalidate_table(table_desc);
 517
 518         if ((table_desc->flags & ACPI_TABLE_ORIGIN_MASK) ==
 519             ACPI_TABLE_ORIGIN_INTERNAL_VIRTUAL) {
 520                 ACPI_FREE(ACPI_CAST_PTR(void, table_desc->address));
 521         }
 522
 523         table_desc->address = ACPI_PTR_TO_PHYSADDR(NULL);
 524         return_VOID;
 525 }