Home | History | Annotate | Line # | Download | only in compiler
aslprepkg.c revision 1.2.10.2
      1  1.2.10.2  tls /******************************************************************************
      2  1.2.10.2  tls  *
      3  1.2.10.2  tls  * Module Name: aslprepkg - support for ACPI predefined name package objects
      4  1.2.10.2  tls  *
      5  1.2.10.2  tls  *****************************************************************************/
      6  1.2.10.2  tls 
      7  1.2.10.2  tls /*
      8  1.2.10.2  tls  * Copyright (C) 2000 - 2013, Intel Corp.
      9  1.2.10.2  tls  * All rights reserved.
     10  1.2.10.2  tls  *
     11  1.2.10.2  tls  * Redistribution and use in source and binary forms, with or without
     12  1.2.10.2  tls  * modification, are permitted provided that the following conditions
     13  1.2.10.2  tls  * are met:
     14  1.2.10.2  tls  * 1. Redistributions of source code must retain the above copyright
     15  1.2.10.2  tls  *    notice, this list of conditions, and the following disclaimer,
     16  1.2.10.2  tls  *    without modification.
     17  1.2.10.2  tls  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  1.2.10.2  tls  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  1.2.10.2  tls  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  1.2.10.2  tls  *    including a substantially similar Disclaimer requirement for further
     21  1.2.10.2  tls  *    binary redistribution.
     22  1.2.10.2  tls  * 3. Neither the names of the above-listed copyright holders nor the names
     23  1.2.10.2  tls  *    of any contributors may be used to endorse or promote products derived
     24  1.2.10.2  tls  *    from this software without specific prior written permission.
     25  1.2.10.2  tls  *
     26  1.2.10.2  tls  * Alternatively, this software may be distributed under the terms of the
     27  1.2.10.2  tls  * GNU General Public License ("GPL") version 2 as published by the Free
     28  1.2.10.2  tls  * Software Foundation.
     29  1.2.10.2  tls  *
     30  1.2.10.2  tls  * NO WARRANTY
     31  1.2.10.2  tls  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  1.2.10.2  tls  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  1.2.10.2  tls  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34  1.2.10.2  tls  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  1.2.10.2  tls  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  1.2.10.2  tls  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  1.2.10.2  tls  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  1.2.10.2  tls  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  1.2.10.2  tls  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  1.2.10.2  tls  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  1.2.10.2  tls  * POSSIBILITY OF SUCH DAMAGES.
     42  1.2.10.2  tls  */
     43  1.2.10.2  tls 
     44  1.2.10.2  tls #include "aslcompiler.h"
     45  1.2.10.2  tls #include "aslcompiler.y.h"
     46  1.2.10.2  tls #include "acpredef.h"
     47  1.2.10.2  tls 
     48  1.2.10.2  tls 
     49  1.2.10.2  tls #define _COMPONENT          ACPI_COMPILER
     50  1.2.10.2  tls         ACPI_MODULE_NAME    ("aslprepkg")
     51  1.2.10.2  tls 
     52  1.2.10.2  tls 
     53  1.2.10.2  tls /* Local prototypes */
     54  1.2.10.2  tls 
     55  1.2.10.2  tls static void
     56  1.2.10.2  tls ApCheckPackageElements (
     57  1.2.10.2  tls     const char                  *PredefinedName,
     58  1.2.10.2  tls     ACPI_PARSE_OBJECT           *Op,
     59  1.2.10.2  tls     UINT8                       Type1,
     60  1.2.10.2  tls     UINT32                      Count1,
     61  1.2.10.2  tls     UINT8                       Type2,
     62  1.2.10.2  tls     UINT32                      Count2);
     63  1.2.10.2  tls 
     64  1.2.10.2  tls static void
     65  1.2.10.2  tls ApCheckPackageList (
     66  1.2.10.2  tls     const char                  *PredefinedName,
     67  1.2.10.2  tls     ACPI_PARSE_OBJECT           *ParentOp,
     68  1.2.10.2  tls     const ACPI_PREDEFINED_INFO  *Package,
     69  1.2.10.2  tls     UINT32                      StartIndex,
     70  1.2.10.2  tls     UINT32                      Count);
     71  1.2.10.2  tls 
     72  1.2.10.2  tls static void
     73  1.2.10.2  tls ApPackageTooSmall (
     74  1.2.10.2  tls     const char                  *PredefinedName,
     75  1.2.10.2  tls     ACPI_PARSE_OBJECT           *Op,
     76  1.2.10.2  tls     UINT32                      Count,
     77  1.2.10.2  tls     UINT32                      ExpectedCount);
     78  1.2.10.2  tls 
     79  1.2.10.2  tls static void
     80  1.2.10.2  tls ApZeroLengthPackage (
     81  1.2.10.2  tls     const char                  *PredefinedName,
     82  1.2.10.2  tls     ACPI_PARSE_OBJECT           *Op);
     83  1.2.10.2  tls 
     84  1.2.10.2  tls static void
     85  1.2.10.2  tls ApPackageTooLarge (
     86  1.2.10.2  tls     const char                  *PredefinedName,
     87  1.2.10.2  tls     ACPI_PARSE_OBJECT           *Op,
     88  1.2.10.2  tls     UINT32                      Count,
     89  1.2.10.2  tls     UINT32                      ExpectedCount);
     90  1.2.10.2  tls 
     91  1.2.10.2  tls 
     92  1.2.10.2  tls /*******************************************************************************
     93  1.2.10.2  tls  *
     94  1.2.10.2  tls  * FUNCTION:    ApCheckPackage
     95  1.2.10.2  tls  *
     96  1.2.10.2  tls  * PARAMETERS:  ParentOp            - Parser op for the package
     97  1.2.10.2  tls  *              Predefined          - Pointer to package-specific info for
     98  1.2.10.2  tls  *                                    the method
     99  1.2.10.2  tls  *
    100  1.2.10.2  tls  * RETURN:      None
    101  1.2.10.2  tls  *
    102  1.2.10.2  tls  * DESCRIPTION: Top-level validation for predefined name return package
    103  1.2.10.2  tls  *              objects.
    104  1.2.10.2  tls  *
    105  1.2.10.2  tls  ******************************************************************************/
    106  1.2.10.2  tls 
    107  1.2.10.2  tls void
    108  1.2.10.2  tls ApCheckPackage (
    109  1.2.10.2  tls     ACPI_PARSE_OBJECT           *ParentOp,
    110  1.2.10.2  tls     const ACPI_PREDEFINED_INFO  *Predefined)
    111  1.2.10.2  tls {
    112  1.2.10.2  tls     ACPI_PARSE_OBJECT           *Op;
    113  1.2.10.2  tls     const ACPI_PREDEFINED_INFO  *Package;
    114  1.2.10.2  tls     ACPI_STATUS                 Status;
    115  1.2.10.2  tls     UINT32                      ExpectedCount;
    116  1.2.10.2  tls     UINT32                      Count;
    117  1.2.10.2  tls     UINT32                      i;
    118  1.2.10.2  tls 
    119  1.2.10.2  tls 
    120  1.2.10.2  tls     /* The package info for this name is in the next table entry */
    121  1.2.10.2  tls 
    122  1.2.10.2  tls     Package = Predefined + 1;
    123  1.2.10.2  tls 
    124  1.2.10.2  tls     /* First child is the package length */
    125  1.2.10.2  tls 
    126  1.2.10.2  tls     Op = ParentOp->Asl.Child;
    127  1.2.10.2  tls     Count = (UINT32) Op->Asl.Value.Integer;
    128  1.2.10.2  tls 
    129  1.2.10.2  tls     /*
    130  1.2.10.2  tls      * Many of the variable-length top-level packages are allowed to simply
    131  1.2.10.2  tls      * have zero elements. This allows the BIOS to tell the host that even
    132  1.2.10.2  tls      * though the predefined name/method exists, the feature is not supported.
    133  1.2.10.2  tls      * Other package types require one or more elements. In any case, there
    134  1.2.10.2  tls      * is no need to continue validation.
    135  1.2.10.2  tls      */
    136  1.2.10.2  tls     if (!Count)
    137  1.2.10.2  tls     {
    138  1.2.10.2  tls         switch (Package->RetInfo.Type)
    139  1.2.10.2  tls         {
    140  1.2.10.2  tls         case ACPI_PTYPE1_FIXED:
    141  1.2.10.2  tls         case ACPI_PTYPE1_OPTION:
    142  1.2.10.2  tls         case ACPI_PTYPE2_PKG_COUNT:
    143  1.2.10.2  tls         case ACPI_PTYPE2_REV_FIXED:
    144  1.2.10.2  tls 
    145  1.2.10.2  tls             ApZeroLengthPackage (Predefined->Info.Name, ParentOp);
    146  1.2.10.2  tls             break;
    147  1.2.10.2  tls 
    148  1.2.10.2  tls         case ACPI_PTYPE1_VAR:
    149  1.2.10.2  tls         case ACPI_PTYPE2:
    150  1.2.10.2  tls         case ACPI_PTYPE2_COUNT:
    151  1.2.10.2  tls         case ACPI_PTYPE2_FIXED:
    152  1.2.10.2  tls         case ACPI_PTYPE2_MIN:
    153  1.2.10.2  tls         case ACPI_PTYPE2_FIX_VAR:
    154  1.2.10.2  tls         default:
    155  1.2.10.2  tls 
    156  1.2.10.2  tls             break;
    157  1.2.10.2  tls         }
    158  1.2.10.2  tls 
    159  1.2.10.2  tls         return;
    160  1.2.10.2  tls     }
    161  1.2.10.2  tls 
    162  1.2.10.2  tls     /* Get the first element of the package */
    163  1.2.10.2  tls 
    164  1.2.10.2  tls     Op = Op->Asl.Next;
    165  1.2.10.2  tls 
    166  1.2.10.2  tls     /* Decode the package type */
    167  1.2.10.2  tls 
    168  1.2.10.2  tls     switch (Package->RetInfo.Type)
    169  1.2.10.2  tls     {
    170  1.2.10.2  tls     case ACPI_PTYPE1_FIXED:
    171  1.2.10.2  tls         /*
    172  1.2.10.2  tls          * The package count is fixed and there are no sub-packages
    173  1.2.10.2  tls          *
    174  1.2.10.2  tls          * If package is too small, exit.
    175  1.2.10.2  tls          * If package is larger than expected, issue warning but continue
    176  1.2.10.2  tls          */
    177  1.2.10.2  tls         ExpectedCount = Package->RetInfo.Count1 + Package->RetInfo.Count2;
    178  1.2.10.2  tls         if (Count < ExpectedCount)
    179  1.2.10.2  tls         {
    180  1.2.10.2  tls             goto PackageTooSmall;
    181  1.2.10.2  tls         }
    182  1.2.10.2  tls         else if (Count > ExpectedCount)
    183  1.2.10.2  tls         {
    184  1.2.10.2  tls             ApPackageTooLarge (Predefined->Info.Name, ParentOp,
    185  1.2.10.2  tls                 Count, ExpectedCount);
    186  1.2.10.2  tls         }
    187  1.2.10.2  tls 
    188  1.2.10.2  tls         /* Validate all elements of the package */
    189  1.2.10.2  tls 
    190  1.2.10.2  tls         ApCheckPackageElements (Predefined->Info.Name, Op,
    191  1.2.10.2  tls             Package->RetInfo.ObjectType1, Package->RetInfo.Count1,
    192  1.2.10.2  tls             Package->RetInfo.ObjectType2, Package->RetInfo.Count2);
    193  1.2.10.2  tls         break;
    194  1.2.10.2  tls 
    195  1.2.10.2  tls     case ACPI_PTYPE1_VAR:
    196  1.2.10.2  tls         /*
    197  1.2.10.2  tls          * The package count is variable, there are no sub-packages,
    198  1.2.10.2  tls          * and all elements must be of the same type
    199  1.2.10.2  tls          */
    200  1.2.10.2  tls         for (i = 0; i < Count; i++)
    201  1.2.10.2  tls         {
    202  1.2.10.2  tls             ApCheckObjectType (Predefined->Info.Name, Op,
    203  1.2.10.2  tls                 Package->RetInfo.ObjectType1, i);
    204  1.2.10.2  tls             Op = Op->Asl.Next;
    205  1.2.10.2  tls         }
    206  1.2.10.2  tls         break;
    207  1.2.10.2  tls 
    208  1.2.10.2  tls     case ACPI_PTYPE1_OPTION:
    209  1.2.10.2  tls         /*
    210  1.2.10.2  tls          * The package count is variable, there are no sub-packages.
    211  1.2.10.2  tls          * There are a fixed number of required elements, and a variable
    212  1.2.10.2  tls          * number of optional elements.
    213  1.2.10.2  tls          *
    214  1.2.10.2  tls          * Check if package is at least as large as the minimum required
    215  1.2.10.2  tls          */
    216  1.2.10.2  tls         ExpectedCount = Package->RetInfo3.Count;
    217  1.2.10.2  tls         if (Count < ExpectedCount)
    218  1.2.10.2  tls         {
    219  1.2.10.2  tls             goto PackageTooSmall;
    220  1.2.10.2  tls         }
    221  1.2.10.2  tls 
    222  1.2.10.2  tls         /* Variable number of sub-objects */
    223  1.2.10.2  tls 
    224  1.2.10.2  tls         for (i = 0; i < Count; i++)
    225  1.2.10.2  tls         {
    226  1.2.10.2  tls             if (i < Package->RetInfo3.Count)
    227  1.2.10.2  tls             {
    228  1.2.10.2  tls                 /* These are the required package elements (0, 1, or 2) */
    229  1.2.10.2  tls 
    230  1.2.10.2  tls                 ApCheckObjectType (Predefined->Info.Name, Op,
    231  1.2.10.2  tls                     Package->RetInfo3.ObjectType[i], i);
    232  1.2.10.2  tls             }
    233  1.2.10.2  tls             else
    234  1.2.10.2  tls             {
    235  1.2.10.2  tls                 /* These are the optional package elements */
    236  1.2.10.2  tls 
    237  1.2.10.2  tls                 ApCheckObjectType (Predefined->Info.Name, Op,
    238  1.2.10.2  tls                     Package->RetInfo3.TailObjectType, i);
    239  1.2.10.2  tls             }
    240  1.2.10.2  tls             Op = Op->Asl.Next;
    241  1.2.10.2  tls         }
    242  1.2.10.2  tls         break;
    243  1.2.10.2  tls 
    244  1.2.10.2  tls     case ACPI_PTYPE2_REV_FIXED:
    245  1.2.10.2  tls 
    246  1.2.10.2  tls         /* First element is the (Integer) revision */
    247  1.2.10.2  tls 
    248  1.2.10.2  tls         ApCheckObjectType (Predefined->Info.Name, Op,
    249  1.2.10.2  tls             ACPI_RTYPE_INTEGER, 0);
    250  1.2.10.2  tls 
    251  1.2.10.2  tls         Op = Op->Asl.Next;
    252  1.2.10.2  tls         Count--;
    253  1.2.10.2  tls 
    254  1.2.10.2  tls         /* Examine the sub-packages */
    255  1.2.10.2  tls 
    256  1.2.10.2  tls         ApCheckPackageList (Predefined->Info.Name, Op,
    257  1.2.10.2  tls             Package, 1, Count);
    258  1.2.10.2  tls         break;
    259  1.2.10.2  tls 
    260  1.2.10.2  tls     case ACPI_PTYPE2_PKG_COUNT:
    261  1.2.10.2  tls 
    262  1.2.10.2  tls         /* First element is the (Integer) count of sub-packages to follow */
    263  1.2.10.2  tls 
    264  1.2.10.2  tls         Status = ApCheckObjectType (Predefined->Info.Name, Op,
    265  1.2.10.2  tls             ACPI_RTYPE_INTEGER, 0);
    266  1.2.10.2  tls 
    267  1.2.10.2  tls         /* We must have an integer count from above (otherwise, use Count) */
    268  1.2.10.2  tls 
    269  1.2.10.2  tls         if (ACPI_SUCCESS (Status))
    270  1.2.10.2  tls         {
    271  1.2.10.2  tls             /*
    272  1.2.10.2  tls              * Count cannot be larger than the parent package length, but
    273  1.2.10.2  tls              * allow it to be smaller. The >= accounts for the Integer above.
    274  1.2.10.2  tls              */
    275  1.2.10.2  tls             ExpectedCount = (UINT32) Op->Asl.Value.Integer;
    276  1.2.10.2  tls             if (ExpectedCount >= Count)
    277  1.2.10.2  tls             {
    278  1.2.10.2  tls                 goto PackageTooSmall;
    279  1.2.10.2  tls             }
    280  1.2.10.2  tls 
    281  1.2.10.2  tls             Count = ExpectedCount;
    282  1.2.10.2  tls         }
    283  1.2.10.2  tls 
    284  1.2.10.2  tls         Op = Op->Asl.Next;
    285  1.2.10.2  tls 
    286  1.2.10.2  tls         /* Examine the sub-packages */
    287  1.2.10.2  tls 
    288  1.2.10.2  tls         ApCheckPackageList (Predefined->Info.Name, Op,
    289  1.2.10.2  tls             Package, 1, Count);
    290  1.2.10.2  tls         break;
    291  1.2.10.2  tls 
    292  1.2.10.2  tls     case ACPI_PTYPE2:
    293  1.2.10.2  tls     case ACPI_PTYPE2_FIXED:
    294  1.2.10.2  tls     case ACPI_PTYPE2_MIN:
    295  1.2.10.2  tls     case ACPI_PTYPE2_COUNT:
    296  1.2.10.2  tls     case ACPI_PTYPE2_FIX_VAR:
    297  1.2.10.2  tls         /*
    298  1.2.10.2  tls          * These types all return a single Package that consists of a
    299  1.2.10.2  tls          * variable number of sub-Packages.
    300  1.2.10.2  tls          */
    301  1.2.10.2  tls 
    302  1.2.10.2  tls         /* Examine the sub-packages */
    303  1.2.10.2  tls 
    304  1.2.10.2  tls         ApCheckPackageList (Predefined->Info.Name, Op,
    305  1.2.10.2  tls             Package, 0, Count);
    306  1.2.10.2  tls         break;
    307  1.2.10.2  tls 
    308  1.2.10.2  tls     default:
    309  1.2.10.2  tls         return;
    310  1.2.10.2  tls     }
    311  1.2.10.2  tls 
    312  1.2.10.2  tls     return;
    313  1.2.10.2  tls 
    314  1.2.10.2  tls PackageTooSmall:
    315  1.2.10.2  tls     ApPackageTooSmall (Predefined->Info.Name, ParentOp,
    316  1.2.10.2  tls         Count, ExpectedCount);
    317  1.2.10.2  tls }
    318  1.2.10.2  tls 
    319  1.2.10.2  tls 
    320  1.2.10.2  tls /*******************************************************************************
    321  1.2.10.2  tls  *
    322  1.2.10.2  tls  * FUNCTION:    ApCheckPackageElements
    323  1.2.10.2  tls  *
    324  1.2.10.2  tls  * PARAMETERS:  PredefinedName      - Name of the predefined object
    325  1.2.10.2  tls  *              Op                  - Parser op for the package
    326  1.2.10.2  tls  *              Type1               - Object type for first group
    327  1.2.10.2  tls  *              Count1              - Count for first group
    328  1.2.10.2  tls  *              Type2               - Object type for second group
    329  1.2.10.2  tls  *              Count2              - Count for second group
    330  1.2.10.2  tls  *
    331  1.2.10.2  tls  * RETURN:      None
    332  1.2.10.2  tls  *
    333  1.2.10.2  tls  * DESCRIPTION: Validate all elements of a package. Works with packages that
    334  1.2.10.2  tls  *              are defined to contain up to two groups of different object
    335  1.2.10.2  tls  *              types.
    336  1.2.10.2  tls  *
    337  1.2.10.2  tls  ******************************************************************************/
    338  1.2.10.2  tls 
    339  1.2.10.2  tls static void
    340  1.2.10.2  tls ApCheckPackageElements (
    341  1.2.10.2  tls     const char              *PredefinedName,
    342  1.2.10.2  tls     ACPI_PARSE_OBJECT       *Op,
    343  1.2.10.2  tls     UINT8                   Type1,
    344  1.2.10.2  tls     UINT32                  Count1,
    345  1.2.10.2  tls     UINT8                   Type2,
    346  1.2.10.2  tls     UINT32                  Count2)
    347  1.2.10.2  tls {
    348  1.2.10.2  tls     UINT32                  i;
    349  1.2.10.2  tls 
    350  1.2.10.2  tls 
    351  1.2.10.2  tls     /*
    352  1.2.10.2  tls      * Up to two groups of package elements are supported by the data
    353  1.2.10.2  tls      * structure. All elements in each group must be of the same type.
    354  1.2.10.2  tls      * The second group can have a count of zero.
    355  1.2.10.2  tls      *
    356  1.2.10.2  tls      * Aborts check upon a NULL package element, as this means (at compile
    357  1.2.10.2  tls      * time) that the remainder of the package elements are also NULL
    358  1.2.10.2  tls      * (This is the only way to create NULL package elements.)
    359  1.2.10.2  tls      */
    360  1.2.10.2  tls     for (i = 0; (i < Count1) && Op; i++)
    361  1.2.10.2  tls     {
    362  1.2.10.2  tls         ApCheckObjectType (PredefinedName, Op, Type1, i);
    363  1.2.10.2  tls         Op = Op->Asl.Next;
    364  1.2.10.2  tls     }
    365  1.2.10.2  tls 
    366  1.2.10.2  tls     for (i = 0; (i < Count2) && Op; i++)
    367  1.2.10.2  tls     {
    368  1.2.10.2  tls         ApCheckObjectType (PredefinedName, Op, Type2, (i + Count1));
    369  1.2.10.2  tls         Op = Op->Asl.Next;
    370  1.2.10.2  tls     }
    371  1.2.10.2  tls }
    372  1.2.10.2  tls 
    373  1.2.10.2  tls 
    374  1.2.10.2  tls /*******************************************************************************
    375  1.2.10.2  tls  *
    376  1.2.10.2  tls  * FUNCTION:    ApCheckPackageList
    377  1.2.10.2  tls  *
    378  1.2.10.2  tls  * PARAMETERS:  PredefinedName      - Name of the predefined object
    379  1.2.10.2  tls  *              ParentOp            - Parser op of the parent package
    380  1.2.10.2  tls  *              Package             - Package info for this predefined name
    381  1.2.10.2  tls  *              StartIndex          - Index in parent package where list begins
    382  1.2.10.2  tls  *              ParentCount         - Element count of parent package
    383  1.2.10.2  tls  *
    384  1.2.10.2  tls  * RETURN:      None
    385  1.2.10.2  tls  *
    386  1.2.10.2  tls  * DESCRIPTION: Validate the individual package elements for a predefined name.
    387  1.2.10.2  tls  *              Handles the cases where the predefined name is defined as a
    388  1.2.10.2  tls  *              Package of Packages (subpackages). These are the types:
    389  1.2.10.2  tls  *
    390  1.2.10.2  tls  *              ACPI_PTYPE2
    391  1.2.10.2  tls  *              ACPI_PTYPE2_FIXED
    392  1.2.10.2  tls  *              ACPI_PTYPE2_MIN
    393  1.2.10.2  tls  *              ACPI_PTYPE2_COUNT
    394  1.2.10.2  tls  *              ACPI_PTYPE2_FIX_VAR
    395  1.2.10.2  tls  *
    396  1.2.10.2  tls  ******************************************************************************/
    397  1.2.10.2  tls 
    398  1.2.10.2  tls static void
    399  1.2.10.2  tls ApCheckPackageList (
    400  1.2.10.2  tls     const char                  *PredefinedName,
    401  1.2.10.2  tls     ACPI_PARSE_OBJECT           *ParentOp,
    402  1.2.10.2  tls     const ACPI_PREDEFINED_INFO  *Package,
    403  1.2.10.2  tls     UINT32                      StartIndex,
    404  1.2.10.2  tls     UINT32                      ParentCount)
    405  1.2.10.2  tls {
    406  1.2.10.2  tls     ACPI_PARSE_OBJECT           *SubPackageOp = ParentOp;
    407  1.2.10.2  tls     ACPI_PARSE_OBJECT           *Op;
    408  1.2.10.2  tls     ACPI_STATUS                 Status;
    409  1.2.10.2  tls     UINT32                      Count;
    410  1.2.10.2  tls     UINT32                      ExpectedCount;
    411  1.2.10.2  tls     UINT32                      i;
    412  1.2.10.2  tls     UINT32                      j;
    413  1.2.10.2  tls 
    414  1.2.10.2  tls 
    415  1.2.10.2  tls     /*
    416  1.2.10.2  tls      * Validate each subpackage in the parent Package
    417  1.2.10.2  tls      *
    418  1.2.10.2  tls      * Note: We ignore NULL package elements on the assumption that
    419  1.2.10.2  tls      * they will be initialized by the BIOS or other ASL code.
    420  1.2.10.2  tls      */
    421  1.2.10.2  tls     for (i = 0; (i < ParentCount) && SubPackageOp; i++)
    422  1.2.10.2  tls     {
    423  1.2.10.2  tls         /* Each object in the list must be of type Package */
    424  1.2.10.2  tls 
    425  1.2.10.2  tls         Status = ApCheckObjectType (PredefinedName, SubPackageOp,
    426  1.2.10.2  tls             ACPI_RTYPE_PACKAGE, i + StartIndex);
    427  1.2.10.2  tls         if (ACPI_FAILURE (Status))
    428  1.2.10.2  tls         {
    429  1.2.10.2  tls             goto NextSubpackage;
    430  1.2.10.2  tls         }
    431  1.2.10.2  tls 
    432  1.2.10.2  tls         /* Examine the different types of expected subpackages */
    433  1.2.10.2  tls 
    434  1.2.10.2  tls         Op = SubPackageOp->Asl.Child;
    435  1.2.10.2  tls 
    436  1.2.10.2  tls         /* First child is the package length */
    437  1.2.10.2  tls 
    438  1.2.10.2  tls         Count = (UINT32) Op->Asl.Value.Integer;
    439  1.2.10.2  tls         Op = Op->Asl.Next;
    440  1.2.10.2  tls 
    441  1.2.10.2  tls         /* The subpackage must have at least one element */
    442  1.2.10.2  tls 
    443  1.2.10.2  tls         if (!Count)
    444  1.2.10.2  tls         {
    445  1.2.10.2  tls             ApZeroLengthPackage (PredefinedName, SubPackageOp);
    446  1.2.10.2  tls             goto NextSubpackage;
    447  1.2.10.2  tls         }
    448  1.2.10.2  tls 
    449  1.2.10.2  tls         /*
    450  1.2.10.2  tls          * Decode the package type.
    451  1.2.10.2  tls          * PTYPE2 indicates that a "package of packages" is expected for
    452  1.2.10.2  tls          * this name. The various flavors of PTYPE2 indicate the number
    453  1.2.10.2  tls          * and format of the subpackages.
    454  1.2.10.2  tls          */
    455  1.2.10.2  tls         switch (Package->RetInfo.Type)
    456  1.2.10.2  tls         {
    457  1.2.10.2  tls         case ACPI_PTYPE2:
    458  1.2.10.2  tls         case ACPI_PTYPE2_PKG_COUNT:
    459  1.2.10.2  tls         case ACPI_PTYPE2_REV_FIXED:
    460  1.2.10.2  tls 
    461  1.2.10.2  tls             /* Each subpackage has a fixed number of elements */
    462  1.2.10.2  tls 
    463  1.2.10.2  tls             ExpectedCount = Package->RetInfo.Count1 + Package->RetInfo.Count2;
    464  1.2.10.2  tls             if (Count < ExpectedCount)
    465  1.2.10.2  tls             {
    466  1.2.10.2  tls                 ApPackageTooSmall (PredefinedName, SubPackageOp,
    467  1.2.10.2  tls                     Count, ExpectedCount);
    468  1.2.10.2  tls                 break;
    469  1.2.10.2  tls             }
    470  1.2.10.2  tls 
    471  1.2.10.2  tls             ApCheckPackageElements (PredefinedName, Op,
    472  1.2.10.2  tls                 Package->RetInfo.ObjectType1, Package->RetInfo.Count1,
    473  1.2.10.2  tls                 Package->RetInfo.ObjectType2, Package->RetInfo.Count2);
    474  1.2.10.2  tls             break;
    475  1.2.10.2  tls 
    476  1.2.10.2  tls         case ACPI_PTYPE2_FIX_VAR:
    477  1.2.10.2  tls             /*
    478  1.2.10.2  tls              * Each subpackage has a fixed number of elements and an
    479  1.2.10.2  tls              * optional element
    480  1.2.10.2  tls              */
    481  1.2.10.2  tls             ExpectedCount = Package->RetInfo.Count1 + Package->RetInfo.Count2;
    482  1.2.10.2  tls             if (Count < ExpectedCount)
    483  1.2.10.2  tls             {
    484  1.2.10.2  tls                 ApPackageTooSmall (PredefinedName, SubPackageOp,
    485  1.2.10.2  tls                     Count, ExpectedCount);
    486  1.2.10.2  tls                 break;
    487  1.2.10.2  tls             }
    488  1.2.10.2  tls 
    489  1.2.10.2  tls             ApCheckPackageElements (PredefinedName, Op,
    490  1.2.10.2  tls                 Package->RetInfo.ObjectType1, Package->RetInfo.Count1,
    491  1.2.10.2  tls                 Package->RetInfo.ObjectType2,
    492  1.2.10.2  tls                 Count - Package->RetInfo.Count1);
    493  1.2.10.2  tls             break;
    494  1.2.10.2  tls 
    495  1.2.10.2  tls         case ACPI_PTYPE2_FIXED:
    496  1.2.10.2  tls 
    497  1.2.10.2  tls             /* Each sub-package has a fixed length */
    498  1.2.10.2  tls 
    499  1.2.10.2  tls             ExpectedCount = Package->RetInfo2.Count;
    500  1.2.10.2  tls             if (Count < ExpectedCount)
    501  1.2.10.2  tls             {
    502  1.2.10.2  tls                 ApPackageTooSmall (PredefinedName, SubPackageOp,
    503  1.2.10.2  tls                     Count, ExpectedCount);
    504  1.2.10.2  tls                 break;
    505  1.2.10.2  tls             }
    506  1.2.10.2  tls 
    507  1.2.10.2  tls             /* Check each object/type combination */
    508  1.2.10.2  tls 
    509  1.2.10.2  tls             for (j = 0; j < ExpectedCount; j++)
    510  1.2.10.2  tls             {
    511  1.2.10.2  tls                 ApCheckObjectType (PredefinedName, Op,
    512  1.2.10.2  tls                     Package->RetInfo2.ObjectType[j], j);
    513  1.2.10.2  tls 
    514  1.2.10.2  tls                 Op = Op->Asl.Next;
    515  1.2.10.2  tls             }
    516  1.2.10.2  tls             break;
    517  1.2.10.2  tls 
    518  1.2.10.2  tls         case ACPI_PTYPE2_MIN:
    519  1.2.10.2  tls 
    520  1.2.10.2  tls             /* Each sub-package has a variable but minimum length */
    521  1.2.10.2  tls 
    522  1.2.10.2  tls             ExpectedCount = Package->RetInfo.Count1;
    523  1.2.10.2  tls             if (Count < ExpectedCount)
    524  1.2.10.2  tls             {
    525  1.2.10.2  tls                 ApPackageTooSmall (PredefinedName, SubPackageOp,
    526  1.2.10.2  tls                     Count, ExpectedCount);
    527  1.2.10.2  tls                 break;
    528  1.2.10.2  tls             }
    529  1.2.10.2  tls 
    530  1.2.10.2  tls             /* Check the type of each sub-package element */
    531  1.2.10.2  tls 
    532  1.2.10.2  tls             ApCheckPackageElements (PredefinedName, Op,
    533  1.2.10.2  tls                 Package->RetInfo.ObjectType1, Count, 0, 0);
    534  1.2.10.2  tls             break;
    535  1.2.10.2  tls 
    536  1.2.10.2  tls         case ACPI_PTYPE2_COUNT:
    537  1.2.10.2  tls             /*
    538  1.2.10.2  tls              * First element is the (Integer) count of elements, including
    539  1.2.10.2  tls              * the count field (the ACPI name is NumElements)
    540  1.2.10.2  tls              */
    541  1.2.10.2  tls             Status = ApCheckObjectType (PredefinedName, Op,
    542  1.2.10.2  tls                 ACPI_RTYPE_INTEGER, 0);
    543  1.2.10.2  tls 
    544  1.2.10.2  tls             /* We must have an integer count from above (otherwise, use Count) */
    545  1.2.10.2  tls 
    546  1.2.10.2  tls             if (ACPI_SUCCESS (Status))
    547  1.2.10.2  tls             {
    548  1.2.10.2  tls                 /*
    549  1.2.10.2  tls                  * Make sure package is large enough for the Count and is
    550  1.2.10.2  tls                  * is as large as the minimum size
    551  1.2.10.2  tls                  */
    552  1.2.10.2  tls                 ExpectedCount = (UINT32) Op->Asl.Value.Integer;
    553  1.2.10.2  tls 
    554  1.2.10.2  tls                 if (Count < ExpectedCount)
    555  1.2.10.2  tls                 {
    556  1.2.10.2  tls                     ApPackageTooSmall (PredefinedName, SubPackageOp,
    557  1.2.10.2  tls                         Count, ExpectedCount);
    558  1.2.10.2  tls                     break;
    559  1.2.10.2  tls                 }
    560  1.2.10.2  tls                 else if (Count > ExpectedCount)
    561  1.2.10.2  tls                 {
    562  1.2.10.2  tls                     ApPackageTooLarge (PredefinedName, SubPackageOp,
    563  1.2.10.2  tls                         Count, ExpectedCount);
    564  1.2.10.2  tls                 }
    565  1.2.10.2  tls 
    566  1.2.10.2  tls                 /* Some names of this type have a minimum length */
    567  1.2.10.2  tls 
    568  1.2.10.2  tls                 if (Count < Package->RetInfo.Count1)
    569  1.2.10.2  tls                 {
    570  1.2.10.2  tls                     ExpectedCount = Package->RetInfo.Count1;
    571  1.2.10.2  tls                     ApPackageTooSmall (PredefinedName, SubPackageOp,
    572  1.2.10.2  tls                         Count, ExpectedCount);
    573  1.2.10.2  tls                     break;
    574  1.2.10.2  tls                 }
    575  1.2.10.2  tls 
    576  1.2.10.2  tls                 Count = ExpectedCount;
    577  1.2.10.2  tls             }
    578  1.2.10.2  tls 
    579  1.2.10.2  tls             /* Check the type of each sub-package element */
    580  1.2.10.2  tls 
    581  1.2.10.2  tls             Op = Op->Asl.Next;
    582  1.2.10.2  tls             ApCheckPackageElements (PredefinedName, Op,
    583  1.2.10.2  tls                 Package->RetInfo.ObjectType1, (Count - 1), 0, 0);
    584  1.2.10.2  tls             break;
    585  1.2.10.2  tls 
    586  1.2.10.2  tls         default:
    587  1.2.10.2  tls             break;
    588  1.2.10.2  tls         }
    589  1.2.10.2  tls 
    590  1.2.10.2  tls NextSubpackage:
    591  1.2.10.2  tls         SubPackageOp = SubPackageOp->Asl.Next;
    592  1.2.10.2  tls     }
    593  1.2.10.2  tls }
    594  1.2.10.2  tls 
    595  1.2.10.2  tls 
    596  1.2.10.2  tls /*******************************************************************************
    597  1.2.10.2  tls  *
    598  1.2.10.2  tls  * FUNCTION:    ApPackageTooSmall
    599  1.2.10.2  tls  *
    600  1.2.10.2  tls  * PARAMETERS:  PredefinedName      - Name of the predefined object
    601  1.2.10.2  tls  *              Op                  - Current parser op
    602  1.2.10.2  tls  *              Count               - Actual package element count
    603  1.2.10.2  tls  *              ExpectedCount       - Expected package element count
    604  1.2.10.2  tls  *
    605  1.2.10.2  tls  * RETURN:      None
    606  1.2.10.2  tls  *
    607  1.2.10.2  tls  * DESCRIPTION: Issue error message for a package that is smaller than
    608  1.2.10.2  tls  *              required.
    609  1.2.10.2  tls  *
    610  1.2.10.2  tls  ******************************************************************************/
    611  1.2.10.2  tls 
    612  1.2.10.2  tls static void
    613  1.2.10.2  tls ApPackageTooSmall (
    614  1.2.10.2  tls     const char                  *PredefinedName,
    615  1.2.10.2  tls     ACPI_PARSE_OBJECT           *Op,
    616  1.2.10.2  tls     UINT32                      Count,
    617  1.2.10.2  tls     UINT32                      ExpectedCount)
    618  1.2.10.2  tls {
    619  1.2.10.2  tls 
    620  1.2.10.2  tls     snprintf (MsgBuffer, sizeof(MsgBuffer), "%s: length %u, required minimum is %u",
    621  1.2.10.2  tls         PredefinedName, Count, ExpectedCount);
    622  1.2.10.2  tls 
    623  1.2.10.2  tls     AslError (ASL_ERROR, ASL_MSG_RESERVED_PACKAGE_LENGTH, Op, MsgBuffer);
    624  1.2.10.2  tls }
    625  1.2.10.2  tls 
    626  1.2.10.2  tls 
    627  1.2.10.2  tls /*******************************************************************************
    628  1.2.10.2  tls  *
    629  1.2.10.2  tls  * FUNCTION:    ApZeroLengthPackage
    630  1.2.10.2  tls  *
    631  1.2.10.2  tls  * PARAMETERS:  PredefinedName      - Name of the predefined object
    632  1.2.10.2  tls  *              Op                  - Current parser op
    633  1.2.10.2  tls  *
    634  1.2.10.2  tls  * RETURN:      None
    635  1.2.10.2  tls  *
    636  1.2.10.2  tls  * DESCRIPTION: Issue error message for a zero-length package (a package that
    637  1.2.10.2  tls  *              is required to have a non-zero length). Variable length
    638  1.2.10.2  tls  *              packages seem to be allowed to have zero length, however.
    639  1.2.10.2  tls  *              Even if not allowed, BIOS code does it.
    640  1.2.10.2  tls  *
    641  1.2.10.2  tls  ******************************************************************************/
    642  1.2.10.2  tls 
    643  1.2.10.2  tls static void
    644  1.2.10.2  tls ApZeroLengthPackage (
    645  1.2.10.2  tls     const char                  *PredefinedName,
    646  1.2.10.2  tls     ACPI_PARSE_OBJECT           *Op)
    647  1.2.10.2  tls {
    648  1.2.10.2  tls 
    649  1.2.10.2  tls     snprintf (MsgBuffer, sizeof(MsgBuffer), "%s: length is zero", PredefinedName);
    650  1.2.10.2  tls 
    651  1.2.10.2  tls     AslError (ASL_ERROR, ASL_MSG_RESERVED_PACKAGE_LENGTH, Op, MsgBuffer);
    652  1.2.10.2  tls }
    653  1.2.10.2  tls 
    654  1.2.10.2  tls 
    655  1.2.10.2  tls /*******************************************************************************
    656  1.2.10.2  tls  *
    657  1.2.10.2  tls  * FUNCTION:    ApPackageTooLarge
    658  1.2.10.2  tls  *
    659  1.2.10.2  tls  * PARAMETERS:  PredefinedName      - Name of the predefined object
    660  1.2.10.2  tls  *              Op                  - Current parser op
    661  1.2.10.2  tls  *              Count               - Actual package element count
    662  1.2.10.2  tls  *              ExpectedCount       - Expected package element count
    663  1.2.10.2  tls  *
    664  1.2.10.2  tls  * RETURN:      None
    665  1.2.10.2  tls  *
    666  1.2.10.2  tls  * DESCRIPTION: Issue a remark for a package that is larger than expected.
    667  1.2.10.2  tls  *
    668  1.2.10.2  tls  ******************************************************************************/
    669  1.2.10.2  tls 
    670  1.2.10.2  tls static void
    671  1.2.10.2  tls ApPackageTooLarge (
    672  1.2.10.2  tls     const char                  *PredefinedName,
    673  1.2.10.2  tls     ACPI_PARSE_OBJECT           *Op,
    674  1.2.10.2  tls     UINT32                      Count,
    675  1.2.10.2  tls     UINT32                      ExpectedCount)
    676  1.2.10.2  tls {
    677  1.2.10.2  tls 
    678  1.2.10.2  tls     snprintf (MsgBuffer, sizeof(MsgBuffer), "%s: length is %u, only %u required",
    679  1.2.10.2  tls         PredefinedName, Count, ExpectedCount);
    680  1.2.10.2  tls 
    681  1.2.10.2  tls     AslError (ASL_REMARK, ASL_MSG_RESERVED_PACKAGE_LENGTH, Op, MsgBuffer);
    682  1.2.10.2  tls }
    683