utdebug.c revision 1.4.2.2 1 1.4.2.2 rmind /******************************************************************************
2 1.4.2.2 rmind *
3 1.4.2.2 rmind * Module Name: utdebug - Debug print routines
4 1.4.2.2 rmind *
5 1.4.2.2 rmind *****************************************************************************/
6 1.4.2.2 rmind
7 1.4.2.2 rmind /*
8 1.4.2.2 rmind * Copyright (C) 2000 - 2011, Intel Corp.
9 1.4.2.2 rmind * All rights reserved.
10 1.4.2.2 rmind *
11 1.4.2.2 rmind * Redistribution and use in source and binary forms, with or without
12 1.4.2.2 rmind * modification, are permitted provided that the following conditions
13 1.4.2.2 rmind * are met:
14 1.4.2.2 rmind * 1. Redistributions of source code must retain the above copyright
15 1.4.2.2 rmind * notice, this list of conditions, and the following disclaimer,
16 1.4.2.2 rmind * without modification.
17 1.4.2.2 rmind * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 1.4.2.2 rmind * substantially similar to the "NO WARRANTY" disclaimer below
19 1.4.2.2 rmind * ("Disclaimer") and any redistribution must be conditioned upon
20 1.4.2.2 rmind * including a substantially similar Disclaimer requirement for further
21 1.4.2.2 rmind * binary redistribution.
22 1.4.2.2 rmind * 3. Neither the names of the above-listed copyright holders nor the names
23 1.4.2.2 rmind * of any contributors may be used to endorse or promote products derived
24 1.4.2.2 rmind * from this software without specific prior written permission.
25 1.4.2.2 rmind *
26 1.4.2.2 rmind * Alternatively, this software may be distributed under the terms of the
27 1.4.2.2 rmind * GNU General Public License ("GPL") version 2 as published by the Free
28 1.4.2.2 rmind * Software Foundation.
29 1.4.2.2 rmind *
30 1.4.2.2 rmind * NO WARRANTY
31 1.4.2.2 rmind * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 1.4.2.2 rmind * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 1.4.2.2 rmind * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 1.4.2.2 rmind * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 1.4.2.2 rmind * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 1.4.2.2 rmind * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 1.4.2.2 rmind * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 1.4.2.2 rmind * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 1.4.2.2 rmind * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 1.4.2.2 rmind * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 1.4.2.2 rmind * POSSIBILITY OF SUCH DAMAGES.
42 1.4.2.2 rmind */
43 1.4.2.2 rmind
44 1.4.2.2 rmind #define __UTDEBUG_C__
45 1.4.2.2 rmind
46 1.4.2.2 rmind #include "acpi.h"
47 1.4.2.2 rmind #include "accommon.h"
48 1.4.2.2 rmind
49 1.4.2.2 rmind #define _COMPONENT ACPI_UTILITIES
50 1.4.2.2 rmind ACPI_MODULE_NAME ("utdebug")
51 1.4.2.2 rmind
52 1.4.2.2 rmind
53 1.4.2.2 rmind #ifdef ACPI_DEBUG_OUTPUT
54 1.4.2.2 rmind
55 1.4.2.2 rmind static ACPI_THREAD_ID AcpiGbl_PrevThreadId = (ACPI_THREAD_ID) 0xFFFFFFFF;
56 1.4.2.2 rmind static const char *AcpiGbl_FnEntryStr = "----Entry";
57 1.4.2.2 rmind static const char *AcpiGbl_FnExitStr = "----Exit-";
58 1.4.2.2 rmind
59 1.4.2.2 rmind /* Local prototypes */
60 1.4.2.2 rmind
61 1.4.2.2 rmind static const char *
62 1.4.2.2 rmind AcpiUtTrimFunctionName (
63 1.4.2.2 rmind const char *FunctionName);
64 1.4.2.2 rmind
65 1.4.2.2 rmind
66 1.4.2.2 rmind /*******************************************************************************
67 1.4.2.2 rmind *
68 1.4.2.2 rmind * FUNCTION: AcpiUtInitStackPtrTrace
69 1.4.2.2 rmind *
70 1.4.2.2 rmind * PARAMETERS: None
71 1.4.2.2 rmind *
72 1.4.2.2 rmind * RETURN: None
73 1.4.2.2 rmind *
74 1.4.2.2 rmind * DESCRIPTION: Save the current CPU stack pointer at subsystem startup
75 1.4.2.2 rmind *
76 1.4.2.2 rmind ******************************************************************************/
77 1.4.2.2 rmind
78 1.4.2.2 rmind void
79 1.4.2.2 rmind AcpiUtInitStackPtrTrace (
80 1.4.2.2 rmind void)
81 1.4.2.2 rmind {
82 1.4.2.2 rmind ACPI_SIZE CurrentSp;
83 1.4.2.2 rmind
84 1.4.2.2 rmind
85 1.4.2.2 rmind AcpiGbl_EntryStackPointer = &CurrentSp;
86 1.4.2.2 rmind }
87 1.4.2.2 rmind
88 1.4.2.2 rmind
89 1.4.2.2 rmind /*******************************************************************************
90 1.4.2.2 rmind *
91 1.4.2.2 rmind * FUNCTION: AcpiUtTrackStackPtr
92 1.4.2.2 rmind *
93 1.4.2.2 rmind * PARAMETERS: None
94 1.4.2.2 rmind *
95 1.4.2.2 rmind * RETURN: None
96 1.4.2.2 rmind *
97 1.4.2.2 rmind * DESCRIPTION: Save the current CPU stack pointer
98 1.4.2.2 rmind *
99 1.4.2.2 rmind ******************************************************************************/
100 1.4.2.2 rmind
101 1.4.2.2 rmind void
102 1.4.2.2 rmind AcpiUtTrackStackPtr (
103 1.4.2.2 rmind void)
104 1.4.2.2 rmind {
105 1.4.2.2 rmind ACPI_SIZE CurrentSp;
106 1.4.2.2 rmind
107 1.4.2.2 rmind
108 1.4.2.2 rmind if (&CurrentSp < AcpiGbl_LowestStackPointer)
109 1.4.2.2 rmind {
110 1.4.2.2 rmind AcpiGbl_LowestStackPointer = &CurrentSp;
111 1.4.2.2 rmind }
112 1.4.2.2 rmind
113 1.4.2.2 rmind if (AcpiGbl_NestingLevel > AcpiGbl_DeepestNesting)
114 1.4.2.2 rmind {
115 1.4.2.2 rmind AcpiGbl_DeepestNesting = AcpiGbl_NestingLevel;
116 1.4.2.2 rmind }
117 1.4.2.2 rmind }
118 1.4.2.2 rmind
119 1.4.2.2 rmind
120 1.4.2.2 rmind /*******************************************************************************
121 1.4.2.2 rmind *
122 1.4.2.2 rmind * FUNCTION: AcpiUtTrimFunctionName
123 1.4.2.2 rmind *
124 1.4.2.2 rmind * PARAMETERS: FunctionName - Ascii string containing a procedure name
125 1.4.2.2 rmind *
126 1.4.2.2 rmind * RETURN: Updated pointer to the function name
127 1.4.2.2 rmind *
128 1.4.2.2 rmind * DESCRIPTION: Remove the "Acpi" prefix from the function name, if present.
129 1.4.2.2 rmind * This allows compiler macros such as __FUNCTION__ to be used
130 1.4.2.2 rmind * with no change to the debug output.
131 1.4.2.2 rmind *
132 1.4.2.2 rmind ******************************************************************************/
133 1.4.2.2 rmind
134 1.4.2.2 rmind static const char *
135 1.4.2.2 rmind AcpiUtTrimFunctionName (
136 1.4.2.2 rmind const char *FunctionName)
137 1.4.2.2 rmind {
138 1.4.2.2 rmind
139 1.4.2.2 rmind /* All Function names are longer than 4 chars, check is safe */
140 1.4.2.2 rmind
141 1.4.2.2 rmind if (*(ACPI_CAST_PTR (UINT32, FunctionName)) == ACPI_PREFIX_MIXED)
142 1.4.2.2 rmind {
143 1.4.2.2 rmind /* This is the case where the original source has not been modified */
144 1.4.2.2 rmind
145 1.4.2.2 rmind return (FunctionName + 4);
146 1.4.2.2 rmind }
147 1.4.2.2 rmind
148 1.4.2.2 rmind if (*(ACPI_CAST_PTR (UINT32, FunctionName)) == ACPI_PREFIX_LOWER)
149 1.4.2.2 rmind {
150 1.4.2.2 rmind /* This is the case where the source has been 'linuxized' */
151 1.4.2.2 rmind
152 1.4.2.2 rmind return (FunctionName + 5);
153 1.4.2.2 rmind }
154 1.4.2.2 rmind
155 1.4.2.2 rmind return (FunctionName);
156 1.4.2.2 rmind }
157 1.4.2.2 rmind
158 1.4.2.2 rmind
159 1.4.2.2 rmind /*******************************************************************************
160 1.4.2.2 rmind *
161 1.4.2.2 rmind * FUNCTION: AcpiDebugPrint
162 1.4.2.2 rmind *
163 1.4.2.2 rmind * PARAMETERS: RequestedDebugLevel - Requested debug print level
164 1.4.2.2 rmind * LineNumber - Caller's line number (for error output)
165 1.4.2.2 rmind * FunctionName - Caller's procedure name
166 1.4.2.2 rmind * ModuleName - Caller's module name
167 1.4.2.2 rmind * ComponentId - Caller's component ID
168 1.4.2.2 rmind * Format - Printf format field
169 1.4.2.2 rmind * ... - Optional printf arguments
170 1.4.2.2 rmind *
171 1.4.2.2 rmind * RETURN: None
172 1.4.2.2 rmind *
173 1.4.2.2 rmind * DESCRIPTION: Print error message with prefix consisting of the module name,
174 1.4.2.2 rmind * line number, and component ID.
175 1.4.2.2 rmind *
176 1.4.2.2 rmind ******************************************************************************/
177 1.4.2.2 rmind
178 1.4.2.2 rmind void ACPI_INTERNAL_VAR_XFACE
179 1.4.2.2 rmind AcpiDebugPrint (
180 1.4.2.2 rmind UINT32 RequestedDebugLevel,
181 1.4.2.2 rmind UINT32 LineNumber,
182 1.4.2.2 rmind const char *FunctionName,
183 1.4.2.2 rmind const char *ModuleName,
184 1.4.2.2 rmind UINT32 ComponentId,
185 1.4.2.2 rmind const char *Format,
186 1.4.2.2 rmind ...)
187 1.4.2.2 rmind {
188 1.4.2.2 rmind ACPI_THREAD_ID ThreadId;
189 1.4.2.2 rmind va_list args;
190 1.4.2.2 rmind
191 1.4.2.2 rmind
192 1.4.2.2 rmind /*
193 1.4.2.2 rmind * Stay silent if the debug level or component ID is disabled
194 1.4.2.2 rmind */
195 1.4.2.2 rmind if (!(RequestedDebugLevel & AcpiDbgLevel) ||
196 1.4.2.2 rmind !(ComponentId & AcpiDbgLayer))
197 1.4.2.2 rmind {
198 1.4.2.2 rmind return;
199 1.4.2.2 rmind }
200 1.4.2.2 rmind
201 1.4.2.2 rmind /*
202 1.4.2.2 rmind * Thread tracking and context switch notification
203 1.4.2.2 rmind */
204 1.4.2.2 rmind ThreadId = AcpiOsGetThreadId ();
205 1.4.2.2 rmind if (ThreadId != AcpiGbl_PrevThreadId)
206 1.4.2.2 rmind {
207 1.4.2.2 rmind if (ACPI_LV_THREADS & AcpiDbgLevel)
208 1.4.2.2 rmind {
209 1.4.2.2 rmind AcpiOsPrintf (
210 1.4.2.2 rmind "\n**** Context Switch from TID %u to TID %u ****\n\n",
211 1.4.2.2 rmind (UINT32) AcpiGbl_PrevThreadId, (UINT32) ThreadId);
212 1.4.2.2 rmind }
213 1.4.2.2 rmind
214 1.4.2.2 rmind AcpiGbl_PrevThreadId = ThreadId;
215 1.4.2.2 rmind }
216 1.4.2.2 rmind
217 1.4.2.2 rmind /*
218 1.4.2.2 rmind * Display the module name, current line number, thread ID (if requested),
219 1.4.2.2 rmind * current procedure nesting level, and the current procedure name
220 1.4.2.2 rmind */
221 1.4.2.2 rmind AcpiOsPrintf ("%8s-%04ld ", ModuleName, LineNumber);
222 1.4.2.2 rmind
223 1.4.2.2 rmind if (ACPI_LV_THREADS & AcpiDbgLevel)
224 1.4.2.2 rmind {
225 1.4.2.2 rmind AcpiOsPrintf ("[%u] ", (UINT32) ThreadId);
226 1.4.2.2 rmind }
227 1.4.2.2 rmind
228 1.4.2.2 rmind AcpiOsPrintf ("[%02ld] %-22.22s: ",
229 1.4.2.2 rmind AcpiGbl_NestingLevel, AcpiUtTrimFunctionName (FunctionName));
230 1.4.2.2 rmind
231 1.4.2.2 rmind va_start (args, Format);
232 1.4.2.2 rmind AcpiOsVprintf (Format, args);
233 1.4.2.2 rmind va_end (args);
234 1.4.2.2 rmind }
235 1.4.2.2 rmind
236 1.4.2.2 rmind ACPI_EXPORT_SYMBOL (AcpiDebugPrint)
237 1.4.2.2 rmind
238 1.4.2.2 rmind
239 1.4.2.2 rmind /*******************************************************************************
240 1.4.2.2 rmind *
241 1.4.2.2 rmind * FUNCTION: AcpiDebugPrintRaw
242 1.4.2.2 rmind *
243 1.4.2.2 rmind * PARAMETERS: RequestedDebugLevel - Requested debug print level
244 1.4.2.2 rmind * LineNumber - Caller's line number
245 1.4.2.2 rmind * FunctionName - Caller's procedure name
246 1.4.2.2 rmind * ModuleName - Caller's module name
247 1.4.2.2 rmind * ComponentId - Caller's component ID
248 1.4.2.2 rmind * Format - Printf format field
249 1.4.2.2 rmind * ... - Optional printf arguments
250 1.4.2.2 rmind *
251 1.4.2.2 rmind * RETURN: None
252 1.4.2.2 rmind *
253 1.4.2.2 rmind * DESCRIPTION: Print message with no headers. Has same interface as
254 1.4.2.2 rmind * DebugPrint so that the same macros can be used.
255 1.4.2.2 rmind *
256 1.4.2.2 rmind ******************************************************************************/
257 1.4.2.2 rmind
258 1.4.2.2 rmind void ACPI_INTERNAL_VAR_XFACE
259 1.4.2.2 rmind AcpiDebugPrintRaw (
260 1.4.2.2 rmind UINT32 RequestedDebugLevel,
261 1.4.2.2 rmind UINT32 LineNumber,
262 1.4.2.2 rmind const char *FunctionName,
263 1.4.2.2 rmind const char *ModuleName,
264 1.4.2.2 rmind UINT32 ComponentId,
265 1.4.2.2 rmind const char *Format,
266 1.4.2.2 rmind ...)
267 1.4.2.2 rmind {
268 1.4.2.2 rmind va_list args;
269 1.4.2.2 rmind
270 1.4.2.2 rmind
271 1.4.2.2 rmind if (!(RequestedDebugLevel & AcpiDbgLevel) ||
272 1.4.2.2 rmind !(ComponentId & AcpiDbgLayer))
273 1.4.2.2 rmind {
274 1.4.2.2 rmind return;
275 1.4.2.2 rmind }
276 1.4.2.2 rmind
277 1.4.2.2 rmind va_start (args, Format);
278 1.4.2.2 rmind AcpiOsVprintf (Format, args);
279 1.4.2.2 rmind va_end (args);
280 1.4.2.2 rmind }
281 1.4.2.2 rmind
282 1.4.2.2 rmind ACPI_EXPORT_SYMBOL (AcpiDebugPrintRaw)
283 1.4.2.2 rmind
284 1.4.2.2 rmind
285 1.4.2.2 rmind /*******************************************************************************
286 1.4.2.2 rmind *
287 1.4.2.2 rmind * FUNCTION: AcpiUtTrace
288 1.4.2.2 rmind *
289 1.4.2.2 rmind * PARAMETERS: LineNumber - Caller's line number
290 1.4.2.2 rmind * FunctionName - Caller's procedure name
291 1.4.2.2 rmind * ModuleName - Caller's module name
292 1.4.2.2 rmind * ComponentId - Caller's component ID
293 1.4.2.2 rmind *
294 1.4.2.2 rmind * RETURN: None
295 1.4.2.2 rmind *
296 1.4.2.2 rmind * DESCRIPTION: Function entry trace. Prints only if TRACE_FUNCTIONS bit is
297 1.4.2.2 rmind * set in DebugLevel
298 1.4.2.2 rmind *
299 1.4.2.2 rmind ******************************************************************************/
300 1.4.2.2 rmind
301 1.4.2.2 rmind void
302 1.4.2.2 rmind AcpiUtTrace (
303 1.4.2.2 rmind UINT32 LineNumber,
304 1.4.2.2 rmind const char *FunctionName,
305 1.4.2.2 rmind const char *ModuleName,
306 1.4.2.2 rmind UINT32 ComponentId)
307 1.4.2.2 rmind {
308 1.4.2.2 rmind
309 1.4.2.2 rmind AcpiGbl_NestingLevel++;
310 1.4.2.2 rmind AcpiUtTrackStackPtr ();
311 1.4.2.2 rmind
312 1.4.2.2 rmind AcpiDebugPrint (ACPI_LV_FUNCTIONS,
313 1.4.2.2 rmind LineNumber, FunctionName, ModuleName, ComponentId,
314 1.4.2.2 rmind "%s\n", AcpiGbl_FnEntryStr);
315 1.4.2.2 rmind }
316 1.4.2.2 rmind
317 1.4.2.2 rmind ACPI_EXPORT_SYMBOL (AcpiUtTrace)
318 1.4.2.2 rmind
319 1.4.2.2 rmind
320 1.4.2.2 rmind /*******************************************************************************
321 1.4.2.2 rmind *
322 1.4.2.2 rmind * FUNCTION: AcpiUtTracePtr
323 1.4.2.2 rmind *
324 1.4.2.2 rmind * PARAMETERS: LineNumber - Caller's line number
325 1.4.2.2 rmind * FunctionName - Caller's procedure name
326 1.4.2.2 rmind * ModuleName - Caller's module name
327 1.4.2.2 rmind * ComponentId - Caller's component ID
328 1.4.2.2 rmind * Pointer - Pointer to display
329 1.4.2.2 rmind *
330 1.4.2.2 rmind * RETURN: None
331 1.4.2.2 rmind *
332 1.4.2.2 rmind * DESCRIPTION: Function entry trace. Prints only if TRACE_FUNCTIONS bit is
333 1.4.2.2 rmind * set in DebugLevel
334 1.4.2.2 rmind *
335 1.4.2.2 rmind ******************************************************************************/
336 1.4.2.2 rmind
337 1.4.2.2 rmind void
338 1.4.2.2 rmind AcpiUtTracePtr (
339 1.4.2.2 rmind UINT32 LineNumber,
340 1.4.2.2 rmind const char *FunctionName,
341 1.4.2.2 rmind const char *ModuleName,
342 1.4.2.2 rmind UINT32 ComponentId,
343 1.4.2.2 rmind void *Pointer)
344 1.4.2.2 rmind {
345 1.4.2.2 rmind AcpiGbl_NestingLevel++;
346 1.4.2.2 rmind AcpiUtTrackStackPtr ();
347 1.4.2.2 rmind
348 1.4.2.2 rmind AcpiDebugPrint (ACPI_LV_FUNCTIONS,
349 1.4.2.2 rmind LineNumber, FunctionName, ModuleName, ComponentId,
350 1.4.2.2 rmind "%s %p\n", AcpiGbl_FnEntryStr, Pointer);
351 1.4.2.2 rmind }
352 1.4.2.2 rmind
353 1.4.2.2 rmind
354 1.4.2.2 rmind /*******************************************************************************
355 1.4.2.2 rmind *
356 1.4.2.2 rmind * FUNCTION: AcpiUtTraceStr
357 1.4.2.2 rmind *
358 1.4.2.2 rmind * PARAMETERS: LineNumber - Caller's line number
359 1.4.2.2 rmind * FunctionName - Caller's procedure name
360 1.4.2.2 rmind * ModuleName - Caller's module name
361 1.4.2.2 rmind * ComponentId - Caller's component ID
362 1.4.2.2 rmind * String - Additional string to display
363 1.4.2.2 rmind *
364 1.4.2.2 rmind * RETURN: None
365 1.4.2.2 rmind *
366 1.4.2.2 rmind * DESCRIPTION: Function entry trace. Prints only if TRACE_FUNCTIONS bit is
367 1.4.2.2 rmind * set in DebugLevel
368 1.4.2.2 rmind *
369 1.4.2.2 rmind ******************************************************************************/
370 1.4.2.2 rmind
371 1.4.2.2 rmind void
372 1.4.2.2 rmind AcpiUtTraceStr (
373 1.4.2.2 rmind UINT32 LineNumber,
374 1.4.2.2 rmind const char *FunctionName,
375 1.4.2.2 rmind const char *ModuleName,
376 1.4.2.2 rmind UINT32 ComponentId,
377 1.4.2.2 rmind const char *String)
378 1.4.2.2 rmind {
379 1.4.2.2 rmind
380 1.4.2.2 rmind AcpiGbl_NestingLevel++;
381 1.4.2.2 rmind AcpiUtTrackStackPtr ();
382 1.4.2.2 rmind
383 1.4.2.2 rmind AcpiDebugPrint (ACPI_LV_FUNCTIONS,
384 1.4.2.2 rmind LineNumber, FunctionName, ModuleName, ComponentId,
385 1.4.2.2 rmind "%s %s\n", AcpiGbl_FnEntryStr, String);
386 1.4.2.2 rmind }
387 1.4.2.2 rmind
388 1.4.2.2 rmind
389 1.4.2.2 rmind /*******************************************************************************
390 1.4.2.2 rmind *
391 1.4.2.2 rmind * FUNCTION: AcpiUtTraceU32
392 1.4.2.2 rmind *
393 1.4.2.2 rmind * PARAMETERS: LineNumber - Caller's line number
394 1.4.2.2 rmind * FunctionName - Caller's procedure name
395 1.4.2.2 rmind * ModuleName - Caller's module name
396 1.4.2.2 rmind * ComponentId - Caller's component ID
397 1.4.2.2 rmind * Integer - Integer to display
398 1.4.2.2 rmind *
399 1.4.2.2 rmind * RETURN: None
400 1.4.2.2 rmind *
401 1.4.2.2 rmind * DESCRIPTION: Function entry trace. Prints only if TRACE_FUNCTIONS bit is
402 1.4.2.2 rmind * set in DebugLevel
403 1.4.2.2 rmind *
404 1.4.2.2 rmind ******************************************************************************/
405 1.4.2.2 rmind
406 1.4.2.2 rmind void
407 1.4.2.2 rmind AcpiUtTraceU32 (
408 1.4.2.2 rmind UINT32 LineNumber,
409 1.4.2.2 rmind const char *FunctionName,
410 1.4.2.2 rmind const char *ModuleName,
411 1.4.2.2 rmind UINT32 ComponentId,
412 1.4.2.2 rmind UINT32 Integer)
413 1.4.2.2 rmind {
414 1.4.2.2 rmind
415 1.4.2.2 rmind AcpiGbl_NestingLevel++;
416 1.4.2.2 rmind AcpiUtTrackStackPtr ();
417 1.4.2.2 rmind
418 1.4.2.2 rmind AcpiDebugPrint (ACPI_LV_FUNCTIONS,
419 1.4.2.2 rmind LineNumber, FunctionName, ModuleName, ComponentId,
420 1.4.2.2 rmind "%s %08X\n", AcpiGbl_FnEntryStr, Integer);
421 1.4.2.2 rmind }
422 1.4.2.2 rmind
423 1.4.2.2 rmind
424 1.4.2.2 rmind /*******************************************************************************
425 1.4.2.2 rmind *
426 1.4.2.2 rmind * FUNCTION: AcpiUtExit
427 1.4.2.2 rmind *
428 1.4.2.2 rmind * PARAMETERS: LineNumber - Caller's line number
429 1.4.2.2 rmind * FunctionName - Caller's procedure name
430 1.4.2.2 rmind * ModuleName - Caller's module name
431 1.4.2.2 rmind * ComponentId - Caller's component ID
432 1.4.2.2 rmind *
433 1.4.2.2 rmind * RETURN: None
434 1.4.2.2 rmind *
435 1.4.2.2 rmind * DESCRIPTION: Function exit trace. Prints only if TRACE_FUNCTIONS bit is
436 1.4.2.2 rmind * set in DebugLevel
437 1.4.2.2 rmind *
438 1.4.2.2 rmind ******************************************************************************/
439 1.4.2.2 rmind
440 1.4.2.2 rmind void
441 1.4.2.2 rmind AcpiUtExit (
442 1.4.2.2 rmind UINT32 LineNumber,
443 1.4.2.2 rmind const char *FunctionName,
444 1.4.2.2 rmind const char *ModuleName,
445 1.4.2.2 rmind UINT32 ComponentId)
446 1.4.2.2 rmind {
447 1.4.2.2 rmind
448 1.4.2.2 rmind AcpiDebugPrint (ACPI_LV_FUNCTIONS,
449 1.4.2.2 rmind LineNumber, FunctionName, ModuleName, ComponentId,
450 1.4.2.2 rmind "%s\n", AcpiGbl_FnExitStr);
451 1.4.2.2 rmind
452 1.4.2.2 rmind AcpiGbl_NestingLevel--;
453 1.4.2.2 rmind }
454 1.4.2.2 rmind
455 1.4.2.2 rmind ACPI_EXPORT_SYMBOL (AcpiUtExit)
456 1.4.2.2 rmind
457 1.4.2.2 rmind
458 1.4.2.2 rmind /*******************************************************************************
459 1.4.2.2 rmind *
460 1.4.2.2 rmind * FUNCTION: AcpiUtStatusExit
461 1.4.2.2 rmind *
462 1.4.2.2 rmind * PARAMETERS: LineNumber - Caller's line number
463 1.4.2.2 rmind * FunctionName - Caller's procedure name
464 1.4.2.2 rmind * ModuleName - Caller's module name
465 1.4.2.2 rmind * ComponentId - Caller's component ID
466 1.4.2.2 rmind * Status - Exit status code
467 1.4.2.2 rmind *
468 1.4.2.2 rmind * RETURN: None
469 1.4.2.2 rmind *
470 1.4.2.2 rmind * DESCRIPTION: Function exit trace. Prints only if TRACE_FUNCTIONS bit is
471 1.4.2.2 rmind * set in DebugLevel. Prints exit status also.
472 1.4.2.2 rmind *
473 1.4.2.2 rmind ******************************************************************************/
474 1.4.2.2 rmind
475 1.4.2.2 rmind void
476 1.4.2.2 rmind AcpiUtStatusExit (
477 1.4.2.2 rmind UINT32 LineNumber,
478 1.4.2.2 rmind const char *FunctionName,
479 1.4.2.2 rmind const char *ModuleName,
480 1.4.2.2 rmind UINT32 ComponentId,
481 1.4.2.2 rmind ACPI_STATUS Status)
482 1.4.2.2 rmind {
483 1.4.2.2 rmind
484 1.4.2.2 rmind if (ACPI_SUCCESS (Status))
485 1.4.2.2 rmind {
486 1.4.2.2 rmind AcpiDebugPrint (ACPI_LV_FUNCTIONS,
487 1.4.2.2 rmind LineNumber, FunctionName, ModuleName, ComponentId,
488 1.4.2.2 rmind "%s %s\n", AcpiGbl_FnExitStr,
489 1.4.2.2 rmind AcpiFormatException (Status));
490 1.4.2.2 rmind }
491 1.4.2.2 rmind else
492 1.4.2.2 rmind {
493 1.4.2.2 rmind AcpiDebugPrint (ACPI_LV_FUNCTIONS,
494 1.4.2.2 rmind LineNumber, FunctionName, ModuleName, ComponentId,
495 1.4.2.2 rmind "%s ****Exception****: %s\n", AcpiGbl_FnExitStr,
496 1.4.2.2 rmind AcpiFormatException (Status));
497 1.4.2.2 rmind }
498 1.4.2.2 rmind
499 1.4.2.2 rmind AcpiGbl_NestingLevel--;
500 1.4.2.2 rmind }
501 1.4.2.2 rmind
502 1.4.2.2 rmind ACPI_EXPORT_SYMBOL (AcpiUtStatusExit)
503 1.4.2.2 rmind
504 1.4.2.2 rmind
505 1.4.2.2 rmind /*******************************************************************************
506 1.4.2.2 rmind *
507 1.4.2.2 rmind * FUNCTION: AcpiUtValueExit
508 1.4.2.2 rmind *
509 1.4.2.2 rmind * PARAMETERS: LineNumber - Caller's line number
510 1.4.2.2 rmind * FunctionName - Caller's procedure name
511 1.4.2.2 rmind * ModuleName - Caller's module name
512 1.4.2.2 rmind * ComponentId - Caller's component ID
513 1.4.2.2 rmind * Value - Value to be printed with exit msg
514 1.4.2.2 rmind *
515 1.4.2.2 rmind * RETURN: None
516 1.4.2.2 rmind *
517 1.4.2.2 rmind * DESCRIPTION: Function exit trace. Prints only if TRACE_FUNCTIONS bit is
518 1.4.2.2 rmind * set in DebugLevel. Prints exit value also.
519 1.4.2.2 rmind *
520 1.4.2.2 rmind ******************************************************************************/
521 1.4.2.2 rmind
522 1.4.2.2 rmind void
523 1.4.2.2 rmind AcpiUtValueExit (
524 1.4.2.2 rmind UINT32 LineNumber,
525 1.4.2.2 rmind const char *FunctionName,
526 1.4.2.2 rmind const char *ModuleName,
527 1.4.2.2 rmind UINT32 ComponentId,
528 1.4.2.2 rmind UINT64 Value)
529 1.4.2.2 rmind {
530 1.4.2.2 rmind
531 1.4.2.2 rmind AcpiDebugPrint (ACPI_LV_FUNCTIONS,
532 1.4.2.2 rmind LineNumber, FunctionName, ModuleName, ComponentId,
533 1.4.2.2 rmind "%s %8.8X%8.8X\n", AcpiGbl_FnExitStr,
534 1.4.2.2 rmind ACPI_FORMAT_UINT64 (Value));
535 1.4.2.2 rmind
536 1.4.2.2 rmind AcpiGbl_NestingLevel--;
537 1.4.2.2 rmind }
538 1.4.2.2 rmind
539 1.4.2.2 rmind ACPI_EXPORT_SYMBOL (AcpiUtValueExit)
540 1.4.2.2 rmind
541 1.4.2.2 rmind
542 1.4.2.2 rmind /*******************************************************************************
543 1.4.2.2 rmind *
544 1.4.2.2 rmind * FUNCTION: AcpiUtPtrExit
545 1.4.2.2 rmind *
546 1.4.2.2 rmind * PARAMETERS: LineNumber - Caller's line number
547 1.4.2.2 rmind * FunctionName - Caller's procedure name
548 1.4.2.2 rmind * ModuleName - Caller's module name
549 1.4.2.2 rmind * ComponentId - Caller's component ID
550 1.4.2.2 rmind * Ptr - Pointer to display
551 1.4.2.2 rmind *
552 1.4.2.2 rmind * RETURN: None
553 1.4.2.2 rmind *
554 1.4.2.2 rmind * DESCRIPTION: Function exit trace. Prints only if TRACE_FUNCTIONS bit is
555 1.4.2.2 rmind * set in DebugLevel. Prints exit value also.
556 1.4.2.2 rmind *
557 1.4.2.2 rmind ******************************************************************************/
558 1.4.2.2 rmind
559 1.4.2.2 rmind void
560 1.4.2.2 rmind AcpiUtPtrExit (
561 1.4.2.2 rmind UINT32 LineNumber,
562 1.4.2.2 rmind const char *FunctionName,
563 1.4.2.2 rmind const char *ModuleName,
564 1.4.2.2 rmind UINT32 ComponentId,
565 1.4.2.2 rmind UINT8 *Ptr)
566 1.4.2.2 rmind {
567 1.4.2.2 rmind
568 1.4.2.2 rmind AcpiDebugPrint (ACPI_LV_FUNCTIONS,
569 1.4.2.2 rmind LineNumber, FunctionName, ModuleName, ComponentId,
570 1.4.2.2 rmind "%s %p\n", AcpiGbl_FnExitStr, Ptr);
571 1.4.2.2 rmind
572 1.4.2.2 rmind AcpiGbl_NestingLevel--;
573 1.4.2.2 rmind }
574 1.4.2.2 rmind
575 1.4.2.2 rmind #endif
576 1.4.2.2 rmind
577 1.4.2.2 rmind
578 1.4.2.2 rmind /*******************************************************************************
579 1.4.2.2 rmind *
580 1.4.2.2 rmind * FUNCTION: AcpiUtDumpBuffer
581 1.4.2.2 rmind *
582 1.4.2.2 rmind * PARAMETERS: Buffer - Buffer to dump
583 1.4.2.2 rmind * Count - Amount to dump, in bytes
584 1.4.2.2 rmind * Display - BYTE, WORD, DWORD, or QWORD display
585 1.4.2.2 rmind * ComponentID - Caller's component ID
586 1.4.2.2 rmind *
587 1.4.2.2 rmind * RETURN: None
588 1.4.2.2 rmind *
589 1.4.2.2 rmind * DESCRIPTION: Generic dump buffer in both hex and ascii.
590 1.4.2.2 rmind *
591 1.4.2.2 rmind ******************************************************************************/
592 1.4.2.2 rmind
593 1.4.2.2 rmind void
594 1.4.2.2 rmind AcpiUtDumpBuffer2 (
595 1.4.2.2 rmind UINT8 *Buffer,
596 1.4.2.2 rmind UINT32 Count,
597 1.4.2.2 rmind UINT32 Display)
598 1.4.2.2 rmind {
599 1.4.2.2 rmind UINT32 i = 0;
600 1.4.2.2 rmind UINT32 j;
601 1.4.2.2 rmind UINT32 Temp32;
602 1.4.2.2 rmind UINT8 BufChar;
603 1.4.2.2 rmind
604 1.4.2.2 rmind
605 1.4.2.2 rmind if (!Buffer)
606 1.4.2.2 rmind {
607 1.4.2.2 rmind AcpiOsPrintf ("Null Buffer Pointer in DumpBuffer!\n");
608 1.4.2.2 rmind return;
609 1.4.2.2 rmind }
610 1.4.2.2 rmind
611 1.4.2.2 rmind if ((Count < 4) || (Count & 0x01))
612 1.4.2.2 rmind {
613 1.4.2.2 rmind Display = DB_BYTE_DISPLAY;
614 1.4.2.2 rmind }
615 1.4.2.2 rmind
616 1.4.2.2 rmind /* Nasty little dump buffer routine! */
617 1.4.2.2 rmind
618 1.4.2.2 rmind while (i < Count)
619 1.4.2.2 rmind {
620 1.4.2.2 rmind /* Print current offset */
621 1.4.2.2 rmind
622 1.4.2.2 rmind AcpiOsPrintf ("%6.4X: ", i);
623 1.4.2.2 rmind
624 1.4.2.2 rmind /* Print 16 hex chars */
625 1.4.2.2 rmind
626 1.4.2.2 rmind for (j = 0; j < 16;)
627 1.4.2.2 rmind {
628 1.4.2.2 rmind if (i + j >= Count)
629 1.4.2.2 rmind {
630 1.4.2.2 rmind /* Dump fill spaces */
631 1.4.2.2 rmind
632 1.4.2.2 rmind AcpiOsPrintf ("%*s", ((Display * 2) + 1), " ");
633 1.4.2.2 rmind j += Display;
634 1.4.2.2 rmind continue;
635 1.4.2.2 rmind }
636 1.4.2.2 rmind
637 1.4.2.2 rmind switch (Display)
638 1.4.2.2 rmind {
639 1.4.2.2 rmind case DB_BYTE_DISPLAY:
640 1.4.2.2 rmind default: /* Default is BYTE display */
641 1.4.2.2 rmind
642 1.4.2.2 rmind AcpiOsPrintf ("%02X ", Buffer[(ACPI_SIZE) i + j]);
643 1.4.2.2 rmind break;
644 1.4.2.2 rmind
645 1.4.2.2 rmind
646 1.4.2.2 rmind case DB_WORD_DISPLAY:
647 1.4.2.2 rmind
648 1.4.2.2 rmind ACPI_MOVE_16_TO_32 (&Temp32, &Buffer[(ACPI_SIZE) i + j]);
649 1.4.2.2 rmind AcpiOsPrintf ("%04X ", Temp32);
650 1.4.2.2 rmind break;
651 1.4.2.2 rmind
652 1.4.2.2 rmind
653 1.4.2.2 rmind case DB_DWORD_DISPLAY:
654 1.4.2.2 rmind
655 1.4.2.2 rmind ACPI_MOVE_32_TO_32 (&Temp32, &Buffer[(ACPI_SIZE) i + j]);
656 1.4.2.2 rmind AcpiOsPrintf ("%08X ", Temp32);
657 1.4.2.2 rmind break;
658 1.4.2.2 rmind
659 1.4.2.2 rmind
660 1.4.2.2 rmind case DB_QWORD_DISPLAY:
661 1.4.2.2 rmind
662 1.4.2.2 rmind ACPI_MOVE_32_TO_32 (&Temp32, &Buffer[(ACPI_SIZE) i + j]);
663 1.4.2.2 rmind AcpiOsPrintf ("%08X", Temp32);
664 1.4.2.2 rmind
665 1.4.2.2 rmind ACPI_MOVE_32_TO_32 (&Temp32, &Buffer[(ACPI_SIZE) i + j + 4]);
666 1.4.2.2 rmind AcpiOsPrintf ("%08X ", Temp32);
667 1.4.2.2 rmind break;
668 1.4.2.2 rmind }
669 1.4.2.2 rmind
670 1.4.2.2 rmind j += Display;
671 1.4.2.2 rmind }
672 1.4.2.2 rmind
673 1.4.2.2 rmind /*
674 1.4.2.2 rmind * Print the ASCII equivalent characters but watch out for the bad
675 1.4.2.2 rmind * unprintable ones (printable chars are 0x20 through 0x7E)
676 1.4.2.2 rmind */
677 1.4.2.2 rmind AcpiOsPrintf (" ");
678 1.4.2.2 rmind for (j = 0; j < 16; j++)
679 1.4.2.2 rmind {
680 1.4.2.2 rmind if (i + j >= Count)
681 1.4.2.2 rmind {
682 1.4.2.2 rmind AcpiOsPrintf ("\n");
683 1.4.2.2 rmind return;
684 1.4.2.2 rmind }
685 1.4.2.2 rmind
686 1.4.2.2 rmind BufChar = Buffer[(ACPI_SIZE) i + j];
687 1.4.2.2 rmind if (ACPI_IS_PRINT (BufChar))
688 1.4.2.2 rmind {
689 1.4.2.2 rmind AcpiOsPrintf ("%c", BufChar);
690 1.4.2.2 rmind }
691 1.4.2.2 rmind else
692 1.4.2.2 rmind {
693 1.4.2.2 rmind AcpiOsPrintf (".");
694 1.4.2.2 rmind }
695 1.4.2.2 rmind }
696 1.4.2.2 rmind
697 1.4.2.2 rmind /* Done with that line. */
698 1.4.2.2 rmind
699 1.4.2.2 rmind AcpiOsPrintf ("\n");
700 1.4.2.2 rmind i += 16;
701 1.4.2.2 rmind }
702 1.4.2.2 rmind
703 1.4.2.2 rmind return;
704 1.4.2.2 rmind }
705 1.4.2.2 rmind
706 1.4.2.2 rmind
707 1.4.2.2 rmind /*******************************************************************************
708 1.4.2.2 rmind *
709 1.4.2.2 rmind * FUNCTION: AcpiUtDumpBuffer
710 1.4.2.2 rmind *
711 1.4.2.2 rmind * PARAMETERS: Buffer - Buffer to dump
712 1.4.2.2 rmind * Count - Amount to dump, in bytes
713 1.4.2.2 rmind * Display - BYTE, WORD, DWORD, or QWORD display
714 1.4.2.2 rmind * ComponentID - Caller's component ID
715 1.4.2.2 rmind *
716 1.4.2.2 rmind * RETURN: None
717 1.4.2.2 rmind *
718 1.4.2.2 rmind * DESCRIPTION: Generic dump buffer in both hex and ascii.
719 1.4.2.2 rmind *
720 1.4.2.2 rmind ******************************************************************************/
721 1.4.2.2 rmind
722 1.4.2.2 rmind void
723 1.4.2.2 rmind AcpiUtDumpBuffer (
724 1.4.2.2 rmind UINT8 *Buffer,
725 1.4.2.2 rmind UINT32 Count,
726 1.4.2.2 rmind UINT32 Display,
727 1.4.2.2 rmind UINT32 ComponentId)
728 1.4.2.2 rmind {
729 1.4.2.2 rmind
730 1.4.2.2 rmind /* Only dump the buffer if tracing is enabled */
731 1.4.2.2 rmind
732 1.4.2.2 rmind if (!((ACPI_LV_TABLES & AcpiDbgLevel) &&
733 1.4.2.2 rmind (ComponentId & AcpiDbgLayer)))
734 1.4.2.2 rmind {
735 1.4.2.2 rmind return;
736 1.4.2.2 rmind }
737 1.4.2.2 rmind
738 1.4.2.2 rmind AcpiUtDumpBuffer2 (Buffer, Count, Display);
739 1.4.2.2 rmind }
740 1.4.2.2 rmind
741 1.4.2.2 rmind
742