1 /****************************************************************************** 2 * 3 * Module Name: asluuid-- compiler UUID support 4 * 5 *****************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2012, 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 45 #include <contrib/dev/acpica/compiler/aslcompiler.h> 46 47 #define _COMPONENT ACPI_COMPILER 48 ACPI_MODULE_NAME ("asluuid") 49 50 51 /* 52 * UUID support functions. 53 * 54 * This table is used to convert an input UUID ascii string to a 16 byte 55 * buffer and the reverse. The table maps a UUID buffer index 0-15 to 56 * the index within the 36-byte UUID string where the associated 2-byte 57 * hex value can be found. 58 * 59 * 36-byte UUID strings are of the form: 60 * aabbccdd-eeff-gghh-iijj-kkllmmnnoopp 61 * Where aa-pp are one byte hex numbers, made up of two hex digits 62 * 63 * Note: This table is basically the inverse of the string-to-offset table 64 * found in the ACPI spec in the description of the ToUUID macro. 65 */ 66 static UINT8 Gbl_MapToUuidOffset[16] = 67 { 68 6,4,2,0,11,9,16,14,19,21,24,26,28,30,32,34 69 }; 70 71 #define UUID_BUFFER_LENGTH 16 72 #define UUID_STRING_LENGTH 36 73 74 /* Positions for required hyphens (dashes) in UUID strings */ 75 76 #define UUID_HYPHEN1_OFFSET 8 77 #define UUID_HYPHEN2_OFFSET 13 78 #define UUID_HYPHEN3_OFFSET 18 79 #define UUID_HYPHEN4_OFFSET 23 80 81 82 /******************************************************************************* 83 * 84 * FUNCTION: AuValiduateUuid 85 * 86 * PARAMETERS: InString - 36-byte formatted UUID string 87 * 88 * RETURN: Status 89 * 90 * DESCRIPTION: Check all 36 characters for correct format 91 * 92 ******************************************************************************/ 93 94 ACPI_STATUS 95 AuValidateUuid ( 96 char *InString) 97 { 98 UINT32 i; 99 100 101 if (!InString || (ACPI_STRLEN (InString) != UUID_STRING_LENGTH)) 102 { 103 return (AE_BAD_PARAMETER); 104 } 105 106 /* Check all 36 characters for correct format */ 107 108 for (i = 0; i < UUID_STRING_LENGTH; i++) 109 { 110 /* Must have 4 hyphens (dashes) in these positions: */ 111 112 if ((i == UUID_HYPHEN1_OFFSET) || 113 (i == UUID_HYPHEN2_OFFSET) || 114 (i == UUID_HYPHEN3_OFFSET) || 115 (i == UUID_HYPHEN4_OFFSET)) 116 { 117 if (InString[i] != '-') 118 { 119 return (AE_BAD_PARAMETER); 120 } 121 } 122 123 /* All other positions must contain hex digits */ 124 125 else 126 { 127 if (!isxdigit ((int) InString[i])) 128 { 129 return (AE_BAD_PARAMETER); 130 } 131 } 132 } 133 134 return (AE_OK); 135 } 136 137 138 /******************************************************************************* 139 * 140 * FUNCTION: AuConvertStringToUuid 141 * 142 * PARAMETERS: InString - 36-byte formatted UUID string 143 * UuidBuffer - 16-byte UUID buffer 144 * 145 * RETURN: Status 146 * 147 * DESCRIPTION: Convert 36-byte formatted UUID string to 16-byte UUID buffer 148 * 149 ******************************************************************************/ 150 151 ACPI_STATUS 152 AuConvertStringToUuid ( 153 char *InString, 154 char *UuidBuffer) 155 { 156 UINT32 i; 157 158 159 if (!InString || !UuidBuffer) 160 { 161 return (AE_BAD_PARAMETER); 162 } 163 164 for (i = 0; i < UUID_BUFFER_LENGTH; i++) 165 { 166 UuidBuffer[i] = (char) (UtHexCharToValue (InString[Gbl_MapToUuidOffset[i]]) << 4); 167 UuidBuffer[i] |= (char) UtHexCharToValue (InString[Gbl_MapToUuidOffset[i] + 1]); 168 } 169 170 return (AE_OK); 171 } 172 173 174 /******************************************************************************* 175 * 176 * FUNCTION: AuConvertUuidToString 177 * 178 * PARAMETERS: UuidBuffer - 16-byte UUID buffer 179 * OutString - 36-byte formatted UUID string 180 * 181 * RETURN: Status 182 * 183 * DESCRIPTION: Convert 16-byte UUID buffer to 36-byte formatted UUID string 184 * OutString must be 37 bytes to include null terminator. 185 * 186 ******************************************************************************/ 187 188 ACPI_STATUS 189 AuConvertUuidToString ( 190 char *UuidBuffer, 191 char *OutString) 192 { 193 UINT32 i; 194 195 196 if (!UuidBuffer || !OutString) 197 { 198 return (AE_BAD_PARAMETER); 199 } 200 201 for (i = 0; i < UUID_BUFFER_LENGTH; i++) 202 { 203 OutString[Gbl_MapToUuidOffset[i]] = (UINT8) AslHexLookup[(UuidBuffer[i] >> 4) & 0xF]; 204 OutString[Gbl_MapToUuidOffset[i] + 1] = (UINT8) AslHexLookup[UuidBuffer[i] & 0xF]; 205 } 206 207 /* Insert required hyphens (dashes) */ 208 209 OutString[UUID_HYPHEN1_OFFSET] = 210 OutString[UUID_HYPHEN2_OFFSET] = 211 OutString[UUID_HYPHEN3_OFFSET] = 212 OutString[UUID_HYPHEN4_OFFSET] = '-'; 213 214 OutString[UUID_STRING_LENGTH] = 0; /* Null terminate */ 215 return (AE_OK); 216 } 217