Home | History | Annotate | Line # | Download | only in dispatcher
      1 /******************************************************************************
      2  *
      3  * Module Name: dswload2 - Dispatcher second pass namespace load callbacks
      4  *
      5  *****************************************************************************/
      6 
      7 /******************************************************************************
      8  *
      9  * 1. Copyright Notice
     10  *
     11  * Some or all of this work - Copyright (c) 1999 - 2025, Intel Corp.
     12  * All rights reserved.
     13  *
     14  * 2. License
     15  *
     16  * 2.1. This is your license from Intel Corp. under its intellectual property
     17  * rights. You may have additional license terms from the party that provided
     18  * you this software, covering your right to use that party's intellectual
     19  * property rights.
     20  *
     21  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
     22  * copy of the source code appearing in this file ("Covered Code") an
     23  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
     24  * base code distributed originally by Intel ("Original Intel Code") to copy,
     25  * make derivatives, distribute, use and display any portion of the Covered
     26  * Code in any form, with the right to sublicense such rights; and
     27  *
     28  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
     29  * license (with the right to sublicense), under only those claims of Intel
     30  * patents that are infringed by the Original Intel Code, to make, use, sell,
     31  * offer to sell, and import the Covered Code and derivative works thereof
     32  * solely to the minimum extent necessary to exercise the above copyright
     33  * license, and in no event shall the patent license extend to any additions
     34  * to or modifications of the Original Intel Code. No other license or right
     35  * is granted directly or by implication, estoppel or otherwise;
     36  *
     37  * The above copyright and patent license is granted only if the following
     38  * conditions are met:
     39  *
     40  * 3. Conditions
     41  *
     42  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
     43  * Redistribution of source code of any substantial portion of the Covered
     44  * Code or modification with rights to further distribute source must include
     45  * the above Copyright Notice, the above License, this list of Conditions,
     46  * and the following Disclaimer and Export Compliance provision. In addition,
     47  * Licensee must cause all Covered Code to which Licensee contributes to
     48  * contain a file documenting the changes Licensee made to create that Covered
     49  * Code and the date of any change. Licensee must include in that file the
     50  * documentation of any changes made by any predecessor Licensee. Licensee
     51  * must include a prominent statement that the modification is derived,
     52  * directly or indirectly, from Original Intel Code.
     53  *
     54  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
     55  * Redistribution of source code of any substantial portion of the Covered
     56  * Code or modification without rights to further distribute source must
     57  * include the following Disclaimer and Export Compliance provision in the
     58  * documentation and/or other materials provided with distribution. In
     59  * addition, Licensee may not authorize further sublicense of source of any
     60  * portion of the Covered Code, and must include terms to the effect that the
     61  * license from Licensee to its licensee is limited to the intellectual
     62  * property embodied in the software Licensee provides to its licensee, and
     63  * not to intellectual property embodied in modifications its licensee may
     64  * make.
     65  *
     66  * 3.3. Redistribution of Executable. Redistribution in executable form of any
     67  * substantial portion of the Covered Code or modification must reproduce the
     68  * above Copyright Notice, and the following Disclaimer and Export Compliance
     69  * provision in the documentation and/or other materials provided with the
     70  * distribution.
     71  *
     72  * 3.4. Intel retains all right, title, and interest in and to the Original
     73  * Intel Code.
     74  *
     75  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
     76  * Intel shall be used in advertising or otherwise to promote the sale, use or
     77  * other dealings in products derived from or relating to the Covered Code
     78  * without prior written authorization from Intel.
     79  *
     80  * 4. Disclaimer and Export Compliance
     81  *
     82  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
     83  * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
     84  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
     85  * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
     86  * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
     87  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
     88  * PARTICULAR PURPOSE.
     89  *
     90  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
     91  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
     92  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
     93  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
     94  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
     95  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
     96  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
     97  * LIMITED REMEDY.
     98  *
     99  * 4.3. Licensee shall not export, either directly or indirectly, any of this
    100  * software or system incorporating such software without first obtaining any
    101  * required license or other approval from the U. S. Department of Commerce or
    102  * any other agency or department of the United States Government. In the
    103  * event Licensee exports any such software from the United States or
    104  * re-exports any such software from a foreign destination, Licensee shall
    105  * ensure that the distribution and export/re-export of the software is in
    106  * compliance with all laws, regulations, orders, or other restrictions of the
    107  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
    108  * any of its subsidiaries will export/re-export any technical data, process,
    109  * software, or service, directly or indirectly, to any country for which the
    110  * United States government or any agency thereof requires an export license,
    111  * other governmental approval, or letter of assurance, without first obtaining
    112  * such license, approval or letter.
    113  *
    114  *****************************************************************************
    115  *
    116  * Alternatively, you may choose to be licensed under the terms of the
    117  * following license:
    118  *
    119  * Redistribution and use in source and binary forms, with or without
    120  * modification, are permitted provided that the following conditions
    121  * are met:
    122  * 1. Redistributions of source code must retain the above copyright
    123  *    notice, this list of conditions, and the following disclaimer,
    124  *    without modification.
    125  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
    126  *    substantially similar to the "NO WARRANTY" disclaimer below
    127  *    ("Disclaimer") and any redistribution must be conditioned upon
    128  *    including a substantially similar Disclaimer requirement for further
    129  *    binary redistribution.
    130  * 3. Neither the names of the above-listed copyright holders nor the names
    131  *    of any contributors may be used to endorse or promote products derived
    132  *    from this software without specific prior written permission.
    133  *
    134  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    135  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
    136  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    137  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
    138  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    139  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    140  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    141  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
    142  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    143  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    144  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    145  *
    146  * Alternatively, you may choose to be licensed under the terms of the
    147  * GNU General Public License ("GPL") version 2 as published by the Free
    148  * Software Foundation.
    149  *
    150  *****************************************************************************/
    151 
    152 #include "acpi.h"
    153 #include "accommon.h"
    154 #include "acparser.h"
    155 #include "amlcode.h"
    156 #include "acdispat.h"
    157 #include "acinterp.h"
    158 #include "acnamesp.h"
    159 #include "acevents.h"
    160 #ifdef ACPI_EXEC_APP
    161 #include "aecommon.h"
    162 #endif
    163 
    164 #define _COMPONENT          ACPI_DISPATCHER
    165         ACPI_MODULE_NAME    ("dswload2")
    166 
    167 
    168 /*******************************************************************************
    169  *
    170  * FUNCTION:    AcpiDsLoad2BeginOp
    171  *
    172  * PARAMETERS:  WalkState       - Current state of the parse tree walk
    173  *              OutOp           - Where to return op if a new one is created
    174  *
    175  * RETURN:      Status
    176  *
    177  * DESCRIPTION: Descending callback used during the loading of ACPI tables.
    178  *
    179  ******************************************************************************/
    180 
    181 ACPI_STATUS
    182 AcpiDsLoad2BeginOp (
    183     ACPI_WALK_STATE         *WalkState,
    184     ACPI_PARSE_OBJECT       **OutOp)
    185 {
    186     ACPI_PARSE_OBJECT       *Op;
    187     ACPI_NAMESPACE_NODE     *Node;
    188     ACPI_STATUS             Status;
    189     ACPI_OBJECT_TYPE        ObjectType;
    190     char                    *BufferPtr;
    191     UINT32                  Flags;
    192 
    193 
    194     ACPI_FUNCTION_TRACE (DsLoad2BeginOp);
    195 
    196 
    197     Op = WalkState->Op;
    198     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Op=%p State=%p\n", Op, WalkState));
    199 
    200     if (Op)
    201     {
    202         if ((WalkState->ControlState) &&
    203             (WalkState->ControlState->Common.State ==
    204                 ACPI_CONTROL_CONDITIONAL_EXECUTING))
    205         {
    206             /* We are executing a while loop outside of a method */
    207 
    208             Status = AcpiDsExecBeginOp (WalkState, OutOp);
    209             return_ACPI_STATUS (Status);
    210         }
    211 
    212         /* We only care about Namespace opcodes here */
    213 
    214         if ((!(WalkState->OpInfo->Flags & AML_NSOPCODE)   &&
    215               (WalkState->Opcode != AML_INT_NAMEPATH_OP)) ||
    216             (!(WalkState->OpInfo->Flags & AML_NAMED)))
    217         {
    218             return_ACPI_STATUS (AE_OK);
    219         }
    220 
    221         /* Get the name we are going to enter or lookup in the namespace */
    222 
    223         if (WalkState->Opcode == AML_INT_NAMEPATH_OP)
    224         {
    225             /* For Namepath op, get the path string */
    226 
    227             BufferPtr = Op->Common.Value.String;
    228             if (!BufferPtr)
    229             {
    230                 /* No name, just exit */
    231 
    232                 return_ACPI_STATUS (AE_OK);
    233             }
    234         }
    235         else
    236         {
    237             /* Get name from the op */
    238 
    239             BufferPtr = ACPI_CAST_PTR (char, &Op->Named.Name);
    240         }
    241     }
    242     else
    243     {
    244         /* Get the namestring from the raw AML */
    245 
    246         BufferPtr = AcpiPsGetNextNamestring (&WalkState->ParserState);
    247     }
    248 
    249     /* Map the opcode into an internal object type */
    250 
    251     ObjectType = WalkState->OpInfo->ObjectType;
    252 
    253     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
    254         "State=%p Op=%p Type=%X\n", WalkState, Op, ObjectType));
    255 
    256     switch (WalkState->Opcode)
    257     {
    258     case AML_FIELD_OP:
    259     case AML_BANK_FIELD_OP:
    260     case AML_INDEX_FIELD_OP:
    261 
    262         Node = NULL;
    263         Status = AE_OK;
    264         break;
    265 
    266     case AML_INT_NAMEPATH_OP:
    267         /*
    268          * The NamePath is an object reference to an existing object.
    269          * Don't enter the name into the namespace, but look it up
    270          * for use later.
    271          */
    272         Status = AcpiNsLookup (WalkState->ScopeInfo, BufferPtr, ObjectType,
    273             ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
    274             WalkState, &(Node));
    275         break;
    276 
    277     case AML_SCOPE_OP:
    278 
    279         /* Special case for Scope(\) -> refers to the Root node */
    280 
    281         if (Op && (Op->Named.Node == AcpiGbl_RootNode))
    282         {
    283             Node = Op->Named.Node;
    284 
    285             Status = AcpiDsScopeStackPush (Node, ObjectType, WalkState);
    286             if (ACPI_FAILURE (Status))
    287             {
    288                 return_ACPI_STATUS (Status);
    289             }
    290         }
    291         else
    292         {
    293             /*
    294              * The Path is an object reference to an existing object.
    295              * Don't enter the name into the namespace, but look it up
    296              * for use later.
    297              */
    298             Status = AcpiNsLookup (WalkState->ScopeInfo, BufferPtr, ObjectType,
    299                 ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
    300                 WalkState, &(Node));
    301             if (ACPI_FAILURE (Status))
    302             {
    303 #ifdef ACPI_ASL_COMPILER
    304                 if (Status == AE_NOT_FOUND)
    305                 {
    306                     Status = AE_OK;
    307                 }
    308                 else
    309                 {
    310                     ACPI_ERROR_NAMESPACE (WalkState->ScopeInfo,
    311                         BufferPtr, Status);
    312                 }
    313 #else
    314                 ACPI_ERROR_NAMESPACE (WalkState->ScopeInfo,
    315                     BufferPtr, Status);
    316 #endif
    317                 return_ACPI_STATUS (Status);
    318             }
    319         }
    320 
    321         /*
    322          * We must check to make sure that the target is
    323          * one of the opcodes that actually opens a scope
    324          */
    325         switch (Node->Type)
    326         {
    327         case ACPI_TYPE_ANY:
    328         case ACPI_TYPE_LOCAL_SCOPE:         /* Scope */
    329         case ACPI_TYPE_DEVICE:
    330         case ACPI_TYPE_POWER:
    331         case ACPI_TYPE_PROCESSOR:
    332         case ACPI_TYPE_THERMAL:
    333 
    334             /* These are acceptable types */
    335             break;
    336 
    337         case ACPI_TYPE_INTEGER:
    338         case ACPI_TYPE_STRING:
    339         case ACPI_TYPE_BUFFER:
    340 
    341             /*
    342              * These types we will allow, but we will change the type.
    343              * This enables some existing code of the form:
    344              *
    345              *  Name (DEB, 0)
    346              *  Scope (DEB) { ... }
    347              */
    348             ACPI_WARNING ((AE_INFO,
    349                 "Type override - [%4.4s] had invalid type (%s) "
    350                 "for Scope operator, changed to type ANY",
    351                 AcpiUtGetNodeName (Node), AcpiUtGetTypeName (Node->Type)));
    352 
    353             Node->Type = ACPI_TYPE_ANY;
    354             WalkState->ScopeInfo->Common.Value = ACPI_TYPE_ANY;
    355             break;
    356 
    357         case ACPI_TYPE_METHOD:
    358 
    359             /*
    360              * Allow scope change to root during execution of module-level
    361              * code. Root is typed METHOD during this time.
    362              */
    363             if ((Node == AcpiGbl_RootNode) &&
    364                 (WalkState->ParseFlags & ACPI_PARSE_MODULE_LEVEL))
    365             {
    366                 break;
    367             }
    368 
    369             ACPI_FALLTHROUGH;
    370 
    371         default:
    372 
    373             /* All other types are an error */
    374 
    375             ACPI_ERROR ((AE_INFO,
    376                 "Invalid type (%s) for target of "
    377                 "Scope operator [%4.4s] (Cannot override)",
    378                 AcpiUtGetTypeName (Node->Type), AcpiUtGetNodeName (Node)));
    379 
    380             return_ACPI_STATUS (AE_AML_OPERAND_TYPE);
    381         }
    382         break;
    383 
    384     default:
    385 
    386         /* All other opcodes */
    387 
    388         if (Op && Op->Common.Node)
    389         {
    390             /* This op/node was previously entered into the namespace */
    391 
    392             Node = Op->Common.Node;
    393 
    394             if (AcpiNsOpensScope (ObjectType))
    395             {
    396                 Status = AcpiDsScopeStackPush (Node, ObjectType, WalkState);
    397                 if (ACPI_FAILURE (Status))
    398                 {
    399                     return_ACPI_STATUS (Status);
    400                 }
    401             }
    402 
    403             return_ACPI_STATUS (AE_OK);
    404         }
    405 
    406         /*
    407          * Enter the named type into the internal namespace. We enter the name
    408          * as we go downward in the parse tree. Any necessary subobjects that
    409          * involve arguments to the opcode must be created as we go back up the
    410          * parse tree later.
    411          *
    412          * Note: Name may already exist if we are executing a deferred opcode.
    413          */
    414         if (WalkState->DeferredNode)
    415         {
    416             /* This name is already in the namespace, get the node */
    417 
    418             Node = WalkState->DeferredNode;
    419             Status = AE_OK;
    420             break;
    421         }
    422 
    423         Flags = ACPI_NS_NO_UPSEARCH;
    424         if (WalkState->PassNumber == ACPI_IMODE_EXECUTE)
    425         {
    426             /* Execution mode, node cannot already exist, node is temporary */
    427 
    428             Flags |= ACPI_NS_ERROR_IF_FOUND;
    429 
    430             if (!(WalkState->ParseFlags & ACPI_PARSE_MODULE_LEVEL))
    431             {
    432                 Flags |= ACPI_NS_TEMPORARY;
    433             }
    434         }
    435 
    436 #ifdef ACPI_ASL_COMPILER
    437 
    438         /*
    439          * Do not open a scope for AML_EXTERNAL_OP
    440          * AcpiNsLookup can open a new scope based on the object type
    441          * of this op. AML_EXTERNAL_OP is a declaration rather than a
    442          * definition. In the case that this external is a method object,
    443          * AcpiNsLookup will open a new scope. However, an AML_EXTERNAL_OP
    444          * associated with the ACPI_TYPE_METHOD is a declaration, rather than
    445          * a definition. Flags is set to avoid opening a scope for any
    446          * AML_EXTERNAL_OP.
    447          */
    448         if (WalkState->Opcode == AML_EXTERNAL_OP)
    449         {
    450             Flags |= ACPI_NS_DONT_OPEN_SCOPE;
    451         }
    452 #endif
    453 
    454         /*
    455          * For name creation opcodes, the full namepath prefix must
    456          * exist, except for the final (new) nameseg.
    457          */
    458         if (WalkState->OpInfo->Flags & AML_NAMED)
    459         {
    460             Flags |= ACPI_NS_PREFIX_MUST_EXIST;
    461         }
    462 
    463         /* Add new entry or lookup existing entry */
    464 
    465         Status = AcpiNsLookup (WalkState->ScopeInfo, BufferPtr, ObjectType,
    466             ACPI_IMODE_LOAD_PASS2, Flags, WalkState, &Node);
    467 
    468         if (ACPI_SUCCESS (Status) && (Flags & ACPI_NS_TEMPORARY))
    469         {
    470             ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
    471                 "***New Node [%4.4s] %p is temporary\n",
    472                 AcpiUtGetNodeName (Node), Node));
    473         }
    474         break;
    475     }
    476 
    477     if (ACPI_FAILURE (Status))
    478     {
    479         ACPI_ERROR_NAMESPACE (WalkState->ScopeInfo,
    480             BufferPtr, Status);
    481         return_ACPI_STATUS (Status);
    482     }
    483 
    484     if (!Op)
    485     {
    486         /* Create a new op */
    487 
    488         Op = AcpiPsAllocOp (WalkState->Opcode, WalkState->Aml);
    489         if (!Op)
    490         {
    491             return_ACPI_STATUS (AE_NO_MEMORY);
    492         }
    493 
    494         /* Initialize the new op */
    495 
    496         if (Node)
    497         {
    498             Op->Named.Name = Node->Name.Integer;
    499         }
    500         *OutOp = Op;
    501     }
    502 
    503     /*
    504      * Put the Node in the "op" object that the parser uses, so we
    505      * can get it again quickly when this scope is closed
    506      */
    507     Op->Common.Node = Node;
    508     return_ACPI_STATUS (Status);
    509 }
    510 
    511 
    512 /*******************************************************************************
    513  *
    514  * FUNCTION:    AcpiDsLoad2EndOp
    515  *
    516  * PARAMETERS:  WalkState       - Current state of the parse tree walk
    517  *
    518  * RETURN:      Status
    519  *
    520  * DESCRIPTION: Ascending callback used during the loading of the namespace,
    521  *              both control methods and everything else.
    522  *
    523  ******************************************************************************/
    524 
    525 ACPI_STATUS
    526 AcpiDsLoad2EndOp (
    527     ACPI_WALK_STATE         *WalkState)
    528 {
    529     ACPI_PARSE_OBJECT       *Op;
    530     ACPI_STATUS             Status = AE_OK;
    531     ACPI_OBJECT_TYPE        ObjectType;
    532     ACPI_NAMESPACE_NODE     *Node;
    533     ACPI_PARSE_OBJECT       *Arg;
    534     ACPI_NAMESPACE_NODE     *NewNode;
    535     UINT32                  i;
    536     UINT8                   RegionSpace;
    537 #ifdef ACPI_EXEC_APP
    538     ACPI_OPERAND_OBJECT     *ObjDesc;
    539     char                    *Namepath;
    540 #endif
    541 
    542 
    543     ACPI_FUNCTION_TRACE (DsLoad2EndOp);
    544 
    545     Op = WalkState->Op;
    546     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Opcode [%s] Op %p State %p\n",
    547         WalkState->OpInfo->Name, Op, WalkState));
    548 
    549     /* Check if opcode had an associated namespace object */
    550 
    551     if (!(WalkState->OpInfo->Flags & AML_NSOBJECT))
    552     {
    553         return_ACPI_STATUS (AE_OK);
    554     }
    555 
    556     if (Op->Common.AmlOpcode == AML_SCOPE_OP)
    557     {
    558         ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
    559             "Ending scope Op=%p State=%p\n", Op, WalkState));
    560     }
    561 
    562     ObjectType = WalkState->OpInfo->ObjectType;
    563 
    564     /*
    565      * Get the Node/name from the earlier lookup
    566      * (It was saved in the *op structure)
    567      */
    568     Node = Op->Common.Node;
    569 
    570     /*
    571      * Put the Node on the object stack (Contains the ACPI Name of
    572      * this object)
    573      */
    574     WalkState->Operands[0] = (void *) Node;
    575     WalkState->NumOperands = 1;
    576 
    577     /* Pop the scope stack */
    578 
    579     if (AcpiNsOpensScope (ObjectType) &&
    580        (Op->Common.AmlOpcode != AML_INT_METHODCALL_OP))
    581     {
    582         ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "(%s) Popping scope for Op %p\n",
    583             AcpiUtGetTypeName (ObjectType), Op));
    584 
    585         Status = AcpiDsScopeStackPop (WalkState);
    586         if (ACPI_FAILURE (Status))
    587         {
    588             goto Cleanup;
    589         }
    590     }
    591 
    592     /*
    593      * Named operations are as follows:
    594      *
    595      * AML_ALIAS
    596      * AML_BANKFIELD
    597      * AML_CREATEBITFIELD
    598      * AML_CREATEBYTEFIELD
    599      * AML_CREATEDWORDFIELD
    600      * AML_CREATEFIELD
    601      * AML_CREATEQWORDFIELD
    602      * AML_CREATEWORDFIELD
    603      * AML_DATA_REGION
    604      * AML_DEVICE
    605      * AML_EVENT
    606      * AML_FIELD
    607      * AML_INDEXFIELD
    608      * AML_METHOD
    609      * AML_METHODCALL
    610      * AML_MUTEX
    611      * AML_NAME
    612      * AML_NAMEDFIELD
    613      * AML_OPREGION
    614      * AML_POWERRES
    615      * AML_PROCESSOR
    616      * AML_SCOPE
    617      * AML_THERMALZONE
    618      */
    619 
    620     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
    621         "Create-Load [%s] State=%p Op=%p NamedObj=%p\n",
    622         AcpiPsGetOpcodeName (Op->Common.AmlOpcode), WalkState, Op, Node));
    623 
    624     /* Decode the opcode */
    625 
    626     Arg = Op->Common.Value.Arg;
    627 
    628     switch (WalkState->OpInfo->Type)
    629     {
    630 
    631     case AML_TYPE_CREATE_FIELD:
    632         /*
    633          * Create the field object, but the field buffer and index must
    634          * be evaluated later during the execution phase
    635          */
    636         Status = AcpiDsCreateBufferField (Op, WalkState);
    637         if ACPI_FAILURE (Status)
    638         {
    639             ACPI_EXCEPTION ((AE_INFO, Status, "CreateBufferField failure"));
    640             goto Cleanup;
    641         }
    642         break;
    643 
    644      case AML_TYPE_NAMED_FIELD:
    645         /*
    646          * If we are executing a method, initialize the field
    647          */
    648         if (WalkState->MethodNode)
    649         {
    650             Status = AcpiDsInitFieldObjects (Op, WalkState);
    651         }
    652 
    653         switch (Op->Common.AmlOpcode)
    654         {
    655         case AML_INDEX_FIELD_OP:
    656 
    657             Status = AcpiDsCreateIndexField (
    658                 Op, (ACPI_HANDLE) Arg->Common.Node, WalkState);
    659             break;
    660 
    661         case AML_BANK_FIELD_OP:
    662 
    663             Status = AcpiDsCreateBankField (Op, Arg->Common.Node, WalkState);
    664             break;
    665 
    666         case AML_FIELD_OP:
    667 
    668             Status = AcpiDsCreateField (Op, Arg->Common.Node, WalkState);
    669             break;
    670 
    671         default:
    672 
    673             /* All NAMED_FIELD opcodes must be handled above */
    674             break;
    675         }
    676         break;
    677 
    678      case AML_TYPE_NAMED_SIMPLE:
    679 
    680         Status = AcpiDsCreateOperands (WalkState, Arg);
    681         if (ACPI_FAILURE (Status))
    682         {
    683             goto Cleanup;
    684         }
    685 
    686         switch (Op->Common.AmlOpcode)
    687         {
    688         case AML_PROCESSOR_OP:
    689 
    690             Status = AcpiExCreateProcessor (WalkState);
    691             break;
    692 
    693         case AML_POWER_RESOURCE_OP:
    694 
    695             Status = AcpiExCreatePowerResource (WalkState);
    696             break;
    697 
    698         case AML_MUTEX_OP:
    699 
    700             Status = AcpiExCreateMutex (WalkState);
    701             break;
    702 
    703         case AML_EVENT_OP:
    704 
    705             Status = AcpiExCreateEvent (WalkState);
    706             break;
    707 
    708         case AML_ALIAS_OP:
    709 
    710             Status = AcpiExCreateAlias (WalkState);
    711             break;
    712 
    713         default:
    714 
    715             /* Unknown opcode */
    716 
    717             Status = AE_OK;
    718             goto Cleanup;
    719         }
    720 
    721         /* Delete operands */
    722 
    723         for (i = 1; i < WalkState->NumOperands; i++)
    724         {
    725             AcpiUtRemoveReference (WalkState->Operands[i]);
    726             WalkState->Operands[i] = NULL;
    727         }
    728 
    729         break;
    730 
    731     case AML_TYPE_NAMED_COMPLEX:
    732 
    733         switch (Op->Common.AmlOpcode)
    734         {
    735         case AML_REGION_OP:
    736         case AML_DATA_REGION_OP:
    737 
    738             if (Op->Common.AmlOpcode == AML_REGION_OP)
    739             {
    740                 RegionSpace = (ACPI_ADR_SPACE_TYPE)
    741                     ((Op->Common.Value.Arg)->Common.Value.Integer);
    742             }
    743             else
    744             {
    745                 RegionSpace = ACPI_ADR_SPACE_DATA_TABLE;
    746             }
    747 
    748             /*
    749              * The OpRegion is not fully parsed at this time. The only valid
    750              * argument is the SpaceId. (We must save the address of the
    751              * AML of the address and length operands)
    752              *
    753              * If we have a valid region, initialize it. The namespace is
    754              * unlocked at this point.
    755              *
    756              * Need to unlock interpreter if it is locked (if we are running
    757              * a control method), in order to allow _REG methods to be run
    758              * during AcpiEvInitializeRegion.
    759              */
    760             if (WalkState->MethodNode)
    761             {
    762                 /*
    763                  * Executing a method: initialize the region and unlock
    764                  * the interpreter
    765                  */
    766                 Status = AcpiExCreateRegion (Op->Named.Data,
    767                     Op->Named.Length, RegionSpace, WalkState);
    768                 if (ACPI_FAILURE (Status))
    769                 {
    770                     return_ACPI_STATUS (Status);
    771                 }
    772             }
    773 
    774             Status = AcpiEvInitializeRegion (
    775                 AcpiNsGetAttachedObject (Node));
    776             break;
    777 
    778         case AML_NAME_OP:
    779 
    780             Status = AcpiDsCreateNode (WalkState, Node, Op);
    781             if (ACPI_FAILURE (Status))
    782             {
    783                 goto Cleanup;
    784             }
    785 
    786 #ifdef ACPI_EXEC_APP
    787             /*
    788              * AcpiExec support for namespace initialization file (initialize
    789              * Name opcodes in this code.)
    790              */
    791             Namepath = AcpiNsGetExternalPathname (Node);
    792             Status = AeLookupInitFileEntry (Namepath, &ObjDesc);
    793             if (ACPI_SUCCESS (Status))
    794             {
    795                 /* Detach any existing object, attach new object */
    796 
    797                 if (Node->Object)
    798                 {
    799                     AcpiNsDetachObject (Node);
    800                 }
    801                 AcpiNsAttachObject (Node, ObjDesc, ObjDesc->Common.Type);
    802             }
    803             ACPI_FREE (Namepath);
    804             Status = AE_OK;
    805 #endif
    806             break;
    807 
    808         case AML_METHOD_OP:
    809             /*
    810              * MethodOp PkgLength NameString MethodFlags TermList
    811              *
    812              * Note: We must create the method node/object pair as soon as we
    813              * see the method declaration. This allows later pass1 parsing
    814              * of invocations of the method (need to know the number of
    815              * arguments.)
    816              */
    817             ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
    818                 "LOADING-Method: State=%p Op=%p NamedObj=%p\n",
    819                 WalkState, Op, Op->Named.Node));
    820 
    821             if (!AcpiNsGetAttachedObject (Op->Named.Node))
    822             {
    823                 WalkState->Operands[0] = ACPI_CAST_PTR (void, Op->Named.Node);
    824                 WalkState->NumOperands = 1;
    825 
    826                 Status = AcpiDsCreateOperands (
    827                     WalkState, Op->Common.Value.Arg);
    828                 if (ACPI_SUCCESS (Status))
    829                 {
    830                     Status = AcpiExCreateMethod (
    831                         Op->Named.Data, Op->Named.Length, WalkState);
    832                 }
    833 
    834                 WalkState->Operands[0] = NULL;
    835                 WalkState->NumOperands = 0;
    836 
    837                 if (ACPI_FAILURE (Status))
    838                 {
    839                     return_ACPI_STATUS (Status);
    840                 }
    841             }
    842             break;
    843 
    844 
    845         default:
    846 
    847             /* All NAMED_COMPLEX opcodes must be handled above */
    848             break;
    849         }
    850         break;
    851 
    852     case AML_CLASS_INTERNAL:
    853 
    854         /* case AML_INT_NAMEPATH_OP: */
    855         break;
    856 
    857     case AML_CLASS_METHOD_CALL:
    858 
    859         ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
    860             "RESOLVING-MethodCall: State=%p Op=%p NamedObj=%p\n",
    861             WalkState, Op, Node));
    862 
    863         /*
    864          * Lookup the method name and save the Node
    865          */
    866         Status = AcpiNsLookup (WalkState->ScopeInfo, Arg->Common.Value.String,
    867             ACPI_TYPE_ANY, ACPI_IMODE_LOAD_PASS2,
    868             ACPI_NS_SEARCH_PARENT | ACPI_NS_DONT_OPEN_SCOPE,
    869             WalkState, &(NewNode));
    870         if (ACPI_SUCCESS (Status))
    871         {
    872             /*
    873              * Make sure that what we found is indeed a method
    874              * We didn't search for a method on purpose, to see if the name
    875              * would resolve
    876              */
    877             if (NewNode->Type != ACPI_TYPE_METHOD)
    878             {
    879                 Status = AE_AML_OPERAND_TYPE;
    880             }
    881 
    882             /* We could put the returned object (Node) on the object stack for
    883              * later, but for now, we will put it in the "op" object that the
    884              * parser uses, so we can get it again at the end of this scope
    885              */
    886             Op->Common.Node = NewNode;
    887         }
    888         else
    889         {
    890             ACPI_ERROR_NAMESPACE (WalkState->ScopeInfo,
    891                 Arg->Common.Value.String, Status);
    892         }
    893         break;
    894 
    895 
    896     default:
    897 
    898         break;
    899     }
    900 
    901 Cleanup:
    902 
    903     /* Remove the Node pushed at the very beginning */
    904 
    905     WalkState->Operands[0] = NULL;
    906     WalkState->NumOperands = 0;
    907     return_ACPI_STATUS (Status);
    908 }
    909