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 | /* | |
25f044e6 | 9 | * Copyright (C) 2000 - 2013, 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 | */ | |
04a81dce | 110 | if (ACPI_IS_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; | |
bbe707ed | 161 | char *node_name; |
1da177e4 LT |
162 | |
163 | /* Parameter validation */ | |
164 | ||
165 | if (name_type > ACPI_NAME_TYPE_MAX) { | |
166 | return (AE_BAD_PARAMETER); | |
167 | } | |
168 | ||
4be44fcd LB |
169 | status = acpi_ut_validate_buffer(buffer); |
170 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
171 | return (status); |
172 | } | |
173 | ||
174 | if (name_type == ACPI_FULL_PATHNAME) { | |
52fc0b02 | 175 | |
1da177e4 LT |
176 | /* Get the full pathname (From the namespace root) */ |
177 | ||
4be44fcd | 178 | status = acpi_ns_handle_to_pathname(handle, buffer); |
1da177e4 LT |
179 | return (status); |
180 | } | |
181 | ||
182 | /* | |
183 | * Wants the single segment ACPI name. | |
184 | * Validate handle and convert to a namespace Node | |
185 | */ | |
4be44fcd LB |
186 | status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE); |
187 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
188 | return (status); |
189 | } | |
190 | ||
f24b664d | 191 | node = acpi_ns_validate_handle(handle); |
1da177e4 LT |
192 | if (!node) { |
193 | status = AE_BAD_PARAMETER; | |
194 | goto unlock_and_exit; | |
195 | } | |
196 | ||
197 | /* Validate/Allocate/Clear caller buffer */ | |
198 | ||
4be44fcd LB |
199 | status = acpi_ut_initialize_buffer(buffer, ACPI_PATH_SEGMENT_LENGTH); |
200 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
201 | goto unlock_and_exit; |
202 | } | |
203 | ||
204 | /* Just copy the ACPI name from the Node and zero terminate it */ | |
205 | ||
bbe707ed JK |
206 | node_name = acpi_ut_get_node_name(node); |
207 | ACPI_MOVE_NAME(buffer->pointer, node_name); | |
4be44fcd | 208 | ((char *)buffer->pointer)[ACPI_NAME_SIZE] = 0; |
1da177e4 LT |
209 | status = AE_OK; |
210 | ||
4be44fcd | 211 | unlock_and_exit: |
1da177e4 | 212 | |
4be44fcd | 213 | (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); |
1da177e4 LT |
214 | return (status); |
215 | } | |
1da177e4 | 216 | |
8313524a | 217 | ACPI_EXPORT_SYMBOL(acpi_get_name) |
1da177e4 | 218 | |
15b8dd53 BM |
219 | /****************************************************************************** |
220 | * | |
221 | * FUNCTION: acpi_ns_copy_device_id | |
222 | * | |
78e25fef LZ |
223 | * PARAMETERS: dest - Pointer to the destination PNP_DEVICE_ID |
224 | * source - Pointer to the source PNP_DEVICE_ID | |
15b8dd53 BM |
225 | * string_area - Pointer to where to copy the dest string |
226 | * | |
227 | * RETURN: Pointer to the next string area | |
228 | * | |
78e25fef | 229 | * DESCRIPTION: Copy a single PNP_DEVICE_ID, including the string data. |
15b8dd53 BM |
230 | * |
231 | ******************************************************************************/ | |
78e25fef LZ |
232 | static char *acpi_ns_copy_device_id(struct acpi_pnp_device_id *dest, |
233 | struct acpi_pnp_device_id *source, | |
15b8dd53 BM |
234 | char *string_area) |
235 | { | |
413fc3f5 | 236 | |
78e25fef | 237 | /* Create the destination PNP_DEVICE_ID */ |
15b8dd53 BM |
238 | |
239 | dest->string = string_area; | |
240 | dest->length = source->length; | |
241 | ||
242 | /* Copy actual string and return a pointer to the next string area */ | |
243 | ||
244 | ACPI_MEMCPY(string_area, source->string, source->length); | |
245 | return (string_area + source->length); | |
246 | } | |
247 | ||
1da177e4 LT |
248 | /****************************************************************************** |
249 | * | |
250 | * FUNCTION: acpi_get_object_info | |
251 | * | |
ba494bee | 252 | * PARAMETERS: handle - Object Handle |
15b8dd53 | 253 | * return_buffer - Where the info is returned |
1da177e4 LT |
254 | * |
255 | * RETURN: Status | |
256 | * | |
257 | * DESCRIPTION: Returns information about an object as gleaned from the | |
258 | * namespace node and possibly by running several standard | |
259 | * control methods (Such as in the case of a device.) | |
260 | * | |
413fc3f5 BM |
261 | * For Device and Processor objects, run the Device _HID, _UID, _CID, _SUB, |
262 | * _STA, _ADR, _sx_w, and _sx_d methods. | |
15b8dd53 BM |
263 | * |
264 | * Note: Allocates the return buffer, must be freed by the caller. | |
265 | * | |
1da177e4 | 266 | ******************************************************************************/ |
15b8dd53 | 267 | |
1da177e4 | 268 | acpi_status |
15b8dd53 BM |
269 | acpi_get_object_info(acpi_handle handle, |
270 | struct acpi_device_info **return_buffer) | |
1da177e4 | 271 | { |
4be44fcd LB |
272 | struct acpi_namespace_node *node; |
273 | struct acpi_device_info *info; | |
78e25fef LZ |
274 | struct acpi_pnp_device_id_list *cid_list = NULL; |
275 | struct acpi_pnp_device_id *hid = NULL; | |
276 | struct acpi_pnp_device_id *uid = NULL; | |
413fc3f5 | 277 | struct acpi_pnp_device_id *sub = NULL; |
15b8dd53 BM |
278 | char *next_id_string; |
279 | acpi_object_type type; | |
280 | acpi_name name; | |
281 | u8 param_count = 0; | |
282 | u8 valid = 0; | |
283 | u32 info_size; | |
284 | u32 i; | |
285 | acpi_status status; | |
1da177e4 LT |
286 | |
287 | /* Parameter validation */ | |
288 | ||
15b8dd53 | 289 | if (!handle || !return_buffer) { |
1da177e4 LT |
290 | return (AE_BAD_PARAMETER); |
291 | } | |
292 | ||
4be44fcd LB |
293 | status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE); |
294 | if (ACPI_FAILURE(status)) { | |
ef0b67fe | 295 | return (status); |
1da177e4 LT |
296 | } |
297 | ||
f24b664d | 298 | node = acpi_ns_validate_handle(handle); |
1da177e4 | 299 | if (!node) { |
4be44fcd | 300 | (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); |
15b8dd53 | 301 | return (AE_BAD_PARAMETER); |
1da177e4 LT |
302 | } |
303 | ||
15b8dd53 | 304 | /* Get the namespace node data while the namespace is locked */ |
1da177e4 | 305 | |
15b8dd53 BM |
306 | info_size = sizeof(struct acpi_device_info); |
307 | type = node->type; | |
308 | name = node->name.integer; | |
1da177e4 | 309 | |
0a1fbf2d | 310 | if (node->type == ACPI_TYPE_METHOD) { |
15b8dd53 | 311 | param_count = node->object->method.param_count; |
0a1fbf2d BM |
312 | } |
313 | ||
4be44fcd LB |
314 | status = acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); |
315 | if (ACPI_FAILURE(status)) { | |
15b8dd53 | 316 | return (status); |
1da177e4 LT |
317 | } |
318 | ||
15b8dd53 | 319 | if ((type == ACPI_TYPE_DEVICE) || (type == ACPI_TYPE_PROCESSOR)) { |
1da177e4 | 320 | /* |
15b8dd53 | 321 | * Get extra info for ACPI Device/Processor objects only: |
413fc3f5 | 322 | * Run the Device _HID, _UID, _SUB, and _CID methods. |
1da177e4 LT |
323 | * |
324 | * Note: none of these methods are required, so they may or may | |
15b8dd53 BM |
325 | * not be present for this device. The Info->Valid bitfield is used |
326 | * to indicate which methods were found and run successfully. | |
1da177e4 LT |
327 | */ |
328 | ||
329 | /* Execute the Device._HID method */ | |
330 | ||
15b8dd53 | 331 | status = acpi_ut_execute_HID(node, &hid); |
4be44fcd | 332 | if (ACPI_SUCCESS(status)) { |
15b8dd53 BM |
333 | info_size += hid->length; |
334 | valid |= ACPI_VALID_HID; | |
1da177e4 LT |
335 | } |
336 | ||
337 | /* Execute the Device._UID method */ | |
338 | ||
15b8dd53 | 339 | status = acpi_ut_execute_UID(node, &uid); |
4be44fcd | 340 | if (ACPI_SUCCESS(status)) { |
15b8dd53 BM |
341 | info_size += uid->length; |
342 | valid |= ACPI_VALID_UID; | |
1da177e4 LT |
343 | } |
344 | ||
413fc3f5 BM |
345 | /* Execute the Device._SUB method */ |
346 | ||
347 | status = acpi_ut_execute_SUB(node, &sub); | |
348 | if (ACPI_SUCCESS(status)) { | |
349 | info_size += sub->length; | |
350 | valid |= ACPI_VALID_SUB; | |
351 | } | |
352 | ||
1da177e4 LT |
353 | /* Execute the Device._CID method */ |
354 | ||
4be44fcd LB |
355 | status = acpi_ut_execute_CID(node, &cid_list); |
356 | if (ACPI_SUCCESS(status)) { | |
15b8dd53 BM |
357 | |
358 | /* Add size of CID strings and CID pointer array */ | |
359 | ||
360 | info_size += | |
361 | (cid_list->list_size - | |
78e25fef | 362 | sizeof(struct acpi_pnp_device_id_list)); |
15b8dd53 | 363 | valid |= ACPI_VALID_CID; |
1da177e4 | 364 | } |
15b8dd53 BM |
365 | } |
366 | ||
367 | /* | |
368 | * Now that we have the variable-length data, we can allocate the | |
369 | * return buffer | |
370 | */ | |
371 | info = ACPI_ALLOCATE_ZEROED(info_size); | |
372 | if (!info) { | |
373 | status = AE_NO_MEMORY; | |
374 | goto cleanup; | |
375 | } | |
376 | ||
377 | /* Get the fixed-length data */ | |
378 | ||
379 | if ((type == ACPI_TYPE_DEVICE) || (type == ACPI_TYPE_PROCESSOR)) { | |
380 | /* | |
381 | * Get extra info for ACPI Device/Processor objects only: | |
382 | * Run the _STA, _ADR and, sx_w, and _sx_d methods. | |
383 | * | |
a7d5caf6 | 384 | * Notes: none of these methods are required, so they may or may |
15b8dd53 BM |
385 | * not be present for this device. The Info->Valid bitfield is used |
386 | * to indicate which methods were found and run successfully. | |
a7d5caf6 BM |
387 | * |
388 | * For _STA, if the method does not exist, then (as per the ACPI | |
389 | * specification), the returned current_status flags will indicate | |
390 | * that the device is present/functional/enabled. Otherwise, the | |
391 | * current_status flags reflect the value returned from _STA. | |
15b8dd53 | 392 | */ |
1da177e4 LT |
393 | |
394 | /* Execute the Device._STA method */ | |
395 | ||
4be44fcd LB |
396 | status = acpi_ut_execute_STA(node, &info->current_status); |
397 | if (ACPI_SUCCESS(status)) { | |
15b8dd53 | 398 | valid |= ACPI_VALID_STA; |
1da177e4 LT |
399 | } |
400 | ||
401 | /* Execute the Device._ADR method */ | |
402 | ||
4be44fcd LB |
403 | status = acpi_ut_evaluate_numeric_object(METHOD_NAME__ADR, node, |
404 | &info->address); | |
405 | if (ACPI_SUCCESS(status)) { | |
15b8dd53 BM |
406 | valid |= ACPI_VALID_ADR; |
407 | } | |
408 | ||
409 | /* Execute the Device._sx_w methods */ | |
410 | ||
411 | status = acpi_ut_execute_power_methods(node, | |
412 | acpi_gbl_lowest_dstate_names, | |
413 | ACPI_NUM_sx_w_METHODS, | |
414 | info->lowest_dstates); | |
415 | if (ACPI_SUCCESS(status)) { | |
416 | valid |= ACPI_VALID_SXWS; | |
1da177e4 LT |
417 | } |
418 | ||
419 | /* Execute the Device._sx_d methods */ | |
420 | ||
15b8dd53 BM |
421 | status = acpi_ut_execute_power_methods(node, |
422 | acpi_gbl_highest_dstate_names, | |
423 | ACPI_NUM_sx_d_METHODS, | |
424 | info->highest_dstates); | |
4be44fcd | 425 | if (ACPI_SUCCESS(status)) { |
15b8dd53 | 426 | valid |= ACPI_VALID_SXDS; |
1da177e4 LT |
427 | } |
428 | } | |
429 | ||
15b8dd53 BM |
430 | /* |
431 | * Create a pointer to the string area of the return buffer. | |
432 | * Point to the end of the base struct acpi_device_info structure. | |
433 | */ | |
434 | next_id_string = ACPI_CAST_PTR(char, info->compatible_id_list.ids); | |
435 | if (cid_list) { | |
1da177e4 | 436 | |
78e25fef | 437 | /* Point past the CID PNP_DEVICE_ID array */ |
15b8dd53 BM |
438 | |
439 | next_id_string += | |
440 | ((acpi_size) cid_list->count * | |
78e25fef | 441 | sizeof(struct acpi_pnp_device_id)); |
1da177e4 LT |
442 | } |
443 | ||
15b8dd53 | 444 | /* |
413fc3f5 BM |
445 | * Copy the HID, UID, SUB, and CIDs to the return buffer. |
446 | * The variable-length strings are copied to the reserved area | |
447 | * at the end of the buffer. | |
15b8dd53 BM |
448 | * |
449 | * For HID and CID, check if the ID is a PCI Root Bridge. | |
450 | */ | |
451 | if (hid) { | |
452 | next_id_string = acpi_ns_copy_device_id(&info->hardware_id, | |
453 | hid, next_id_string); | |
454 | ||
455 | if (acpi_ut_is_pci_root_bridge(hid->string)) { | |
456 | info->flags |= ACPI_PCI_ROOT_BRIDGE; | |
457 | } | |
458 | } | |
1da177e4 | 459 | |
15b8dd53 BM |
460 | if (uid) { |
461 | next_id_string = acpi_ns_copy_device_id(&info->unique_id, | |
462 | uid, next_id_string); | |
463 | } | |
1da177e4 | 464 | |
413fc3f5 BM |
465 | if (sub) { |
466 | next_id_string = acpi_ns_copy_device_id(&info->subsystem_id, | |
467 | sub, next_id_string); | |
468 | } | |
469 | ||
1da177e4 | 470 | if (cid_list) { |
15b8dd53 BM |
471 | info->compatible_id_list.count = cid_list->count; |
472 | info->compatible_id_list.list_size = cid_list->list_size; | |
473 | ||
474 | /* Copy each CID */ | |
475 | ||
476 | for (i = 0; i < cid_list->count; i++) { | |
477 | next_id_string = | |
478 | acpi_ns_copy_device_id(&info->compatible_id_list. | |
479 | ids[i], &cid_list->ids[i], | |
480 | next_id_string); | |
481 | ||
482 | if (acpi_ut_is_pci_root_bridge(cid_list->ids[i].string)) { | |
483 | info->flags |= ACPI_PCI_ROOT_BRIDGE; | |
484 | } | |
485 | } | |
1da177e4 LT |
486 | } |
487 | ||
15b8dd53 BM |
488 | /* Copy the fixed-length data */ |
489 | ||
490 | info->info_size = info_size; | |
491 | info->type = type; | |
492 | info->name = name; | |
493 | info->param_count = param_count; | |
494 | info->valid = valid; | |
495 | ||
496 | *return_buffer = info; | |
497 | status = AE_OK; | |
498 | ||
4be44fcd | 499 | cleanup: |
15b8dd53 BM |
500 | if (hid) { |
501 | ACPI_FREE(hid); | |
502 | } | |
503 | if (uid) { | |
504 | ACPI_FREE(uid); | |
505 | } | |
413fc3f5 BM |
506 | if (sub) { |
507 | ACPI_FREE(sub); | |
508 | } | |
1da177e4 | 509 | if (cid_list) { |
8313524a | 510 | ACPI_FREE(cid_list); |
1da177e4 LT |
511 | } |
512 | return (status); | |
513 | } | |
1da177e4 | 514 | |
8313524a | 515 | ACPI_EXPORT_SYMBOL(acpi_get_object_info) |
b2f7ddcf LM |
516 | |
517 | /****************************************************************************** | |
518 | * | |
519 | * FUNCTION: acpi_install_method | |
520 | * | |
ba494bee | 521 | * PARAMETERS: buffer - An ACPI table containing one control method |
b2f7ddcf LM |
522 | * |
523 | * RETURN: Status | |
524 | * | |
525 | * DESCRIPTION: Install a control method into the namespace. If the method | |
526 | * name already exists in the namespace, it is overwritten. The | |
527 | * input buffer must contain a valid DSDT or SSDT containing a | |
528 | * single control method. | |
529 | * | |
530 | ******************************************************************************/ | |
531 | acpi_status acpi_install_method(u8 *buffer) | |
532 | { | |
533 | struct acpi_table_header *table = | |
534 | ACPI_CAST_PTR(struct acpi_table_header, buffer); | |
535 | u8 *aml_buffer; | |
536 | u8 *aml_start; | |
537 | char *path; | |
538 | struct acpi_namespace_node *node; | |
539 | union acpi_operand_object *method_obj; | |
540 | struct acpi_parse_state parser_state; | |
541 | u32 aml_length; | |
542 | u16 opcode; | |
543 | u8 method_flags; | |
544 | acpi_status status; | |
545 | ||
546 | /* Parameter validation */ | |
547 | ||
548 | if (!buffer) { | |
9c0d7939 | 549 | return (AE_BAD_PARAMETER); |
b2f7ddcf LM |
550 | } |
551 | ||
552 | /* Table must be a DSDT or SSDT */ | |
553 | ||
554 | if (!ACPI_COMPARE_NAME(table->signature, ACPI_SIG_DSDT) && | |
555 | !ACPI_COMPARE_NAME(table->signature, ACPI_SIG_SSDT)) { | |
9c0d7939 | 556 | return (AE_BAD_HEADER); |
b2f7ddcf LM |
557 | } |
558 | ||
559 | /* First AML opcode in the table must be a control method */ | |
560 | ||
561 | parser_state.aml = buffer + sizeof(struct acpi_table_header); | |
562 | opcode = acpi_ps_peek_opcode(&parser_state); | |
563 | if (opcode != AML_METHOD_OP) { | |
9c0d7939 | 564 | return (AE_BAD_PARAMETER); |
b2f7ddcf LM |
565 | } |
566 | ||
567 | /* Extract method information from the raw AML */ | |
568 | ||
569 | parser_state.aml += acpi_ps_get_opcode_size(opcode); | |
570 | parser_state.pkg_end = acpi_ps_get_next_package_end(&parser_state); | |
571 | path = acpi_ps_get_next_namestring(&parser_state); | |
572 | method_flags = *parser_state.aml++; | |
573 | aml_start = parser_state.aml; | |
574 | aml_length = ACPI_PTR_DIFF(parser_state.pkg_end, aml_start); | |
575 | ||
576 | /* | |
577 | * Allocate resources up-front. We don't want to have to delete a new | |
578 | * node from the namespace if we cannot allocate memory. | |
579 | */ | |
580 | aml_buffer = ACPI_ALLOCATE(aml_length); | |
581 | if (!aml_buffer) { | |
9c0d7939 | 582 | return (AE_NO_MEMORY); |
b2f7ddcf LM |
583 | } |
584 | ||
585 | method_obj = acpi_ut_create_internal_object(ACPI_TYPE_METHOD); | |
586 | if (!method_obj) { | |
587 | ACPI_FREE(aml_buffer); | |
9c0d7939 | 588 | return (AE_NO_MEMORY); |
b2f7ddcf LM |
589 | } |
590 | ||
591 | /* Lock namespace for acpi_ns_lookup, we may be creating a new node */ | |
592 | ||
593 | status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE); | |
594 | if (ACPI_FAILURE(status)) { | |
595 | goto error_exit; | |
596 | } | |
597 | ||
598 | /* The lookup either returns an existing node or creates a new one */ | |
599 | ||
600 | status = | |
601 | acpi_ns_lookup(NULL, path, ACPI_TYPE_METHOD, ACPI_IMODE_LOAD_PASS1, | |
602 | ACPI_NS_DONT_OPEN_SCOPE | ACPI_NS_ERROR_IF_FOUND, | |
603 | NULL, &node); | |
604 | ||
605 | (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE); | |
606 | ||
607 | if (ACPI_FAILURE(status)) { /* ns_lookup */ | |
608 | if (status != AE_ALREADY_EXISTS) { | |
609 | goto error_exit; | |
610 | } | |
611 | ||
612 | /* Node existed previously, make sure it is a method node */ | |
613 | ||
614 | if (node->type != ACPI_TYPE_METHOD) { | |
615 | status = AE_TYPE; | |
616 | goto error_exit; | |
617 | } | |
618 | } | |
619 | ||
620 | /* Copy the method AML to the local buffer */ | |
621 | ||
622 | ACPI_MEMCPY(aml_buffer, aml_start, aml_length); | |
623 | ||
624 | /* Initialize the method object with the new method's information */ | |
625 | ||
626 | method_obj->method.aml_start = aml_buffer; | |
627 | method_obj->method.aml_length = aml_length; | |
628 | ||
629 | method_obj->method.param_count = (u8) | |
630 | (method_flags & AML_METHOD_ARG_COUNT); | |
631 | ||
b2f7ddcf | 632 | if (method_flags & AML_METHOD_SERIALIZED) { |
26294842 LM |
633 | method_obj->method.info_flags = ACPI_METHOD_SERIALIZED; |
634 | ||
b2f7ddcf LM |
635 | method_obj->method.sync_level = (u8) |
636 | ((method_flags & AML_METHOD_SYNC_LEVEL) >> 4); | |
637 | } | |
638 | ||
639 | /* | |
640 | * Now that it is complete, we can attach the new method object to | |
641 | * the method Node (detaches/deletes any existing object) | |
642 | */ | |
643 | status = acpi_ns_attach_object(node, method_obj, ACPI_TYPE_METHOD); | |
644 | ||
645 | /* | |
646 | * Flag indicates AML buffer is dynamic, must be deleted later. | |
647 | * Must be set only after attach above. | |
648 | */ | |
649 | node->flags |= ANOBJ_ALLOCATED_BUFFER; | |
650 | ||
651 | /* Remove local reference to the method object */ | |
652 | ||
653 | acpi_ut_remove_reference(method_obj); | |
9c0d7939 | 654 | return (status); |
b2f7ddcf LM |
655 | |
656 | error_exit: | |
657 | ||
658 | ACPI_FREE(aml_buffer); | |
659 | ACPI_FREE(method_obj); | |
9c0d7939 | 660 | return (status); |
b2f7ddcf LM |
661 | } |
662 | ACPI_EXPORT_SYMBOL(acpi_install_method) |