utascii.c revision 1.1.1.1.2.2
1 1.1.1.1.2.2 skrll /****************************************************************************** 2 1.1.1.1.2.2 skrll * 3 1.1.1.1.2.2 skrll * Module Name: utascii - Utility ascii functions 4 1.1.1.1.2.2 skrll * 5 1.1.1.1.2.2 skrll *****************************************************************************/ 6 1.1.1.1.2.2 skrll 7 1.1.1.1.2.2 skrll /* 8 1.1.1.1.2.2 skrll * Copyright (C) 2000 - 2016, Intel Corp. 9 1.1.1.1.2.2 skrll * All rights reserved. 10 1.1.1.1.2.2 skrll * 11 1.1.1.1.2.2 skrll * Redistribution and use in source and binary forms, with or without 12 1.1.1.1.2.2 skrll * modification, are permitted provided that the following conditions 13 1.1.1.1.2.2 skrll * are met: 14 1.1.1.1.2.2 skrll * 1. Redistributions of source code must retain the above copyright 15 1.1.1.1.2.2 skrll * notice, this list of conditions, and the following disclaimer, 16 1.1.1.1.2.2 skrll * without modification. 17 1.1.1.1.2.2 skrll * 2. Redistributions in binary form must reproduce at minimum a disclaimer 18 1.1.1.1.2.2 skrll * substantially similar to the "NO WARRANTY" disclaimer below 19 1.1.1.1.2.2 skrll * ("Disclaimer") and any redistribution must be conditioned upon 20 1.1.1.1.2.2 skrll * including a substantially similar Disclaimer requirement for further 21 1.1.1.1.2.2 skrll * binary redistribution. 22 1.1.1.1.2.2 skrll * 3. Neither the names of the above-listed copyright holders nor the names 23 1.1.1.1.2.2 skrll * of any contributors may be used to endorse or promote products derived 24 1.1.1.1.2.2 skrll * from this software without specific prior written permission. 25 1.1.1.1.2.2 skrll * 26 1.1.1.1.2.2 skrll * Alternatively, this software may be distributed under the terms of the 27 1.1.1.1.2.2 skrll * GNU General Public License ("GPL") version 2 as published by the Free 28 1.1.1.1.2.2 skrll * Software Foundation. 29 1.1.1.1.2.2 skrll * 30 1.1.1.1.2.2 skrll * NO WARRANTY 31 1.1.1.1.2.2 skrll * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 32 1.1.1.1.2.2 skrll * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 33 1.1.1.1.2.2 skrll * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR 34 1.1.1.1.2.2 skrll * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 35 1.1.1.1.2.2 skrll * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 36 1.1.1.1.2.2 skrll * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 37 1.1.1.1.2.2 skrll * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 38 1.1.1.1.2.2 skrll * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 39 1.1.1.1.2.2 skrll * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 40 1.1.1.1.2.2 skrll * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 41 1.1.1.1.2.2 skrll * POSSIBILITY OF SUCH DAMAGES. 42 1.1.1.1.2.2 skrll */ 43 1.1.1.1.2.2 skrll 44 1.1.1.1.2.2 skrll #include "acpi.h" 45 1.1.1.1.2.2 skrll #include "accommon.h" 46 1.1.1.1.2.2 skrll 47 1.1.1.1.2.2 skrll 48 1.1.1.1.2.2 skrll /******************************************************************************* 49 1.1.1.1.2.2 skrll * 50 1.1.1.1.2.2 skrll * FUNCTION: AcpiUtValidNameseg 51 1.1.1.1.2.2 skrll * 52 1.1.1.1.2.2 skrll * PARAMETERS: Name - The name or table signature to be examined. 53 1.1.1.1.2.2 skrll * Four characters, does not have to be a 54 1.1.1.1.2.2 skrll * NULL terminated string. 55 1.1.1.1.2.2 skrll * 56 1.1.1.1.2.2 skrll * RETURN: TRUE if signature is has 4 valid ACPI characters 57 1.1.1.1.2.2 skrll * 58 1.1.1.1.2.2 skrll * DESCRIPTION: Validate an ACPI table signature. 59 1.1.1.1.2.2 skrll * 60 1.1.1.1.2.2 skrll ******************************************************************************/ 61 1.1.1.1.2.2 skrll 62 1.1.1.1.2.2 skrll BOOLEAN 63 1.1.1.1.2.2 skrll AcpiUtValidNameseg ( 64 1.1.1.1.2.2 skrll char *Name) 65 1.1.1.1.2.2 skrll { 66 1.1.1.1.2.2 skrll UINT32 i; 67 1.1.1.1.2.2 skrll 68 1.1.1.1.2.2 skrll 69 1.1.1.1.2.2 skrll /* Validate each character in the signature */ 70 1.1.1.1.2.2 skrll 71 1.1.1.1.2.2 skrll for (i = 0; i < ACPI_NAME_SIZE; i++) 72 1.1.1.1.2.2 skrll { 73 1.1.1.1.2.2 skrll if (!AcpiUtValidNameChar (Name[i], i)) 74 1.1.1.1.2.2 skrll { 75 1.1.1.1.2.2 skrll return (FALSE); 76 1.1.1.1.2.2 skrll } 77 1.1.1.1.2.2 skrll } 78 1.1.1.1.2.2 skrll 79 1.1.1.1.2.2 skrll return (TRUE); 80 1.1.1.1.2.2 skrll } 81 1.1.1.1.2.2 skrll 82 1.1.1.1.2.2 skrll 83 1.1.1.1.2.2 skrll /******************************************************************************* 84 1.1.1.1.2.2 skrll * 85 1.1.1.1.2.2 skrll * FUNCTION: AcpiUtValidNameChar 86 1.1.1.1.2.2 skrll * 87 1.1.1.1.2.2 skrll * PARAMETERS: Char - The character to be examined 88 1.1.1.1.2.2 skrll * Position - Byte position (0-3) 89 1.1.1.1.2.2 skrll * 90 1.1.1.1.2.2 skrll * RETURN: TRUE if the character is valid, FALSE otherwise 91 1.1.1.1.2.2 skrll * 92 1.1.1.1.2.2 skrll * DESCRIPTION: Check for a valid ACPI character. Must be one of: 93 1.1.1.1.2.2 skrll * 1) Upper case alpha 94 1.1.1.1.2.2 skrll * 2) numeric 95 1.1.1.1.2.2 skrll * 3) underscore 96 1.1.1.1.2.2 skrll * 97 1.1.1.1.2.2 skrll * We allow a '!' as the last character because of the ASF! table 98 1.1.1.1.2.2 skrll * 99 1.1.1.1.2.2 skrll ******************************************************************************/ 100 1.1.1.1.2.2 skrll 101 1.1.1.1.2.2 skrll BOOLEAN 102 1.1.1.1.2.2 skrll AcpiUtValidNameChar ( 103 1.1.1.1.2.2 skrll char Character, 104 1.1.1.1.2.2 skrll UINT32 Position) 105 1.1.1.1.2.2 skrll { 106 1.1.1.1.2.2 skrll 107 1.1.1.1.2.2 skrll if (!((Character >= 'A' && Character <= 'Z') || 108 1.1.1.1.2.2 skrll (Character >= '0' && Character <= '9') || 109 1.1.1.1.2.2 skrll (Character == '_'))) 110 1.1.1.1.2.2 skrll { 111 1.1.1.1.2.2 skrll /* Allow a '!' in the last position */ 112 1.1.1.1.2.2 skrll 113 1.1.1.1.2.2 skrll if (Character == '!' && Position == 3) 114 1.1.1.1.2.2 skrll { 115 1.1.1.1.2.2 skrll return (TRUE); 116 1.1.1.1.2.2 skrll } 117 1.1.1.1.2.2 skrll 118 1.1.1.1.2.2 skrll return (FALSE); 119 1.1.1.1.2.2 skrll } 120 1.1.1.1.2.2 skrll 121 1.1.1.1.2.2 skrll return (TRUE); 122 1.1.1.1.2.2 skrll } 123 1.1.1.1.2.2 skrll 124 1.1.1.1.2.2 skrll 125 1.1.1.1.2.2 skrll /******************************************************************************* 126 1.1.1.1.2.2 skrll * 127 1.1.1.1.2.2 skrll * FUNCTION: AcpiUtCheckAndRepairAscii 128 1.1.1.1.2.2 skrll * 129 1.1.1.1.2.2 skrll * PARAMETERS: Name - Ascii string 130 1.1.1.1.2.2 skrll * Count - Number of characters to check 131 1.1.1.1.2.2 skrll * 132 1.1.1.1.2.2 skrll * RETURN: None 133 1.1.1.1.2.2 skrll * 134 1.1.1.1.2.2 skrll * DESCRIPTION: Ensure that the requested number of characters are printable 135 1.1.1.1.2.2 skrll * Ascii characters. Sets non-printable and null chars to <space>. 136 1.1.1.1.2.2 skrll * 137 1.1.1.1.2.2 skrll ******************************************************************************/ 138 1.1.1.1.2.2 skrll 139 1.1.1.1.2.2 skrll void 140 1.1.1.1.2.2 skrll AcpiUtCheckAndRepairAscii ( 141 1.1.1.1.2.2 skrll UINT8 *Name, 142 1.1.1.1.2.2 skrll char *RepairedName, 143 1.1.1.1.2.2 skrll UINT32 Count) 144 1.1.1.1.2.2 skrll { 145 1.1.1.1.2.2 skrll UINT32 i; 146 1.1.1.1.2.2 skrll 147 1.1.1.1.2.2 skrll 148 1.1.1.1.2.2 skrll for (i = 0; i < Count; i++) 149 1.1.1.1.2.2 skrll { 150 1.1.1.1.2.2 skrll RepairedName[i] = (char) Name[i]; 151 1.1.1.1.2.2 skrll 152 1.1.1.1.2.2 skrll if (!Name[i]) 153 1.1.1.1.2.2 skrll { 154 1.1.1.1.2.2 skrll return; 155 1.1.1.1.2.2 skrll } 156 1.1.1.1.2.2 skrll if (!isprint (Name[i])) 157 1.1.1.1.2.2 skrll { 158 1.1.1.1.2.2 skrll RepairedName[i] = ' '; 159 1.1.1.1.2.2 skrll } 160 1.1.1.1.2.2 skrll } 161 1.1.1.1.2.2 skrll } 162
Indexes created Wed Oct 01 19:09:53 GMT 2025