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