Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /****************************************************************************** |
2 | * | |
3 | * Module Name: exconfig - Namespace reconfiguration (Load/Unload opcodes) | |
4 | * | |
5 | *****************************************************************************/ | |
6 | ||
7 | /* | |
6c9deb72 | 8 | * Copyright (C) 2000 - 2007, R. Byron Moore |
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 LT |
44 | #include <acpi/acpi.h> |
45 | #include <acpi/acinterp.h> | |
46 | #include <acpi/amlcode.h> | |
47 | #include <acpi/acnamesp.h> | |
48 | #include <acpi/acevents.h> | |
49 | #include <acpi/actables.h> | |
50 | #include <acpi/acdispat.h> | |
51 | ||
1da177e4 | 52 | #define _COMPONENT ACPI_EXECUTER |
4be44fcd | 53 | ACPI_MODULE_NAME("exconfig") |
1da177e4 | 54 | |
44f6c012 | 55 | /* Local prototypes */ |
44f6c012 | 56 | static acpi_status |
f3d2e786 | 57 | acpi_ex_add_table(acpi_native_uint table_index, |
4be44fcd LB |
58 | struct acpi_namespace_node *parent_node, |
59 | union acpi_operand_object **ddb_handle); | |
1da177e4 LT |
60 | |
61 | /******************************************************************************* | |
62 | * | |
63 | * FUNCTION: acpi_ex_add_table | |
64 | * | |
65 | * PARAMETERS: Table - Pointer to raw table | |
66 | * parent_node - Where to load the table (scope) | |
67 | * ddb_handle - Where to return the table handle. | |
68 | * | |
69 | * RETURN: Status | |
70 | * | |
71 | * DESCRIPTION: Common function to Install and Load an ACPI table with a | |
72 | * returned table handle. | |
73 | * | |
74 | ******************************************************************************/ | |
75 | ||
44f6c012 | 76 | static acpi_status |
f3d2e786 | 77 | acpi_ex_add_table(acpi_native_uint table_index, |
4be44fcd LB |
78 | struct acpi_namespace_node *parent_node, |
79 | union acpi_operand_object **ddb_handle) | |
1da177e4 | 80 | { |
4be44fcd | 81 | acpi_status status; |
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 | ||
95 | obj_desc->reference.opcode = AML_LOAD_OP; | |
96 | *ddb_handle = obj_desc; | |
97 | ||
1da177e4 LT |
98 | /* Install the new table into the local data structures */ |
99 | ||
f3d2e786 | 100 | obj_desc->reference.object = ACPI_CAST_PTR(void, table_index); |
1da177e4 LT |
101 | |
102 | /* Add the table to the namespace */ | |
103 | ||
f3d2e786 | 104 | status = acpi_ns_load_table(table_index, parent_node); |
4be44fcd | 105 | if (ACPI_FAILURE(status)) { |
f3d2e786 BM |
106 | acpi_ut_remove_reference(obj_desc); |
107 | *ddb_handle = NULL; | |
1da177e4 LT |
108 | } |
109 | ||
4be44fcd | 110 | return_ACPI_STATUS(status); |
1da177e4 LT |
111 | } |
112 | ||
1da177e4 LT |
113 | /******************************************************************************* |
114 | * | |
115 | * FUNCTION: acpi_ex_load_table_op | |
116 | * | |
117 | * PARAMETERS: walk_state - Current state with operands | |
118 | * return_desc - Where to store the return object | |
119 | * | |
120 | * RETURN: Status | |
121 | * | |
a6823e12 | 122 | * DESCRIPTION: Load an ACPI table from the RSDT/XSDT |
1da177e4 LT |
123 | * |
124 | ******************************************************************************/ | |
125 | ||
126 | acpi_status | |
4be44fcd LB |
127 | acpi_ex_load_table_op(struct acpi_walk_state *walk_state, |
128 | union acpi_operand_object **return_desc) | |
1da177e4 | 129 | { |
4be44fcd LB |
130 | acpi_status status; |
131 | union acpi_operand_object **operand = &walk_state->operands[0]; | |
f3d2e786 | 132 | acpi_native_uint table_index; |
4be44fcd LB |
133 | struct acpi_namespace_node *parent_node; |
134 | struct acpi_namespace_node *start_node; | |
135 | struct acpi_namespace_node *parameter_node = NULL; | |
136 | union acpi_operand_object *ddb_handle; | |
f3d2e786 | 137 | struct acpi_table_header *table; |
1da177e4 | 138 | |
b229cf92 | 139 | ACPI_FUNCTION_TRACE(ex_load_table_op); |
1da177e4 | 140 | |
a6823e12 | 141 | /* Find the ACPI table in the RSDT/XSDT */ |
1da177e4 | 142 | |
4be44fcd LB |
143 | status = acpi_tb_find_table(operand[0]->string.pointer, |
144 | operand[1]->string.pointer, | |
f3d2e786 | 145 | operand[2]->string.pointer, &table_index); |
4be44fcd | 146 | if (ACPI_FAILURE(status)) { |
1da177e4 | 147 | if (status != AE_NOT_FOUND) { |
4be44fcd | 148 | return_ACPI_STATUS(status); |
1da177e4 LT |
149 | } |
150 | ||
151 | /* Table not found, return an Integer=0 and AE_OK */ | |
152 | ||
4be44fcd | 153 | ddb_handle = acpi_ut_create_internal_object(ACPI_TYPE_INTEGER); |
1da177e4 | 154 | if (!ddb_handle) { |
4be44fcd | 155 | return_ACPI_STATUS(AE_NO_MEMORY); |
1da177e4 LT |
156 | } |
157 | ||
158 | ddb_handle->integer.value = 0; | |
159 | *return_desc = ddb_handle; | |
160 | ||
4be44fcd | 161 | return_ACPI_STATUS(AE_OK); |
1da177e4 LT |
162 | } |
163 | ||
164 | /* Default nodes */ | |
165 | ||
166 | start_node = walk_state->scope_info->scope.node; | |
167 | parent_node = acpi_gbl_root_node; | |
168 | ||
169 | /* root_path (optional parameter) */ | |
170 | ||
171 | if (operand[3]->string.length > 0) { | |
172 | /* | |
173 | * Find the node referenced by the root_path_string. This is the | |
174 | * location within the namespace where the table will be loaded. | |
175 | */ | |
4be44fcd | 176 | status = |
4119532c BM |
177 | acpi_ns_get_node(start_node, operand[3]->string.pointer, |
178 | ACPI_NS_SEARCH_PARENT, &parent_node); | |
4be44fcd LB |
179 | if (ACPI_FAILURE(status)) { |
180 | return_ACPI_STATUS(status); | |
1da177e4 LT |
181 | } |
182 | } | |
183 | ||
184 | /* parameter_path (optional parameter) */ | |
185 | ||
186 | if (operand[4]->string.length > 0) { | |
187 | if ((operand[4]->string.pointer[0] != '\\') && | |
4be44fcd | 188 | (operand[4]->string.pointer[0] != '^')) { |
1da177e4 LT |
189 | /* |
190 | * Path is not absolute, so it will be relative to the node | |
191 | * referenced by the root_path_string (or the NS root if omitted) | |
192 | */ | |
193 | start_node = parent_node; | |
194 | } | |
195 | ||
44f6c012 RM |
196 | /* Find the node referenced by the parameter_path_string */ |
197 | ||
4be44fcd | 198 | status = |
4119532c BM |
199 | acpi_ns_get_node(start_node, operand[4]->string.pointer, |
200 | ACPI_NS_SEARCH_PARENT, ¶meter_node); | |
4be44fcd LB |
201 | if (ACPI_FAILURE(status)) { |
202 | return_ACPI_STATUS(status); | |
1da177e4 LT |
203 | } |
204 | } | |
205 | ||
206 | /* Load the table into the namespace */ | |
207 | ||
f3d2e786 | 208 | status = acpi_ex_add_table(table_index, parent_node, &ddb_handle); |
4be44fcd LB |
209 | if (ACPI_FAILURE(status)) { |
210 | return_ACPI_STATUS(status); | |
1da177e4 LT |
211 | } |
212 | ||
213 | /* Parameter Data (optional) */ | |
214 | ||
215 | if (parameter_node) { | |
52fc0b02 | 216 | |
1da177e4 LT |
217 | /* Store the parameter data into the optional parameter object */ |
218 | ||
4be44fcd LB |
219 | status = acpi_ex_store(operand[5], |
220 | ACPI_CAST_PTR(union acpi_operand_object, | |
221 | parameter_node), | |
222 | walk_state); | |
223 | if (ACPI_FAILURE(status)) { | |
224 | (void)acpi_ex_unload_table(ddb_handle); | |
225 | return_ACPI_STATUS(status); | |
1da177e4 LT |
226 | } |
227 | } | |
228 | ||
f3d2e786 BM |
229 | status = acpi_get_table_by_index(table_index, &table); |
230 | if (ACPI_SUCCESS(status)) { | |
231 | ACPI_INFO((AE_INFO, | |
232 | "Dynamic OEM Table Load - [%4.4s] OemId [%6.6s] OemTableId [%8.8s]", | |
233 | table->signature, table->oem_id, | |
234 | table->oem_table_id)); | |
235 | } | |
967440e3 | 236 | |
3e08e2d2 LM |
237 | /* Invoke table handler if present */ |
238 | ||
239 | if (acpi_gbl_table_handler) { | |
240 | (void)acpi_gbl_table_handler(ACPI_TABLE_EVENT_LOAD, table, | |
241 | acpi_gbl_table_handler_context); | |
242 | } | |
243 | ||
1da177e4 | 244 | *return_desc = ddb_handle; |
4be44fcd | 245 | return_ACPI_STATUS(status); |
1da177e4 LT |
246 | } |
247 | ||
1da177e4 LT |
248 | /******************************************************************************* |
249 | * | |
250 | * FUNCTION: acpi_ex_load_op | |
251 | * | |
a6823e12 | 252 | * PARAMETERS: obj_desc - Region or Buffer/Field where the table will be |
1da177e4 LT |
253 | * obtained |
254 | * Target - Where a handle to the table will be stored | |
255 | * walk_state - Current state | |
256 | * | |
257 | * RETURN: Status | |
258 | * | |
259 | * DESCRIPTION: Load an ACPI table from a field or operation region | |
260 | * | |
a6823e12 AS |
261 | * NOTE: Region Fields (Field, bank_field, index_fields) are resolved to buffer |
262 | * objects before this code is reached. | |
263 | * | |
264 | * If source is an operation region, it must refer to system_memory, as | |
265 | * per the ACPI specification. | |
266 | * | |
1da177e4 LT |
267 | ******************************************************************************/ |
268 | ||
269 | acpi_status | |
4be44fcd LB |
270 | acpi_ex_load_op(union acpi_operand_object *obj_desc, |
271 | union acpi_operand_object *target, | |
272 | struct acpi_walk_state *walk_state) | |
1da177e4 | 273 | { |
4be44fcd | 274 | union acpi_operand_object *ddb_handle; |
428f2112 | 275 | struct acpi_table_desc table_desc; |
a6823e12 AS |
276 | acpi_native_uint table_index; |
277 | acpi_status status; | |
98af37fb | 278 | u32 length; |
1da177e4 | 279 | |
b229cf92 | 280 | ACPI_FUNCTION_TRACE(ex_load_op); |
1da177e4 | 281 | |
428f2112 | 282 | ACPI_MEMSET(&table_desc, 0, sizeof(struct acpi_table_desc)); |
a6823e12 AS |
283 | |
284 | /* Source Object can be either an op_region or a Buffer/Field */ | |
285 | ||
4be44fcd | 286 | switch (ACPI_GET_OBJECT_TYPE(obj_desc)) { |
1da177e4 LT |
287 | case ACPI_TYPE_REGION: |
288 | ||
5eb69180 BM |
289 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Load from Region %p %s\n", |
290 | obj_desc, | |
291 | acpi_ut_get_object_type_name(obj_desc))); | |
292 | ||
a6823e12 AS |
293 | /* Region must be system_memory (from ACPI spec) */ |
294 | ||
295 | if (obj_desc->region.space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY) { | |
296 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); | |
297 | } | |
298 | ||
1da177e4 LT |
299 | /* |
300 | * If the Region Address and Length have not been previously evaluated, | |
301 | * evaluate them now and save the results. | |
302 | */ | |
303 | if (!(obj_desc->common.flags & AOPOBJ_DATA_VALID)) { | |
4be44fcd LB |
304 | status = acpi_ds_get_region_arguments(obj_desc); |
305 | if (ACPI_FAILURE(status)) { | |
306 | return_ACPI_STATUS(status); | |
1da177e4 LT |
307 | } |
308 | } | |
309 | ||
5eb69180 BM |
310 | /* |
311 | * We will simply map the memory region for the table. However, the | |
312 | * memory region is technically not guaranteed to remain stable and | |
313 | * we may eventually have to copy the table to a local buffer. | |
314 | */ | |
a6823e12 AS |
315 | table_desc.address = obj_desc->region.address; |
316 | table_desc.length = obj_desc->region.length; | |
317 | table_desc.flags = ACPI_TABLE_ORIGIN_MAPPED; | |
1da177e4 LT |
318 | break; |
319 | ||
a6823e12 | 320 | case ACPI_TYPE_BUFFER: /* Buffer or resolved region_field */ |
1da177e4 | 321 | |
a6823e12 AS |
322 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
323 | "Load from Buffer or Field %p %s\n", obj_desc, | |
324 | acpi_ut_get_object_type_name(obj_desc))); | |
88ac00f5 | 325 | |
98af37fb BM |
326 | length = obj_desc->buffer.length; |
327 | ||
328 | /* Must have at least an ACPI table header */ | |
329 | ||
330 | if (length < sizeof(struct acpi_table_header)) { | |
331 | return_ACPI_STATUS(AE_INVALID_TABLE_LENGTH); | |
332 | } | |
333 | ||
334 | /* Validate checksum here. It won't get validated in tb_add_table */ | |
335 | ||
336 | status = acpi_tb_verify_checksum((struct acpi_table_header *) | |
337 | obj_desc->buffer.pointer, | |
338 | length); | |
339 | if (ACPI_FAILURE(status)) { | |
340 | return_ACPI_STATUS(status); | |
341 | } | |
342 | ||
5eb69180 BM |
343 | /* |
344 | * We need to copy the buffer since the original buffer could be | |
345 | * changed or deleted in the future | |
346 | */ | |
98af37fb | 347 | table_desc.pointer = ACPI_ALLOCATE(length); |
5eb69180 BM |
348 | if (!table_desc.pointer) { |
349 | return_ACPI_STATUS(AE_NO_MEMORY); | |
350 | } | |
1da177e4 | 351 | |
5eb69180 | 352 | ACPI_MEMCPY(table_desc.pointer, obj_desc->buffer.pointer, |
98af37fb BM |
353 | length); |
354 | table_desc.length = length; | |
5eb69180 | 355 | table_desc.flags = ACPI_TABLE_ORIGIN_ALLOCATED; |
1da177e4 LT |
356 | break; |
357 | ||
1da177e4 | 358 | default: |
4be44fcd | 359 | return_ACPI_STATUS(AE_AML_OPERAND_TYPE); |
1da177e4 LT |
360 | } |
361 | ||
f3d2e786 BM |
362 | /* |
363 | * Install the new table into the local data structures | |
364 | */ | |
428f2112 | 365 | status = acpi_tb_add_table(&table_desc, &table_index); |
f3d2e786 | 366 | if (ACPI_FAILURE(status)) { |
0fab8997 | 367 | goto cleanup; |
f3d2e786 | 368 | } |
1da177e4 | 369 | |
f3d2e786 | 370 | status = |
7f4ac9f9 BM |
371 | acpi_ex_add_table(table_index, walk_state->scope_info->scope.node, |
372 | &ddb_handle); | |
4be44fcd | 373 | if (ACPI_FAILURE(status)) { |
52fc0b02 | 374 | |
88ac00f5 RM |
375 | /* On error, table_ptr was deallocated above */ |
376 | ||
4be44fcd | 377 | return_ACPI_STATUS(status); |
1da177e4 LT |
378 | } |
379 | ||
380 | /* Store the ddb_handle into the Target operand */ | |
381 | ||
4be44fcd LB |
382 | status = acpi_ex_store(ddb_handle, target, walk_state); |
383 | if (ACPI_FAILURE(status)) { | |
384 | (void)acpi_ex_unload_table(ddb_handle); | |
1da177e4 | 385 | |
88ac00f5 | 386 | /* table_ptr was deallocated above */ |
1da177e4 | 387 | |
a13b8460 | 388 | acpi_ut_remove_reference(ddb_handle); |
4be44fcd | 389 | return_ACPI_STATUS(status); |
88ac00f5 | 390 | } |
1da177e4 | 391 | |
3e08e2d2 LM |
392 | /* Invoke table handler if present */ |
393 | ||
394 | if (acpi_gbl_table_handler) { | |
395 | (void)acpi_gbl_table_handler(ACPI_TABLE_EVENT_LOAD, | |
396 | table_desc.pointer, | |
397 | acpi_gbl_table_handler_context); | |
398 | } | |
399 | ||
4be44fcd LB |
400 | cleanup: |
401 | if (ACPI_FAILURE(status)) { | |
5eb69180 BM |
402 | |
403 | /* Delete allocated buffer or mapping */ | |
404 | ||
a6823e12 | 405 | acpi_tb_delete_table(&table_desc); |
1da177e4 | 406 | } |
4be44fcd | 407 | return_ACPI_STATUS(status); |
1da177e4 LT |
408 | } |
409 | ||
1da177e4 LT |
410 | /******************************************************************************* |
411 | * | |
412 | * FUNCTION: acpi_ex_unload_table | |
413 | * | |
414 | * PARAMETERS: ddb_handle - Handle to a previously loaded table | |
415 | * | |
416 | * RETURN: Status | |
417 | * | |
418 | * DESCRIPTION: Unload an ACPI table | |
419 | * | |
420 | ******************************************************************************/ | |
421 | ||
4be44fcd | 422 | acpi_status acpi_ex_unload_table(union acpi_operand_object *ddb_handle) |
1da177e4 | 423 | { |
4be44fcd LB |
424 | acpi_status status = AE_OK; |
425 | union acpi_operand_object *table_desc = ddb_handle; | |
f3d2e786 | 426 | acpi_native_uint table_index; |
3e08e2d2 | 427 | struct acpi_table_header *table; |
1da177e4 | 428 | |
b229cf92 | 429 | ACPI_FUNCTION_TRACE(ex_unload_table); |
1da177e4 LT |
430 | |
431 | /* | |
432 | * Validate the handle | |
433 | * Although the handle is partially validated in acpi_ex_reconfiguration(), | |
434 | * when it calls acpi_ex_resolve_operands(), the handle is more completely | |
435 | * validated here. | |
436 | */ | |
437 | if ((!ddb_handle) || | |
4be44fcd LB |
438 | (ACPI_GET_DESCRIPTOR_TYPE(ddb_handle) != ACPI_DESC_TYPE_OPERAND) || |
439 | (ACPI_GET_OBJECT_TYPE(ddb_handle) != ACPI_TYPE_LOCAL_REFERENCE)) { | |
440 | return_ACPI_STATUS(AE_BAD_PARAMETER); | |
1da177e4 LT |
441 | } |
442 | ||
f3d2e786 | 443 | /* Get the table index from the ddb_handle */ |
1da177e4 | 444 | |
f3d2e786 | 445 | table_index = (acpi_native_uint) table_desc->reference.object; |
1da177e4 | 446 | |
3e08e2d2 LM |
447 | /* Invoke table handler if present */ |
448 | ||
449 | if (acpi_gbl_table_handler) { | |
450 | status = acpi_get_table_by_index(table_index, &table); | |
451 | if (ACPI_SUCCESS(status)) { | |
452 | (void)acpi_gbl_table_handler(ACPI_TABLE_EVENT_UNLOAD, | |
453 | table, | |
454 | acpi_gbl_table_handler_context); | |
455 | } | |
456 | } | |
457 | ||
1da177e4 LT |
458 | /* |
459 | * Delete the entire namespace under this table Node | |
460 | * (Offset contains the table_id) | |
461 | */ | |
f3d2e786 BM |
462 | acpi_tb_delete_namespace_by_owner(table_index); |
463 | acpi_tb_release_owner_id(table_index); | |
1da177e4 | 464 | |
f3d2e786 | 465 | acpi_tb_set_table_loaded_flag(table_index, FALSE); |
1da177e4 LT |
466 | |
467 | /* Delete the table descriptor (ddb_handle) */ | |
468 | ||
4be44fcd | 469 | acpi_ut_remove_reference(table_desc); |
3e08e2d2 | 470 | return_ACPI_STATUS(AE_OK); |
1da177e4 | 471 | } |