1 /******************************************************************************
   2  *
   3  * Module Name: dsargs - Support for execution of dynamic arguments for static
   4  *                       objects (regions, fields, buffer fields, etc.)
   5  *
   6  *****************************************************************************/
   7 
   8 /*
   9  * Copyright (C) 2000 - 2011, Intel Corp.
  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 #define __DSARGS_C__
  46 
  47 #include "acpi.h"
  48 #include "accommon.h"
  49 #include "acparser.h"
  50 #include "amlcode.h"
  51 #include "acdispat.h"
  52 #include "acnamesp.h"
  53 
  54 #define _COMPONENT          ACPI_DISPATCHER
  55         ACPI_MODULE_NAME    ("dsargs")
  56 
  57 /* Local prototypes */
  58 
  59 static ACPI_STATUS
  60 AcpiDsExecuteArguments (
  61     ACPI_NAMESPACE_NODE     *Node,
  62     ACPI_NAMESPACE_NODE     *ScopeNode,
  63     UINT32                  AmlLength,
  64     UINT8                   *AmlStart);
  65 
  66 
  67 /*******************************************************************************
  68  *
  69  * FUNCTION:    AcpiDsExecuteArguments
  70  *
  71  * PARAMETERS:  Node                - Object NS node
  72  *              ScopeNode           - Parent NS node
  73  *              AmlLength           - Length of executable AML
  74  *              AmlStart            - Pointer to the AML
  75  *
  76  * RETURN:      Status.
  77  *
  78  * DESCRIPTION: Late (deferred) execution of region or field arguments
  79  *
  80  ******************************************************************************/
  81 
  82 static ACPI_STATUS
  83 AcpiDsExecuteArguments (
  84     ACPI_NAMESPACE_NODE     *Node,
  85     ACPI_NAMESPACE_NODE     *ScopeNode,
  86     UINT32                  AmlLength,
  87     UINT8                   *AmlStart)
  88 {
  89     ACPI_STATUS             Status;
  90     ACPI_PARSE_OBJECT       *Op;
  91     ACPI_WALK_STATE         *WalkState;
  92 
  93 
  94     ACPI_FUNCTION_TRACE (DsExecuteArguments);
  95 
  96 
  97     /* Allocate a new parser op to be the root of the parsed tree */
  98 
  99     Op = AcpiPsAllocOp (AML_INT_EVAL_SUBTREE_OP);
 100     if (!Op)
 101     {
 102         return_ACPI_STATUS (AE_NO_MEMORY);
 103     }
 104 
 105     /* Save the Node for use in AcpiPsParseAml */
 106 
 107     Op->Common.Node = ScopeNode;
 108 
 109     /* Create and initialize a new parser state */
 110 
 111     WalkState = AcpiDsCreateWalkState (0, NULL, NULL, NULL);
 112     if (!WalkState)
 113     {
 114         Status = AE_NO_MEMORY;
 115         goto Cleanup;
 116     }
 117 
 118     Status = AcpiDsInitAmlWalk (WalkState, Op, NULL, AmlStart,
 119                     AmlLength, NULL, ACPI_IMODE_LOAD_PASS1);
 120     if (ACPI_FAILURE (Status))
 121     {
 122         AcpiDsDeleteWalkState (WalkState);
 123         goto Cleanup;
 124     }
 125 
 126     /* Mark this parse as a deferred opcode */
 127 
 128     WalkState->ParseFlags = ACPI_PARSE_DEFERRED_OP;
 129     WalkState->DeferredNode = Node;
 130 
 131     /* Pass1: Parse the entire declaration */
 132 
 133     Status = AcpiPsParseAml (WalkState);
 134     if (ACPI_FAILURE (Status))
 135     {
 136         goto Cleanup;
 137     }
 138 
 139     /* Get and init the Op created above */
 140 
 141     Op->Common.Node = Node;
 142     AcpiPsDeleteParseTree (Op);
 143 
 144     /* Evaluate the deferred arguments */
 145 
 146     Op = AcpiPsAllocOp (AML_INT_EVAL_SUBTREE_OP);
 147     if (!Op)
 148     {
 149         return_ACPI_STATUS (AE_NO_MEMORY);
 150     }
 151 
 152     Op->Common.Node = ScopeNode;
 153 
 154     /* Create and initialize a new parser state */
 155 
 156     WalkState = AcpiDsCreateWalkState (0, NULL, NULL, NULL);
 157     if (!WalkState)
 158     {
 159         Status = AE_NO_MEMORY;
 160         goto Cleanup;
 161     }
 162 
 163     /* Execute the opcode and arguments */
 164 
 165     Status = AcpiDsInitAmlWalk (WalkState, Op, NULL, AmlStart,
 166                     AmlLength, NULL, ACPI_IMODE_EXECUTE);
 167     if (ACPI_FAILURE (Status))
 168     {
 169         AcpiDsDeleteWalkState (WalkState);
 170         goto Cleanup;
 171     }
 172 
 173     /* Mark this execution as a deferred opcode */
 174 
 175     WalkState->DeferredNode = Node;
 176     Status = AcpiPsParseAml (WalkState);
 177 
 178 Cleanup:
 179     AcpiPsDeleteParseTree (Op);
 180     return_ACPI_STATUS (Status);
 181 }
 182 
 183 
 184 /*******************************************************************************
 185  *
 186  * FUNCTION:    AcpiDsGetBufferFieldArguments
 187  *
 188  * PARAMETERS:  ObjDesc         - A valid BufferField object
 189  *
 190  * RETURN:      Status.
 191  *
 192  * DESCRIPTION: Get BufferField Buffer and Index. This implements the late
 193  *              evaluation of these field attributes.
 194  *
 195  ******************************************************************************/
 196 
 197 ACPI_STATUS
 198 AcpiDsGetBufferFieldArguments (
 199     ACPI_OPERAND_OBJECT     *ObjDesc)
 200 {
 201     ACPI_OPERAND_OBJECT     *ExtraDesc;
 202     ACPI_NAMESPACE_NODE     *Node;
 203     ACPI_STATUS             Status;
 204 
 205 
 206     ACPI_FUNCTION_TRACE_PTR (DsGetBufferFieldArguments, ObjDesc);
 207 
 208 
 209     if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
 210     {
 211         return_ACPI_STATUS (AE_OK);
 212     }
 213 
 214     /* Get the AML pointer (method object) and BufferField node */
 215 
 216     ExtraDesc = AcpiNsGetSecondaryObject (ObjDesc);
 217     Node = ObjDesc->BufferField.Node;
 218 
 219     ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname (ACPI_TYPE_BUFFER_FIELD,
 220         Node, NULL));
 221 
 222     ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[%4.4s] BufferField Arg Init\n",
 223         AcpiUtGetNodeName (Node)));
 224 
 225     /* Execute the AML code for the TermArg arguments */
 226 
 227     Status = AcpiDsExecuteArguments (Node, Node->Parent,
 228                 ExtraDesc->Extra.AmlLength, ExtraDesc->Extra.AmlStart);
 229     return_ACPI_STATUS (Status);
 230 }
 231 
 232 
 233 /*******************************************************************************
 234  *
 235  * FUNCTION:    AcpiDsGetBankFieldArguments
 236  *
 237  * PARAMETERS:  ObjDesc         - A valid BankField object
 238  *
 239  * RETURN:      Status.
 240  *
 241  * DESCRIPTION: Get BankField BankValue. This implements the late
 242  *              evaluation of these field attributes.
 243  *
 244  ******************************************************************************/
 245 
 246 ACPI_STATUS
 247 AcpiDsGetBankFieldArguments (
 248     ACPI_OPERAND_OBJECT     *ObjDesc)
 249 {
 250     ACPI_OPERAND_OBJECT     *ExtraDesc;
 251     ACPI_NAMESPACE_NODE     *Node;
 252     ACPI_STATUS             Status;
 253 
 254 
 255     ACPI_FUNCTION_TRACE_PTR (DsGetBankFieldArguments, ObjDesc);
 256 
 257 
 258     if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
 259     {
 260         return_ACPI_STATUS (AE_OK);
 261     }
 262 
 263     /* Get the AML pointer (method object) and BankField node */
 264 
 265     ExtraDesc = AcpiNsGetSecondaryObject (ObjDesc);
 266     Node = ObjDesc->BankField.Node;
 267 
 268     ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname (ACPI_TYPE_LOCAL_BANK_FIELD,
 269         Node, NULL));
 270 
 271     ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[%4.4s] BankField Arg Init\n",
 272         AcpiUtGetNodeName (Node)));
 273 
 274     /* Execute the AML code for the TermArg arguments */
 275 
 276     Status = AcpiDsExecuteArguments (Node, Node->Parent,
 277                 ExtraDesc->Extra.AmlLength, ExtraDesc->Extra.AmlStart);
 278     return_ACPI_STATUS (Status);
 279 }
 280 
 281 
 282 /*******************************************************************************
 283  *
 284  * FUNCTION:    AcpiDsGetBufferArguments
 285  *
 286  * PARAMETERS:  ObjDesc         - A valid Buffer object
 287  *
 288  * RETURN:      Status.
 289  *
 290  * DESCRIPTION: Get Buffer length and initializer byte list. This implements
 291  *              the late evaluation of these attributes.
 292  *
 293  ******************************************************************************/
 294 
 295 ACPI_STATUS
 296 AcpiDsGetBufferArguments (
 297     ACPI_OPERAND_OBJECT     *ObjDesc)
 298 {
 299     ACPI_NAMESPACE_NODE     *Node;
 300     ACPI_STATUS             Status;
 301 
 302 
 303     ACPI_FUNCTION_TRACE_PTR (DsGetBufferArguments, ObjDesc);
 304 
 305 
 306     if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
 307     {
 308         return_ACPI_STATUS (AE_OK);
 309     }
 310 
 311     /* Get the Buffer node */
 312 
 313     Node = ObjDesc->Buffer.Node;
 314     if (!Node)
 315     {
 316         ACPI_ERROR ((AE_INFO,
 317             "No pointer back to namespace node in buffer object %p", ObjDesc));
 318         return_ACPI_STATUS (AE_AML_INTERNAL);
 319     }
 320 
 321     ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Buffer Arg Init\n"));
 322 
 323     /* Execute the AML code for the TermArg arguments */
 324 
 325     Status = AcpiDsExecuteArguments (Node, Node,
 326                 ObjDesc->Buffer.AmlLength, ObjDesc->Buffer.AmlStart);
 327     return_ACPI_STATUS (Status);
 328 }
 329 
 330 
 331 /*******************************************************************************
 332  *
 333  * FUNCTION:    AcpiDsGetPackageArguments
 334  *
 335  * PARAMETERS:  ObjDesc         - A valid Package object
 336  *
 337  * RETURN:      Status.
 338  *
 339  * DESCRIPTION: Get Package length and initializer byte list. This implements
 340  *              the late evaluation of these attributes.
 341  *
 342  ******************************************************************************/
 343 
 344 ACPI_STATUS
 345 AcpiDsGetPackageArguments (
 346     ACPI_OPERAND_OBJECT     *ObjDesc)
 347 {
 348     ACPI_NAMESPACE_NODE     *Node;
 349     ACPI_STATUS             Status;
 350 
 351 
 352     ACPI_FUNCTION_TRACE_PTR (DsGetPackageArguments, ObjDesc);
 353 
 354 
 355     if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
 356     {
 357         return_ACPI_STATUS (AE_OK);
 358     }
 359 
 360     /* Get the Package node */
 361 
 362     Node = ObjDesc->Package.Node;
 363     if (!Node)
 364     {
 365         ACPI_ERROR ((AE_INFO,
 366             "No pointer back to namespace node in package %p", ObjDesc));
 367         return_ACPI_STATUS (AE_AML_INTERNAL);
 368     }
 369 
 370     ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Package Arg Init\n"));
 371 
 372     /* Execute the AML code for the TermArg arguments */
 373 
 374     Status = AcpiDsExecuteArguments (Node, Node,
 375                 ObjDesc->Package.AmlLength, ObjDesc->Package.AmlStart);
 376     return_ACPI_STATUS (Status);
 377 }
 378 
 379 
 380 /*******************************************************************************
 381  *
 382  * FUNCTION:    AcpiDsGetRegionArguments
 383  *
 384  * PARAMETERS:  ObjDesc         - A valid region object
 385  *
 386  * RETURN:      Status.
 387  *
 388  * DESCRIPTION: Get region address and length. This implements the late
 389  *              evaluation of these region attributes.
 390  *
 391  ******************************************************************************/
 392 
 393 ACPI_STATUS
 394 AcpiDsGetRegionArguments (
 395     ACPI_OPERAND_OBJECT     *ObjDesc)
 396 {
 397     ACPI_NAMESPACE_NODE     *Node;
 398     ACPI_STATUS             Status;
 399     ACPI_OPERAND_OBJECT     *ExtraDesc;
 400 
 401 
 402     ACPI_FUNCTION_TRACE_PTR (DsGetRegionArguments, ObjDesc);
 403 
 404 
 405     if (ObjDesc->Region.Flags & AOPOBJ_DATA_VALID)
 406     {
 407         return_ACPI_STATUS (AE_OK);
 408     }
 409 
 410     ExtraDesc = AcpiNsGetSecondaryObject (ObjDesc);
 411     if (!ExtraDesc)
 412     {
 413         return_ACPI_STATUS (AE_NOT_EXIST);
 414     }
 415 
 416     /* Get the Region node */
 417 
 418     Node = ObjDesc->Region.Node;
 419 
 420     ACPI_DEBUG_EXEC (AcpiUtDisplayInitPathname (ACPI_TYPE_REGION, Node, NULL));
 421 
 422     ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "[%4.4s] OpRegion Arg Init at AML %p\n",
 423         AcpiUtGetNodeName (Node), ExtraDesc->Extra.AmlStart));
 424 
 425     /* Execute the argument AML */
 426 
 427     Status = AcpiDsExecuteArguments (Node, Node->Parent,
 428                 ExtraDesc->Extra.AmlLength, ExtraDesc->Extra.AmlStart);
 429     return_ACPI_STATUS (Status);
 430 }