drivers/acpi/utilities/utinit.c

   1 /******************************************************************************
   2  *
   3  * Module Name: utinit - Common ACPI subsystem initialization
   4  *
   5  *****************************************************************************/
   6
   7 /*
   8  * Copyright (C) 2000 - 2006, R. Byron Moore
   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 <acpi/acnamesp.h>
  46 #include <acpi/acevents.h>
  47 #include <acpi/actables.h>
  48
  49 #define _COMPONENT          ACPI_UTILITIES
  50 ACPI_MODULE_NAME("utinit")
  51
  52 /* Local prototypes */
  53 static void acpi_ut_fadt_register_error(char *register_name, u32 value);
  54
  55 static void acpi_ut_terminate(void);
  56
  57 /*******************************************************************************
  58  *
  59  * FUNCTION:    acpi_ut_fadt_register_error
  60  *
  61  * PARAMETERS:  register_name           - Pointer to string identifying register
  62  *              Value                   - Actual register contents value
  63  *
  64  * RETURN:      None
  65  *
  66  * DESCRIPTION: Display failure message
  67  *
  68  ******************************************************************************/
  69
  70 static void acpi_ut_fadt_register_error(char *register_name, u32 value)
  71 {
  72
  73         ACPI_WARNING((AE_INFO, "Invalid FADT value %s = %X",
  74                       register_name, value));
  75 }
  76
  77 /******************************************************************************
  78  *
  79  * FUNCTION:    acpi_ut_validate_fadt
  80  *
  81  * PARAMETERS:  None
  82  *
  83  * RETURN:      Status
  84  *
  85  * DESCRIPTION: Validate various ACPI registers in the FADT
  86  *
  87  ******************************************************************************/
  88
  89 acpi_status acpi_ut_validate_fadt(void)
  90 {
  91
  92         /*
  93          * Verify Fixed ACPI Description Table fields,
  94          * but don't abort on any problems, just display error
  95          */
  96         if (acpi_gbl_FADT.pm1_event_length < 4) {
  97                 acpi_ut_fadt_register_error("Pm1EventLength",
  98                                             (u32) acpi_gbl_FADT.
  99                                             pm1_event_length);
 100         }
 101
 102         if (acpi_gbl_FADT.pm_timer_length < 4) {
 103                 acpi_ut_fadt_register_error("PmTimerLength",
 104                                             (u32) acpi_gbl_FADT.
 105                                             pm_timer_length);
 106         }
 107
 108         if (!acpi_gbl_FADT.pm1_control_length) {
 109                 acpi_ut_fadt_register_error("Pm1ControlLength", 0);
 110         }
 111
 112         if (!acpi_gbl_FADT.xpm1a_event_block.address) {
 113                 acpi_ut_fadt_register_error("XPm1aEventBlock.Address", 0);
 114         }
 115
 116         if (!acpi_gbl_FADT.xpm1a_control_block.address) {
 117                 acpi_ut_fadt_register_error("XPm1aControlBlock.Address", 0);
 118         }
 119
 120         if (!acpi_gbl_FADT.xpm_timer_block.address) {
 121                 acpi_ut_fadt_register_error("XPmTimerBlock.Address", 0);
 122         }
 123
 124         if ((acpi_gbl_FADT.xpm2_control_block.address &&
 125              !acpi_gbl_FADT.pm2_control_length)) {
 126                 acpi_ut_fadt_register_error("Pm2ControlLength",
 127                                             (u32) acpi_gbl_FADT.
 128                                             pm2_control_length);
 129         }
 130
 131         /* Length of GPE blocks must be a multiple of 2 */
 132
 133         if (acpi_gbl_FADT.xgpe0_block.address &&
 134             (acpi_gbl_FADT.gpe0_block_length & 1)) {
 135                 acpi_ut_fadt_register_error("Gpe0BlockLength",
 136                                             (u32) acpi_gbl_FADT.
 137                                             gpe0_block_length);
 138         }
 139
 140         if (acpi_gbl_FADT.xgpe1_block.address &&
 141             (acpi_gbl_FADT.gpe1_block_length & 1)) {
 142                 acpi_ut_fadt_register_error("Gpe1BlockLength",
 143                                             (u32) acpi_gbl_FADT.
 144                                             gpe1_block_length);
 145         }
 146
 147         return (AE_OK);
 148 }
 149
 150 /******************************************************************************
 151  *
 152  * FUNCTION:    acpi_ut_terminate
 153  *
 154  * PARAMETERS:  none
 155  *
 156  * RETURN:      none
 157  *
 158  * DESCRIPTION: Free global memory
 159  *
 160  ******************************************************************************/
 161
 162 static void acpi_ut_terminate(void)
 163 {
 164         struct acpi_gpe_block_info *gpe_block;
 165         struct acpi_gpe_block_info *next_gpe_block;
 166         struct acpi_gpe_xrupt_info *gpe_xrupt_info;
 167         struct acpi_gpe_xrupt_info *next_gpe_xrupt_info;
 168
 169         ACPI_FUNCTION_TRACE(ut_terminate);
 170
 171         /* Free global GPE blocks and related info structures */
 172
 173         gpe_xrupt_info = acpi_gbl_gpe_xrupt_list_head;
 174         while (gpe_xrupt_info) {
 175                 gpe_block = gpe_xrupt_info->gpe_block_list_head;
 176                 while (gpe_block) {
 177                         next_gpe_block = gpe_block->next;
 178                         ACPI_FREE(gpe_block->event_info);
 179                         ACPI_FREE(gpe_block->register_info);
 180                         ACPI_FREE(gpe_block);
 181
 182                         gpe_block = next_gpe_block;
 183                 }
 184                 next_gpe_xrupt_info = gpe_xrupt_info->next;
 185                 ACPI_FREE(gpe_xrupt_info);
 186                 gpe_xrupt_info = next_gpe_xrupt_info;
 187         }
 188
 189         return_VOID;
 190 }
 191
 192 /*******************************************************************************
 193  *
 194  * FUNCTION:    acpi_ut_subsystem_shutdown
 195  *
 196  * PARAMETERS:  none
 197  *
 198  * RETURN:      none
 199  *
 200  * DESCRIPTION: Shutdown the various subsystems.  Don't delete the mutex
 201  *              objects here -- because the AML debugger may be still running.
 202  *
 203  ******************************************************************************/
 204
 205 void acpi_ut_subsystem_shutdown(void)
 206 {
 207
 208         ACPI_FUNCTION_TRACE(ut_subsystem_shutdown);
 209
 210         /* Just exit if subsystem is already shutdown */
 211
 212         if (acpi_gbl_shutdown) {
 213                 ACPI_ERROR((AE_INFO, "ACPI Subsystem is already terminated"));
 214                 return_VOID;
 215         }
 216
 217         /* Subsystem appears active, go ahead and shut it down */
 218
 219         acpi_gbl_shutdown = TRUE;
 220         acpi_gbl_startup_flags = 0;
 221         ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Shutting down ACPI Subsystem\n"));
 222
 223         /* Close the acpi_event Handling */
 224
 225         acpi_ev_terminate();
 226
 227         /* Close the Namespace */
 228
 229         acpi_ns_terminate();
 230
 231         /* Delete the ACPI tables */
 232
 233         acpi_tb_terminate();
 234
 235         /* Close the globals */
 236
 237         acpi_ut_terminate();
 238
 239         /* Purge the local caches */
 240
 241         (void)acpi_ut_delete_caches();
 242         return_VOID;
 243 }