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