1 /******************************************************************************
3 * Module Name: utinit - Common ACPI subsystem initialization
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2005, R. Byron Moore
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
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.
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.
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.
45 #include <acpi/acpi.h>
46 #include <acpi/acnamesp.h>
47 #include <acpi/acevents.h>
49 #define _COMPONENT ACPI_UTILITIES
50 ACPI_MODULE_NAME ("utinit")
52 /* Local prototypes */
55 acpi_ut_fadt_register_error (
60 static void acpi_ut_terminate (
64 /*******************************************************************************
66 * FUNCTION: acpi_ut_fadt_register_error
68 * PARAMETERS: register_name - Pointer to string identifying register
69 * Value - Actual register contents value
70 * Offset - Byte offset in the FADT
72 * RETURN: AE_BAD_VALUE
74 * DESCRIPTION: Display failure message
76 ******************************************************************************/
79 acpi_ut_fadt_register_error (
86 ("Invalid FADT value %s=%X at offset %X FADT=%p\n",
87 register_name, value, (u32) offset, acpi_gbl_FADT));
91 /******************************************************************************
93 * FUNCTION: acpi_ut_validate_fadt
99 * DESCRIPTION: Validate various ACPI registers in the FADT
101 ******************************************************************************/
104 acpi_ut_validate_fadt (
109 * Verify Fixed ACPI Description Table fields,
110 * but don't abort on any problems, just display error
112 if (acpi_gbl_FADT->pm1_evt_len < 4) {
113 acpi_ut_fadt_register_error ("PM1_EVT_LEN",
114 (u32) acpi_gbl_FADT->pm1_evt_len,
115 ACPI_FADT_OFFSET (pm1_evt_len));
118 if (!acpi_gbl_FADT->pm1_cnt_len) {
119 acpi_ut_fadt_register_error ("PM1_CNT_LEN", 0,
120 ACPI_FADT_OFFSET (pm1_cnt_len));
123 if (!acpi_gbl_FADT->xpm1a_evt_blk.address) {
124 acpi_ut_fadt_register_error ("X_PM1a_EVT_BLK", 0,
125 ACPI_FADT_OFFSET (xpm1a_evt_blk.address));
128 if (!acpi_gbl_FADT->xpm1a_cnt_blk.address) {
129 acpi_ut_fadt_register_error ("X_PM1a_CNT_BLK", 0,
130 ACPI_FADT_OFFSET (xpm1a_cnt_blk.address));
133 if (!acpi_gbl_FADT->xpm_tmr_blk.address) {
134 acpi_ut_fadt_register_error ("X_PM_TMR_BLK", 0,
135 ACPI_FADT_OFFSET (xpm_tmr_blk.address));
138 if ((acpi_gbl_FADT->xpm2_cnt_blk.address &&
139 !acpi_gbl_FADT->pm2_cnt_len)) {
140 acpi_ut_fadt_register_error ("PM2_CNT_LEN",
141 (u32) acpi_gbl_FADT->pm2_cnt_len,
142 ACPI_FADT_OFFSET (pm2_cnt_len));
145 if (acpi_gbl_FADT->pm_tm_len < 4) {
146 acpi_ut_fadt_register_error ("PM_TM_LEN",
147 (u32) acpi_gbl_FADT->pm_tm_len,
148 ACPI_FADT_OFFSET (pm_tm_len));
151 /* Length of GPE blocks must be a multiple of 2 */
153 if (acpi_gbl_FADT->xgpe0_blk.address &&
154 (acpi_gbl_FADT->gpe0_blk_len & 1)) {
155 acpi_ut_fadt_register_error ("(x)GPE0_BLK_LEN",
156 (u32) acpi_gbl_FADT->gpe0_blk_len,
157 ACPI_FADT_OFFSET (gpe0_blk_len));
160 if (acpi_gbl_FADT->xgpe1_blk.address &&
161 (acpi_gbl_FADT->gpe1_blk_len & 1)) {
162 acpi_ut_fadt_register_error ("(x)GPE1_BLK_LEN",
163 (u32) acpi_gbl_FADT->gpe1_blk_len,
164 ACPI_FADT_OFFSET (gpe1_blk_len));
171 /******************************************************************************
173 * FUNCTION: acpi_ut_terminate
179 * DESCRIPTION: Free global memory
181 ******************************************************************************/
187 struct acpi_gpe_block_info *gpe_block;
188 struct acpi_gpe_block_info *next_gpe_block;
189 struct acpi_gpe_xrupt_info *gpe_xrupt_info;
190 struct acpi_gpe_xrupt_info *next_gpe_xrupt_info;
193 ACPI_FUNCTION_TRACE ("ut_terminate");
196 /* Free global tables, etc. */
197 /* Free global GPE blocks and related info structures */
199 gpe_xrupt_info = acpi_gbl_gpe_xrupt_list_head;
200 while (gpe_xrupt_info) {
201 gpe_block = gpe_xrupt_info->gpe_block_list_head;
203 next_gpe_block = gpe_block->next;
204 ACPI_MEM_FREE (gpe_block->event_info);
205 ACPI_MEM_FREE (gpe_block->register_info);
206 ACPI_MEM_FREE (gpe_block);
208 gpe_block = next_gpe_block;
210 next_gpe_xrupt_info = gpe_xrupt_info->next;
211 ACPI_MEM_FREE (gpe_xrupt_info);
212 gpe_xrupt_info = next_gpe_xrupt_info;
219 /*******************************************************************************
221 * FUNCTION: acpi_ut_subsystem_shutdown
227 * DESCRIPTION: Shutdown the various subsystems. Don't delete the mutex
228 * objects here -- because the AML debugger may be still running.
230 ******************************************************************************/
233 acpi_ut_subsystem_shutdown (
237 ACPI_FUNCTION_TRACE ("ut_subsystem_shutdown");
239 /* Just exit if subsystem is already shutdown */
241 if (acpi_gbl_shutdown) {
242 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR,
243 "ACPI Subsystem is already terminated\n"));
247 /* Subsystem appears active, go ahead and shut it down */
249 acpi_gbl_shutdown = TRUE;
250 ACPI_DEBUG_PRINT ((ACPI_DB_INFO,
251 "Shutting down ACPI Subsystem...\n"));
253 /* Close the acpi_event Handling */
255 acpi_ev_terminate ();
257 /* Close the Namespace */
259 acpi_ns_terminate ();
261 /* Close the globals */
263 acpi_ut_terminate ();
265 /* Purge the local caches */
267 (void) acpi_purge_cached_objects ();
269 /* Debug only - display leftover memory allocation, if any */
271 #ifdef ACPI_DBG_TRACK_ALLOCATIONS
272 acpi_ut_dump_allocations (ACPI_UINT32_MAX, NULL);