dsutils.c revision 151937
1/******************************************************************************* 2 * 3 * Module Name: dsutils - Dispatcher utilities 4 * $Revision: 1.115 $ 5 * 6 ******************************************************************************/ 7 8/****************************************************************************** 9 * 10 * 1. Copyright Notice 11 * 12 * Some or all of this work - Copyright (c) 1999 - 2005, Intel Corp. 13 * All rights reserved. 14 * 15 * 2. License 16 * 17 * 2.1. This is your license from Intel Corp. under its intellectual property 18 * rights. You may have additional license terms from the party that provided 19 * you this software, covering your right to use that party's intellectual 20 * property rights. 21 * 22 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a 23 * copy of the source code appearing in this file ("Covered Code") an 24 * irrevocable, perpetual, worldwide license under Intel's copyrights in the 25 * base code distributed originally by Intel ("Original Intel Code") to copy, 26 * make derivatives, distribute, use and display any portion of the Covered 27 * Code in any form, with the right to sublicense such rights; and 28 * 29 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent 30 * license (with the right to sublicense), under only those claims of Intel 31 * patents that are infringed by the Original Intel Code, to make, use, sell, 32 * offer to sell, and import the Covered Code and derivative works thereof 33 * solely to the minimum extent necessary to exercise the above copyright 34 * license, and in no event shall the patent license extend to any additions 35 * to or modifications of the Original Intel Code. No other license or right 36 * is granted directly or by implication, estoppel or otherwise; 37 * 38 * The above copyright and patent license is granted only if the following 39 * conditions are met: 40 * 41 * 3. Conditions 42 * 43 * 3.1. Redistribution of Source with Rights to Further Distribute Source. 44 * Redistribution of source code of any substantial portion of the Covered 45 * Code or modification with rights to further distribute source must include 46 * the above Copyright Notice, the above License, this list of Conditions, 47 * and the following Disclaimer and Export Compliance provision. In addition, 48 * Licensee must cause all Covered Code to which Licensee contributes to 49 * contain a file documenting the changes Licensee made to create that Covered 50 * Code and the date of any change. Licensee must include in that file the 51 * documentation of any changes made by any predecessor Licensee. Licensee 52 * must include a prominent statement that the modification is derived, 53 * directly or indirectly, from Original Intel Code. 54 * 55 * 3.2. Redistribution of Source with no Rights to Further Distribute Source. 56 * Redistribution of source code of any substantial portion of the Covered 57 * Code or modification without rights to further distribute source must 58 * include the following Disclaimer and Export Compliance provision in the 59 * documentation and/or other materials provided with distribution. In 60 * addition, Licensee may not authorize further sublicense of source of any 61 * portion of the Covered Code, and must include terms to the effect that the 62 * license from Licensee to its licensee is limited to the intellectual 63 * property embodied in the software Licensee provides to its licensee, and 64 * not to intellectual property embodied in modifications its licensee may 65 * make. 66 * 67 * 3.3. Redistribution of Executable. Redistribution in executable form of any 68 * substantial portion of the Covered Code or modification must reproduce the 69 * above Copyright Notice, and the following Disclaimer and Export Compliance 70 * provision in the documentation and/or other materials provided with the 71 * distribution. 72 * 73 * 3.4. Intel retains all right, title, and interest in and to the Original 74 * Intel Code. 75 * 76 * 3.5. Neither the name Intel nor any other trademark owned or controlled by 77 * Intel shall be used in advertising or otherwise to promote the sale, use or 78 * other dealings in products derived from or relating to the Covered Code 79 * without prior written authorization from Intel. 80 * 81 * 4. Disclaimer and Export Compliance 82 * 83 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED 84 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE 85 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE, 86 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY 87 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY 88 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A 89 * PARTICULAR PURPOSE. 90 * 91 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES 92 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR 93 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT, 94 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY 95 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL 96 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS 97 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY 98 * LIMITED REMEDY. 99 * 100 * 4.3. Licensee shall not export, either directly or indirectly, any of this 101 * software or system incorporating such software without first obtaining any 102 * required license or other approval from the U. S. Department of Commerce or 103 * any other agency or department of the United States Government. In the 104 * event Licensee exports any such software from the United States or 105 * re-exports any such software from a foreign destination, Licensee shall 106 * ensure that the distribution and export/re-export of the software is in 107 * compliance with all laws, regulations, orders, or other restrictions of the 108 * U.S. Export Administration Regulations. Licensee agrees that neither it nor 109 * any of its subsidiaries will export/re-export any technical data, process, 110 * software, or service, directly or indirectly, to any country for which the 111 * United States government or any agency thereof requires an export license, 112 * other governmental approval, or letter of assurance, without first obtaining 113 * such license, approval or letter. 114 * 115 *****************************************************************************/ 116 117#define __DSUTILS_C__ 118 119#include <contrib/dev/acpica/acpi.h> 120#include <contrib/dev/acpica/acparser.h> 121#include <contrib/dev/acpica/amlcode.h> 122#include <contrib/dev/acpica/acdispat.h> 123#include <contrib/dev/acpica/acinterp.h> 124#include <contrib/dev/acpica/acnamesp.h> 125#include <contrib/dev/acpica/acdebug.h> 126 127#define _COMPONENT ACPI_DISPATCHER 128 ACPI_MODULE_NAME ("dsutils") 129 130 131/******************************************************************************* 132 * 133 * FUNCTION: AcpiDsClearImplicitReturn 134 * 135 * PARAMETERS: WalkState - Current State 136 * 137 * RETURN: None. 138 * 139 * DESCRIPTION: Clear and remove a reference on an implicit return value. Used 140 * to delete "stale" return values (if enabled, the return value 141 * from every operator is saved at least momentarily, in case the 142 * parent method exits.) 143 * 144 ******************************************************************************/ 145 146void 147AcpiDsClearImplicitReturn ( 148 ACPI_WALK_STATE *WalkState) 149{ 150 ACPI_FUNCTION_NAME ("DsClearImplicitReturn"); 151 152 153 /* 154 * Slack must be enabled for this feature 155 */ 156 if (!AcpiGbl_EnableInterpreterSlack) 157 { 158 return; 159 } 160 161 if (WalkState->ImplicitReturnObj) 162 { 163 /* 164 * Delete any "stale" implicit return. However, in 165 * complex statements, the implicit return value can be 166 * bubbled up several levels. 167 */ 168 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, 169 "Removing reference on stale implicit return obj %p\n", 170 WalkState->ImplicitReturnObj)); 171 172 AcpiUtRemoveReference (WalkState->ImplicitReturnObj); 173 WalkState->ImplicitReturnObj = NULL; 174 } 175} 176 177 178#ifndef ACPI_NO_METHOD_EXECUTION 179/******************************************************************************* 180 * 181 * FUNCTION: AcpiDsDoImplicitReturn 182 * 183 * PARAMETERS: ReturnDesc - The return value 184 * WalkState - Current State 185 * AddReference - True if a reference should be added to the 186 * return object 187 * 188 * RETURN: TRUE if implicit return enabled, FALSE otherwise 189 * 190 * DESCRIPTION: Implements the optional "implicit return". We save the result 191 * of every ASL operator and control method invocation in case the 192 * parent method exit. Before storing a new return value, we 193 * delete the previous return value. 194 * 195 ******************************************************************************/ 196 197BOOLEAN 198AcpiDsDoImplicitReturn ( 199 ACPI_OPERAND_OBJECT *ReturnDesc, 200 ACPI_WALK_STATE *WalkState, 201 BOOLEAN AddReference) 202{ 203 ACPI_FUNCTION_NAME ("DsDoImplicitReturn"); 204 205 206 /* 207 * Slack must be enabled for this feature, and we must 208 * have a valid return object 209 */ 210 if ((!AcpiGbl_EnableInterpreterSlack) || 211 (!ReturnDesc)) 212 { 213 return (FALSE); 214 } 215 216 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, 217 "Result %p will be implicitly returned; Prev=%p\n", 218 ReturnDesc, 219 WalkState->ImplicitReturnObj)); 220 221 /* 222 * Delete any "stale" implicit return value first. However, in 223 * complex statements, the implicit return value can be 224 * bubbled up several levels, so we don't clear the value if it 225 * is the same as the ReturnDesc. 226 */ 227 if (WalkState->ImplicitReturnObj) 228 { 229 if (WalkState->ImplicitReturnObj == ReturnDesc) 230 { 231 return (TRUE); 232 } 233 AcpiDsClearImplicitReturn (WalkState); 234 } 235 236 /* Save the implicit return value, add a reference if requested */ 237 238 WalkState->ImplicitReturnObj = ReturnDesc; 239 if (AddReference) 240 { 241 AcpiUtAddReference (ReturnDesc); 242 } 243 244 return (TRUE); 245} 246 247 248/******************************************************************************* 249 * 250 * FUNCTION: AcpiDsIsResultUsed 251 * 252 * PARAMETERS: Op - Current Op 253 * WalkState - Current State 254 * 255 * RETURN: TRUE if result is used, FALSE otherwise 256 * 257 * DESCRIPTION: Check if a result object will be used by the parent 258 * 259 ******************************************************************************/ 260 261BOOLEAN 262AcpiDsIsResultUsed ( 263 ACPI_PARSE_OBJECT *Op, 264 ACPI_WALK_STATE *WalkState) 265{ 266 const ACPI_OPCODE_INFO *ParentInfo; 267 268 ACPI_FUNCTION_TRACE_PTR ("DsIsResultUsed", Op); 269 270 271 /* Must have both an Op and a Result Object */ 272 273 if (!Op) 274 { 275 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Null Op\n")); 276 return_UINT8 (TRUE); 277 } 278 279 /* 280 * We know that this operator is not a 281 * Return() operator (would not come here.) The following code is the 282 * optional support for a so-called "implicit return". Some AML code 283 * assumes that the last value of the method is "implicitly" returned 284 * to the caller. Just save the last result as the return value. 285 * NOTE: this is optional because the ASL language does not actually 286 * support this behavior. 287 */ 288 (void) AcpiDsDoImplicitReturn (WalkState->ResultObj, WalkState, TRUE); 289 290 /* 291 * Now determine if the parent will use the result 292 * 293 * If there is no parent, or the parent is a ScopeOp, we are executing 294 * at the method level. An executing method typically has no parent, 295 * since each method is parsed separately. A method invoked externally 296 * via ExecuteControlMethod has a ScopeOp as the parent. 297 */ 298 if ((!Op->Common.Parent) || 299 (Op->Common.Parent->Common.AmlOpcode == AML_SCOPE_OP)) 300 { 301 /* No parent, the return value cannot possibly be used */ 302 303 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, 304 "At Method level, result of [%s] not used\n", 305 AcpiPsGetOpcodeName (Op->Common.AmlOpcode))); 306 return_UINT8 (FALSE); 307 } 308 309 /* Get info on the parent. The RootOp is AML_SCOPE */ 310 311 ParentInfo = AcpiPsGetOpcodeInfo (Op->Common.Parent->Common.AmlOpcode); 312 if (ParentInfo->Class == AML_CLASS_UNKNOWN) 313 { 314 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, 315 "Unknown parent opcode. Op=%p\n", Op)); 316 return_UINT8 (FALSE); 317 } 318 319 /* 320 * Decide what to do with the result based on the parent. If 321 * the parent opcode will not use the result, delete the object. 322 * Otherwise leave it as is, it will be deleted when it is used 323 * as an operand later. 324 */ 325 switch (ParentInfo->Class) 326 { 327 case AML_CLASS_CONTROL: 328 329 switch (Op->Common.Parent->Common.AmlOpcode) 330 { 331 case AML_RETURN_OP: 332 333 /* Never delete the return value associated with a return opcode */ 334 335 goto ResultUsed; 336 337 case AML_IF_OP: 338 case AML_WHILE_OP: 339 340 /* 341 * If we are executing the predicate AND this is the predicate op, 342 * we will use the return value 343 */ 344 if ((WalkState->ControlState->Common.State == ACPI_CONTROL_PREDICATE_EXECUTING) && 345 (WalkState->ControlState->Control.PredicateOp == Op)) 346 { 347 goto ResultUsed; 348 } 349 break; 350 351 default: 352 /* Ignore other control opcodes */ 353 break; 354 } 355 356 /* The general control opcode returns no result */ 357 358 goto ResultNotUsed; 359 360 361 case AML_CLASS_CREATE: 362 363 /* 364 * These opcodes allow TermArg(s) as operands and therefore 365 * the operands can be method calls. The result is used. 366 */ 367 goto ResultUsed; 368 369 370 case AML_CLASS_NAMED_OBJECT: 371 372 if ((Op->Common.Parent->Common.AmlOpcode == AML_REGION_OP) || 373 (Op->Common.Parent->Common.AmlOpcode == AML_DATA_REGION_OP) || 374 (Op->Common.Parent->Common.AmlOpcode == AML_PACKAGE_OP) || 375 (Op->Common.Parent->Common.AmlOpcode == AML_VAR_PACKAGE_OP) || 376 (Op->Common.Parent->Common.AmlOpcode == AML_BUFFER_OP) || 377 (Op->Common.Parent->Common.AmlOpcode == AML_INT_EVAL_SUBTREE_OP)) 378 { 379 /* 380 * These opcodes allow TermArg(s) as operands and therefore 381 * the operands can be method calls. The result is used. 382 */ 383 goto ResultUsed; 384 } 385 386 goto ResultNotUsed; 387 388 389 default: 390 391 /* 392 * In all other cases. the parent will actually use the return 393 * object, so keep it. 394 */ 395 goto ResultUsed; 396 } 397 398 399ResultUsed: 400 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, 401 "Result of [%s] used by Parent [%s] Op=%p\n", 402 AcpiPsGetOpcodeName (Op->Common.AmlOpcode), 403 AcpiPsGetOpcodeName (Op->Common.Parent->Common.AmlOpcode), Op)); 404 405 return_UINT8 (TRUE); 406 407 408ResultNotUsed: 409 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, 410 "Result of [%s] not used by Parent [%s] Op=%p\n", 411 AcpiPsGetOpcodeName (Op->Common.AmlOpcode), 412 AcpiPsGetOpcodeName (Op->Common.Parent->Common.AmlOpcode), Op)); 413 414 return_UINT8 (FALSE); 415} 416 417 418/******************************************************************************* 419 * 420 * FUNCTION: AcpiDsDeleteResultIfNotUsed 421 * 422 * PARAMETERS: Op - Current parse Op 423 * ResultObj - Result of the operation 424 * WalkState - Current state 425 * 426 * RETURN: Status 427 * 428 * DESCRIPTION: Used after interpretation of an opcode. If there is an internal 429 * result descriptor, check if the parent opcode will actually use 430 * this result. If not, delete the result now so that it will 431 * not become orphaned. 432 * 433 ******************************************************************************/ 434 435void 436AcpiDsDeleteResultIfNotUsed ( 437 ACPI_PARSE_OBJECT *Op, 438 ACPI_OPERAND_OBJECT *ResultObj, 439 ACPI_WALK_STATE *WalkState) 440{ 441 ACPI_OPERAND_OBJECT *ObjDesc; 442 ACPI_STATUS Status; 443 444 445 ACPI_FUNCTION_TRACE_PTR ("DsDeleteResultIfNotUsed", ResultObj); 446 447 448 if (!Op) 449 { 450 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Null Op\n")); 451 return_VOID; 452 } 453 454 if (!ResultObj) 455 { 456 return_VOID; 457 } 458 459 if (!AcpiDsIsResultUsed (Op, WalkState)) 460 { 461 /* Must pop the result stack (ObjDesc should be equal to ResultObj) */ 462 463 Status = AcpiDsResultPop (&ObjDesc, WalkState); 464 if (ACPI_SUCCESS (Status)) 465 { 466 AcpiUtRemoveReference (ResultObj); 467 } 468 } 469 470 return_VOID; 471} 472 473 474/******************************************************************************* 475 * 476 * FUNCTION: AcpiDsResolveOperands 477 * 478 * PARAMETERS: WalkState - Current walk state with operands on stack 479 * 480 * RETURN: Status 481 * 482 * DESCRIPTION: Resolve all operands to their values. Used to prepare 483 * arguments to a control method invocation (a call from one 484 * method to another.) 485 * 486 ******************************************************************************/ 487 488ACPI_STATUS 489AcpiDsResolveOperands ( 490 ACPI_WALK_STATE *WalkState) 491{ 492 UINT32 i; 493 ACPI_STATUS Status = AE_OK; 494 495 496 ACPI_FUNCTION_TRACE_PTR ("DsResolveOperands", WalkState); 497 498 499 /* 500 * Attempt to resolve each of the valid operands 501 * Method arguments are passed by reference, not by value. This means 502 * that the actual objects are passed, not copies of the objects. 503 */ 504 for (i = 0; i < WalkState->NumOperands; i++) 505 { 506 Status = AcpiExResolveToValue (&WalkState->Operands[i], WalkState); 507 if (ACPI_FAILURE (Status)) 508 { 509 break; 510 } 511 } 512 513 return_ACPI_STATUS (Status); 514} 515 516 517/******************************************************************************* 518 * 519 * FUNCTION: AcpiDsClearOperands 520 * 521 * PARAMETERS: WalkState - Current walk state with operands on stack 522 * 523 * RETURN: None 524 * 525 * DESCRIPTION: Clear all operands on the current walk state operand stack. 526 * 527 ******************************************************************************/ 528 529void 530AcpiDsClearOperands ( 531 ACPI_WALK_STATE *WalkState) 532{ 533 UINT32 i; 534 535 536 ACPI_FUNCTION_TRACE_PTR ("DsClearOperands", WalkState); 537 538 539 /* Remove a reference on each operand on the stack */ 540 541 for (i = 0; i < WalkState->NumOperands; i++) 542 { 543 /* 544 * Remove a reference to all operands, including both 545 * "Arguments" and "Targets". 546 */ 547 AcpiUtRemoveReference (WalkState->Operands[i]); 548 WalkState->Operands[i] = NULL; 549 } 550 551 WalkState->NumOperands = 0; 552 return_VOID; 553} 554#endif 555 556 557/******************************************************************************* 558 * 559 * FUNCTION: AcpiDsCreateOperand 560 * 561 * PARAMETERS: WalkState - Current walk state 562 * Arg - Parse object for the argument 563 * ArgIndex - Which argument (zero based) 564 * 565 * RETURN: Status 566 * 567 * DESCRIPTION: Translate a parse tree object that is an argument to an AML 568 * opcode to the equivalent interpreter object. This may include 569 * looking up a name or entering a new name into the internal 570 * namespace. 571 * 572 ******************************************************************************/ 573 574ACPI_STATUS 575AcpiDsCreateOperand ( 576 ACPI_WALK_STATE *WalkState, 577 ACPI_PARSE_OBJECT *Arg, 578 UINT32 ArgIndex) 579{ 580 ACPI_STATUS Status = AE_OK; 581 char *NameString; 582 UINT32 NameLength; 583 ACPI_OPERAND_OBJECT *ObjDesc; 584 ACPI_PARSE_OBJECT *ParentOp; 585 UINT16 Opcode; 586 ACPI_INTERPRETER_MODE InterpreterMode; 587 const ACPI_OPCODE_INFO *OpInfo; 588 589 590 ACPI_FUNCTION_TRACE_PTR ("DsCreateOperand", Arg); 591 592 593 /* A valid name must be looked up in the namespace */ 594 595 if ((Arg->Common.AmlOpcode == AML_INT_NAMEPATH_OP) && 596 (Arg->Common.Value.String)) 597 { 598 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Getting a name: Arg=%p\n", Arg)); 599 600 /* Get the entire name string from the AML stream */ 601 602 Status = AcpiExGetNameString (ACPI_TYPE_ANY, Arg->Common.Value.Buffer, 603 &NameString, &NameLength); 604 605 if (ACPI_FAILURE (Status)) 606 { 607 return_ACPI_STATUS (Status); 608 } 609 610 /* All prefixes have been handled, and the name is in NameString */ 611 612 /* 613 * Special handling for BufferField declarations. This is a deferred 614 * opcode that unfortunately defines the field name as the last 615 * parameter instead of the first. We get here when we are performing 616 * the deferred execution, so the actual name of the field is already 617 * in the namespace. We don't want to attempt to look it up again 618 * because we may be executing in a different scope than where the 619 * actual opcode exists. 620 */ 621 if ((WalkState->DeferredNode) && 622 (WalkState->DeferredNode->Type == ACPI_TYPE_BUFFER_FIELD) && 623 (ArgIndex != 0)) 624 { 625 ObjDesc = ACPI_CAST_PTR ( 626 ACPI_OPERAND_OBJECT, WalkState->DeferredNode); 627 Status = AE_OK; 628 } 629 else /* All other opcodes */ 630 { 631 /* 632 * Differentiate between a namespace "create" operation 633 * versus a "lookup" operation (IMODE_LOAD_PASS2 vs. 634 * IMODE_EXECUTE) in order to support the creation of 635 * namespace objects during the execution of control methods. 636 */ 637 ParentOp = Arg->Common.Parent; 638 OpInfo = AcpiPsGetOpcodeInfo (ParentOp->Common.AmlOpcode); 639 if ((OpInfo->Flags & AML_NSNODE) && 640 (ParentOp->Common.AmlOpcode != AML_INT_METHODCALL_OP) && 641 (ParentOp->Common.AmlOpcode != AML_REGION_OP) && 642 (ParentOp->Common.AmlOpcode != AML_INT_NAMEPATH_OP)) 643 { 644 /* Enter name into namespace if not found */ 645 646 InterpreterMode = ACPI_IMODE_LOAD_PASS2; 647 } 648 else 649 { 650 /* Return a failure if name not found */ 651 652 InterpreterMode = ACPI_IMODE_EXECUTE; 653 } 654 655 Status = AcpiNsLookup (WalkState->ScopeInfo, NameString, 656 ACPI_TYPE_ANY, InterpreterMode, 657 ACPI_NS_SEARCH_PARENT | ACPI_NS_DONT_OPEN_SCOPE, 658 WalkState, 659 ACPI_CAST_INDIRECT_PTR (ACPI_NAMESPACE_NODE, &ObjDesc)); 660 /* 661 * The only case where we pass through (ignore) a NOT_FOUND 662 * error is for the CondRefOf opcode. 663 */ 664 if (Status == AE_NOT_FOUND) 665 { 666 if (ParentOp->Common.AmlOpcode == AML_COND_REF_OF_OP) 667 { 668 /* 669 * For the Conditional Reference op, it's OK if 670 * the name is not found; We just need a way to 671 * indicate this to the interpreter, set the 672 * object to the root 673 */ 674 ObjDesc = ACPI_CAST_PTR ( 675 ACPI_OPERAND_OBJECT, AcpiGbl_RootNode); 676 Status = AE_OK; 677 } 678 else 679 { 680 /* 681 * We just plain didn't find it -- which is a 682 * very serious error at this point 683 */ 684 Status = AE_AML_NAME_NOT_FOUND; 685 } 686 } 687 688 if (ACPI_FAILURE (Status)) 689 { 690 ACPI_REPORT_NSERROR (NameString, Status); 691 } 692 } 693 694 /* Free the namestring created above */ 695 696 ACPI_MEM_FREE (NameString); 697 698 /* Check status from the lookup */ 699 700 if (ACPI_FAILURE (Status)) 701 { 702 return_ACPI_STATUS (Status); 703 } 704 705 /* Put the resulting object onto the current object stack */ 706 707 Status = AcpiDsObjStackPush (ObjDesc, WalkState); 708 if (ACPI_FAILURE (Status)) 709 { 710 return_ACPI_STATUS (Status); 711 } 712 ACPI_DEBUGGER_EXEC (AcpiDbDisplayArgumentObject (ObjDesc, WalkState)); 713 } 714 else 715 { 716 /* Check for null name case */ 717 718 if (Arg->Common.AmlOpcode == AML_INT_NAMEPATH_OP) 719 { 720 /* 721 * If the name is null, this means that this is an 722 * optional result parameter that was not specified 723 * in the original ASL. Create a Zero Constant for a 724 * placeholder. (Store to a constant is a Noop.) 725 */ 726 Opcode = AML_ZERO_OP; /* Has no arguments! */ 727 728 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, 729 "Null namepath: Arg=%p\n", Arg)); 730 } 731 else 732 { 733 Opcode = Arg->Common.AmlOpcode; 734 } 735 736 /* Get the object type of the argument */ 737 738 OpInfo = AcpiPsGetOpcodeInfo (Opcode); 739 if (OpInfo->ObjectType == ACPI_TYPE_INVALID) 740 { 741 return_ACPI_STATUS (AE_NOT_IMPLEMENTED); 742 } 743 744 if (OpInfo->Flags & AML_HAS_RETVAL) 745 { 746 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, 747 "Argument previously created, already stacked\n")); 748 749 ACPI_DEBUGGER_EXEC (AcpiDbDisplayArgumentObject ( 750 WalkState->Operands [WalkState->NumOperands - 1], WalkState)); 751 752 /* 753 * Use value that was already previously returned 754 * by the evaluation of this argument 755 */ 756 Status = AcpiDsResultPopFromBottom (&ObjDesc, WalkState); 757 if (ACPI_FAILURE (Status)) 758 { 759 /* 760 * Only error is underflow, and this indicates 761 * a missing or null operand! 762 */ 763 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, 764 "Missing or null operand, %s\n", 765 AcpiFormatException (Status))); 766 return_ACPI_STATUS (Status); 767 } 768 } 769 else 770 { 771 /* Create an ACPI_INTERNAL_OBJECT for the argument */ 772 773 ObjDesc = AcpiUtCreateInternalObject (OpInfo->ObjectType); 774 if (!ObjDesc) 775 { 776 return_ACPI_STATUS (AE_NO_MEMORY); 777 } 778 779 /* Initialize the new object */ 780 781 Status = AcpiDsInitObjectFromOp ( 782 WalkState, Arg, Opcode, &ObjDesc); 783 if (ACPI_FAILURE (Status)) 784 { 785 AcpiUtDeleteObjectDesc (ObjDesc); 786 return_ACPI_STATUS (Status); 787 } 788 } 789 790 /* Put the operand object on the object stack */ 791 792 Status = AcpiDsObjStackPush (ObjDesc, WalkState); 793 if (ACPI_FAILURE (Status)) 794 { 795 return_ACPI_STATUS (Status); 796 } 797 798 ACPI_DEBUGGER_EXEC (AcpiDbDisplayArgumentObject (ObjDesc, WalkState)); 799 } 800 801 return_ACPI_STATUS (AE_OK); 802} 803 804 805/******************************************************************************* 806 * 807 * FUNCTION: AcpiDsCreateOperands 808 * 809 * PARAMETERS: WalkState - Current state 810 * FirstArg - First argument of a parser argument tree 811 * 812 * RETURN: Status 813 * 814 * DESCRIPTION: Convert an operator's arguments from a parse tree format to 815 * namespace objects and place those argument object on the object 816 * stack in preparation for evaluation by the interpreter. 817 * 818 ******************************************************************************/ 819 820ACPI_STATUS 821AcpiDsCreateOperands ( 822 ACPI_WALK_STATE *WalkState, 823 ACPI_PARSE_OBJECT *FirstArg) 824{ 825 ACPI_STATUS Status = AE_OK; 826 ACPI_PARSE_OBJECT *Arg; 827 UINT32 ArgCount = 0; 828 829 830 ACPI_FUNCTION_TRACE_PTR ("DsCreateOperands", FirstArg); 831 832 833 /* For all arguments in the list... */ 834 835 Arg = FirstArg; 836 while (Arg) 837 { 838 Status = AcpiDsCreateOperand (WalkState, Arg, ArgCount); 839 if (ACPI_FAILURE (Status)) 840 { 841 goto Cleanup; 842 } 843 844 ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH, "Arg #%d (%p) done, Arg1=%p\n", 845 ArgCount, Arg, FirstArg)); 846 847 /* Move on to next argument, if any */ 848 849 Arg = Arg->Common.Next; 850 ArgCount++; 851 } 852 853 return_ACPI_STATUS (Status); 854 855 856Cleanup: 857 /* 858 * We must undo everything done above; meaning that we must 859 * pop everything off of the operand stack and delete those 860 * objects 861 */ 862 (void) AcpiDsObjStackPopAndDelete (ArgCount, WalkState); 863 864 ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "While creating Arg %d - %s\n", 865 (ArgCount + 1), AcpiFormatException (Status))); 866 return_ACPI_STATUS (Status); 867} 868 869 870