1 /******************************************************************************* 2 * 3 * Module Name: utstring - Common functions for strings and characters 4 * 5 ******************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2016, Intel Corp. 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 44 #include <acpi/acpi.h> 45 #include "accommon.h" 46 #include "acnamesp.h" 47 48 #define _COMPONENT ACPI_UTILITIES 49 ACPI_MODULE_NAME("utstring") 50 51 /******************************************************************************* 52 * 53 * FUNCTION: acpi_ut_print_string 54 * 55 * PARAMETERS: string - Null terminated ASCII string 56 * max_length - Maximum output length. Used to constrain the 57 * length of strings during debug output only. 58 * 59 * RETURN: None 60 * 61 * DESCRIPTION: Dump an ASCII string with support for ACPI-defined escape 62 * sequences. 63 * 64 ******************************************************************************/ 65 void acpi_ut_print_string(char *string, u16 max_length) 66 { 67 u32 i; 68 69 if (!string) { 70 acpi_os_printf("<\"NULL STRING PTR\">"); 71 return; 72 } 73 74 acpi_os_printf("\""); 75 for (i = 0; (i < max_length) && string[i]; i++) { 76 77 /* Escape sequences */ 78 79 switch (string[i]) { 80 case 0x07: 81 82 acpi_os_printf("\\a"); /* BELL */ 83 break; 84 85 case 0x08: 86 87 acpi_os_printf("\\b"); /* BACKSPACE */ 88 break; 89 90 case 0x0C: 91 92 acpi_os_printf("\\f"); /* FORMFEED */ 93 break; 94 95 case 0x0A: 96 97 acpi_os_printf("\\n"); /* LINEFEED */ 98 break; 99 100 case 0x0D: 101 102 acpi_os_printf("\\r"); /* CARRIAGE RETURN */ 103 break; 104 105 case 0x09: 106 107 acpi_os_printf("\\t"); /* HORIZONTAL TAB */ 108 break; 109 110 case 0x0B: 111 112 acpi_os_printf("\\v"); /* VERTICAL TAB */ 113 break; 114 115 case '\'': /* Single Quote */ 116 case '\"': /* Double Quote */ 117 case '\\': /* Backslash */ 118 119 acpi_os_printf("\\%c", (int)string[i]); 120 break; 121 122 default: 123 124 /* Check for printable character or hex escape */ 125 126 if (isprint((int)string[i])) { 127 /* This is a normal character */ 128 129 acpi_os_printf("%c", (int)string[i]); 130 } else { 131 /* All others will be Hex escapes */ 132 133 acpi_os_printf("\\x%2.2X", (s32)string[i]); 134 } 135 break; 136 } 137 } 138 139 acpi_os_printf("\""); 140 141 if (i == max_length && string[i]) { 142 acpi_os_printf("..."); 143 } 144 } 145 146 /******************************************************************************* 147 * 148 * FUNCTION: acpi_ut_repair_name 149 * 150 * PARAMETERS: name - The ACPI name to be repaired 151 * 152 * RETURN: Repaired version of the name 153 * 154 * DESCRIPTION: Repair an ACPI name: Change invalid characters to '*' and 155 * return the new name. NOTE: the Name parameter must reside in 156 * read/write memory, cannot be a const. 157 * 158 * An ACPI Name must consist of valid ACPI characters. We will repair the name 159 * if necessary because we don't want to abort because of this, but we want 160 * all namespace names to be printable. A warning message is appropriate. 161 * 162 * This issue came up because there are in fact machines that exhibit 163 * this problem, and we want to be able to enable ACPI support for them, 164 * even though there are a few bad names. 165 * 166 ******************************************************************************/ 167 168 void acpi_ut_repair_name(char *name) 169 { 170 u32 i; 171 u8 found_bad_char = FALSE; 172 u32 original_name; 173 174 ACPI_FUNCTION_NAME(ut_repair_name); 175 176 /* 177 * Special case for the root node. This can happen if we get an 178 * error during the execution of module-level code. 179 */ 180 if (ACPI_COMPARE_NAME(name, "\\___")) { 181 return; 182 } 183 184 ACPI_MOVE_NAME(&original_name, name); 185 186 /* Check each character in the name */ 187 188 for (i = 0; i < ACPI_NAME_SIZE; i++) { 189 if (acpi_ut_valid_name_char(name[i], i)) { 190 continue; 191 } 192 193 /* 194 * Replace a bad character with something printable, yet technically 195 * still invalid. This prevents any collisions with existing "good" 196 * names in the namespace. 197 */ 198 name[i] = '*'; 199 found_bad_char = TRUE; 200 } 201 202 if (found_bad_char) { 203 204 /* Report warning only if in strict mode or debug mode */ 205 206 if (!acpi_gbl_enable_interpreter_slack) { 207 ACPI_WARNING((AE_INFO, 208 "Invalid character(s) in name (0x%.8X), repaired: [%4.4s]", 209 original_name, name)); 210 } else { 211 ACPI_DEBUG_PRINT((ACPI_DB_INFO, 212 "Invalid character(s) in name (0x%.8X), repaired: [%4.4s]", 213 original_name, name)); 214 } 215 } 216 } 217 218 #if defined ACPI_ASL_COMPILER || defined ACPI_EXEC_APP 219 /******************************************************************************* 220 * 221 * FUNCTION: ut_convert_backslashes 222 * 223 * PARAMETERS: pathname - File pathname string to be converted 224 * 225 * RETURN: Modifies the input Pathname 226 * 227 * DESCRIPTION: Convert all backslashes (0x5C) to forward slashes (0x2F) within 228 * the entire input file pathname string. 229 * 230 ******************************************************************************/ 231 232 void ut_convert_backslashes(char *pathname) 233 { 234 235 if (!pathname) { 236 return; 237 } 238 239 while (*pathname) { 240 if (*pathname == '\\') { 241 *pathname = '/'; 242 } 243 244 pathname++; 245 } 246 } 247 #endif 248