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