Home | History | Annotate | Line # | Download | only in dispatcher
dswscope.c revision 1.1.1.2.8.2
      1  1.1.1.2.8.2  jruoho /******************************************************************************
      2  1.1.1.2.8.2  jruoho  *
      3  1.1.1.2.8.2  jruoho  * Module Name: dswscope - Scope stack manipulation
      4  1.1.1.2.8.2  jruoho  *
      5  1.1.1.2.8.2  jruoho  *****************************************************************************/
      6  1.1.1.2.8.2  jruoho 
      7  1.1.1.2.8.2  jruoho /*
      8  1.1.1.2.8.2  jruoho  * Copyright (C) 2000 - 2011, Intel Corp.
      9  1.1.1.2.8.2  jruoho  * All rights reserved.
     10  1.1.1.2.8.2  jruoho  *
     11  1.1.1.2.8.2  jruoho  * Redistribution and use in source and binary forms, with or without
     12  1.1.1.2.8.2  jruoho  * modification, are permitted provided that the following conditions
     13  1.1.1.2.8.2  jruoho  * are met:
     14  1.1.1.2.8.2  jruoho  * 1. Redistributions of source code must retain the above copyright
     15  1.1.1.2.8.2  jruoho  *    notice, this list of conditions, and the following disclaimer,
     16  1.1.1.2.8.2  jruoho  *    without modification.
     17  1.1.1.2.8.2  jruoho  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  1.1.1.2.8.2  jruoho  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  1.1.1.2.8.2  jruoho  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  1.1.1.2.8.2  jruoho  *    including a substantially similar Disclaimer requirement for further
     21  1.1.1.2.8.2  jruoho  *    binary redistribution.
     22  1.1.1.2.8.2  jruoho  * 3. Neither the names of the above-listed copyright holders nor the names
     23  1.1.1.2.8.2  jruoho  *    of any contributors may be used to endorse or promote products derived
     24  1.1.1.2.8.2  jruoho  *    from this software without specific prior written permission.
     25  1.1.1.2.8.2  jruoho  *
     26  1.1.1.2.8.2  jruoho  * Alternatively, this software may be distributed under the terms of the
     27  1.1.1.2.8.2  jruoho  * GNU General Public License ("GPL") version 2 as published by the Free
     28  1.1.1.2.8.2  jruoho  * Software Foundation.
     29  1.1.1.2.8.2  jruoho  *
     30  1.1.1.2.8.2  jruoho  * NO WARRANTY
     31  1.1.1.2.8.2  jruoho  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  1.1.1.2.8.2  jruoho  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  1.1.1.2.8.2  jruoho  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34  1.1.1.2.8.2  jruoho  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  1.1.1.2.8.2  jruoho  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  1.1.1.2.8.2  jruoho  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  1.1.1.2.8.2  jruoho  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  1.1.1.2.8.2  jruoho  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  1.1.1.2.8.2  jruoho  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  1.1.1.2.8.2  jruoho  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  1.1.1.2.8.2  jruoho  * POSSIBILITY OF SUCH DAMAGES.
     42  1.1.1.2.8.2  jruoho  */
     43  1.1.1.2.8.2  jruoho 
     44  1.1.1.2.8.2  jruoho #define __DSWSCOPE_C__
     45  1.1.1.2.8.2  jruoho 
     46  1.1.1.2.8.2  jruoho #include "acpi.h"
     47  1.1.1.2.8.2  jruoho #include "accommon.h"
     48  1.1.1.2.8.2  jruoho #include "acdispat.h"
     49  1.1.1.2.8.2  jruoho 
     50  1.1.1.2.8.2  jruoho 
     51  1.1.1.2.8.2  jruoho #define _COMPONENT          ACPI_DISPATCHER
     52  1.1.1.2.8.2  jruoho         ACPI_MODULE_NAME    ("dswscope")
     53  1.1.1.2.8.2  jruoho 
     54  1.1.1.2.8.2  jruoho 
     55  1.1.1.2.8.2  jruoho /****************************************************************************
     56  1.1.1.2.8.2  jruoho  *
     57  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiDsScopeStackClear
     58  1.1.1.2.8.2  jruoho  *
     59  1.1.1.2.8.2  jruoho  * PARAMETERS:  WalkState       - Current state
     60  1.1.1.2.8.2  jruoho  *
     61  1.1.1.2.8.2  jruoho  * RETURN:      None
     62  1.1.1.2.8.2  jruoho  *
     63  1.1.1.2.8.2  jruoho  * DESCRIPTION: Pop (and free) everything on the scope stack except the
     64  1.1.1.2.8.2  jruoho  *              root scope object (which remains at the stack top.)
     65  1.1.1.2.8.2  jruoho  *
     66  1.1.1.2.8.2  jruoho  ***************************************************************************/
     67  1.1.1.2.8.2  jruoho 
     68  1.1.1.2.8.2  jruoho void
     69  1.1.1.2.8.2  jruoho AcpiDsScopeStackClear (
     70  1.1.1.2.8.2  jruoho     ACPI_WALK_STATE         *WalkState)
     71  1.1.1.2.8.2  jruoho {
     72  1.1.1.2.8.2  jruoho     ACPI_GENERIC_STATE      *ScopeInfo;
     73  1.1.1.2.8.2  jruoho 
     74  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_NAME (DsScopeStackClear);
     75  1.1.1.2.8.2  jruoho 
     76  1.1.1.2.8.2  jruoho 
     77  1.1.1.2.8.2  jruoho     while (WalkState->ScopeInfo)
     78  1.1.1.2.8.2  jruoho     {
     79  1.1.1.2.8.2  jruoho         /* Pop a scope off the stack */
     80  1.1.1.2.8.2  jruoho 
     81  1.1.1.2.8.2  jruoho         ScopeInfo = WalkState->ScopeInfo;
     82  1.1.1.2.8.2  jruoho         WalkState->ScopeInfo = ScopeInfo->Scope.Next;
     83  1.1.1.2.8.2  jruoho 
     84  1.1.1.2.8.2  jruoho         ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
     85  1.1.1.2.8.2  jruoho             "Popped object type (%s)\n",
     86  1.1.1.2.8.2  jruoho             AcpiUtGetTypeName (ScopeInfo->Common.Value)));
     87  1.1.1.2.8.2  jruoho         AcpiUtDeleteGenericState (ScopeInfo);
     88  1.1.1.2.8.2  jruoho     }
     89  1.1.1.2.8.2  jruoho }
     90  1.1.1.2.8.2  jruoho 
     91  1.1.1.2.8.2  jruoho 
     92  1.1.1.2.8.2  jruoho /****************************************************************************
     93  1.1.1.2.8.2  jruoho  *
     94  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiDsScopeStackPush
     95  1.1.1.2.8.2  jruoho  *
     96  1.1.1.2.8.2  jruoho  * PARAMETERS:  Node            - Name to be made current
     97  1.1.1.2.8.2  jruoho  *              Type            - Type of frame being pushed
     98  1.1.1.2.8.2  jruoho  *              WalkState       - Current state
     99  1.1.1.2.8.2  jruoho  *
    100  1.1.1.2.8.2  jruoho  * RETURN:      Status
    101  1.1.1.2.8.2  jruoho  *
    102  1.1.1.2.8.2  jruoho  * DESCRIPTION: Push the current scope on the scope stack, and make the
    103  1.1.1.2.8.2  jruoho  *              passed Node current.
    104  1.1.1.2.8.2  jruoho  *
    105  1.1.1.2.8.2  jruoho  ***************************************************************************/
    106  1.1.1.2.8.2  jruoho 
    107  1.1.1.2.8.2  jruoho ACPI_STATUS
    108  1.1.1.2.8.2  jruoho AcpiDsScopeStackPush (
    109  1.1.1.2.8.2  jruoho     ACPI_NAMESPACE_NODE     *Node,
    110  1.1.1.2.8.2  jruoho     ACPI_OBJECT_TYPE        Type,
    111  1.1.1.2.8.2  jruoho     ACPI_WALK_STATE         *WalkState)
    112  1.1.1.2.8.2  jruoho {
    113  1.1.1.2.8.2  jruoho     ACPI_GENERIC_STATE      *ScopeInfo;
    114  1.1.1.2.8.2  jruoho     ACPI_GENERIC_STATE      *OldScopeInfo;
    115  1.1.1.2.8.2  jruoho 
    116  1.1.1.2.8.2  jruoho 
    117  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_TRACE (DsScopeStackPush);
    118  1.1.1.2.8.2  jruoho 
    119  1.1.1.2.8.2  jruoho 
    120  1.1.1.2.8.2  jruoho     if (!Node)
    121  1.1.1.2.8.2  jruoho     {
    122  1.1.1.2.8.2  jruoho         /* Invalid scope   */
    123  1.1.1.2.8.2  jruoho 
    124  1.1.1.2.8.2  jruoho         ACPI_ERROR ((AE_INFO, "Null scope parameter"));
    125  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (AE_BAD_PARAMETER);
    126  1.1.1.2.8.2  jruoho     }
    127  1.1.1.2.8.2  jruoho 
    128  1.1.1.2.8.2  jruoho     /* Make sure object type is valid */
    129  1.1.1.2.8.2  jruoho 
    130  1.1.1.2.8.2  jruoho     if (!AcpiUtValidObjectType (Type))
    131  1.1.1.2.8.2  jruoho     {
    132  1.1.1.2.8.2  jruoho         ACPI_WARNING ((AE_INFO,
    133  1.1.1.2.8.2  jruoho             "Invalid object type: 0x%X", Type));
    134  1.1.1.2.8.2  jruoho     }
    135  1.1.1.2.8.2  jruoho 
    136  1.1.1.2.8.2  jruoho     /* Allocate a new scope object */
    137  1.1.1.2.8.2  jruoho 
    138  1.1.1.2.8.2  jruoho     ScopeInfo = AcpiUtCreateGenericState ();
    139  1.1.1.2.8.2  jruoho     if (!ScopeInfo)
    140  1.1.1.2.8.2  jruoho     {
    141  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (AE_NO_MEMORY);
    142  1.1.1.2.8.2  jruoho     }
    143  1.1.1.2.8.2  jruoho 
    144  1.1.1.2.8.2  jruoho     /* Init new scope object */
    145  1.1.1.2.8.2  jruoho 
    146  1.1.1.2.8.2  jruoho     ScopeInfo->Common.DescriptorType = ACPI_DESC_TYPE_STATE_WSCOPE;
    147  1.1.1.2.8.2  jruoho     ScopeInfo->Scope.Node = Node;
    148  1.1.1.2.8.2  jruoho     ScopeInfo->Common.Value = (UINT16) Type;
    149  1.1.1.2.8.2  jruoho 
    150  1.1.1.2.8.2  jruoho     WalkState->ScopeDepth++;
    151  1.1.1.2.8.2  jruoho 
    152  1.1.1.2.8.2  jruoho     ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
    153  1.1.1.2.8.2  jruoho         "[%.2d] Pushed scope ", (UINT32) WalkState->ScopeDepth));
    154  1.1.1.2.8.2  jruoho 
    155  1.1.1.2.8.2  jruoho     OldScopeInfo = WalkState->ScopeInfo;
    156  1.1.1.2.8.2  jruoho     if (OldScopeInfo)
    157  1.1.1.2.8.2  jruoho     {
    158  1.1.1.2.8.2  jruoho         ACPI_DEBUG_PRINT_RAW ((ACPI_DB_EXEC,
    159  1.1.1.2.8.2  jruoho             "[%4.4s] (%s)",
    160  1.1.1.2.8.2  jruoho             AcpiUtGetNodeName (OldScopeInfo->Scope.Node),
    161  1.1.1.2.8.2  jruoho             AcpiUtGetTypeName (OldScopeInfo->Common.Value)));
    162  1.1.1.2.8.2  jruoho     }
    163  1.1.1.2.8.2  jruoho     else
    164  1.1.1.2.8.2  jruoho     {
    165  1.1.1.2.8.2  jruoho         ACPI_DEBUG_PRINT_RAW ((ACPI_DB_EXEC,
    166  1.1.1.2.8.2  jruoho             "[\\___] (%s)", "ROOT"));
    167  1.1.1.2.8.2  jruoho     }
    168  1.1.1.2.8.2  jruoho 
    169  1.1.1.2.8.2  jruoho     ACPI_DEBUG_PRINT_RAW ((ACPI_DB_EXEC,
    170  1.1.1.2.8.2  jruoho         ", New scope -> [%4.4s] (%s)\n",
    171  1.1.1.2.8.2  jruoho         AcpiUtGetNodeName (ScopeInfo->Scope.Node),
    172  1.1.1.2.8.2  jruoho         AcpiUtGetTypeName (ScopeInfo->Common.Value)));
    173  1.1.1.2.8.2  jruoho 
    174  1.1.1.2.8.2  jruoho     /* Push new scope object onto stack */
    175  1.1.1.2.8.2  jruoho 
    176  1.1.1.2.8.2  jruoho     AcpiUtPushGenericState (&WalkState->ScopeInfo, ScopeInfo);
    177  1.1.1.2.8.2  jruoho     return_ACPI_STATUS (AE_OK);
    178  1.1.1.2.8.2  jruoho }
    179  1.1.1.2.8.2  jruoho 
    180  1.1.1.2.8.2  jruoho 
    181  1.1.1.2.8.2  jruoho /****************************************************************************
    182  1.1.1.2.8.2  jruoho  *
    183  1.1.1.2.8.2  jruoho  * FUNCTION:    AcpiDsScopeStackPop
    184  1.1.1.2.8.2  jruoho  *
    185  1.1.1.2.8.2  jruoho  * PARAMETERS:  WalkState       - Current state
    186  1.1.1.2.8.2  jruoho  *
    187  1.1.1.2.8.2  jruoho  * RETURN:      Status
    188  1.1.1.2.8.2  jruoho  *
    189  1.1.1.2.8.2  jruoho  * DESCRIPTION: Pop the scope stack once.
    190  1.1.1.2.8.2  jruoho  *
    191  1.1.1.2.8.2  jruoho  ***************************************************************************/
    192  1.1.1.2.8.2  jruoho 
    193  1.1.1.2.8.2  jruoho ACPI_STATUS
    194  1.1.1.2.8.2  jruoho AcpiDsScopeStackPop (
    195  1.1.1.2.8.2  jruoho     ACPI_WALK_STATE         *WalkState)
    196  1.1.1.2.8.2  jruoho {
    197  1.1.1.2.8.2  jruoho     ACPI_GENERIC_STATE      *ScopeInfo;
    198  1.1.1.2.8.2  jruoho     ACPI_GENERIC_STATE      *NewScopeInfo;
    199  1.1.1.2.8.2  jruoho 
    200  1.1.1.2.8.2  jruoho 
    201  1.1.1.2.8.2  jruoho     ACPI_FUNCTION_TRACE (DsScopeStackPop);
    202  1.1.1.2.8.2  jruoho 
    203  1.1.1.2.8.2  jruoho 
    204  1.1.1.2.8.2  jruoho     /*
    205  1.1.1.2.8.2  jruoho      * Pop scope info object off the stack.
    206  1.1.1.2.8.2  jruoho      */
    207  1.1.1.2.8.2  jruoho     ScopeInfo = AcpiUtPopGenericState (&WalkState->ScopeInfo);
    208  1.1.1.2.8.2  jruoho     if (!ScopeInfo)
    209  1.1.1.2.8.2  jruoho     {
    210  1.1.1.2.8.2  jruoho         return_ACPI_STATUS (AE_STACK_UNDERFLOW);
    211  1.1.1.2.8.2  jruoho     }
    212  1.1.1.2.8.2  jruoho 
    213  1.1.1.2.8.2  jruoho     WalkState->ScopeDepth--;
    214  1.1.1.2.8.2  jruoho 
    215  1.1.1.2.8.2  jruoho     ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
    216  1.1.1.2.8.2  jruoho         "[%.2d] Popped scope [%4.4s] (%s), New scope -> ",
    217  1.1.1.2.8.2  jruoho         (UINT32) WalkState->ScopeDepth,
    218  1.1.1.2.8.2  jruoho         AcpiUtGetNodeName (ScopeInfo->Scope.Node),
    219  1.1.1.2.8.2  jruoho         AcpiUtGetTypeName (ScopeInfo->Common.Value)));
    220  1.1.1.2.8.2  jruoho 
    221  1.1.1.2.8.2  jruoho     NewScopeInfo = WalkState->ScopeInfo;
    222  1.1.1.2.8.2  jruoho     if (NewScopeInfo)
    223  1.1.1.2.8.2  jruoho     {
    224  1.1.1.2.8.2  jruoho         ACPI_DEBUG_PRINT_RAW ((ACPI_DB_EXEC,
    225  1.1.1.2.8.2  jruoho             "[%4.4s] (%s)\n",
    226  1.1.1.2.8.2  jruoho             AcpiUtGetNodeName (NewScopeInfo->Scope.Node),
    227  1.1.1.2.8.2  jruoho             AcpiUtGetTypeName (NewScopeInfo->Common.Value)));
    228  1.1.1.2.8.2  jruoho     }
    229  1.1.1.2.8.2  jruoho     else
    230  1.1.1.2.8.2  jruoho     {
    231  1.1.1.2.8.2  jruoho         ACPI_DEBUG_PRINT_RAW ((ACPI_DB_EXEC,
    232  1.1.1.2.8.2  jruoho             "[\\___] (ROOT)\n"));
    233  1.1.1.2.8.2  jruoho     }
    234  1.1.1.2.8.2  jruoho 
    235  1.1.1.2.8.2  jruoho     AcpiUtDeleteGenericState (ScopeInfo);
    236  1.1.1.2.8.2  jruoho     return_ACPI_STATUS (AE_OK);
    237  1.1.1.2.8.2  jruoho }
    238  1.1.1.2.8.2  jruoho 
    239  1.1.1.2.8.2  jruoho 
    240