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
AcpiDsInitCallbacks(ACPI_WALK_STATE * WalkState,UINT32 PassNumber)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
AcpiDsLoad1BeginOp(ACPI_WALK_STATE * WalkState,ACPI_PARSE_OBJECT ** OutOp)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
AcpiDsLoad1EndOp(ACPI_WALK_STATE * WalkState)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
AcpiDsLoad2BeginOp(ACPI_WALK_STATE * WalkState,ACPI_PARSE_OBJECT ** OutOp)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
AcpiDsLoad2EndOp(ACPI_WALK_STATE * WalkState)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