xref: /titanic_50/usr/src/uts/intel/io/acpica/dispatcher/dswload.c (revision b494511a9cf72b1fc4eb13a0e593f55c624ab829)
1 /******************************************************************************
2  *
3  * Module Name: dswload - Dispatcher namespace load callbacks
4  *
5  *****************************************************************************/
6 
7 /******************************************************************************
8  *
9  * 1. Copyright Notice
10  *
11  * Some or all of this work - Copyright (c) 1999 - 2009, 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 #define __DSWLOAD_C__
117 
118 #include "acpi.h"
119 #include "accommon.h"
120 #include "acparser.h"
121 #include "amlcode.h"
122 #include "acdispat.h"
123 #include "acinterp.h"
124 #include "acnamesp.h"
125 #include "acevents.h"
126 
127 #ifdef ACPI_ASL_COMPILER
128 #include "acdisasm.h"
129 #endif
130 
131 #define _COMPONENT          ACPI_DISPATCHER
132         ACPI_MODULE_NAME    ("dswload")
133 
134 
135 /*******************************************************************************
136  *
137  * FUNCTION:    AcpiDsInitCallbacks
138  *
139  * PARAMETERS:  WalkState       - Current state of the parse tree walk
140  *              PassNumber      - 1, 2, or 3
141  *
142  * RETURN:      Status
143  *
144  * DESCRIPTION: Init walk state callbacks
145  *
146  ******************************************************************************/
147 
148 ACPI_STATUS
149 AcpiDsInitCallbacks (
150     ACPI_WALK_STATE         *WalkState,
151     UINT32                  PassNumber)
152 {
153 
154     switch (PassNumber)
155     {
156     case 1:
157         WalkState->ParseFlags         = ACPI_PARSE_LOAD_PASS1 |
158                                         ACPI_PARSE_DELETE_TREE;
159         WalkState->DescendingCallback = AcpiDsLoad1BeginOp;
160         WalkState->AscendingCallback  = AcpiDsLoad1EndOp;
161         break;
162 
163     case 2:
164         WalkState->ParseFlags         = ACPI_PARSE_LOAD_PASS1 |
165                                         ACPI_PARSE_DELETE_TREE;
166         WalkState->DescendingCallback = AcpiDsLoad2BeginOp;
167         WalkState->AscendingCallback  = AcpiDsLoad2EndOp;
168         break;
169 
170     case 3:
171 #ifndef ACPI_NO_METHOD_EXECUTION
172         WalkState->ParseFlags        |= ACPI_PARSE_EXECUTE  |
173                                         ACPI_PARSE_DELETE_TREE;
174         WalkState->DescendingCallback = AcpiDsExecBeginOp;
175         WalkState->AscendingCallback  = AcpiDsExecEndOp;
176 #endif
177         break;
178 
179     default:
180         return (AE_BAD_PARAMETER);
181     }
182 
183     return (AE_OK);
184 }
185 
186 
187 /*******************************************************************************
188  *
189  * FUNCTION:    AcpiDsLoad1BeginOp
190  *
191  * PARAMETERS:  WalkState       - Current state of the parse tree walk
192  *              OutOp           - Where to return op if a new one is created
193  *
194  * RETURN:      Status
195  *
196  * DESCRIPTION: Descending callback used during the loading of ACPI tables.
197  *
198  ******************************************************************************/
199 
200 ACPI_STATUS
201 AcpiDsLoad1BeginOp (
202     ACPI_WALK_STATE         *WalkState,
203     ACPI_PARSE_OBJECT       **OutOp)
204 {
205     ACPI_PARSE_OBJECT       *Op;
206     ACPI_NAMESPACE_NODE     *Node;
207     ACPI_STATUS             Status;
208     ACPI_OBJECT_TYPE        ObjectType;
209     char                    *Path;
210     UINT32                  Flags;
211 
212 
213     ACPI_FUNCTION_TRACE (DsLoad1BeginOp);
214 
215 
216     Op = WalkState->Op;
217     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Op=%p State=%p\n", Op, WalkState));
218 
219     /* We are only interested in opcodes that have an associated name */
220 
221     if (Op)
222     {
223         if (!(WalkState->OpInfo->Flags & AML_NAMED))
224         {
225             *OutOp = Op;
226             return_ACPI_STATUS (AE_OK);
227         }
228 
229         /* Check if this object has already been installed in the namespace */
230 
231         if (Op->Common.Node)
232         {
233             *OutOp = Op;
234             return_ACPI_STATUS (AE_OK);
235         }
236     }
237 
238     Path = AcpiPsGetNextNamestring (&WalkState->ParserState);
239 
240     /* Map the raw opcode into an internal object type */
241 
242     ObjectType = WalkState->OpInfo->ObjectType;
243 
244     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
245         "State=%p Op=%p [%s]\n", WalkState, Op, AcpiUtGetTypeName (ObjectType)));
246 
247     switch (WalkState->Opcode)
248     {
249     case AML_SCOPE_OP:
250 
251         /*
252          * The target name of the Scope() operator must exist at this point so
253          * that we can actually open the scope to enter new names underneath it.
254          * Allow search-to-root for single namesegs.
255          */
256         Status = AcpiNsLookup (WalkState->ScopeInfo, Path, ObjectType,
257                         ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT, WalkState, &(Node));
258 #ifdef ACPI_ASL_COMPILER
259         if (Status == AE_NOT_FOUND)
260         {
261             /*
262              * Table disassembly:
263              * Target of Scope() not found. Generate an External for it, and
264              * insert the name into the namespace.
265              */
266             AcpiDmAddToExternalList (Op, Path, ACPI_TYPE_DEVICE, 0);
267             Status = AcpiNsLookup (WalkState->ScopeInfo, Path, ObjectType,
268                        ACPI_IMODE_LOAD_PASS1, ACPI_NS_SEARCH_PARENT,
269                        WalkState, &Node);
270         }
271 #endif
272         if (ACPI_FAILURE (Status))
273         {
274             ACPI_ERROR_NAMESPACE (Path, Status);
275             return_ACPI_STATUS (Status);
276         }
277 
278         /*
279          * Check to make sure that the target is
280          * one of the opcodes that actually opens a scope
281          */
282         switch (Node->Type)
283         {
284         case ACPI_TYPE_ANY:
285         case ACPI_TYPE_LOCAL_SCOPE:         /* Scope  */
286         case ACPI_TYPE_DEVICE:
287         case ACPI_TYPE_POWER:
288         case ACPI_TYPE_PROCESSOR:
289         case ACPI_TYPE_THERMAL:
290 
291             /* These are acceptable types */
292             break;
293 
294         case ACPI_TYPE_INTEGER:
295         case ACPI_TYPE_STRING:
296         case ACPI_TYPE_BUFFER:
297 
298             /*
299              * These types we will allow, but we will change the type. This
300              * enables some existing code of the form:
301              *
302              *  Name (DEB, 0)
303              *  Scope (DEB) { ... }
304              *
305              * Note: silently change the type here. On the second pass, we will report
306              * a warning
307              */
308             ACPI_DEBUG_PRINT ((ACPI_DB_INFO,
309                 "Type override - [%4.4s] had invalid type (%s) for Scope operator, changed to (Scope)\n",
310                 Path, AcpiUtGetTypeName (Node->Type)));
311 
312             Node->Type = ACPI_TYPE_ANY;
313             WalkState->ScopeInfo->Common.Value = ACPI_TYPE_ANY;
314             break;
315 
316         default:
317 
318             /* All other types are an error */
319 
320             ACPI_ERROR ((AE_INFO,
321                 "Invalid type (%s) for target of Scope operator [%4.4s] (Cannot override)",
322                 AcpiUtGetTypeName (Node->Type), Path));
323 
324             return_ACPI_STATUS (AE_AML_OPERAND_TYPE);
325         }
326         break;
327 
328 
329     default:
330         /*
331          * For all other named opcodes, we will enter the name into
332          * the namespace.
333          *
334          * Setup the search flags.
335          * Since we are entering a name into the namespace, we do not want to
336          * enable the search-to-root upsearch.
337          *
338          * There are only two conditions where it is acceptable that the name
339          * already exists:
340          *    1) the Scope() operator can reopen a scoping object that was
341          *       previously defined (Scope, Method, Device, etc.)
342          *    2) Whenever we are parsing a deferred opcode (OpRegion, Buffer,
343          *       BufferField, or Package), the name of the object is already
344          *       in the namespace.
345          */
346         if (WalkState->DeferredNode)
347         {
348             /* This name is already in the namespace, get the node */
349 
350             Node = WalkState->DeferredNode;
351             Status = AE_OK;
352             break;
353         }
354 
355         /*
356          * If we are executing a method, do not create any namespace objects
357          * during the load phase, only during execution.
358          */
359         if (WalkState->MethodNode)
360         {
361             Node = NULL;
362             Status = AE_OK;
363             break;
364         }
365 
366         Flags = ACPI_NS_NO_UPSEARCH;
367         if ((WalkState->Opcode != AML_SCOPE_OP) &&
368             (!(WalkState->ParseFlags & ACPI_PARSE_DEFERRED_OP)))
369         {
370             Flags |= ACPI_NS_ERROR_IF_FOUND;
371             ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "[%s] Cannot already exist\n",
372                     AcpiUtGetTypeName (ObjectType)));
373         }
374         else
375         {
376             ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
377                 "[%s] Both Find or Create allowed\n",
378                     AcpiUtGetTypeName (ObjectType)));
379         }
380 
381         /*
382          * Enter the named type into the internal namespace. We enter the name
383          * as we go downward in the parse tree. Any necessary subobjects that
384          * involve arguments to the opcode must be created as we go back up the
385          * parse tree later.
386          */
387         Status = AcpiNsLookup (WalkState->ScopeInfo, Path, ObjectType,
388                         ACPI_IMODE_LOAD_PASS1, Flags, WalkState, &Node);
389         if (ACPI_FAILURE (Status))
390         {
391             if (Status == AE_ALREADY_EXISTS)
392             {
393                 /* The name already exists in this scope */
394 
395                 if (Node->Flags & ANOBJ_IS_EXTERNAL)
396                 {
397                     /*
398                      * Allow one create on an object or segment that was
399                      * previously declared External
400                      */
401                     Node->Flags &= ~ANOBJ_IS_EXTERNAL;
402                     Node->Type = (UINT8) ObjectType;
403 
404                     /* Just retyped a node, probably will need to open a scope */
405 
406                     if (AcpiNsOpensScope (ObjectType))
407                     {
408                         Status = AcpiDsScopeStackPush (Node, ObjectType, WalkState);
409                         if (ACPI_FAILURE (Status))
410                         {
411                             return_ACPI_STATUS (Status);
412                         }
413                     }
414 
415                     Status = AE_OK;
416                 }
417             }
418 
419             if (ACPI_FAILURE (Status))
420             {
421                 ACPI_ERROR_NAMESPACE (Path, Status);
422                 return_ACPI_STATUS (Status);
423             }
424         }
425         break;
426     }
427 
428     /* Common exit */
429 
430     if (!Op)
431     {
432         /* Create a new op */
433 
434         Op = AcpiPsAllocOp (WalkState->Opcode);
435         if (!Op)
436         {
437             return_ACPI_STATUS (AE_NO_MEMORY);
438         }
439     }
440 
441     /* Initialize the op */
442 
443 #if (defined (ACPI_NO_METHOD_EXECUTION) || defined (ACPI_CONSTANT_EVAL_ONLY))
444     Op->Named.Path = ACPI_CAST_PTR (UINT8, Path);
445 #endif
446 
447     if (Node)
448     {
449         /*
450          * Put the Node in the "op" object that the parser uses, so we
451          * can get it again quickly when this scope is closed
452          */
453         Op->Common.Node = Node;
454         Op->Named.Name = Node->Name.Integer;
455     }
456 
457     AcpiPsAppendArg (AcpiPsGetParentScope (&WalkState->ParserState), Op);
458     *OutOp = Op;
459     return_ACPI_STATUS (Status);
460 }
461 
462 
463 /*******************************************************************************
464  *
465  * FUNCTION:    AcpiDsLoad1EndOp
466  *
467  * PARAMETERS:  WalkState       - Current state of the parse tree walk
468  *
469  * RETURN:      Status
470  *
471  * DESCRIPTION: Ascending callback used during the loading of the namespace,
472  *              both control methods and everything else.
473  *
474  ******************************************************************************/
475 
476 ACPI_STATUS
477 AcpiDsLoad1EndOp (
478     ACPI_WALK_STATE         *WalkState)
479 {
480     ACPI_PARSE_OBJECT       *Op;
481     ACPI_OBJECT_TYPE        ObjectType;
482     ACPI_STATUS             Status = AE_OK;
483 
484 
485     ACPI_FUNCTION_TRACE (DsLoad1EndOp);
486 
487 
488     Op = WalkState->Op;
489     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Op=%p State=%p\n", Op, WalkState));
490 
491     /* We are only interested in opcodes that have an associated name */
492 
493     if (!(WalkState->OpInfo->Flags & (AML_NAMED | AML_FIELD)))
494     {
495         return_ACPI_STATUS (AE_OK);
496     }
497 
498     /* Get the object type to determine if we should pop the scope */
499 
500     ObjectType = WalkState->OpInfo->ObjectType;
501 
502 #ifndef ACPI_NO_METHOD_EXECUTION
503     if (WalkState->OpInfo->Flags & AML_FIELD)
504     {
505         /*
506          * If we are executing a method, do not create any namespace objects
507          * during the load phase, only during execution.
508          */
509         if (!WalkState->MethodNode)
510         {
511             if (WalkState->Opcode == AML_FIELD_OP          ||
512                 WalkState->Opcode == AML_BANK_FIELD_OP     ||
513                 WalkState->Opcode == AML_INDEX_FIELD_OP)
514             {
515                 Status = AcpiDsInitFieldObjects (Op, WalkState);
516             }
517         }
518         return_ACPI_STATUS (Status);
519     }
520 
521     /*
522      * If we are executing a method, do not create any namespace objects
523      * during the load phase, only during execution.
524      */
525     if (!WalkState->MethodNode)
526     {
527         if (Op->Common.AmlOpcode == AML_REGION_OP)
528         {
529             Status = AcpiExCreateRegion (Op->Named.Data, Op->Named.Length,
530                         (ACPI_ADR_SPACE_TYPE) ((Op->Common.Value.Arg)->Common.Value.Integer),
531                         WalkState);
532             if (ACPI_FAILURE (Status))
533             {
534                 return_ACPI_STATUS (Status);
535             }
536         }
537         else if (Op->Common.AmlOpcode == AML_DATA_REGION_OP)
538         {
539             Status = AcpiExCreateRegion (Op->Named.Data, Op->Named.Length,
540                         REGION_DATA_TABLE, WalkState);
541             if (ACPI_FAILURE (Status))
542             {
543                 return_ACPI_STATUS (Status);
544             }
545         }
546     }
547 #endif
548 
549     if (Op->Common.AmlOpcode == AML_NAME_OP)
550     {
551         /* For Name opcode, get the object type from the argument */
552 
553         if (Op->Common.Value.Arg)
554         {
555             ObjectType = (AcpiPsGetOpcodeInfo (
556                 (Op->Common.Value.Arg)->Common.AmlOpcode))->ObjectType;
557 
558             /* Set node type if we have a namespace node */
559 
560             if (Op->Common.Node)
561             {
562                 Op->Common.Node->Type = (UINT8) ObjectType;
563             }
564         }
565     }
566 
567     /*
568      * If we are executing a method, do not create any namespace objects
569      * during the load phase, only during execution.
570      */
571     if (!WalkState->MethodNode)
572     {
573         if (Op->Common.AmlOpcode == AML_METHOD_OP)
574         {
575             /*
576              * MethodOp PkgLength NameString MethodFlags TermList
577              *
578              * Note: We must create the method node/object pair as soon as we
579              * see the method declaration. This allows later pass1 parsing
580              * of invocations of the method (need to know the number of
581              * arguments.)
582              */
583             ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
584                 "LOADING-Method: State=%p Op=%p NamedObj=%p\n",
585                 WalkState, Op, Op->Named.Node));
586 
587             if (!AcpiNsGetAttachedObject (Op->Named.Node))
588             {
589                 WalkState->Operands[0] = ACPI_CAST_PTR (void, Op->Named.Node);
590                 WalkState->NumOperands = 1;
591 
592                 Status = AcpiDsCreateOperands (WalkState, Op->Common.Value.Arg);
593                 if (ACPI_SUCCESS (Status))
594                 {
595                     Status = AcpiExCreateMethod (Op->Named.Data,
596                                         Op->Named.Length, WalkState);
597                 }
598 
599                 WalkState->Operands[0] = NULL;
600                 WalkState->NumOperands = 0;
601 
602                 if (ACPI_FAILURE (Status))
603                 {
604                     return_ACPI_STATUS (Status);
605                 }
606             }
607         }
608     }
609 
610     /* Pop the scope stack (only if loading a table) */
611 
612     if (!WalkState->MethodNode &&
613         AcpiNsOpensScope (ObjectType))
614     {
615         ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "(%s): Popping scope for Op %p\n",
616             AcpiUtGetTypeName (ObjectType), Op));
617 
618         Status = AcpiDsScopeStackPop (WalkState);
619     }
620 
621     return_ACPI_STATUS (Status);
622 }
623 
624 
625 /*******************************************************************************
626  *
627  * FUNCTION:    AcpiDsLoad2BeginOp
628  *
629  * PARAMETERS:  WalkState       - Current state of the parse tree walk
630  *              OutOp           - Wher to return op if a new one is created
631  *
632  * RETURN:      Status
633  *
634  * DESCRIPTION: Descending callback used during the loading of ACPI tables.
635  *
636  ******************************************************************************/
637 
638 ACPI_STATUS
639 AcpiDsLoad2BeginOp (
640     ACPI_WALK_STATE         *WalkState,
641     ACPI_PARSE_OBJECT       **OutOp)
642 {
643     ACPI_PARSE_OBJECT       *Op;
644     ACPI_NAMESPACE_NODE     *Node;
645     ACPI_STATUS             Status;
646     ACPI_OBJECT_TYPE        ObjectType;
647     char                    *BufferPtr;
648     UINT32                  Flags;
649 
650 
651     ACPI_FUNCTION_TRACE (DsLoad2BeginOp);
652 
653 
654     Op = WalkState->Op;
655     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Op=%p State=%p\n", Op, WalkState));
656 
657     if (Op)
658     {
659         if ((WalkState->ControlState) &&
660             (WalkState->ControlState->Common.State ==
661                 ACPI_CONTROL_CONDITIONAL_EXECUTING))
662         {
663             /* We are executing a while loop outside of a method */
664 
665             Status = AcpiDsExecBeginOp (WalkState, OutOp);
666             return_ACPI_STATUS (Status);
667         }
668 
669         /* We only care about Namespace opcodes here */
670 
671         if ((!(WalkState->OpInfo->Flags & AML_NSOPCODE)   &&
672               (WalkState->Opcode != AML_INT_NAMEPATH_OP)) ||
673             (!(WalkState->OpInfo->Flags & AML_NAMED)))
674         {
675             return_ACPI_STATUS (AE_OK);
676         }
677 
678         /* Get the name we are going to enter or lookup in the namespace */
679 
680         if (WalkState->Opcode == AML_INT_NAMEPATH_OP)
681         {
682             /* For Namepath op, get the path string */
683 
684             BufferPtr = Op->Common.Value.String;
685             if (!BufferPtr)
686             {
687                 /* No name, just exit */
688 
689                 return_ACPI_STATUS (AE_OK);
690             }
691         }
692         else
693         {
694             /* Get name from the op */
695 
696             BufferPtr = ACPI_CAST_PTR (char, &Op->Named.Name);
697         }
698     }
699     else
700     {
701         /* Get the namestring from the raw AML */
702 
703         BufferPtr = AcpiPsGetNextNamestring (&WalkState->ParserState);
704     }
705 
706     /* Map the opcode into an internal object type */
707 
708     ObjectType = WalkState->OpInfo->ObjectType;
709 
710     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
711         "State=%p Op=%p Type=%X\n", WalkState, Op, ObjectType));
712 
713     switch (WalkState->Opcode)
714     {
715     case AML_FIELD_OP:
716     case AML_BANK_FIELD_OP:
717     case AML_INDEX_FIELD_OP:
718 
719         Node = NULL;
720         Status = AE_OK;
721         break;
722 
723     case AML_INT_NAMEPATH_OP:
724         /*
725          * The NamePath is an object reference to an existing object.
726          * Don't enter the name into the namespace, but look it up
727          * for use later.
728          */
729         Status = AcpiNsLookup (WalkState->ScopeInfo, BufferPtr, ObjectType,
730                         ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
731                         WalkState, &(Node));
732         break;
733 
734     case AML_SCOPE_OP:
735 
736         /* Special case for Scope(\) -> refers to the Root node */
737 
738         if (Op && (Op->Named.Node == AcpiGbl_RootNode))
739         {
740             Node = Op->Named.Node;
741 
742             Status = AcpiDsScopeStackPush (Node, ObjectType, WalkState);
743             if (ACPI_FAILURE (Status))
744             {
745                 return_ACPI_STATUS (Status);
746             }
747         }
748         else
749         {
750             /*
751              * The Path is an object reference to an existing object.
752              * Don't enter the name into the namespace, but look it up
753              * for use later.
754              */
755             Status = AcpiNsLookup (WalkState->ScopeInfo, BufferPtr, ObjectType,
756                         ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
757                         WalkState, &(Node));
758             if (ACPI_FAILURE (Status))
759             {
760 #ifdef ACPI_ASL_COMPILER
761                 if (Status == AE_NOT_FOUND)
762                 {
763                     Status = AE_OK;
764                 }
765                 else
766                 {
767                     ACPI_ERROR_NAMESPACE (BufferPtr, Status);
768                 }
769 #else
770                 ACPI_ERROR_NAMESPACE (BufferPtr, Status);
771 #endif
772                 return_ACPI_STATUS (Status);
773             }
774         }
775 
776         /*
777          * We must check to make sure that the target is
778          * one of the opcodes that actually opens a scope
779          */
780         switch (Node->Type)
781         {
782         case ACPI_TYPE_ANY:
783         case ACPI_TYPE_LOCAL_SCOPE:         /* Scope */
784         case ACPI_TYPE_DEVICE:
785         case ACPI_TYPE_POWER:
786         case ACPI_TYPE_PROCESSOR:
787         case ACPI_TYPE_THERMAL:
788 
789             /* These are acceptable types */
790             break;
791 
792         case ACPI_TYPE_INTEGER:
793         case ACPI_TYPE_STRING:
794         case ACPI_TYPE_BUFFER:
795 
796             /*
797              * These types we will allow, but we will change the type. This
798              * enables some existing code of the form:
799              *
800              *  Name (DEB, 0)
801              *  Scope (DEB) { ... }
802              */
803             ACPI_WARNING ((AE_INFO,
804                 "Type override - [%4.4s] had invalid type (%s) for Scope operator, changed to (Scope)",
805                 BufferPtr, AcpiUtGetTypeName (Node->Type)));
806 
807             Node->Type = ACPI_TYPE_ANY;
808             WalkState->ScopeInfo->Common.Value = ACPI_TYPE_ANY;
809             break;
810 
811         default:
812 
813             /* All other types are an error */
814 
815             ACPI_ERROR ((AE_INFO,
816                 "Invalid type (%s) for target of Scope operator [%4.4s]",
817                 AcpiUtGetTypeName (Node->Type), BufferPtr));
818 
819             return (AE_AML_OPERAND_TYPE);
820         }
821         break;
822 
823     default:
824 
825         /* All other opcodes */
826 
827         if (Op && Op->Common.Node)
828         {
829             /* This op/node was previously entered into the namespace */
830 
831             Node = Op->Common.Node;
832 
833             if (AcpiNsOpensScope (ObjectType))
834             {
835                 Status = AcpiDsScopeStackPush (Node, ObjectType, WalkState);
836                 if (ACPI_FAILURE (Status))
837                 {
838                     return_ACPI_STATUS (Status);
839                 }
840             }
841 
842             return_ACPI_STATUS (AE_OK);
843         }
844 
845         /*
846          * Enter the named type into the internal namespace. We enter the name
847          * as we go downward in the parse tree. Any necessary subobjects that
848          * involve arguments to the opcode must be created as we go back up the
849          * parse tree later.
850          *
851          * Note: Name may already exist if we are executing a deferred opcode.
852          */
853         if (WalkState->DeferredNode)
854         {
855             /* This name is already in the namespace, get the node */
856 
857             Node = WalkState->DeferredNode;
858             Status = AE_OK;
859             break;
860         }
861 
862         Flags = ACPI_NS_NO_UPSEARCH;
863         if (WalkState->PassNumber == ACPI_IMODE_EXECUTE)
864         {
865             /* Execution mode, node cannot already exist, node is temporary */
866 
867             Flags |= ACPI_NS_ERROR_IF_FOUND;
868 
869             if (!(WalkState->ParseFlags & ACPI_PARSE_MODULE_LEVEL))
870             {
871                 Flags |= ACPI_NS_TEMPORARY;
872             }
873         }
874 
875         /* Add new entry or lookup existing entry */
876 
877         Status = AcpiNsLookup (WalkState->ScopeInfo, BufferPtr, ObjectType,
878                     ACPI_IMODE_LOAD_PASS2, Flags, WalkState, &Node);
879 
880         if (ACPI_SUCCESS (Status) && (Flags & ACPI_NS_TEMPORARY))
881         {
882             ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
883                 "***New Node [%4.4s] %p is temporary\n",
884                 AcpiUtGetNodeName (Node), Node));
885         }
886         break;
887     }
888 
889     if (ACPI_FAILURE (Status))
890     {
891         ACPI_ERROR_NAMESPACE (BufferPtr, Status);
892         return_ACPI_STATUS (Status);
893     }
894 
895     if (!Op)
896     {
897         /* Create a new op */
898 
899         Op = AcpiPsAllocOp (WalkState->Opcode);
900         if (!Op)
901         {
902             return_ACPI_STATUS (AE_NO_MEMORY);
903         }
904 
905         /* Initialize the new op */
906 
907         if (Node)
908         {
909             Op->Named.Name = Node->Name.Integer;
910         }
911         *OutOp = Op;
912     }
913 
914     /*
915      * Put the Node in the "op" object that the parser uses, so we
916      * can get it again quickly when this scope is closed
917      */
918     Op->Common.Node = Node;
919     return_ACPI_STATUS (Status);
920 }
921 
922 
923 /*******************************************************************************
924  *
925  * FUNCTION:    AcpiDsLoad2EndOp
926  *
927  * PARAMETERS:  WalkState       - Current state of the parse tree walk
928  *
929  * RETURN:      Status
930  *
931  * DESCRIPTION: Ascending callback used during the loading of the namespace,
932  *              both control methods and everything else.
933  *
934  ******************************************************************************/
935 
936 ACPI_STATUS
937 AcpiDsLoad2EndOp (
938     ACPI_WALK_STATE         *WalkState)
939 {
940     ACPI_PARSE_OBJECT       *Op;
941     ACPI_STATUS             Status = AE_OK;
942     ACPI_OBJECT_TYPE        ObjectType;
943     ACPI_NAMESPACE_NODE     *Node;
944     ACPI_PARSE_OBJECT       *Arg;
945     ACPI_NAMESPACE_NODE     *NewNode;
946 #ifndef ACPI_NO_METHOD_EXECUTION
947     UINT32                  i;
948     UINT8                   RegionSpace;
949 #endif
950 
951 
952     ACPI_FUNCTION_TRACE (DsLoad2EndOp);
953 
954     Op = WalkState->Op;
955     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Opcode [%s] Op %p State %p\n",
956             WalkState->OpInfo->Name, Op, WalkState));
957 
958     /* Check if opcode had an associated namespace object */
959 
960     if (!(WalkState->OpInfo->Flags & AML_NSOBJECT))
961     {
962         return_ACPI_STATUS (AE_OK);
963     }
964 
965     if (Op->Common.AmlOpcode == AML_SCOPE_OP)
966     {
967         ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
968             "Ending scope Op=%p State=%p\n", Op, WalkState));
969     }
970 
971     ObjectType = WalkState->OpInfo->ObjectType;
972 
973     /*
974      * Get the Node/name from the earlier lookup
975      * (It was saved in the *op structure)
976      */
977     Node = Op->Common.Node;
978 
979     /*
980      * Put the Node on the object stack (Contains the ACPI Name of
981      * this object)
982      */
983     WalkState->Operands[0] = (void *) Node;
984     WalkState->NumOperands = 1;
985 
986     /* Pop the scope stack */
987 
988     if (AcpiNsOpensScope (ObjectType) &&
989        (Op->Common.AmlOpcode != AML_INT_METHODCALL_OP))
990     {
991         ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "(%s) Popping scope for Op %p\n",
992             AcpiUtGetTypeName (ObjectType), Op));
993 
994         Status = AcpiDsScopeStackPop (WalkState);
995         if (ACPI_FAILURE (Status))
996         {
997             goto Cleanup;
998         }
999     }
1000 
1001     /*
1002      * Named operations are as follows:
1003      *
1004      * AML_ALIAS
1005      * AML_BANKFIELD
1006      * AML_CREATEBITFIELD
1007      * AML_CREATEBYTEFIELD
1008      * AML_CREATEDWORDFIELD
1009      * AML_CREATEFIELD
1010      * AML_CREATEQWORDFIELD
1011      * AML_CREATEWORDFIELD
1012      * AML_DATA_REGION
1013      * AML_DEVICE
1014      * AML_EVENT
1015      * AML_FIELD
1016      * AML_INDEXFIELD
1017      * AML_METHOD
1018      * AML_METHODCALL
1019      * AML_MUTEX
1020      * AML_NAME
1021      * AML_NAMEDFIELD
1022      * AML_OPREGION
1023      * AML_POWERRES
1024      * AML_PROCESSOR
1025      * AML_SCOPE
1026      * AML_THERMALZONE
1027      */
1028 
1029     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
1030         "Create-Load [%s] State=%p Op=%p NamedObj=%p\n",
1031         AcpiPsGetOpcodeName (Op->Common.AmlOpcode), WalkState, Op, Node));
1032 
1033     /* Decode the opcode */
1034 
1035     Arg = Op->Common.Value.Arg;
1036 
1037     switch (WalkState->OpInfo->Type)
1038     {
1039 #ifndef ACPI_NO_METHOD_EXECUTION
1040 
1041     case AML_TYPE_CREATE_FIELD:
1042         /*
1043          * Create the field object, but the field buffer and index must
1044          * be evaluated later during the execution phase
1045          */
1046         Status = AcpiDsCreateBufferField (Op, WalkState);
1047         break;
1048 
1049 
1050      case AML_TYPE_NAMED_FIELD:
1051         /*
1052          * If we are executing a method, initialize the field
1053          */
1054         if (WalkState->MethodNode)
1055         {
1056             Status = AcpiDsInitFieldObjects (Op, WalkState);
1057         }
1058 
1059         switch (Op->Common.AmlOpcode)
1060         {
1061         case AML_INDEX_FIELD_OP:
1062 
1063             Status = AcpiDsCreateIndexField (Op, (ACPI_HANDLE) Arg->Common.Node,
1064                         WalkState);
1065             break;
1066 
1067         case AML_BANK_FIELD_OP:
1068 
1069             Status = AcpiDsCreateBankField (Op, Arg->Common.Node, WalkState);
1070             break;
1071 
1072         case AML_FIELD_OP:
1073 
1074             Status = AcpiDsCreateField (Op, Arg->Common.Node, WalkState);
1075             break;
1076 
1077         default:
1078             /* All NAMED_FIELD opcodes must be handled above */
1079             break;
1080         }
1081         break;
1082 
1083 
1084      case AML_TYPE_NAMED_SIMPLE:
1085 
1086         Status = AcpiDsCreateOperands (WalkState, Arg);
1087         if (ACPI_FAILURE (Status))
1088         {
1089             goto Cleanup;
1090         }
1091 
1092         switch (Op->Common.AmlOpcode)
1093         {
1094         case AML_PROCESSOR_OP:
1095 
1096             Status = AcpiExCreateProcessor (WalkState);
1097             break;
1098 
1099         case AML_POWER_RES_OP:
1100 
1101             Status = AcpiExCreatePowerResource (WalkState);
1102             break;
1103 
1104         case AML_MUTEX_OP:
1105 
1106             Status = AcpiExCreateMutex (WalkState);
1107             break;
1108 
1109         case AML_EVENT_OP:
1110 
1111             Status = AcpiExCreateEvent (WalkState);
1112             break;
1113 
1114 
1115         case AML_ALIAS_OP:
1116 
1117             Status = AcpiExCreateAlias (WalkState);
1118             break;
1119 
1120         default:
1121             /* Unknown opcode */
1122 
1123             Status = AE_OK;
1124             goto Cleanup;
1125         }
1126 
1127         /* Delete operands */
1128 
1129         for (i = 1; i < WalkState->NumOperands; i++)
1130         {
1131             AcpiUtRemoveReference (WalkState->Operands[i]);
1132             WalkState->Operands[i] = NULL;
1133         }
1134 
1135         break;
1136 #endif /* ACPI_NO_METHOD_EXECUTION */
1137 
1138     case AML_TYPE_NAMED_COMPLEX:
1139 
1140         switch (Op->Common.AmlOpcode)
1141         {
1142 #ifndef ACPI_NO_METHOD_EXECUTION
1143         case AML_REGION_OP:
1144         case AML_DATA_REGION_OP:
1145 
1146             if (Op->Common.AmlOpcode == AML_REGION_OP)
1147             {
1148                 RegionSpace = (ACPI_ADR_SPACE_TYPE)
1149                       ((Op->Common.Value.Arg)->Common.Value.Integer);
1150             }
1151             else
1152             {
1153                 RegionSpace = REGION_DATA_TABLE;
1154             }
1155 
1156             /*
1157              * The OpRegion is not fully parsed at this time. The only valid
1158              * argument is the SpaceId. (We must save the address of the
1159              * AML of the address and length operands)
1160              *
1161              * If we have a valid region, initialize it. The Namespace is NOT
1162              * locked at this point.
1163              *
1164              * Need to unlock interpreter if it is locked (if we are running
1165              * a control method), in order to allow _REG methods to be run
1166              * during AcpiEvInitializeRegion.
1167              */
1168             if (WalkState->MethodNode)
1169             {
1170                 /*
1171                  * Executing a method: initialize the region and unlock
1172                  * the interpreter
1173                  */
1174                 Status = AcpiExCreateRegion (Op->Named.Data, Op->Named.Length,
1175                             RegionSpace, WalkState);
1176                 if (ACPI_FAILURE (Status))
1177                 {
1178                     return (Status);
1179                 }
1180 
1181                 AcpiExExitInterpreter ();
1182             }
1183 
1184             Status = AcpiEvInitializeRegion (AcpiNsGetAttachedObject (Node),
1185                         FALSE);
1186             if (WalkState->MethodNode)
1187             {
1188                 AcpiExEnterInterpreter ();
1189             }
1190 
1191             if (ACPI_FAILURE (Status))
1192             {
1193                 /*
1194                  *  If AE_NOT_EXIST is returned, it is not fatal
1195                  *  because many regions get created before a handler
1196                  *  is installed for said region.
1197                  */
1198                 if (AE_NOT_EXIST == Status)
1199                 {
1200                     Status = AE_OK;
1201                 }
1202             }
1203             break;
1204 
1205 
1206         case AML_NAME_OP:
1207 
1208             Status = AcpiDsCreateNode (WalkState, Node, Op);
1209             break;
1210 
1211 
1212         case AML_METHOD_OP:
1213             /*
1214              * MethodOp PkgLength NameString MethodFlags TermList
1215              *
1216              * Note: We must create the method node/object pair as soon as we
1217              * see the method declaration. This allows later pass1 parsing
1218              * of invocations of the method (need to know the number of
1219              * arguments.)
1220              */
1221             ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
1222                 "LOADING-Method: State=%p Op=%p NamedObj=%p\n",
1223                 WalkState, Op, Op->Named.Node));
1224 
1225             if (!AcpiNsGetAttachedObject (Op->Named.Node))
1226             {
1227                 WalkState->Operands[0] = ACPI_CAST_PTR (void, Op->Named.Node);
1228                 WalkState->NumOperands = 1;
1229 
1230                 Status = AcpiDsCreateOperands (WalkState, Op->Common.Value.Arg);
1231                 if (ACPI_SUCCESS (Status))
1232                 {
1233                     Status = AcpiExCreateMethod (Op->Named.Data,
1234                                         Op->Named.Length, WalkState);
1235                 }
1236                 WalkState->Operands[0] = NULL;
1237                 WalkState->NumOperands = 0;
1238 
1239                 if (ACPI_FAILURE (Status))
1240                 {
1241                     return_ACPI_STATUS (Status);
1242                 }
1243             }
1244             break;
1245 
1246 #endif /* ACPI_NO_METHOD_EXECUTION */
1247 
1248         default:
1249             /* All NAMED_COMPLEX opcodes must be handled above */
1250             break;
1251         }
1252         break;
1253 
1254 
1255     case AML_CLASS_INTERNAL:
1256 
1257         /* case AML_INT_NAMEPATH_OP: */
1258         break;
1259 
1260 
1261     case AML_CLASS_METHOD_CALL:
1262 
1263         ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
1264             "RESOLVING-MethodCall: State=%p Op=%p NamedObj=%p\n",
1265             WalkState, Op, Node));
1266 
1267         /*
1268          * Lookup the method name and save the Node
1269          */
1270         Status = AcpiNsLookup (WalkState->ScopeInfo, Arg->Common.Value.String,
1271                         ACPI_TYPE_ANY, ACPI_IMODE_LOAD_PASS2,
1272                         ACPI_NS_SEARCH_PARENT | ACPI_NS_DONT_OPEN_SCOPE,
1273                         WalkState, &(NewNode));
1274         if (ACPI_SUCCESS (Status))
1275         {
1276             /*
1277              * Make sure that what we found is indeed a method
1278              * We didn't search for a method on purpose, to see if the name
1279              * would resolve
1280              */
1281             if (NewNode->Type != ACPI_TYPE_METHOD)
1282             {
1283                 Status = AE_AML_OPERAND_TYPE;
1284             }
1285 
1286             /* We could put the returned object (Node) on the object stack for
1287              * later, but for now, we will put it in the "op" object that the
1288              * parser uses, so we can get it again at the end of this scope
1289              */
1290             Op->Common.Node = NewNode;
1291         }
1292         else
1293         {
1294             ACPI_ERROR_NAMESPACE (Arg->Common.Value.String, Status);
1295         }
1296         break;
1297 
1298 
1299     default:
1300         break;
1301     }
1302 
1303 Cleanup:
1304 
1305     /* Remove the Node pushed at the very beginning */
1306 
1307     WalkState->Operands[0] = NULL;
1308     WalkState->NumOperands = 0;
1309     return_ACPI_STATUS (Status);
1310 }
1311 
1312 
1313