Home | History | Annotate | Line # | Download | only in parser
psloop.c revision 1.1.1.10.2.2
      1           1.1    jruoho /******************************************************************************
      2           1.1    jruoho  *
      3           1.1    jruoho  * Module Name: psloop - Main AML parse loop
      4           1.1    jruoho  *
      5           1.1    jruoho  *****************************************************************************/
      6           1.1    jruoho 
      7       1.1.1.2    jruoho /*
      8  1.1.1.10.2.1  pgoyette  * Copyright (C) 2000 - 2018, Intel Corp.
      9           1.1    jruoho  * All rights reserved.
     10           1.1    jruoho  *
     11       1.1.1.2    jruoho  * Redistribution and use in source and binary forms, with or without
     12       1.1.1.2    jruoho  * modification, are permitted provided that the following conditions
     13       1.1.1.2    jruoho  * are met:
     14       1.1.1.2    jruoho  * 1. Redistributions of source code must retain the above copyright
     15       1.1.1.2    jruoho  *    notice, this list of conditions, and the following disclaimer,
     16       1.1.1.2    jruoho  *    without modification.
     17       1.1.1.2    jruoho  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18       1.1.1.2    jruoho  *    substantially similar to the "NO WARRANTY" disclaimer below
     19       1.1.1.2    jruoho  *    ("Disclaimer") and any redistribution must be conditioned upon
     20       1.1.1.2    jruoho  *    including a substantially similar Disclaimer requirement for further
     21       1.1.1.2    jruoho  *    binary redistribution.
     22       1.1.1.2    jruoho  * 3. Neither the names of the above-listed copyright holders nor the names
     23       1.1.1.2    jruoho  *    of any contributors may be used to endorse or promote products derived
     24       1.1.1.2    jruoho  *    from this software without specific prior written permission.
     25       1.1.1.2    jruoho  *
     26       1.1.1.2    jruoho  * Alternatively, this software may be distributed under the terms of the
     27       1.1.1.2    jruoho  * GNU General Public License ("GPL") version 2 as published by the Free
     28       1.1.1.2    jruoho  * Software Foundation.
     29       1.1.1.2    jruoho  *
     30       1.1.1.2    jruoho  * NO WARRANTY
     31       1.1.1.2    jruoho  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32       1.1.1.2    jruoho  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33       1.1.1.2    jruoho  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34       1.1.1.2    jruoho  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35       1.1.1.2    jruoho  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36       1.1.1.2    jruoho  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37       1.1.1.2    jruoho  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38       1.1.1.2    jruoho  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39       1.1.1.2    jruoho  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40       1.1.1.2    jruoho  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41       1.1.1.2    jruoho  * POSSIBILITY OF SUCH DAMAGES.
     42       1.1.1.2    jruoho  */
     43           1.1    jruoho 
     44           1.1    jruoho /*
     45           1.1    jruoho  * Parse the AML and build an operation tree as most interpreters, (such as
     46           1.1    jruoho  * Perl) do. Parsing is done by hand rather than with a YACC generated parser
     47           1.1    jruoho  * to tightly constrain stack and dynamic memory usage. Parsing is kept
     48           1.1    jruoho  * flexible and the code fairly compact by parsing based on a list of AML
     49           1.1    jruoho  * opcode templates in AmlOpInfo[].
     50           1.1    jruoho  */
     51           1.1    jruoho 
     52           1.1    jruoho #include "acpi.h"
     53           1.1    jruoho #include "accommon.h"
     54       1.1.1.6  christos #include "acinterp.h"
     55           1.1    jruoho #include "acparser.h"
     56           1.1    jruoho #include "acdispat.h"
     57           1.1    jruoho #include "amlcode.h"
     58       1.1.1.9  christos #include "acconvert.h"
     59  1.1.1.10.2.2  pgoyette #include "acnamesp.h"
     60           1.1    jruoho 
     61           1.1    jruoho #define _COMPONENT          ACPI_PARSER
     62           1.1    jruoho         ACPI_MODULE_NAME    ("psloop")
     63           1.1    jruoho 
     64           1.1    jruoho 
     65           1.1    jruoho /* Local prototypes */
     66           1.1    jruoho 
     67           1.1    jruoho static ACPI_STATUS
     68           1.1    jruoho AcpiPsGetArguments (
     69           1.1    jruoho     ACPI_WALK_STATE         *WalkState,
     70           1.1    jruoho     UINT8                   *AmlOpStart,
     71           1.1    jruoho     ACPI_PARSE_OBJECT       *Op);
     72           1.1    jruoho 
     73           1.1    jruoho static void
     74           1.1    jruoho AcpiPsLinkModuleCode (
     75           1.1    jruoho     ACPI_PARSE_OBJECT       *ParentOp,
     76           1.1    jruoho     UINT8                   *AmlStart,
     77           1.1    jruoho     UINT32                  AmlLength,
     78           1.1    jruoho     ACPI_OWNER_ID           OwnerId);
     79           1.1    jruoho 
     80           1.1    jruoho 
     81           1.1    jruoho /*******************************************************************************
     82           1.1    jruoho  *
     83           1.1    jruoho  * FUNCTION:    AcpiPsGetArguments
     84           1.1    jruoho  *
     85           1.1    jruoho  * PARAMETERS:  WalkState           - Current state
     86           1.1    jruoho  *              AmlOpStart          - Op start in AML
     87           1.1    jruoho  *              Op                  - Current Op
     88           1.1    jruoho  *
     89           1.1    jruoho  * RETURN:      Status
     90           1.1    jruoho  *
     91           1.1    jruoho  * DESCRIPTION: Get arguments for passed Op.
     92           1.1    jruoho  *
     93           1.1    jruoho  ******************************************************************************/
     94           1.1    jruoho 
     95           1.1    jruoho static ACPI_STATUS
     96           1.1    jruoho AcpiPsGetArguments (
     97           1.1    jruoho     ACPI_WALK_STATE         *WalkState,
     98           1.1    jruoho     UINT8                   *AmlOpStart,
     99           1.1    jruoho     ACPI_PARSE_OBJECT       *Op)
    100           1.1    jruoho {
    101           1.1    jruoho     ACPI_STATUS             Status = AE_OK;
    102           1.1    jruoho     ACPI_PARSE_OBJECT       *Arg = NULL;
    103           1.1    jruoho     const ACPI_OPCODE_INFO  *OpInfo;
    104           1.1    jruoho 
    105           1.1    jruoho 
    106           1.1    jruoho     ACPI_FUNCTION_TRACE_PTR (PsGetArguments, WalkState);
    107           1.1    jruoho 
    108           1.1    jruoho 
    109       1.1.1.8  christos     ACPI_DEBUG_PRINT ((ACPI_DB_PARSE,
    110       1.1.1.8  christos         "Get arguments for opcode [%s]\n", Op->Common.AmlOpName));
    111       1.1.1.8  christos 
    112           1.1    jruoho     switch (Op->Common.AmlOpcode)
    113           1.1    jruoho     {
    114           1.1    jruoho     case AML_BYTE_OP:       /* AML_BYTEDATA_ARG */
    115           1.1    jruoho     case AML_WORD_OP:       /* AML_WORDDATA_ARG */
    116           1.1    jruoho     case AML_DWORD_OP:      /* AML_DWORDATA_ARG */
    117           1.1    jruoho     case AML_QWORD_OP:      /* AML_QWORDATA_ARG */
    118           1.1    jruoho     case AML_STRING_OP:     /* AML_ASCIICHARLIST_ARG */
    119           1.1    jruoho 
    120           1.1    jruoho         /* Fill in constant or string argument directly */
    121           1.1    jruoho 
    122           1.1    jruoho         AcpiPsGetNextSimpleArg (&(WalkState->ParserState),
    123           1.1    jruoho             GET_CURRENT_ARG_TYPE (WalkState->ArgTypes), Op);
    124           1.1    jruoho         break;
    125           1.1    jruoho 
    126           1.1    jruoho     case AML_INT_NAMEPATH_OP:   /* AML_NAMESTRING_ARG */
    127           1.1    jruoho 
    128       1.1.1.7  christos         Status = AcpiPsGetNextNamepath (WalkState,
    129       1.1.1.7  christos             &(WalkState->ParserState), Op, ACPI_POSSIBLE_METHOD_CALL);
    130           1.1    jruoho         if (ACPI_FAILURE (Status))
    131           1.1    jruoho         {
    132           1.1    jruoho             return_ACPI_STATUS (Status);
    133           1.1    jruoho         }
    134           1.1    jruoho 
    135           1.1    jruoho         WalkState->ArgTypes = 0;
    136           1.1    jruoho         break;
    137           1.1    jruoho 
    138           1.1    jruoho     default:
    139           1.1    jruoho         /*
    140           1.1    jruoho          * Op is not a constant or string, append each argument to the Op
    141           1.1    jruoho          */
    142       1.1.1.7  christos         while (GET_CURRENT_ARG_TYPE (WalkState->ArgTypes) &&
    143       1.1.1.7  christos             !WalkState->ArgCount)
    144           1.1    jruoho         {
    145       1.1.1.6  christos             WalkState->Aml = WalkState->ParserState.Aml;
    146           1.1    jruoho 
    147       1.1.1.9  christos             switch (Op->Common.AmlOpcode)
    148       1.1.1.9  christos             {
    149       1.1.1.9  christos             case AML_METHOD_OP:
    150       1.1.1.9  christos             case AML_BUFFER_OP:
    151       1.1.1.9  christos             case AML_PACKAGE_OP:
    152       1.1.1.9  christos             case AML_VARIABLE_PACKAGE_OP:
    153       1.1.1.9  christos             case AML_WHILE_OP:
    154       1.1.1.9  christos 
    155       1.1.1.9  christos                 break;
    156       1.1.1.9  christos 
    157       1.1.1.9  christos             default:
    158       1.1.1.9  christos 
    159       1.1.1.9  christos                 ASL_CV_CAPTURE_COMMENTS (WalkState);
    160       1.1.1.9  christos                 break;
    161       1.1.1.9  christos             }
    162       1.1.1.9  christos 
    163           1.1    jruoho             Status = AcpiPsGetNextArg (WalkState, &(WalkState->ParserState),
    164       1.1.1.7  christos                 GET_CURRENT_ARG_TYPE (WalkState->ArgTypes), &Arg);
    165           1.1    jruoho             if (ACPI_FAILURE (Status))
    166           1.1    jruoho             {
    167           1.1    jruoho                 return_ACPI_STATUS (Status);
    168           1.1    jruoho             }
    169           1.1    jruoho 
    170           1.1    jruoho             if (Arg)
    171           1.1    jruoho             {
    172           1.1    jruoho                 AcpiPsAppendArg (Op, Arg);
    173           1.1    jruoho             }
    174           1.1    jruoho 
    175           1.1    jruoho             INCREMENT_ARG_LIST (WalkState->ArgTypes);
    176           1.1    jruoho         }
    177           1.1    jruoho 
    178      1.1.1.10  christos         ACPI_DEBUG_PRINT ((ACPI_DB_PARSE,
    179  1.1.1.10.2.1  pgoyette             "Final argument count: %8.8X pass %u\n",
    180      1.1.1.10  christos             WalkState->ArgCount, WalkState->PassNumber));
    181           1.1    jruoho 
    182           1.1    jruoho         /*
    183  1.1.1.10.2.1  pgoyette          * This case handles the legacy option that groups all module-level
    184  1.1.1.10.2.1  pgoyette          * code blocks together and defers execution until all of the tables
    185  1.1.1.10.2.1  pgoyette          * are loaded. Execute all of these blocks at this time.
    186  1.1.1.10.2.1  pgoyette          * Execute any module-level code that was detected during the table
    187  1.1.1.10.2.1  pgoyette          * load phase.
    188  1.1.1.10.2.1  pgoyette          *
    189  1.1.1.10.2.1  pgoyette          * Note: this option is deprecated and will be eliminated in the
    190  1.1.1.10.2.1  pgoyette          * future. Use of this option can cause problems with AML code that
    191  1.1.1.10.2.1  pgoyette          * depends upon in-order immediate execution of module-level code.
    192           1.1    jruoho          */
    193  1.1.1.10.2.1  pgoyette         if (AcpiGbl_GroupModuleLevelCode &&
    194  1.1.1.10.2.1  pgoyette             (WalkState->PassNumber <= ACPI_IMODE_LOAD_PASS2) &&
    195           1.1    jruoho             ((WalkState->ParseFlags & ACPI_PARSE_DISASSEMBLE) == 0))
    196           1.1    jruoho         {
    197           1.1    jruoho             /*
    198           1.1    jruoho              * We want to skip If/Else/While constructs during Pass1 because we
    199           1.1    jruoho              * want to actually conditionally execute the code during Pass2.
    200           1.1    jruoho              *
    201           1.1    jruoho              * Except for disassembly, where we always want to walk the
    202           1.1    jruoho              * If/Else/While packages
    203           1.1    jruoho              */
    204           1.1    jruoho             switch (Op->Common.AmlOpcode)
    205           1.1    jruoho             {
    206           1.1    jruoho             case AML_IF_OP:
    207           1.1    jruoho             case AML_ELSE_OP:
    208           1.1    jruoho             case AML_WHILE_OP:
    209           1.1    jruoho                 /*
    210           1.1    jruoho                  * Currently supported module-level opcodes are:
    211           1.1    jruoho                  * IF/ELSE/WHILE. These appear to be the most common,
    212           1.1    jruoho                  * and easiest to support since they open an AML
    213           1.1    jruoho                  * package.
    214           1.1    jruoho                  */
    215           1.1    jruoho                 if (WalkState->PassNumber == ACPI_IMODE_LOAD_PASS1)
    216           1.1    jruoho                 {
    217           1.1    jruoho                     AcpiPsLinkModuleCode (Op->Common.Parent, AmlOpStart,
    218           1.1    jruoho                         (UINT32) (WalkState->ParserState.PkgEnd - AmlOpStart),
    219           1.1    jruoho                         WalkState->OwnerId);
    220           1.1    jruoho                 }
    221           1.1    jruoho 
    222           1.1    jruoho                 ACPI_DEBUG_PRINT ((ACPI_DB_PARSE,
    223           1.1    jruoho                     "Pass1: Skipping an If/Else/While body\n"));
    224           1.1    jruoho 
    225           1.1    jruoho                 /* Skip body of if/else/while in pass 1 */
    226           1.1    jruoho 
    227           1.1    jruoho                 WalkState->ParserState.Aml = WalkState->ParserState.PkgEnd;
    228           1.1    jruoho                 WalkState->ArgCount = 0;
    229           1.1    jruoho                 break;
    230           1.1    jruoho 
    231           1.1    jruoho             default:
    232           1.1    jruoho                 /*
    233           1.1    jruoho                  * Check for an unsupported executable opcode at module
    234           1.1    jruoho                  * level. We must be in PASS1, the parent must be a SCOPE,
    235           1.1    jruoho                  * The opcode class must be EXECUTE, and the opcode must
    236           1.1    jruoho                  * not be an argument to another opcode.
    237           1.1    jruoho                  */
    238           1.1    jruoho                 if ((WalkState->PassNumber == ACPI_IMODE_LOAD_PASS1) &&
    239           1.1    jruoho                     (Op->Common.Parent->Common.AmlOpcode == AML_SCOPE_OP))
    240           1.1    jruoho                 {
    241           1.1    jruoho                     OpInfo = AcpiPsGetOpcodeInfo (Op->Common.AmlOpcode);
    242           1.1    jruoho                     if ((OpInfo->Class == AML_CLASS_EXECUTE) &&
    243           1.1    jruoho                         (!Arg))
    244           1.1    jruoho                     {
    245           1.1    jruoho                         ACPI_WARNING ((AE_INFO,
    246       1.1.1.3  christos                             "Unsupported module-level executable opcode "
    247       1.1.1.3  christos                             "0x%.2X at table offset 0x%.4X",
    248           1.1    jruoho                             Op->Common.AmlOpcode,
    249           1.1    jruoho                             (UINT32) (ACPI_PTR_DIFF (AmlOpStart,
    250           1.1    jruoho                                 WalkState->ParserState.AmlStart) +
    251           1.1    jruoho                                 sizeof (ACPI_TABLE_HEADER))));
    252           1.1    jruoho                     }
    253           1.1    jruoho                 }
    254           1.1    jruoho                 break;
    255           1.1    jruoho             }
    256           1.1    jruoho         }
    257           1.1    jruoho 
    258           1.1    jruoho         /* Special processing for certain opcodes */
    259           1.1    jruoho 
    260           1.1    jruoho         switch (Op->Common.AmlOpcode)
    261           1.1    jruoho         {
    262           1.1    jruoho         case AML_METHOD_OP:
    263           1.1    jruoho             /*
    264           1.1    jruoho              * Skip parsing of control method because we don't have enough
    265           1.1    jruoho              * info in the first pass to parse it correctly.
    266           1.1    jruoho              *
    267           1.1    jruoho              * Save the length and address of the body
    268           1.1    jruoho              */
    269           1.1    jruoho             Op->Named.Data = WalkState->ParserState.Aml;
    270           1.1    jruoho             Op->Named.Length = (UINT32)
    271           1.1    jruoho                 (WalkState->ParserState.PkgEnd - WalkState->ParserState.Aml);
    272           1.1    jruoho 
    273           1.1    jruoho             /* Skip body of method */
    274           1.1    jruoho 
    275           1.1    jruoho             WalkState->ParserState.Aml = WalkState->ParserState.PkgEnd;
    276           1.1    jruoho             WalkState->ArgCount = 0;
    277           1.1    jruoho             break;
    278           1.1    jruoho 
    279           1.1    jruoho         case AML_BUFFER_OP:
    280           1.1    jruoho         case AML_PACKAGE_OP:
    281       1.1.1.9  christos         case AML_VARIABLE_PACKAGE_OP:
    282           1.1    jruoho 
    283           1.1    jruoho             if ((Op->Common.Parent) &&
    284           1.1    jruoho                 (Op->Common.Parent->Common.AmlOpcode == AML_NAME_OP) &&
    285           1.1    jruoho                 (WalkState->PassNumber <= ACPI_IMODE_LOAD_PASS2))
    286           1.1    jruoho             {
    287      1.1.1.10  christos                 ACPI_DEBUG_PRINT ((ACPI_DB_PARSE,
    288      1.1.1.10  christos                     "Setup Package/Buffer: Pass %u, AML Ptr: %p\n",
    289      1.1.1.10  christos                     WalkState->PassNumber, AmlOpStart));
    290      1.1.1.10  christos 
    291           1.1    jruoho                 /*
    292           1.1    jruoho                  * Skip parsing of Buffers and Packages because we don't have
    293           1.1    jruoho                  * enough info in the first pass to parse them correctly.
    294           1.1    jruoho                  */
    295           1.1    jruoho                 Op->Named.Data = AmlOpStart;
    296           1.1    jruoho                 Op->Named.Length = (UINT32)
    297           1.1    jruoho                     (WalkState->ParserState.PkgEnd - AmlOpStart);
    298           1.1    jruoho 
    299           1.1    jruoho                 /* Skip body */
    300           1.1    jruoho 
    301           1.1    jruoho                 WalkState->ParserState.Aml = WalkState->ParserState.PkgEnd;
    302           1.1    jruoho                 WalkState->ArgCount = 0;
    303           1.1    jruoho             }
    304           1.1    jruoho             break;
    305           1.1    jruoho 
    306           1.1    jruoho         case AML_WHILE_OP:
    307           1.1    jruoho 
    308           1.1    jruoho             if (WalkState->ControlState)
    309           1.1    jruoho             {
    310           1.1    jruoho                 WalkState->ControlState->Control.PackageEnd =
    311           1.1    jruoho                     WalkState->ParserState.PkgEnd;
    312           1.1    jruoho             }
    313           1.1    jruoho             break;
    314           1.1    jruoho 
    315           1.1    jruoho         default:
    316           1.1    jruoho 
    317           1.1    jruoho             /* No action for all other opcodes */
    318       1.1.1.3  christos 
    319           1.1    jruoho             break;
    320           1.1    jruoho         }
    321           1.1    jruoho 
    322           1.1    jruoho         break;
    323           1.1    jruoho     }
    324           1.1    jruoho 
    325           1.1    jruoho     return_ACPI_STATUS (AE_OK);
    326           1.1    jruoho }
    327           1.1    jruoho 
    328           1.1    jruoho 
    329           1.1    jruoho /*******************************************************************************
    330           1.1    jruoho  *
    331           1.1    jruoho  * FUNCTION:    AcpiPsLinkModuleCode
    332           1.1    jruoho  *
    333           1.1    jruoho  * PARAMETERS:  ParentOp            - Parent parser op
    334           1.1    jruoho  *              AmlStart            - Pointer to the AML
    335           1.1    jruoho  *              AmlLength           - Length of executable AML
    336           1.1    jruoho  *              OwnerId             - OwnerId of module level code
    337           1.1    jruoho  *
    338           1.1    jruoho  * RETURN:      None.
    339           1.1    jruoho  *
    340           1.1    jruoho  * DESCRIPTION: Wrap the module-level code with a method object and link the
    341           1.1    jruoho  *              object to the global list. Note, the mutex field of the method
    342           1.1    jruoho  *              object is used to link multiple module-level code objects.
    343           1.1    jruoho  *
    344  1.1.1.10.2.1  pgoyette  * NOTE: In this legacy option, each block of detected executable AML
    345  1.1.1.10.2.1  pgoyette  * code that is outside of any control method is wrapped with a temporary
    346  1.1.1.10.2.1  pgoyette  * control method object and placed on a global list below.
    347  1.1.1.10.2.1  pgoyette  *
    348  1.1.1.10.2.1  pgoyette  * This function executes the module-level code for all tables only after
    349  1.1.1.10.2.1  pgoyette  * all of the tables have been loaded. It is a legacy option and is
    350  1.1.1.10.2.1  pgoyette  * not compatible with other ACPI implementations. See AcpiNsLoadTable.
    351  1.1.1.10.2.1  pgoyette  *
    352  1.1.1.10.2.1  pgoyette  * This function will be removed when the legacy option is removed.
    353  1.1.1.10.2.1  pgoyette  *
    354           1.1    jruoho  ******************************************************************************/
    355           1.1    jruoho 
    356           1.1    jruoho static void
    357           1.1    jruoho AcpiPsLinkModuleCode (
    358           1.1    jruoho     ACPI_PARSE_OBJECT       *ParentOp,
    359           1.1    jruoho     UINT8                   *AmlStart,
    360           1.1    jruoho     UINT32                  AmlLength,
    361           1.1    jruoho     ACPI_OWNER_ID           OwnerId)
    362           1.1    jruoho {
    363           1.1    jruoho     ACPI_OPERAND_OBJECT     *Prev;
    364           1.1    jruoho     ACPI_OPERAND_OBJECT     *Next;
    365           1.1    jruoho     ACPI_OPERAND_OBJECT     *MethodObj;
    366           1.1    jruoho     ACPI_NAMESPACE_NODE     *ParentNode;
    367           1.1    jruoho 
    368           1.1    jruoho 
    369       1.1.1.7  christos     ACPI_FUNCTION_TRACE (PsLinkModuleCode);
    370       1.1.1.7  christos 
    371       1.1.1.7  christos 
    372           1.1    jruoho     /* Get the tail of the list */
    373           1.1    jruoho 
    374           1.1    jruoho     Prev = Next = AcpiGbl_ModuleCodeList;
    375           1.1    jruoho     while (Next)
    376           1.1    jruoho     {
    377           1.1    jruoho         Prev = Next;
    378           1.1    jruoho         Next = Next->Method.Mutex;
    379           1.1    jruoho     }
    380           1.1    jruoho 
    381           1.1    jruoho     /*
    382           1.1    jruoho      * Insert the module level code into the list. Merge it if it is
    383           1.1    jruoho      * adjacent to the previous element.
    384           1.1    jruoho      */
    385           1.1    jruoho     if (!Prev ||
    386           1.1    jruoho        ((Prev->Method.AmlStart + Prev->Method.AmlLength) != AmlStart))
    387           1.1    jruoho     {
    388           1.1    jruoho         /* Create, initialize, and link a new temporary method object */
    389           1.1    jruoho 
    390           1.1    jruoho         MethodObj = AcpiUtCreateInternalObject (ACPI_TYPE_METHOD);
    391           1.1    jruoho         if (!MethodObj)
    392           1.1    jruoho         {
    393       1.1.1.7  christos             return_VOID;
    394           1.1    jruoho         }
    395           1.1    jruoho 
    396       1.1.1.7  christos         ACPI_DEBUG_PRINT ((ACPI_DB_PARSE,
    397       1.1.1.7  christos             "Create/Link new code block: %p\n", MethodObj));
    398       1.1.1.7  christos 
    399           1.1    jruoho         if (ParentOp->Common.Node)
    400           1.1    jruoho         {
    401           1.1    jruoho             ParentNode = ParentOp->Common.Node;
    402           1.1    jruoho         }
    403           1.1    jruoho         else
    404           1.1    jruoho         {
    405           1.1    jruoho             ParentNode = AcpiGbl_RootNode;
    406           1.1    jruoho         }
    407           1.1    jruoho 
    408           1.1    jruoho         MethodObj->Method.AmlStart = AmlStart;
    409           1.1    jruoho         MethodObj->Method.AmlLength = AmlLength;
    410           1.1    jruoho         MethodObj->Method.OwnerId = OwnerId;
    411       1.1.1.2    jruoho         MethodObj->Method.InfoFlags |= ACPI_METHOD_MODULE_LEVEL;
    412           1.1    jruoho 
    413           1.1    jruoho         /*
    414           1.1    jruoho          * Save the parent node in NextObject. This is cheating, but we
    415           1.1    jruoho          * don't want to expand the method object.
    416           1.1    jruoho          */
    417           1.1    jruoho         MethodObj->Method.NextObject =
    418           1.1    jruoho             ACPI_CAST_PTR (ACPI_OPERAND_OBJECT, ParentNode);
    419           1.1    jruoho 
    420           1.1    jruoho         if (!Prev)
    421           1.1    jruoho         {
    422           1.1    jruoho             AcpiGbl_ModuleCodeList = MethodObj;
    423           1.1    jruoho         }
    424           1.1    jruoho         else
    425           1.1    jruoho         {
    426           1.1    jruoho             Prev->Method.Mutex = MethodObj;
    427           1.1    jruoho         }
    428           1.1    jruoho     }
    429           1.1    jruoho     else
    430           1.1    jruoho     {
    431       1.1.1.7  christos         ACPI_DEBUG_PRINT ((ACPI_DB_PARSE,
    432       1.1.1.7  christos             "Appending to existing code block: %p\n", Prev));
    433       1.1.1.7  christos 
    434           1.1    jruoho         Prev->Method.AmlLength += AmlLength;
    435           1.1    jruoho     }
    436       1.1.1.7  christos 
    437       1.1.1.7  christos     return_VOID;
    438           1.1    jruoho }
    439           1.1    jruoho 
    440           1.1    jruoho /*******************************************************************************
    441           1.1    jruoho  *
    442           1.1    jruoho  * FUNCTION:    AcpiPsParseLoop
    443           1.1    jruoho  *
    444           1.1    jruoho  * PARAMETERS:  WalkState           - Current state
    445           1.1    jruoho  *
    446           1.1    jruoho  * RETURN:      Status
    447           1.1    jruoho  *
    448           1.1    jruoho  * DESCRIPTION: Parse AML (pointed to by the current parser state) and return
    449           1.1    jruoho  *              a tree of ops.
    450           1.1    jruoho  *
    451           1.1    jruoho  ******************************************************************************/
    452           1.1    jruoho 
    453           1.1    jruoho ACPI_STATUS
    454           1.1    jruoho AcpiPsParseLoop (
    455           1.1    jruoho     ACPI_WALK_STATE         *WalkState)
    456           1.1    jruoho {
    457           1.1    jruoho     ACPI_STATUS             Status = AE_OK;
    458           1.1    jruoho     ACPI_PARSE_OBJECT       *Op = NULL;     /* current op */
    459           1.1    jruoho     ACPI_PARSE_STATE        *ParserState;
    460           1.1    jruoho     UINT8                   *AmlOpStart = NULL;
    461           1.1    jruoho 
    462           1.1    jruoho 
    463           1.1    jruoho     ACPI_FUNCTION_TRACE_PTR (PsParseLoop, WalkState);
    464           1.1    jruoho 
    465           1.1    jruoho 
    466           1.1    jruoho     if (WalkState->DescendingCallback == NULL)
    467           1.1    jruoho     {
    468           1.1    jruoho         return_ACPI_STATUS (AE_BAD_PARAMETER);
    469           1.1    jruoho     }
    470           1.1    jruoho 
    471           1.1    jruoho     ParserState = &WalkState->ParserState;
    472           1.1    jruoho     WalkState->ArgTypes = 0;
    473           1.1    jruoho 
    474           1.1    jruoho #if (!defined (ACPI_NO_METHOD_EXECUTION) && !defined (ACPI_CONSTANT_EVAL_ONLY))
    475           1.1    jruoho 
    476           1.1    jruoho     if (WalkState->WalkType & ACPI_WALK_METHOD_RESTART)
    477           1.1    jruoho     {
    478           1.1    jruoho         /* We are restarting a preempted control method */
    479           1.1    jruoho 
    480           1.1    jruoho         if (AcpiPsHasCompletedScope (ParserState))
    481           1.1    jruoho         {
    482           1.1    jruoho             /*
    483           1.1    jruoho              * We must check if a predicate to an IF or WHILE statement
    484           1.1    jruoho              * was just completed
    485           1.1    jruoho              */
    486           1.1    jruoho             if ((ParserState->Scope->ParseScope.Op) &&
    487           1.1    jruoho                ((ParserState->Scope->ParseScope.Op->Common.AmlOpcode == AML_IF_OP) ||
    488           1.1    jruoho                 (ParserState->Scope->ParseScope.Op->Common.AmlOpcode == AML_WHILE_OP)) &&
    489           1.1    jruoho                 (WalkState->ControlState) &&
    490           1.1    jruoho                 (WalkState->ControlState->Common.State ==
    491           1.1    jruoho                     ACPI_CONTROL_PREDICATE_EXECUTING))
    492           1.1    jruoho             {
    493           1.1    jruoho                 /*
    494           1.1    jruoho                  * A predicate was just completed, get the value of the
    495           1.1    jruoho                  * predicate and branch based on that value
    496           1.1    jruoho                  */
    497           1.1    jruoho                 WalkState->Op = NULL;
    498           1.1    jruoho                 Status = AcpiDsGetPredicateValue (WalkState, ACPI_TO_POINTER (TRUE));
    499           1.1    jruoho                 if (ACPI_FAILURE (Status) &&
    500           1.1    jruoho                     ((Status & AE_CODE_MASK) != AE_CODE_CONTROL))
    501           1.1    jruoho                 {
    502           1.1    jruoho                     if (Status == AE_AML_NO_RETURN_VALUE)
    503           1.1    jruoho                     {
    504           1.1    jruoho                         ACPI_EXCEPTION ((AE_INFO, Status,
    505           1.1    jruoho                             "Invoked method did not return a value"));
    506           1.1    jruoho                     }
    507           1.1    jruoho 
    508           1.1    jruoho                     ACPI_EXCEPTION ((AE_INFO, Status, "GetPredicate Failed"));
    509           1.1    jruoho                     return_ACPI_STATUS (Status);
    510           1.1    jruoho                 }
    511           1.1    jruoho 
    512           1.1    jruoho                 Status = AcpiPsNextParseState (WalkState, Op, Status);
    513           1.1    jruoho             }
    514           1.1    jruoho 
    515           1.1    jruoho             AcpiPsPopScope (ParserState, &Op,
    516           1.1    jruoho                 &WalkState->ArgTypes, &WalkState->ArgCount);
    517           1.1    jruoho             ACPI_DEBUG_PRINT ((ACPI_DB_PARSE, "Popped scope, Op=%p\n", Op));
    518           1.1    jruoho         }
    519           1.1    jruoho         else if (WalkState->PrevOp)
    520           1.1    jruoho         {
    521           1.1    jruoho             /* We were in the middle of an op */
    522           1.1    jruoho 
    523           1.1    jruoho             Op = WalkState->PrevOp;
    524           1.1    jruoho             WalkState->ArgTypes = WalkState->PrevArgTypes;
    525           1.1    jruoho         }
    526           1.1    jruoho     }
    527           1.1    jruoho #endif
    528           1.1    jruoho 
    529           1.1    jruoho     /* Iterative parsing loop, while there is more AML to process: */
    530           1.1    jruoho 
    531           1.1    jruoho     while ((ParserState->Aml < ParserState->AmlEnd) || (Op))
    532           1.1    jruoho     {
    533       1.1.1.9  christos         ASL_CV_CAPTURE_COMMENTS (WalkState);
    534       1.1.1.9  christos 
    535           1.1    jruoho         AmlOpStart = ParserState->Aml;
    536           1.1    jruoho         if (!Op)
    537           1.1    jruoho         {
    538           1.1    jruoho             Status = AcpiPsCreateOp (WalkState, AmlOpStart, &Op);
    539           1.1    jruoho             if (ACPI_FAILURE (Status))
    540           1.1    jruoho             {
    541  1.1.1.10.2.2  pgoyette                 /*
    542  1.1.1.10.2.2  pgoyette                  * ACPI_PARSE_MODULE_LEVEL means that we are loading a table by
    543  1.1.1.10.2.2  pgoyette                  * executing it as a control method. However, if we encounter
    544  1.1.1.10.2.2  pgoyette                  * an error while loading the table, we need to keep trying to
    545  1.1.1.10.2.2  pgoyette                  * load the table rather than aborting the table load. Set the
    546  1.1.1.10.2.2  pgoyette                  * status to AE_OK to proceed with the table load.
    547  1.1.1.10.2.2  pgoyette                  */
    548  1.1.1.10.2.2  pgoyette                 if ((WalkState->ParseFlags & ACPI_PARSE_MODULE_LEVEL) &&
    549  1.1.1.10.2.2  pgoyette                     Status == AE_ALREADY_EXISTS)
    550  1.1.1.10.2.2  pgoyette                 {
    551  1.1.1.10.2.2  pgoyette                     Status = AE_OK;
    552  1.1.1.10.2.2  pgoyette                 }
    553           1.1    jruoho                 if (Status == AE_CTRL_PARSE_CONTINUE)
    554           1.1    jruoho                 {
    555           1.1    jruoho                     continue;
    556           1.1    jruoho                 }
    557           1.1    jruoho 
    558           1.1    jruoho                 if (Status == AE_CTRL_PARSE_PENDING)
    559           1.1    jruoho                 {
    560           1.1    jruoho                     Status = AE_OK;
    561           1.1    jruoho                 }
    562           1.1    jruoho 
    563       1.1.1.4  christos                 if (Status == AE_CTRL_TERMINATE)
    564       1.1.1.4  christos                 {
    565       1.1.1.4  christos                     return_ACPI_STATUS (Status);
    566       1.1.1.4  christos                 }
    567       1.1.1.4  christos 
    568           1.1    jruoho                 Status = AcpiPsCompleteOp (WalkState, &Op, Status);
    569           1.1    jruoho                 if (ACPI_FAILURE (Status))
    570           1.1    jruoho                 {
    571           1.1    jruoho                     return_ACPI_STATUS (Status);
    572           1.1    jruoho                 }
    573  1.1.1.10.2.2  pgoyette                 if (AcpiNsOpensScope (
    574  1.1.1.10.2.2  pgoyette                     AcpiPsGetOpcodeInfo (WalkState->Opcode)->ObjectType))
    575  1.1.1.10.2.2  pgoyette                 {
    576  1.1.1.10.2.2  pgoyette                     /*
    577  1.1.1.10.2.2  pgoyette                      * If the scope/device op fails to parse, skip the body of
    578  1.1.1.10.2.2  pgoyette                      * the scope op because the parse failure indicates that
    579  1.1.1.10.2.2  pgoyette                      * the device may not exist.
    580  1.1.1.10.2.2  pgoyette                      */
    581  1.1.1.10.2.2  pgoyette                     ACPI_ERROR ((AE_INFO, "Skip parsing opcode %s",
    582  1.1.1.10.2.2  pgoyette                         AcpiPsGetOpcodeName (WalkState->Opcode)));
    583  1.1.1.10.2.2  pgoyette                     WalkState->ParserState.Aml = WalkState->Aml + 1;
    584  1.1.1.10.2.2  pgoyette                     WalkState->ParserState.Aml =
    585  1.1.1.10.2.2  pgoyette                         AcpiPsGetNextPackageEnd(&WalkState->ParserState);
    586  1.1.1.10.2.2  pgoyette                     WalkState->Aml = WalkState->ParserState.Aml;
    587  1.1.1.10.2.2  pgoyette                 }
    588           1.1    jruoho 
    589           1.1    jruoho                 continue;
    590           1.1    jruoho             }
    591           1.1    jruoho 
    592       1.1.1.6  christos             AcpiExStartTraceOpcode (Op, WalkState);
    593           1.1    jruoho         }
    594           1.1    jruoho 
    595           1.1    jruoho         /*
    596           1.1    jruoho          * Start ArgCount at zero because we don't know if there are
    597           1.1    jruoho          * any args yet
    598           1.1    jruoho          */
    599       1.1.1.9  christos         WalkState->ArgCount = 0;
    600       1.1.1.9  christos 
    601       1.1.1.9  christos         switch (Op->Common.AmlOpcode)
    602       1.1.1.9  christos         {
    603       1.1.1.9  christos         case AML_BYTE_OP:
    604       1.1.1.9  christos         case AML_WORD_OP:
    605       1.1.1.9  christos         case AML_DWORD_OP:
    606       1.1.1.9  christos         case AML_QWORD_OP:
    607       1.1.1.9  christos 
    608       1.1.1.9  christos             break;
    609       1.1.1.9  christos 
    610       1.1.1.9  christos         default:
    611       1.1.1.9  christos 
    612       1.1.1.9  christos             ASL_CV_CAPTURE_COMMENTS (WalkState);
    613       1.1.1.9  christos             break;
    614       1.1.1.9  christos         }
    615           1.1    jruoho 
    616           1.1    jruoho         /* Are there any arguments that must be processed? */
    617           1.1    jruoho 
    618           1.1    jruoho         if (WalkState->ArgTypes)
    619           1.1    jruoho         {
    620           1.1    jruoho             /* Get arguments */
    621           1.1    jruoho 
    622           1.1    jruoho             Status = AcpiPsGetArguments (WalkState, AmlOpStart, Op);
    623           1.1    jruoho             if (ACPI_FAILURE (Status))
    624           1.1    jruoho             {
    625           1.1    jruoho                 Status = AcpiPsCompleteOp (WalkState, &Op, Status);
    626           1.1    jruoho                 if (ACPI_FAILURE (Status))
    627           1.1    jruoho                 {
    628           1.1    jruoho                     return_ACPI_STATUS (Status);
    629           1.1    jruoho                 }
    630  1.1.1.10.2.2  pgoyette                 if ((WalkState->ControlState) &&
    631  1.1.1.10.2.2  pgoyette                     ((WalkState->ControlState->Control.Opcode == AML_IF_OP) ||
    632  1.1.1.10.2.2  pgoyette                     (WalkState->ControlState->Control.Opcode == AML_WHILE_OP)))
    633  1.1.1.10.2.2  pgoyette                 {
    634  1.1.1.10.2.2  pgoyette                     /*
    635  1.1.1.10.2.2  pgoyette                      * If the if/while op fails to parse, we will skip parsing
    636  1.1.1.10.2.2  pgoyette                      * the body of the op.
    637  1.1.1.10.2.2  pgoyette                      */
    638  1.1.1.10.2.2  pgoyette                     ParserState->Aml =
    639  1.1.1.10.2.2  pgoyette                         WalkState->ControlState->Control.AmlPredicateStart + 1;
    640  1.1.1.10.2.2  pgoyette                     ParserState->Aml =
    641  1.1.1.10.2.2  pgoyette                         AcpiPsGetNextPackageEnd (ParserState);
    642  1.1.1.10.2.2  pgoyette                     WalkState->Aml = ParserState->Aml;
    643           1.1    jruoho 
    644  1.1.1.10.2.2  pgoyette                     ACPI_ERROR ((AE_INFO, "Skipping While/If block"));
    645  1.1.1.10.2.2  pgoyette                     if (*WalkState->Aml == AML_ELSE_OP)
    646  1.1.1.10.2.2  pgoyette                     {
    647  1.1.1.10.2.2  pgoyette                         ACPI_ERROR ((AE_INFO, "Skipping Else block"));
    648  1.1.1.10.2.2  pgoyette                         WalkState->ParserState.Aml = WalkState->Aml + 1;
    649  1.1.1.10.2.2  pgoyette                         WalkState->ParserState.Aml =
    650  1.1.1.10.2.2  pgoyette                             AcpiPsGetNextPackageEnd (ParserState);
    651  1.1.1.10.2.2  pgoyette                         WalkState->Aml = ParserState->Aml;
    652  1.1.1.10.2.2  pgoyette                     }
    653  1.1.1.10.2.2  pgoyette                     ACPI_FREE(AcpiUtPopGenericState (&WalkState->ControlState));
    654  1.1.1.10.2.2  pgoyette                 }
    655  1.1.1.10.2.2  pgoyette                 Op = NULL;
    656           1.1    jruoho                 continue;
    657           1.1    jruoho             }
    658           1.1    jruoho         }
    659           1.1    jruoho 
    660           1.1    jruoho         /* Check for arguments that need to be processed */
    661           1.1    jruoho 
    662      1.1.1.10  christos         ACPI_DEBUG_PRINT ((ACPI_DB_PARSE,
    663  1.1.1.10.2.1  pgoyette             "Parseloop: argument count: %8.8X\n", WalkState->ArgCount));
    664      1.1.1.10  christos 
    665           1.1    jruoho         if (WalkState->ArgCount)
    666           1.1    jruoho         {
    667           1.1    jruoho             /*
    668           1.1    jruoho              * There are arguments (complex ones), push Op and
    669           1.1    jruoho              * prepare for argument
    670           1.1    jruoho              */
    671           1.1    jruoho             Status = AcpiPsPushScope (ParserState, Op,
    672       1.1.1.7  christos                 WalkState->ArgTypes, WalkState->ArgCount);
    673           1.1    jruoho             if (ACPI_FAILURE (Status))
    674           1.1    jruoho             {
    675           1.1    jruoho                 Status = AcpiPsCompleteOp (WalkState, &Op, Status);
    676           1.1    jruoho                 if (ACPI_FAILURE (Status))
    677           1.1    jruoho                 {
    678           1.1    jruoho                     return_ACPI_STATUS (Status);
    679           1.1    jruoho                 }
    680           1.1    jruoho 
    681           1.1    jruoho                 continue;
    682           1.1    jruoho             }
    683           1.1    jruoho 
    684           1.1    jruoho             Op = NULL;
    685           1.1    jruoho             continue;
    686           1.1    jruoho         }
    687           1.1    jruoho 
    688           1.1    jruoho         /*
    689           1.1    jruoho          * All arguments have been processed -- Op is complete,
    690           1.1    jruoho          * prepare for next
    691           1.1    jruoho          */
    692           1.1    jruoho         WalkState->OpInfo = AcpiPsGetOpcodeInfo (Op->Common.AmlOpcode);
    693           1.1    jruoho         if (WalkState->OpInfo->Flags & AML_NAMED)
    694           1.1    jruoho         {
    695           1.1    jruoho             if (Op->Common.AmlOpcode == AML_REGION_OP ||
    696           1.1    jruoho                 Op->Common.AmlOpcode == AML_DATA_REGION_OP)
    697           1.1    jruoho             {
    698           1.1    jruoho                 /*
    699           1.1    jruoho                  * Skip parsing of control method or opregion body,
    700           1.1    jruoho                  * because we don't have enough info in the first pass
    701           1.1    jruoho                  * to parse them correctly.
    702           1.1    jruoho                  *
    703           1.1    jruoho                  * Completed parsing an OpRegion declaration, we now
    704           1.1    jruoho                  * know the length.
    705           1.1    jruoho                  */
    706           1.1    jruoho                 Op->Named.Length = (UINT32) (ParserState->Aml - Op->Named.Data);
    707           1.1    jruoho             }
    708           1.1    jruoho         }
    709           1.1    jruoho 
    710           1.1    jruoho         if (WalkState->OpInfo->Flags & AML_CREATE)
    711           1.1    jruoho         {
    712           1.1    jruoho             /*
    713           1.1    jruoho              * Backup to beginning of CreateXXXfield declaration (1 for
    714           1.1    jruoho              * Opcode)
    715           1.1    jruoho              *
    716           1.1    jruoho              * BodyLength is unknown until we parse the body
    717           1.1    jruoho              */
    718           1.1    jruoho             Op->Named.Length = (UINT32) (ParserState->Aml - Op->Named.Data);
    719           1.1    jruoho         }
    720           1.1    jruoho 
    721           1.1    jruoho         if (Op->Common.AmlOpcode == AML_BANK_FIELD_OP)
    722           1.1    jruoho         {
    723           1.1    jruoho             /*
    724           1.1    jruoho              * Backup to beginning of BankField declaration
    725           1.1    jruoho              *
    726           1.1    jruoho              * BodyLength is unknown until we parse the body
    727           1.1    jruoho              */
    728           1.1    jruoho             Op->Named.Length = (UINT32) (ParserState->Aml - Op->Named.Data);
    729           1.1    jruoho         }
    730           1.1    jruoho 
    731           1.1    jruoho         /* This op complete, notify the dispatcher */
    732           1.1    jruoho 
    733           1.1    jruoho         if (WalkState->AscendingCallback != NULL)
    734           1.1    jruoho         {
    735           1.1    jruoho             WalkState->Op = Op;
    736           1.1    jruoho             WalkState->Opcode = Op->Common.AmlOpcode;
    737           1.1    jruoho 
    738           1.1    jruoho             Status = WalkState->AscendingCallback (WalkState);
    739           1.1    jruoho             Status = AcpiPsNextParseState (WalkState, Op, Status);
    740           1.1    jruoho             if (Status == AE_CTRL_PENDING)
    741           1.1    jruoho             {
    742           1.1    jruoho                 Status = AE_OK;
    743           1.1    jruoho             }
    744  1.1.1.10.2.2  pgoyette             else if ((WalkState->ParseFlags & ACPI_PARSE_MODULE_LEVEL) &&
    745  1.1.1.10.2.2  pgoyette                 (ACPI_AML_EXCEPTION(Status) || Status == AE_ALREADY_EXISTS ||
    746  1.1.1.10.2.2  pgoyette                 Status == AE_NOT_FOUND))
    747  1.1.1.10.2.2  pgoyette             {
    748  1.1.1.10.2.2  pgoyette                 /*
    749  1.1.1.10.2.2  pgoyette                  * ACPI_PARSE_MODULE_LEVEL flag means that we are currently
    750  1.1.1.10.2.2  pgoyette                  * loading a table by executing it as a control method.
    751  1.1.1.10.2.2  pgoyette                  * However, if we encounter an error while loading the table,
    752  1.1.1.10.2.2  pgoyette                  * we need to keep trying to load the table rather than
    753  1.1.1.10.2.2  pgoyette                  * aborting the table load (setting the status to AE_OK
    754  1.1.1.10.2.2  pgoyette                  * continues the table load). If we get a failure at this
    755  1.1.1.10.2.2  pgoyette                  * point, it means that the dispatcher got an error while
    756  1.1.1.10.2.2  pgoyette                  * trying to execute the Op.
    757  1.1.1.10.2.2  pgoyette                  */
    758  1.1.1.10.2.2  pgoyette                 Status = AE_OK;
    759  1.1.1.10.2.2  pgoyette             }
    760           1.1    jruoho         }
    761           1.1    jruoho 
    762           1.1    jruoho         Status = AcpiPsCompleteOp (WalkState, &Op, Status);
    763           1.1    jruoho         if (ACPI_FAILURE (Status))
    764           1.1    jruoho         {
    765           1.1    jruoho             return_ACPI_STATUS (Status);
    766           1.1    jruoho         }
    767           1.1    jruoho 
    768           1.1    jruoho     } /* while ParserState->Aml */
    769           1.1    jruoho 
    770           1.1    jruoho     Status = AcpiPsCompleteFinalOp (WalkState, Op, Status);
    771           1.1    jruoho     return_ACPI_STATUS (Status);
    772           1.1    jruoho }
    773