1 /******************************************************************************
3 * Module Name: exstoren - AML Interpreter object store support,
4 * Store to Node (namespace object)
6 *****************************************************************************/
9 * Copyright (C) 2000 - 2017, Intel Corp.
10 * All rights reserved.
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
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.
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.
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.
51 #define _COMPONENT ACPI_EXECUTER
52 ACPI_MODULE_NAME ("exstoren")
55 /*******************************************************************************
57 * FUNCTION: AcpiExResolveObject
59 * PARAMETERS: SourceDescPtr - Pointer to the source object
60 * TargetType - Current type of the target
61 * WalkState - Current walk state
63 * RETURN: Status, resolved object in SourceDescPtr.
65 * DESCRIPTION: Resolve an object. If the object is a reference, dereference
66 * it and return the actual object in the SourceDescPtr.
68 ******************************************************************************/
72 ACPI_OPERAND_OBJECT
**SourceDescPtr
,
73 ACPI_OBJECT_TYPE TargetType
,
74 ACPI_WALK_STATE
*WalkState
)
76 ACPI_OPERAND_OBJECT
*SourceDesc
= *SourceDescPtr
;
77 ACPI_STATUS Status
= AE_OK
;
80 ACPI_FUNCTION_TRACE (ExResolveObject
);
83 /* Ensure we have a Target that can be stored to */
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)
95 case ACPI_TYPE_INTEGER
:
96 case ACPI_TYPE_STRING
:
97 case ACPI_TYPE_BUFFER
:
99 * Stores into a Field/Region or into a Integer/Buffer/String
100 * are all essentially the same. This case handles the
101 * "interchangeable" types Integer, String, and Buffer.
103 if (SourceDesc
->Common
.Type
== ACPI_TYPE_LOCAL_REFERENCE
)
105 /* Resolve a reference object first */
107 Status
= AcpiExResolveToValue (SourceDescPtr
, WalkState
);
108 if (ACPI_FAILURE (Status
))
114 /* For CopyObject, no further validation necessary */
116 if (WalkState
->Opcode
== AML_COPY_OP
)
121 /* Must have a Integer, Buffer, or String */
123 if ((SourceDesc
->Common
.Type
!= ACPI_TYPE_INTEGER
) &&
124 (SourceDesc
->Common
.Type
!= ACPI_TYPE_BUFFER
) &&
125 (SourceDesc
->Common
.Type
!= ACPI_TYPE_STRING
) &&
126 !((SourceDesc
->Common
.Type
== ACPI_TYPE_LOCAL_REFERENCE
) &&
127 (SourceDesc
->Reference
.Class
== ACPI_REFCLASS_TABLE
)))
129 /* Conversion successful but still not a valid type */
131 ACPI_ERROR ((AE_INFO
,
132 "Cannot assign type [%s] to [%s] (must be type Int/Str/Buf)",
133 AcpiUtGetObjectTypeName (SourceDesc
),
134 AcpiUtGetTypeName (TargetType
)));
136 Status
= AE_AML_OPERAND_TYPE
;
140 case ACPI_TYPE_LOCAL_ALIAS
:
141 case ACPI_TYPE_LOCAL_METHOD_ALIAS
:
143 * All aliases should have been resolved earlier, during the
144 * operand resolution phase.
146 ACPI_ERROR ((AE_INFO
, "Store into an unresolved Alias object"));
147 Status
= AE_AML_INTERNAL
;
150 case ACPI_TYPE_PACKAGE
:
153 * All other types than Alias and the various Fields come here,
154 * including the untyped case - ACPI_TYPE_ANY.
159 return_ACPI_STATUS (Status
);
163 /*******************************************************************************
165 * FUNCTION: AcpiExStoreObjectToObject
167 * PARAMETERS: SourceDesc - Object to store
168 * DestDesc - Object to receive a copy of the source
169 * NewDesc - New object if DestDesc is obsoleted
170 * WalkState - Current walk state
174 * DESCRIPTION: "Store" an object to another object. This may include
175 * converting the source type to the target type (implicit
176 * conversion), and a copy of the value of the source to
179 * The Assignment of an object to another (not named) object
181 * The Source passed in will replace the current value (if any)
182 * with the input value.
184 * When storing into an object the data is converted to the
185 * target object type then stored in the object. This means
186 * that the target object type (for an initialized target) will
187 * not be changed by a store operation.
189 * This module allows destination types of Number, String,
190 * Buffer, and Package.
192 * Assumes parameters are already validated. NOTE: SourceDesc
193 * resolution (from a reference object) must be performed by
194 * the caller if necessary.
196 ******************************************************************************/
199 AcpiExStoreObjectToObject (
200 ACPI_OPERAND_OBJECT
*SourceDesc
,
201 ACPI_OPERAND_OBJECT
*DestDesc
,
202 ACPI_OPERAND_OBJECT
**NewDesc
,
203 ACPI_WALK_STATE
*WalkState
)
205 ACPI_OPERAND_OBJECT
*ActualSrcDesc
;
206 ACPI_STATUS Status
= AE_OK
;
209 ACPI_FUNCTION_TRACE_PTR (ExStoreObjectToObject
, SourceDesc
);
212 ActualSrcDesc
= SourceDesc
;
216 * There is no destination object (An uninitialized node or
217 * package element), so we can simply copy the source object
218 * creating a new destination object
220 Status
= AcpiUtCopyIobjectToIobject (ActualSrcDesc
, NewDesc
, WalkState
);
221 return_ACPI_STATUS (Status
);
224 if (SourceDesc
->Common
.Type
!= DestDesc
->Common
.Type
)
227 * The source type does not match the type of the destination.
228 * Perform the "implicit conversion" of the source to the current type
229 * of the target as per the ACPI specification.
231 * If no conversion performed, ActualSrcDesc = SourceDesc.
232 * Otherwise, ActualSrcDesc is a temporary object to hold the
235 Status
= AcpiExConvertToTargetType (DestDesc
->Common
.Type
,
236 SourceDesc
, &ActualSrcDesc
, WalkState
);
237 if (ACPI_FAILURE (Status
))
239 return_ACPI_STATUS (Status
);
242 if (SourceDesc
== ActualSrcDesc
)
245 * No conversion was performed. Return the SourceDesc as the
248 *NewDesc
= SourceDesc
;
249 return_ACPI_STATUS (AE_OK
);
254 * We now have two objects of identical types, and we can perform a
255 * copy of the *value* of the source object.
257 switch (DestDesc
->Common
.Type
)
259 case ACPI_TYPE_INTEGER
:
261 DestDesc
->Integer
.Value
= ActualSrcDesc
->Integer
.Value
;
263 /* Truncate value if we are executing from a 32-bit ACPI table */
265 (void) AcpiExTruncateFor32bitTable (DestDesc
);
268 case ACPI_TYPE_STRING
:
270 Status
= AcpiExStoreStringToString (ActualSrcDesc
, DestDesc
);
273 case ACPI_TYPE_BUFFER
:
275 Status
= AcpiExStoreBufferToBuffer (ActualSrcDesc
, DestDesc
);
278 case ACPI_TYPE_PACKAGE
:
280 Status
= AcpiUtCopyIobjectToIobject (ActualSrcDesc
, &DestDesc
,
286 * All other types come here.
288 ACPI_WARNING ((AE_INFO
, "Store into type [%s] not implemented",
289 AcpiUtGetObjectTypeName (DestDesc
)));
291 Status
= AE_NOT_IMPLEMENTED
;
295 if (ActualSrcDesc
!= SourceDesc
)
297 /* Delete the intermediate (temporary) source object */
299 AcpiUtRemoveReference (ActualSrcDesc
);
303 return_ACPI_STATUS (Status
);