Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /****************************************************************************** |
2 | * | |
3 | * Module Name: exconfig - Namespace reconfiguration (Load/Unload opcodes) | |
4 | * | |
5 | *****************************************************************************/ | |
6 | ||
7 | /* | |
c8100dc4 | 8 | * Copyright (C) 2000 - 2016, Intel Corp. |
1da177e4 LT |
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 | ||
1da177e4 | 44 | #include <acpi/acpi.h> |
e2f7a777 LB |
45 | #include "accommon.h" |
46 | #include "acinterp.h" | |
47 | #include "acnamesp.h" | |
48 | #include "actables.h" | |
49 | #include "acdispat.h" | |
3c59f960 | 50 | #include "acevents.h" |
528a412c | 51 | #include "amlcode.h" |
1da177e4 | 52 | |
1da177e4 | 53 | #define _COMPONENT ACPI_EXECUTER |
4be44fcd | 54 | ACPI_MODULE_NAME("exconfig") |
1da177e4 | 55 | |
44f6c012 | 56 | /* Local prototypes */ |
44f6c012 | 57 | static acpi_status |
ac0f06eb | 58 | acpi_ex_add_table(u32 table_index, union acpi_operand_object **ddb_handle); |
1da177e4 | 59 | |
3c59f960 BM |
60 | static acpi_status |
61 | acpi_ex_region_read(union acpi_operand_object *obj_desc, | |
62 | u32 length, u8 *buffer); | |
63 | ||
1da177e4 LT |
64 | /******************************************************************************* |
65 | * | |
66 | * FUNCTION: acpi_ex_add_table | |
67 | * | |
ba494bee | 68 | * PARAMETERS: table - Pointer to raw table |
1da177e4 LT |
69 | * parent_node - Where to load the table (scope) |
70 | * ddb_handle - Where to return the table handle. | |
71 | * | |
72 | * RETURN: Status | |
73 | * | |
74 | * DESCRIPTION: Common function to Install and Load an ACPI table with a | |
75 | * returned table handle. | |
76 | * | |
77 | ******************************************************************************/ | |
78 | ||
44f6c012 | 79 | static acpi_status |
ac0f06eb | 80 | acpi_ex_add_table(u32 table_index, union acpi_operand_object **ddb_handle) |
1da177e4 | 81 | { |
4be44fcd | 82 | union acpi_operand_object *obj_desc; |
1da177e4 | 83 | |
b229cf92 | 84 | ACPI_FUNCTION_TRACE(ex_add_table); |
1da177e4 LT |
85 | |
86 | /* Create an object to be the table handle */ | |
87 | ||
4be44fcd | 88 | obj_desc = acpi_ut_create_internal_object(ACPI_TYPE_LOCAL_REFERENCE); |
1da177e4 | 89 | if (!obj_desc) { |
4be44fcd | 90 | return_ACPI_STATUS(AE_NO_MEMORY); |
1da177e4 LT |
91 | } |
92 | ||
0c9938cc RM |
93 | /* Init the table handle */ |
94 | ||
e0be6f5a | 95 | obj_desc->common.flags |= AOPOBJ_DATA_VALID; |
1044f1f6 | 96 | obj_desc->reference.class = ACPI_REFCLASS_TABLE; |
57e664cf | 97 | obj_desc->reference.value = table_index; |
ac0f06eb | 98 | *ddb_handle = obj_desc; |
186c307f | 99 | return_ACPI_STATUS(AE_OK); |
1da177e4 LT |
100 | } |
101 | ||
1da177e4 LT |
102 | /******************************************************************************* |
103 | * | |
104 | * FUNCTION: acpi_ex_load_table_op | |
105 | * | |
106 | * PARAMETERS: walk_state - Current state with operands | |
107 | * return_desc - Where to store the return object | |
108 | * | |
109 | * RETURN: Status | |
110 | * | |
a6823e12 | 111 | * DESCRIPTION: Load an ACPI table from the RSDT/XSDT |
1da177e4 LT |
112 | * |
113 | ******************************************************************************/ | |
114 | ||
115 | acpi_status | |
4be44fcd LB |
116 | acpi_ex_load_table_op(struct acpi_walk_state *walk_state, |
117 | union acpi_operand_object **return_desc) | |
1da177e4 | 118 | { |
4be44fcd LB |
119 | acpi_status status; |
120 | union acpi_operand_object **operand = &walk_state->operands[0]; | |
4be44fcd LB |
121 | struct acpi_namespace_node *parent_node; |
122 | struct acpi_namespace_node *start_node; | |
123 | struct acpi_namespace_node *parameter_node = NULL; | |
124 | union acpi_operand_object *ddb_handle; | |
67a119f9 | 125 | u32 table_index; |
1da177e4 | 126 | |
b229cf92 | 127 | ACPI_FUNCTION_TRACE(ex_load_table_op); |
1da177e4 | 128 | |
a6823e12 | 129 | /* Find the ACPI table in the RSDT/XSDT */ |
1da177e4 | 130 | |
ac0f06eb | 131 | acpi_ex_exit_interpreter(); |
4be44fcd LB |
132 | status = acpi_tb_find_table(operand[0]->string.pointer, |
133 | operand[1]->string.pointer, | |
f3d2e786 | 134 | operand[2]->string.pointer, &table_index); |
ac0f06eb | 135 | acpi_ex_enter_interpreter(); |
4be44fcd | 136 | if (ACPI_FAILURE(status)) { |
1da177e4 | 137 | if (status != AE_NOT_FOUND) { |
4be44fcd | 138 | return_ACPI_STATUS(status); |
1da177e4 LT |
139 | } |
140 | ||
141 | /* Table not found, return an Integer=0 and AE_OK */ | |
142 | ||
dc95a270 | 143 | ddb_handle = acpi_ut_create_integer_object((u64) 0); |
1da177e4 | 144 | if (!ddb_handle) { |
4be44fcd | 145 | return_ACPI_STATUS(AE_NO_MEMORY); |
1da177e4 LT |
146 | } |
147 | ||
1da177e4 | 148 | *return_desc = ddb_handle; |
4be44fcd | 149 | return_ACPI_STATUS(AE_OK); |
1da177e4 LT |
150 | } |
151 | ||
152 | /* Default nodes */ | |
153 | ||
154 | start_node = walk_state->scope_info->scope.node; | |
155 | parent_node = acpi_gbl_root_node; | |
156 | ||
157 | /* root_path (optional parameter) */ | |
158 | ||
159 | if (operand[3]->string.length > 0) { | |
160 | /* | |
161 | * Find the node referenced by the root_path_string. This is the | |
162 | * location within the namespace where the table will be loaded. | |
163 | */ | |
74f51b80 LZ |
164 | status = acpi_ns_get_node_unlocked(start_node, |
165 | operand[3]->string.pointer, | |
166 | ACPI_NS_SEARCH_PARENT, | |
167 | &parent_node); | |
4be44fcd LB |
168 | if (ACPI_FAILURE(status)) { |
169 | return_ACPI_STATUS(status); | |
1da177e4 LT |
170 | } |
171 | } | |
172 | ||
173 | /* parameter_path (optional parameter) */ | |
174 | ||
175 | if (operand[4]->string.length > 0) { | |
528a412c BM |
176 | if ((operand[4]->string.pointer[0] != AML_ROOT_PREFIX) && |
177 | (operand[4]->string.pointer[0] != AML_PARENT_PREFIX)) { | |
1da177e4 LT |
178 | /* |
179 | * Path is not absolute, so it will be relative to the node | |
180 | * referenced by the root_path_string (or the NS root if omitted) | |
181 | */ | |
182 | start_node = parent_node; | |
183 | } | |
184 | ||
44f6c012 RM |
185 | /* Find the node referenced by the parameter_path_string */ |
186 | ||
74f51b80 LZ |
187 | status = acpi_ns_get_node_unlocked(start_node, |
188 | operand[4]->string.pointer, | |
189 | ACPI_NS_SEARCH_PARENT, | |
190 | ¶meter_node); | |
4be44fcd LB |
191 | if (ACPI_FAILURE(status)) { |
192 | return_ACPI_STATUS(status); | |
1da177e4 LT |
193 | } |
194 | } | |
195 | ||
196 | /* Load the table into the namespace */ | |
197 | ||
ac0f06eb LZ |
198 | ACPI_INFO(("Dynamic OEM Table Load:")); |
199 | acpi_ex_exit_interpreter(); | |
200 | status = acpi_tb_load_table(table_index, parent_node); | |
201 | acpi_ex_enter_interpreter(); | |
202 | if (ACPI_FAILURE(status)) { | |
203 | return_ACPI_STATUS(status); | |
204 | } | |
205 | ||
206 | status = acpi_ex_add_table(table_index, &ddb_handle); | |
4be44fcd LB |
207 | if (ACPI_FAILURE(status)) { |
208 | return_ACPI_STATUS(status); | |
1da177e4 LT |
209 | } |
210 | ||
211 | /* Parameter Data (optional) */ | |
212 | ||
213 | if (parameter_node) { | |
52fc0b02 | 214 | |
1da177e4 LT |
215 | /* Store the parameter data into the optional parameter object */ |
216 | ||
4be44fcd LB |
217 | status = acpi_ex_store(operand[5], |
218 | ACPI_CAST_PTR(union acpi_operand_object, | |
219 | parameter_node), | |
220 | walk_state); | |
221 | if (ACPI_FAILURE(status)) { | |
222 | (void)acpi_ex_unload_table(ddb_handle); | |
06366c14 LM |
223 | |
224 | acpi_ut_remove_reference(ddb_handle); | |
4be44fcd | 225 | return_ACPI_STATUS(status); |
1da177e4 LT |
226 | } |
227 | } | |
228 | ||
229 | *return_desc = ddb_handle; | |
4be44fcd | 230 | return_ACPI_STATUS(status); |
1da177e4 LT |
231 | } |
232 | ||
3c59f960 BM |
233 | /******************************************************************************* |
234 | * | |
235 | * FUNCTION: acpi_ex_region_read | |
236 | * | |
237 | * PARAMETERS: obj_desc - Region descriptor | |
ba494bee BM |
238 | * length - Number of bytes to read |
239 | * buffer - Pointer to where to put the data | |
3c59f960 BM |
240 | * |
241 | * RETURN: Status | |
242 | * | |
243 | * DESCRIPTION: Read data from an operation region. The read starts from the | |
244 | * beginning of the region. | |
245 | * | |
246 | ******************************************************************************/ | |
247 | ||
248 | static acpi_status | |
249 | acpi_ex_region_read(union acpi_operand_object *obj_desc, u32 length, u8 *buffer) | |
250 | { | |
251 | acpi_status status; | |
5df7e6cb | 252 | u64 value; |
f5407af3 | 253 | u32 region_offset = 0; |
3c59f960 BM |
254 | u32 i; |
255 | ||
3c59f960 BM |
256 | /* Bytewise reads */ |
257 | ||
258 | for (i = 0; i < length; i++) { | |
9ce81784 BM |
259 | status = |
260 | acpi_ev_address_space_dispatch(obj_desc, NULL, ACPI_READ, | |
261 | region_offset, 8, &value); | |
3c59f960 | 262 | if (ACPI_FAILURE(status)) { |
9c0d7939 | 263 | return (status); |
3c59f960 BM |
264 | } |
265 | ||
266 | *buffer = (u8)value; | |
267 | buffer++; | |
f5407af3 | 268 | region_offset++; |
3c59f960 BM |
269 | } |
270 | ||
9c0d7939 | 271 | return (AE_OK); |
3c59f960 BM |
272 | } |
273 | ||
1da177e4 LT |
274 | /******************************************************************************* |
275 | * | |
276 | * FUNCTION: acpi_ex_load_op | |
277 | * | |
a6823e12 | 278 | * PARAMETERS: obj_desc - Region or Buffer/Field where the table will be |
1da177e4 | 279 | * obtained |
ba494bee | 280 | * target - Where a handle to the table will be stored |
1da177e4 LT |
281 | * walk_state - Current state |
282 | * | |
283 | * RETURN: Status | |
284 | * | |
285 | * DESCRIPTION: Load an ACPI table from a field or operation region | |
286 | * | |
a6823e12 AS |
287 | * NOTE: Region Fields (Field, bank_field, index_fields) are resolved to buffer |
288 | * objects before this code is reached. | |
289 | * | |
290 | * If source is an operation region, it must refer to system_memory, as | |
291 | * per the ACPI specification. | |
292 | * | |
1da177e4 LT |
293 | ******************************************************************************/ |
294 | ||
295 | acpi_status | |
4be44fcd LB |
296 | acpi_ex_load_op(union acpi_operand_object *obj_desc, |
297 | union acpi_operand_object *target, | |
298 | struct acpi_walk_state *walk_state) | |
1da177e4 | 299 | { |
4be44fcd | 300 | union acpi_operand_object *ddb_handle; |
86dfc6f3 | 301 | struct acpi_table_header *table_header; |
f0e0da8a | 302 | struct acpi_table_header *table; |
67a119f9 | 303 | u32 table_index; |
a6823e12 | 304 | acpi_status status; |
98af37fb | 305 | u32 length; |
1da177e4 | 306 | |
b229cf92 | 307 | ACPI_FUNCTION_TRACE(ex_load_op); |
1da177e4 | 308 | |
a6823e12 AS |
309 | /* Source Object can be either an op_region or a Buffer/Field */ |
310 | ||
3371c19c | 311 | switch (obj_desc->common.type) { |
1da177e4 LT |
312 | case ACPI_TYPE_REGION: |
313 | ||
f0e0da8a DN |
314 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
315 | "Load table from Region %p\n", obj_desc)); | |
5eb69180 | 316 | |
a6823e12 AS |
317 | /* Region must be system_memory (from ACPI spec) */ |
318 | ||
319 | if (obj_desc->region.space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY) { | |
320 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); | |
321 | } | |
322 | ||
1da177e4 | 323 | /* |
1fad8738 BM |
324 | * If the Region Address and Length have not been previously |
325 | * evaluated, evaluate them now and save the results. | |
1da177e4 LT |
326 | */ |
327 | if (!(obj_desc->common.flags & AOPOBJ_DATA_VALID)) { | |
4be44fcd LB |
328 | status = acpi_ds_get_region_arguments(obj_desc); |
329 | if (ACPI_FAILURE(status)) { | |
330 | return_ACPI_STATUS(status); | |
1da177e4 LT |
331 | } |
332 | } | |
333 | ||
3c59f960 BM |
334 | /* Get the table header first so we can get the table length */ |
335 | ||
86dfc6f3 LZ |
336 | table_header = ACPI_ALLOCATE(sizeof(struct acpi_table_header)); |
337 | if (!table_header) { | |
f0e0da8a DN |
338 | return_ACPI_STATUS(AE_NO_MEMORY); |
339 | } | |
340 | ||
3c59f960 BM |
341 | status = |
342 | acpi_ex_region_read(obj_desc, | |
343 | sizeof(struct acpi_table_header), | |
86dfc6f3 LZ |
344 | ACPI_CAST_PTR(u8, table_header)); |
345 | length = table_header->length; | |
346 | ACPI_FREE(table_header); | |
3c59f960 BM |
347 | |
348 | if (ACPI_FAILURE(status)) { | |
349 | return_ACPI_STATUS(status); | |
350 | } | |
f0e0da8a DN |
351 | |
352 | /* Must have at least an ACPI table header */ | |
353 | ||
354 | if (length < sizeof(struct acpi_table_header)) { | |
355 | return_ACPI_STATUS(AE_INVALID_TABLE_LENGTH); | |
356 | } | |
357 | ||
358 | /* | |
3c59f960 BM |
359 | * The original implementation simply mapped the table, with no copy. |
360 | * However, the memory region is not guaranteed to remain stable and | |
361 | * we must copy the table to a local buffer. For example, the memory | |
362 | * region is corrupted after suspend on some machines. Dynamically | |
363 | * loaded tables are usually small, so this overhead is minimal. | |
364 | * | |
365 | * The latest implementation (5/2009) does not use a mapping at all. | |
366 | * We use the low-level operation region interface to read the table | |
367 | * instead of the obvious optimization of using a direct mapping. | |
368 | * This maintains a consistent use of operation regions across the | |
369 | * entire subsystem. This is important if additional processing must | |
370 | * be performed in the (possibly user-installed) operation region | |
371 | * handler. For example, acpi_exec and ASLTS depend on this. | |
5eb69180 | 372 | */ |
f0e0da8a DN |
373 | |
374 | /* Allocate a buffer for the table */ | |
375 | ||
86dfc6f3 LZ |
376 | table = ACPI_ALLOCATE(length); |
377 | if (!table) { | |
f0e0da8a DN |
378 | return_ACPI_STATUS(AE_NO_MEMORY); |
379 | } | |
380 | ||
3c59f960 | 381 | /* Read the entire table */ |
f0e0da8a | 382 | |
3c59f960 | 383 | status = acpi_ex_region_read(obj_desc, length, |
86dfc6f3 | 384 | ACPI_CAST_PTR(u8, table)); |
3c59f960 | 385 | if (ACPI_FAILURE(status)) { |
86dfc6f3 | 386 | ACPI_FREE(table); |
3c59f960 | 387 | return_ACPI_STATUS(status); |
f0e0da8a | 388 | } |
1da177e4 LT |
389 | break; |
390 | ||
a6823e12 | 391 | case ACPI_TYPE_BUFFER: /* Buffer or resolved region_field */ |
1da177e4 | 392 | |
a6823e12 | 393 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
f0e0da8a DN |
394 | "Load table from Buffer or Field %p\n", |
395 | obj_desc)); | |
98af37fb BM |
396 | |
397 | /* Must have at least an ACPI table header */ | |
398 | ||
f0e0da8a | 399 | if (obj_desc->buffer.length < sizeof(struct acpi_table_header)) { |
98af37fb BM |
400 | return_ACPI_STATUS(AE_INVALID_TABLE_LENGTH); |
401 | } | |
402 | ||
f0e0da8a | 403 | /* Get the actual table length from the table header */ |
98af37fb | 404 | |
86dfc6f3 | 405 | table_header = |
f0e0da8a DN |
406 | ACPI_CAST_PTR(struct acpi_table_header, |
407 | obj_desc->buffer.pointer); | |
86dfc6f3 | 408 | length = table_header->length; |
f0e0da8a DN |
409 | |
410 | /* Table cannot extend beyond the buffer */ | |
411 | ||
412 | if (length > obj_desc->buffer.length) { | |
413 | return_ACPI_STATUS(AE_AML_BUFFER_LIMIT); | |
414 | } | |
415 | if (length < sizeof(struct acpi_table_header)) { | |
416 | return_ACPI_STATUS(AE_INVALID_TABLE_LENGTH); | |
98af37fb BM |
417 | } |
418 | ||
5eb69180 | 419 | /* |
1fad8738 BM |
420 | * Copy the table from the buffer because the buffer could be |
421 | * modified or even deleted in the future | |
5eb69180 | 422 | */ |
86dfc6f3 LZ |
423 | table = ACPI_ALLOCATE(length); |
424 | if (!table) { | |
5eb69180 BM |
425 | return_ACPI_STATUS(AE_NO_MEMORY); |
426 | } | |
1da177e4 | 427 | |
4fa4616e | 428 | memcpy(table, table_header, length); |
1da177e4 LT |
429 | break; |
430 | ||
1da177e4 | 431 | default: |
1d1ea1b7 | 432 | |
4be44fcd | 433 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); |
1da177e4 LT |
434 | } |
435 | ||
f0e0da8a DN |
436 | /* Install the new table into the local data structures */ |
437 | ||
05fb04b5 | 438 | ACPI_INFO(("Dynamic OEM Table Load:")); |
ac0f06eb LZ |
439 | acpi_ex_exit_interpreter(); |
440 | status = | |
441 | acpi_tb_install_and_load_table(table, ACPI_PTR_TO_PHYSADDR(table), | |
442 | ACPI_TABLE_ORIGIN_INTERNAL_VIRTUAL, | |
443 | TRUE, &table_index); | |
444 | acpi_ex_enter_interpreter(); | |
f3d2e786 | 445 | if (ACPI_FAILURE(status)) { |
2147d3f0 BM |
446 | |
447 | /* Delete allocated table buffer */ | |
448 | ||
86dfc6f3 LZ |
449 | ACPI_FREE(table); |
450 | return_ACPI_STATUS(status); | |
451 | } | |
452 | ||
0bda3f2f BM |
453 | /* |
454 | * Add the table to the namespace. | |
455 | * | |
f0e0da8a | 456 | * Note: Load the table objects relative to the root of the namespace. |
0bda3f2f BM |
457 | * This appears to go against the ACPI specification, but we do it for |
458 | * compatibility with other ACPI implementations. | |
459 | */ | |
ac0f06eb | 460 | status = acpi_ex_add_table(table_index, &ddb_handle); |
4be44fcd | 461 | if (ACPI_FAILURE(status)) { |
52fc0b02 | 462 | |
88ac00f5 RM |
463 | /* On error, table_ptr was deallocated above */ |
464 | ||
4be44fcd | 465 | return_ACPI_STATUS(status); |
1da177e4 LT |
466 | } |
467 | ||
468 | /* Store the ddb_handle into the Target operand */ | |
469 | ||
4be44fcd LB |
470 | status = acpi_ex_store(ddb_handle, target, walk_state); |
471 | if (ACPI_FAILURE(status)) { | |
472 | (void)acpi_ex_unload_table(ddb_handle); | |
1da177e4 | 473 | |
88ac00f5 | 474 | /* table_ptr was deallocated above */ |
1da177e4 | 475 | |
a13b8460 | 476 | acpi_ut_remove_reference(ddb_handle); |
4be44fcd | 477 | return_ACPI_STATUS(status); |
88ac00f5 | 478 | } |
1da177e4 | 479 | |
06366c14 LM |
480 | /* Remove the reference by added by acpi_ex_store above */ |
481 | ||
482 | acpi_ut_remove_reference(ddb_handle); | |
4be44fcd | 483 | return_ACPI_STATUS(status); |
1da177e4 LT |
484 | } |
485 | ||
1da177e4 LT |
486 | /******************************************************************************* |
487 | * | |
488 | * FUNCTION: acpi_ex_unload_table | |
489 | * | |
490 | * PARAMETERS: ddb_handle - Handle to a previously loaded table | |
491 | * | |
492 | * RETURN: Status | |
493 | * | |
494 | * DESCRIPTION: Unload an ACPI table | |
495 | * | |
496 | ******************************************************************************/ | |
497 | ||
4be44fcd | 498 | acpi_status acpi_ex_unload_table(union acpi_operand_object *ddb_handle) |
1da177e4 | 499 | { |
4be44fcd LB |
500 | acpi_status status = AE_OK; |
501 | union acpi_operand_object *table_desc = ddb_handle; | |
67a119f9 | 502 | u32 table_index; |
3e08e2d2 | 503 | struct acpi_table_header *table; |
1da177e4 | 504 | |
b229cf92 | 505 | ACPI_FUNCTION_TRACE(ex_unload_table); |
1da177e4 | 506 | |
43d1a62d BM |
507 | /* |
508 | * Temporarily emit a warning so that the ASL for the machine can be | |
509 | * hopefully obtained. This is to say that the Unload() operator is | |
510 | * extremely rare if not completely unused. | |
511 | */ | |
512 | ACPI_WARNING((AE_INFO, "Received request to unload an ACPI table")); | |
513 | ||
1da177e4 LT |
514 | /* |
515 | * Validate the handle | |
e0be6f5a | 516 | * Although the handle is partially validated in acpi_ex_reconfiguration() |
1da177e4 LT |
517 | * when it calls acpi_ex_resolve_operands(), the handle is more completely |
518 | * validated here. | |
e0be6f5a LM |
519 | * |
520 | * Handle must be a valid operand object of type reference. Also, the | |
521 | * ddb_handle must still be marked valid (table has not been previously | |
522 | * unloaded) | |
1da177e4 LT |
523 | */ |
524 | if ((!ddb_handle) || | |
4be44fcd | 525 | (ACPI_GET_DESCRIPTOR_TYPE(ddb_handle) != ACPI_DESC_TYPE_OPERAND) || |
e0be6f5a LM |
526 | (ddb_handle->common.type != ACPI_TYPE_LOCAL_REFERENCE) || |
527 | (!(ddb_handle->common.flags & AOPOBJ_DATA_VALID))) { | |
f6f57f60 | 528 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); |
1da177e4 LT |
529 | } |
530 | ||
57e664cf | 531 | /* Get the table index from the ddb_handle */ |
1da177e4 | 532 | |
57e664cf | 533 | table_index = table_desc->reference.value; |
1da177e4 | 534 | |
e0be6f5a LM |
535 | /* Ensure the table is still loaded */ |
536 | ||
537 | if (!acpi_tb_is_table_loaded(table_index)) { | |
538 | return_ACPI_STATUS(AE_NOT_EXIST); | |
539 | } | |
540 | ||
3e08e2d2 LM |
541 | /* Invoke table handler if present */ |
542 | ||
543 | if (acpi_gbl_table_handler) { | |
544 | status = acpi_get_table_by_index(table_index, &table); | |
545 | if (ACPI_SUCCESS(status)) { | |
546 | (void)acpi_gbl_table_handler(ACPI_TABLE_EVENT_UNLOAD, | |
547 | table, | |
548 | acpi_gbl_table_handler_context); | |
549 | } | |
550 | } | |
551 | ||
8a335a23 BM |
552 | /* Delete the portion of the namespace owned by this table */ |
553 | ||
554 | status = acpi_tb_delete_namespace_by_owner(table_index); | |
555 | if (ACPI_FAILURE(status)) { | |
556 | return_ACPI_STATUS(status); | |
557 | } | |
1da177e4 | 558 | |
8a335a23 | 559 | (void)acpi_tb_release_owner_id(table_index); |
f3d2e786 | 560 | acpi_tb_set_table_loaded_flag(table_index, FALSE); |
1da177e4 | 561 | |
e0be6f5a LM |
562 | /* |
563 | * Invalidate the handle. We do this because the handle may be stored | |
564 | * in a named object and may not be actually deleted until much later. | |
565 | */ | |
566 | ddb_handle->common.flags &= ~AOPOBJ_DATA_VALID; | |
3e08e2d2 | 567 | return_ACPI_STATUS(AE_OK); |
1da177e4 | 568 | } |