1 /****************************************************************************** 2 * 3 * Module Name: dtutils.c - Utility routines for the data table compiler 4 * 5 *****************************************************************************/ 6 7 /****************************************************************************** 8 * 9 * 1. Copyright Notice 10 * 11 * Some or all of this work - Copyright (c) 1999 - 2020, Intel Corp. 12 * All rights reserved. 13 * 14 * 2. License 15 * 16 * 2.1. This is your license from Intel Corp. under its intellectual property 17 * rights. You may have additional license terms from the party that provided 18 * you this software, covering your right to use that party's intellectual 19 * property rights. 20 * 21 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a 22 * copy of the source code appearing in this file ("Covered Code") an 23 * irrevocable, perpetual, worldwide license under Intel's copyrights in the 24 * base code distributed originally by Intel ("Original Intel Code") to copy, 25 * make derivatives, distribute, use and display any portion of the Covered 26 * Code in any form, with the right to sublicense such rights; and 27 * 28 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent 29 * license (with the right to sublicense), under only those claims of Intel 30 * patents that are infringed by the Original Intel Code, to make, use, sell, 31 * offer to sell, and import the Covered Code and derivative works thereof 32 * solely to the minimum extent necessary to exercise the above copyright 33 * license, and in no event shall the patent license extend to any additions 34 * to or modifications of the Original Intel Code. No other license or right 35 * is granted directly or by implication, estoppel or otherwise; 36 * 37 * The above copyright and patent license is granted only if the following 38 * conditions are met: 39 * 40 * 3. Conditions 41 * 42 * 3.1. Redistribution of Source with Rights to Further Distribute Source. 43 * Redistribution of source code of any substantial portion of the Covered 44 * Code or modification with rights to further distribute source must include 45 * the above Copyright Notice, the above License, this list of Conditions, 46 * and the following Disclaimer and Export Compliance provision. In addition, 47 * Licensee must cause all Covered Code to which Licensee contributes to 48 * contain a file documenting the changes Licensee made to create that Covered 49 * Code and the date of any change. Licensee must include in that file the 50 * documentation of any changes made by any predecessor Licensee. Licensee 51 * must include a prominent statement that the modification is derived, 52 * directly or indirectly, from Original Intel Code. 53 * 54 * 3.2. Redistribution of Source with no Rights to Further Distribute Source. 55 * Redistribution of source code of any substantial portion of the Covered 56 * Code or modification without rights to further distribute source must 57 * include the following Disclaimer and Export Compliance provision in the 58 * documentation and/or other materials provided with distribution. In 59 * addition, Licensee may not authorize further sublicense of source of any 60 * portion of the Covered Code, and must include terms to the effect that the 61 * license from Licensee to its licensee is limited to the intellectual 62 * property embodied in the software Licensee provides to its licensee, and 63 * not to intellectual property embodied in modifications its licensee may 64 * make. 65 * 66 * 3.3. Redistribution of Executable. Redistribution in executable form of any 67 * substantial portion of the Covered Code or modification must reproduce the 68 * above Copyright Notice, and the following Disclaimer and Export Compliance 69 * provision in the documentation and/or other materials provided with the 70 * distribution. 71 * 72 * 3.4. Intel retains all right, title, and interest in and to the Original 73 * Intel Code. 74 * 75 * 3.5. Neither the name Intel nor any other trademark owned or controlled by 76 * Intel shall be used in advertising or otherwise to promote the sale, use or 77 * other dealings in products derived from or relating to the Covered Code 78 * without prior written authorization from Intel. 79 * 80 * 4. Disclaimer and Export Compliance 81 * 82 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED 83 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE 84 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE, 85 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY 86 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY 87 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A 88 * PARTICULAR PURPOSE. 89 * 90 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES 91 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR 92 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT, 93 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY 94 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL 95 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS 96 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY 97 * LIMITED REMEDY. 98 * 99 * 4.3. Licensee shall not export, either directly or indirectly, any of this 100 * software or system incorporating such software without first obtaining any 101 * required license or other approval from the U. S. Department of Commerce or 102 * any other agency or department of the United States Government. In the 103 * event Licensee exports any such software from the United States or 104 * re-exports any such software from a foreign destination, Licensee shall 105 * ensure that the distribution and export/re-export of the software is in 106 * compliance with all laws, regulations, orders, or other restrictions of the 107 * U.S. Export Administration Regulations. Licensee agrees that neither it nor 108 * any of its subsidiaries will export/re-export any technical data, process, 109 * software, or service, directly or indirectly, to any country for which the 110 * United States government or any agency thereof requires an export license, 111 * other governmental approval, or letter of assurance, without first obtaining 112 * such license, approval or letter. 113 * 114 ***************************************************************************** 115 * 116 * Alternatively, you may choose to be licensed under the terms of the 117 * following license: 118 * 119 * Redistribution and use in source and binary forms, with or without 120 * modification, are permitted provided that the following conditions 121 * are met: 122 * 1. Redistributions of source code must retain the above copyright 123 * notice, this list of conditions, and the following disclaimer, 124 * without modification. 125 * 2. Redistributions in binary form must reproduce at minimum a disclaimer 126 * substantially similar to the "NO WARRANTY" disclaimer below 127 * ("Disclaimer") and any redistribution must be conditioned upon 128 * including a substantially similar Disclaimer requirement for further 129 * binary redistribution. 130 * 3. Neither the names of the above-listed copyright holders nor the names 131 * of any contributors may be used to endorse or promote products derived 132 * from this software without specific prior written permission. 133 * 134 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 135 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 136 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 137 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 138 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 139 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 140 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 141 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 142 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 143 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 144 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 145 * 146 * Alternatively, you may choose to be licensed under the terms of the 147 * GNU General Public License ("GPL") version 2 as published by the Free 148 * Software Foundation. 149 * 150 *****************************************************************************/ 151 152 #include <contrib/dev/acpica/compiler/aslcompiler.h> 153 #include <contrib/dev/acpica/include/actables.h> 154 155 #define _COMPONENT DT_COMPILER 156 ACPI_MODULE_NAME ("dtutils") 157 158 /* Local prototypes */ 159 160 static void 161 DtSum ( 162 DT_SUBTABLE *Subtable, 163 void *Context, 164 void *ReturnValue); 165 166 167 /****************************************************************************** 168 * 169 * FUNCTION: DtError 170 * 171 * PARAMETERS: Level - Seriousness (Warning/error, etc.) 172 * MessageId - Index into global message buffer 173 * Op - Parse node where error happened 174 * ExtraMessage - additional error message 175 * 176 * RETURN: None 177 * 178 * DESCRIPTION: Common error interface for data table compiler 179 * 180 *****************************************************************************/ 181 182 void 183 DtError ( 184 UINT8 Level, 185 UINT16 MessageId, 186 DT_FIELD *FieldObject, 187 char *ExtraMessage) 188 { 189 UINT32 Line = 0; 190 191 192 /* Field object could be NULL */ 193 194 if (FieldObject) 195 { 196 Line = FieldObject->Line; 197 } 198 199 /* Check if user wants to ignore this exception */ 200 201 if (AslIsExceptionIgnored (AslGbl_Files[ASL_FILE_INPUT].Filename, 202 Line, Level, MessageId)) 203 { 204 return; 205 } 206 207 if (FieldObject) 208 { 209 AslCommonError (Level, MessageId, 210 FieldObject->Line, 211 FieldObject->Line, 212 FieldObject->ByteOffset, 213 FieldObject->Column, 214 AslGbl_Files[ASL_FILE_INPUT].Filename, ExtraMessage); 215 } 216 else 217 { 218 AslCommonError (Level, MessageId, 0, 219 0, 0, 0, 0, ExtraMessage); 220 } 221 } 222 223 224 /****************************************************************************** 225 * 226 * FUNCTION: DtNameError 227 * 228 * PARAMETERS: Level - Seriousness (Warning/error, etc.) 229 * MessageId - Index into global message buffer 230 * Op - Parse node where error happened 231 * ExtraMessage - additional error message 232 * 233 * RETURN: None 234 * 235 * DESCRIPTION: Error interface for named objects 236 * 237 *****************************************************************************/ 238 239 void 240 DtNameError ( 241 UINT8 Level, 242 UINT16 MessageId, 243 DT_FIELD *FieldObject, 244 char *ExtraMessage) 245 { 246 247 switch (Level) 248 { 249 case ASL_WARNING2: 250 case ASL_WARNING3: 251 252 if (AslGbl_WarningLevel < Level) 253 { 254 return; 255 } 256 break; 257 258 default: 259 260 break; 261 } 262 263 if (FieldObject) 264 { 265 AslCommonError (Level, MessageId, 266 FieldObject->Line, 267 FieldObject->Line, 268 FieldObject->ByteOffset, 269 FieldObject->NameColumn, 270 AslGbl_Files[ASL_FILE_INPUT].Filename, ExtraMessage); 271 } 272 else 273 { 274 AslCommonError (Level, MessageId, 0, 275 0, 0, 0, 0, ExtraMessage); 276 } 277 } 278 279 280 /******************************************************************************* 281 * 282 * FUNCTION: DtFatal 283 * 284 * PARAMETERS: None 285 * 286 * RETURN: None 287 * 288 * DESCRIPTION: Dump the error log and abort the compiler. Used for serious 289 * compile or I/O errors 290 * 291 ******************************************************************************/ 292 293 void 294 DtFatal ( 295 UINT16 MessageId, 296 DT_FIELD *FieldObject, 297 char *ExtraMessage) 298 { 299 300 DtError (ASL_ERROR, MessageId, FieldObject, ExtraMessage); 301 302 /* 303 * TBD: remove this entire function, DtFatal 304 * 305 * We cannot abort the compiler on error, because we may be compiling a 306 * list of files. We must move on to the next file. 307 */ 308 #ifdef __OBSOLETE 309 CmCleanupAndExit (); 310 exit (1); 311 #endif 312 } 313 314 315 /******************************************************************************* 316 * 317 * FUNCTION: DtDoConstant 318 * 319 * PARAMETERS: String - Only hex constants are supported, 320 * regardless of whether the 0x prefix 321 * is used 322 * 323 * RETURN: Converted Integer 324 * 325 * DESCRIPTION: Convert a string to an integer, with overflow/error checking. 326 * 327 ******************************************************************************/ 328 329 UINT64 330 DtDoConstant ( 331 char *String) 332 { 333 UINT64 ConvertedInteger; 334 335 336 /* 337 * TBD: The ImplicitStrtoul64 function does not report overflow 338 * conditions. The input string is simply truncated. If it is 339 * desired to report overflow to the table compiler, this should 340 * somehow be added here. Note: integers that are prefixed with 0x 341 * or not are both hex integers. 342 */ 343 ConvertedInteger = AcpiUtImplicitStrtoul64 (String); 344 return (ConvertedInteger); 345 } 346 347 /****************************************************************************** 348 * 349 * FUNCTION: DtGetFieldValue 350 * 351 * PARAMETERS: Field - Current field list pointer 352 * 353 * RETURN: Field value 354 * 355 * DESCRIPTION: Get field value 356 * 357 *****************************************************************************/ 358 359 char * 360 DtGetFieldValue ( 361 DT_FIELD *Field) 362 { 363 if (!Field) 364 { 365 return (NULL); 366 } 367 368 return (Field->Value); 369 } 370 371 372 /****************************************************************************** 373 * 374 * FUNCTION: DtGetFieldType 375 * 376 * PARAMETERS: Info - Data table info 377 * 378 * RETURN: Field type 379 * 380 * DESCRIPTION: Get field type 381 * 382 *****************************************************************************/ 383 384 UINT8 385 DtGetFieldType ( 386 ACPI_DMTABLE_INFO *Info) 387 { 388 UINT8 Type; 389 390 391 /* DT_FLAG means that this is the start of a block of flag bits */ 392 /* TBD - we can make these a separate opcode later */ 393 394 if (Info->Flags & DT_FLAG) 395 { 396 return (DT_FIELD_TYPE_FLAGS_INTEGER); 397 } 398 399 /* Type is based upon the opcode for this field in the info table */ 400 401 switch (Info->Opcode) 402 { 403 case ACPI_DMT_FLAG0: 404 case ACPI_DMT_FLAG1: 405 case ACPI_DMT_FLAG2: 406 case ACPI_DMT_FLAG3: 407 case ACPI_DMT_FLAG4: 408 case ACPI_DMT_FLAG5: 409 case ACPI_DMT_FLAG6: 410 case ACPI_DMT_FLAG7: 411 case ACPI_DMT_FLAGS0: 412 case ACPI_DMT_FLAGS1: 413 case ACPI_DMT_FLAGS2: 414 case ACPI_DMT_FLAGS4: 415 case ACPI_DMT_FLAGS4_0: 416 case ACPI_DMT_FLAGS4_4: 417 case ACPI_DMT_FLAGS4_8: 418 case ACPI_DMT_FLAGS4_12: 419 case ACPI_DMT_FLAGS16_16: 420 421 Type = DT_FIELD_TYPE_FLAG; 422 break; 423 424 case ACPI_DMT_NAME4: 425 case ACPI_DMT_SIG: 426 case ACPI_DMT_NAME6: 427 case ACPI_DMT_NAME8: 428 case ACPI_DMT_STRING: 429 430 Type = DT_FIELD_TYPE_STRING; 431 break; 432 433 case ACPI_DMT_BUFFER: 434 case ACPI_DMT_RAW_BUFFER: 435 case ACPI_DMT_BUF7: 436 case ACPI_DMT_BUF10: 437 case ACPI_DMT_BUF12: 438 case ACPI_DMT_BUF16: 439 case ACPI_DMT_BUF128: 440 case ACPI_DMT_PCI_PATH: 441 442 Type = DT_FIELD_TYPE_BUFFER; 443 break; 444 445 case ACPI_DMT_GAS: 446 case ACPI_DMT_HESTNTFY: 447 case ACPI_DMT_IORTMEM: 448 449 Type = DT_FIELD_TYPE_INLINE_SUBTABLE; 450 break; 451 452 case ACPI_DMT_UNICODE: 453 454 Type = DT_FIELD_TYPE_UNICODE; 455 break; 456 457 case ACPI_DMT_UUID: 458 459 Type = DT_FIELD_TYPE_UUID; 460 break; 461 462 case ACPI_DMT_DEVICE_PATH: 463 464 Type = DT_FIELD_TYPE_DEVICE_PATH; 465 break; 466 467 case ACPI_DMT_LABEL: 468 469 Type = DT_FIELD_TYPE_LABEL; 470 break; 471 472 default: 473 474 Type = DT_FIELD_TYPE_INTEGER; 475 break; 476 } 477 478 return (Type); 479 } 480 481 482 /****************************************************************************** 483 * 484 * FUNCTION: DtGetBufferLength 485 * 486 * PARAMETERS: Buffer - List of integers, 487 * for example "10 3A 4F 2E" 488 * 489 * RETURN: Count of integer 490 * 491 * DESCRIPTION: Get length of bytes needed to store the integers 492 * 493 *****************************************************************************/ 494 495 UINT32 496 DtGetBufferLength ( 497 char *Buffer) 498 { 499 UINT32 ByteLength = 0; 500 501 502 while (*Buffer) 503 { 504 if (*Buffer == ' ') 505 { 506 ByteLength++; 507 508 while (*Buffer == ' ') 509 { 510 Buffer++; 511 } 512 } 513 514 Buffer++; 515 } 516 517 return (++ByteLength); 518 } 519 520 521 /****************************************************************************** 522 * 523 * FUNCTION: DtGetFieldLength 524 * 525 * PARAMETERS: Field - Current field 526 * Info - Data table info 527 * 528 * RETURN: Field length 529 * 530 * DESCRIPTION: Get length of bytes needed to compile the field 531 * 532 * Note: This function must remain in sync with AcpiDmDumpTable. 533 * 534 *****************************************************************************/ 535 536 UINT32 537 DtGetFieldLength ( 538 DT_FIELD *Field, 539 ACPI_DMTABLE_INFO *Info) 540 { 541 UINT32 ByteLength = 0; 542 char *Value; 543 544 545 /* Length is based upon the opcode for this field in the info table */ 546 547 switch (Info->Opcode) 548 { 549 case ACPI_DMT_FLAG0: 550 case ACPI_DMT_FLAG1: 551 case ACPI_DMT_FLAG2: 552 case ACPI_DMT_FLAG3: 553 case ACPI_DMT_FLAG4: 554 case ACPI_DMT_FLAG5: 555 case ACPI_DMT_FLAG6: 556 case ACPI_DMT_FLAG7: 557 case ACPI_DMT_FLAGS0: 558 case ACPI_DMT_FLAGS1: 559 case ACPI_DMT_FLAGS2: 560 case ACPI_DMT_FLAGS4: 561 case ACPI_DMT_FLAGS4_0: 562 case ACPI_DMT_FLAGS4_4: 563 case ACPI_DMT_FLAGS4_8: 564 case ACPI_DMT_FLAGS4_12: 565 case ACPI_DMT_FLAGS16_16: 566 case ACPI_DMT_LABEL: 567 case ACPI_DMT_EXTRA_TEXT: 568 569 ByteLength = 0; 570 break; 571 572 case ACPI_DMT_UINT8: 573 case ACPI_DMT_CHKSUM: 574 case ACPI_DMT_SPACEID: 575 case ACPI_DMT_ACCWIDTH: 576 case ACPI_DMT_IVRS: 577 case ACPI_DMT_GTDT: 578 case ACPI_DMT_MADT: 579 case ACPI_DMT_PCCT: 580 case ACPI_DMT_PMTT: 581 case ACPI_DMT_PPTT: 582 case ACPI_DMT_SDEV: 583 case ACPI_DMT_SRAT: 584 case ACPI_DMT_ASF: 585 case ACPI_DMT_HESTNTYP: 586 case ACPI_DMT_FADTPM: 587 case ACPI_DMT_EINJACT: 588 case ACPI_DMT_EINJINST: 589 case ACPI_DMT_ERSTACT: 590 case ACPI_DMT_ERSTINST: 591 case ACPI_DMT_DMAR_SCOPE: 592 593 ByteLength = 1; 594 break; 595 596 case ACPI_DMT_UINT16: 597 case ACPI_DMT_DMAR: 598 case ACPI_DMT_HEST: 599 case ACPI_DMT_HMAT: 600 case ACPI_DMT_NFIT: 601 case ACPI_DMT_PCI_PATH: 602 603 ByteLength = 2; 604 break; 605 606 case ACPI_DMT_UINT24: 607 608 ByteLength = 3; 609 break; 610 611 case ACPI_DMT_UINT32: 612 case ACPI_DMT_NAME4: 613 case ACPI_DMT_SIG: 614 case ACPI_DMT_LPIT: 615 case ACPI_DMT_TPM2: 616 617 ByteLength = 4; 618 break; 619 620 case ACPI_DMT_UINT40: 621 622 ByteLength = 5; 623 break; 624 625 case ACPI_DMT_UINT48: 626 case ACPI_DMT_NAME6: 627 628 ByteLength = 6; 629 break; 630 631 case ACPI_DMT_UINT56: 632 case ACPI_DMT_BUF7: 633 634 ByteLength = 7; 635 break; 636 637 case ACPI_DMT_UINT64: 638 case ACPI_DMT_NAME8: 639 640 ByteLength = 8; 641 break; 642 643 case ACPI_DMT_STRING: 644 645 Value = DtGetFieldValue (Field); 646 if (Value) 647 { 648 ByteLength = strlen (Value) + 1; 649 } 650 else 651 { /* At this point, this is a fatal error */ 652 653 sprintf (AslGbl_MsgBuffer, "Expected \"%s\"", Info->Name); 654 DtFatal (ASL_MSG_COMPILER_INTERNAL, NULL, AslGbl_MsgBuffer); 655 return (0); 656 } 657 break; 658 659 case ACPI_DMT_GAS: 660 661 ByteLength = sizeof (ACPI_GENERIC_ADDRESS); 662 break; 663 664 case ACPI_DMT_HESTNTFY: 665 666 ByteLength = sizeof (ACPI_HEST_NOTIFY); 667 break; 668 669 case ACPI_DMT_IORTMEM: 670 671 ByteLength = sizeof (ACPI_IORT_MEMORY_ACCESS); 672 break; 673 674 case ACPI_DMT_BUFFER: 675 case ACPI_DMT_RAW_BUFFER: 676 677 Value = DtGetFieldValue (Field); 678 if (Value) 679 { 680 ByteLength = DtGetBufferLength (Value); 681 } 682 else 683 { /* At this point, this is a fatal error */ 684 685 sprintf (AslGbl_MsgBuffer, "Expected \"%s\"", Info->Name); 686 DtFatal (ASL_MSG_COMPILER_INTERNAL, NULL, AslGbl_MsgBuffer); 687 return (0); 688 } 689 break; 690 691 case ACPI_DMT_BUF10: 692 693 ByteLength = 10; 694 break; 695 696 case ACPI_DMT_BUF12: 697 698 ByteLength = 12; 699 break; 700 701 case ACPI_DMT_BUF16: 702 case ACPI_DMT_UUID: 703 704 ByteLength = 16; 705 break; 706 707 case ACPI_DMT_BUF128: 708 709 ByteLength = 128; 710 break; 711 712 case ACPI_DMT_UNICODE: 713 714 Value = DtGetFieldValue (Field); 715 716 /* TBD: error if Value is NULL? (as below?) */ 717 718 ByteLength = (strlen (Value) + 1) * sizeof(UINT16); 719 break; 720 721 default: 722 723 DtFatal (ASL_MSG_COMPILER_INTERNAL, Field, "Invalid table opcode"); 724 return (0); 725 } 726 727 return (ByteLength); 728 } 729 730 731 /****************************************************************************** 732 * 733 * FUNCTION: DtSum 734 * 735 * PARAMETERS: DT_WALK_CALLBACK: 736 * Subtable - Subtable 737 * Context - Unused 738 * ReturnValue - Store the checksum of subtable 739 * 740 * RETURN: Status 741 * 742 * DESCRIPTION: Get the checksum of subtable 743 * 744 *****************************************************************************/ 745 746 static void 747 DtSum ( 748 DT_SUBTABLE *Subtable, 749 void *Context, 750 void *ReturnValue) 751 { 752 UINT8 Checksum; 753 UINT8 *Sum = ReturnValue; 754 755 756 Checksum = AcpiTbChecksum (Subtable->Buffer, Subtable->Length); 757 *Sum = (UINT8) (*Sum + Checksum); 758 } 759 760 761 /****************************************************************************** 762 * 763 * FUNCTION: DtSetTableChecksum 764 * 765 * PARAMETERS: ChecksumPointer - Where to return the checksum 766 * 767 * RETURN: None 768 * 769 * DESCRIPTION: Set checksum of the whole data table into the checksum field 770 * 771 *****************************************************************************/ 772 773 void 774 DtSetTableChecksum ( 775 UINT8 *ChecksumPointer) 776 { 777 UINT8 Checksum = 0; 778 UINT8 OldSum; 779 780 781 DtWalkTableTree (AslGbl_RootTable, DtSum, NULL, &Checksum); 782 783 OldSum = *ChecksumPointer; 784 Checksum = (UINT8) (Checksum - OldSum); 785 786 /* Compute the final checksum */ 787 788 Checksum = (UINT8) (0 - Checksum); 789 *ChecksumPointer = Checksum; 790 } 791 792 793 /****************************************************************************** 794 * 795 * FUNCTION: DtSetTableLength 796 * 797 * PARAMETERS: None 798 * 799 * RETURN: None 800 * 801 * DESCRIPTION: Walk the subtables and set all the length fields 802 * 803 *****************************************************************************/ 804 805 void 806 DtSetTableLength ( 807 void) 808 { 809 DT_SUBTABLE *ParentTable; 810 DT_SUBTABLE *ChildTable; 811 812 813 ParentTable = AslGbl_RootTable; 814 ChildTable = NULL; 815 816 if (!ParentTable) 817 { 818 return; 819 } 820 821 DtSetSubtableLength (ParentTable); 822 823 while (1) 824 { 825 ChildTable = DtGetNextSubtable (ParentTable, ChildTable); 826 if (ChildTable) 827 { 828 if (ChildTable->LengthField) 829 { 830 DtSetSubtableLength (ChildTable); 831 } 832 833 if (ChildTable->Child) 834 { 835 ParentTable = ChildTable; 836 ChildTable = NULL; 837 } 838 else 839 { 840 ParentTable->TotalLength += ChildTable->TotalLength; 841 if (ParentTable->LengthField) 842 { 843 DtSetSubtableLength (ParentTable); 844 } 845 } 846 } 847 else 848 { 849 ChildTable = ParentTable; 850 851 if (ChildTable == AslGbl_RootTable) 852 { 853 break; 854 } 855 856 ParentTable = DtGetParentSubtable (ParentTable); 857 858 ParentTable->TotalLength += ChildTable->TotalLength; 859 if (ParentTable->LengthField) 860 { 861 DtSetSubtableLength (ParentTable); 862 } 863 } 864 } 865 } 866 867 868 /****************************************************************************** 869 * 870 * FUNCTION: DtWalkTableTree 871 * 872 * PARAMETERS: StartTable - Subtable in the tree where walking begins 873 * UserFunction - Called during the walk 874 * Context - Passed to user function 875 * ReturnValue - The return value of UserFunction 876 * 877 * RETURN: None 878 * 879 * DESCRIPTION: Performs a depth-first walk of the subtable tree 880 * 881 *****************************************************************************/ 882 883 void 884 DtWalkTableTree ( 885 DT_SUBTABLE *StartTable, 886 DT_WALK_CALLBACK UserFunction, 887 void *Context, 888 void *ReturnValue) 889 { 890 DT_SUBTABLE *ParentTable; 891 DT_SUBTABLE *ChildTable; 892 893 894 ParentTable = StartTable; 895 ChildTable = NULL; 896 897 if (!ParentTable) 898 { 899 return; 900 } 901 902 UserFunction (ParentTable, Context, ReturnValue); 903 904 while (1) 905 { 906 ChildTable = DtGetNextSubtable (ParentTable, ChildTable); 907 if (ChildTable) 908 { 909 UserFunction (ChildTable, Context, ReturnValue); 910 911 if (ChildTable->Child) 912 { 913 ParentTable = ChildTable; 914 ChildTable = NULL; 915 } 916 } 917 else 918 { 919 ChildTable = ParentTable; 920 if (ChildTable == AslGbl_RootTable) 921 { 922 break; 923 } 924 925 ParentTable = DtGetParentSubtable (ParentTable); 926 927 if (ChildTable->Peer == StartTable) 928 { 929 break; 930 } 931 } 932 } 933 } 934