2 /******************************************************************************
4 * Module Name: exstoren - AML Interpreter object store support,
5 * Store to Node (namespace object)
7 *****************************************************************************/
10 * Copyright (C) 2000 - 2005, R. Byron Moore
11 * All rights reserved.
13 * Redistribution and use in source and binary forms, with or without
14 * modification, are permitted provided that the following conditions
16 * 1. Redistributions of source code must retain the above copyright
17 * notice, this list of conditions, and the following disclaimer,
18 * without modification.
19 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
20 * substantially similar to the "NO WARRANTY" disclaimer below
21 * ("Disclaimer") and any redistribution must be conditioned upon
22 * including a substantially similar Disclaimer requirement for further
23 * binary redistribution.
24 * 3. Neither the names of the above-listed copyright holders nor the names
25 * of any contributors may be used to endorse or promote products derived
26 * from this software without specific prior written permission.
28 * Alternatively, this software may be distributed under the terms of the
29 * GNU General Public License ("GPL") version 2 as published by the Free
30 * Software Foundation.
33 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
34 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
35 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
36 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
37 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
38 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
39 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
40 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
41 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
42 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
43 * POSSIBILITY OF SUCH DAMAGES.
47 #include <acpi/acpi.h>
48 #include <acpi/acinterp.h>
49 #include <acpi/amlcode.h>
52 #define _COMPONENT ACPI_EXECUTER
53 ACPI_MODULE_NAME ("exstoren")
56 /*******************************************************************************
58 * FUNCTION: acpi_ex_resolve_object
60 * PARAMETERS: source_desc_ptr - Pointer to the source object
61 * target_type - Current type of the target
62 * walk_state - Current walk state
64 * RETURN: Status, resolved object in source_desc_ptr.
66 * DESCRIPTION: Resolve an object. If the object is a reference, dereference
67 * it and return the actual object in the source_desc_ptr.
69 ******************************************************************************/
72 acpi_ex_resolve_object (
73 union acpi_operand_object
**source_desc_ptr
,
74 acpi_object_type target_type
,
75 struct acpi_walk_state
*walk_state
)
77 union acpi_operand_object
*source_desc
= *source_desc_ptr
;
78 acpi_status status
= AE_OK
;
81 ACPI_FUNCTION_TRACE ("ex_resolve_object");
84 /* Ensure we have a Target that can be stored to */
86 switch (target_type
) {
87 case ACPI_TYPE_BUFFER_FIELD
:
88 case ACPI_TYPE_LOCAL_REGION_FIELD
:
89 case ACPI_TYPE_LOCAL_BANK_FIELD
:
90 case ACPI_TYPE_LOCAL_INDEX_FIELD
:
92 * These cases all require only Integers or values that
93 * can be converted to Integers (Strings or Buffers)
96 case ACPI_TYPE_INTEGER
:
97 case ACPI_TYPE_STRING
:
98 case ACPI_TYPE_BUFFER
:
101 * Stores into a Field/Region or into a Integer/Buffer/String
102 * are all essentially the same. This case handles the
103 * "interchangeable" types Integer, String, and Buffer.
105 if (ACPI_GET_OBJECT_TYPE (source_desc
) == ACPI_TYPE_LOCAL_REFERENCE
) {
106 /* Resolve a reference object first */
108 status
= acpi_ex_resolve_to_value (source_desc_ptr
, walk_state
);
109 if (ACPI_FAILURE (status
)) {
114 /* For copy_object, no further validation necessary */
116 if (walk_state
->opcode
== AML_COPY_OP
) {
120 /* Must have a Integer, Buffer, or String */
122 if ((ACPI_GET_OBJECT_TYPE (source_desc
) != ACPI_TYPE_INTEGER
) &&
123 (ACPI_GET_OBJECT_TYPE (source_desc
) != ACPI_TYPE_BUFFER
) &&
124 (ACPI_GET_OBJECT_TYPE (source_desc
) != ACPI_TYPE_STRING
) &&
125 !((ACPI_GET_OBJECT_TYPE (source_desc
) == ACPI_TYPE_LOCAL_REFERENCE
) && (source_desc
->reference
.opcode
== AML_LOAD_OP
))) {
126 /* Conversion successful but still not a valid type */
128 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR
,
129 "Cannot assign type %s to %s (must be type Int/Str/Buf)\n",
130 acpi_ut_get_object_type_name (source_desc
),
131 acpi_ut_get_type_name (target_type
)));
132 status
= AE_AML_OPERAND_TYPE
;
137 case ACPI_TYPE_LOCAL_ALIAS
:
138 case ACPI_TYPE_LOCAL_METHOD_ALIAS
:
140 /* Aliases are resolved by acpi_ex_prep_operands */
142 ACPI_REPORT_ERROR (("Store into Alias - should never happen\n"));
143 status
= AE_AML_INTERNAL
;
147 case ACPI_TYPE_PACKAGE
:
151 * All other types than Alias and the various Fields come here,
152 * including the untyped case - ACPI_TYPE_ANY.
157 return_ACPI_STATUS (status
);
161 /*******************************************************************************
163 * FUNCTION: acpi_ex_store_object_to_object
165 * PARAMETERS: source_desc - Object to store
166 * dest_desc - Object to receive a copy of the source
167 * new_desc - New object if dest_desc is obsoleted
168 * walk_state - Current walk state
172 * DESCRIPTION: "Store" an object to another object. This may include
173 * converting the source type to the target type (implicit
174 * conversion), and a copy of the value of the source to
177 * The Assignment of an object to another (not named) object
179 * The Source passed in will replace the current value (if any)
180 * with the input value.
182 * When storing into an object the data is converted to the
183 * target object type then stored in the object. This means
184 * that the target object type (for an initialized target) will
185 * not be changed by a store operation.
187 * This module allows destination types of Number, String,
188 * Buffer, and Package.
190 * Assumes parameters are already validated. NOTE: source_desc
191 * resolution (from a reference object) must be performed by
192 * the caller if necessary.
194 ******************************************************************************/
197 acpi_ex_store_object_to_object (
198 union acpi_operand_object
*source_desc
,
199 union acpi_operand_object
*dest_desc
,
200 union acpi_operand_object
**new_desc
,
201 struct acpi_walk_state
*walk_state
)
203 union acpi_operand_object
*actual_src_desc
;
204 acpi_status status
= AE_OK
;
207 ACPI_FUNCTION_TRACE_PTR ("ex_store_object_to_object", source_desc
);
210 actual_src_desc
= source_desc
;
213 * There is no destination object (An uninitialized node or
214 * package element), so we can simply copy the source object
215 * creating a new destination object
217 status
= acpi_ut_copy_iobject_to_iobject (actual_src_desc
, new_desc
, walk_state
);
218 return_ACPI_STATUS (status
);
221 if (ACPI_GET_OBJECT_TYPE (source_desc
) != ACPI_GET_OBJECT_TYPE (dest_desc
)) {
223 * The source type does not match the type of the destination.
224 * Perform the "implicit conversion" of the source to the current type
225 * of the target as per the ACPI specification.
227 * If no conversion performed, actual_src_desc = source_desc.
228 * Otherwise, actual_src_desc is a temporary object to hold the
231 status
= acpi_ex_convert_to_target_type (ACPI_GET_OBJECT_TYPE (dest_desc
),
232 source_desc
, &actual_src_desc
, walk_state
);
233 if (ACPI_FAILURE (status
)) {
234 return_ACPI_STATUS (status
);
237 if (source_desc
== actual_src_desc
) {
239 * No conversion was performed. Return the source_desc as the
242 *new_desc
= source_desc
;
243 return_ACPI_STATUS (AE_OK
);
248 * We now have two objects of identical types, and we can perform a
249 * copy of the *value* of the source object.
251 switch (ACPI_GET_OBJECT_TYPE (dest_desc
)) {
252 case ACPI_TYPE_INTEGER
:
254 dest_desc
->integer
.value
= actual_src_desc
->integer
.value
;
256 /* Truncate value if we are executing from a 32-bit ACPI table */
258 acpi_ex_truncate_for32bit_table (dest_desc
);
261 case ACPI_TYPE_STRING
:
263 status
= acpi_ex_store_string_to_string (actual_src_desc
, dest_desc
);
266 case ACPI_TYPE_BUFFER
:
269 * Note: There is different store behavior depending on the original
272 status
= acpi_ex_store_buffer_to_buffer (actual_src_desc
, dest_desc
);
275 case ACPI_TYPE_PACKAGE
:
277 status
= acpi_ut_copy_iobject_to_iobject (actual_src_desc
, &dest_desc
,
283 * All other types come here.
285 ACPI_DEBUG_PRINT ((ACPI_DB_WARN
, "Store into type %s not implemented\n",
286 acpi_ut_get_object_type_name (dest_desc
)));
288 status
= AE_NOT_IMPLEMENTED
;
292 if (actual_src_desc
!= source_desc
) {
293 /* Delete the intermediate (temporary) source object */
295 acpi_ut_remove_reference (actual_src_desc
);
298 *new_desc
= dest_desc
;
299 return_ACPI_STATUS (status
);