1 /******************************************************************************
3 * Module Name: dswload - Dispatcher namespace load callbacks
5 *****************************************************************************/
7 /******************************************************************************
11 * Some or all of this work - Copyright (c) 1999 - 2018, Intel Corp.
12 * All rights reserved.
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
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
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;
37 * The above copyright and patent license is granted only if the following
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.
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
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
72 * 3.4. Intel retains all right, title, and interest in and to the Original
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.
80 * 4. Disclaimer and Export Compliance
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
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
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.
114 *****************************************************************************
116 * Alternatively, you may choose to be licensed under the terms of the
119 * Redistribution and use in source and binary forms, with or without
120 * modification, are permitted provided that the following conditions
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.
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.
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.
150 *****************************************************************************/
152 #include "aslcompiler.h"
154 #include "acdispat.h"
155 #include "acnamesp.h"
156 #include "acparser.h"
157 #include "aslcompiler.y.h"
160 #define _COMPONENT ACPI_COMPILER
161 ACPI_MODULE_NAME ("aslload")
163 /* Local prototypes */
166 LdLoadFieldElements (
167 ACPI_PARSE_OBJECT *Op,
168 ACPI_WALK_STATE *WalkState);
171 LdLoadResourceElements (
172 ACPI_PARSE_OBJECT *Op,
173 ACPI_WALK_STATE *WalkState);
177 ACPI_PARSE_OBJECT *Op,
183 ACPI_PARSE_OBJECT *Op,
188 LdCommonNamespaceEnd (
189 ACPI_PARSE_OBJECT *Op,
194 /*******************************************************************************
196 * FUNCTION: LdLoadNamespace
198 * PARAMETERS: RootOp - Root of the parse tree
202 * DESCRIPTION: Perform a walk of the parse tree that in turn loads all of the
203 * named ASL/AML objects into the namespace. The namespace is
204 * constructed in order to resolve named references and references
205 * to named fields within resource templates/descriptors.
207 ******************************************************************************/
211 ACPI_PARSE_OBJECT *RootOp)
213 ACPI_WALK_STATE *WalkState;
216 /* Create a new walk state */
218 WalkState = AcpiDsCreateWalkState (0, NULL, NULL, NULL);
221 return (AE_NO_MEMORY);
224 /* Walk the entire parse tree, first pass */
226 TrWalkParseTree (RootOp, ASL_WALK_VISIT_TWICE, LdNamespace1Begin,
227 LdCommonNamespaceEnd, WalkState);
229 /* Second pass to handle forward references */
231 TrWalkParseTree (RootOp, ASL_WALK_VISIT_TWICE, LdNamespace2Begin,
232 LdCommonNamespaceEnd, WalkState);
234 /* Dump the namespace if debug is enabled */
236 if (AcpiDbgLevel & ACPI_LV_TABLES)
238 AcpiNsDumpTables (ACPI_NS_ALL, ACPI_UINT32_MAX);
241 ACPI_FREE (WalkState);
246 /*******************************************************************************
248 * FUNCTION: LdLoadFieldElements
250 * PARAMETERS: Op - Parent node (Field)
251 * WalkState - Current walk state
255 * DESCRIPTION: Enter the named elements of the field (children of the parent)
256 * into the namespace.
258 ******************************************************************************/
261 LdLoadFieldElements (
262 ACPI_PARSE_OBJECT *Op,
263 ACPI_WALK_STATE *WalkState)
265 ACPI_PARSE_OBJECT *Child = NULL;
266 ACPI_NAMESPACE_NODE *Node;
270 /* Get the first named field element */
272 switch (Op->Asl.AmlOpcode)
274 case AML_BANK_FIELD_OP:
276 Child = UtGetArg (Op, 6);
279 case AML_INDEX_FIELD_OP:
281 Child = UtGetArg (Op, 5);
286 Child = UtGetArg (Op, 4);
291 /* No other opcodes should arrive here */
293 return (AE_BAD_PARAMETER);
296 /* Enter all elements into the namespace */
300 switch (Child->Asl.AmlOpcode)
302 case AML_INT_RESERVEDFIELD_OP:
303 case AML_INT_ACCESSFIELD_OP:
304 case AML_INT_CONNECTION_OP:
309 Status = AcpiNsLookup (WalkState->ScopeInfo,
310 Child->Asl.Value.String,
311 ACPI_TYPE_LOCAL_REGION_FIELD,
312 ACPI_IMODE_LOAD_PASS1,
313 ACPI_NS_NO_UPSEARCH | ACPI_NS_DONT_OPEN_SCOPE |
314 ACPI_NS_ERROR_IF_FOUND, NULL, &Node);
315 if (ACPI_FAILURE (Status))
317 if (Status != AE_ALREADY_EXISTS)
319 AslError (ASL_ERROR, ASL_MSG_CORE_EXCEPTION, Child,
320 Child->Asl.Value.String);
323 else if (Status == AE_ALREADY_EXISTS &&
324 (Node->Flags & ANOBJ_IS_EXTERNAL))
326 Node->Type = (UINT8) ACPI_TYPE_LOCAL_REGION_FIELD;
331 * The name already exists in this scope
332 * But continue processing the elements
334 AslDualParseOpError (ASL_WARNING, ASL_MSG_EXTERN_COLLISION, Child,
335 Child->Asl.Value.String, ASL_MSG_EXTERN_FOUND_HERE, Node->Op,
336 Node->Op->Asl.ExternalName);
341 Child->Asl.Node = Node;
347 Child = Child->Asl.Next;
354 /*******************************************************************************
356 * FUNCTION: LdLoadResourceElements
358 * PARAMETERS: Op - Parent node (Resource Descriptor)
359 * WalkState - Current walk state
363 * DESCRIPTION: Enter the named elements of the resource descriptor (children
364 * of the parent) into the namespace.
366 * NOTE: In the real AML namespace, these named elements never exist. But
367 * we simply use the namespace here as a symbol table so we can look
368 * them up as they are referenced.
370 ******************************************************************************/
373 LdLoadResourceElements (
374 ACPI_PARSE_OBJECT *Op,
375 ACPI_WALK_STATE *WalkState)
377 ACPI_PARSE_OBJECT *InitializerOp = NULL;
378 ACPI_NAMESPACE_NODE *Node;
383 * Enter the resource name into the namespace. Name must not already exist.
384 * This opens a scope, so later field names are guaranteed to be new/unique.
386 Status = AcpiNsLookup (WalkState->ScopeInfo, Op->Asl.Namepath,
387 ACPI_TYPE_LOCAL_RESOURCE, ACPI_IMODE_LOAD_PASS1,
388 ACPI_NS_NO_UPSEARCH | ACPI_NS_ERROR_IF_FOUND,
390 if (ACPI_FAILURE (Status))
392 if (Status == AE_ALREADY_EXISTS)
394 /* Actual node causing the error was saved in ParentMethod */
396 AslDualParseOpError (ASL_ERROR, ASL_MSG_NAME_EXISTS,
397 (ACPI_PARSE_OBJECT *) Op->Asl.ParentMethod,
398 Op->Asl.Namepath, ASL_MSG_FOUND_HERE, Node->Op,
399 Node->Op->Asl.ExternalName);
405 Node->Value = (UINT32) Op->Asl.Value.Integer;
410 * Now enter the predefined fields, for easy lookup when referenced
413 InitializerOp = ASL_GET_CHILD_NODE (Op);
414 while (InitializerOp)
416 if (InitializerOp->Asl.ExternalName)
418 Status = AcpiNsLookup (WalkState->ScopeInfo,
419 InitializerOp->Asl.ExternalName,
420 ACPI_TYPE_LOCAL_RESOURCE_FIELD, ACPI_IMODE_LOAD_PASS1,
421 ACPI_NS_NO_UPSEARCH | ACPI_NS_DONT_OPEN_SCOPE, NULL, &Node);
422 if (ACPI_FAILURE (Status))
428 * Store the field offset and length in the namespace node
429 * so it can be used when the field is referenced
431 Node->Value = InitializerOp->Asl.Value.Tag.BitOffset;
432 Node->Length = InitializerOp->Asl.Value.Tag.BitLength;
433 InitializerOp->Asl.Node = Node;
434 Node->Op = InitializerOp;
437 InitializerOp = ASL_GET_PEER_NODE (InitializerOp);
444 /*******************************************************************************
446 * FUNCTION: LdNamespace1Begin
448 * PARAMETERS: ASL_WALK_CALLBACK
452 * DESCRIPTION: Descending callback used during the parse tree walk. If this
453 * is a named AML opcode, enter into the namespace
455 ******************************************************************************/
459 ACPI_PARSE_OBJECT *Op,
463 ACPI_WALK_STATE *WalkState = (ACPI_WALK_STATE *) Context;
464 ACPI_NAMESPACE_NODE *Node;
465 ACPI_PARSE_OBJECT *MethodOp;
467 ACPI_OBJECT_TYPE ObjectType;
468 ACPI_OBJECT_TYPE ActualObjectType = ACPI_TYPE_ANY;
470 UINT32 Flags = ACPI_NS_NO_UPSEARCH;
471 ACPI_PARSE_OBJECT *Arg;
473 BOOLEAN ForceNewScope = FALSE;
474 const ACPI_OPCODE_INFO *OpInfo;
475 ACPI_PARSE_OBJECT *ParentOp;
478 ACPI_FUNCTION_NAME (LdNamespace1Begin);
481 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Op %p [%s]\n",
482 Op, Op->Asl.ParseOpName));
485 * We are only interested in opcodes that have an associated name
486 * (or multiple names)
488 switch (Op->Asl.AmlOpcode)
490 case AML_BANK_FIELD_OP:
491 case AML_INDEX_FIELD_OP:
494 Status = LdLoadFieldElements (Op, WalkState);
497 case AML_INT_CONNECTION_OP:
500 if (Op->Asl.Child->Asl.AmlOpcode != AML_INT_NAMEPATH_OP)
506 Status = AcpiNsLookup (WalkState->ScopeInfo, Arg->Asl.ExternalName,
507 ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT,
509 if (ACPI_FAILURE (Status))
514 if (Node->Type == ACPI_TYPE_BUFFER)
516 Arg->Asl.Node = Node;
518 Arg = Node->Op->Asl.Child; /* Get namepath */
519 Arg = Arg->Asl.Next; /* Get actual buffer */
520 Arg = Arg->Asl.Child; /* Buffer length */
521 Arg = Arg->Asl.Next; /* RAW_DATA buffer */
527 /* All other opcodes go below */
532 /* Check if this object has already been installed in the namespace */
539 /* Check for a possible illegal forward reference */
541 if ((Op->Asl.ParseOpcode == PARSEOP_NAMESEG) ||
542 (Op->Asl.ParseOpcode == PARSEOP_NAMESTRING))
545 * Op->Asl.Namepath will be NULL for these opcodes.
546 * These opcodes are guaranteed to have a parent.
547 * Examine the parent opcode.
550 ParentOp = Op->Asl.Parent;
551 OpInfo = AcpiPsGetOpcodeInfo (ParentOp->Asl.AmlOpcode);
554 * Exclude all operators that actually declare a new name:
555 * Name (ABCD, 1) -> Ignore (AML_CLASS_NAMED_OBJECT)
556 * We only want references to named objects:
557 * Store (2, WXYZ) -> Attempt to resolve the name
559 if (OpInfo->Class == AML_CLASS_NAMED_OBJECT)
565 * Check if the referenced object exists at this point during
567 * 1) If it exists, then this cannot be a forward reference.
568 * 2) If it does not exist, it could be a forward reference or
569 * it truly does not exist (and no external declaration).
571 Status = AcpiNsLookup (WalkState->ScopeInfo,
572 Op->Asl.Value.Name, ACPI_TYPE_ANY, ACPI_IMODE_EXECUTE,
573 ACPI_NS_SEARCH_PARENT | ACPI_NS_DONT_OPEN_SCOPE,
575 if (Status == AE_NOT_FOUND)
578 * This is either a foward reference or the object truly
579 * does not exist. The two cases can only be differentiated
580 * during the cross-reference stage later. Mark the Op/Name
581 * as not-found for now to indicate the need for further
584 * Special case: Allow forward references from elements of
585 * Package objects. This provides compatibility with other
586 * ACPI implementations. To correctly implement this, the
587 * ACPICA table load defers package resolution until the entire
588 * namespace has been loaded.
590 if ((ParentOp->Asl.ParseOpcode != PARSEOP_PACKAGE) &&
591 (ParentOp->Asl.ParseOpcode != PARSEOP_VAR_PACKAGE))
593 Op->Asl.CompileFlags |= OP_NOT_FOUND_DURING_LOAD;
602 Path = Op->Asl.Namepath;
608 /* Map the raw opcode into an internal object type */
610 switch (Op->Asl.ParseOpcode)
614 Arg = Op->Asl.Child; /* Get the NameSeg/NameString node */
615 Arg = Arg->Asl.Next; /* First peer is the object to be associated with the name */
618 * If this name refers to a ResourceTemplate, we will need to open
619 * a new scope so that the resource subfield names can be entered into
620 * the namespace underneath this name
622 if (Op->Asl.CompileFlags & OP_IS_RESOURCE_DESC)
624 ForceNewScope = TRUE;
627 /* Get the data type associated with the named object, not the name itself */
629 /* Log2 loop to convert from Btype (binary) to Etype (encoded) */
632 for (i = 1; i < Arg->Asl.AcpiBtype; i *= 2)
638 case PARSEOP_EXTERNAL:
640 * "External" simply enters a name and type into the namespace.
641 * We must be careful to not open a new scope, however, no matter
642 * what type the external name refers to (e.g., a method)
644 * first child is name, next child is ObjectType
646 ActualObjectType = (UINT8) Op->Asl.Child->Asl.Next->Asl.Value.Integer;
647 ObjectType = ACPI_TYPE_ANY;
650 * We will mark every new node along the path as "External". This
651 * allows some or all of the nodes to be created later in the ASL
652 * code. Handles cases like this:
654 * External (\_SB_.PCI0.ABCD, IntObj)
663 * Store (\_SB_.PCI0.ABCD, Local0)
666 Flags |= ACPI_NS_EXTERNAL;
669 case PARSEOP_DEFAULT_ARG:
671 if (Op->Asl.CompileFlags == OP_IS_RESOURCE_DESC)
673 Status = LdLoadResourceElements (Op, WalkState);
674 return_ACPI_STATUS (Status);
677 ObjectType = AslMapNamedOpcodeToDataType (Op->Asl.AmlOpcode);
682 * The name referenced by Scope(Name) must already exist at this point.
683 * In other words, forward references for Scope() are not supported.
684 * The only real reason for this is that the MS interpreter cannot
685 * handle this case. Perhaps someday this case can go away.
687 Status = AcpiNsLookup (WalkState->ScopeInfo, Path, ACPI_TYPE_ANY,
688 ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT, WalkState, &Node);
689 if (ACPI_FAILURE (Status))
691 if (Status == AE_NOT_FOUND)
693 /* The name was not found, go ahead and create it */
695 Status = AcpiNsLookup (WalkState->ScopeInfo, Path,
696 ACPI_TYPE_LOCAL_SCOPE, ACPI_IMODE_LOAD_PASS1,
697 Flags, WalkState, &Node);
698 if (ACPI_FAILURE (Status))
700 return_ACPI_STATUS (Status);
703 /* However, this is an error -- operand to Scope must exist */
705 if (strlen (Op->Asl.ExternalName) == ACPI_NAME_SIZE)
707 AslError (ASL_ERROR, ASL_MSG_NOT_FOUND, Op,
708 Op->Asl.ExternalName);
712 AslError (ASL_ERROR, ASL_MSG_NAMEPATH_NOT_EXIST, Op,
713 Op->Asl.ExternalName);
719 AslCoreSubsystemError (Op, Status,
720 "Failure from namespace lookup", FALSE);
722 return_ACPI_STATUS (Status);
724 else /* Status AE_OK */
727 * Do not allow references to external scopes from the DSDT.
728 * This is because the DSDT is always loaded first, and the
729 * external reference cannot be resolved -- causing a runtime
730 * error because Scope() must be resolved immediately.
733 if ((Node->Flags & ANOBJ_IS_EXTERNAL) &&
734 (ACPI_COMPARE_NAME (AslGbl_TableSignature, "DSDT")))
736 /* However, allowed if the reference is within a method */
738 MethodOp = Op->Asl.Parent;
740 (MethodOp->Asl.ParseOpcode != PARSEOP_METHOD))
742 MethodOp = MethodOp->Asl.Parent;
747 /* Not in a control method, error */
749 AslError (ASL_ERROR, ASL_MSG_CROSS_TABLE_SCOPE, Op, NULL);
754 /* We found a node with this name, now check the type */
758 case ACPI_TYPE_LOCAL_SCOPE:
759 case ACPI_TYPE_DEVICE:
760 case ACPI_TYPE_POWER:
761 case ACPI_TYPE_PROCESSOR:
762 case ACPI_TYPE_THERMAL:
764 /* These are acceptable types - they all open a new scope */
767 case ACPI_TYPE_INTEGER:
768 case ACPI_TYPE_STRING:
769 case ACPI_TYPE_BUFFER:
771 * These types we will allow, but we will change the type.
772 * This enables some existing code of the form:
775 * Scope (DEB) { ... }
777 * Which is used to workaround the fact that the MS interpreter
778 * does not allow Scope() forward references.
780 sprintf (AslGbl_MsgBuffer, "%s [%s], changing type to [Scope]",
781 Op->Asl.ExternalName, AcpiUtGetTypeName (Node->Type));
782 AslError (ASL_REMARK, ASL_MSG_SCOPE_TYPE, Op, AslGbl_MsgBuffer);
784 /* Switch the type to scope, open the new scope */
786 Node->Type = ACPI_TYPE_LOCAL_SCOPE;
787 Status = AcpiDsScopeStackPush (Node, ACPI_TYPE_LOCAL_SCOPE,
789 if (ACPI_FAILURE (Status))
791 return_ACPI_STATUS (Status);
797 /* All other types are an error */
799 sprintf (AslGbl_MsgBuffer, "%s [%s]", Op->Asl.ExternalName,
800 AcpiUtGetTypeName (Node->Type));
801 AslError (ASL_ERROR, ASL_MSG_SCOPE_TYPE, Op, AslGbl_MsgBuffer);
804 * However, switch the type to be an actual scope so
805 * that compilation can continue without generating a whole
806 * cascade of additional errors. Open the new scope.
808 Node->Type = ACPI_TYPE_LOCAL_SCOPE;
809 Status = AcpiDsScopeStackPush (Node, ACPI_TYPE_LOCAL_SCOPE,
811 if (ACPI_FAILURE (Status))
813 return_ACPI_STATUS (Status);
823 ObjectType = AslMapNamedOpcodeToDataType (Op->Asl.AmlOpcode);
827 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Loading name: %s, (%s)\n",
828 Op->Asl.ExternalName, AcpiUtGetTypeName (ObjectType)));
830 /* The name must not already exist */
832 Flags |= ACPI_NS_ERROR_IF_FOUND;
835 * For opcodes that enter new names into the namespace,
836 * all prefix NameSegs must exist.
838 WalkState->OpInfo = AcpiPsGetOpcodeInfo (Op->Asl.AmlOpcode);
839 if (((WalkState->OpInfo->Flags & AML_NAMED) ||
840 (WalkState->OpInfo->Flags & AML_CREATE)) &&
841 (Op->Asl.AmlOpcode != AML_EXTERNAL_OP))
843 Flags |= ACPI_NS_PREFIX_MUST_EXIST;
847 * Enter the named type into the internal namespace. We enter the name
848 * as we go downward in the parse tree. Any necessary subobjects that
849 * involve arguments to the opcode must be created as we go back up the
852 Status = AcpiNsLookup (WalkState->ScopeInfo, Path, ObjectType,
853 ACPI_IMODE_LOAD_PASS1, Flags, WalkState, &Node);
854 if (ACPI_FAILURE (Status))
856 if (Status == AE_ALREADY_EXISTS)
858 /* The name already exists in this scope */
860 if (Node->Type == ACPI_TYPE_LOCAL_SCOPE)
862 /* Allow multiple references to the same scope */
864 Node->Type = (UINT8) ObjectType;
867 else if ((Node->Flags & ANOBJ_IS_EXTERNAL) &&
868 (Op->Asl.ParseOpcode != PARSEOP_EXTERNAL))
871 * Allow one create on an object or segment that was
872 * previously declared External
874 Node->Flags &= ~ANOBJ_IS_EXTERNAL;
875 Node->Type = (UINT8) ObjectType;
877 /* Just retyped a node, probably will need to open a scope */
879 if (AcpiNsOpensScope (ObjectType))
881 Status = AcpiDsScopeStackPush (Node, ObjectType, WalkState);
882 if (ACPI_FAILURE (Status))
884 return_ACPI_STATUS (Status);
890 else if (!(Node->Flags & ANOBJ_IS_EXTERNAL) &&
891 (Op->Asl.ParseOpcode == PARSEOP_EXTERNAL))
894 * Allow externals in same scope as the definition of the
895 * actual object. Similar to C. Allows multiple definition
896 * blocks that refer to each other in the same file.
900 else if ((Node->Flags & ANOBJ_IS_EXTERNAL) &&
901 (Op->Asl.ParseOpcode == PARSEOP_EXTERNAL) &&
902 (ObjectType == ACPI_TYPE_ANY))
904 /* Allow update of externals of unknown type. */
906 if (AcpiNsOpensScope (ActualObjectType))
908 Node->Type = (UINT8) ActualObjectType;
913 sprintf (AslGbl_MsgBuffer, "%s [%s]", Op->Asl.ExternalName,
914 AcpiUtGetTypeName (Node->Type));
915 AslError (ASL_ERROR, ASL_MSG_SCOPE_TYPE, Op, AslGbl_MsgBuffer);
916 return_ACPI_STATUS (AE_OK);
921 /* Valid error, object already exists */
923 AslDualParseOpError (ASL_ERROR, ASL_MSG_NAME_EXISTS, Op,
924 Op->Asl.ExternalName, ASL_MSG_FOUND_HERE, Node->Op,
925 Node->Op->Asl.ExternalName);
926 return_ACPI_STATUS (AE_OK);
929 else if (AE_NOT_FOUND)
932 * One or more prefix NameSegs of the NamePath do not exist
933 * (all of them must exist). Attempt to continue compilation
934 * by setting the current scope to the root.
936 Node = AcpiGbl_RootNode;
941 /* Flag all other errors as coming from the ACPICA core */
943 AslCoreSubsystemError (Op, Status,
944 "Failure from namespace lookup", FALSE);
945 return_ACPI_STATUS (Status);
951 Status = AcpiDsScopeStackPush (Node, ObjectType, WalkState);
952 if (ACPI_FAILURE (Status))
954 return_ACPI_STATUS (Status);
960 * Point the parse node to the new namespace node, and point
961 * the Node back to the original Parse node
966 /* Set the actual data type if appropriate (EXTERNAL term only) */
968 if (ActualObjectType != ACPI_TYPE_ANY)
970 Node->Type = (UINT8) ActualObjectType;
971 Node->Value = ASL_EXTERNAL_METHOD;
974 if (Op->Asl.ParseOpcode == PARSEOP_METHOD)
977 * Get the method argument count from "Extra" and save
978 * it in the namespace node
980 Node->Value = (UINT32) Op->Asl.Extra;
983 return_ACPI_STATUS (Status);
987 /*******************************************************************************
989 * FUNCTION: LdNamespace2Begin
991 * PARAMETERS: ASL_WALK_CALLBACK
995 * DESCRIPTION: Descending callback used during the pass 2 parse tree walk.
996 * Second pass resolves some forward references.
999 * Currently only needs to handle the Alias operator.
1000 * Could be used to allow forward references from the Scope() operator, but
1001 * the MS interpreter does not allow this, so this compiler does not either.
1003 ******************************************************************************/
1007 ACPI_PARSE_OBJECT *Op,
1011 ACPI_WALK_STATE *WalkState = (ACPI_WALK_STATE *) Context;
1013 ACPI_NAMESPACE_NODE *Node;
1014 ACPI_OBJECT_TYPE ObjectType;
1015 BOOLEAN ForceNewScope = FALSE;
1016 ACPI_PARSE_OBJECT *Arg;
1018 ACPI_NAMESPACE_NODE *TargetNode;
1021 ACPI_FUNCTION_NAME (LdNamespace2Begin);
1022 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Op %p [%s]\n",
1023 Op, Op->Asl.ParseOpName));
1026 /* Ignore Ops with no namespace node */
1028 Node = Op->Asl.Node;
1034 /* Get the type to determine if we should push the scope */
1036 if ((Op->Asl.ParseOpcode == PARSEOP_DEFAULT_ARG) &&
1037 (Op->Asl.CompileFlags == OP_IS_RESOURCE_DESC))
1039 ObjectType = ACPI_TYPE_LOCAL_RESOURCE;
1043 ObjectType = AslMapNamedOpcodeToDataType (Op->Asl.AmlOpcode);
1046 /* Push scope for Resource Templates */
1048 if (Op->Asl.ParseOpcode == PARSEOP_NAME)
1050 if (Op->Asl.CompileFlags & OP_IS_RESOURCE_DESC)
1052 ForceNewScope = TRUE;
1056 /* Push the scope stack */
1058 if (ForceNewScope || AcpiNsOpensScope (ObjectType))
1060 Status = AcpiDsScopeStackPush (Node, ObjectType, WalkState);
1061 if (ACPI_FAILURE (Status))
1063 return_ACPI_STATUS (Status);
1067 if (Op->Asl.ParseOpcode == PARSEOP_ALIAS)
1070 * Complete the alias node by getting and saving the target node.
1071 * First child is the alias target
1073 Arg = Op->Asl.Child;
1075 /* Get the target pathname */
1077 Path = Arg->Asl.Namepath;
1080 Status = UtInternalizeName (Arg->Asl.ExternalName, &Path);
1081 if (ACPI_FAILURE (Status))
1087 /* Get the NS node associated with the target. It must exist. */
1089 Status = AcpiNsLookup (WalkState->ScopeInfo, Path, ACPI_TYPE_ANY,
1090 ACPI_IMODE_EXECUTE, ACPI_NS_SEARCH_PARENT | ACPI_NS_DONT_OPEN_SCOPE,
1091 WalkState, &TargetNode);
1092 if (ACPI_FAILURE (Status))
1094 if (Status == AE_NOT_FOUND)
1096 /* Standalone NameSeg vs. NamePath */
1098 if (strlen (Arg->Asl.ExternalName) == ACPI_NAME_SIZE)
1100 AslError (ASL_ERROR, ASL_MSG_NOT_FOUND, Op,
1101 Arg->Asl.ExternalName);
1105 AslError (ASL_ERROR, ASL_MSG_NAMEPATH_NOT_EXIST, Op,
1106 Arg->Asl.ExternalName);
1111 * NOTE: Removed 10/2018 to enhance compiler error reporting. No
1115 * The name was not found, go ahead and create it.
1116 * This prevents more errors later.
1118 Status = AcpiNsLookup (WalkState->ScopeInfo, Path,
1119 ACPI_TYPE_ANY, ACPI_IMODE_LOAD_PASS1,
1120 ACPI_NS_NO_UPSEARCH, WalkState, &Node);
1123 /* Removed: return (AE_OK)*/
1126 AslCoreSubsystemError (Op, Status,
1127 "Failure from namespace lookup", FALSE);
1131 /* Save the target node within the alias node */
1133 Node->Object = ACPI_CAST_PTR (ACPI_OPERAND_OBJECT, TargetNode);
1140 /*******************************************************************************
1142 * FUNCTION: LdCommonNamespaceEnd
1144 * PARAMETERS: ASL_WALK_CALLBACK
1148 * DESCRIPTION: Ascending callback used during the loading of the namespace,
1149 * We only need to worry about managing the scope stack here.
1151 ******************************************************************************/
1154 LdCommonNamespaceEnd (
1155 ACPI_PARSE_OBJECT *Op,
1159 ACPI_WALK_STATE *WalkState = (ACPI_WALK_STATE *) Context;
1160 ACPI_OBJECT_TYPE ObjectType;
1161 BOOLEAN ForceNewScope = FALSE;
1164 ACPI_FUNCTION_NAME (LdCommonNamespaceEnd);
1167 /* We are only interested in opcodes that have an associated name */
1169 if (!Op->Asl.Namepath)
1174 /* Get the type to determine if we should pop the scope */
1176 if ((Op->Asl.ParseOpcode == PARSEOP_DEFAULT_ARG) &&
1177 (Op->Asl.CompileFlags == OP_IS_RESOURCE_DESC))
1179 /* TBD: Merge into AcpiDsMapNamedOpcodeToDataType */
1181 ObjectType = ACPI_TYPE_LOCAL_RESOURCE;
1185 ObjectType = AslMapNamedOpcodeToDataType (Op->Asl.AmlOpcode);
1188 /* Pop scope that was pushed for Resource Templates */
1190 if (Op->Asl.ParseOpcode == PARSEOP_NAME)
1192 if (Op->Asl.CompileFlags & OP_IS_RESOURCE_DESC)
1194 ForceNewScope = TRUE;
1198 /* Pop the scope stack */
1200 if (ForceNewScope || AcpiNsOpensScope (ObjectType))
1202 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
1203 "(%s): Popping scope for Op [%s] %p\n",
1204 AcpiUtGetTypeName (ObjectType), Op->Asl.ParseOpName, Op));
1206 (void) AcpiDsScopeStackPop (WalkState);