tbxfload.c revision 1.1.1.2.2.1 1 1.1 christos /******************************************************************************
2 1.1 christos *
3 1.1 christos * Module Name: tbxfload - Table load/unload external interfaces
4 1.1 christos *
5 1.1 christos *****************************************************************************/
6 1.1 christos
7 1.1 christos /*
8 1.1.1.2.2.1 skrll * Copyright (C) 2000 - 2015, Intel Corp.
9 1.1 christos * All rights reserved.
10 1.1 christos *
11 1.1 christos * Redistribution and use in source and binary forms, with or without
12 1.1 christos * modification, are permitted provided that the following conditions
13 1.1 christos * are met:
14 1.1 christos * 1. Redistributions of source code must retain the above copyright
15 1.1 christos * notice, this list of conditions, and the following disclaimer,
16 1.1 christos * without modification.
17 1.1 christos * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 1.1 christos * substantially similar to the "NO WARRANTY" disclaimer below
19 1.1 christos * ("Disclaimer") and any redistribution must be conditioned upon
20 1.1 christos * including a substantially similar Disclaimer requirement for further
21 1.1 christos * binary redistribution.
22 1.1 christos * 3. Neither the names of the above-listed copyright holders nor the names
23 1.1 christos * of any contributors may be used to endorse or promote products derived
24 1.1 christos * from this software without specific prior written permission.
25 1.1 christos *
26 1.1 christos * Alternatively, this software may be distributed under the terms of the
27 1.1 christos * GNU General Public License ("GPL") version 2 as published by the Free
28 1.1 christos * Software Foundation.
29 1.1 christos *
30 1.1 christos * NO WARRANTY
31 1.1 christos * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 1.1 christos * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 1.1 christos * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 1.1 christos * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 1.1 christos * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 1.1 christos * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 1.1 christos * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 1.1 christos * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 1.1 christos * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 1.1 christos * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 1.1 christos * POSSIBILITY OF SUCH DAMAGES.
42 1.1 christos */
43 1.1 christos
44 1.1 christos #define EXPORT_ACPI_INTERFACES
45 1.1 christos
46 1.1 christos #include "acpi.h"
47 1.1 christos #include "accommon.h"
48 1.1 christos #include "acnamesp.h"
49 1.1 christos #include "actables.h"
50 1.1 christos
51 1.1 christos #define _COMPONENT ACPI_TABLES
52 1.1 christos ACPI_MODULE_NAME ("tbxfload")
53 1.1 christos
54 1.1 christos /* Local prototypes */
55 1.1 christos
56 1.1 christos static ACPI_STATUS
57 1.1 christos AcpiTbLoadNamespace (
58 1.1 christos void);
59 1.1 christos
60 1.1 christos
61 1.1 christos /*******************************************************************************
62 1.1 christos *
63 1.1 christos * FUNCTION: AcpiLoadTables
64 1.1 christos *
65 1.1 christos * PARAMETERS: None
66 1.1 christos *
67 1.1 christos * RETURN: Status
68 1.1 christos *
69 1.1 christos * DESCRIPTION: Load the ACPI tables from the RSDT/XSDT
70 1.1 christos *
71 1.1 christos ******************************************************************************/
72 1.1 christos
73 1.1 christos ACPI_STATUS
74 1.1 christos AcpiLoadTables (
75 1.1 christos void)
76 1.1 christos {
77 1.1 christos ACPI_STATUS Status;
78 1.1 christos
79 1.1 christos
80 1.1 christos ACPI_FUNCTION_TRACE (AcpiLoadTables);
81 1.1 christos
82 1.1 christos
83 1.1 christos /* Load the namespace from the tables */
84 1.1 christos
85 1.1 christos Status = AcpiTbLoadNamespace ();
86 1.1 christos if (ACPI_FAILURE (Status))
87 1.1 christos {
88 1.1 christos ACPI_EXCEPTION ((AE_INFO, Status,
89 1.1 christos "While loading namespace from ACPI tables"));
90 1.1 christos }
91 1.1 christos
92 1.1 christos return_ACPI_STATUS (Status);
93 1.1 christos }
94 1.1 christos
95 1.1 christos ACPI_EXPORT_SYMBOL_INIT (AcpiLoadTables)
96 1.1 christos
97 1.1 christos
98 1.1 christos /*******************************************************************************
99 1.1 christos *
100 1.1 christos * FUNCTION: AcpiTbLoadNamespace
101 1.1 christos *
102 1.1 christos * PARAMETERS: None
103 1.1 christos *
104 1.1 christos * RETURN: Status
105 1.1 christos *
106 1.1 christos * DESCRIPTION: Load the namespace from the DSDT and all SSDTs/PSDTs found in
107 1.1 christos * the RSDT/XSDT.
108 1.1 christos *
109 1.1 christos ******************************************************************************/
110 1.1 christos
111 1.1 christos static ACPI_STATUS
112 1.1 christos AcpiTbLoadNamespace (
113 1.1 christos void)
114 1.1 christos {
115 1.1 christos ACPI_STATUS Status;
116 1.1 christos UINT32 i;
117 1.1 christos ACPI_TABLE_HEADER *NewDsdt;
118 1.1 christos
119 1.1 christos
120 1.1 christos ACPI_FUNCTION_TRACE (TbLoadNamespace);
121 1.1 christos
122 1.1 christos
123 1.1 christos (void) AcpiUtAcquireMutex (ACPI_MTX_TABLES);
124 1.1 christos
125 1.1 christos /*
126 1.1 christos * Load the namespace. The DSDT is required, but any SSDT and
127 1.1 christos * PSDT tables are optional. Verify the DSDT.
128 1.1 christos */
129 1.1 christos if (!AcpiGbl_RootTableList.CurrentTableCount ||
130 1.1 christos !ACPI_COMPARE_NAME (
131 1.1 christos &(AcpiGbl_RootTableList.Tables[ACPI_TABLE_INDEX_DSDT].Signature),
132 1.1 christos ACPI_SIG_DSDT) ||
133 1.1.1.2 christos ACPI_FAILURE (AcpiTbValidateTable (
134 1.1 christos &AcpiGbl_RootTableList.Tables[ACPI_TABLE_INDEX_DSDT])))
135 1.1 christos {
136 1.1 christos Status = AE_NO_ACPI_TABLES;
137 1.1 christos goto UnlockAndExit;
138 1.1 christos }
139 1.1 christos
140 1.1 christos /*
141 1.1 christos * Save the DSDT pointer for simple access. This is the mapped memory
142 1.1 christos * address. We must take care here because the address of the .Tables
143 1.1 christos * array can change dynamically as tables are loaded at run-time. Note:
144 1.1.1.2 christos * .Pointer field is not validated until after call to AcpiTbValidateTable.
145 1.1 christos */
146 1.1 christos AcpiGbl_DSDT = AcpiGbl_RootTableList.Tables[ACPI_TABLE_INDEX_DSDT].Pointer;
147 1.1 christos
148 1.1 christos /*
149 1.1 christos * Optionally copy the entire DSDT to local memory (instead of simply
150 1.1 christos * mapping it.) There are some BIOSs that corrupt or replace the original
151 1.1 christos * DSDT, creating the need for this option. Default is FALSE, do not copy
152 1.1 christos * the DSDT.
153 1.1 christos */
154 1.1 christos if (AcpiGbl_CopyDsdtLocally)
155 1.1 christos {
156 1.1 christos NewDsdt = AcpiTbCopyDsdt (ACPI_TABLE_INDEX_DSDT);
157 1.1 christos if (NewDsdt)
158 1.1 christos {
159 1.1 christos AcpiGbl_DSDT = NewDsdt;
160 1.1 christos }
161 1.1 christos }
162 1.1 christos
163 1.1 christos /*
164 1.1 christos * Save the original DSDT header for detection of table corruption
165 1.1 christos * and/or replacement of the DSDT from outside the OS.
166 1.1 christos */
167 1.1 christos ACPI_MEMCPY (&AcpiGbl_OriginalDsdtHeader, AcpiGbl_DSDT,
168 1.1 christos sizeof (ACPI_TABLE_HEADER));
169 1.1 christos
170 1.1 christos (void) AcpiUtReleaseMutex (ACPI_MTX_TABLES);
171 1.1 christos
172 1.1 christos /* Load and parse tables */
173 1.1 christos
174 1.1 christos Status = AcpiNsLoadTable (ACPI_TABLE_INDEX_DSDT, AcpiGbl_RootNode);
175 1.1 christos if (ACPI_FAILURE (Status))
176 1.1 christos {
177 1.1 christos return_ACPI_STATUS (Status);
178 1.1 christos }
179 1.1 christos
180 1.1 christos /* Load any SSDT or PSDT tables. Note: Loop leaves tables locked */
181 1.1 christos
182 1.1 christos (void) AcpiUtAcquireMutex (ACPI_MTX_TABLES);
183 1.1 christos for (i = 0; i < AcpiGbl_RootTableList.CurrentTableCount; ++i)
184 1.1 christos {
185 1.1 christos if ((!ACPI_COMPARE_NAME (&(AcpiGbl_RootTableList.Tables[i].Signature),
186 1.1 christos ACPI_SIG_SSDT) &&
187 1.1 christos !ACPI_COMPARE_NAME (&(AcpiGbl_RootTableList.Tables[i].Signature),
188 1.1 christos ACPI_SIG_PSDT)) ||
189 1.1.1.2 christos ACPI_FAILURE (AcpiTbValidateTable (
190 1.1 christos &AcpiGbl_RootTableList.Tables[i])))
191 1.1 christos {
192 1.1 christos continue;
193 1.1 christos }
194 1.1 christos
195 1.1 christos /* Ignore errors while loading tables, get as many as possible */
196 1.1 christos
197 1.1 christos (void) AcpiUtReleaseMutex (ACPI_MTX_TABLES);
198 1.1 christos (void) AcpiNsLoadTable (i, AcpiGbl_RootNode);
199 1.1 christos (void) AcpiUtAcquireMutex (ACPI_MTX_TABLES);
200 1.1 christos }
201 1.1 christos
202 1.1 christos ACPI_INFO ((AE_INFO, "All ACPI Tables successfully acquired"));
203 1.1 christos
204 1.1 christos UnlockAndExit:
205 1.1 christos (void) AcpiUtReleaseMutex (ACPI_MTX_TABLES);
206 1.1 christos return_ACPI_STATUS (Status);
207 1.1 christos }
208 1.1 christos
209 1.1 christos
210 1.1 christos /*******************************************************************************
211 1.1 christos *
212 1.1.1.2 christos * FUNCTION: AcpiInstallTable
213 1.1.1.2 christos *
214 1.1.1.2 christos * PARAMETERS: Address - Address of the ACPI table to be installed.
215 1.1.1.2 christos * Physical - Whether the address is a physical table
216 1.1.1.2 christos * address or not
217 1.1.1.2 christos *
218 1.1.1.2 christos * RETURN: Status
219 1.1.1.2 christos *
220 1.1.1.2 christos * DESCRIPTION: Dynamically install an ACPI table.
221 1.1.1.2 christos * Note: This function should only be invoked after
222 1.1.1.2 christos * AcpiInitializeTables() and before AcpiLoadTables().
223 1.1.1.2 christos *
224 1.1.1.2 christos ******************************************************************************/
225 1.1.1.2 christos
226 1.1.1.2 christos ACPI_STATUS
227 1.1.1.2 christos AcpiInstallTable (
228 1.1.1.2 christos ACPI_PHYSICAL_ADDRESS Address,
229 1.1.1.2 christos BOOLEAN Physical)
230 1.1.1.2 christos {
231 1.1.1.2 christos ACPI_STATUS Status;
232 1.1.1.2 christos UINT8 Flags;
233 1.1.1.2 christos UINT32 TableIndex;
234 1.1.1.2 christos
235 1.1.1.2 christos
236 1.1.1.2 christos ACPI_FUNCTION_TRACE (AcpiInstallTable);
237 1.1.1.2 christos
238 1.1.1.2 christos
239 1.1.1.2 christos if (Physical)
240 1.1.1.2 christos {
241 1.1.1.2 christos Flags = ACPI_TABLE_ORIGIN_EXTERNAL_VIRTUAL;
242 1.1.1.2 christos }
243 1.1.1.2 christos else
244 1.1.1.2 christos {
245 1.1.1.2 christos Flags = ACPI_TABLE_ORIGIN_INTERNAL_PHYSICAL;
246 1.1.1.2 christos }
247 1.1.1.2 christos
248 1.1.1.2 christos Status = AcpiTbInstallStandardTable (Address, Flags,
249 1.1.1.2 christos FALSE, FALSE, &TableIndex);
250 1.1.1.2 christos
251 1.1.1.2 christos return_ACPI_STATUS (Status);
252 1.1.1.2 christos }
253 1.1.1.2 christos
254 1.1.1.2 christos ACPI_EXPORT_SYMBOL_INIT (AcpiInstallTable)
255 1.1.1.2 christos
256 1.1.1.2 christos
257 1.1.1.2 christos /*******************************************************************************
258 1.1.1.2 christos *
259 1.1 christos * FUNCTION: AcpiLoadTable
260 1.1 christos *
261 1.1 christos * PARAMETERS: Table - Pointer to a buffer containing the ACPI
262 1.1 christos * table to be loaded.
263 1.1 christos *
264 1.1 christos * RETURN: Status
265 1.1 christos *
266 1.1 christos * DESCRIPTION: Dynamically load an ACPI table from the caller's buffer. Must
267 1.1 christos * be a valid ACPI table with a valid ACPI table header.
268 1.1 christos * Note1: Mainly intended to support hotplug addition of SSDTs.
269 1.1 christos * Note2: Does not copy the incoming table. User is responsible
270 1.1 christos * to ensure that the table is not deleted or unmapped.
271 1.1 christos *
272 1.1 christos ******************************************************************************/
273 1.1 christos
274 1.1 christos ACPI_STATUS
275 1.1 christos AcpiLoadTable (
276 1.1 christos ACPI_TABLE_HEADER *Table)
277 1.1 christos {
278 1.1 christos ACPI_STATUS Status;
279 1.1 christos UINT32 TableIndex;
280 1.1 christos
281 1.1 christos
282 1.1 christos ACPI_FUNCTION_TRACE (AcpiLoadTable);
283 1.1 christos
284 1.1 christos
285 1.1 christos /* Parameter validation */
286 1.1 christos
287 1.1 christos if (!Table)
288 1.1 christos {
289 1.1 christos return_ACPI_STATUS (AE_BAD_PARAMETER);
290 1.1 christos }
291 1.1 christos
292 1.1 christos /* Must acquire the interpreter lock during this operation */
293 1.1 christos
294 1.1 christos Status = AcpiUtAcquireMutex (ACPI_MTX_INTERPRETER);
295 1.1 christos if (ACPI_FAILURE (Status))
296 1.1 christos {
297 1.1 christos return_ACPI_STATUS (Status);
298 1.1 christos }
299 1.1 christos
300 1.1 christos /* Install the table and load it into the namespace */
301 1.1 christos
302 1.1 christos ACPI_INFO ((AE_INFO, "Host-directed Dynamic ACPI Table Load:"));
303 1.1.1.2 christos (void) AcpiUtAcquireMutex (ACPI_MTX_TABLES);
304 1.1.1.2 christos
305 1.1.1.2 christos Status = AcpiTbInstallStandardTable (ACPI_PTR_TO_PHYSADDR (Table),
306 1.1.1.2 christos ACPI_TABLE_ORIGIN_EXTERNAL_VIRTUAL, TRUE, FALSE,
307 1.1.1.2 christos &TableIndex);
308 1.1.1.2 christos
309 1.1.1.2 christos (void) AcpiUtReleaseMutex (ACPI_MTX_TABLES);
310 1.1.1.2 christos if (ACPI_FAILURE (Status))
311 1.1.1.2 christos {
312 1.1.1.2 christos goto UnlockAndExit;
313 1.1.1.2 christos }
314 1.1.1.2 christos
315 1.1.1.2 christos /*
316 1.1.1.2 christos * Note: Now table is "INSTALLED", it must be validated before
317 1.1.1.2 christos * using.
318 1.1.1.2 christos */
319 1.1.1.2 christos Status = AcpiTbValidateTable (&AcpiGbl_RootTableList.Tables[TableIndex]);
320 1.1 christos if (ACPI_FAILURE (Status))
321 1.1 christos {
322 1.1 christos goto UnlockAndExit;
323 1.1 christos }
324 1.1 christos
325 1.1 christos Status = AcpiNsLoadTable (TableIndex, AcpiGbl_RootNode);
326 1.1 christos
327 1.1 christos /* Invoke table handler if present */
328 1.1 christos
329 1.1 christos if (AcpiGbl_TableHandler)
330 1.1 christos {
331 1.1 christos (void) AcpiGbl_TableHandler (ACPI_TABLE_EVENT_LOAD, Table,
332 1.1 christos AcpiGbl_TableHandlerContext);
333 1.1 christos }
334 1.1 christos
335 1.1 christos UnlockAndExit:
336 1.1 christos (void) AcpiUtReleaseMutex (ACPI_MTX_INTERPRETER);
337 1.1 christos return_ACPI_STATUS (Status);
338 1.1 christos }
339 1.1 christos
340 1.1 christos ACPI_EXPORT_SYMBOL (AcpiLoadTable)
341 1.1 christos
342 1.1 christos
343 1.1 christos /*******************************************************************************
344 1.1 christos *
345 1.1 christos * FUNCTION: AcpiUnloadParentTable
346 1.1 christos *
347 1.1 christos * PARAMETERS: Object - Handle to any namespace object owned by
348 1.1 christos * the table to be unloaded
349 1.1 christos *
350 1.1 christos * RETURN: Status
351 1.1 christos *
352 1.1 christos * DESCRIPTION: Via any namespace object within an SSDT or OEMx table, unloads
353 1.1 christos * the table and deletes all namespace objects associated with
354 1.1 christos * that table. Unloading of the DSDT is not allowed.
355 1.1 christos * Note: Mainly intended to support hotplug removal of SSDTs.
356 1.1 christos *
357 1.1 christos ******************************************************************************/
358 1.1 christos
359 1.1 christos ACPI_STATUS
360 1.1 christos AcpiUnloadParentTable (
361 1.1 christos ACPI_HANDLE Object)
362 1.1 christos {
363 1.1 christos ACPI_NAMESPACE_NODE *Node = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, Object);
364 1.1 christos ACPI_STATUS Status = AE_NOT_EXIST;
365 1.1 christos ACPI_OWNER_ID OwnerId;
366 1.1 christos UINT32 i;
367 1.1 christos
368 1.1 christos
369 1.1 christos ACPI_FUNCTION_TRACE (AcpiUnloadParentTable);
370 1.1 christos
371 1.1 christos
372 1.1 christos /* Parameter validation */
373 1.1 christos
374 1.1 christos if (!Object)
375 1.1 christos {
376 1.1 christos return_ACPI_STATUS (AE_BAD_PARAMETER);
377 1.1 christos }
378 1.1 christos
379 1.1 christos /*
380 1.1 christos * The node OwnerId is currently the same as the parent table ID.
381 1.1 christos * However, this could change in the future.
382 1.1 christos */
383 1.1 christos OwnerId = Node->OwnerId;
384 1.1 christos if (!OwnerId)
385 1.1 christos {
386 1.1 christos /* OwnerId==0 means DSDT is the owner. DSDT cannot be unloaded */
387 1.1 christos
388 1.1 christos return_ACPI_STATUS (AE_TYPE);
389 1.1 christos }
390 1.1 christos
391 1.1 christos /* Must acquire the interpreter lock during this operation */
392 1.1 christos
393 1.1 christos Status = AcpiUtAcquireMutex (ACPI_MTX_INTERPRETER);
394 1.1 christos if (ACPI_FAILURE (Status))
395 1.1 christos {
396 1.1 christos return_ACPI_STATUS (Status);
397 1.1 christos }
398 1.1 christos
399 1.1 christos /* Find the table in the global table list */
400 1.1 christos
401 1.1 christos for (i = 0; i < AcpiGbl_RootTableList.CurrentTableCount; i++)
402 1.1 christos {
403 1.1 christos if (OwnerId != AcpiGbl_RootTableList.Tables[i].OwnerId)
404 1.1 christos {
405 1.1 christos continue;
406 1.1 christos }
407 1.1 christos
408 1.1 christos /*
409 1.1 christos * Allow unload of SSDT and OEMx tables only. Do not allow unload
410 1.1 christos * of the DSDT. No other types of tables should get here, since
411 1.1 christos * only these types can contain AML and thus are the only types
412 1.1 christos * that can create namespace objects.
413 1.1 christos */
414 1.1 christos if (ACPI_COMPARE_NAME (
415 1.1 christos AcpiGbl_RootTableList.Tables[i].Signature.Ascii,
416 1.1 christos ACPI_SIG_DSDT))
417 1.1 christos {
418 1.1 christos Status = AE_TYPE;
419 1.1 christos break;
420 1.1 christos }
421 1.1 christos
422 1.1 christos /* Ensure the table is actually loaded */
423 1.1 christos
424 1.1 christos if (!AcpiTbIsTableLoaded (i))
425 1.1 christos {
426 1.1 christos Status = AE_NOT_EXIST;
427 1.1 christos break;
428 1.1 christos }
429 1.1 christos
430 1.1 christos /* Invoke table handler if present */
431 1.1 christos
432 1.1 christos if (AcpiGbl_TableHandler)
433 1.1 christos {
434 1.1 christos (void) AcpiGbl_TableHandler (ACPI_TABLE_EVENT_UNLOAD,
435 1.1 christos AcpiGbl_RootTableList.Tables[i].Pointer,
436 1.1 christos AcpiGbl_TableHandlerContext);
437 1.1 christos }
438 1.1 christos
439 1.1 christos /*
440 1.1 christos * Delete all namespace objects owned by this table. Note that
441 1.1 christos * these objects can appear anywhere in the namespace by virtue
442 1.1 christos * of the AML "Scope" operator. Thus, we need to track ownership
443 1.1 christos * by an ID, not simply a position within the hierarchy.
444 1.1 christos */
445 1.1 christos Status = AcpiTbDeleteNamespaceByOwner (i);
446 1.1 christos if (ACPI_FAILURE (Status))
447 1.1 christos {
448 1.1 christos break;
449 1.1 christos }
450 1.1 christos
451 1.1 christos Status = AcpiTbReleaseOwnerId (i);
452 1.1 christos AcpiTbSetTableLoadedFlag (i, FALSE);
453 1.1 christos break;
454 1.1 christos }
455 1.1 christos
456 1.1 christos (void) AcpiUtReleaseMutex (ACPI_MTX_INTERPRETER);
457 1.1 christos return_ACPI_STATUS (Status);
458 1.1 christos }
459 1.1 christos
460 1.1 christos ACPI_EXPORT_SYMBOL (AcpiUnloadParentTable)
461