Home | History | Annotate | Line # | Download | only in dispatcher
dsdebug.c revision 1.1.1.1.2.3
      1  1.1.1.1.2.2  skrll /******************************************************************************
      2  1.1.1.1.2.2  skrll  *
      3  1.1.1.1.2.2  skrll  * Module Name: dsdebug - Parser/Interpreter interface - debugging
      4  1.1.1.1.2.2  skrll  *
      5  1.1.1.1.2.2  skrll  *****************************************************************************/
      6  1.1.1.1.2.2  skrll 
      7  1.1.1.1.2.2  skrll /*
      8  1.1.1.1.2.3  skrll  * Copyright (C) 2000 - 2016, Intel Corp.
      9  1.1.1.1.2.2  skrll  * All rights reserved.
     10  1.1.1.1.2.2  skrll  *
     11  1.1.1.1.2.2  skrll  * Redistribution and use in source and binary forms, with or without
     12  1.1.1.1.2.2  skrll  * modification, are permitted provided that the following conditions
     13  1.1.1.1.2.2  skrll  * are met:
     14  1.1.1.1.2.2  skrll  * 1. Redistributions of source code must retain the above copyright
     15  1.1.1.1.2.2  skrll  *    notice, this list of conditions, and the following disclaimer,
     16  1.1.1.1.2.2  skrll  *    without modification.
     17  1.1.1.1.2.2  skrll  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
     18  1.1.1.1.2.2  skrll  *    substantially similar to the "NO WARRANTY" disclaimer below
     19  1.1.1.1.2.2  skrll  *    ("Disclaimer") and any redistribution must be conditioned upon
     20  1.1.1.1.2.2  skrll  *    including a substantially similar Disclaimer requirement for further
     21  1.1.1.1.2.2  skrll  *    binary redistribution.
     22  1.1.1.1.2.2  skrll  * 3. Neither the names of the above-listed copyright holders nor the names
     23  1.1.1.1.2.2  skrll  *    of any contributors may be used to endorse or promote products derived
     24  1.1.1.1.2.2  skrll  *    from this software without specific prior written permission.
     25  1.1.1.1.2.2  skrll  *
     26  1.1.1.1.2.2  skrll  * Alternatively, this software may be distributed under the terms of the
     27  1.1.1.1.2.2  skrll  * GNU General Public License ("GPL") version 2 as published by the Free
     28  1.1.1.1.2.2  skrll  * Software Foundation.
     29  1.1.1.1.2.2  skrll  *
     30  1.1.1.1.2.2  skrll  * NO WARRANTY
     31  1.1.1.1.2.2  skrll  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     32  1.1.1.1.2.2  skrll  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     33  1.1.1.1.2.2  skrll  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
     34  1.1.1.1.2.2  skrll  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     35  1.1.1.1.2.2  skrll  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     36  1.1.1.1.2.2  skrll  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     37  1.1.1.1.2.2  skrll  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     38  1.1.1.1.2.2  skrll  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     39  1.1.1.1.2.2  skrll  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
     40  1.1.1.1.2.2  skrll  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     41  1.1.1.1.2.2  skrll  * POSSIBILITY OF SUCH DAMAGES.
     42  1.1.1.1.2.2  skrll  */
     43  1.1.1.1.2.2  skrll 
     44  1.1.1.1.2.2  skrll #include "acpi.h"
     45  1.1.1.1.2.2  skrll #include "accommon.h"
     46  1.1.1.1.2.2  skrll #include "acdispat.h"
     47  1.1.1.1.2.2  skrll #include "acnamesp.h"
     48  1.1.1.1.2.2  skrll #include "acdisasm.h"
     49  1.1.1.1.2.2  skrll #include "acinterp.h"
     50  1.1.1.1.2.2  skrll 
     51  1.1.1.1.2.2  skrll 
     52  1.1.1.1.2.2  skrll #define _COMPONENT          ACPI_DISPATCHER
     53  1.1.1.1.2.2  skrll         ACPI_MODULE_NAME    ("dsdebug")
     54  1.1.1.1.2.2  skrll 
     55  1.1.1.1.2.2  skrll 
     56  1.1.1.1.2.2  skrll #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
     57  1.1.1.1.2.2  skrll 
     58  1.1.1.1.2.2  skrll /* Local prototypes */
     59  1.1.1.1.2.2  skrll 
     60  1.1.1.1.2.2  skrll static void
     61  1.1.1.1.2.2  skrll AcpiDsPrintNodePathname (
     62  1.1.1.1.2.2  skrll     ACPI_NAMESPACE_NODE     *Node,
     63  1.1.1.1.2.2  skrll     const char              *Message);
     64  1.1.1.1.2.2  skrll 
     65  1.1.1.1.2.2  skrll 
     66  1.1.1.1.2.2  skrll /*******************************************************************************
     67  1.1.1.1.2.2  skrll  *
     68  1.1.1.1.2.2  skrll  * FUNCTION:    AcpiDsPrintNodePathname
     69  1.1.1.1.2.2  skrll  *
     70  1.1.1.1.2.2  skrll  * PARAMETERS:  Node            - Object
     71  1.1.1.1.2.2  skrll  *              Message         - Prefix message
     72  1.1.1.1.2.2  skrll  *
     73  1.1.1.1.2.2  skrll  * DESCRIPTION: Print an object's full namespace pathname
     74  1.1.1.1.2.2  skrll  *              Manages allocation/freeing of a pathname buffer
     75  1.1.1.1.2.2  skrll  *
     76  1.1.1.1.2.2  skrll  ******************************************************************************/
     77  1.1.1.1.2.2  skrll 
     78  1.1.1.1.2.2  skrll static void
     79  1.1.1.1.2.2  skrll AcpiDsPrintNodePathname (
     80  1.1.1.1.2.2  skrll     ACPI_NAMESPACE_NODE     *Node,
     81  1.1.1.1.2.2  skrll     const char              *Message)
     82  1.1.1.1.2.2  skrll {
     83  1.1.1.1.2.2  skrll     ACPI_BUFFER             Buffer;
     84  1.1.1.1.2.2  skrll     ACPI_STATUS             Status;
     85  1.1.1.1.2.2  skrll 
     86  1.1.1.1.2.2  skrll 
     87  1.1.1.1.2.2  skrll     ACPI_FUNCTION_TRACE (DsPrintNodePathname);
     88  1.1.1.1.2.2  skrll 
     89  1.1.1.1.2.2  skrll     if (!Node)
     90  1.1.1.1.2.2  skrll     {
     91  1.1.1.1.2.2  skrll         ACPI_DEBUG_PRINT_RAW ((ACPI_DB_DISPATCH, "[NULL NAME]"));
     92  1.1.1.1.2.2  skrll         return_VOID;
     93  1.1.1.1.2.2  skrll     }
     94  1.1.1.1.2.2  skrll 
     95  1.1.1.1.2.2  skrll     /* Convert handle to full pathname and print it (with supplied message) */
     96  1.1.1.1.2.2  skrll 
     97  1.1.1.1.2.2  skrll     Buffer.Length = ACPI_ALLOCATE_LOCAL_BUFFER;
     98  1.1.1.1.2.2  skrll 
     99  1.1.1.1.2.3  skrll     Status = AcpiNsHandleToPathname (Node, &Buffer, TRUE);
    100  1.1.1.1.2.2  skrll     if (ACPI_SUCCESS (Status))
    101  1.1.1.1.2.2  skrll     {
    102  1.1.1.1.2.2  skrll         if (Message)
    103  1.1.1.1.2.2  skrll         {
    104  1.1.1.1.2.2  skrll             ACPI_DEBUG_PRINT_RAW ((ACPI_DB_DISPATCH, "%s ", Message));
    105  1.1.1.1.2.2  skrll         }
    106  1.1.1.1.2.2  skrll 
    107  1.1.1.1.2.2  skrll         ACPI_DEBUG_PRINT_RAW ((ACPI_DB_DISPATCH, "[%s] (Node %p)",
    108  1.1.1.1.2.2  skrll             (char *) Buffer.Pointer, Node));
    109  1.1.1.1.2.2  skrll         ACPI_FREE (Buffer.Pointer);
    110  1.1.1.1.2.2  skrll     }
    111  1.1.1.1.2.2  skrll 
    112  1.1.1.1.2.2  skrll     return_VOID;
    113  1.1.1.1.2.2  skrll }
    114  1.1.1.1.2.2  skrll 
    115  1.1.1.1.2.2  skrll 
    116  1.1.1.1.2.2  skrll /*******************************************************************************
    117  1.1.1.1.2.2  skrll  *
    118  1.1.1.1.2.2  skrll  * FUNCTION:    AcpiDsDumpMethodStack
    119  1.1.1.1.2.2  skrll  *
    120  1.1.1.1.2.2  skrll  * PARAMETERS:  Status          - Method execution status
    121  1.1.1.1.2.2  skrll  *              WalkState       - Current state of the parse tree walk
    122  1.1.1.1.2.2  skrll  *              Op              - Executing parse op
    123  1.1.1.1.2.2  skrll  *
    124  1.1.1.1.2.2  skrll  * RETURN:      None
    125  1.1.1.1.2.2  skrll  *
    126  1.1.1.1.2.2  skrll  * DESCRIPTION: Called when a method has been aborted because of an error.
    127  1.1.1.1.2.2  skrll  *              Dumps the method execution stack.
    128  1.1.1.1.2.2  skrll  *
    129  1.1.1.1.2.2  skrll  ******************************************************************************/
    130  1.1.1.1.2.2  skrll 
    131  1.1.1.1.2.2  skrll void
    132  1.1.1.1.2.2  skrll AcpiDsDumpMethodStack (
    133  1.1.1.1.2.2  skrll     ACPI_STATUS             Status,
    134  1.1.1.1.2.2  skrll     ACPI_WALK_STATE         *WalkState,
    135  1.1.1.1.2.2  skrll     ACPI_PARSE_OBJECT       *Op)
    136  1.1.1.1.2.2  skrll {
    137  1.1.1.1.2.2  skrll     ACPI_PARSE_OBJECT       *Next;
    138  1.1.1.1.2.2  skrll     ACPI_THREAD_STATE       *Thread;
    139  1.1.1.1.2.2  skrll     ACPI_WALK_STATE         *NextWalkState;
    140  1.1.1.1.2.2  skrll     ACPI_NAMESPACE_NODE     *PreviousMethod = NULL;
    141  1.1.1.1.2.2  skrll     ACPI_OPERAND_OBJECT     *MethodDesc;
    142  1.1.1.1.2.2  skrll 
    143  1.1.1.1.2.2  skrll 
    144  1.1.1.1.2.2  skrll     ACPI_FUNCTION_TRACE (DsDumpMethodStack);
    145  1.1.1.1.2.2  skrll 
    146  1.1.1.1.2.2  skrll     /* Ignore control codes, they are not errors */
    147  1.1.1.1.2.2  skrll 
    148  1.1.1.1.2.2  skrll     if ((Status & AE_CODE_MASK) == AE_CODE_CONTROL)
    149  1.1.1.1.2.2  skrll     {
    150  1.1.1.1.2.2  skrll         return_VOID;
    151  1.1.1.1.2.2  skrll     }
    152  1.1.1.1.2.2  skrll 
    153  1.1.1.1.2.2  skrll     /* We may be executing a deferred opcode */
    154  1.1.1.1.2.2  skrll 
    155  1.1.1.1.2.2  skrll     if (WalkState->DeferredNode)
    156  1.1.1.1.2.2  skrll     {
    157  1.1.1.1.2.2  skrll         ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
    158  1.1.1.1.2.2  skrll             "Executing subtree for Buffer/Package/Region\n"));
    159  1.1.1.1.2.2  skrll         return_VOID;
    160  1.1.1.1.2.2  skrll     }
    161  1.1.1.1.2.2  skrll 
    162  1.1.1.1.2.2  skrll     /*
    163  1.1.1.1.2.2  skrll      * If there is no Thread, we are not actually executing a method.
    164  1.1.1.1.2.2  skrll      * This can happen when the iASL compiler calls the interpreter
    165  1.1.1.1.2.2  skrll      * to perform constant folding.
    166  1.1.1.1.2.2  skrll      */
    167  1.1.1.1.2.2  skrll     Thread = WalkState->Thread;
    168  1.1.1.1.2.2  skrll     if (!Thread)
    169  1.1.1.1.2.2  skrll     {
    170  1.1.1.1.2.2  skrll         return_VOID;
    171  1.1.1.1.2.2  skrll     }
    172  1.1.1.1.2.2  skrll 
    173  1.1.1.1.2.2  skrll     /* Display exception and method name */
    174  1.1.1.1.2.2  skrll 
    175  1.1.1.1.2.2  skrll     ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
    176  1.1.1.1.2.2  skrll         "\n**** Exception %s during execution of method ",
    177  1.1.1.1.2.2  skrll         AcpiFormatException (Status)));
    178  1.1.1.1.2.3  skrll 
    179  1.1.1.1.2.2  skrll     AcpiDsPrintNodePathname (WalkState->MethodNode, NULL);
    180  1.1.1.1.2.2  skrll 
    181  1.1.1.1.2.2  skrll     /* Display stack of executing methods */
    182  1.1.1.1.2.2  skrll 
    183  1.1.1.1.2.2  skrll     ACPI_DEBUG_PRINT_RAW ((ACPI_DB_DISPATCH,
    184  1.1.1.1.2.2  skrll         "\n\nMethod Execution Stack:\n"));
    185  1.1.1.1.2.2  skrll     NextWalkState = Thread->WalkStateList;
    186  1.1.1.1.2.2  skrll 
    187  1.1.1.1.2.2  skrll     /* Walk list of linked walk states */
    188  1.1.1.1.2.2  skrll 
    189  1.1.1.1.2.2  skrll     while (NextWalkState)
    190  1.1.1.1.2.2  skrll     {
    191  1.1.1.1.2.2  skrll         MethodDesc = NextWalkState->MethodDesc;
    192  1.1.1.1.2.2  skrll         if (MethodDesc)
    193  1.1.1.1.2.2  skrll         {
    194  1.1.1.1.2.2  skrll             AcpiExStopTraceMethod (
    195  1.1.1.1.2.3  skrll                 (ACPI_NAMESPACE_NODE *) MethodDesc->Method.Node,
    196  1.1.1.1.2.3  skrll                 MethodDesc, WalkState);
    197  1.1.1.1.2.2  skrll         }
    198  1.1.1.1.2.2  skrll 
    199  1.1.1.1.2.2  skrll         ACPI_DEBUG_PRINT ((ACPI_DB_DISPATCH,
    200  1.1.1.1.2.2  skrll             "    Method [%4.4s] executing: ",
    201  1.1.1.1.2.2  skrll             AcpiUtGetNodeName (NextWalkState->MethodNode)));
    202  1.1.1.1.2.2  skrll 
    203  1.1.1.1.2.2  skrll         /* First method is the currently executing method */
    204  1.1.1.1.2.2  skrll 
    205  1.1.1.1.2.2  skrll         if (NextWalkState == WalkState)
    206  1.1.1.1.2.2  skrll         {
    207  1.1.1.1.2.2  skrll             if (Op)
    208  1.1.1.1.2.2  skrll             {
    209  1.1.1.1.2.2  skrll                 /* Display currently executing ASL statement */
    210  1.1.1.1.2.2  skrll 
    211  1.1.1.1.2.2  skrll                 Next = Op->Common.Next;
    212  1.1.1.1.2.2  skrll                 Op->Common.Next = NULL;
    213  1.1.1.1.2.2  skrll 
    214  1.1.1.1.2.2  skrll #ifdef ACPI_DISASSEMBLER
    215  1.1.1.1.2.2  skrll                 AcpiDmDisassemble (NextWalkState, Op, ACPI_UINT32_MAX);
    216  1.1.1.1.2.2  skrll #endif
    217  1.1.1.1.2.2  skrll                 Op->Common.Next = Next;
    218  1.1.1.1.2.2  skrll             }
    219  1.1.1.1.2.2  skrll         }
    220  1.1.1.1.2.2  skrll         else
    221  1.1.1.1.2.2  skrll         {
    222  1.1.1.1.2.2  skrll             /*
    223  1.1.1.1.2.2  skrll              * This method has called another method
    224  1.1.1.1.2.3  skrll              * NOTE: the method call parse subtree is already deleted at
    225  1.1.1.1.2.3  skrll              * this point, so we cannot disassemble the method invocation.
    226  1.1.1.1.2.2  skrll              */
    227  1.1.1.1.2.2  skrll             ACPI_DEBUG_PRINT_RAW ((ACPI_DB_DISPATCH, "Call to method "));
    228  1.1.1.1.2.2  skrll             AcpiDsPrintNodePathname (PreviousMethod, NULL);
    229  1.1.1.1.2.2  skrll         }
    230  1.1.1.1.2.2  skrll 
    231  1.1.1.1.2.2  skrll         PreviousMethod = NextWalkState->MethodNode;
    232  1.1.1.1.2.2  skrll         NextWalkState = NextWalkState->Next;
    233  1.1.1.1.2.2  skrll         ACPI_DEBUG_PRINT_RAW ((ACPI_DB_DISPATCH, "\n"));
    234  1.1.1.1.2.2  skrll     }
    235  1.1.1.1.2.2  skrll 
    236  1.1.1.1.2.2  skrll     return_VOID;
    237  1.1.1.1.2.2  skrll }
    238  1.1.1.1.2.2  skrll 
    239  1.1.1.1.2.2  skrll #else
    240  1.1.1.1.2.2  skrll 
    241  1.1.1.1.2.2  skrll void
    242  1.1.1.1.2.2  skrll AcpiDsDumpMethodStack (
    243  1.1.1.1.2.2  skrll     ACPI_STATUS             Status,
    244  1.1.1.1.2.2  skrll     ACPI_WALK_STATE         *WalkState,
    245  1.1.1.1.2.2  skrll     ACPI_PARSE_OBJECT       *Op)
    246  1.1.1.1.2.2  skrll {
    247  1.1.1.1.2.2  skrll     return;
    248  1.1.1.1.2.2  skrll }
    249  1.1.1.1.2.2  skrll 
    250  1.1.1.1.2.2  skrll #endif
    251