Home | History | Annotate | Line # | Download | only in disassembler
dmresrc.c revision 1.5.2.3
      1      1.1    jruoho /*******************************************************************************
      2      1.1    jruoho  *
      3      1.1    jruoho  * Module Name: dmresrc.c - Resource Descriptor disassembly
      4      1.1    jruoho  *
      5      1.1    jruoho  ******************************************************************************/
      6      1.1    jruoho 
      7      1.3    jruoho /*
      8  1.5.2.3     skrll  * Copyright (C) 2000 - 2017, Intel Corp.
      9      1.1    jruoho  * All rights reserved.
     10      1.1    jruoho  *
     11      1.3    jruoho  * Redistribution and use in source and binary forms, with or without
     12      1.3    jruoho  * modification, are permitted provided that the following conditions
     13      1.3    jruoho  * are met:
     14      1.3    jruoho  * 1. Redistributions of source code must retain the above copyright
     15      1.3    jruoho  *    notice, this list of conditions, and the following disclaimer,
     16      1.3    jruoho  *    without modification.
     17      1.3    jruoho  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18      1.3    jruoho  *    substantially similar to the "NO WARRANTY" disclaimer below
     19      1.3    jruoho  *    ("Disclaimer") and any redistribution must be conditioned upon
     20      1.3    jruoho  *    including a substantially similar Disclaimer requirement for further
     21      1.3    jruoho  *    binary redistribution.
     22      1.3    jruoho  * 3. Neither the names of the above-listed copyright holders nor the names
     23      1.3    jruoho  *    of any contributors may be used to endorse or promote products derived
     24      1.3    jruoho  *    from this software without specific prior written permission.
     25      1.3    jruoho  *
     26      1.3    jruoho  * Alternatively, this software may be distributed under the terms of the
     27      1.3    jruoho  * GNU General Public License ("GPL") version 2 as published by the Free
     28      1.3    jruoho  * Software Foundation.
     29      1.3    jruoho  *
     30      1.3    jruoho  * NO WARRANTY
     31      1.3    jruoho  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32      1.3    jruoho  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33      1.3    jruoho  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34      1.3    jruoho  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35      1.3    jruoho  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36      1.3    jruoho  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37      1.3    jruoho  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38      1.3    jruoho  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39      1.3    jruoho  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40      1.3    jruoho  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41      1.3    jruoho  * POSSIBILITY OF SUCH DAMAGES.
     42      1.3    jruoho  */
     43      1.1    jruoho 
     44      1.1    jruoho #include "acpi.h"
     45      1.1    jruoho #include "accommon.h"
     46      1.1    jruoho #include "amlcode.h"
     47      1.1    jruoho #include "acdisasm.h"
     48      1.1    jruoho 
     49      1.1    jruoho 
     50      1.1    jruoho #define _COMPONENT          ACPI_CA_DEBUGGER
     51      1.1    jruoho         ACPI_MODULE_NAME    ("dbresrc")
     52      1.1    jruoho 
     53      1.1    jruoho 
     54      1.1    jruoho /* Dispatch tables for Resource disassembly functions */
     55      1.1    jruoho 
     56      1.1    jruoho static ACPI_RESOURCE_HANDLER    AcpiGbl_DmResourceDispatch [] =
     57      1.1    jruoho {
     58      1.1    jruoho     /* Small descriptors */
     59      1.1    jruoho 
     60      1.1    jruoho     NULL,                           /* 0x00, Reserved */
     61      1.1    jruoho     NULL,                           /* 0x01, Reserved */
     62      1.1    jruoho     NULL,                           /* 0x02, Reserved */
     63      1.1    jruoho     NULL,                           /* 0x03, Reserved */
     64      1.1    jruoho     AcpiDmIrqDescriptor,            /* 0x04, ACPI_RESOURCE_NAME_IRQ_FORMAT */
     65      1.1    jruoho     AcpiDmDmaDescriptor,            /* 0x05, ACPI_RESOURCE_NAME_DMA_FORMAT */
     66      1.1    jruoho     AcpiDmStartDependentDescriptor, /* 0x06, ACPI_RESOURCE_NAME_START_DEPENDENT */
     67      1.1    jruoho     AcpiDmEndDependentDescriptor,   /* 0x07, ACPI_RESOURCE_NAME_END_DEPENDENT */
     68      1.1    jruoho     AcpiDmIoDescriptor,             /* 0x08, ACPI_RESOURCE_NAME_IO_PORT */
     69      1.1    jruoho     AcpiDmFixedIoDescriptor,        /* 0x09, ACPI_RESOURCE_NAME_FIXED_IO_PORT */
     70      1.4  christos     AcpiDmFixedDmaDescriptor,       /* 0x0A, ACPI_RESOURCE_NAME_FIXED_DMA */
     71      1.1    jruoho     NULL,                           /* 0x0B, Reserved */
     72      1.1    jruoho     NULL,                           /* 0x0C, Reserved */
     73      1.1    jruoho     NULL,                           /* 0x0D, Reserved */
     74      1.1    jruoho     AcpiDmVendorSmallDescriptor,    /* 0x0E, ACPI_RESOURCE_NAME_SMALL_VENDOR */
     75      1.1    jruoho     NULL,                           /* 0x0F, ACPI_RESOURCE_NAME_END_TAG (not used) */
     76      1.1    jruoho 
     77      1.1    jruoho     /* Large descriptors */
     78      1.1    jruoho 
     79      1.1    jruoho     NULL,                           /* 0x00, Reserved */
     80      1.1    jruoho     AcpiDmMemory24Descriptor,       /* 0x01, ACPI_RESOURCE_NAME_MEMORY_24 */
     81      1.1    jruoho     AcpiDmGenericRegisterDescriptor,/* 0x02, ACPI_RESOURCE_NAME_GENERIC_REGISTER */
     82      1.1    jruoho     NULL,                           /* 0x03, Reserved */
     83      1.1    jruoho     AcpiDmVendorLargeDescriptor,    /* 0x04, ACPI_RESOURCE_NAME_LARGE_VENDOR */
     84      1.1    jruoho     AcpiDmMemory32Descriptor,       /* 0x05, ACPI_RESOURCE_NAME_MEMORY_32 */
     85      1.1    jruoho     AcpiDmFixedMemory32Descriptor,  /* 0x06, ACPI_RESOURCE_NAME_FIXED_MEMORY_32 */
     86      1.1    jruoho     AcpiDmDwordDescriptor,          /* 0x07, ACPI_RESOURCE_NAME_DWORD_ADDRESS_SPACE */
     87      1.1    jruoho     AcpiDmWordDescriptor,           /* 0x08, ACPI_RESOURCE_NAME_WORD_ADDRESS_SPACE */
     88      1.1    jruoho     AcpiDmInterruptDescriptor,      /* 0x09, ACPI_RESOURCE_NAME_EXTENDED_XRUPT */
     89      1.1    jruoho     AcpiDmQwordDescriptor,          /* 0x0A, ACPI_RESOURCE_NAME_QWORD_ADDRESS_SPACE */
     90      1.4  christos     AcpiDmExtendedDescriptor,       /* 0x0B, ACPI_RESOURCE_NAME_EXTENDED_ADDRESS_SPACE */
     91      1.4  christos     AcpiDmGpioDescriptor,           /* 0x0C, ACPI_RESOURCE_NAME_GPIO */
     92      1.4  christos     NULL,                           /* 0x0D, Reserved */
     93      1.4  christos     AcpiDmSerialBusDescriptor       /* 0x0E, ACPI_RESOURCE_NAME_SERIAL_BUS */
     94      1.1    jruoho };
     95      1.1    jruoho 
     96      1.1    jruoho 
     97      1.1    jruoho /* Only used for single-threaded applications */
     98      1.1    jruoho /* TBD: remove when name is passed as parameter to the dump functions */
     99      1.1    jruoho 
    100      1.1    jruoho static UINT32               ResourceName;
    101      1.1    jruoho 
    102      1.1    jruoho 
    103      1.1    jruoho /*******************************************************************************
    104      1.1    jruoho  *
    105      1.1    jruoho  * FUNCTION:    AcpiDmDescriptorName
    106      1.1    jruoho  *
    107      1.1    jruoho  * PARAMETERS:  None
    108      1.1    jruoho  *
    109      1.1    jruoho  * RETURN:      None
    110      1.1    jruoho  *
    111      1.1    jruoho  * DESCRIPTION: Emit a name for the descriptor if one is present (indicated
    112      1.1    jruoho  *              by the name being changed from the default name.) A name is only
    113      1.1    jruoho  *              emitted if a reference to the descriptor has been made somewhere
    114      1.1    jruoho  *              in the original ASL code.
    115      1.1    jruoho  *
    116      1.1    jruoho  ******************************************************************************/
    117      1.1    jruoho 
    118      1.1    jruoho void
    119      1.1    jruoho AcpiDmDescriptorName (
    120      1.1    jruoho     void)
    121      1.1    jruoho {
    122      1.1    jruoho 
    123      1.1    jruoho     if (ResourceName == ACPI_DEFAULT_RESNAME)
    124      1.1    jruoho     {
    125      1.1    jruoho         return;
    126      1.1    jruoho     }
    127      1.1    jruoho 
    128      1.1    jruoho     AcpiOsPrintf ("%4.4s", (char *) &ResourceName);
    129      1.1    jruoho }
    130      1.1    jruoho 
    131      1.1    jruoho 
    132      1.1    jruoho /*******************************************************************************
    133      1.1    jruoho  *
    134      1.1    jruoho  * FUNCTION:    AcpiDmDumpInteger*
    135      1.1    jruoho  *
    136      1.1    jruoho  * PARAMETERS:  Value               - Value to emit
    137      1.1    jruoho  *              Name                - Associated name (emitted as a comment)
    138      1.1    jruoho  *
    139      1.1    jruoho  * RETURN:      None
    140      1.1    jruoho  *
    141      1.1    jruoho  * DESCRIPTION: Integer output helper functions
    142      1.1    jruoho  *
    143      1.1    jruoho  ******************************************************************************/
    144      1.1    jruoho 
    145      1.1    jruoho void
    146      1.1    jruoho AcpiDmDumpInteger8 (
    147      1.1    jruoho     UINT8                   Value,
    148      1.2    jruoho     const char              *Name)
    149      1.1    jruoho {
    150      1.1    jruoho     AcpiOsPrintf ("0x%2.2X,               // %s\n", Value, Name);
    151      1.1    jruoho }
    152      1.1    jruoho 
    153      1.1    jruoho void
    154      1.1    jruoho AcpiDmDumpInteger16 (
    155      1.1    jruoho     UINT16                  Value,
    156      1.2    jruoho     const char              *Name)
    157      1.1    jruoho {
    158      1.1    jruoho     AcpiOsPrintf ("0x%4.4X,             // %s\n", Value, Name);
    159      1.1    jruoho }
    160      1.1    jruoho 
    161      1.1    jruoho void
    162      1.1    jruoho AcpiDmDumpInteger32 (
    163      1.1    jruoho     UINT32                  Value,
    164      1.2    jruoho     const char              *Name)
    165      1.1    jruoho {
    166      1.1    jruoho     AcpiOsPrintf ("0x%8.8X,         // %s\n", Value, Name);
    167      1.1    jruoho }
    168      1.1    jruoho 
    169      1.1    jruoho void
    170      1.1    jruoho AcpiDmDumpInteger64 (
    171      1.1    jruoho     UINT64                  Value,
    172      1.2    jruoho     const char              *Name)
    173      1.1    jruoho {
    174      1.1    jruoho     AcpiOsPrintf ("0x%8.8X%8.8X, // %s\n", ACPI_FORMAT_UINT64 (Value), Name);
    175      1.1    jruoho }
    176      1.1    jruoho 
    177      1.1    jruoho 
    178      1.1    jruoho /*******************************************************************************
    179      1.1    jruoho  *
    180      1.1    jruoho  * FUNCTION:    AcpiDmBitList
    181      1.1    jruoho  *
    182      1.1    jruoho  * PARAMETERS:  Mask            - 16-bit value corresponding to 16 interrupt
    183      1.1    jruoho  *                                or DMA values
    184      1.1    jruoho  *
    185      1.1    jruoho  * RETURN:      None
    186      1.1    jruoho  *
    187      1.1    jruoho  * DESCRIPTION: Dump a bit mask as a list of individual interrupt/DMA levels.
    188      1.1    jruoho  *
    189      1.1    jruoho  ******************************************************************************/
    190      1.1    jruoho 
    191      1.1    jruoho void
    192      1.1    jruoho AcpiDmBitList (
    193      1.1    jruoho     UINT16                  Mask)
    194      1.1    jruoho {
    195      1.1    jruoho     UINT32                  i;
    196      1.1    jruoho     BOOLEAN                 Previous = FALSE;
    197      1.1    jruoho 
    198      1.1    jruoho 
    199      1.1    jruoho     /* Open the initializer list */
    200      1.1    jruoho 
    201      1.1    jruoho     AcpiOsPrintf ("{");
    202      1.1    jruoho 
    203      1.1    jruoho     /* Examine each bit */
    204      1.1    jruoho 
    205      1.1    jruoho     for (i = 0; i < 16; i++)
    206      1.1    jruoho     {
    207      1.1    jruoho         /* Only interested in bits that are set to 1 */
    208      1.1    jruoho 
    209      1.1    jruoho         if (Mask & 1)
    210      1.1    jruoho         {
    211      1.1    jruoho             if (Previous)
    212      1.1    jruoho             {
    213      1.1    jruoho                 AcpiOsPrintf (",");
    214      1.1    jruoho             }
    215  1.5.2.2     skrll 
    216      1.1    jruoho             Previous = TRUE;
    217      1.1    jruoho             AcpiOsPrintf ("%u", i);
    218      1.1    jruoho         }
    219      1.1    jruoho 
    220      1.1    jruoho         Mask >>= 1;
    221      1.1    jruoho     }
    222      1.1    jruoho 
    223      1.1    jruoho     /* Close list */
    224      1.1    jruoho 
    225      1.1    jruoho     AcpiOsPrintf ("}\n");
    226      1.1    jruoho }
    227      1.1    jruoho 
    228      1.1    jruoho 
    229      1.1    jruoho /*******************************************************************************
    230      1.1    jruoho  *
    231      1.1    jruoho  * FUNCTION:    AcpiDmResourceTemplate
    232      1.1    jruoho  *
    233      1.1    jruoho  * PARAMETERS:  Info            - Curent parse tree walk info
    234      1.1    jruoho  *              ByteData        - Pointer to the byte list data
    235      1.1    jruoho  *              ByteCount       - Length of the byte list
    236      1.1    jruoho  *
    237      1.1    jruoho  * RETURN:      None
    238      1.1    jruoho  *
    239      1.1    jruoho  * DESCRIPTION: Dump the contents of a Resource Template containing a set of
    240      1.1    jruoho  *              Resource Descriptors.
    241      1.1    jruoho  *
    242      1.1    jruoho  ******************************************************************************/
    243      1.1    jruoho 
    244      1.1    jruoho void
    245      1.1    jruoho AcpiDmResourceTemplate (
    246      1.1    jruoho     ACPI_OP_WALK_INFO       *Info,
    247      1.1    jruoho     ACPI_PARSE_OBJECT       *Op,
    248      1.1    jruoho     UINT8                   *ByteData,
    249      1.1    jruoho     UINT32                  ByteCount)
    250      1.1    jruoho {
    251      1.1    jruoho     ACPI_STATUS             Status;
    252      1.1    jruoho     UINT32                  CurrentByteOffset;
    253      1.1    jruoho     UINT8                   ResourceType;
    254      1.1    jruoho     UINT32                  ResourceLength;
    255      1.1    jruoho     void                    *Aml;
    256      1.1    jruoho     UINT32                  Level;
    257      1.1    jruoho     BOOLEAN                 DependentFns = FALSE;
    258      1.1    jruoho     UINT8                   ResourceIndex;
    259      1.1    jruoho     ACPI_NAMESPACE_NODE     *Node;
    260      1.1    jruoho 
    261      1.1    jruoho 
    262      1.5  christos     if (Op->Asl.AmlOpcode != AML_FIELD_OP)
    263      1.5  christos     {
    264      1.5  christos         Info->MappingOp = Op;
    265      1.5  christos     }
    266      1.5  christos 
    267      1.1    jruoho     Level = Info->Level;
    268      1.1    jruoho     ResourceName = ACPI_DEFAULT_RESNAME;
    269      1.1    jruoho     Node = Op->Common.Node;
    270      1.1    jruoho     if (Node)
    271      1.1    jruoho     {
    272      1.1    jruoho         Node = Node->Child;
    273      1.1    jruoho     }
    274      1.1    jruoho 
    275      1.1    jruoho     for (CurrentByteOffset = 0; CurrentByteOffset < ByteCount;)
    276      1.1    jruoho     {
    277      1.1    jruoho         Aml = &ByteData[CurrentByteOffset];
    278      1.1    jruoho 
    279      1.1    jruoho         /* Get the descriptor type and length */
    280      1.1    jruoho 
    281      1.1    jruoho         ResourceType = AcpiUtGetResourceType (Aml);
    282      1.1    jruoho         ResourceLength = AcpiUtGetResourceLength (Aml);
    283      1.1    jruoho 
    284      1.1    jruoho         /* Validate the Resource Type and Resource Length */
    285      1.1    jruoho 
    286      1.4  christos         Status = AcpiUtValidateResource (NULL, Aml, &ResourceIndex);
    287      1.1    jruoho         if (ACPI_FAILURE (Status))
    288      1.1    jruoho         {
    289  1.5.2.2     skrll             AcpiOsPrintf (
    290  1.5.2.2     skrll                 "/*** Could not validate Resource, type (%X) %s***/\n",
    291      1.1    jruoho                 ResourceType, AcpiFormatException (Status));
    292      1.1    jruoho             return;
    293      1.1    jruoho         }
    294      1.1    jruoho 
    295      1.1    jruoho         /* Point to next descriptor */
    296      1.1    jruoho 
    297      1.1    jruoho         CurrentByteOffset += AcpiUtGetDescriptorLength (Aml);
    298      1.1    jruoho 
    299      1.1    jruoho         /* Descriptor pre-processing */
    300      1.1    jruoho 
    301      1.1    jruoho         switch (ResourceType)
    302      1.1    jruoho         {
    303      1.1    jruoho         case ACPI_RESOURCE_NAME_START_DEPENDENT:
    304      1.1    jruoho 
    305      1.1    jruoho             /* Finish a previous StartDependentFns */
    306      1.1    jruoho 
    307      1.1    jruoho             if (DependentFns)
    308      1.1    jruoho             {
    309      1.1    jruoho                 Level--;
    310      1.1    jruoho                 AcpiDmIndent (Level);
    311      1.1    jruoho                 AcpiOsPrintf ("}\n");
    312      1.1    jruoho             }
    313      1.1    jruoho             break;
    314      1.1    jruoho 
    315      1.1    jruoho         case ACPI_RESOURCE_NAME_END_DEPENDENT:
    316      1.1    jruoho 
    317      1.1    jruoho             Level--;
    318      1.1    jruoho             DependentFns = FALSE;
    319      1.1    jruoho             break;
    320      1.1    jruoho 
    321      1.1    jruoho         case ACPI_RESOURCE_NAME_END_TAG:
    322      1.1    jruoho 
    323      1.1    jruoho             /* Normal exit, the resource list is finished */
    324      1.1    jruoho 
    325      1.1    jruoho             if (DependentFns)
    326      1.1    jruoho             {
    327      1.1    jruoho                 /*
    328      1.1    jruoho                  * Close an open StartDependentDescriptor. This indicates a
    329      1.1    jruoho                  * missing EndDependentDescriptor.
    330      1.1    jruoho                  */
    331      1.1    jruoho                 Level--;
    332      1.1    jruoho                 DependentFns = FALSE;
    333      1.1    jruoho 
    334      1.1    jruoho                 /* Go ahead and insert EndDependentFn() */
    335      1.1    jruoho 
    336      1.5  christos                 AcpiDmEndDependentDescriptor (Info, Aml, ResourceLength, Level);
    337      1.1    jruoho 
    338      1.1    jruoho                 AcpiDmIndent (Level);
    339      1.1    jruoho                 AcpiOsPrintf (
    340  1.5.2.2     skrll                     "/*** Disassembler: inserted "
    341  1.5.2.2     skrll                     "missing EndDependentFn () ***/\n");
    342      1.1    jruoho             }
    343      1.1    jruoho             return;
    344      1.1    jruoho 
    345      1.1    jruoho         default:
    346      1.4  christos 
    347      1.1    jruoho             break;
    348      1.1    jruoho         }
    349      1.1    jruoho 
    350      1.1    jruoho         /* Disassemble the resource structure */
    351      1.1    jruoho 
    352      1.1    jruoho         if (Node)
    353      1.1    jruoho         {
    354      1.1    jruoho             ResourceName = Node->Name.Integer;
    355      1.1    jruoho             Node = Node->Peer;
    356      1.1    jruoho         }
    357      1.1    jruoho 
    358      1.1    jruoho         AcpiGbl_DmResourceDispatch [ResourceIndex] (
    359      1.5  christos             Info, Aml, ResourceLength, Level);
    360      1.1    jruoho 
    361      1.1    jruoho         /* Descriptor post-processing */
    362      1.1    jruoho 
    363      1.1    jruoho         if (ResourceType == ACPI_RESOURCE_NAME_START_DEPENDENT)
    364      1.1    jruoho         {
    365      1.1    jruoho             DependentFns = TRUE;
    366      1.1    jruoho             Level++;
    367      1.1    jruoho         }
    368      1.1    jruoho     }
    369      1.1    jruoho }
    370      1.1    jruoho 
    371      1.1    jruoho 
    372      1.1    jruoho /*******************************************************************************
    373      1.1    jruoho  *
    374      1.1    jruoho  * FUNCTION:    AcpiDmIsResourceTemplate
    375      1.1    jruoho  *
    376      1.4  christos  * PARAMETERS:  WalkState           - Current walk info
    377      1.4  christos  *              Op                  - Buffer Op to be examined
    378      1.1    jruoho  *
    379      1.1    jruoho  * RETURN:      Status. AE_OK if valid template
    380      1.1    jruoho  *
    381      1.1    jruoho  * DESCRIPTION: Walk a byte list to determine if it consists of a valid set
    382      1.4  christos  *              of resource descriptors. Nothing is output.
    383      1.1    jruoho  *
    384      1.1    jruoho  ******************************************************************************/
    385      1.1    jruoho 
    386      1.1    jruoho ACPI_STATUS
    387      1.1    jruoho AcpiDmIsResourceTemplate (
    388      1.4  christos     ACPI_WALK_STATE         *WalkState,
    389      1.1    jruoho     ACPI_PARSE_OBJECT       *Op)
    390      1.1    jruoho {
    391      1.1    jruoho     ACPI_STATUS             Status;
    392      1.1    jruoho     ACPI_PARSE_OBJECT       *NextOp;
    393      1.1    jruoho     UINT8                   *Aml;
    394      1.1    jruoho     UINT8                   *EndAml;
    395  1.5.2.3     skrll     UINT32                  BufferLength;
    396  1.5.2.3     skrll     UINT32                  DeclaredBufferLength;
    397      1.1    jruoho 
    398      1.1    jruoho 
    399      1.1    jruoho     /* This op must be a buffer */
    400      1.1    jruoho 
    401      1.1    jruoho     if (Op->Common.AmlOpcode != AML_BUFFER_OP)
    402      1.1    jruoho     {
    403      1.1    jruoho         return (AE_TYPE);
    404      1.1    jruoho     }
    405      1.1    jruoho 
    406  1.5.2.3     skrll     /*
    407  1.5.2.3     skrll      * Get the declared length of the buffer.
    408  1.5.2.3     skrll      * This is the nn in "Buffer (nn)"
    409  1.5.2.3     skrll      */
    410      1.1    jruoho     NextOp = Op->Common.Value.Arg;
    411      1.4  christos     if (!NextOp)
    412      1.4  christos     {
    413      1.4  christos         AcpiOsPrintf ("NULL byte list in buffer\n");
    414      1.4  christos         return (AE_TYPE);
    415      1.4  christos     }
    416      1.4  christos 
    417  1.5.2.3     skrll     DeclaredBufferLength = NextOp->Common.Value.Size;
    418  1.5.2.3     skrll 
    419  1.5.2.3     skrll     /* Get the length of the raw initialization byte list */
    420  1.5.2.3     skrll 
    421      1.1    jruoho     NextOp = NextOp->Common.Next;
    422      1.1    jruoho     if (!NextOp)
    423      1.1    jruoho     {
    424      1.1    jruoho         return (AE_TYPE);
    425      1.1    jruoho     }
    426      1.1    jruoho 
    427      1.1    jruoho     Aml = NextOp->Named.Data;
    428  1.5.2.3     skrll     BufferLength = NextOp->Common.Value.Size;
    429  1.5.2.3     skrll 
    430  1.5.2.3     skrll     /*
    431  1.5.2.3     skrll      * Not a template if declared buffer length != actual length of the
    432  1.5.2.3     skrll      * intialization byte list. Because the resource macros will create
    433  1.5.2.3     skrll      * a buffer of the exact required length (buffer length will be equal
    434  1.5.2.3     skrll      * to the actual length).
    435  1.5.2.3     skrll      */
    436  1.5.2.3     skrll     if (DeclaredBufferLength != BufferLength)
    437  1.5.2.3     skrll     {
    438  1.5.2.3     skrll         return (AE_TYPE);
    439  1.5.2.3     skrll     }
    440      1.1    jruoho 
    441      1.1    jruoho     /* Walk the byte list, abort on any invalid descriptor type or length */
    442      1.1    jruoho 
    443  1.5.2.3     skrll     Status = AcpiUtWalkAmlResources (WalkState, Aml, BufferLength,
    444      1.4  christos         NULL, ACPI_CAST_INDIRECT_PTR (void, &EndAml));
    445      1.1    jruoho     if (ACPI_FAILURE (Status))
    446      1.1    jruoho     {
    447      1.1    jruoho         return (AE_TYPE);
    448      1.1    jruoho     }
    449      1.1    jruoho 
    450      1.1    jruoho     /*
    451      1.1    jruoho      * For the resource template to be valid, one EndTag must appear
    452      1.1    jruoho      * at the very end of the ByteList, not before. (For proper disassembly
    453      1.1    jruoho      * of a ResourceTemplate, the buffer must not have any extra data after
    454      1.1    jruoho      * the EndTag.)
    455      1.1    jruoho      */
    456  1.5.2.3     skrll     if ((Aml + BufferLength - sizeof (AML_RESOURCE_END_TAG)) != EndAml)
    457      1.1    jruoho     {
    458      1.1    jruoho         return (AE_AML_NO_RESOURCE_END_TAG);
    459      1.1    jruoho     }
    460      1.1    jruoho 
    461      1.1    jruoho     /*
    462      1.1    jruoho      * All resource descriptors are valid, therefore this list appears
    463      1.1    jruoho      * to be a valid resource template
    464      1.1    jruoho      */
    465      1.1    jruoho     return (AE_OK);
    466      1.1    jruoho }
    467