1// SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 2/******************************************************************************* 3 * 4 * Module Name: utstrsuppt - Support functions for string-to-integer conversion 5 * 6 ******************************************************************************/ 7 8#include <acpi/acpi.h> 9#include "accommon.h" 10 11#define _COMPONENT ACPI_UTILITIES 12ACPI_MODULE_NAME("utstrsuppt") 13 14/* Local prototypes */ 15static acpi_status 16acpi_ut_insert_digit(u64 *accumulated_value, u32 base, int ascii_digit); 17 18static acpi_status 19acpi_ut_strtoul_multiply64(u64 multiplicand, u32 base, u64 *out_product); 20 21static acpi_status acpi_ut_strtoul_add64(u64 addend1, u32 digit, u64 *out_sum); 22 23/******************************************************************************* 24 * 25 * FUNCTION: acpi_ut_convert_octal_string 26 * 27 * PARAMETERS: string - Null terminated input string 28 * return_value_ptr - Where the converted value is returned 29 * 30 * RETURN: Status and 64-bit converted integer 31 * 32 * DESCRIPTION: Performs a base 8 conversion of the input string to an 33 * integer value, either 32 or 64 bits. 34 * 35 * NOTE: Maximum 64-bit unsigned octal value is 01777777777777777777777 36 * Maximum 32-bit unsigned octal value is 037777777777 37 * 38 ******************************************************************************/ 39 40acpi_status acpi_ut_convert_octal_string(char *string, u64 *return_value_ptr) 41{ 42 u64 accumulated_value = 0; 43 acpi_status status = AE_OK; 44 45 /* Convert each ASCII byte in the input string */ 46 47 while (*string) { 48 49 /* Character must be ASCII 0-7, otherwise terminate with no error */ 50 51 if (!(ACPI_IS_OCTAL_DIGIT(*string))) { 52 break; 53 } 54 55 /* Convert and insert this octal digit into the accumulator */ 56 57 status = acpi_ut_insert_digit(&accumulated_value, 8, *string); 58 if (ACPI_FAILURE(status)) { 59 status = AE_OCTAL_OVERFLOW; 60 break; 61 } 62 63 string++; 64 } 65 66 /* Always return the value that has been accumulated */ 67 68 *return_value_ptr = accumulated_value; 69 return (status); 70} 71 72/******************************************************************************* 73 * 74 * FUNCTION: acpi_ut_convert_decimal_string 75 * 76 * PARAMETERS: string - Null terminated input string 77 * return_value_ptr - Where the converted value is returned 78 * 79 * RETURN: Status and 64-bit converted integer 80 * 81 * DESCRIPTION: Performs a base 10 conversion of the input string to an 82 * integer value, either 32 or 64 bits. 83 * 84 * NOTE: Maximum 64-bit unsigned decimal value is 18446744073709551615 85 * Maximum 32-bit unsigned decimal value is 4294967295 86 * 87 ******************************************************************************/ 88 89acpi_status acpi_ut_convert_decimal_string(char *string, u64 *return_value_ptr) 90{ 91 u64 accumulated_value = 0; 92 acpi_status status = AE_OK; 93 94 /* Convert each ASCII byte in the input string */ 95 96 while (*string) { 97 98 /* Character must be ASCII 0-9, otherwise terminate with no error */ 99 100 if (!isdigit(*string)) { 101 break; 102 } 103 104 /* Convert and insert this decimal digit into the accumulator */ 105 106 status = acpi_ut_insert_digit(&accumulated_value, 10, *string); 107 if (ACPI_FAILURE(status)) { 108 status = AE_DECIMAL_OVERFLOW; 109 break; 110 } 111 112 string++; 113 } 114 115 /* Always return the value that has been accumulated */ 116 117 *return_value_ptr = accumulated_value; 118 return (status); 119} 120 121/******************************************************************************* 122 * 123 * FUNCTION: acpi_ut_convert_hex_string 124 * 125 * PARAMETERS: string - Null terminated input string 126 * return_value_ptr - Where the converted value is returned 127 * 128 * RETURN: Status and 64-bit converted integer 129 * 130 * DESCRIPTION: Performs a base 16 conversion of the input string to an 131 * integer value, either 32 or 64 bits. 132 * 133 * NOTE: Maximum 64-bit unsigned hex value is 0xFFFFFFFFFFFFFFFF 134 * Maximum 32-bit unsigned hex value is 0xFFFFFFFF 135 * 136 ******************************************************************************/ 137 138acpi_status acpi_ut_convert_hex_string(char *string, u64 *return_value_ptr) 139{ 140 u64 accumulated_value = 0; 141 acpi_status status = AE_OK; 142 143 /* Convert each ASCII byte in the input string */ 144 145 while (*string) { 146 147 /* Must be ASCII A-F, a-f, or 0-9, otherwise terminate with no error */ 148 149 if (!isxdigit(*string)) { 150 break; 151 } 152 153 /* Convert and insert this hex digit into the accumulator */ 154 155 status = acpi_ut_insert_digit(&accumulated_value, 16, *string); 156 if (ACPI_FAILURE(status)) { 157 status = AE_HEX_OVERFLOW; 158 break; 159 } 160 161 string++; 162 } 163 164 /* Always return the value that has been accumulated */ 165 166 *return_value_ptr = accumulated_value; 167 return (status); 168} 169 170/******************************************************************************* 171 * 172 * FUNCTION: acpi_ut_remove_leading_zeros 173 * 174 * PARAMETERS: string - Pointer to input ASCII string 175 * 176 * RETURN: Next character after any leading zeros. This character may be 177 * used by the caller to detect end-of-string. 178 * 179 * DESCRIPTION: Remove any leading zeros in the input string. Return the 180 * next character after the final ASCII zero to enable the caller 181 * to check for the end of the string (NULL terminator). 182 * 183 ******************************************************************************/ 184 185char acpi_ut_remove_leading_zeros(char **string) 186{ 187 188 while (**string == ACPI_ASCII_ZERO) { 189 *string += 1; 190 } 191 192 return (**string); 193} 194 195/******************************************************************************* 196 * 197 * FUNCTION: acpi_ut_remove_whitespace 198 * 199 * PARAMETERS: string - Pointer to input ASCII string 200 * 201 * RETURN: Next character after any whitespace. This character may be 202 * used by the caller to detect end-of-string. 203 * 204 * DESCRIPTION: Remove any leading whitespace in the input string. Return the 205 * next character after the final ASCII zero to enable the caller 206 * to check for the end of the string (NULL terminator). 207 * 208 ******************************************************************************/ 209 210char acpi_ut_remove_whitespace(char **string) 211{ 212 213 while (isspace((u8)**string)) { 214 *string += 1; 215 } 216 217 return (**string); 218} 219 220/******************************************************************************* 221 * 222 * FUNCTION: acpi_ut_detect_hex_prefix 223 * 224 * PARAMETERS: string - Pointer to input ASCII string 225 * 226 * RETURN: TRUE if a "0x" prefix was found at the start of the string 227 * 228 * DESCRIPTION: Detect and remove a hex "0x" prefix 229 * 230 ******************************************************************************/ 231 232u8 acpi_ut_detect_hex_prefix(char **string) 233{ 234 char *initial_position = *string; 235 236 acpi_ut_remove_hex_prefix(string); 237 if (*string != initial_position) { 238 return (TRUE); /* String is past leading 0x */ 239 } 240 241 return (FALSE); /* Not a hex string */ 242} 243 244/******************************************************************************* 245 * 246 * FUNCTION: acpi_ut_remove_hex_prefix 247 * 248 * PARAMETERS: string - Pointer to input ASCII string 249 * 250 * RETURN: none 251 * 252 * DESCRIPTION: Remove a hex "0x" prefix 253 * 254 ******************************************************************************/ 255 256void acpi_ut_remove_hex_prefix(char **string) 257{ 258 if ((**string == ACPI_ASCII_ZERO) && 259 (tolower((int)*(*string + 1)) == 'x')) { 260 *string += 2; /* Go past the leading 0x */ 261 } 262} 263 264/******************************************************************************* 265 * 266 * FUNCTION: acpi_ut_detect_octal_prefix 267 * 268 * PARAMETERS: string - Pointer to input ASCII string 269 * 270 * RETURN: True if an octal "0" prefix was found at the start of the 271 * string 272 * 273 * DESCRIPTION: Detect and remove an octal prefix (zero) 274 * 275 ******************************************************************************/ 276 277u8 acpi_ut_detect_octal_prefix(char **string) 278{ 279 280 if (**string == ACPI_ASCII_ZERO) { 281 *string += 1; /* Go past the leading 0 */ 282 return (TRUE); 283 } 284 285 return (FALSE); /* Not an octal string */ 286} 287 288/******************************************************************************* 289 * 290 * FUNCTION: acpi_ut_insert_digit 291 * 292 * PARAMETERS: accumulated_value - Current value of the integer value 293 * accumulator. The new value is 294 * returned here. 295 * base - Radix, either 8/10/16 296 * ascii_digit - ASCII single digit to be inserted 297 * 298 * RETURN: Status and result of the convert/insert operation. The only 299 * possible returned exception code is numeric overflow of 300 * either the multiply or add conversion operations. 301 * 302 * DESCRIPTION: Generic conversion and insertion function for all bases: 303 * 304 * 1) Multiply the current accumulated/converted value by the 305 * base in order to make room for the new character. 306 * 307 * 2) Convert the new character to binary and add it to the 308 * current accumulated value. 309 * 310 * Note: The only possible exception indicates an integer 311 * overflow (AE_NUMERIC_OVERFLOW) 312 * 313 ******************************************************************************/ 314 315static acpi_status 316acpi_ut_insert_digit(u64 *accumulated_value, u32 base, int ascii_digit) 317{ 318 acpi_status status; 319 u64 product; 320 321 /* Make room in the accumulated value for the incoming digit */ 322 323 status = acpi_ut_strtoul_multiply64(*accumulated_value, base, &product); 324 if (ACPI_FAILURE(status)) { 325 return (status); 326 } 327 328 /* Add in the new digit, and store the sum to the accumulated value */ 329 330 status = 331 acpi_ut_strtoul_add64(product, 332 acpi_ut_ascii_char_to_hex(ascii_digit), 333 accumulated_value); 334 335 return (status); 336} 337 338/******************************************************************************* 339 * 340 * FUNCTION: acpi_ut_strtoul_multiply64 341 * 342 * PARAMETERS: multiplicand - Current accumulated converted integer 343 * base - Base/Radix 344 * out_product - Where the product is returned 345 * 346 * RETURN: Status and 64-bit product 347 * 348 * DESCRIPTION: Multiply two 64-bit values, with checking for 64-bit overflow as 349 * well as 32-bit overflow if necessary (if the current global 350 * integer width is 32). 351 * 352 ******************************************************************************/ 353 354static acpi_status 355acpi_ut_strtoul_multiply64(u64 multiplicand, u32 base, u64 *out_product) 356{ 357 u64 product; 358 u64 quotient; 359 360 /* Exit if either operand is zero */ 361 362 *out_product = 0; 363 if (!multiplicand || !base) { 364 return (AE_OK); 365 } 366 367 /* 368 * Check for 64-bit overflow before the actual multiplication. 369 * 370 * Notes: 64-bit division is often not supported on 32-bit platforms 371 * (it requires a library function), Therefore ACPICA has a local 372 * 64-bit divide function. Also, Multiplier is currently only used 373 * as the radix (8/10/16), to the 64/32 divide will always work. 374 */ 375 acpi_ut_short_divide(ACPI_UINT64_MAX, base, "ient, NULL); 376 if (multiplicand > quotient) { 377 return (AE_NUMERIC_OVERFLOW); 378 } 379 380 product = multiplicand * base; 381 382 /* Check for 32-bit overflow if necessary */ 383 384 if ((acpi_gbl_integer_bit_width == 32) && (product > ACPI_UINT32_MAX)) { 385 return (AE_NUMERIC_OVERFLOW); 386 } 387 388 *out_product = product; 389 return (AE_OK); 390} 391 392/******************************************************************************* 393 * 394 * FUNCTION: acpi_ut_strtoul_add64 395 * 396 * PARAMETERS: addend1 - Current accumulated converted integer 397 * digit - New hex value/char 398 * out_sum - Where sum is returned (Accumulator) 399 * 400 * RETURN: Status and 64-bit sum 401 * 402 * DESCRIPTION: Add two 64-bit values, with checking for 64-bit overflow as 403 * well as 32-bit overflow if necessary (if the current global 404 * integer width is 32). 405 * 406 ******************************************************************************/ 407 408static acpi_status acpi_ut_strtoul_add64(u64 addend1, u32 digit, u64 *out_sum) 409{ 410 u64 sum; 411 412 /* Check for 64-bit overflow before the actual addition */ 413 414 if ((addend1 > 0) && (digit > (ACPI_UINT64_MAX - addend1))) { 415 return (AE_NUMERIC_OVERFLOW); 416 } 417 418 sum = addend1 + digit; 419 420 /* Check for 32-bit overflow if necessary */ 421 422 if ((acpi_gbl_integer_bit_width == 32) && (sum > ACPI_UINT32_MAX)) { 423 return (AE_NUMERIC_OVERFLOW); 424 } 425 426 *out_sum = sum; 427 return (AE_OK); 428} 429