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