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