nsprepkg.c revision 1.1.1.1.10.2
1 1.1.1.1.10.2 tls /****************************************************************************** 2 1.1.1.1.10.2 tls * 3 1.1.1.1.10.2 tls * Module Name: nsprepkg - Validation of package objects for predefined names 4 1.1.1.1.10.2 tls * 5 1.1.1.1.10.2 tls *****************************************************************************/ 6 1.1.1.1.10.2 tls 7 1.1.1.1.10.2 tls /* 8 1.1.1.1.10.2 tls * Copyright (C) 2000 - 2013, Intel Corp. 9 1.1.1.1.10.2 tls * All rights reserved. 10 1.1.1.1.10.2 tls * 11 1.1.1.1.10.2 tls * Redistribution and use in source and binary forms, with or without 12 1.1.1.1.10.2 tls * modification, are permitted provided that the following conditions 13 1.1.1.1.10.2 tls * are met: 14 1.1.1.1.10.2 tls * 1. Redistributions of source code must retain the above copyright 15 1.1.1.1.10.2 tls * notice, this list of conditions, and the following disclaimer, 16 1.1.1.1.10.2 tls * without modification. 17 1.1.1.1.10.2 tls * 2. Redistributions in binary form must reproduce at minimum a disclaimer 18 1.1.1.1.10.2 tls * substantially similar to the "NO WARRANTY" disclaimer below 19 1.1.1.1.10.2 tls * ("Disclaimer") and any redistribution must be conditioned upon 20 1.1.1.1.10.2 tls * including a substantially similar Disclaimer requirement for further 21 1.1.1.1.10.2 tls * binary redistribution. 22 1.1.1.1.10.2 tls * 3. Neither the names of the above-listed copyright holders nor the names 23 1.1.1.1.10.2 tls * of any contributors may be used to endorse or promote products derived 24 1.1.1.1.10.2 tls * from this software without specific prior written permission. 25 1.1.1.1.10.2 tls * 26 1.1.1.1.10.2 tls * Alternatively, this software may be distributed under the terms of the 27 1.1.1.1.10.2 tls * GNU General Public License ("GPL") version 2 as published by the Free 28 1.1.1.1.10.2 tls * Software Foundation. 29 1.1.1.1.10.2 tls * 30 1.1.1.1.10.2 tls * NO WARRANTY 31 1.1.1.1.10.2 tls * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 32 1.1.1.1.10.2 tls * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 33 1.1.1.1.10.2 tls * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR 34 1.1.1.1.10.2 tls * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 35 1.1.1.1.10.2 tls * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 36 1.1.1.1.10.2 tls * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 37 1.1.1.1.10.2 tls * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 38 1.1.1.1.10.2 tls * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 39 1.1.1.1.10.2 tls * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 40 1.1.1.1.10.2 tls * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 41 1.1.1.1.10.2 tls * POSSIBILITY OF SUCH DAMAGES. 42 1.1.1.1.10.2 tls */ 43 1.1.1.1.10.2 tls 44 1.1.1.1.10.2 tls #include "acpi.h" 45 1.1.1.1.10.2 tls #include "accommon.h" 46 1.1.1.1.10.2 tls #include "acnamesp.h" 47 1.1.1.1.10.2 tls #include "acpredef.h" 48 1.1.1.1.10.2 tls 49 1.1.1.1.10.2 tls 50 1.1.1.1.10.2 tls #define _COMPONENT ACPI_NAMESPACE 51 1.1.1.1.10.2 tls ACPI_MODULE_NAME ("nsprepkg") 52 1.1.1.1.10.2 tls 53 1.1.1.1.10.2 tls 54 1.1.1.1.10.2 tls /* Local prototypes */ 55 1.1.1.1.10.2 tls 56 1.1.1.1.10.2 tls static ACPI_STATUS 57 1.1.1.1.10.2 tls AcpiNsCheckPackageList ( 58 1.1.1.1.10.2 tls ACPI_EVALUATE_INFO *Info, 59 1.1.1.1.10.2 tls const ACPI_PREDEFINED_INFO *Package, 60 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT **Elements, 61 1.1.1.1.10.2 tls UINT32 Count); 62 1.1.1.1.10.2 tls 63 1.1.1.1.10.2 tls static ACPI_STATUS 64 1.1.1.1.10.2 tls AcpiNsCheckPackageElements ( 65 1.1.1.1.10.2 tls ACPI_EVALUATE_INFO *Info, 66 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT **Elements, 67 1.1.1.1.10.2 tls UINT8 Type1, 68 1.1.1.1.10.2 tls UINT32 Count1, 69 1.1.1.1.10.2 tls UINT8 Type2, 70 1.1.1.1.10.2 tls UINT32 Count2, 71 1.1.1.1.10.2 tls UINT32 StartIndex); 72 1.1.1.1.10.2 tls 73 1.1.1.1.10.2 tls 74 1.1.1.1.10.2 tls /******************************************************************************* 75 1.1.1.1.10.2 tls * 76 1.1.1.1.10.2 tls * FUNCTION: AcpiNsCheckPackage 77 1.1.1.1.10.2 tls * 78 1.1.1.1.10.2 tls * PARAMETERS: Info - Method execution information block 79 1.1.1.1.10.2 tls * ReturnObjectPtr - Pointer to the object returned from the 80 1.1.1.1.10.2 tls * evaluation of a method or object 81 1.1.1.1.10.2 tls * 82 1.1.1.1.10.2 tls * RETURN: Status 83 1.1.1.1.10.2 tls * 84 1.1.1.1.10.2 tls * DESCRIPTION: Check a returned package object for the correct count and 85 1.1.1.1.10.2 tls * correct type of all sub-objects. 86 1.1.1.1.10.2 tls * 87 1.1.1.1.10.2 tls ******************************************************************************/ 88 1.1.1.1.10.2 tls 89 1.1.1.1.10.2 tls ACPI_STATUS 90 1.1.1.1.10.2 tls AcpiNsCheckPackage ( 91 1.1.1.1.10.2 tls ACPI_EVALUATE_INFO *Info, 92 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT **ReturnObjectPtr) 93 1.1.1.1.10.2 tls { 94 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT *ReturnObject = *ReturnObjectPtr; 95 1.1.1.1.10.2 tls const ACPI_PREDEFINED_INFO *Package; 96 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT **Elements; 97 1.1.1.1.10.2 tls ACPI_STATUS Status = AE_OK; 98 1.1.1.1.10.2 tls UINT32 ExpectedCount; 99 1.1.1.1.10.2 tls UINT32 Count; 100 1.1.1.1.10.2 tls UINT32 i; 101 1.1.1.1.10.2 tls 102 1.1.1.1.10.2 tls 103 1.1.1.1.10.2 tls ACPI_FUNCTION_NAME (NsCheckPackage); 104 1.1.1.1.10.2 tls 105 1.1.1.1.10.2 tls 106 1.1.1.1.10.2 tls /* The package info for this name is in the next table entry */ 107 1.1.1.1.10.2 tls 108 1.1.1.1.10.2 tls Package = Info->Predefined + 1; 109 1.1.1.1.10.2 tls 110 1.1.1.1.10.2 tls ACPI_DEBUG_PRINT ((ACPI_DB_NAMES, 111 1.1.1.1.10.2 tls "%s Validating return Package of Type %X, Count %X\n", 112 1.1.1.1.10.2 tls Info->FullPathname, Package->RetInfo.Type, 113 1.1.1.1.10.2 tls ReturnObject->Package.Count)); 114 1.1.1.1.10.2 tls 115 1.1.1.1.10.2 tls /* 116 1.1.1.1.10.2 tls * For variable-length Packages, we can safely remove all embedded 117 1.1.1.1.10.2 tls * and trailing NULL package elements 118 1.1.1.1.10.2 tls */ 119 1.1.1.1.10.2 tls AcpiNsRemoveNullElements (Info, Package->RetInfo.Type, ReturnObject); 120 1.1.1.1.10.2 tls 121 1.1.1.1.10.2 tls /* Extract package count and elements array */ 122 1.1.1.1.10.2 tls 123 1.1.1.1.10.2 tls Elements = ReturnObject->Package.Elements; 124 1.1.1.1.10.2 tls Count = ReturnObject->Package.Count; 125 1.1.1.1.10.2 tls 126 1.1.1.1.10.2 tls /* 127 1.1.1.1.10.2 tls * Most packages must have at least one element. The only exception 128 1.1.1.1.10.2 tls * is the variable-length package (ACPI_PTYPE1_VAR). 129 1.1.1.1.10.2 tls */ 130 1.1.1.1.10.2 tls if (!Count) 131 1.1.1.1.10.2 tls { 132 1.1.1.1.10.2 tls if (Package->RetInfo.Type == ACPI_PTYPE1_VAR) 133 1.1.1.1.10.2 tls { 134 1.1.1.1.10.2 tls return (AE_OK); 135 1.1.1.1.10.2 tls } 136 1.1.1.1.10.2 tls 137 1.1.1.1.10.2 tls ACPI_WARN_PREDEFINED ((AE_INFO, Info->FullPathname, Info->NodeFlags, 138 1.1.1.1.10.2 tls "Return Package has no elements (empty)")); 139 1.1.1.1.10.2 tls 140 1.1.1.1.10.2 tls return (AE_AML_OPERAND_VALUE); 141 1.1.1.1.10.2 tls } 142 1.1.1.1.10.2 tls 143 1.1.1.1.10.2 tls /* 144 1.1.1.1.10.2 tls * Decode the type of the expected package contents 145 1.1.1.1.10.2 tls * 146 1.1.1.1.10.2 tls * PTYPE1 packages contain no subpackages 147 1.1.1.1.10.2 tls * PTYPE2 packages contain sub-packages 148 1.1.1.1.10.2 tls */ 149 1.1.1.1.10.2 tls switch (Package->RetInfo.Type) 150 1.1.1.1.10.2 tls { 151 1.1.1.1.10.2 tls case ACPI_PTYPE1_FIXED: 152 1.1.1.1.10.2 tls /* 153 1.1.1.1.10.2 tls * The package count is fixed and there are no sub-packages 154 1.1.1.1.10.2 tls * 155 1.1.1.1.10.2 tls * If package is too small, exit. 156 1.1.1.1.10.2 tls * If package is larger than expected, issue warning but continue 157 1.1.1.1.10.2 tls */ 158 1.1.1.1.10.2 tls ExpectedCount = Package->RetInfo.Count1 + Package->RetInfo.Count2; 159 1.1.1.1.10.2 tls if (Count < ExpectedCount) 160 1.1.1.1.10.2 tls { 161 1.1.1.1.10.2 tls goto PackageTooSmall; 162 1.1.1.1.10.2 tls } 163 1.1.1.1.10.2 tls else if (Count > ExpectedCount) 164 1.1.1.1.10.2 tls { 165 1.1.1.1.10.2 tls ACPI_DEBUG_PRINT ((ACPI_DB_REPAIR, 166 1.1.1.1.10.2 tls "%s: Return Package is larger than needed - " 167 1.1.1.1.10.2 tls "found %u, expected %u\n", 168 1.1.1.1.10.2 tls Info->FullPathname, Count, ExpectedCount)); 169 1.1.1.1.10.2 tls } 170 1.1.1.1.10.2 tls 171 1.1.1.1.10.2 tls /* Validate all elements of the returned package */ 172 1.1.1.1.10.2 tls 173 1.1.1.1.10.2 tls Status = AcpiNsCheckPackageElements (Info, Elements, 174 1.1.1.1.10.2 tls Package->RetInfo.ObjectType1, Package->RetInfo.Count1, 175 1.1.1.1.10.2 tls Package->RetInfo.ObjectType2, Package->RetInfo.Count2, 0); 176 1.1.1.1.10.2 tls break; 177 1.1.1.1.10.2 tls 178 1.1.1.1.10.2 tls case ACPI_PTYPE1_VAR: 179 1.1.1.1.10.2 tls /* 180 1.1.1.1.10.2 tls * The package count is variable, there are no sub-packages, and all 181 1.1.1.1.10.2 tls * elements must be of the same type 182 1.1.1.1.10.2 tls */ 183 1.1.1.1.10.2 tls for (i = 0; i < Count; i++) 184 1.1.1.1.10.2 tls { 185 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, Elements, 186 1.1.1.1.10.2 tls Package->RetInfo.ObjectType1, i); 187 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 188 1.1.1.1.10.2 tls { 189 1.1.1.1.10.2 tls return (Status); 190 1.1.1.1.10.2 tls } 191 1.1.1.1.10.2 tls Elements++; 192 1.1.1.1.10.2 tls } 193 1.1.1.1.10.2 tls break; 194 1.1.1.1.10.2 tls 195 1.1.1.1.10.2 tls case ACPI_PTYPE1_OPTION: 196 1.1.1.1.10.2 tls /* 197 1.1.1.1.10.2 tls * The package count is variable, there are no sub-packages. There are 198 1.1.1.1.10.2 tls * a fixed number of required elements, and a variable number of 199 1.1.1.1.10.2 tls * optional elements. 200 1.1.1.1.10.2 tls * 201 1.1.1.1.10.2 tls * Check if package is at least as large as the minimum required 202 1.1.1.1.10.2 tls */ 203 1.1.1.1.10.2 tls ExpectedCount = Package->RetInfo3.Count; 204 1.1.1.1.10.2 tls if (Count < ExpectedCount) 205 1.1.1.1.10.2 tls { 206 1.1.1.1.10.2 tls goto PackageTooSmall; 207 1.1.1.1.10.2 tls } 208 1.1.1.1.10.2 tls 209 1.1.1.1.10.2 tls /* Variable number of sub-objects */ 210 1.1.1.1.10.2 tls 211 1.1.1.1.10.2 tls for (i = 0; i < Count; i++) 212 1.1.1.1.10.2 tls { 213 1.1.1.1.10.2 tls if (i < Package->RetInfo3.Count) 214 1.1.1.1.10.2 tls { 215 1.1.1.1.10.2 tls /* These are the required package elements (0, 1, or 2) */ 216 1.1.1.1.10.2 tls 217 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, Elements, 218 1.1.1.1.10.2 tls Package->RetInfo3.ObjectType[i], i); 219 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 220 1.1.1.1.10.2 tls { 221 1.1.1.1.10.2 tls return (Status); 222 1.1.1.1.10.2 tls } 223 1.1.1.1.10.2 tls } 224 1.1.1.1.10.2 tls else 225 1.1.1.1.10.2 tls { 226 1.1.1.1.10.2 tls /* These are the optional package elements */ 227 1.1.1.1.10.2 tls 228 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, Elements, 229 1.1.1.1.10.2 tls Package->RetInfo3.TailObjectType, i); 230 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 231 1.1.1.1.10.2 tls { 232 1.1.1.1.10.2 tls return (Status); 233 1.1.1.1.10.2 tls } 234 1.1.1.1.10.2 tls } 235 1.1.1.1.10.2 tls Elements++; 236 1.1.1.1.10.2 tls } 237 1.1.1.1.10.2 tls break; 238 1.1.1.1.10.2 tls 239 1.1.1.1.10.2 tls case ACPI_PTYPE2_REV_FIXED: 240 1.1.1.1.10.2 tls 241 1.1.1.1.10.2 tls /* First element is the (Integer) revision */ 242 1.1.1.1.10.2 tls 243 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, Elements, 244 1.1.1.1.10.2 tls ACPI_RTYPE_INTEGER, 0); 245 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 246 1.1.1.1.10.2 tls { 247 1.1.1.1.10.2 tls return (Status); 248 1.1.1.1.10.2 tls } 249 1.1.1.1.10.2 tls 250 1.1.1.1.10.2 tls Elements++; 251 1.1.1.1.10.2 tls Count--; 252 1.1.1.1.10.2 tls 253 1.1.1.1.10.2 tls /* Examine the sub-packages */ 254 1.1.1.1.10.2 tls 255 1.1.1.1.10.2 tls Status = AcpiNsCheckPackageList (Info, Package, Elements, Count); 256 1.1.1.1.10.2 tls break; 257 1.1.1.1.10.2 tls 258 1.1.1.1.10.2 tls case ACPI_PTYPE2_PKG_COUNT: 259 1.1.1.1.10.2 tls 260 1.1.1.1.10.2 tls /* First element is the (Integer) count of sub-packages to follow */ 261 1.1.1.1.10.2 tls 262 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, Elements, 263 1.1.1.1.10.2 tls ACPI_RTYPE_INTEGER, 0); 264 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 265 1.1.1.1.10.2 tls { 266 1.1.1.1.10.2 tls return (Status); 267 1.1.1.1.10.2 tls } 268 1.1.1.1.10.2 tls 269 1.1.1.1.10.2 tls /* 270 1.1.1.1.10.2 tls * Count cannot be larger than the parent package length, but allow it 271 1.1.1.1.10.2 tls * to be smaller. The >= accounts for the Integer above. 272 1.1.1.1.10.2 tls */ 273 1.1.1.1.10.2 tls ExpectedCount = (UINT32) (*Elements)->Integer.Value; 274 1.1.1.1.10.2 tls if (ExpectedCount >= Count) 275 1.1.1.1.10.2 tls { 276 1.1.1.1.10.2 tls goto PackageTooSmall; 277 1.1.1.1.10.2 tls } 278 1.1.1.1.10.2 tls 279 1.1.1.1.10.2 tls Count = ExpectedCount; 280 1.1.1.1.10.2 tls Elements++; 281 1.1.1.1.10.2 tls 282 1.1.1.1.10.2 tls /* Examine the sub-packages */ 283 1.1.1.1.10.2 tls 284 1.1.1.1.10.2 tls Status = AcpiNsCheckPackageList (Info, Package, Elements, Count); 285 1.1.1.1.10.2 tls break; 286 1.1.1.1.10.2 tls 287 1.1.1.1.10.2 tls case ACPI_PTYPE2: 288 1.1.1.1.10.2 tls case ACPI_PTYPE2_FIXED: 289 1.1.1.1.10.2 tls case ACPI_PTYPE2_MIN: 290 1.1.1.1.10.2 tls case ACPI_PTYPE2_COUNT: 291 1.1.1.1.10.2 tls case ACPI_PTYPE2_FIX_VAR: 292 1.1.1.1.10.2 tls /* 293 1.1.1.1.10.2 tls * These types all return a single Package that consists of a 294 1.1.1.1.10.2 tls * variable number of sub-Packages. 295 1.1.1.1.10.2 tls * 296 1.1.1.1.10.2 tls * First, ensure that the first element is a sub-Package. If not, 297 1.1.1.1.10.2 tls * the BIOS may have incorrectly returned the object as a single 298 1.1.1.1.10.2 tls * package instead of a Package of Packages (a common error if 299 1.1.1.1.10.2 tls * there is only one entry). We may be able to repair this by 300 1.1.1.1.10.2 tls * wrapping the returned Package with a new outer Package. 301 1.1.1.1.10.2 tls */ 302 1.1.1.1.10.2 tls if (*Elements && ((*Elements)->Common.Type != ACPI_TYPE_PACKAGE)) 303 1.1.1.1.10.2 tls { 304 1.1.1.1.10.2 tls /* Create the new outer package and populate it */ 305 1.1.1.1.10.2 tls 306 1.1.1.1.10.2 tls Status = AcpiNsWrapWithPackage (Info, ReturnObject, ReturnObjectPtr); 307 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 308 1.1.1.1.10.2 tls { 309 1.1.1.1.10.2 tls return (Status); 310 1.1.1.1.10.2 tls } 311 1.1.1.1.10.2 tls 312 1.1.1.1.10.2 tls /* Update locals to point to the new package (of 1 element) */ 313 1.1.1.1.10.2 tls 314 1.1.1.1.10.2 tls ReturnObject = *ReturnObjectPtr; 315 1.1.1.1.10.2 tls Elements = ReturnObject->Package.Elements; 316 1.1.1.1.10.2 tls Count = 1; 317 1.1.1.1.10.2 tls } 318 1.1.1.1.10.2 tls 319 1.1.1.1.10.2 tls /* Examine the sub-packages */ 320 1.1.1.1.10.2 tls 321 1.1.1.1.10.2 tls Status = AcpiNsCheckPackageList (Info, Package, Elements, Count); 322 1.1.1.1.10.2 tls break; 323 1.1.1.1.10.2 tls 324 1.1.1.1.10.2 tls default: 325 1.1.1.1.10.2 tls 326 1.1.1.1.10.2 tls /* Should not get here if predefined info table is correct */ 327 1.1.1.1.10.2 tls 328 1.1.1.1.10.2 tls ACPI_WARN_PREDEFINED ((AE_INFO, Info->FullPathname, Info->NodeFlags, 329 1.1.1.1.10.2 tls "Invalid internal return type in table entry: %X", 330 1.1.1.1.10.2 tls Package->RetInfo.Type)); 331 1.1.1.1.10.2 tls 332 1.1.1.1.10.2 tls return (AE_AML_INTERNAL); 333 1.1.1.1.10.2 tls } 334 1.1.1.1.10.2 tls 335 1.1.1.1.10.2 tls return (Status); 336 1.1.1.1.10.2 tls 337 1.1.1.1.10.2 tls 338 1.1.1.1.10.2 tls PackageTooSmall: 339 1.1.1.1.10.2 tls 340 1.1.1.1.10.2 tls /* Error exit for the case with an incorrect package count */ 341 1.1.1.1.10.2 tls 342 1.1.1.1.10.2 tls ACPI_WARN_PREDEFINED ((AE_INFO, Info->FullPathname, Info->NodeFlags, 343 1.1.1.1.10.2 tls "Return Package is too small - found %u elements, expected %u", 344 1.1.1.1.10.2 tls Count, ExpectedCount)); 345 1.1.1.1.10.2 tls 346 1.1.1.1.10.2 tls return (AE_AML_OPERAND_VALUE); 347 1.1.1.1.10.2 tls } 348 1.1.1.1.10.2 tls 349 1.1.1.1.10.2 tls 350 1.1.1.1.10.2 tls /******************************************************************************* 351 1.1.1.1.10.2 tls * 352 1.1.1.1.10.2 tls * FUNCTION: AcpiNsCheckPackageList 353 1.1.1.1.10.2 tls * 354 1.1.1.1.10.2 tls * PARAMETERS: Info - Method execution information block 355 1.1.1.1.10.2 tls * Package - Pointer to package-specific info for method 356 1.1.1.1.10.2 tls * Elements - Element list of parent package. All elements 357 1.1.1.1.10.2 tls * of this list should be of type Package. 358 1.1.1.1.10.2 tls * Count - Count of subpackages 359 1.1.1.1.10.2 tls * 360 1.1.1.1.10.2 tls * RETURN: Status 361 1.1.1.1.10.2 tls * 362 1.1.1.1.10.2 tls * DESCRIPTION: Examine a list of subpackages 363 1.1.1.1.10.2 tls * 364 1.1.1.1.10.2 tls ******************************************************************************/ 365 1.1.1.1.10.2 tls 366 1.1.1.1.10.2 tls static ACPI_STATUS 367 1.1.1.1.10.2 tls AcpiNsCheckPackageList ( 368 1.1.1.1.10.2 tls ACPI_EVALUATE_INFO *Info, 369 1.1.1.1.10.2 tls const ACPI_PREDEFINED_INFO *Package, 370 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT **Elements, 371 1.1.1.1.10.2 tls UINT32 Count) 372 1.1.1.1.10.2 tls { 373 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT *SubPackage; 374 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT **SubElements; 375 1.1.1.1.10.2 tls ACPI_STATUS Status; 376 1.1.1.1.10.2 tls UINT32 ExpectedCount; 377 1.1.1.1.10.2 tls UINT32 i; 378 1.1.1.1.10.2 tls UINT32 j; 379 1.1.1.1.10.2 tls 380 1.1.1.1.10.2 tls 381 1.1.1.1.10.2 tls /* 382 1.1.1.1.10.2 tls * Validate each sub-Package in the parent Package 383 1.1.1.1.10.2 tls * 384 1.1.1.1.10.2 tls * NOTE: assumes list of sub-packages contains no NULL elements. 385 1.1.1.1.10.2 tls * Any NULL elements should have been removed by earlier call 386 1.1.1.1.10.2 tls * to AcpiNsRemoveNullElements. 387 1.1.1.1.10.2 tls */ 388 1.1.1.1.10.2 tls for (i = 0; i < Count; i++) 389 1.1.1.1.10.2 tls { 390 1.1.1.1.10.2 tls SubPackage = *Elements; 391 1.1.1.1.10.2 tls SubElements = SubPackage->Package.Elements; 392 1.1.1.1.10.2 tls Info->ParentPackage = SubPackage; 393 1.1.1.1.10.2 tls 394 1.1.1.1.10.2 tls /* Each sub-object must be of type Package */ 395 1.1.1.1.10.2 tls 396 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, &SubPackage, 397 1.1.1.1.10.2 tls ACPI_RTYPE_PACKAGE, i); 398 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 399 1.1.1.1.10.2 tls { 400 1.1.1.1.10.2 tls return (Status); 401 1.1.1.1.10.2 tls } 402 1.1.1.1.10.2 tls 403 1.1.1.1.10.2 tls /* Examine the different types of expected sub-packages */ 404 1.1.1.1.10.2 tls 405 1.1.1.1.10.2 tls Info->ParentPackage = SubPackage; 406 1.1.1.1.10.2 tls switch (Package->RetInfo.Type) 407 1.1.1.1.10.2 tls { 408 1.1.1.1.10.2 tls case ACPI_PTYPE2: 409 1.1.1.1.10.2 tls case ACPI_PTYPE2_PKG_COUNT: 410 1.1.1.1.10.2 tls case ACPI_PTYPE2_REV_FIXED: 411 1.1.1.1.10.2 tls 412 1.1.1.1.10.2 tls /* Each subpackage has a fixed number of elements */ 413 1.1.1.1.10.2 tls 414 1.1.1.1.10.2 tls ExpectedCount = Package->RetInfo.Count1 + Package->RetInfo.Count2; 415 1.1.1.1.10.2 tls if (SubPackage->Package.Count < ExpectedCount) 416 1.1.1.1.10.2 tls { 417 1.1.1.1.10.2 tls goto PackageTooSmall; 418 1.1.1.1.10.2 tls } 419 1.1.1.1.10.2 tls 420 1.1.1.1.10.2 tls Status = AcpiNsCheckPackageElements (Info, SubElements, 421 1.1.1.1.10.2 tls Package->RetInfo.ObjectType1, 422 1.1.1.1.10.2 tls Package->RetInfo.Count1, 423 1.1.1.1.10.2 tls Package->RetInfo.ObjectType2, 424 1.1.1.1.10.2 tls Package->RetInfo.Count2, 0); 425 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 426 1.1.1.1.10.2 tls { 427 1.1.1.1.10.2 tls return (Status); 428 1.1.1.1.10.2 tls } 429 1.1.1.1.10.2 tls break; 430 1.1.1.1.10.2 tls 431 1.1.1.1.10.2 tls case ACPI_PTYPE2_FIX_VAR: 432 1.1.1.1.10.2 tls /* 433 1.1.1.1.10.2 tls * Each subpackage has a fixed number of elements and an 434 1.1.1.1.10.2 tls * optional element 435 1.1.1.1.10.2 tls */ 436 1.1.1.1.10.2 tls ExpectedCount = Package->RetInfo.Count1 + Package->RetInfo.Count2; 437 1.1.1.1.10.2 tls if (SubPackage->Package.Count < ExpectedCount) 438 1.1.1.1.10.2 tls { 439 1.1.1.1.10.2 tls goto PackageTooSmall; 440 1.1.1.1.10.2 tls } 441 1.1.1.1.10.2 tls 442 1.1.1.1.10.2 tls Status = AcpiNsCheckPackageElements (Info, SubElements, 443 1.1.1.1.10.2 tls Package->RetInfo.ObjectType1, 444 1.1.1.1.10.2 tls Package->RetInfo.Count1, 445 1.1.1.1.10.2 tls Package->RetInfo.ObjectType2, 446 1.1.1.1.10.2 tls SubPackage->Package.Count - Package->RetInfo.Count1, 0); 447 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 448 1.1.1.1.10.2 tls { 449 1.1.1.1.10.2 tls return (Status); 450 1.1.1.1.10.2 tls } 451 1.1.1.1.10.2 tls break; 452 1.1.1.1.10.2 tls 453 1.1.1.1.10.2 tls case ACPI_PTYPE2_FIXED: 454 1.1.1.1.10.2 tls 455 1.1.1.1.10.2 tls /* Each sub-package has a fixed length */ 456 1.1.1.1.10.2 tls 457 1.1.1.1.10.2 tls ExpectedCount = Package->RetInfo2.Count; 458 1.1.1.1.10.2 tls if (SubPackage->Package.Count < ExpectedCount) 459 1.1.1.1.10.2 tls { 460 1.1.1.1.10.2 tls goto PackageTooSmall; 461 1.1.1.1.10.2 tls } 462 1.1.1.1.10.2 tls 463 1.1.1.1.10.2 tls /* Check the type of each sub-package element */ 464 1.1.1.1.10.2 tls 465 1.1.1.1.10.2 tls for (j = 0; j < ExpectedCount; j++) 466 1.1.1.1.10.2 tls { 467 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, &SubElements[j], 468 1.1.1.1.10.2 tls Package->RetInfo2.ObjectType[j], j); 469 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 470 1.1.1.1.10.2 tls { 471 1.1.1.1.10.2 tls return (Status); 472 1.1.1.1.10.2 tls } 473 1.1.1.1.10.2 tls } 474 1.1.1.1.10.2 tls break; 475 1.1.1.1.10.2 tls 476 1.1.1.1.10.2 tls case ACPI_PTYPE2_MIN: 477 1.1.1.1.10.2 tls 478 1.1.1.1.10.2 tls /* Each sub-package has a variable but minimum length */ 479 1.1.1.1.10.2 tls 480 1.1.1.1.10.2 tls ExpectedCount = Package->RetInfo.Count1; 481 1.1.1.1.10.2 tls if (SubPackage->Package.Count < ExpectedCount) 482 1.1.1.1.10.2 tls { 483 1.1.1.1.10.2 tls goto PackageTooSmall; 484 1.1.1.1.10.2 tls } 485 1.1.1.1.10.2 tls 486 1.1.1.1.10.2 tls /* Check the type of each sub-package element */ 487 1.1.1.1.10.2 tls 488 1.1.1.1.10.2 tls Status = AcpiNsCheckPackageElements (Info, SubElements, 489 1.1.1.1.10.2 tls Package->RetInfo.ObjectType1, 490 1.1.1.1.10.2 tls SubPackage->Package.Count, 0, 0, 0); 491 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 492 1.1.1.1.10.2 tls { 493 1.1.1.1.10.2 tls return (Status); 494 1.1.1.1.10.2 tls } 495 1.1.1.1.10.2 tls break; 496 1.1.1.1.10.2 tls 497 1.1.1.1.10.2 tls case ACPI_PTYPE2_COUNT: 498 1.1.1.1.10.2 tls /* 499 1.1.1.1.10.2 tls * First element is the (Integer) count of elements, including 500 1.1.1.1.10.2 tls * the count field (the ACPI name is NumElements) 501 1.1.1.1.10.2 tls */ 502 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, SubElements, 503 1.1.1.1.10.2 tls ACPI_RTYPE_INTEGER, 0); 504 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 505 1.1.1.1.10.2 tls { 506 1.1.1.1.10.2 tls return (Status); 507 1.1.1.1.10.2 tls } 508 1.1.1.1.10.2 tls 509 1.1.1.1.10.2 tls /* 510 1.1.1.1.10.2 tls * Make sure package is large enough for the Count and is 511 1.1.1.1.10.2 tls * is as large as the minimum size 512 1.1.1.1.10.2 tls */ 513 1.1.1.1.10.2 tls ExpectedCount = (UINT32) (*SubElements)->Integer.Value; 514 1.1.1.1.10.2 tls if (SubPackage->Package.Count < ExpectedCount) 515 1.1.1.1.10.2 tls { 516 1.1.1.1.10.2 tls goto PackageTooSmall; 517 1.1.1.1.10.2 tls } 518 1.1.1.1.10.2 tls if (SubPackage->Package.Count < Package->RetInfo.Count1) 519 1.1.1.1.10.2 tls { 520 1.1.1.1.10.2 tls ExpectedCount = Package->RetInfo.Count1; 521 1.1.1.1.10.2 tls goto PackageTooSmall; 522 1.1.1.1.10.2 tls } 523 1.1.1.1.10.2 tls if (ExpectedCount == 0) 524 1.1.1.1.10.2 tls { 525 1.1.1.1.10.2 tls /* 526 1.1.1.1.10.2 tls * Either the NumEntries element was originally zero or it was 527 1.1.1.1.10.2 tls * a NULL element and repaired to an Integer of value zero. 528 1.1.1.1.10.2 tls * In either case, repair it by setting NumEntries to be the 529 1.1.1.1.10.2 tls * actual size of the subpackage. 530 1.1.1.1.10.2 tls */ 531 1.1.1.1.10.2 tls ExpectedCount = SubPackage->Package.Count; 532 1.1.1.1.10.2 tls (*SubElements)->Integer.Value = ExpectedCount; 533 1.1.1.1.10.2 tls } 534 1.1.1.1.10.2 tls 535 1.1.1.1.10.2 tls /* Check the type of each sub-package element */ 536 1.1.1.1.10.2 tls 537 1.1.1.1.10.2 tls Status = AcpiNsCheckPackageElements (Info, (SubElements + 1), 538 1.1.1.1.10.2 tls Package->RetInfo.ObjectType1, 539 1.1.1.1.10.2 tls (ExpectedCount - 1), 0, 0, 1); 540 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 541 1.1.1.1.10.2 tls { 542 1.1.1.1.10.2 tls return (Status); 543 1.1.1.1.10.2 tls } 544 1.1.1.1.10.2 tls break; 545 1.1.1.1.10.2 tls 546 1.1.1.1.10.2 tls default: /* Should not get here, type was validated by caller */ 547 1.1.1.1.10.2 tls 548 1.1.1.1.10.2 tls return (AE_AML_INTERNAL); 549 1.1.1.1.10.2 tls } 550 1.1.1.1.10.2 tls 551 1.1.1.1.10.2 tls Elements++; 552 1.1.1.1.10.2 tls } 553 1.1.1.1.10.2 tls 554 1.1.1.1.10.2 tls return (AE_OK); 555 1.1.1.1.10.2 tls 556 1.1.1.1.10.2 tls 557 1.1.1.1.10.2 tls PackageTooSmall: 558 1.1.1.1.10.2 tls 559 1.1.1.1.10.2 tls /* The sub-package count was smaller than required */ 560 1.1.1.1.10.2 tls 561 1.1.1.1.10.2 tls ACPI_WARN_PREDEFINED ((AE_INFO, Info->FullPathname, Info->NodeFlags, 562 1.1.1.1.10.2 tls "Return Sub-Package[%u] is too small - found %u elements, expected %u", 563 1.1.1.1.10.2 tls i, SubPackage->Package.Count, ExpectedCount)); 564 1.1.1.1.10.2 tls 565 1.1.1.1.10.2 tls return (AE_AML_OPERAND_VALUE); 566 1.1.1.1.10.2 tls } 567 1.1.1.1.10.2 tls 568 1.1.1.1.10.2 tls 569 1.1.1.1.10.2 tls /******************************************************************************* 570 1.1.1.1.10.2 tls * 571 1.1.1.1.10.2 tls * FUNCTION: AcpiNsCheckPackageElements 572 1.1.1.1.10.2 tls * 573 1.1.1.1.10.2 tls * PARAMETERS: Info - Method execution information block 574 1.1.1.1.10.2 tls * Elements - Pointer to the package elements array 575 1.1.1.1.10.2 tls * Type1 - Object type for first group 576 1.1.1.1.10.2 tls * Count1 - Count for first group 577 1.1.1.1.10.2 tls * Type2 - Object type for second group 578 1.1.1.1.10.2 tls * Count2 - Count for second group 579 1.1.1.1.10.2 tls * StartIndex - Start of the first group of elements 580 1.1.1.1.10.2 tls * 581 1.1.1.1.10.2 tls * RETURN: Status 582 1.1.1.1.10.2 tls * 583 1.1.1.1.10.2 tls * DESCRIPTION: Check that all elements of a package are of the correct object 584 1.1.1.1.10.2 tls * type. Supports up to two groups of different object types. 585 1.1.1.1.10.2 tls * 586 1.1.1.1.10.2 tls ******************************************************************************/ 587 1.1.1.1.10.2 tls 588 1.1.1.1.10.2 tls static ACPI_STATUS 589 1.1.1.1.10.2 tls AcpiNsCheckPackageElements ( 590 1.1.1.1.10.2 tls ACPI_EVALUATE_INFO *Info, 591 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT **Elements, 592 1.1.1.1.10.2 tls UINT8 Type1, 593 1.1.1.1.10.2 tls UINT32 Count1, 594 1.1.1.1.10.2 tls UINT8 Type2, 595 1.1.1.1.10.2 tls UINT32 Count2, 596 1.1.1.1.10.2 tls UINT32 StartIndex) 597 1.1.1.1.10.2 tls { 598 1.1.1.1.10.2 tls ACPI_OPERAND_OBJECT **ThisElement = Elements; 599 1.1.1.1.10.2 tls ACPI_STATUS Status; 600 1.1.1.1.10.2 tls UINT32 i; 601 1.1.1.1.10.2 tls 602 1.1.1.1.10.2 tls 603 1.1.1.1.10.2 tls /* 604 1.1.1.1.10.2 tls * Up to two groups of package elements are supported by the data 605 1.1.1.1.10.2 tls * structure. All elements in each group must be of the same type. 606 1.1.1.1.10.2 tls * The second group can have a count of zero. 607 1.1.1.1.10.2 tls */ 608 1.1.1.1.10.2 tls for (i = 0; i < Count1; i++) 609 1.1.1.1.10.2 tls { 610 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, ThisElement, 611 1.1.1.1.10.2 tls Type1, i + StartIndex); 612 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 613 1.1.1.1.10.2 tls { 614 1.1.1.1.10.2 tls return (Status); 615 1.1.1.1.10.2 tls } 616 1.1.1.1.10.2 tls ThisElement++; 617 1.1.1.1.10.2 tls } 618 1.1.1.1.10.2 tls 619 1.1.1.1.10.2 tls for (i = 0; i < Count2; i++) 620 1.1.1.1.10.2 tls { 621 1.1.1.1.10.2 tls Status = AcpiNsCheckObjectType (Info, ThisElement, 622 1.1.1.1.10.2 tls Type2, (i + Count1 + StartIndex)); 623 1.1.1.1.10.2 tls if (ACPI_FAILURE (Status)) 624 1.1.1.1.10.2 tls { 625 1.1.1.1.10.2 tls return (Status); 626 1.1.1.1.10.2 tls } 627 1.1.1.1.10.2 tls ThisElement++; 628 1.1.1.1.10.2 tls } 629 1.1.1.1.10.2 tls 630 1.1.1.1.10.2 tls return (AE_OK); 631 1.1.1.1.10.2 tls } 632
Indexes created Fri Oct 17 09:09:57 GMT 2025