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