exresolv.c revision 1.1.1.2.2.2 1 1.1.1.2.2.2 bouyer
2 1.1.1.2.2.2 bouyer /******************************************************************************
3 1.1.1.2.2.2 bouyer *
4 1.1.1.2.2.2 bouyer * Module Name: exresolv - AML Interpreter object resolution
5 1.1.1.2.2.2 bouyer *
6 1.1.1.2.2.2 bouyer *****************************************************************************/
7 1.1.1.2.2.2 bouyer
8 1.1.1.2.2.2 bouyer /*
9 1.1.1.2.2.2 bouyer * Copyright (C) 2000 - 2011, Intel Corp.
10 1.1.1.2.2.2 bouyer * All rights reserved.
11 1.1.1.2.2.2 bouyer *
12 1.1.1.2.2.2 bouyer * Redistribution and use in source and binary forms, with or without
13 1.1.1.2.2.2 bouyer * modification, are permitted provided that the following conditions
14 1.1.1.2.2.2 bouyer * are met:
15 1.1.1.2.2.2 bouyer * 1. Redistributions of source code must retain the above copyright
16 1.1.1.2.2.2 bouyer * notice, this list of conditions, and the following disclaimer,
17 1.1.1.2.2.2 bouyer * without modification.
18 1.1.1.2.2.2 bouyer * 2. Redistributions in binary form must reproduce at minimum a disclaimer
19 1.1.1.2.2.2 bouyer * substantially similar to the "NO WARRANTY" disclaimer below
20 1.1.1.2.2.2 bouyer * ("Disclaimer") and any redistribution must be conditioned upon
21 1.1.1.2.2.2 bouyer * including a substantially similar Disclaimer requirement for further
22 1.1.1.2.2.2 bouyer * binary redistribution.
23 1.1.1.2.2.2 bouyer * 3. Neither the names of the above-listed copyright holders nor the names
24 1.1.1.2.2.2 bouyer * of any contributors may be used to endorse or promote products derived
25 1.1.1.2.2.2 bouyer * from this software without specific prior written permission.
26 1.1.1.2.2.2 bouyer *
27 1.1.1.2.2.2 bouyer * Alternatively, this software may be distributed under the terms of the
28 1.1.1.2.2.2 bouyer * GNU General Public License ("GPL") version 2 as published by the Free
29 1.1.1.2.2.2 bouyer * Software Foundation.
30 1.1.1.2.2.2 bouyer *
31 1.1.1.2.2.2 bouyer * NO WARRANTY
32 1.1.1.2.2.2 bouyer * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
33 1.1.1.2.2.2 bouyer * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
34 1.1.1.2.2.2 bouyer * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
35 1.1.1.2.2.2 bouyer * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
36 1.1.1.2.2.2 bouyer * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37 1.1.1.2.2.2 bouyer * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
38 1.1.1.2.2.2 bouyer * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
39 1.1.1.2.2.2 bouyer * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
40 1.1.1.2.2.2 bouyer * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
41 1.1.1.2.2.2 bouyer * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
42 1.1.1.2.2.2 bouyer * POSSIBILITY OF SUCH DAMAGES.
43 1.1.1.2.2.2 bouyer */
44 1.1.1.2.2.2 bouyer
45 1.1.1.2.2.2 bouyer #define __EXRESOLV_C__
46 1.1.1.2.2.2 bouyer
47 1.1.1.2.2.2 bouyer #include "acpi.h"
48 1.1.1.2.2.2 bouyer #include "accommon.h"
49 1.1.1.2.2.2 bouyer #include "amlcode.h"
50 1.1.1.2.2.2 bouyer #include "acdispat.h"
51 1.1.1.2.2.2 bouyer #include "acinterp.h"
52 1.1.1.2.2.2 bouyer #include "acnamesp.h"
53 1.1.1.2.2.2 bouyer
54 1.1.1.2.2.2 bouyer
55 1.1.1.2.2.2 bouyer #define _COMPONENT ACPI_EXECUTER
56 1.1.1.2.2.2 bouyer ACPI_MODULE_NAME ("exresolv")
57 1.1.1.2.2.2 bouyer
58 1.1.1.2.2.2 bouyer /* Local prototypes */
59 1.1.1.2.2.2 bouyer
60 1.1.1.2.2.2 bouyer static ACPI_STATUS
61 1.1.1.2.2.2 bouyer AcpiExResolveObjectToValue (
62 1.1.1.2.2.2 bouyer ACPI_OPERAND_OBJECT **StackPtr,
63 1.1.1.2.2.2 bouyer ACPI_WALK_STATE *WalkState);
64 1.1.1.2.2.2 bouyer
65 1.1.1.2.2.2 bouyer
66 1.1.1.2.2.2 bouyer /*******************************************************************************
67 1.1.1.2.2.2 bouyer *
68 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExResolveToValue
69 1.1.1.2.2.2 bouyer *
70 1.1.1.2.2.2 bouyer * PARAMETERS: **StackPtr - Points to entry on ObjStack, which can
71 1.1.1.2.2.2 bouyer * be either an (ACPI_OPERAND_OBJECT *)
72 1.1.1.2.2.2 bouyer * or an ACPI_HANDLE.
73 1.1.1.2.2.2 bouyer * WalkState - Current method state
74 1.1.1.2.2.2 bouyer *
75 1.1.1.2.2.2 bouyer * RETURN: Status
76 1.1.1.2.2.2 bouyer *
77 1.1.1.2.2.2 bouyer * DESCRIPTION: Convert Reference objects to values
78 1.1.1.2.2.2 bouyer *
79 1.1.1.2.2.2 bouyer ******************************************************************************/
80 1.1.1.2.2.2 bouyer
81 1.1.1.2.2.2 bouyer ACPI_STATUS
82 1.1.1.2.2.2 bouyer AcpiExResolveToValue (
83 1.1.1.2.2.2 bouyer ACPI_OPERAND_OBJECT **StackPtr,
84 1.1.1.2.2.2 bouyer ACPI_WALK_STATE *WalkState)
85 1.1.1.2.2.2 bouyer {
86 1.1.1.2.2.2 bouyer ACPI_STATUS Status;
87 1.1.1.2.2.2 bouyer
88 1.1.1.2.2.2 bouyer
89 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE_PTR (ExResolveToValue, StackPtr);
90 1.1.1.2.2.2 bouyer
91 1.1.1.2.2.2 bouyer
92 1.1.1.2.2.2 bouyer if (!StackPtr || !*StackPtr)
93 1.1.1.2.2.2 bouyer {
94 1.1.1.2.2.2 bouyer ACPI_ERROR ((AE_INFO, "Internal - null pointer"));
95 1.1.1.2.2.2 bouyer return_ACPI_STATUS (AE_AML_NO_OPERAND);
96 1.1.1.2.2.2 bouyer }
97 1.1.1.2.2.2 bouyer
98 1.1.1.2.2.2 bouyer /*
99 1.1.1.2.2.2 bouyer * The entity pointed to by the StackPtr can be either
100 1.1.1.2.2.2 bouyer * 1) A valid ACPI_OPERAND_OBJECT, or
101 1.1.1.2.2.2 bouyer * 2) A ACPI_NAMESPACE_NODE (NamedObj)
102 1.1.1.2.2.2 bouyer */
103 1.1.1.2.2.2 bouyer if (ACPI_GET_DESCRIPTOR_TYPE (*StackPtr) == ACPI_DESC_TYPE_OPERAND)
104 1.1.1.2.2.2 bouyer {
105 1.1.1.2.2.2 bouyer Status = AcpiExResolveObjectToValue (StackPtr, WalkState);
106 1.1.1.2.2.2 bouyer if (ACPI_FAILURE (Status))
107 1.1.1.2.2.2 bouyer {
108 1.1.1.2.2.2 bouyer return_ACPI_STATUS (Status);
109 1.1.1.2.2.2 bouyer }
110 1.1.1.2.2.2 bouyer
111 1.1.1.2.2.2 bouyer if (!*StackPtr)
112 1.1.1.2.2.2 bouyer {
113 1.1.1.2.2.2 bouyer ACPI_ERROR ((AE_INFO, "Internal - null pointer"));
114 1.1.1.2.2.2 bouyer return_ACPI_STATUS (AE_AML_NO_OPERAND);
115 1.1.1.2.2.2 bouyer }
116 1.1.1.2.2.2 bouyer }
117 1.1.1.2.2.2 bouyer
118 1.1.1.2.2.2 bouyer /*
119 1.1.1.2.2.2 bouyer * Object on the stack may have changed if AcpiExResolveObjectToValue()
120 1.1.1.2.2.2 bouyer * was called (i.e., we can't use an _else_ here.)
121 1.1.1.2.2.2 bouyer */
122 1.1.1.2.2.2 bouyer if (ACPI_GET_DESCRIPTOR_TYPE (*StackPtr) == ACPI_DESC_TYPE_NAMED)
123 1.1.1.2.2.2 bouyer {
124 1.1.1.2.2.2 bouyer Status = AcpiExResolveNodeToValue (
125 1.1.1.2.2.2 bouyer ACPI_CAST_INDIRECT_PTR (ACPI_NAMESPACE_NODE, StackPtr),
126 1.1.1.2.2.2 bouyer WalkState);
127 1.1.1.2.2.2 bouyer if (ACPI_FAILURE (Status))
128 1.1.1.2.2.2 bouyer {
129 1.1.1.2.2.2 bouyer return_ACPI_STATUS (Status);
130 1.1.1.2.2.2 bouyer }
131 1.1.1.2.2.2 bouyer }
132 1.1.1.2.2.2 bouyer
133 1.1.1.2.2.2 bouyer ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Resolved object %p\n", *StackPtr));
134 1.1.1.2.2.2 bouyer return_ACPI_STATUS (AE_OK);
135 1.1.1.2.2.2 bouyer }
136 1.1.1.2.2.2 bouyer
137 1.1.1.2.2.2 bouyer
138 1.1.1.2.2.2 bouyer /*******************************************************************************
139 1.1.1.2.2.2 bouyer *
140 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExResolveObjectToValue
141 1.1.1.2.2.2 bouyer *
142 1.1.1.2.2.2 bouyer * PARAMETERS: StackPtr - Pointer to an internal object
143 1.1.1.2.2.2 bouyer * WalkState - Current method state
144 1.1.1.2.2.2 bouyer *
145 1.1.1.2.2.2 bouyer * RETURN: Status
146 1.1.1.2.2.2 bouyer *
147 1.1.1.2.2.2 bouyer * DESCRIPTION: Retrieve the value from an internal object. The Reference type
148 1.1.1.2.2.2 bouyer * uses the associated AML opcode to determine the value.
149 1.1.1.2.2.2 bouyer *
150 1.1.1.2.2.2 bouyer ******************************************************************************/
151 1.1.1.2.2.2 bouyer
152 1.1.1.2.2.2 bouyer static ACPI_STATUS
153 1.1.1.2.2.2 bouyer AcpiExResolveObjectToValue (
154 1.1.1.2.2.2 bouyer ACPI_OPERAND_OBJECT **StackPtr,
155 1.1.1.2.2.2 bouyer ACPI_WALK_STATE *WalkState)
156 1.1.1.2.2.2 bouyer {
157 1.1.1.2.2.2 bouyer ACPI_STATUS Status = AE_OK;
158 1.1.1.2.2.2 bouyer ACPI_OPERAND_OBJECT *StackDesc;
159 1.1.1.2.2.2 bouyer ACPI_OPERAND_OBJECT *ObjDesc = NULL;
160 1.1.1.2.2.2 bouyer UINT8 RefType;
161 1.1.1.2.2.2 bouyer
162 1.1.1.2.2.2 bouyer
163 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE (ExResolveObjectToValue);
164 1.1.1.2.2.2 bouyer
165 1.1.1.2.2.2 bouyer
166 1.1.1.2.2.2 bouyer StackDesc = *StackPtr;
167 1.1.1.2.2.2 bouyer
168 1.1.1.2.2.2 bouyer /* This is an ACPI_OPERAND_OBJECT */
169 1.1.1.2.2.2 bouyer
170 1.1.1.2.2.2 bouyer switch (StackDesc->Common.Type)
171 1.1.1.2.2.2 bouyer {
172 1.1.1.2.2.2 bouyer case ACPI_TYPE_LOCAL_REFERENCE:
173 1.1.1.2.2.2 bouyer
174 1.1.1.2.2.2 bouyer RefType = StackDesc->Reference.Class;
175 1.1.1.2.2.2 bouyer
176 1.1.1.2.2.2 bouyer switch (RefType)
177 1.1.1.2.2.2 bouyer {
178 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_LOCAL:
179 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_ARG:
180 1.1.1.2.2.2 bouyer
181 1.1.1.2.2.2 bouyer /*
182 1.1.1.2.2.2 bouyer * Get the local from the method's state info
183 1.1.1.2.2.2 bouyer * Note: this increments the local's object reference count
184 1.1.1.2.2.2 bouyer */
185 1.1.1.2.2.2 bouyer Status = AcpiDsMethodDataGetValue (RefType,
186 1.1.1.2.2.2 bouyer StackDesc->Reference.Value, WalkState, &ObjDesc);
187 1.1.1.2.2.2 bouyer if (ACPI_FAILURE (Status))
188 1.1.1.2.2.2 bouyer {
189 1.1.1.2.2.2 bouyer return_ACPI_STATUS (Status);
190 1.1.1.2.2.2 bouyer }
191 1.1.1.2.2.2 bouyer
192 1.1.1.2.2.2 bouyer ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[Arg/Local %X] ValueObj is %p\n",
193 1.1.1.2.2.2 bouyer StackDesc->Reference.Value, ObjDesc));
194 1.1.1.2.2.2 bouyer
195 1.1.1.2.2.2 bouyer /*
196 1.1.1.2.2.2 bouyer * Now we can delete the original Reference Object and
197 1.1.1.2.2.2 bouyer * replace it with the resolved value
198 1.1.1.2.2.2 bouyer */
199 1.1.1.2.2.2 bouyer AcpiUtRemoveReference (StackDesc);
200 1.1.1.2.2.2 bouyer *StackPtr = ObjDesc;
201 1.1.1.2.2.2 bouyer break;
202 1.1.1.2.2.2 bouyer
203 1.1.1.2.2.2 bouyer
204 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_INDEX:
205 1.1.1.2.2.2 bouyer
206 1.1.1.2.2.2 bouyer switch (StackDesc->Reference.TargetType)
207 1.1.1.2.2.2 bouyer {
208 1.1.1.2.2.2 bouyer case ACPI_TYPE_BUFFER_FIELD:
209 1.1.1.2.2.2 bouyer
210 1.1.1.2.2.2 bouyer /* Just return - do not dereference */
211 1.1.1.2.2.2 bouyer break;
212 1.1.1.2.2.2 bouyer
213 1.1.1.2.2.2 bouyer
214 1.1.1.2.2.2 bouyer case ACPI_TYPE_PACKAGE:
215 1.1.1.2.2.2 bouyer
216 1.1.1.2.2.2 bouyer /* If method call or CopyObject - do not dereference */
217 1.1.1.2.2.2 bouyer
218 1.1.1.2.2.2 bouyer if ((WalkState->Opcode == AML_INT_METHODCALL_OP) ||
219 1.1.1.2.2.2 bouyer (WalkState->Opcode == AML_COPY_OP))
220 1.1.1.2.2.2 bouyer {
221 1.1.1.2.2.2 bouyer break;
222 1.1.1.2.2.2 bouyer }
223 1.1.1.2.2.2 bouyer
224 1.1.1.2.2.2 bouyer /* Otherwise, dereference the PackageIndex to a package element */
225 1.1.1.2.2.2 bouyer
226 1.1.1.2.2.2 bouyer ObjDesc = *StackDesc->Reference.Where;
227 1.1.1.2.2.2 bouyer if (ObjDesc)
228 1.1.1.2.2.2 bouyer {
229 1.1.1.2.2.2 bouyer /*
230 1.1.1.2.2.2 bouyer * Valid object descriptor, copy pointer to return value
231 1.1.1.2.2.2 bouyer * (i.e., dereference the package index)
232 1.1.1.2.2.2 bouyer * Delete the ref object, increment the returned object
233 1.1.1.2.2.2 bouyer */
234 1.1.1.2.2.2 bouyer AcpiUtRemoveReference (StackDesc);
235 1.1.1.2.2.2 bouyer AcpiUtAddReference (ObjDesc);
236 1.1.1.2.2.2 bouyer *StackPtr = ObjDesc;
237 1.1.1.2.2.2 bouyer }
238 1.1.1.2.2.2 bouyer else
239 1.1.1.2.2.2 bouyer {
240 1.1.1.2.2.2 bouyer /*
241 1.1.1.2.2.2 bouyer * A NULL object descriptor means an uninitialized element of
242 1.1.1.2.2.2 bouyer * the package, can't dereference it
243 1.1.1.2.2.2 bouyer */
244 1.1.1.2.2.2 bouyer ACPI_ERROR ((AE_INFO,
245 1.1.1.2.2.2 bouyer "Attempt to dereference an Index to NULL package element Idx=%p",
246 1.1.1.2.2.2 bouyer StackDesc));
247 1.1.1.2.2.2 bouyer Status = AE_AML_UNINITIALIZED_ELEMENT;
248 1.1.1.2.2.2 bouyer }
249 1.1.1.2.2.2 bouyer break;
250 1.1.1.2.2.2 bouyer
251 1.1.1.2.2.2 bouyer
252 1.1.1.2.2.2 bouyer default:
253 1.1.1.2.2.2 bouyer
254 1.1.1.2.2.2 bouyer /* Invalid reference object */
255 1.1.1.2.2.2 bouyer
256 1.1.1.2.2.2 bouyer ACPI_ERROR ((AE_INFO,
257 1.1.1.2.2.2 bouyer "Unknown TargetType 0x%X in Index/Reference object %p",
258 1.1.1.2.2.2 bouyer StackDesc->Reference.TargetType, StackDesc));
259 1.1.1.2.2.2 bouyer Status = AE_AML_INTERNAL;
260 1.1.1.2.2.2 bouyer break;
261 1.1.1.2.2.2 bouyer }
262 1.1.1.2.2.2 bouyer break;
263 1.1.1.2.2.2 bouyer
264 1.1.1.2.2.2 bouyer
265 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_REFOF:
266 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_DEBUG:
267 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_TABLE:
268 1.1.1.2.2.2 bouyer
269 1.1.1.2.2.2 bouyer /* Just leave the object as-is, do not dereference */
270 1.1.1.2.2.2 bouyer
271 1.1.1.2.2.2 bouyer break;
272 1.1.1.2.2.2 bouyer
273 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_NAME: /* Reference to a named object */
274 1.1.1.2.2.2 bouyer
275 1.1.1.2.2.2 bouyer /* Dereference the name */
276 1.1.1.2.2.2 bouyer
277 1.1.1.2.2.2 bouyer if ((StackDesc->Reference.Node->Type == ACPI_TYPE_DEVICE) ||
278 1.1.1.2.2.2 bouyer (StackDesc->Reference.Node->Type == ACPI_TYPE_THERMAL))
279 1.1.1.2.2.2 bouyer {
280 1.1.1.2.2.2 bouyer /* These node types do not have 'real' subobjects */
281 1.1.1.2.2.2 bouyer
282 1.1.1.2.2.2 bouyer *StackPtr = (void *) StackDesc->Reference.Node;
283 1.1.1.2.2.2 bouyer }
284 1.1.1.2.2.2 bouyer else
285 1.1.1.2.2.2 bouyer {
286 1.1.1.2.2.2 bouyer /* Get the object pointed to by the namespace node */
287 1.1.1.2.2.2 bouyer
288 1.1.1.2.2.2 bouyer *StackPtr = (StackDesc->Reference.Node)->Object;
289 1.1.1.2.2.2 bouyer AcpiUtAddReference (*StackPtr);
290 1.1.1.2.2.2 bouyer }
291 1.1.1.2.2.2 bouyer
292 1.1.1.2.2.2 bouyer AcpiUtRemoveReference (StackDesc);
293 1.1.1.2.2.2 bouyer break;
294 1.1.1.2.2.2 bouyer
295 1.1.1.2.2.2 bouyer default:
296 1.1.1.2.2.2 bouyer
297 1.1.1.2.2.2 bouyer ACPI_ERROR ((AE_INFO,
298 1.1.1.2.2.2 bouyer "Unknown Reference type 0x%X in %p", RefType, StackDesc));
299 1.1.1.2.2.2 bouyer Status = AE_AML_INTERNAL;
300 1.1.1.2.2.2 bouyer break;
301 1.1.1.2.2.2 bouyer }
302 1.1.1.2.2.2 bouyer break;
303 1.1.1.2.2.2 bouyer
304 1.1.1.2.2.2 bouyer
305 1.1.1.2.2.2 bouyer case ACPI_TYPE_BUFFER:
306 1.1.1.2.2.2 bouyer
307 1.1.1.2.2.2 bouyer Status = AcpiDsGetBufferArguments (StackDesc);
308 1.1.1.2.2.2 bouyer break;
309 1.1.1.2.2.2 bouyer
310 1.1.1.2.2.2 bouyer
311 1.1.1.2.2.2 bouyer case ACPI_TYPE_PACKAGE:
312 1.1.1.2.2.2 bouyer
313 1.1.1.2.2.2 bouyer Status = AcpiDsGetPackageArguments (StackDesc);
314 1.1.1.2.2.2 bouyer break;
315 1.1.1.2.2.2 bouyer
316 1.1.1.2.2.2 bouyer
317 1.1.1.2.2.2 bouyer case ACPI_TYPE_BUFFER_FIELD:
318 1.1.1.2.2.2 bouyer case ACPI_TYPE_LOCAL_REGION_FIELD:
319 1.1.1.2.2.2 bouyer case ACPI_TYPE_LOCAL_BANK_FIELD:
320 1.1.1.2.2.2 bouyer case ACPI_TYPE_LOCAL_INDEX_FIELD:
321 1.1.1.2.2.2 bouyer
322 1.1.1.2.2.2 bouyer ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "FieldRead SourceDesc=%p Type=%X\n",
323 1.1.1.2.2.2 bouyer StackDesc, StackDesc->Common.Type));
324 1.1.1.2.2.2 bouyer
325 1.1.1.2.2.2 bouyer Status = AcpiExReadDataFromField (WalkState, StackDesc, &ObjDesc);
326 1.1.1.2.2.2 bouyer
327 1.1.1.2.2.2 bouyer /* Remove a reference to the original operand, then override */
328 1.1.1.2.2.2 bouyer
329 1.1.1.2.2.2 bouyer AcpiUtRemoveReference (*StackPtr);
330 1.1.1.2.2.2 bouyer *StackPtr = (void *) ObjDesc;
331 1.1.1.2.2.2 bouyer break;
332 1.1.1.2.2.2 bouyer
333 1.1.1.2.2.2 bouyer default:
334 1.1.1.2.2.2 bouyer break;
335 1.1.1.2.2.2 bouyer }
336 1.1.1.2.2.2 bouyer
337 1.1.1.2.2.2 bouyer return_ACPI_STATUS (Status);
338 1.1.1.2.2.2 bouyer }
339 1.1.1.2.2.2 bouyer
340 1.1.1.2.2.2 bouyer
341 1.1.1.2.2.2 bouyer /*******************************************************************************
342 1.1.1.2.2.2 bouyer *
343 1.1.1.2.2.2 bouyer * FUNCTION: AcpiExResolveMultiple
344 1.1.1.2.2.2 bouyer *
345 1.1.1.2.2.2 bouyer * PARAMETERS: WalkState - Current state (contains AML opcode)
346 1.1.1.2.2.2 bouyer * Operand - Starting point for resolution
347 1.1.1.2.2.2 bouyer * ReturnType - Where the object type is returned
348 1.1.1.2.2.2 bouyer * ReturnDesc - Where the resolved object is returned
349 1.1.1.2.2.2 bouyer *
350 1.1.1.2.2.2 bouyer * RETURN: Status
351 1.1.1.2.2.2 bouyer *
352 1.1.1.2.2.2 bouyer * DESCRIPTION: Return the base object and type. Traverse a reference list if
353 1.1.1.2.2.2 bouyer * necessary to get to the base object.
354 1.1.1.2.2.2 bouyer *
355 1.1.1.2.2.2 bouyer ******************************************************************************/
356 1.1.1.2.2.2 bouyer
357 1.1.1.2.2.2 bouyer ACPI_STATUS
358 1.1.1.2.2.2 bouyer AcpiExResolveMultiple (
359 1.1.1.2.2.2 bouyer ACPI_WALK_STATE *WalkState,
360 1.1.1.2.2.2 bouyer ACPI_OPERAND_OBJECT *Operand,
361 1.1.1.2.2.2 bouyer ACPI_OBJECT_TYPE *ReturnType,
362 1.1.1.2.2.2 bouyer ACPI_OPERAND_OBJECT **ReturnDesc)
363 1.1.1.2.2.2 bouyer {
364 1.1.1.2.2.2 bouyer ACPI_OPERAND_OBJECT *ObjDesc = (void *) Operand;
365 1.1.1.2.2.2 bouyer ACPI_NAMESPACE_NODE *Node;
366 1.1.1.2.2.2 bouyer ACPI_OBJECT_TYPE Type;
367 1.1.1.2.2.2 bouyer ACPI_STATUS Status;
368 1.1.1.2.2.2 bouyer
369 1.1.1.2.2.2 bouyer
370 1.1.1.2.2.2 bouyer ACPI_FUNCTION_TRACE (AcpiExResolveMultiple);
371 1.1.1.2.2.2 bouyer
372 1.1.1.2.2.2 bouyer
373 1.1.1.2.2.2 bouyer /* Operand can be either a namespace node or an operand descriptor */
374 1.1.1.2.2.2 bouyer
375 1.1.1.2.2.2 bouyer switch (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc))
376 1.1.1.2.2.2 bouyer {
377 1.1.1.2.2.2 bouyer case ACPI_DESC_TYPE_OPERAND:
378 1.1.1.2.2.2 bouyer Type = ObjDesc->Common.Type;
379 1.1.1.2.2.2 bouyer break;
380 1.1.1.2.2.2 bouyer
381 1.1.1.2.2.2 bouyer case ACPI_DESC_TYPE_NAMED:
382 1.1.1.2.2.2 bouyer Type = ((ACPI_NAMESPACE_NODE *) ObjDesc)->Type;
383 1.1.1.2.2.2 bouyer ObjDesc = AcpiNsGetAttachedObject ((ACPI_NAMESPACE_NODE *) ObjDesc);
384 1.1.1.2.2.2 bouyer
385 1.1.1.2.2.2 bouyer /* If we had an Alias node, use the attached object for type info */
386 1.1.1.2.2.2 bouyer
387 1.1.1.2.2.2 bouyer if (Type == ACPI_TYPE_LOCAL_ALIAS)
388 1.1.1.2.2.2 bouyer {
389 1.1.1.2.2.2 bouyer Type = ((ACPI_NAMESPACE_NODE *) ObjDesc)->Type;
390 1.1.1.2.2.2 bouyer ObjDesc = AcpiNsGetAttachedObject ((ACPI_NAMESPACE_NODE *) ObjDesc);
391 1.1.1.2.2.2 bouyer }
392 1.1.1.2.2.2 bouyer break;
393 1.1.1.2.2.2 bouyer
394 1.1.1.2.2.2 bouyer default:
395 1.1.1.2.2.2 bouyer return_ACPI_STATUS (AE_AML_OPERAND_TYPE);
396 1.1.1.2.2.2 bouyer }
397 1.1.1.2.2.2 bouyer
398 1.1.1.2.2.2 bouyer /* If type is anything other than a reference, we are done */
399 1.1.1.2.2.2 bouyer
400 1.1.1.2.2.2 bouyer if (Type != ACPI_TYPE_LOCAL_REFERENCE)
401 1.1.1.2.2.2 bouyer {
402 1.1.1.2.2.2 bouyer goto Exit;
403 1.1.1.2.2.2 bouyer }
404 1.1.1.2.2.2 bouyer
405 1.1.1.2.2.2 bouyer /*
406 1.1.1.2.2.2 bouyer * For reference objects created via the RefOf, Index, or Load/LoadTable
407 1.1.1.2.2.2 bouyer * operators, we need to get to the base object (as per the ACPI
408 1.1.1.2.2.2 bouyer * specification of the ObjectType and SizeOf operators). This means
409 1.1.1.2.2.2 bouyer * traversing the list of possibly many nested references.
410 1.1.1.2.2.2 bouyer */
411 1.1.1.2.2.2 bouyer while (ObjDesc->Common.Type == ACPI_TYPE_LOCAL_REFERENCE)
412 1.1.1.2.2.2 bouyer {
413 1.1.1.2.2.2 bouyer switch (ObjDesc->Reference.Class)
414 1.1.1.2.2.2 bouyer {
415 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_REFOF:
416 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_NAME:
417 1.1.1.2.2.2 bouyer
418 1.1.1.2.2.2 bouyer /* Dereference the reference pointer */
419 1.1.1.2.2.2 bouyer
420 1.1.1.2.2.2 bouyer if (ObjDesc->Reference.Class == ACPI_REFCLASS_REFOF)
421 1.1.1.2.2.2 bouyer {
422 1.1.1.2.2.2 bouyer Node = ObjDesc->Reference.Object;
423 1.1.1.2.2.2 bouyer }
424 1.1.1.2.2.2 bouyer else /* AML_INT_NAMEPATH_OP */
425 1.1.1.2.2.2 bouyer {
426 1.1.1.2.2.2 bouyer Node = ObjDesc->Reference.Node;
427 1.1.1.2.2.2 bouyer }
428 1.1.1.2.2.2 bouyer
429 1.1.1.2.2.2 bouyer /* All "References" point to a NS node */
430 1.1.1.2.2.2 bouyer
431 1.1.1.2.2.2 bouyer if (ACPI_GET_DESCRIPTOR_TYPE (Node) != ACPI_DESC_TYPE_NAMED)
432 1.1.1.2.2.2 bouyer {
433 1.1.1.2.2.2 bouyer ACPI_ERROR ((AE_INFO,
434 1.1.1.2.2.2 bouyer "Not a namespace node %p [%s]",
435 1.1.1.2.2.2 bouyer Node, AcpiUtGetDescriptorName (Node)));
436 1.1.1.2.2.2 bouyer return_ACPI_STATUS (AE_AML_INTERNAL);
437 1.1.1.2.2.2 bouyer }
438 1.1.1.2.2.2 bouyer
439 1.1.1.2.2.2 bouyer /* Get the attached object */
440 1.1.1.2.2.2 bouyer
441 1.1.1.2.2.2 bouyer ObjDesc = AcpiNsGetAttachedObject (Node);
442 1.1.1.2.2.2 bouyer if (!ObjDesc)
443 1.1.1.2.2.2 bouyer {
444 1.1.1.2.2.2 bouyer /* No object, use the NS node type */
445 1.1.1.2.2.2 bouyer
446 1.1.1.2.2.2 bouyer Type = AcpiNsGetType (Node);
447 1.1.1.2.2.2 bouyer goto Exit;
448 1.1.1.2.2.2 bouyer }
449 1.1.1.2.2.2 bouyer
450 1.1.1.2.2.2 bouyer /* Check for circular references */
451 1.1.1.2.2.2 bouyer
452 1.1.1.2.2.2 bouyer if (ObjDesc == Operand)
453 1.1.1.2.2.2 bouyer {
454 1.1.1.2.2.2 bouyer return_ACPI_STATUS (AE_AML_CIRCULAR_REFERENCE);
455 1.1.1.2.2.2 bouyer }
456 1.1.1.2.2.2 bouyer break;
457 1.1.1.2.2.2 bouyer
458 1.1.1.2.2.2 bouyer
459 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_INDEX:
460 1.1.1.2.2.2 bouyer
461 1.1.1.2.2.2 bouyer /* Get the type of this reference (index into another object) */
462 1.1.1.2.2.2 bouyer
463 1.1.1.2.2.2 bouyer Type = ObjDesc->Reference.TargetType;
464 1.1.1.2.2.2 bouyer if (Type != ACPI_TYPE_PACKAGE)
465 1.1.1.2.2.2 bouyer {
466 1.1.1.2.2.2 bouyer goto Exit;
467 1.1.1.2.2.2 bouyer }
468 1.1.1.2.2.2 bouyer
469 1.1.1.2.2.2 bouyer /*
470 1.1.1.2.2.2 bouyer * The main object is a package, we want to get the type
471 1.1.1.2.2.2 bouyer * of the individual package element that is referenced by
472 1.1.1.2.2.2 bouyer * the index.
473 1.1.1.2.2.2 bouyer *
474 1.1.1.2.2.2 bouyer * This could of course in turn be another reference object.
475 1.1.1.2.2.2 bouyer */
476 1.1.1.2.2.2 bouyer ObjDesc = *(ObjDesc->Reference.Where);
477 1.1.1.2.2.2 bouyer if (!ObjDesc)
478 1.1.1.2.2.2 bouyer {
479 1.1.1.2.2.2 bouyer /* NULL package elements are allowed */
480 1.1.1.2.2.2 bouyer
481 1.1.1.2.2.2 bouyer Type = 0; /* Uninitialized */
482 1.1.1.2.2.2 bouyer goto Exit;
483 1.1.1.2.2.2 bouyer }
484 1.1.1.2.2.2 bouyer break;
485 1.1.1.2.2.2 bouyer
486 1.1.1.2.2.2 bouyer
487 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_TABLE:
488 1.1.1.2.2.2 bouyer
489 1.1.1.2.2.2 bouyer Type = ACPI_TYPE_DDB_HANDLE;
490 1.1.1.2.2.2 bouyer goto Exit;
491 1.1.1.2.2.2 bouyer
492 1.1.1.2.2.2 bouyer
493 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_LOCAL:
494 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_ARG:
495 1.1.1.2.2.2 bouyer
496 1.1.1.2.2.2 bouyer if (ReturnDesc)
497 1.1.1.2.2.2 bouyer {
498 1.1.1.2.2.2 bouyer Status = AcpiDsMethodDataGetValue (ObjDesc->Reference.Class,
499 1.1.1.2.2.2 bouyer ObjDesc->Reference.Value, WalkState, &ObjDesc);
500 1.1.1.2.2.2 bouyer if (ACPI_FAILURE (Status))
501 1.1.1.2.2.2 bouyer {
502 1.1.1.2.2.2 bouyer return_ACPI_STATUS (Status);
503 1.1.1.2.2.2 bouyer }
504 1.1.1.2.2.2 bouyer AcpiUtRemoveReference (ObjDesc);
505 1.1.1.2.2.2 bouyer }
506 1.1.1.2.2.2 bouyer else
507 1.1.1.2.2.2 bouyer {
508 1.1.1.2.2.2 bouyer Status = AcpiDsMethodDataGetNode (ObjDesc->Reference.Class,
509 1.1.1.2.2.2 bouyer ObjDesc->Reference.Value, WalkState, &Node);
510 1.1.1.2.2.2 bouyer if (ACPI_FAILURE (Status))
511 1.1.1.2.2.2 bouyer {
512 1.1.1.2.2.2 bouyer return_ACPI_STATUS (Status);
513 1.1.1.2.2.2 bouyer }
514 1.1.1.2.2.2 bouyer
515 1.1.1.2.2.2 bouyer ObjDesc = AcpiNsGetAttachedObject (Node);
516 1.1.1.2.2.2 bouyer if (!ObjDesc)
517 1.1.1.2.2.2 bouyer {
518 1.1.1.2.2.2 bouyer Type = ACPI_TYPE_ANY;
519 1.1.1.2.2.2 bouyer goto Exit;
520 1.1.1.2.2.2 bouyer }
521 1.1.1.2.2.2 bouyer }
522 1.1.1.2.2.2 bouyer break;
523 1.1.1.2.2.2 bouyer
524 1.1.1.2.2.2 bouyer
525 1.1.1.2.2.2 bouyer case ACPI_REFCLASS_DEBUG:
526 1.1.1.2.2.2 bouyer
527 1.1.1.2.2.2 bouyer /* The Debug Object is of type "DebugObject" */
528 1.1.1.2.2.2 bouyer
529 1.1.1.2.2.2 bouyer Type = ACPI_TYPE_DEBUG_OBJECT;
530 1.1.1.2.2.2 bouyer goto Exit;
531 1.1.1.2.2.2 bouyer
532 1.1.1.2.2.2 bouyer
533 1.1.1.2.2.2 bouyer default:
534 1.1.1.2.2.2 bouyer
535 1.1.1.2.2.2 bouyer ACPI_ERROR ((AE_INFO,
536 1.1.1.2.2.2 bouyer "Unknown Reference Class 0x%2.2X", ObjDesc->Reference.Class));
537 1.1.1.2.2.2 bouyer return_ACPI_STATUS (AE_AML_INTERNAL);
538 1.1.1.2.2.2 bouyer }
539 1.1.1.2.2.2 bouyer }
540 1.1.1.2.2.2 bouyer
541 1.1.1.2.2.2 bouyer /*
542 1.1.1.2.2.2 bouyer * Now we are guaranteed to have an object that has not been created
543 1.1.1.2.2.2 bouyer * via the RefOf or Index operators.
544 1.1.1.2.2.2 bouyer */
545 1.1.1.2.2.2 bouyer Type = ObjDesc->Common.Type;
546 1.1.1.2.2.2 bouyer
547 1.1.1.2.2.2 bouyer
548 1.1.1.2.2.2 bouyer Exit:
549 1.1.1.2.2.2 bouyer /* Convert internal types to external types */
550 1.1.1.2.2.2 bouyer
551 1.1.1.2.2.2 bouyer switch (Type)
552 1.1.1.2.2.2 bouyer {
553 1.1.1.2.2.2 bouyer case ACPI_TYPE_LOCAL_REGION_FIELD:
554 1.1.1.2.2.2 bouyer case ACPI_TYPE_LOCAL_BANK_FIELD:
555 1.1.1.2.2.2 bouyer case ACPI_TYPE_LOCAL_INDEX_FIELD:
556 1.1.1.2.2.2 bouyer
557 1.1.1.2.2.2 bouyer Type = ACPI_TYPE_FIELD_UNIT;
558 1.1.1.2.2.2 bouyer break;
559 1.1.1.2.2.2 bouyer
560 1.1.1.2.2.2 bouyer case ACPI_TYPE_LOCAL_SCOPE:
561 1.1.1.2.2.2 bouyer
562 1.1.1.2.2.2 bouyer /* Per ACPI Specification, Scope is untyped */
563 1.1.1.2.2.2 bouyer
564 1.1.1.2.2.2 bouyer Type = ACPI_TYPE_ANY;
565 1.1.1.2.2.2 bouyer break;
566 1.1.1.2.2.2 bouyer
567 1.1.1.2.2.2 bouyer default:
568 1.1.1.2.2.2 bouyer /* No change to Type required */
569 1.1.1.2.2.2 bouyer break;
570 1.1.1.2.2.2 bouyer }
571 1.1.1.2.2.2 bouyer
572 1.1.1.2.2.2 bouyer *ReturnType = Type;
573 1.1.1.2.2.2 bouyer if (ReturnDesc)
574 1.1.1.2.2.2 bouyer {
575 1.1.1.2.2.2 bouyer *ReturnDesc = ObjDesc;
576 1.1.1.2.2.2 bouyer }
577 1.1.1.2.2.2 bouyer return_ACPI_STATUS (AE_OK);
578 1.1.1.2.2.2 bouyer }
579 1.1.1.2.2.2 bouyer
580 1.1.1.2.2.2 bouyer
581