Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /******************************************************************************* |
2 | * | |
3 | * Module Name: utmisc - common utility procedures | |
4 | * | |
5 | ******************************************************************************/ | |
6 | ||
7 | /* | |
8 | * Copyright (C) 2000 - 2005, R. Byron Moore | |
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/acnamesp.h> | |
46 | ||
1da177e4 | 47 | #define _COMPONENT ACPI_UTILITIES |
4be44fcd | 48 | ACPI_MODULE_NAME("utmisc") |
44f6c012 | 49 | |
f9f4601f RM |
50 | /******************************************************************************* |
51 | * | |
52 | * FUNCTION: acpi_ut_allocate_owner_id | |
53 | * | |
54 | * PARAMETERS: owner_id - Where the new owner ID is returned | |
55 | * | |
0c9938cc RM |
56 | * RETURN: Status |
57 | * | |
58 | * DESCRIPTION: Allocate a table or method owner ID. The owner ID is used to | |
59 | * track objects created by the table or method, to be deleted | |
60 | * when the method exits or the table is unloaded. | |
f9f4601f RM |
61 | * |
62 | ******************************************************************************/ | |
4be44fcd | 63 | acpi_status acpi_ut_allocate_owner_id(acpi_owner_id * owner_id) |
f9f4601f | 64 | { |
4be44fcd LB |
65 | acpi_native_uint i; |
66 | acpi_status status; | |
f9f4601f | 67 | |
4be44fcd | 68 | ACPI_FUNCTION_TRACE("ut_allocate_owner_id"); |
f9f4601f | 69 | |
0c9938cc RM |
70 | /* Mutex for the global ID mask */ |
71 | ||
4be44fcd LB |
72 | status = acpi_ut_acquire_mutex(ACPI_MTX_CACHES); |
73 | if (ACPI_FAILURE(status)) { | |
74 | return_ACPI_STATUS(status); | |
f9f4601f RM |
75 | } |
76 | ||
77 | /* Find a free owner ID */ | |
78 | ||
79 | for (i = 0; i < 32; i++) { | |
80 | if (!(acpi_gbl_owner_id_mask & (1 << i))) { | |
81 | acpi_gbl_owner_id_mask |= (1 << i); | |
0c9938cc | 82 | *owner_id = (acpi_owner_id) (i + 1); |
f9f4601f RM |
83 | goto exit; |
84 | } | |
85 | } | |
86 | ||
87 | /* | |
88 | * If we are here, all owner_ids have been allocated. This probably should | |
89 | * not happen since the IDs are reused after deallocation. The IDs are | |
90 | * allocated upon table load (one per table) and method execution, and | |
91 | * they are released when a table is unloaded or a method completes | |
92 | * execution. | |
93 | */ | |
0c9938cc | 94 | *owner_id = 0; |
f9f4601f | 95 | status = AE_OWNER_ID_LIMIT; |
4be44fcd | 96 | ACPI_REPORT_ERROR(("Could not allocate new owner_id (32 max), AE_OWNER_ID_LIMIT\n")); |
f9f4601f | 97 | |
4be44fcd LB |
98 | exit: |
99 | (void)acpi_ut_release_mutex(ACPI_MTX_CACHES); | |
100 | return_ACPI_STATUS(status); | |
f9f4601f RM |
101 | } |
102 | ||
f9f4601f RM |
103 | /******************************************************************************* |
104 | * | |
105 | * FUNCTION: acpi_ut_release_owner_id | |
106 | * | |
0c9938cc | 107 | * PARAMETERS: owner_id_ptr - Pointer to a previously allocated owner_iD |
f9f4601f | 108 | * |
0c9938cc RM |
109 | * RETURN: None. No error is returned because we are either exiting a |
110 | * control method or unloading a table. Either way, we would | |
111 | * ignore any error anyway. | |
112 | * | |
113 | * DESCRIPTION: Release a table or method owner ID. Valid IDs are 1 - 32 | |
f9f4601f RM |
114 | * |
115 | ******************************************************************************/ | |
116 | ||
4be44fcd | 117 | void acpi_ut_release_owner_id(acpi_owner_id * owner_id_ptr) |
f9f4601f | 118 | { |
4be44fcd LB |
119 | acpi_owner_id owner_id = *owner_id_ptr; |
120 | acpi_status status; | |
f9f4601f | 121 | |
4be44fcd | 122 | ACPI_FUNCTION_TRACE("ut_release_owner_id"); |
f9f4601f | 123 | |
0c9938cc RM |
124 | /* Always clear the input owner_id (zero is an invalid ID) */ |
125 | ||
126 | *owner_id_ptr = 0; | |
127 | ||
128 | /* Zero is not a valid owner_iD */ | |
129 | ||
130 | if ((owner_id == 0) || (owner_id > 32)) { | |
4be44fcd | 131 | ACPI_REPORT_ERROR(("Invalid owner_id: %2.2X\n", owner_id)); |
0c9938cc RM |
132 | return_VOID; |
133 | } | |
134 | ||
135 | /* Mutex for the global ID mask */ | |
136 | ||
4be44fcd LB |
137 | status = acpi_ut_acquire_mutex(ACPI_MTX_CACHES); |
138 | if (ACPI_FAILURE(status)) { | |
0c9938cc | 139 | return_VOID; |
f9f4601f RM |
140 | } |
141 | ||
4be44fcd | 142 | owner_id--; /* Normalize to zero */ |
0c9938cc RM |
143 | |
144 | /* Free the owner ID only if it is valid */ | |
f9f4601f RM |
145 | |
146 | if (acpi_gbl_owner_id_mask & (1 << owner_id)) { | |
147 | acpi_gbl_owner_id_mask ^= (1 << owner_id); | |
148 | } | |
f9f4601f | 149 | |
4be44fcd | 150 | (void)acpi_ut_release_mutex(ACPI_MTX_CACHES); |
0c9938cc | 151 | return_VOID; |
f9f4601f RM |
152 | } |
153 | ||
44f6c012 RM |
154 | /******************************************************************************* |
155 | * | |
156 | * FUNCTION: acpi_ut_strupr (strupr) | |
157 | * | |
158 | * PARAMETERS: src_string - The source string to convert | |
159 | * | |
0c9938cc | 160 | * RETURN: None |
44f6c012 RM |
161 | * |
162 | * DESCRIPTION: Convert string to uppercase | |
163 | * | |
164 | * NOTE: This is not a POSIX function, so it appears here, not in utclib.c | |
165 | * | |
166 | ******************************************************************************/ | |
167 | ||
4be44fcd | 168 | void acpi_ut_strupr(char *src_string) |
44f6c012 | 169 | { |
4be44fcd | 170 | char *string; |
44f6c012 | 171 | |
4be44fcd | 172 | ACPI_FUNCTION_ENTRY(); |
44f6c012 | 173 | |
73459f73 | 174 | if (!src_string) { |
0c9938cc | 175 | return; |
73459f73 RM |
176 | } |
177 | ||
44f6c012 RM |
178 | /* Walk entire string, uppercasing the letters */ |
179 | ||
180 | for (string = src_string; *string; string++) { | |
4be44fcd | 181 | *string = (char)ACPI_TOUPPER(*string); |
44f6c012 RM |
182 | } |
183 | ||
0c9938cc | 184 | return; |
44f6c012 RM |
185 | } |
186 | ||
1da177e4 LT |
187 | /******************************************************************************* |
188 | * | |
189 | * FUNCTION: acpi_ut_print_string | |
190 | * | |
191 | * PARAMETERS: String - Null terminated ASCII string | |
44f6c012 | 192 | * max_length - Maximum output length |
1da177e4 LT |
193 | * |
194 | * RETURN: None | |
195 | * | |
196 | * DESCRIPTION: Dump an ASCII string with support for ACPI-defined escape | |
197 | * sequences. | |
198 | * | |
199 | ******************************************************************************/ | |
200 | ||
4be44fcd | 201 | void acpi_ut_print_string(char *string, u8 max_length) |
1da177e4 | 202 | { |
4be44fcd | 203 | u32 i; |
1da177e4 LT |
204 | |
205 | if (!string) { | |
4be44fcd | 206 | acpi_os_printf("<\"NULL STRING PTR\">"); |
1da177e4 LT |
207 | return; |
208 | } | |
209 | ||
4be44fcd | 210 | acpi_os_printf("\""); |
1da177e4 LT |
211 | for (i = 0; string[i] && (i < max_length); i++) { |
212 | /* Escape sequences */ | |
213 | ||
214 | switch (string[i]) { | |
215 | case 0x07: | |
4be44fcd | 216 | acpi_os_printf("\\a"); /* BELL */ |
1da177e4 LT |
217 | break; |
218 | ||
219 | case 0x08: | |
4be44fcd | 220 | acpi_os_printf("\\b"); /* BACKSPACE */ |
1da177e4 LT |
221 | break; |
222 | ||
223 | case 0x0C: | |
4be44fcd | 224 | acpi_os_printf("\\f"); /* FORMFEED */ |
1da177e4 LT |
225 | break; |
226 | ||
227 | case 0x0A: | |
4be44fcd | 228 | acpi_os_printf("\\n"); /* LINEFEED */ |
1da177e4 LT |
229 | break; |
230 | ||
231 | case 0x0D: | |
4be44fcd | 232 | acpi_os_printf("\\r"); /* CARRIAGE RETURN */ |
1da177e4 LT |
233 | break; |
234 | ||
235 | case 0x09: | |
4be44fcd | 236 | acpi_os_printf("\\t"); /* HORIZONTAL TAB */ |
1da177e4 LT |
237 | break; |
238 | ||
239 | case 0x0B: | |
4be44fcd | 240 | acpi_os_printf("\\v"); /* VERTICAL TAB */ |
1da177e4 LT |
241 | break; |
242 | ||
4be44fcd LB |
243 | case '\'': /* Single Quote */ |
244 | case '\"': /* Double Quote */ | |
245 | case '\\': /* Backslash */ | |
246 | acpi_os_printf("\\%c", (int)string[i]); | |
1da177e4 LT |
247 | break; |
248 | ||
249 | default: | |
250 | ||
251 | /* Check for printable character or hex escape */ | |
252 | ||
4be44fcd | 253 | if (ACPI_IS_PRINT(string[i])) { |
1da177e4 LT |
254 | /* This is a normal character */ |
255 | ||
4be44fcd LB |
256 | acpi_os_printf("%c", (int)string[i]); |
257 | } else { | |
1da177e4 LT |
258 | /* All others will be Hex escapes */ |
259 | ||
4be44fcd | 260 | acpi_os_printf("\\x%2.2X", (s32) string[i]); |
1da177e4 LT |
261 | } |
262 | break; | |
263 | } | |
264 | } | |
4be44fcd | 265 | acpi_os_printf("\""); |
1da177e4 LT |
266 | |
267 | if (i == max_length && string[i]) { | |
4be44fcd | 268 | acpi_os_printf("..."); |
1da177e4 LT |
269 | } |
270 | } | |
271 | ||
1da177e4 LT |
272 | /******************************************************************************* |
273 | * | |
274 | * FUNCTION: acpi_ut_dword_byte_swap | |
275 | * | |
276 | * PARAMETERS: Value - Value to be converted | |
277 | * | |
44f6c012 RM |
278 | * RETURN: u32 integer with bytes swapped |
279 | * | |
1da177e4 LT |
280 | * DESCRIPTION: Convert a 32-bit value to big-endian (swap the bytes) |
281 | * | |
282 | ******************************************************************************/ | |
283 | ||
4be44fcd | 284 | u32 acpi_ut_dword_byte_swap(u32 value) |
1da177e4 LT |
285 | { |
286 | union { | |
4be44fcd LB |
287 | u32 value; |
288 | u8 bytes[4]; | |
1da177e4 | 289 | } out; |
1da177e4 | 290 | union { |
4be44fcd LB |
291 | u32 value; |
292 | u8 bytes[4]; | |
1da177e4 LT |
293 | } in; |
294 | ||
4be44fcd | 295 | ACPI_FUNCTION_ENTRY(); |
1da177e4 LT |
296 | |
297 | in.value = value; | |
298 | ||
299 | out.bytes[0] = in.bytes[3]; | |
300 | out.bytes[1] = in.bytes[2]; | |
301 | out.bytes[2] = in.bytes[1]; | |
302 | out.bytes[3] = in.bytes[0]; | |
303 | ||
304 | return (out.value); | |
305 | } | |
306 | ||
1da177e4 LT |
307 | /******************************************************************************* |
308 | * | |
309 | * FUNCTION: acpi_ut_set_integer_width | |
310 | * | |
311 | * PARAMETERS: Revision From DSDT header | |
312 | * | |
313 | * RETURN: None | |
314 | * | |
315 | * DESCRIPTION: Set the global integer bit width based upon the revision | |
316 | * of the DSDT. For Revision 1 and 0, Integers are 32 bits. | |
317 | * For Revision 2 and above, Integers are 64 bits. Yes, this | |
318 | * makes a difference. | |
319 | * | |
320 | ******************************************************************************/ | |
321 | ||
4be44fcd | 322 | void acpi_ut_set_integer_width(u8 revision) |
1da177e4 LT |
323 | { |
324 | ||
325 | if (revision <= 1) { | |
326 | acpi_gbl_integer_bit_width = 32; | |
327 | acpi_gbl_integer_nybble_width = 8; | |
328 | acpi_gbl_integer_byte_width = 4; | |
4be44fcd | 329 | } else { |
1da177e4 LT |
330 | acpi_gbl_integer_bit_width = 64; |
331 | acpi_gbl_integer_nybble_width = 16; | |
332 | acpi_gbl_integer_byte_width = 8; | |
333 | } | |
334 | } | |
335 | ||
1da177e4 LT |
336 | #ifdef ACPI_DEBUG_OUTPUT |
337 | /******************************************************************************* | |
338 | * | |
339 | * FUNCTION: acpi_ut_display_init_pathname | |
340 | * | |
44f6c012 RM |
341 | * PARAMETERS: Type - Object type of the node |
342 | * obj_handle - Handle whose pathname will be displayed | |
1da177e4 LT |
343 | * Path - Additional path string to be appended. |
344 | * (NULL if no extra path) | |
345 | * | |
346 | * RETURN: acpi_status | |
347 | * | |
348 | * DESCRIPTION: Display full pathname of an object, DEBUG ONLY | |
349 | * | |
350 | ******************************************************************************/ | |
351 | ||
352 | void | |
4be44fcd LB |
353 | acpi_ut_display_init_pathname(u8 type, |
354 | struct acpi_namespace_node *obj_handle, | |
355 | char *path) | |
1da177e4 | 356 | { |
4be44fcd LB |
357 | acpi_status status; |
358 | struct acpi_buffer buffer; | |
1da177e4 | 359 | |
4be44fcd | 360 | ACPI_FUNCTION_ENTRY(); |
1da177e4 LT |
361 | |
362 | /* Only print the path if the appropriate debug level is enabled */ | |
363 | ||
364 | if (!(acpi_dbg_level & ACPI_LV_INIT_NAMES)) { | |
365 | return; | |
366 | } | |
367 | ||
368 | /* Get the full pathname to the node */ | |
369 | ||
370 | buffer.length = ACPI_ALLOCATE_LOCAL_BUFFER; | |
4be44fcd LB |
371 | status = acpi_ns_handle_to_pathname(obj_handle, &buffer); |
372 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
373 | return; |
374 | } | |
375 | ||
376 | /* Print what we're doing */ | |
377 | ||
378 | switch (type) { | |
379 | case ACPI_TYPE_METHOD: | |
4be44fcd | 380 | acpi_os_printf("Executing "); |
1da177e4 LT |
381 | break; |
382 | ||
383 | default: | |
4be44fcd | 384 | acpi_os_printf("Initializing "); |
1da177e4 LT |
385 | break; |
386 | } | |
387 | ||
388 | /* Print the object type and pathname */ | |
389 | ||
4be44fcd LB |
390 | acpi_os_printf("%-12s %s", |
391 | acpi_ut_get_type_name(type), (char *)buffer.pointer); | |
1da177e4 LT |
392 | |
393 | /* Extra path is used to append names like _STA, _INI, etc. */ | |
394 | ||
395 | if (path) { | |
4be44fcd | 396 | acpi_os_printf(".%s", path); |
1da177e4 | 397 | } |
4be44fcd | 398 | acpi_os_printf("\n"); |
1da177e4 | 399 | |
4be44fcd | 400 | ACPI_MEM_FREE(buffer.pointer); |
1da177e4 LT |
401 | } |
402 | #endif | |
403 | ||
1da177e4 LT |
404 | /******************************************************************************* |
405 | * | |
406 | * FUNCTION: acpi_ut_valid_acpi_name | |
407 | * | |
44f6c012 | 408 | * PARAMETERS: Name - The name to be examined |
1da177e4 | 409 | * |
44f6c012 | 410 | * RETURN: TRUE if the name is valid, FALSE otherwise |
1da177e4 LT |
411 | * |
412 | * DESCRIPTION: Check for a valid ACPI name. Each character must be one of: | |
413 | * 1) Upper case alpha | |
414 | * 2) numeric | |
415 | * 3) underscore | |
416 | * | |
417 | ******************************************************************************/ | |
418 | ||
4be44fcd | 419 | u8 acpi_ut_valid_acpi_name(u32 name) |
1da177e4 | 420 | { |
4be44fcd LB |
421 | char *name_ptr = (char *)&name; |
422 | char character; | |
423 | acpi_native_uint i; | |
1da177e4 | 424 | |
4be44fcd | 425 | ACPI_FUNCTION_ENTRY(); |
1da177e4 LT |
426 | |
427 | for (i = 0; i < ACPI_NAME_SIZE; i++) { | |
428 | character = *name_ptr; | |
429 | name_ptr++; | |
430 | ||
431 | if (!((character == '_') || | |
4be44fcd LB |
432 | (character >= 'A' && character <= 'Z') || |
433 | (character >= '0' && character <= '9'))) { | |
1da177e4 LT |
434 | return (FALSE); |
435 | } | |
436 | } | |
437 | ||
438 | return (TRUE); | |
439 | } | |
440 | ||
1da177e4 LT |
441 | /******************************************************************************* |
442 | * | |
443 | * FUNCTION: acpi_ut_valid_acpi_character | |
444 | * | |
445 | * PARAMETERS: Character - The character to be examined | |
446 | * | |
447 | * RETURN: 1 if Character may appear in a name, else 0 | |
448 | * | |
449 | * DESCRIPTION: Check for a printable character | |
450 | * | |
451 | ******************************************************************************/ | |
452 | ||
4be44fcd | 453 | u8 acpi_ut_valid_acpi_character(char character) |
1da177e4 LT |
454 | { |
455 | ||
4be44fcd | 456 | ACPI_FUNCTION_ENTRY(); |
1da177e4 | 457 | |
4be44fcd LB |
458 | return ((u8) ((character == '_') || |
459 | (character >= 'A' && character <= 'Z') || | |
460 | (character >= '0' && character <= '9'))); | |
1da177e4 LT |
461 | } |
462 | ||
1da177e4 LT |
463 | /******************************************************************************* |
464 | * | |
465 | * FUNCTION: acpi_ut_strtoul64 | |
466 | * | |
467 | * PARAMETERS: String - Null terminated string | |
468 | * Base - Radix of the string: 10, 16, or ACPI_ANY_BASE | |
469 | * ret_integer - Where the converted integer is returned | |
470 | * | |
471 | * RETURN: Status and Converted value | |
472 | * | |
473 | * DESCRIPTION: Convert a string into an unsigned value. | |
474 | * NOTE: Does not support Octal strings, not needed. | |
475 | * | |
476 | ******************************************************************************/ | |
477 | ||
478 | acpi_status | |
4be44fcd | 479 | acpi_ut_strtoul64(char *string, u32 base, acpi_integer * ret_integer) |
1da177e4 | 480 | { |
4be44fcd LB |
481 | u32 this_digit = 0; |
482 | acpi_integer return_value = 0; | |
483 | acpi_integer quotient; | |
1da177e4 | 484 | |
4be44fcd | 485 | ACPI_FUNCTION_TRACE("ut_stroul64"); |
1da177e4 LT |
486 | |
487 | if ((!string) || !(*string)) { | |
488 | goto error_exit; | |
489 | } | |
490 | ||
491 | switch (base) { | |
492 | case ACPI_ANY_BASE: | |
493 | case 10: | |
494 | case 16: | |
495 | break; | |
496 | ||
497 | default: | |
498 | /* Invalid Base */ | |
4be44fcd | 499 | return_ACPI_STATUS(AE_BAD_PARAMETER); |
1da177e4 LT |
500 | } |
501 | ||
502 | /* Skip over any white space in the buffer */ | |
503 | ||
4be44fcd | 504 | while (ACPI_IS_SPACE(*string) || *string == '\t') { |
1da177e4 LT |
505 | string++; |
506 | } | |
507 | ||
508 | /* | |
509 | * If the input parameter Base is zero, then we need to | |
510 | * determine if it is decimal or hexadecimal: | |
511 | */ | |
512 | if (base == 0) { | |
4be44fcd | 513 | if ((*string == '0') && (ACPI_TOLOWER(*(string + 1)) == 'x')) { |
1da177e4 LT |
514 | base = 16; |
515 | string += 2; | |
4be44fcd | 516 | } else { |
1da177e4 LT |
517 | base = 10; |
518 | } | |
519 | } | |
520 | ||
521 | /* | |
522 | * For hexadecimal base, skip over the leading | |
523 | * 0 or 0x, if they are present. | |
524 | */ | |
525 | if ((base == 16) && | |
4be44fcd | 526 | (*string == '0') && (ACPI_TOLOWER(*(string + 1)) == 'x')) { |
1da177e4 LT |
527 | string += 2; |
528 | } | |
529 | ||
530 | /* Any string left? */ | |
531 | ||
532 | if (!(*string)) { | |
533 | goto error_exit; | |
534 | } | |
535 | ||
536 | /* Main loop: convert the string to a 64-bit integer */ | |
537 | ||
538 | while (*string) { | |
4be44fcd | 539 | if (ACPI_IS_DIGIT(*string)) { |
1da177e4 LT |
540 | /* Convert ASCII 0-9 to Decimal value */ |
541 | ||
4be44fcd LB |
542 | this_digit = ((u8) * string) - '0'; |
543 | } else { | |
1da177e4 LT |
544 | if (base == 10) { |
545 | /* Digit is out of range */ | |
546 | ||
547 | goto error_exit; | |
548 | } | |
549 | ||
4be44fcd LB |
550 | this_digit = (u8) ACPI_TOUPPER(*string); |
551 | if (ACPI_IS_XDIGIT((char)this_digit)) { | |
1da177e4 LT |
552 | /* Convert ASCII Hex char to value */ |
553 | ||
554 | this_digit = this_digit - 'A' + 10; | |
4be44fcd | 555 | } else { |
1da177e4 LT |
556 | /* |
557 | * We allow non-hex chars, just stop now, same as end-of-string. | |
558 | * See ACPI spec, string-to-integer conversion. | |
559 | */ | |
560 | break; | |
561 | } | |
562 | } | |
563 | ||
564 | /* Divide the digit into the correct position */ | |
565 | ||
4be44fcd LB |
566 | (void) |
567 | acpi_ut_short_divide((ACPI_INTEGER_MAX - | |
568 | (acpi_integer) this_digit), base, | |
569 | "ient, NULL); | |
1da177e4 LT |
570 | if (return_value > quotient) { |
571 | goto error_exit; | |
572 | } | |
573 | ||
574 | return_value *= base; | |
575 | return_value += this_digit; | |
576 | string++; | |
577 | } | |
578 | ||
579 | /* All done, normal exit */ | |
580 | ||
581 | *ret_integer = return_value; | |
4be44fcd | 582 | return_ACPI_STATUS(AE_OK); |
1da177e4 | 583 | |
4be44fcd | 584 | error_exit: |
1da177e4 LT |
585 | /* Base was set/validated above */ |
586 | ||
587 | if (base == 10) { | |
4be44fcd LB |
588 | return_ACPI_STATUS(AE_BAD_DECIMAL_CONSTANT); |
589 | } else { | |
590 | return_ACPI_STATUS(AE_BAD_HEX_CONSTANT); | |
1da177e4 LT |
591 | } |
592 | } | |
593 | ||
1da177e4 LT |
594 | /******************************************************************************* |
595 | * | |
596 | * FUNCTION: acpi_ut_create_update_state_and_push | |
597 | * | |
44f6c012 | 598 | * PARAMETERS: Object - Object to be added to the new state |
1da177e4 LT |
599 | * Action - Increment/Decrement |
600 | * state_list - List the state will be added to | |
601 | * | |
44f6c012 | 602 | * RETURN: Status |
1da177e4 LT |
603 | * |
604 | * DESCRIPTION: Create a new state and push it | |
605 | * | |
606 | ******************************************************************************/ | |
607 | ||
608 | acpi_status | |
4be44fcd LB |
609 | acpi_ut_create_update_state_and_push(union acpi_operand_object *object, |
610 | u16 action, | |
611 | union acpi_generic_state **state_list) | |
1da177e4 | 612 | { |
4be44fcd | 613 | union acpi_generic_state *state; |
1da177e4 | 614 | |
4be44fcd | 615 | ACPI_FUNCTION_ENTRY(); |
1da177e4 LT |
616 | |
617 | /* Ignore null objects; these are expected */ | |
618 | ||
619 | if (!object) { | |
620 | return (AE_OK); | |
621 | } | |
622 | ||
4be44fcd | 623 | state = acpi_ut_create_update_state(object, action); |
1da177e4 LT |
624 | if (!state) { |
625 | return (AE_NO_MEMORY); | |
626 | } | |
627 | ||
4be44fcd | 628 | acpi_ut_push_generic_state(state_list, state); |
1da177e4 LT |
629 | return (AE_OK); |
630 | } | |
631 | ||
1da177e4 LT |
632 | /******************************************************************************* |
633 | * | |
634 | * FUNCTION: acpi_ut_walk_package_tree | |
635 | * | |
44f6c012 RM |
636 | * PARAMETERS: source_object - The package to walk |
637 | * target_object - Target object (if package is being copied) | |
638 | * walk_callback - Called once for each package element | |
639 | * Context - Passed to the callback function | |
1da177e4 LT |
640 | * |
641 | * RETURN: Status | |
642 | * | |
643 | * DESCRIPTION: Walk through a package | |
644 | * | |
645 | ******************************************************************************/ | |
646 | ||
647 | acpi_status | |
4be44fcd LB |
648 | acpi_ut_walk_package_tree(union acpi_operand_object * source_object, |
649 | void *target_object, | |
650 | acpi_pkg_callback walk_callback, void *context) | |
1da177e4 | 651 | { |
4be44fcd LB |
652 | acpi_status status = AE_OK; |
653 | union acpi_generic_state *state_list = NULL; | |
654 | union acpi_generic_state *state; | |
655 | u32 this_index; | |
656 | union acpi_operand_object *this_source_obj; | |
1da177e4 | 657 | |
4be44fcd | 658 | ACPI_FUNCTION_TRACE("ut_walk_package_tree"); |
1da177e4 | 659 | |
4be44fcd | 660 | state = acpi_ut_create_pkg_state(source_object, target_object, 0); |
1da177e4 | 661 | if (!state) { |
4be44fcd | 662 | return_ACPI_STATUS(AE_NO_MEMORY); |
1da177e4 LT |
663 | } |
664 | ||
665 | while (state) { | |
666 | /* Get one element of the package */ | |
667 | ||
4be44fcd | 668 | this_index = state->pkg.index; |
1da177e4 | 669 | this_source_obj = (union acpi_operand_object *) |
4be44fcd | 670 | state->pkg.source_object->package.elements[this_index]; |
1da177e4 LT |
671 | |
672 | /* | |
673 | * Check for: | |
674 | * 1) An uninitialized package element. It is completely | |
675 | * legal to declare a package and leave it uninitialized | |
676 | * 2) Not an internal object - can be a namespace node instead | |
677 | * 3) Any type other than a package. Packages are handled in else | |
678 | * case below. | |
679 | */ | |
680 | if ((!this_source_obj) || | |
4be44fcd LB |
681 | (ACPI_GET_DESCRIPTOR_TYPE(this_source_obj) != |
682 | ACPI_DESC_TYPE_OPERAND) | |
683 | || (ACPI_GET_OBJECT_TYPE(this_source_obj) != | |
684 | ACPI_TYPE_PACKAGE)) { | |
685 | status = | |
686 | walk_callback(ACPI_COPY_TYPE_SIMPLE, | |
687 | this_source_obj, state, context); | |
688 | if (ACPI_FAILURE(status)) { | |
689 | return_ACPI_STATUS(status); | |
1da177e4 LT |
690 | } |
691 | ||
692 | state->pkg.index++; | |
4be44fcd LB |
693 | while (state->pkg.index >= |
694 | state->pkg.source_object->package.count) { | |
1da177e4 LT |
695 | /* |
696 | * We've handled all of the objects at this level, This means | |
697 | * that we have just completed a package. That package may | |
698 | * have contained one or more packages itself. | |
699 | * | |
700 | * Delete this state and pop the previous state (package). | |
701 | */ | |
4be44fcd LB |
702 | acpi_ut_delete_generic_state(state); |
703 | state = acpi_ut_pop_generic_state(&state_list); | |
1da177e4 LT |
704 | |
705 | /* Finished when there are no more states */ | |
706 | ||
707 | if (!state) { | |
708 | /* | |
709 | * We have handled all of the objects in the top level | |
710 | * package just add the length of the package objects | |
711 | * and exit | |
712 | */ | |
4be44fcd | 713 | return_ACPI_STATUS(AE_OK); |
1da177e4 LT |
714 | } |
715 | ||
716 | /* | |
717 | * Go back up a level and move the index past the just | |
718 | * completed package object. | |
719 | */ | |
720 | state->pkg.index++; | |
721 | } | |
4be44fcd | 722 | } else { |
1da177e4 LT |
723 | /* This is a subobject of type package */ |
724 | ||
4be44fcd LB |
725 | status = |
726 | walk_callback(ACPI_COPY_TYPE_PACKAGE, | |
727 | this_source_obj, state, context); | |
728 | if (ACPI_FAILURE(status)) { | |
729 | return_ACPI_STATUS(status); | |
1da177e4 LT |
730 | } |
731 | ||
732 | /* | |
733 | * Push the current state and create a new one | |
734 | * The callback above returned a new target package object. | |
735 | */ | |
4be44fcd LB |
736 | acpi_ut_push_generic_state(&state_list, state); |
737 | state = acpi_ut_create_pkg_state(this_source_obj, | |
738 | state->pkg. | |
739 | this_target_obj, 0); | |
1da177e4 | 740 | if (!state) { |
4be44fcd | 741 | return_ACPI_STATUS(AE_NO_MEMORY); |
1da177e4 LT |
742 | } |
743 | } | |
744 | } | |
745 | ||
746 | /* We should never get here */ | |
747 | ||
4be44fcd | 748 | return_ACPI_STATUS(AE_AML_INTERNAL); |
1da177e4 LT |
749 | } |
750 | ||
1da177e4 LT |
751 | /******************************************************************************* |
752 | * | |
753 | * FUNCTION: acpi_ut_generate_checksum | |
754 | * | |
755 | * PARAMETERS: Buffer - Buffer to be scanned | |
756 | * Length - number of bytes to examine | |
757 | * | |
44f6c012 | 758 | * RETURN: The generated checksum |
1da177e4 LT |
759 | * |
760 | * DESCRIPTION: Generate a checksum on a raw buffer | |
761 | * | |
762 | ******************************************************************************/ | |
763 | ||
4be44fcd | 764 | u8 acpi_ut_generate_checksum(u8 * buffer, u32 length) |
1da177e4 | 765 | { |
4be44fcd LB |
766 | u32 i; |
767 | signed char sum = 0; | |
1da177e4 LT |
768 | |
769 | for (i = 0; i < length; i++) { | |
4be44fcd | 770 | sum = (signed char)(sum + buffer[i]); |
1da177e4 LT |
771 | } |
772 | ||
773 | return ((u8) (0 - sum)); | |
774 | } | |
775 | ||
1da177e4 LT |
776 | /******************************************************************************* |
777 | * | |
778 | * FUNCTION: acpi_ut_get_resource_end_tag | |
779 | * | |
780 | * PARAMETERS: obj_desc - The resource template buffer object | |
781 | * | |
782 | * RETURN: Pointer to the end tag | |
783 | * | |
784 | * DESCRIPTION: Find the END_TAG resource descriptor in a resource template | |
785 | * | |
786 | ******************************************************************************/ | |
787 | ||
4be44fcd | 788 | u8 *acpi_ut_get_resource_end_tag(union acpi_operand_object * obj_desc) |
1da177e4 | 789 | { |
4be44fcd LB |
790 | u8 buffer_byte; |
791 | u8 *buffer; | |
792 | u8 *end_buffer; | |
1da177e4 | 793 | |
4be44fcd | 794 | buffer = obj_desc->buffer.pointer; |
1da177e4 LT |
795 | end_buffer = buffer + obj_desc->buffer.length; |
796 | ||
797 | while (buffer < end_buffer) { | |
798 | buffer_byte = *buffer; | |
799 | if (buffer_byte & ACPI_RDESC_TYPE_MASK) { | |
800 | /* Large Descriptor - Length is next 2 bytes */ | |
801 | ||
4be44fcd LB |
802 | buffer += ((*(buffer + 1) | (*(buffer + 2) << 8)) + 3); |
803 | } else { | |
1da177e4 LT |
804 | /* Small Descriptor. End Tag will be found here */ |
805 | ||
4be44fcd LB |
806 | if ((buffer_byte & ACPI_RDESC_SMALL_MASK) == |
807 | ACPI_RDESC_TYPE_END_TAG) { | |
1da177e4 LT |
808 | /* Found the end tag descriptor, all done. */ |
809 | ||
810 | return (buffer); | |
811 | } | |
812 | ||
813 | /* Length is in the header */ | |
814 | ||
815 | buffer += ((buffer_byte & 0x07) + 1); | |
816 | } | |
817 | } | |
818 | ||
819 | /* End tag not found */ | |
820 | ||
821 | return (NULL); | |
822 | } | |
823 | ||
1da177e4 LT |
824 | /******************************************************************************* |
825 | * | |
826 | * FUNCTION: acpi_ut_report_error | |
827 | * | |
828 | * PARAMETERS: module_name - Caller's module name (for error output) | |
829 | * line_number - Caller's line number (for error output) | |
830 | * component_id - Caller's component ID (for error output) | |
1da177e4 LT |
831 | * |
832 | * RETURN: None | |
833 | * | |
834 | * DESCRIPTION: Print error message | |
835 | * | |
836 | ******************************************************************************/ | |
837 | ||
4be44fcd | 838 | void acpi_ut_report_error(char *module_name, u32 line_number, u32 component_id) |
1da177e4 LT |
839 | { |
840 | ||
4be44fcd | 841 | acpi_os_printf("%8s-%04d: *** Error: ", module_name, line_number); |
1da177e4 LT |
842 | } |
843 | ||
1da177e4 LT |
844 | /******************************************************************************* |
845 | * | |
846 | * FUNCTION: acpi_ut_report_warning | |
847 | * | |
848 | * PARAMETERS: module_name - Caller's module name (for error output) | |
849 | * line_number - Caller's line number (for error output) | |
850 | * component_id - Caller's component ID (for error output) | |
1da177e4 LT |
851 | * |
852 | * RETURN: None | |
853 | * | |
854 | * DESCRIPTION: Print warning message | |
855 | * | |
856 | ******************************************************************************/ | |
857 | ||
858 | void | |
4be44fcd | 859 | acpi_ut_report_warning(char *module_name, u32 line_number, u32 component_id) |
1da177e4 LT |
860 | { |
861 | ||
4be44fcd | 862 | acpi_os_printf("%8s-%04d: *** Warning: ", module_name, line_number); |
1da177e4 LT |
863 | } |
864 | ||
1da177e4 LT |
865 | /******************************************************************************* |
866 | * | |
867 | * FUNCTION: acpi_ut_report_info | |
868 | * | |
869 | * PARAMETERS: module_name - Caller's module name (for error output) | |
870 | * line_number - Caller's line number (for error output) | |
871 | * component_id - Caller's component ID (for error output) | |
1da177e4 LT |
872 | * |
873 | * RETURN: None | |
874 | * | |
875 | * DESCRIPTION: Print information message | |
876 | * | |
877 | ******************************************************************************/ | |
878 | ||
4be44fcd | 879 | void acpi_ut_report_info(char *module_name, u32 line_number, u32 component_id) |
1da177e4 LT |
880 | { |
881 | ||
4be44fcd | 882 | acpi_os_printf("%8s-%04d: *** Info: ", module_name, line_number); |
1da177e4 | 883 | } |