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