Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | |
2 | /****************************************************************************** | |
3 | * | |
4 | * Module Name: exresnte - AML Interpreter object resolution | |
5 | * | |
6 | *****************************************************************************/ | |
7 | ||
8 | /* | |
9 | * Copyright (C) 2000 - 2005, R. Byron Moore | |
10 | * All rights reserved. | |
11 | * | |
12 | * Redistribution and use in source and binary forms, with or without | |
13 | * modification, are permitted provided that the following conditions | |
14 | * are met: | |
15 | * 1. Redistributions of source code must retain the above copyright | |
16 | * notice, this list of conditions, and the following disclaimer, | |
17 | * without modification. | |
18 | * 2. Redistributions in binary form must reproduce at minimum a disclaimer | |
19 | * substantially similar to the "NO WARRANTY" disclaimer below | |
20 | * ("Disclaimer") and any redistribution must be conditioned upon | |
21 | * including a substantially similar Disclaimer requirement for further | |
22 | * binary redistribution. | |
23 | * 3. Neither the names of the above-listed copyright holders nor the names | |
24 | * of any contributors may be used to endorse or promote products derived | |
25 | * from this software without specific prior written permission. | |
26 | * | |
27 | * Alternatively, this software may be distributed under the terms of the | |
28 | * GNU General Public License ("GPL") version 2 as published by the Free | |
29 | * Software Foundation. | |
30 | * | |
31 | * NO WARRANTY | |
32 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
33 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
34 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR | |
35 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
36 | * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
37 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
38 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
39 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, | |
40 | * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING | |
41 | * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | |
42 | * POSSIBILITY OF SUCH DAMAGES. | |
43 | */ | |
44 | ||
45 | ||
46 | #include <acpi/acpi.h> | |
47 | #include <acpi/acdispat.h> | |
48 | #include <acpi/acinterp.h> | |
49 | #include <acpi/acnamesp.h> | |
50 | #include <acpi/acparser.h> | |
51 | #include <acpi/amlcode.h> | |
52 | ||
53 | ||
54 | #define _COMPONENT ACPI_EXECUTER | |
55 | ACPI_MODULE_NAME ("exresnte") | |
56 | ||
57 | ||
58 | /******************************************************************************* | |
59 | * | |
60 | * FUNCTION: acpi_ex_resolve_node_to_value | |
61 | * | |
62 | * PARAMETERS: object_ptr - Pointer to a location that contains | |
63 | * a pointer to a NS node, and will receive a | |
64 | * pointer to the resolved object. | |
65 | * walk_state - Current state. Valid only if executing AML | |
66 | * code. NULL if simply resolving an object | |
67 | * | |
68 | * RETURN: Status | |
69 | * | |
70 | * DESCRIPTION: Resolve a Namespace node to a valued object | |
71 | * | |
72 | * Note: for some of the data types, the pointer attached to the Node | |
73 | * can be either a pointer to an actual internal object or a pointer into the | |
74 | * AML stream itself. These types are currently: | |
75 | * | |
76 | * ACPI_TYPE_INTEGER | |
77 | * ACPI_TYPE_STRING | |
78 | * ACPI_TYPE_BUFFER | |
79 | * ACPI_TYPE_MUTEX | |
80 | * ACPI_TYPE_PACKAGE | |
81 | * | |
82 | ******************************************************************************/ | |
83 | ||
84 | acpi_status | |
85 | acpi_ex_resolve_node_to_value ( | |
86 | struct acpi_namespace_node **object_ptr, | |
87 | struct acpi_walk_state *walk_state) | |
88 | ||
89 | { | |
90 | acpi_status status = AE_OK; | |
91 | union acpi_operand_object *source_desc; | |
92 | union acpi_operand_object *obj_desc = NULL; | |
93 | struct acpi_namespace_node *node; | |
94 | acpi_object_type entry_type; | |
95 | ||
96 | ||
97 | ACPI_FUNCTION_TRACE ("ex_resolve_node_to_value"); | |
98 | ||
99 | ||
100 | /* | |
101 | * The stack pointer points to a struct acpi_namespace_node (Node). Get the | |
102 | * object that is attached to the Node. | |
103 | */ | |
104 | node = *object_ptr; | |
105 | source_desc = acpi_ns_get_attached_object (node); | |
106 | entry_type = acpi_ns_get_type ((acpi_handle) node); | |
107 | ||
108 | ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Entry=%p source_desc=%p [%s]\n", | |
109 | node, source_desc, acpi_ut_get_type_name (entry_type))); | |
110 | ||
111 | if ((entry_type == ACPI_TYPE_LOCAL_ALIAS) || | |
112 | (entry_type == ACPI_TYPE_LOCAL_METHOD_ALIAS)) { | |
113 | /* There is always exactly one level of indirection */ | |
114 | ||
115 | node = ACPI_CAST_PTR (struct acpi_namespace_node, node->object); | |
116 | source_desc = acpi_ns_get_attached_object (node); | |
117 | entry_type = acpi_ns_get_type ((acpi_handle) node); | |
118 | *object_ptr = node; | |
119 | } | |
120 | ||
121 | /* | |
122 | * Several object types require no further processing: | |
123 | * 1) Devices rarely have an attached object, return the Node | |
124 | * 2) Method locals and arguments have a pseudo-Node | |
125 | */ | |
126 | if (entry_type == ACPI_TYPE_DEVICE || | |
127 | (node->flags & (ANOBJ_METHOD_ARG | ANOBJ_METHOD_LOCAL))) { | |
128 | return_ACPI_STATUS (AE_OK); | |
129 | } | |
130 | ||
131 | if (!source_desc) { | |
132 | ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "No object attached to node %p\n", | |
133 | node)); | |
134 | return_ACPI_STATUS (AE_AML_NO_OPERAND); | |
135 | } | |
136 | ||
137 | /* | |
138 | * Action is based on the type of the Node, which indicates the type | |
139 | * of the attached object or pointer | |
140 | */ | |
141 | switch (entry_type) { | |
142 | case ACPI_TYPE_PACKAGE: | |
143 | ||
144 | if (ACPI_GET_OBJECT_TYPE (source_desc) != ACPI_TYPE_PACKAGE) { | |
145 | ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Object not a Package, type %s\n", | |
146 | acpi_ut_get_object_type_name (source_desc))); | |
147 | return_ACPI_STATUS (AE_AML_OPERAND_TYPE); | |
148 | } | |
149 | ||
150 | status = acpi_ds_get_package_arguments (source_desc); | |
151 | if (ACPI_SUCCESS (status)) { | |
152 | /* Return an additional reference to the object */ | |
153 | ||
154 | obj_desc = source_desc; | |
155 | acpi_ut_add_reference (obj_desc); | |
156 | } | |
157 | break; | |
158 | ||
159 | ||
160 | case ACPI_TYPE_BUFFER: | |
161 | ||
162 | if (ACPI_GET_OBJECT_TYPE (source_desc) != ACPI_TYPE_BUFFER) { | |
163 | ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Object not a Buffer, type %s\n", | |
164 | acpi_ut_get_object_type_name (source_desc))); | |
165 | return_ACPI_STATUS (AE_AML_OPERAND_TYPE); | |
166 | } | |
167 | ||
168 | status = acpi_ds_get_buffer_arguments (source_desc); | |
169 | if (ACPI_SUCCESS (status)) { | |
170 | /* Return an additional reference to the object */ | |
171 | ||
172 | obj_desc = source_desc; | |
173 | acpi_ut_add_reference (obj_desc); | |
174 | } | |
175 | break; | |
176 | ||
177 | ||
178 | case ACPI_TYPE_STRING: | |
179 | ||
180 | if (ACPI_GET_OBJECT_TYPE (source_desc) != ACPI_TYPE_STRING) { | |
181 | ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Object not a String, type %s\n", | |
182 | acpi_ut_get_object_type_name (source_desc))); | |
183 | return_ACPI_STATUS (AE_AML_OPERAND_TYPE); | |
184 | } | |
185 | ||
186 | /* Return an additional reference to the object */ | |
187 | ||
188 | obj_desc = source_desc; | |
189 | acpi_ut_add_reference (obj_desc); | |
190 | break; | |
191 | ||
192 | ||
193 | case ACPI_TYPE_INTEGER: | |
194 | ||
195 | if (ACPI_GET_OBJECT_TYPE (source_desc) != ACPI_TYPE_INTEGER) { | |
196 | ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Object not a Integer, type %s\n", | |
197 | acpi_ut_get_object_type_name (source_desc))); | |
198 | return_ACPI_STATUS (AE_AML_OPERAND_TYPE); | |
199 | } | |
200 | ||
201 | /* Return an additional reference to the object */ | |
202 | ||
203 | obj_desc = source_desc; | |
204 | acpi_ut_add_reference (obj_desc); | |
205 | break; | |
206 | ||
207 | ||
208 | case ACPI_TYPE_BUFFER_FIELD: | |
209 | case ACPI_TYPE_LOCAL_REGION_FIELD: | |
210 | case ACPI_TYPE_LOCAL_BANK_FIELD: | |
211 | case ACPI_TYPE_LOCAL_INDEX_FIELD: | |
212 | ||
44f6c012 RM |
213 | ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, |
214 | "field_read Node=%p source_desc=%p Type=%X\n", | |
1da177e4 LT |
215 | node, source_desc, entry_type)); |
216 | ||
217 | status = acpi_ex_read_data_from_field (walk_state, source_desc, &obj_desc); | |
218 | break; | |
219 | ||
44f6c012 RM |
220 | /* For these objects, just return the object attached to the Node */ |
221 | ||
1da177e4 LT |
222 | case ACPI_TYPE_MUTEX: |
223 | case ACPI_TYPE_METHOD: | |
224 | case ACPI_TYPE_POWER: | |
225 | case ACPI_TYPE_PROCESSOR: | |
226 | case ACPI_TYPE_THERMAL: | |
227 | case ACPI_TYPE_EVENT: | |
228 | case ACPI_TYPE_REGION: | |
229 | ||
230 | /* Return an additional reference to the object */ | |
231 | ||
232 | obj_desc = source_desc; | |
233 | acpi_ut_add_reference (obj_desc); | |
234 | break; | |
235 | ||
1da177e4 LT |
236 | /* TYPE_ANY is untyped, and thus there is no object associated with it */ |
237 | ||
238 | case ACPI_TYPE_ANY: | |
239 | ||
44f6c012 RM |
240 | ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, |
241 | "Untyped entry %p, no attached object!\n", | |
1da177e4 LT |
242 | node)); |
243 | ||
244 | return_ACPI_STATUS (AE_AML_OPERAND_TYPE); /* Cannot be AE_TYPE */ | |
245 | ||
246 | ||
247 | case ACPI_TYPE_LOCAL_REFERENCE: | |
248 | ||
249 | switch (source_desc->reference.opcode) { | |
250 | case AML_LOAD_OP: | |
251 | ||
252 | /* This is a ddb_handle */ | |
253 | /* Return an additional reference to the object */ | |
254 | ||
255 | obj_desc = source_desc; | |
256 | acpi_ut_add_reference (obj_desc); | |
257 | break; | |
258 | ||
259 | default: | |
260 | /* No named references are allowed here */ | |
261 | ||
44f6c012 RM |
262 | ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, |
263 | "Unsupported Reference opcode %X (%s)\n", | |
1da177e4 LT |
264 | source_desc->reference.opcode, |
265 | acpi_ps_get_opcode_name (source_desc->reference.opcode))); | |
266 | ||
267 | return_ACPI_STATUS (AE_AML_OPERAND_TYPE); | |
268 | } | |
269 | break; | |
270 | ||
271 | ||
1da177e4 LT |
272 | default: |
273 | ||
44f6c012 RM |
274 | /* Default case is for unknown types */ |
275 | ||
276 | ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, | |
277 | "Node %p - Unknown object type %X\n", | |
1da177e4 LT |
278 | node, entry_type)); |
279 | ||
280 | return_ACPI_STATUS (AE_AML_OPERAND_TYPE); | |
281 | ||
282 | } /* switch (entry_type) */ | |
283 | ||
284 | ||
44f6c012 | 285 | /* Return the object descriptor */ |
1da177e4 LT |
286 | |
287 | *object_ptr = (void *) obj_desc; | |
288 | return_ACPI_STATUS (status); | |
289 | } | |
290 | ||
291 |