Commit | Line | Data |
---|---|---|
95857638 | 1 | // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 |
1da177e4 LT |
2 | /******************************************************************************* |
3 | * | |
4 | * Module Name: rsxface - Public interfaces to the resource manager | |
5 | * | |
6 | ******************************************************************************/ | |
7 | ||
839e928f LZ |
8 | #define EXPORT_ACPI_INTERFACES |
9 | ||
1da177e4 | 10 | #include <acpi/acpi.h> |
e2f7a777 LB |
11 | #include "accommon.h" |
12 | #include "acresrc.h" | |
13 | #include "acnamesp.h" | |
1da177e4 LT |
14 | |
15 | #define _COMPONENT ACPI_RESOURCES | |
4be44fcd | 16 | ACPI_MODULE_NAME("rsxface") |
1da177e4 | 17 | |
44f6c012 | 18 | /* Local macros for 16,32-bit to 64-bit conversion */ |
44f6c012 | 19 | #define ACPI_COPY_FIELD(out, in, field) ((out)->field = (in)->field) |
1fad8738 | 20 | #define ACPI_COPY_ADDRESS(out, in) \ |
44f6c012 RM |
21 | ACPI_COPY_FIELD(out, in, resource_type); \ |
22 | ACPI_COPY_FIELD(out, in, producer_consumer); \ | |
23 | ACPI_COPY_FIELD(out, in, decode); \ | |
24 | ACPI_COPY_FIELD(out, in, min_address_fixed); \ | |
25 | ACPI_COPY_FIELD(out, in, max_address_fixed); \ | |
0897831b | 26 | ACPI_COPY_FIELD(out, in, info); \ |
a45de93e LZ |
27 | ACPI_COPY_FIELD(out, in, address.granularity); \ |
28 | ACPI_COPY_FIELD(out, in, address.minimum); \ | |
29 | ACPI_COPY_FIELD(out, in, address.maximum); \ | |
30 | ACPI_COPY_FIELD(out, in, address.translation_offset); \ | |
31 | ACPI_COPY_FIELD(out, in, address.address_length); \ | |
44f6c012 | 32 | ACPI_COPY_FIELD(out, in, resource_source); |
c51a4de8 BM |
33 | /* Local prototypes */ |
34 | static acpi_status | |
35 | acpi_rs_match_vendor_resource(struct acpi_resource *resource, void *context); | |
36 | ||
4119532c BM |
37 | static acpi_status |
38 | acpi_rs_validate_parameters(acpi_handle device_handle, | |
39 | struct acpi_buffer *buffer, | |
40 | struct acpi_namespace_node **return_node); | |
41 | ||
42 | /******************************************************************************* | |
43 | * | |
44 | * FUNCTION: acpi_rs_validate_parameters | |
45 | * | |
46 | * PARAMETERS: device_handle - Handle to a device | |
ba494bee | 47 | * buffer - Pointer to a data buffer |
4119532c BM |
48 | * return_node - Pointer to where the device node is returned |
49 | * | |
50 | * RETURN: Status | |
51 | * | |
52 | * DESCRIPTION: Common parameter validation for resource interfaces | |
53 | * | |
54 | ******************************************************************************/ | |
55 | ||
56 | static acpi_status | |
57 | acpi_rs_validate_parameters(acpi_handle device_handle, | |
58 | struct acpi_buffer *buffer, | |
59 | struct acpi_namespace_node **return_node) | |
60 | { | |
61 | acpi_status status; | |
62 | struct acpi_namespace_node *node; | |
63 | ||
64 | ACPI_FUNCTION_TRACE(rs_validate_parameters); | |
65 | ||
66 | /* | |
67 | * Must have a valid handle to an ACPI device | |
68 | */ | |
69 | if (!device_handle) { | |
70 | return_ACPI_STATUS(AE_BAD_PARAMETER); | |
71 | } | |
72 | ||
f24b664d | 73 | node = acpi_ns_validate_handle(device_handle); |
4119532c BM |
74 | if (!node) { |
75 | return_ACPI_STATUS(AE_BAD_PARAMETER); | |
76 | } | |
77 | ||
78 | if (node->type != ACPI_TYPE_DEVICE) { | |
79 | return_ACPI_STATUS(AE_TYPE); | |
80 | } | |
81 | ||
82 | /* | |
83 | * Validate the user buffer object | |
84 | * | |
85 | * if there is a non-zero buffer length we also need a valid pointer in | |
86 | * the buffer. If it's a zero buffer length, we'll be returning the | |
87 | * needed buffer size (later), so keep going. | |
88 | */ | |
89 | status = acpi_ut_validate_buffer(buffer); | |
90 | if (ACPI_FAILURE(status)) { | |
91 | return_ACPI_STATUS(status); | |
92 | } | |
93 | ||
94 | *return_node = node; | |
95 | return_ACPI_STATUS(AE_OK); | |
96 | } | |
97 | ||
1da177e4 LT |
98 | /******************************************************************************* |
99 | * | |
100 | * FUNCTION: acpi_get_irq_routing_table | |
101 | * | |
4119532c BM |
102 | * PARAMETERS: device_handle - Handle to the Bus device we are querying |
103 | * ret_buffer - Pointer to a buffer to receive the | |
1da177e4 LT |
104 | * current resources for the device |
105 | * | |
106 | * RETURN: Status | |
107 | * | |
108 | * DESCRIPTION: This function is called to get the IRQ routing table for a | |
4119532c BM |
109 | * specific bus. The caller must first acquire a handle for the |
110 | * desired bus. The routine table is placed in the buffer pointed | |
1da177e4 LT |
111 | * to by the ret_buffer variable parameter. |
112 | * | |
113 | * If the function fails an appropriate status will be returned | |
114 | * and the value of ret_buffer is undefined. | |
115 | * | |
116 | * This function attempts to execute the _PRT method contained in | |
117 | * the object indicated by the passed device_handle. | |
118 | * | |
119 | ******************************************************************************/ | |
c51a4de8 | 120 | |
1da177e4 | 121 | acpi_status |
4be44fcd LB |
122 | acpi_get_irq_routing_table(acpi_handle device_handle, |
123 | struct acpi_buffer *ret_buffer) | |
1da177e4 | 124 | { |
4be44fcd | 125 | acpi_status status; |
4119532c | 126 | struct acpi_namespace_node *node; |
1da177e4 | 127 | |
b229cf92 | 128 | ACPI_FUNCTION_TRACE(acpi_get_irq_routing_table); |
1da177e4 | 129 | |
4119532c | 130 | /* Validate parameters then dispatch to internal routine */ |
1da177e4 | 131 | |
4119532c | 132 | status = acpi_rs_validate_parameters(device_handle, ret_buffer, &node); |
4be44fcd LB |
133 | if (ACPI_FAILURE(status)) { |
134 | return_ACPI_STATUS(status); | |
1da177e4 LT |
135 | } |
136 | ||
4119532c | 137 | status = acpi_rs_get_prt_method_data(node, ret_buffer); |
4be44fcd | 138 | return_ACPI_STATUS(status); |
1da177e4 LT |
139 | } |
140 | ||
8313524a BM |
141 | ACPI_EXPORT_SYMBOL(acpi_get_irq_routing_table) |
142 | ||
1da177e4 LT |
143 | /******************************************************************************* |
144 | * | |
145 | * FUNCTION: acpi_get_current_resources | |
146 | * | |
4119532c | 147 | * PARAMETERS: device_handle - Handle to the device object for the |
1da177e4 | 148 | * device we are querying |
4119532c | 149 | * ret_buffer - Pointer to a buffer to receive the |
1da177e4 LT |
150 | * current resources for the device |
151 | * | |
152 | * RETURN: Status | |
153 | * | |
154 | * DESCRIPTION: This function is called to get the current resources for a | |
4119532c BM |
155 | * specific device. The caller must first acquire a handle for |
156 | * the desired device. The resource data is placed in the buffer | |
1da177e4 LT |
157 | * pointed to by the ret_buffer variable parameter. |
158 | * | |
159 | * If the function fails an appropriate status will be returned | |
160 | * and the value of ret_buffer is undefined. | |
161 | * | |
162 | * This function attempts to execute the _CRS method contained in | |
163 | * the object indicated by the passed device_handle. | |
164 | * | |
165 | ******************************************************************************/ | |
1da177e4 | 166 | acpi_status |
4be44fcd LB |
167 | acpi_get_current_resources(acpi_handle device_handle, |
168 | struct acpi_buffer *ret_buffer) | |
1da177e4 | 169 | { |
4be44fcd | 170 | acpi_status status; |
4119532c | 171 | struct acpi_namespace_node *node; |
1da177e4 | 172 | |
b229cf92 | 173 | ACPI_FUNCTION_TRACE(acpi_get_current_resources); |
1da177e4 | 174 | |
4119532c | 175 | /* Validate parameters then dispatch to internal routine */ |
1da177e4 | 176 | |
4119532c | 177 | status = acpi_rs_validate_parameters(device_handle, ret_buffer, &node); |
4be44fcd LB |
178 | if (ACPI_FAILURE(status)) { |
179 | return_ACPI_STATUS(status); | |
1da177e4 LT |
180 | } |
181 | ||
4119532c | 182 | status = acpi_rs_get_crs_method_data(node, ret_buffer); |
4be44fcd | 183 | return_ACPI_STATUS(status); |
1da177e4 | 184 | } |
1da177e4 | 185 | |
8313524a | 186 | ACPI_EXPORT_SYMBOL(acpi_get_current_resources) |
4d946f79 | 187 | |
1da177e4 LT |
188 | /******************************************************************************* |
189 | * | |
190 | * FUNCTION: acpi_get_possible_resources | |
191 | * | |
4119532c | 192 | * PARAMETERS: device_handle - Handle to the device object for the |
1da177e4 | 193 | * device we are querying |
4119532c | 194 | * ret_buffer - Pointer to a buffer to receive the |
1da177e4 LT |
195 | * resources for the device |
196 | * | |
197 | * RETURN: Status | |
198 | * | |
199 | * DESCRIPTION: This function is called to get a list of the possible resources | |
4119532c BM |
200 | * for a specific device. The caller must first acquire a handle |
201 | * for the desired device. The resource data is placed in the | |
1da177e4 LT |
202 | * buffer pointed to by the ret_buffer variable. |
203 | * | |
204 | * If the function fails an appropriate status will be returned | |
205 | * and the value of ret_buffer is undefined. | |
206 | * | |
207 | ******************************************************************************/ | |
1da177e4 | 208 | acpi_status |
4be44fcd LB |
209 | acpi_get_possible_resources(acpi_handle device_handle, |
210 | struct acpi_buffer *ret_buffer) | |
1da177e4 | 211 | { |
4be44fcd | 212 | acpi_status status; |
4119532c | 213 | struct acpi_namespace_node *node; |
1da177e4 | 214 | |
b229cf92 | 215 | ACPI_FUNCTION_TRACE(acpi_get_possible_resources); |
1da177e4 | 216 | |
4119532c | 217 | /* Validate parameters then dispatch to internal routine */ |
1da177e4 | 218 | |
4119532c | 219 | status = acpi_rs_validate_parameters(device_handle, ret_buffer, &node); |
4be44fcd LB |
220 | if (ACPI_FAILURE(status)) { |
221 | return_ACPI_STATUS(status); | |
1da177e4 LT |
222 | } |
223 | ||
4119532c | 224 | status = acpi_rs_get_prs_method_data(node, ret_buffer); |
4be44fcd | 225 | return_ACPI_STATUS(status); |
1da177e4 | 226 | } |
1da177e4 | 227 | |
8313524a | 228 | ACPI_EXPORT_SYMBOL(acpi_get_possible_resources) |
4d946f79 | 229 | |
1da177e4 LT |
230 | /******************************************************************************* |
231 | * | |
232 | * FUNCTION: acpi_set_current_resources | |
233 | * | |
4119532c BM |
234 | * PARAMETERS: device_handle - Handle to the device object for the |
235 | * device we are setting resources | |
236 | * in_buffer - Pointer to a buffer containing the | |
1da177e4 LT |
237 | * resources to be set for the device |
238 | * | |
239 | * RETURN: Status | |
240 | * | |
241 | * DESCRIPTION: This function is called to set the current resources for a | |
4119532c BM |
242 | * specific device. The caller must first acquire a handle for |
243 | * the desired device. The resource data is passed to the routine | |
1da177e4 LT |
244 | * the buffer pointed to by the in_buffer variable. |
245 | * | |
246 | ******************************************************************************/ | |
1da177e4 | 247 | acpi_status |
4be44fcd LB |
248 | acpi_set_current_resources(acpi_handle device_handle, |
249 | struct acpi_buffer *in_buffer) | |
1da177e4 | 250 | { |
4be44fcd | 251 | acpi_status status; |
4119532c | 252 | struct acpi_namespace_node *node; |
1da177e4 | 253 | |
b229cf92 | 254 | ACPI_FUNCTION_TRACE(acpi_set_current_resources); |
1da177e4 | 255 | |
4119532c | 256 | /* Validate the buffer, don't allow zero length */ |
44f6c012 | 257 | |
4119532c | 258 | if ((!in_buffer) || (!in_buffer->pointer) || (!in_buffer->length)) { |
4be44fcd | 259 | return_ACPI_STATUS(AE_BAD_PARAMETER); |
1da177e4 LT |
260 | } |
261 | ||
4119532c BM |
262 | /* Validate parameters then dispatch to internal routine */ |
263 | ||
264 | status = acpi_rs_validate_parameters(device_handle, in_buffer, &node); | |
265 | if (ACPI_FAILURE(status)) { | |
266 | return_ACPI_STATUS(status); | |
267 | } | |
268 | ||
269 | status = acpi_rs_set_srs_method_data(node, in_buffer); | |
4be44fcd | 270 | return_ACPI_STATUS(status); |
1da177e4 | 271 | } |
1da177e4 | 272 | |
8313524a | 273 | ACPI_EXPORT_SYMBOL(acpi_set_current_resources) |
1da177e4 | 274 | |
a91cdde2 BM |
275 | /******************************************************************************* |
276 | * | |
277 | * FUNCTION: acpi_get_event_resources | |
278 | * | |
279 | * PARAMETERS: device_handle - Handle to the device object for the | |
280 | * device we are getting resources | |
281 | * in_buffer - Pointer to a buffer containing the | |
282 | * resources to be set for the device | |
283 | * | |
284 | * RETURN: Status | |
285 | * | |
286 | * DESCRIPTION: This function is called to get the event resources for a | |
287 | * specific device. The caller must first acquire a handle for | |
288 | * the desired device. The resource data is passed to the routine | |
289 | * the buffer pointed to by the in_buffer variable. Uses the | |
290 | * _AEI method. | |
291 | * | |
292 | ******************************************************************************/ | |
293 | acpi_status | |
294 | acpi_get_event_resources(acpi_handle device_handle, | |
295 | struct acpi_buffer *ret_buffer) | |
296 | { | |
297 | acpi_status status; | |
298 | struct acpi_namespace_node *node; | |
299 | ||
300 | ACPI_FUNCTION_TRACE(acpi_get_event_resources); | |
301 | ||
302 | /* Validate parameters then dispatch to internal routine */ | |
303 | ||
304 | status = acpi_rs_validate_parameters(device_handle, ret_buffer, &node); | |
305 | if (ACPI_FAILURE(status)) { | |
306 | return_ACPI_STATUS(status); | |
307 | } | |
308 | ||
309 | status = acpi_rs_get_aei_method_data(node, ret_buffer); | |
310 | return_ACPI_STATUS(status); | |
311 | } | |
312 | ||
313 | ACPI_EXPORT_SYMBOL(acpi_get_event_resources) | |
314 | ||
1da177e4 LT |
315 | /****************************************************************************** |
316 | * | |
317 | * FUNCTION: acpi_resource_to_address64 | |
318 | * | |
ba494bee BM |
319 | * PARAMETERS: resource - Pointer to a resource |
320 | * out - Pointer to the users's return buffer | |
4119532c | 321 | * (a struct acpi_resource_address64) |
1da177e4 LT |
322 | * |
323 | * RETURN: Status | |
324 | * | |
325 | * DESCRIPTION: If the resource is an address16, address32, or address64, | |
4119532c | 326 | * copy it to the address64 return buffer. This saves the |
1da177e4 LT |
327 | * caller from having to duplicate code for different-sized |
328 | * addresses. | |
329 | * | |
330 | ******************************************************************************/ | |
1da177e4 | 331 | acpi_status |
4be44fcd LB |
332 | acpi_resource_to_address64(struct acpi_resource *resource, |
333 | struct acpi_resource_address64 *out) | |
1da177e4 | 334 | { |
4be44fcd LB |
335 | struct acpi_resource_address16 *address16; |
336 | struct acpi_resource_address32 *address32; | |
1da177e4 | 337 | |
c51a4de8 BM |
338 | if (!resource || !out) { |
339 | return (AE_BAD_PARAMETER); | |
340 | } | |
341 | ||
342 | /* Convert 16 or 32 address descriptor to 64 */ | |
343 | ||
bda663d3 | 344 | switch (resource->type) { |
50eca3eb | 345 | case ACPI_RESOURCE_TYPE_ADDRESS16: |
1da177e4 | 346 | |
ba9c3f55 BM |
347 | address16 = |
348 | ACPI_CAST_PTR(struct acpi_resource_address16, | |
349 | &resource->data); | |
4be44fcd | 350 | ACPI_COPY_ADDRESS(out, address16); |
1da177e4 LT |
351 | break; |
352 | ||
50eca3eb | 353 | case ACPI_RESOURCE_TYPE_ADDRESS32: |
1da177e4 | 354 | |
ba9c3f55 BM |
355 | address32 = |
356 | ACPI_CAST_PTR(struct acpi_resource_address32, | |
357 | &resource->data); | |
4be44fcd | 358 | ACPI_COPY_ADDRESS(out, address32); |
1da177e4 LT |
359 | break; |
360 | ||
50eca3eb | 361 | case ACPI_RESOURCE_TYPE_ADDRESS64: |
1da177e4 LT |
362 | |
363 | /* Simple copy for 64 bit source */ | |
364 | ||
4fa4616e BM |
365 | memcpy(out, &resource->data, |
366 | sizeof(struct acpi_resource_address64)); | |
1da177e4 LT |
367 | break; |
368 | ||
1da177e4 | 369 | default: |
1d1ea1b7 | 370 | |
1da177e4 LT |
371 | return (AE_BAD_PARAMETER); |
372 | } | |
373 | ||
374 | return (AE_OK); | |
375 | } | |
4be44fcd | 376 | |
8313524a | 377 | ACPI_EXPORT_SYMBOL(acpi_resource_to_address64) |
c51a4de8 BM |
378 | |
379 | /******************************************************************************* | |
380 | * | |
381 | * FUNCTION: acpi_get_vendor_resource | |
382 | * | |
4119532c | 383 | * PARAMETERS: device_handle - Handle for the parent device object |
ba494bee | 384 | * name - Method name for the parent resource |
4119532c | 385 | * (METHOD_NAME__CRS or METHOD_NAME__PRS) |
ba494bee | 386 | * uuid - Pointer to the UUID to be matched. |
4119532c BM |
387 | * includes both subtype and 16-byte UUID |
388 | * ret_buffer - Where the vendor resource is returned | |
c51a4de8 BM |
389 | * |
390 | * RETURN: Status | |
391 | * | |
afb1bbee | 392 | * DESCRIPTION: Walk a resource template for the specified device to find a |
c51a4de8 BM |
393 | * vendor-defined resource that matches the supplied UUID and |
394 | * UUID subtype. Returns a struct acpi_resource of type Vendor. | |
395 | * | |
396 | ******************************************************************************/ | |
c51a4de8 BM |
397 | acpi_status |
398 | acpi_get_vendor_resource(acpi_handle device_handle, | |
399 | char *name, | |
f5c1e1c5 LZ |
400 | struct acpi_vendor_uuid *uuid, |
401 | struct acpi_buffer *ret_buffer) | |
c51a4de8 BM |
402 | { |
403 | struct acpi_vendor_walk_info info; | |
404 | acpi_status status; | |
405 | ||
406 | /* Other parameters are validated by acpi_walk_resources */ | |
407 | ||
408 | if (!uuid || !ret_buffer) { | |
409 | return (AE_BAD_PARAMETER); | |
410 | } | |
411 | ||
412 | info.uuid = uuid; | |
413 | info.buffer = ret_buffer; | |
414 | info.status = AE_NOT_EXIST; | |
415 | ||
416 | /* Walk the _CRS or _PRS resource list for this device */ | |
417 | ||
418 | status = | |
419 | acpi_walk_resources(device_handle, name, | |
420 | acpi_rs_match_vendor_resource, &info); | |
421 | if (ACPI_FAILURE(status)) { | |
422 | return (status); | |
423 | } | |
424 | ||
425 | return (info.status); | |
426 | } | |
427 | ||
8313524a BM |
428 | ACPI_EXPORT_SYMBOL(acpi_get_vendor_resource) |
429 | ||
c51a4de8 BM |
430 | /******************************************************************************* |
431 | * | |
432 | * FUNCTION: acpi_rs_match_vendor_resource | |
433 | * | |
61686124 | 434 | * PARAMETERS: acpi_walk_resource_callback |
c51a4de8 BM |
435 | * |
436 | * RETURN: Status | |
437 | * | |
438 | * DESCRIPTION: Match a vendor resource via the ACPI 3.0 UUID | |
439 | * | |
440 | ******************************************************************************/ | |
c51a4de8 BM |
441 | static acpi_status |
442 | acpi_rs_match_vendor_resource(struct acpi_resource *resource, void *context) | |
443 | { | |
444 | struct acpi_vendor_walk_info *info = context; | |
445 | struct acpi_resource_vendor_typed *vendor; | |
446 | struct acpi_buffer *buffer; | |
447 | acpi_status status; | |
448 | ||
449 | /* Ignore all descriptors except Vendor */ | |
450 | ||
451 | if (resource->type != ACPI_RESOURCE_TYPE_VENDOR) { | |
452 | return (AE_OK); | |
453 | } | |
454 | ||
455 | vendor = &resource->data.vendor_typed; | |
456 | ||
457 | /* | |
458 | * For a valid match, these conditions must hold: | |
459 | * | |
460 | * 1) Length of descriptor data must be at least as long as a UUID struct | |
461 | * 2) The UUID subtypes must match | |
462 | * 3) The UUID data must match | |
463 | */ | |
464 | if ((vendor->byte_length < (ACPI_UUID_LENGTH + 1)) || | |
465 | (vendor->uuid_subtype != info->uuid->subtype) || | |
4fa4616e | 466 | (memcmp(vendor->uuid, info->uuid->data, ACPI_UUID_LENGTH))) { |
c51a4de8 BM |
467 | return (AE_OK); |
468 | } | |
469 | ||
470 | /* Validate/Allocate/Clear caller buffer */ | |
471 | ||
472 | buffer = info->buffer; | |
473 | status = acpi_ut_initialize_buffer(buffer, resource->length); | |
474 | if (ACPI_FAILURE(status)) { | |
475 | return (status); | |
476 | } | |
477 | ||
478 | /* Found the correct resource, copy and return it */ | |
479 | ||
4fa4616e | 480 | memcpy(buffer->pointer, resource, resource->length); |
c51a4de8 BM |
481 | buffer->length = resource->length; |
482 | ||
483 | /* Found the desired descriptor, terminate resource walk */ | |
484 | ||
485 | info->status = AE_OK; | |
486 | return (AE_CTRL_TERMINATE); | |
487 | } | |
8313524a | 488 | |
4119532c BM |
489 | /******************************************************************************* |
490 | * | |
afb1bbee | 491 | * FUNCTION: acpi_walk_resource_buffer |
4119532c | 492 | * |
afb1bbee BM |
493 | * PARAMETERS: buffer - Formatted buffer returned by one of the |
494 | * various Get*Resource functions | |
4119532c | 495 | * user_function - Called for each resource |
ba494bee | 496 | * context - Passed to user_function |
4119532c BM |
497 | * |
498 | * RETURN: Status | |
499 | * | |
afb1bbee BM |
500 | * DESCRIPTION: Walks the input resource template. The user_function is called |
501 | * once for each resource in the list. | |
4119532c BM |
502 | * |
503 | ******************************************************************************/ | |
afb1bbee | 504 | |
4119532c | 505 | acpi_status |
f5c1e1c5 | 506 | acpi_walk_resource_buffer(struct acpi_buffer *buffer, |
afb1bbee BM |
507 | acpi_walk_resource_callback user_function, |
508 | void *context) | |
4119532c | 509 | { |
afb1bbee | 510 | acpi_status status = AE_OK; |
4119532c BM |
511 | struct acpi_resource *resource; |
512 | struct acpi_resource *resource_end; | |
513 | ||
afb1bbee | 514 | ACPI_FUNCTION_TRACE(acpi_walk_resource_buffer); |
4119532c BM |
515 | |
516 | /* Parameter validation */ | |
517 | ||
afb1bbee | 518 | if (!buffer || !buffer->pointer || !user_function) { |
4119532c BM |
519 | return_ACPI_STATUS(AE_BAD_PARAMETER); |
520 | } | |
521 | ||
afb1bbee | 522 | /* Buffer contains the resource list and length */ |
4119532c | 523 | |
afb1bbee | 524 | resource = ACPI_CAST_PTR(struct acpi_resource, buffer->pointer); |
4119532c | 525 | resource_end = |
afb1bbee | 526 | ACPI_ADD_PTR(struct acpi_resource, buffer->pointer, buffer->length); |
4119532c BM |
527 | |
528 | /* Walk the resource list until the end_tag is found (or buffer end) */ | |
529 | ||
530 | while (resource < resource_end) { | |
531 | ||
c13085e5 | 532 | /* Sanity check the resource type */ |
4119532c BM |
533 | |
534 | if (resource->type > ACPI_RESOURCE_TYPE_MAX) { | |
535 | status = AE_AML_INVALID_RESOURCE_TYPE; | |
536 | break; | |
537 | } | |
538 | ||
c13085e5 BM |
539 | /* Sanity check the length. It must not be zero, or we loop forever */ |
540 | ||
541 | if (!resource->length) { | |
542 | return_ACPI_STATUS(AE_AML_BAD_RESOURCE_LENGTH); | |
543 | } | |
544 | ||
4119532c BM |
545 | /* Invoke the user function, abort on any error returned */ |
546 | ||
547 | status = user_function(resource, context); | |
548 | if (ACPI_FAILURE(status)) { | |
549 | if (status == AE_CTRL_TERMINATE) { | |
550 | ||
551 | /* This is an OK termination by the user function */ | |
552 | ||
553 | status = AE_OK; | |
554 | } | |
555 | break; | |
556 | } | |
557 | ||
558 | /* end_tag indicates end-of-list */ | |
559 | ||
560 | if (resource->type == ACPI_RESOURCE_TYPE_END_TAG) { | |
561 | break; | |
562 | } | |
563 | ||
564 | /* Get the next resource descriptor */ | |
565 | ||
fb4e5026 | 566 | resource = ACPI_NEXT_RESOURCE(resource); |
4119532c BM |
567 | } |
568 | ||
afb1bbee BM |
569 | return_ACPI_STATUS(status); |
570 | } | |
571 | ||
572 | ACPI_EXPORT_SYMBOL(acpi_walk_resource_buffer) | |
573 | ||
574 | /******************************************************************************* | |
575 | * | |
576 | * FUNCTION: acpi_walk_resources | |
577 | * | |
578 | * PARAMETERS: device_handle - Handle to the device object for the | |
579 | * device we are querying | |
580 | * name - Method name of the resources we want. | |
581 | * (METHOD_NAME__CRS, METHOD_NAME__PRS, or | |
137c7835 | 582 | * METHOD_NAME__AEI or METHOD_NAME__DMA) |
afb1bbee BM |
583 | * user_function - Called for each resource |
584 | * context - Passed to user_function | |
585 | * | |
586 | * RETURN: Status | |
587 | * | |
588 | * DESCRIPTION: Retrieves the current or possible resource list for the | |
589 | * specified device. The user_function is called once for | |
590 | * each resource in the list. | |
591 | * | |
592 | ******************************************************************************/ | |
593 | acpi_status | |
594 | acpi_walk_resources(acpi_handle device_handle, | |
595 | char *name, | |
596 | acpi_walk_resource_callback user_function, void *context) | |
597 | { | |
598 | acpi_status status; | |
599 | struct acpi_buffer buffer; | |
600 | ||
601 | ACPI_FUNCTION_TRACE(acpi_walk_resources); | |
602 | ||
603 | /* Parameter validation */ | |
604 | ||
605 | if (!device_handle || !user_function || !name || | |
5599fb69 BM |
606 | (!ACPI_COMPARE_NAMESEG(name, METHOD_NAME__CRS) && |
607 | !ACPI_COMPARE_NAMESEG(name, METHOD_NAME__PRS) && | |
608 | !ACPI_COMPARE_NAMESEG(name, METHOD_NAME__AEI) && | |
609 | !ACPI_COMPARE_NAMESEG(name, METHOD_NAME__DMA))) { | |
afb1bbee BM |
610 | return_ACPI_STATUS(AE_BAD_PARAMETER); |
611 | } | |
612 | ||
137c7835 | 613 | /* Get the _CRS/_PRS/_AEI/_DMA resource list */ |
afb1bbee BM |
614 | |
615 | buffer.length = ACPI_ALLOCATE_LOCAL_BUFFER; | |
616 | status = acpi_rs_get_method_data(device_handle, name, &buffer); | |
617 | if (ACPI_FAILURE(status)) { | |
618 | return_ACPI_STATUS(status); | |
619 | } | |
620 | ||
621 | /* Walk the resource list and cleanup */ | |
622 | ||
623 | status = acpi_walk_resource_buffer(&buffer, user_function, context); | |
4119532c BM |
624 | ACPI_FREE(buffer.pointer); |
625 | return_ACPI_STATUS(status); | |
626 | } | |
627 | ||
628 | ACPI_EXPORT_SYMBOL(acpi_walk_resources) |