123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211 |
- // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
- /*******************************************************************************
- *
- * Module Name: utstring - Common functions for strings and characters
- *
- ******************************************************************************/
- #include <acpi/acpi.h>
- #include "accommon.h"
- #include "acnamesp.h"
- #define _COMPONENT ACPI_UTILITIES
- ACPI_MODULE_NAME("utstring")
- /*******************************************************************************
- *
- * FUNCTION: acpi_ut_print_string
- *
- * PARAMETERS: string - Null terminated ASCII string
- * max_length - Maximum output length. Used to constrain the
- * length of strings during debug output only.
- *
- * RETURN: None
- *
- * DESCRIPTION: Dump an ASCII string with support for ACPI-defined escape
- * sequences.
- *
- ******************************************************************************/
- void acpi_ut_print_string(char *string, u16 max_length)
- {
- u32 i;
- if (!string) {
- acpi_os_printf("<\"NULL STRING PTR\">");
- return;
- }
- acpi_os_printf("\"");
- for (i = 0; (i < max_length) && string[i]; i++) {
- /* Escape sequences */
- switch (string[i]) {
- case 0x07:
- acpi_os_printf("\\a"); /* BELL */
- break;
- case 0x08:
- acpi_os_printf("\\b"); /* BACKSPACE */
- break;
- case 0x0C:
- acpi_os_printf("\\f"); /* FORMFEED */
- break;
- case 0x0A:
- acpi_os_printf("\\n"); /* LINEFEED */
- break;
- case 0x0D:
- acpi_os_printf("\\r"); /* CARRIAGE RETURN */
- break;
- case 0x09:
- acpi_os_printf("\\t"); /* HORIZONTAL TAB */
- break;
- case 0x0B:
- acpi_os_printf("\\v"); /* VERTICAL TAB */
- break;
- case '\'': /* Single Quote */
- case '\"': /* Double Quote */
- case '\\': /* Backslash */
- acpi_os_printf("\\%c", (int)string[i]);
- break;
- default:
- /* Check for printable character or hex escape */
- if (isprint((int)string[i])) {
- /* This is a normal character */
- acpi_os_printf("%c", (int)string[i]);
- } else {
- /* All others will be Hex escapes */
- acpi_os_printf("\\x%2.2X", (s32)string[i]);
- }
- break;
- }
- }
- acpi_os_printf("\"");
- if (i == max_length && string[i]) {
- acpi_os_printf("...");
- }
- }
- /*******************************************************************************
- *
- * FUNCTION: acpi_ut_repair_name
- *
- * PARAMETERS: name - The ACPI name to be repaired
- *
- * RETURN: Repaired version of the name
- *
- * DESCRIPTION: Repair an ACPI name: Change invalid characters to '*' and
- * return the new name. NOTE: the Name parameter must reside in
- * read/write memory, cannot be a const.
- *
- * An ACPI Name must consist of valid ACPI characters. We will repair the name
- * if necessary because we don't want to abort because of this, but we want
- * all namespace names to be printable. A warning message is appropriate.
- *
- * This issue came up because there are in fact machines that exhibit
- * this problem, and we want to be able to enable ACPI support for them,
- * even though there are a few bad names.
- *
- ******************************************************************************/
- void acpi_ut_repair_name(char *name)
- {
- u32 i;
- u8 found_bad_char = FALSE;
- u32 original_name;
- ACPI_FUNCTION_NAME(ut_repair_name);
- /*
- * Special case for the root node. This can happen if we get an
- * error during the execution of module-level code.
- */
- if (ACPI_COMPARE_NAMESEG(name, ACPI_ROOT_PATHNAME)) {
- return;
- }
- ACPI_COPY_NAMESEG(&original_name, name);
- /* Check each character in the name */
- for (i = 0; i < ACPI_NAMESEG_SIZE; i++) {
- if (acpi_ut_valid_name_char(name[i], i)) {
- continue;
- }
- /*
- * Replace a bad character with something printable, yet technically
- * still invalid. This prevents any collisions with existing "good"
- * names in the namespace.
- */
- name[i] = '*';
- found_bad_char = TRUE;
- }
- if (found_bad_char) {
- /* Report warning only if in strict mode or debug mode */
- if (!acpi_gbl_enable_interpreter_slack) {
- ACPI_WARNING((AE_INFO,
- "Invalid character(s) in name (0x%.8X), repaired: [%4.4s]",
- original_name, name));
- } else {
- ACPI_DEBUG_PRINT((ACPI_DB_INFO,
- "Invalid character(s) in name (0x%.8X), repaired: [%4.4s]",
- original_name, name));
- }
- }
- }
- #if defined ACPI_ASL_COMPILER || defined ACPI_EXEC_APP
- /*******************************************************************************
- *
- * FUNCTION: ut_convert_backslashes
- *
- * PARAMETERS: pathname - File pathname string to be converted
- *
- * RETURN: Modifies the input Pathname
- *
- * DESCRIPTION: Convert all backslashes (0x5C) to forward slashes (0x2F) within
- * the entire input file pathname string.
- *
- ******************************************************************************/
- void ut_convert_backslashes(char *pathname)
- {
- if (!pathname) {
- return;
- }
- while (*pathname) {
- if (*pathname == '\\') {
- *pathname = '/';
- }
- pathname++;
- }
- }
- #endif
|