Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /****************************************************************************** |
2 | * | |
3 | * Module Name: nsxfname - Public interfaces to the ACPI subsystem | |
4 | * ACPI Namespace oriented interfaces | |
5 | * | |
6 | *****************************************************************************/ | |
7 | ||
8 | /* | |
77848130 | 9 | * Copyright (C) 2000 - 2012, Intel Corp. |
1da177e4 LT |
10 | * All rights reserved. |
11 | * | |
12 | * Redistribution and use in source and binary forms, with or without | |
13 | * modification, are permitted provided that the following conditions | |
14 | * are met: | |
15 | * 1. Redistributions of source code must retain the above copyright | |
16 | * notice, this list of conditions, and the following disclaimer, | |
17 | * without modification. | |
18 | * 2. Redistributions in binary form must reproduce at minimum a disclaimer | |
19 | * substantially similar to the "NO WARRANTY" disclaimer below | |
20 | * ("Disclaimer") and any redistribution must be conditioned upon | |
21 | * including a substantially similar Disclaimer requirement for further | |
22 | * binary redistribution. | |
23 | * 3. Neither the names of the above-listed copyright holders nor the names | |
24 | * of any contributors may be used to endorse or promote products derived | |
25 | * from this software without specific prior written permission. | |
26 | * | |
27 | * Alternatively, this software may be distributed under the terms of the | |
28 | * GNU General Public License ("GPL") version 2 as published by the Free | |
29 | * Software Foundation. | |
30 | * | |
31 | * NO WARRANTY | |
32 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
33 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
34 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR | |
35 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
36 | * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
37 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
38 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
39 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, | |
40 | * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING | |
41 | * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | |
42 | * POSSIBILITY OF SUCH DAMAGES. | |
43 | */ | |
44 | ||
214f2c90 | 45 | #include <linux/export.h> |
1da177e4 | 46 | #include <acpi/acpi.h> |
e2f7a777 LB |
47 | #include "accommon.h" |
48 | #include "acnamesp.h" | |
b2f7ddcf LM |
49 | #include "acparser.h" |
50 | #include "amlcode.h" | |
1da177e4 | 51 | |
1da177e4 | 52 | #define _COMPONENT ACPI_NAMESPACE |
4be44fcd | 53 | ACPI_MODULE_NAME("nsxfname") |
1da177e4 | 54 | |
15b8dd53 | 55 | /* Local prototypes */ |
78e25fef LZ |
56 | static char *acpi_ns_copy_device_id(struct acpi_pnp_device_id *dest, |
57 | struct acpi_pnp_device_id *source, | |
15b8dd53 BM |
58 | char *string_area); |
59 | ||
1da177e4 LT |
60 | /****************************************************************************** |
61 | * | |
62 | * FUNCTION: acpi_get_handle | |
63 | * | |
ba494bee BM |
64 | * PARAMETERS: parent - Object to search under (search scope). |
65 | * pathname - Pointer to an asciiz string containing the | |
44f6c012 RM |
66 | * name |
67 | * ret_handle - Where the return handle is returned | |
1da177e4 LT |
68 | * |
69 | * RETURN: Status | |
70 | * | |
71 | * DESCRIPTION: This routine will search for a caller specified name in the | |
73a3090a BM |
72 | * name space. The caller can restrict the search region by |
73 | * specifying a non NULL parent. The parent value is itself a | |
1da177e4 LT |
74 | * namespace handle. |
75 | * | |
76 | ******************************************************************************/ | |
15b8dd53 | 77 | |
1da177e4 | 78 | acpi_status |
4be44fcd LB |
79 | acpi_get_handle(acpi_handle parent, |
80 | acpi_string pathname, acpi_handle * ret_handle) | |
1da177e4 | 81 | { |
4be44fcd LB |
82 | acpi_status status; |
83 | struct acpi_namespace_node *node = NULL; | |
84 | struct acpi_namespace_node *prefix_node = NULL; | |
1da177e4 | 85 | |
4be44fcd | 86 | ACPI_FUNCTION_ENTRY(); |
1da177e4 LT |
87 | |
88 | /* Parameter Validation */ | |
89 | ||
90 | if (!ret_handle || !pathname) { | |
91 | return (AE_BAD_PARAMETER); | |
92 | } | |
93 | ||
94 | /* Convert a parent handle to a prefix node */ | |
95 | ||
96 | if (parent) { | |
f24b664d | 97 | prefix_node = acpi_ns_validate_handle(parent); |
1da177e4 | 98 | if (!prefix_node) { |
1da177e4 LT |
99 | return (AE_BAD_PARAMETER); |
100 | } | |
f1c2b1da BM |
101 | } |
102 | ||
103 | /* | |
104 | * Valid cases are: | |
105 | * 1) Fully qualified pathname | |
106 | * 2) Parent + Relative pathname | |
107 | * | |
108 | * Error for <null Parent + relative path> | |
109 | */ | |
110 | if (acpi_ns_valid_root_prefix(pathname[0])) { | |
1da177e4 | 111 | |
f1c2b1da BM |
112 | /* Pathname is fully qualified (starts with '\') */ |
113 | ||
114 | /* Special case for root-only, since we can't search for it */ | |
115 | ||
116 | if (!ACPI_STRCMP(pathname, ACPI_NS_ROOT_PATH)) { | |
117 | *ret_handle = | |
f24b664d | 118 | ACPI_CAST_PTR(acpi_handle, acpi_gbl_root_node); |
f1c2b1da | 119 | return (AE_OK); |
1da177e4 | 120 | } |
f1c2b1da | 121 | } else if (!prefix_node) { |
1da177e4 | 122 | |
f1c2b1da | 123 | /* Relative path with null prefix is disallowed */ |
1da177e4 | 124 | |
f1c2b1da | 125 | return (AE_BAD_PARAMETER); |
1da177e4 LT |
126 | } |
127 | ||
f1c2b1da | 128 | /* Find the Node and convert to a handle */ |
1da177e4 | 129 | |
f1c2b1da BM |
130 | status = |
131 | acpi_ns_get_node(prefix_node, pathname, ACPI_NS_NO_UPSEARCH, &node); | |
4be44fcd | 132 | if (ACPI_SUCCESS(status)) { |
f24b664d | 133 | *ret_handle = ACPI_CAST_PTR(acpi_handle, node); |
1da177e4 LT |
134 | } |
135 | ||
136 | return (status); | |
137 | } | |
1da177e4 | 138 | |
8313524a | 139 | ACPI_EXPORT_SYMBOL(acpi_get_handle) |
1da177e4 LT |
140 | |
141 | /****************************************************************************** | |
142 | * | |
143 | * FUNCTION: acpi_get_name | |
144 | * | |
ba494bee | 145 | * PARAMETERS: handle - Handle to be converted to a pathname |
1da177e4 | 146 | * name_type - Full pathname or single segment |
ba494bee | 147 | * buffer - Buffer for returned path |
1da177e4 LT |
148 | * |
149 | * RETURN: Pointer to a string containing the fully qualified Name. | |
150 | * | |
151 | * DESCRIPTION: This routine returns the fully qualified name associated with | |
73a3090a | 152 | * the Handle parameter. This and the acpi_pathname_to_handle are |
1da177e4 LT |
153 | * complementary functions. |
154 | * | |
155 | ******************************************************************************/ | |
1da177e4 | 156 | acpi_status |
4be44fcd | 157 | acpi_get_name(acpi_handle handle, u32 name_type, struct acpi_buffer * buffer) |
1da177e4 | 158 | { |
4be44fcd LB |
159 | acpi_status status; |
160 | struct acpi_namespace_node *node; | |
1da177e4 LT |
161 | |
162 | /* Parameter validation */ | |
163 | ||
164 | if (name_type > ACPI_NAME_TYPE_MAX) { | |
165 | return (AE_BAD_PARAMETER); | |
166 | } | |
167 | ||
4be44fcd LB |
168 | status = acpi_ut_validate_buffer(buffer); |
169 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
170 | return (status); |
171 | } | |
172 | ||
173 | if (name_type == ACPI_FULL_PATHNAME) { | |
52fc0b02 | 174 | |
1da177e4 LT |
175 | /* Get the full pathname (From the namespace root) */ |
176 | ||
4be44fcd | 177 | status = acpi_ns_handle_to_pathname(handle, buffer); |
1da177e4 LT |
178 | return (status); |
179 | } | |
180 | ||
181 | /* | |
182 | * Wants the single segment ACPI name. | |
183 | * Validate handle and convert to a namespace Node | |
184 | */ | |
4be44fcd LB |
185 | status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE); |
186 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
187 | return (status); |
188 | } | |
189 | ||
f24b664d | 190 | node = acpi_ns_validate_handle(handle); |
1da177e4 LT |
191 | if (!node) { |
192 | status = AE_BAD_PARAMETER; | |
193 | goto unlock_and_exit; | |
194 | } | |
195 | ||
196 | /* Validate/Allocate/Clear caller buffer */ | |
197 | ||
4be44fcd LB |
198 | status = acpi_ut_initialize_buffer(buffer, ACPI_PATH_SEGMENT_LENGTH); |
199 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
200 | goto unlock_and_exit; |
201 | } | |
202 | ||
203 | /* Just copy the ACPI name from the Node and zero terminate it */ | |
204 | ||
4be44fcd LB |
205 | ACPI_STRNCPY(buffer->pointer, acpi_ut_get_node_name(node), |
206 | ACPI_NAME_SIZE); | |
207 | ((char *)buffer->pointer)[ACPI_NAME_SIZE] = 0; | |
1da177e4 LT |
208 | status = AE_OK; |
209 | ||
4be44fcd | 210 | unlock_and_exit: |
1da177e4 | 211 | |
4be44fcd | 212 | (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); |
1da177e4 LT |
213 | return (status); |
214 | } | |
1da177e4 | 215 | |
8313524a | 216 | ACPI_EXPORT_SYMBOL(acpi_get_name) |
1da177e4 | 217 | |
15b8dd53 BM |
218 | /****************************************************************************** |
219 | * | |
220 | * FUNCTION: acpi_ns_copy_device_id | |
221 | * | |
78e25fef LZ |
222 | * PARAMETERS: dest - Pointer to the destination PNP_DEVICE_ID |
223 | * source - Pointer to the source PNP_DEVICE_ID | |
15b8dd53 BM |
224 | * string_area - Pointer to where to copy the dest string |
225 | * | |
226 | * RETURN: Pointer to the next string area | |
227 | * | |
78e25fef | 228 | * DESCRIPTION: Copy a single PNP_DEVICE_ID, including the string data. |
15b8dd53 BM |
229 | * |
230 | ******************************************************************************/ | |
78e25fef LZ |
231 | static char *acpi_ns_copy_device_id(struct acpi_pnp_device_id *dest, |
232 | struct acpi_pnp_device_id *source, | |
15b8dd53 BM |
233 | char *string_area) |
234 | { | |
78e25fef | 235 | /* Create the destination PNP_DEVICE_ID */ |
15b8dd53 BM |
236 | |
237 | dest->string = string_area; | |
238 | dest->length = source->length; | |
239 | ||
240 | /* Copy actual string and return a pointer to the next string area */ | |
241 | ||
242 | ACPI_MEMCPY(string_area, source->string, source->length); | |
243 | return (string_area + source->length); | |
244 | } | |
245 | ||
1da177e4 LT |
246 | /****************************************************************************** |
247 | * | |
248 | * FUNCTION: acpi_get_object_info | |
249 | * | |
ba494bee | 250 | * PARAMETERS: handle - Object Handle |
15b8dd53 | 251 | * return_buffer - Where the info is returned |
1da177e4 LT |
252 | * |
253 | * RETURN: Status | |
254 | * | |
255 | * DESCRIPTION: Returns information about an object as gleaned from the | |
256 | * namespace node and possibly by running several standard | |
257 | * control methods (Such as in the case of a device.) | |
258 | * | |
15b8dd53 BM |
259 | * For Device and Processor objects, run the Device _HID, _UID, _CID, _STA, |
260 | * _ADR, _sx_w, and _sx_d methods. | |
261 | * | |
262 | * Note: Allocates the return buffer, must be freed by the caller. | |
263 | * | |
1da177e4 | 264 | ******************************************************************************/ |
15b8dd53 | 265 | |
1da177e4 | 266 | acpi_status |
15b8dd53 BM |
267 | acpi_get_object_info(acpi_handle handle, |
268 | struct acpi_device_info **return_buffer) | |
1da177e4 | 269 | { |
4be44fcd LB |
270 | struct acpi_namespace_node *node; |
271 | struct acpi_device_info *info; | |
78e25fef LZ |
272 | struct acpi_pnp_device_id_list *cid_list = NULL; |
273 | struct acpi_pnp_device_id *hid = NULL; | |
274 | struct acpi_pnp_device_id *uid = NULL; | |
15b8dd53 BM |
275 | char *next_id_string; |
276 | acpi_object_type type; | |
277 | acpi_name name; | |
278 | u8 param_count = 0; | |
279 | u8 valid = 0; | |
280 | u32 info_size; | |
281 | u32 i; | |
282 | acpi_status status; | |
1da177e4 LT |
283 | |
284 | /* Parameter validation */ | |
285 | ||
15b8dd53 | 286 | if (!handle || !return_buffer) { |
1da177e4 LT |
287 | return (AE_BAD_PARAMETER); |
288 | } | |
289 | ||
4be44fcd LB |
290 | status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE); |
291 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
292 | goto cleanup; |
293 | } | |
294 | ||
f24b664d | 295 | node = acpi_ns_validate_handle(handle); |
1da177e4 | 296 | if (!node) { |
4be44fcd | 297 | (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); |
15b8dd53 | 298 | return (AE_BAD_PARAMETER); |
1da177e4 LT |
299 | } |
300 | ||
15b8dd53 | 301 | /* Get the namespace node data while the namespace is locked */ |
1da177e4 | 302 | |
15b8dd53 BM |
303 | info_size = sizeof(struct acpi_device_info); |
304 | type = node->type; | |
305 | name = node->name.integer; | |
1da177e4 | 306 | |
0a1fbf2d | 307 | if (node->type == ACPI_TYPE_METHOD) { |
15b8dd53 | 308 | param_count = node->object->method.param_count; |
0a1fbf2d BM |
309 | } |
310 | ||
4be44fcd LB |
311 | status = acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); |
312 | if (ACPI_FAILURE(status)) { | |
15b8dd53 | 313 | return (status); |
1da177e4 LT |
314 | } |
315 | ||
15b8dd53 | 316 | if ((type == ACPI_TYPE_DEVICE) || (type == ACPI_TYPE_PROCESSOR)) { |
1da177e4 | 317 | /* |
15b8dd53 BM |
318 | * Get extra info for ACPI Device/Processor objects only: |
319 | * Run the Device _HID, _UID, and _CID methods. | |
1da177e4 LT |
320 | * |
321 | * Note: none of these methods are required, so they may or may | |
15b8dd53 BM |
322 | * not be present for this device. The Info->Valid bitfield is used |
323 | * to indicate which methods were found and run successfully. | |
1da177e4 LT |
324 | */ |
325 | ||
326 | /* Execute the Device._HID method */ | |
327 | ||
15b8dd53 | 328 | status = acpi_ut_execute_HID(node, &hid); |
4be44fcd | 329 | if (ACPI_SUCCESS(status)) { |
15b8dd53 BM |
330 | info_size += hid->length; |
331 | valid |= ACPI_VALID_HID; | |
1da177e4 LT |
332 | } |
333 | ||
334 | /* Execute the Device._UID method */ | |
335 | ||
15b8dd53 | 336 | status = acpi_ut_execute_UID(node, &uid); |
4be44fcd | 337 | if (ACPI_SUCCESS(status)) { |
15b8dd53 BM |
338 | info_size += uid->length; |
339 | valid |= ACPI_VALID_UID; | |
1da177e4 LT |
340 | } |
341 | ||
342 | /* Execute the Device._CID method */ | |
343 | ||
4be44fcd LB |
344 | status = acpi_ut_execute_CID(node, &cid_list); |
345 | if (ACPI_SUCCESS(status)) { | |
15b8dd53 BM |
346 | |
347 | /* Add size of CID strings and CID pointer array */ | |
348 | ||
349 | info_size += | |
350 | (cid_list->list_size - | |
78e25fef | 351 | sizeof(struct acpi_pnp_device_id_list)); |
15b8dd53 | 352 | valid |= ACPI_VALID_CID; |
1da177e4 | 353 | } |
15b8dd53 BM |
354 | } |
355 | ||
356 | /* | |
357 | * Now that we have the variable-length data, we can allocate the | |
358 | * return buffer | |
359 | */ | |
360 | info = ACPI_ALLOCATE_ZEROED(info_size); | |
361 | if (!info) { | |
362 | status = AE_NO_MEMORY; | |
363 | goto cleanup; | |
364 | } | |
365 | ||
366 | /* Get the fixed-length data */ | |
367 | ||
368 | if ((type == ACPI_TYPE_DEVICE) || (type == ACPI_TYPE_PROCESSOR)) { | |
369 | /* | |
370 | * Get extra info for ACPI Device/Processor objects only: | |
371 | * Run the _STA, _ADR and, sx_w, and _sx_d methods. | |
372 | * | |
373 | * Note: none of these methods are required, so they may or may | |
374 | * not be present for this device. The Info->Valid bitfield is used | |
375 | * to indicate which methods were found and run successfully. | |
376 | */ | |
1da177e4 LT |
377 | |
378 | /* Execute the Device._STA method */ | |
379 | ||
4be44fcd LB |
380 | status = acpi_ut_execute_STA(node, &info->current_status); |
381 | if (ACPI_SUCCESS(status)) { | |
15b8dd53 | 382 | valid |= ACPI_VALID_STA; |
1da177e4 LT |
383 | } |
384 | ||
385 | /* Execute the Device._ADR method */ | |
386 | ||
4be44fcd LB |
387 | status = acpi_ut_evaluate_numeric_object(METHOD_NAME__ADR, node, |
388 | &info->address); | |
389 | if (ACPI_SUCCESS(status)) { | |
15b8dd53 BM |
390 | valid |= ACPI_VALID_ADR; |
391 | } | |
392 | ||
393 | /* Execute the Device._sx_w methods */ | |
394 | ||
395 | status = acpi_ut_execute_power_methods(node, | |
396 | acpi_gbl_lowest_dstate_names, | |
397 | ACPI_NUM_sx_w_METHODS, | |
398 | info->lowest_dstates); | |
399 | if (ACPI_SUCCESS(status)) { | |
400 | valid |= ACPI_VALID_SXWS; | |
1da177e4 LT |
401 | } |
402 | ||
403 | /* Execute the Device._sx_d methods */ | |
404 | ||
15b8dd53 BM |
405 | status = acpi_ut_execute_power_methods(node, |
406 | acpi_gbl_highest_dstate_names, | |
407 | ACPI_NUM_sx_d_METHODS, | |
408 | info->highest_dstates); | |
4be44fcd | 409 | if (ACPI_SUCCESS(status)) { |
15b8dd53 | 410 | valid |= ACPI_VALID_SXDS; |
1da177e4 LT |
411 | } |
412 | } | |
413 | ||
15b8dd53 BM |
414 | /* |
415 | * Create a pointer to the string area of the return buffer. | |
416 | * Point to the end of the base struct acpi_device_info structure. | |
417 | */ | |
418 | next_id_string = ACPI_CAST_PTR(char, info->compatible_id_list.ids); | |
419 | if (cid_list) { | |
1da177e4 | 420 | |
78e25fef | 421 | /* Point past the CID PNP_DEVICE_ID array */ |
15b8dd53 BM |
422 | |
423 | next_id_string += | |
424 | ((acpi_size) cid_list->count * | |
78e25fef | 425 | sizeof(struct acpi_pnp_device_id)); |
1da177e4 LT |
426 | } |
427 | ||
15b8dd53 BM |
428 | /* |
429 | * Copy the HID, UID, and CIDs to the return buffer. The variable-length | |
430 | * strings are copied to the reserved area at the end of the buffer. | |
431 | * | |
432 | * For HID and CID, check if the ID is a PCI Root Bridge. | |
433 | */ | |
434 | if (hid) { | |
435 | next_id_string = acpi_ns_copy_device_id(&info->hardware_id, | |
436 | hid, next_id_string); | |
437 | ||
438 | if (acpi_ut_is_pci_root_bridge(hid->string)) { | |
439 | info->flags |= ACPI_PCI_ROOT_BRIDGE; | |
440 | } | |
441 | } | |
1da177e4 | 442 | |
15b8dd53 BM |
443 | if (uid) { |
444 | next_id_string = acpi_ns_copy_device_id(&info->unique_id, | |
445 | uid, next_id_string); | |
446 | } | |
1da177e4 LT |
447 | |
448 | if (cid_list) { | |
15b8dd53 BM |
449 | info->compatible_id_list.count = cid_list->count; |
450 | info->compatible_id_list.list_size = cid_list->list_size; | |
451 | ||
452 | /* Copy each CID */ | |
453 | ||
454 | for (i = 0; i < cid_list->count; i++) { | |
455 | next_id_string = | |
456 | acpi_ns_copy_device_id(&info->compatible_id_list. | |
457 | ids[i], &cid_list->ids[i], | |
458 | next_id_string); | |
459 | ||
460 | if (acpi_ut_is_pci_root_bridge(cid_list->ids[i].string)) { | |
461 | info->flags |= ACPI_PCI_ROOT_BRIDGE; | |
462 | } | |
463 | } | |
1da177e4 LT |
464 | } |
465 | ||
15b8dd53 BM |
466 | /* Copy the fixed-length data */ |
467 | ||
468 | info->info_size = info_size; | |
469 | info->type = type; | |
470 | info->name = name; | |
471 | info->param_count = param_count; | |
472 | info->valid = valid; | |
473 | ||
474 | *return_buffer = info; | |
475 | status = AE_OK; | |
476 | ||
4be44fcd | 477 | cleanup: |
15b8dd53 BM |
478 | if (hid) { |
479 | ACPI_FREE(hid); | |
480 | } | |
481 | if (uid) { | |
482 | ACPI_FREE(uid); | |
483 | } | |
1da177e4 | 484 | if (cid_list) { |
8313524a | 485 | ACPI_FREE(cid_list); |
1da177e4 LT |
486 | } |
487 | return (status); | |
488 | } | |
1da177e4 | 489 | |
8313524a | 490 | ACPI_EXPORT_SYMBOL(acpi_get_object_info) |
b2f7ddcf LM |
491 | |
492 | /****************************************************************************** | |
493 | * | |
494 | * FUNCTION: acpi_install_method | |
495 | * | |
ba494bee | 496 | * PARAMETERS: buffer - An ACPI table containing one control method |
b2f7ddcf LM |
497 | * |
498 | * RETURN: Status | |
499 | * | |
500 | * DESCRIPTION: Install a control method into the namespace. If the method | |
501 | * name already exists in the namespace, it is overwritten. The | |
502 | * input buffer must contain a valid DSDT or SSDT containing a | |
503 | * single control method. | |
504 | * | |
505 | ******************************************************************************/ | |
506 | acpi_status acpi_install_method(u8 *buffer) | |
507 | { | |
508 | struct acpi_table_header *table = | |
509 | ACPI_CAST_PTR(struct acpi_table_header, buffer); | |
510 | u8 *aml_buffer; | |
511 | u8 *aml_start; | |
512 | char *path; | |
513 | struct acpi_namespace_node *node; | |
514 | union acpi_operand_object *method_obj; | |
515 | struct acpi_parse_state parser_state; | |
516 | u32 aml_length; | |
517 | u16 opcode; | |
518 | u8 method_flags; | |
519 | acpi_status status; | |
520 | ||
521 | /* Parameter validation */ | |
522 | ||
523 | if (!buffer) { | |
524 | return AE_BAD_PARAMETER; | |
525 | } | |
526 | ||
527 | /* Table must be a DSDT or SSDT */ | |
528 | ||
529 | if (!ACPI_COMPARE_NAME(table->signature, ACPI_SIG_DSDT) && | |
530 | !ACPI_COMPARE_NAME(table->signature, ACPI_SIG_SSDT)) { | |
531 | return AE_BAD_HEADER; | |
532 | } | |
533 | ||
534 | /* First AML opcode in the table must be a control method */ | |
535 | ||
536 | parser_state.aml = buffer + sizeof(struct acpi_table_header); | |
537 | opcode = acpi_ps_peek_opcode(&parser_state); | |
538 | if (opcode != AML_METHOD_OP) { | |
539 | return AE_BAD_PARAMETER; | |
540 | } | |
541 | ||
542 | /* Extract method information from the raw AML */ | |
543 | ||
544 | parser_state.aml += acpi_ps_get_opcode_size(opcode); | |
545 | parser_state.pkg_end = acpi_ps_get_next_package_end(&parser_state); | |
546 | path = acpi_ps_get_next_namestring(&parser_state); | |
547 | method_flags = *parser_state.aml++; | |
548 | aml_start = parser_state.aml; | |
549 | aml_length = ACPI_PTR_DIFF(parser_state.pkg_end, aml_start); | |
550 | ||
551 | /* | |
552 | * Allocate resources up-front. We don't want to have to delete a new | |
553 | * node from the namespace if we cannot allocate memory. | |
554 | */ | |
555 | aml_buffer = ACPI_ALLOCATE(aml_length); | |
556 | if (!aml_buffer) { | |
557 | return AE_NO_MEMORY; | |
558 | } | |
559 | ||
560 | method_obj = acpi_ut_create_internal_object(ACPI_TYPE_METHOD); | |
561 | if (!method_obj) { | |
562 | ACPI_FREE(aml_buffer); | |
563 | return AE_NO_MEMORY; | |
564 | } | |
565 | ||
566 | /* Lock namespace for acpi_ns_lookup, we may be creating a new node */ | |
567 | ||
568 | status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE); | |
569 | if (ACPI_FAILURE(status)) { | |
570 | goto error_exit; | |
571 | } | |
572 | ||
573 | /* The lookup either returns an existing node or creates a new one */ | |
574 | ||
575 | status = | |
576 | acpi_ns_lookup(NULL, path, ACPI_TYPE_METHOD, ACPI_IMODE_LOAD_PASS1, | |
577 | ACPI_NS_DONT_OPEN_SCOPE | ACPI_NS_ERROR_IF_FOUND, | |
578 | NULL, &node); | |
579 | ||
580 | (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); | |
581 | ||
582 | if (ACPI_FAILURE(status)) { /* ns_lookup */ | |
583 | if (status != AE_ALREADY_EXISTS) { | |
584 | goto error_exit; | |
585 | } | |
586 | ||
587 | /* Node existed previously, make sure it is a method node */ | |
588 | ||
589 | if (node->type != ACPI_TYPE_METHOD) { | |
590 | status = AE_TYPE; | |
591 | goto error_exit; | |
592 | } | |
593 | } | |
594 | ||
595 | /* Copy the method AML to the local buffer */ | |
596 | ||
597 | ACPI_MEMCPY(aml_buffer, aml_start, aml_length); | |
598 | ||
599 | /* Initialize the method object with the new method's information */ | |
600 | ||
601 | method_obj->method.aml_start = aml_buffer; | |
602 | method_obj->method.aml_length = aml_length; | |
603 | ||
604 | method_obj->method.param_count = (u8) | |
605 | (method_flags & AML_METHOD_ARG_COUNT); | |
606 | ||
b2f7ddcf | 607 | if (method_flags & AML_METHOD_SERIALIZED) { |
26294842 LM |
608 | method_obj->method.info_flags = ACPI_METHOD_SERIALIZED; |
609 | ||
b2f7ddcf LM |
610 | method_obj->method.sync_level = (u8) |
611 | ((method_flags & AML_METHOD_SYNC_LEVEL) >> 4); | |
612 | } | |
613 | ||
614 | /* | |
615 | * Now that it is complete, we can attach the new method object to | |
616 | * the method Node (detaches/deletes any existing object) | |
617 | */ | |
618 | status = acpi_ns_attach_object(node, method_obj, ACPI_TYPE_METHOD); | |
619 | ||
620 | /* | |
621 | * Flag indicates AML buffer is dynamic, must be deleted later. | |
622 | * Must be set only after attach above. | |
623 | */ | |
624 | node->flags |= ANOBJ_ALLOCATED_BUFFER; | |
625 | ||
626 | /* Remove local reference to the method object */ | |
627 | ||
628 | acpi_ut_remove_reference(method_obj); | |
629 | return status; | |
630 | ||
631 | error_exit: | |
632 | ||
633 | ACPI_FREE(aml_buffer); | |
634 | ACPI_FREE(method_obj); | |
635 | return status; | |
636 | } | |
637 | ACPI_EXPORT_SYMBOL(acpi_install_method) |