1 /****************************************************************************** 2 * 3 * Module Name: prutils - Preprocessor utilities 4 * 5 *****************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2013, 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 "aslcompiler.h" 45 #include "dtcompiler.h" 46 47 48 #define _COMPONENT ASL_PREPROCESSOR 49 ACPI_MODULE_NAME ("prutils") 50 51 52 /****************************************************************************** 53 * 54 * FUNCTION: PrGetNextToken 55 * 56 * PARAMETERS: Buffer - Current line buffer 57 * MatchString - String with valid token delimiters 58 * Next - Set to next possible token in buffer 59 * 60 * RETURN: Next token (null-terminated). Modifies the input line. 61 * Remainder of line is stored in *Next. 62 * 63 * DESCRIPTION: Local implementation of strtok() with local storage for the 64 * next pointer. Not only thread-safe, but allows multiple 65 * parsing of substrings such as expressions. 66 * 67 *****************************************************************************/ 68 69 char * 70 PrGetNextToken ( 71 char *Buffer, 72 char *MatchString, 73 char **Next) 74 { 75 char *TokenStart; 76 77 78 if (!Buffer) 79 { 80 /* Use Next if it is valid */ 81 82 Buffer = *Next; 83 if (!(*Next)) 84 { 85 return (NULL); 86 } 87 } 88 89 /* Skip any leading delimiters */ 90 91 while (*Buffer) 92 { 93 if (strchr (MatchString, *Buffer)) 94 { 95 Buffer++; 96 } 97 else 98 { 99 break; 100 } 101 } 102 103 /* Anything left on the line? */ 104 105 if (!(*Buffer)) 106 { 107 *Next = NULL; 108 return (NULL); 109 } 110 111 TokenStart = Buffer; 112 113 /* Find the end of this token */ 114 115 while (*Buffer) 116 { 117 if (strchr (MatchString, *Buffer)) 118 { 119 *Buffer = 0; 120 *Next = Buffer+1; 121 if (!**Next) 122 { 123 *Next = NULL; 124 } 125 return (TokenStart); 126 } 127 Buffer++; 128 } 129 130 *Next = NULL; 131 return (TokenStart); 132 } 133 134 135 /******************************************************************************* 136 * 137 * FUNCTION: PrError 138 * 139 * PARAMETERS: Level - Seriousness (Warning/error, etc.) 140 * MessageId - Index into global message buffer 141 * Column - Column in current line 142 * 143 * RETURN: None 144 * 145 * DESCRIPTION: Preprocessor error reporting. Front end to AslCommonError2 146 * 147 ******************************************************************************/ 148 149 void 150 PrError ( 151 UINT8 Level, 152 UINT8 MessageId, 153 UINT32 Column) 154 { 155 #if 0 156 AcpiOsPrintf ("%s (%u) : %s", Gbl_Files[ASL_FILE_INPUT].Filename, 157 Gbl_CurrentLineNumber, Gbl_CurrentLineBuffer); 158 #endif 159 160 161 if (Column > 120) 162 { 163 Column = 0; 164 } 165 166 /* TBD: Need Logical line number? */ 167 168 AslCommonError2 (Level, MessageId, 169 Gbl_CurrentLineNumber, Column, 170 Gbl_CurrentLineBuffer, 171 Gbl_Files[ASL_FILE_INPUT].Filename, "Preprocessor"); 172 173 Gbl_PreprocessorError = TRUE; 174 } 175 176 177 /******************************************************************************* 178 * 179 * FUNCTION: PrReplaceData 180 * 181 * PARAMETERS: Buffer - Original(target) buffer pointer 182 * LengthToRemove - Length to be removed from target buffer 183 * BufferToAdd - Data to be inserted into target buffer 184 * LengthToAdd - Length of BufferToAdd 185 * 186 * RETURN: None 187 * 188 * DESCRIPTION: Generic buffer data replacement. 189 * 190 ******************************************************************************/ 191 192 void 193 PrReplaceData ( 194 char *Buffer, 195 UINT32 LengthToRemove, 196 char *BufferToAdd, 197 UINT32 LengthToAdd) 198 { 199 UINT32 BufferLength; 200 201 202 /* Buffer is a string, so the length must include the terminating zero */ 203 204 BufferLength = strlen (Buffer) + 1; 205 206 if (LengthToRemove != LengthToAdd) 207 { 208 /* 209 * Move some of the existing data 210 * 1) If adding more bytes than removing, make room for the new data 211 * 2) if removing more bytes than adding, delete the extra space 212 */ 213 if (LengthToRemove > 0) 214 { 215 memmove ((Buffer + LengthToAdd), (Buffer + LengthToRemove), 216 (BufferLength - LengthToRemove)); 217 } 218 } 219 220 /* Now we can move in the new data */ 221 222 if (LengthToAdd > 0) 223 { 224 memmove (Buffer, BufferToAdd, LengthToAdd); 225 } 226 } 227 228 229 /******************************************************************************* 230 * 231 * FUNCTION: PrOpenIncludeFile 232 * 233 * PARAMETERS: Filename - Filename or pathname for include file 234 * 235 * RETURN: None. 236 * 237 * DESCRIPTION: Open an include file and push it on the input file stack. 238 * 239 ******************************************************************************/ 240 241 void 242 PrOpenIncludeFile ( 243 char *Filename) 244 { 245 FILE *IncludeFile; 246 ASL_INCLUDE_DIR *NextDir; 247 248 249 /* Start the actual include file on the next line */ 250 251 Gbl_CurrentLineOffset++; 252 253 /* Attempt to open the include file */ 254 /* If the file specifies an absolute path, just open it */ 255 256 if ((Filename[0] == '/') || 257 (Filename[0] == '\\') || 258 (Filename[1] == ':')) 259 { 260 IncludeFile = PrOpenIncludeWithPrefix ("", Filename); 261 if (!IncludeFile) 262 { 263 goto ErrorExit; 264 } 265 return; 266 } 267 268 /* 269 * The include filename is not an absolute path. 270 * 271 * First, search for the file within the "local" directory -- meaning 272 * the same directory that contains the source file. 273 * 274 * Construct the file pathname from the global directory name. 275 */ 276 IncludeFile = PrOpenIncludeWithPrefix (Gbl_DirectoryPath, Filename); 277 if (IncludeFile) 278 { 279 return; 280 } 281 282 /* 283 * Second, search for the file within the (possibly multiple) 284 * directories specified by the -I option on the command line. 285 */ 286 NextDir = Gbl_IncludeDirList; 287 while (NextDir) 288 { 289 IncludeFile = PrOpenIncludeWithPrefix (NextDir->Dir, Filename); 290 if (IncludeFile) 291 { 292 return; 293 } 294 295 NextDir = NextDir->Next; 296 } 297 298 /* We could not open the include file after trying very hard */ 299 300 ErrorExit: 301 snprintf (Gbl_MainTokenBuffer, ASL_DEFAULT_LINE_BUFFER_SIZE, "%s, %s", 302 Filename, strerror (errno)); 303 PrError (ASL_ERROR, ASL_MSG_INCLUDE_FILE_OPEN, 0); 304 } 305 306 307 /******************************************************************************* 308 * 309 * FUNCTION: FlOpenIncludeWithPrefix 310 * 311 * PARAMETERS: PrefixDir - Prefix directory pathname. Can be a zero 312 * length string. 313 * Filename - The include filename from the source ASL. 314 * 315 * RETURN: Valid file descriptor if successful. Null otherwise. 316 * 317 * DESCRIPTION: Open an include file and push it on the input file stack. 318 * 319 ******************************************************************************/ 320 321 FILE * 322 PrOpenIncludeWithPrefix ( 323 char *PrefixDir, 324 char *Filename) 325 { 326 FILE *IncludeFile; 327 char *Pathname; 328 329 330 /* Build the full pathname to the file */ 331 332 Pathname = FlMergePathnames (PrefixDir, Filename); 333 334 DbgPrint (ASL_PARSE_OUTPUT, PR_PREFIX_ID 335 "Include: Opening file - \"%s\"\n", 336 Gbl_CurrentLineNumber, Pathname); 337 338 /* Attempt to open the file, push if successful */ 339 340 IncludeFile = fopen (Pathname, "r"); 341 if (!IncludeFile) 342 { 343 fprintf (stderr, "Could not open include file %s\n", Pathname); 344 ACPI_FREE (Pathname); 345 return (NULL); 346 } 347 348 /* Push the include file on the open input file stack */ 349 350 PrPushInputFileStack (IncludeFile, Pathname); 351 return (IncludeFile); 352 } 353 354 355 /******************************************************************************* 356 * 357 * FUNCTION: AslPushInputFileStack 358 * 359 * PARAMETERS: InputFile - Open file pointer 360 * Filename - Name of the file 361 * 362 * RETURN: None 363 * 364 * DESCRIPTION: Push the InputFile onto the file stack, and point the parser 365 * to this file. Called when an include file is successfully 366 * opened. 367 * 368 ******************************************************************************/ 369 370 void 371 PrPushInputFileStack ( 372 FILE *InputFile, 373 char *Filename) 374 { 375 PR_FILE_NODE *Fnode; 376 377 378 /* Save the current state in an Fnode */ 379 380 Fnode = UtLocalCalloc (sizeof (PR_FILE_NODE)); 381 382 Fnode->File = Gbl_Files[ASL_FILE_INPUT].Handle; 383 Fnode->Next = Gbl_InputFileList; 384 Fnode->Filename = Gbl_Files[ASL_FILE_INPUT].Filename; 385 Fnode->CurrentLineNumber = Gbl_CurrentLineNumber; 386 387 /* Push it on the stack */ 388 389 Gbl_InputFileList = Fnode; 390 391 DbgPrint (ASL_PARSE_OUTPUT, PR_PREFIX_ID 392 "Push InputFile Stack: handle %p\n\n", 393 Gbl_CurrentLineNumber, InputFile); 394 395 /* Reset the global line count and filename */ 396 397 Gbl_Files[ASL_FILE_INPUT].Filename = Filename; 398 Gbl_Files[ASL_FILE_INPUT].Handle = InputFile; 399 Gbl_PreviousLineNumber = 0; 400 Gbl_CurrentLineNumber = 0; 401 402 /* Emit a new #line directive for the include file */ 403 404 FlPrintFile (ASL_FILE_PREPROCESSOR, "#line %u \"%s\"\n", 405 1, Filename); 406 } 407 408 409 /******************************************************************************* 410 * 411 * FUNCTION: AslPopInputFileStack 412 * 413 * PARAMETERS: None 414 * 415 * RETURN: 0 if a node was popped, -1 otherwise 416 * 417 * DESCRIPTION: Pop the top of the input file stack and point the parser to 418 * the saved parse buffer contained in the fnode. Also, set the 419 * global line counters to the saved values. This function is 420 * called when an include file reaches EOF. 421 * 422 ******************************************************************************/ 423 424 BOOLEAN 425 PrPopInputFileStack ( 426 void) 427 { 428 PR_FILE_NODE *Fnode; 429 430 431 Fnode = Gbl_InputFileList; 432 DbgPrint (ASL_PARSE_OUTPUT, "\n" PR_PREFIX_ID 433 "Pop InputFile Stack, Fnode %p\n\n", 434 Gbl_CurrentLineNumber, Fnode); 435 436 if (!Fnode) 437 { 438 return (FALSE); 439 } 440 441 /* Close the current include file */ 442 443 fclose (Gbl_Files[ASL_FILE_INPUT].Handle); 444 445 /* Update the top-of-stack */ 446 447 Gbl_InputFileList = Fnode->Next; 448 449 /* Reset global line counter and filename */ 450 451 Gbl_Files[ASL_FILE_INPUT].Filename = Fnode->Filename; 452 Gbl_Files[ASL_FILE_INPUT].Handle = Fnode->File; 453 Gbl_CurrentLineNumber = Fnode->CurrentLineNumber; 454 Gbl_PreviousLineNumber = 0; 455 456 /* Emit a new #line directive after the include file */ 457 458 FlPrintFile (ASL_FILE_PREPROCESSOR, "#line %u \"%s\"\n", 459 Gbl_CurrentLineNumber + 1, Fnode->Filename); 460 461 /* All done with this node */ 462 463 ACPI_FREE (Fnode); 464 return (TRUE); 465 } 466