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