xref: /linux/drivers/acpi/acpica/utdebug.c (revision ba494beeaa69bc0fb01eb89464ad5d57d26e3901)
195b482a8SLen Brown /******************************************************************************
295b482a8SLen Brown  *
395b482a8SLen Brown  * Module Name: utdebug - Debug print routines
495b482a8SLen Brown  *
595b482a8SLen Brown  *****************************************************************************/
695b482a8SLen Brown 
795b482a8SLen Brown /*
877848130SBob Moore  * Copyright (C) 2000 - 2012, Intel Corp.
995b482a8SLen Brown  * All rights reserved.
1095b482a8SLen Brown  *
1195b482a8SLen Brown  * Redistribution and use in source and binary forms, with or without
1295b482a8SLen Brown  * modification, are permitted provided that the following conditions
1395b482a8SLen Brown  * are met:
1495b482a8SLen Brown  * 1. Redistributions of source code must retain the above copyright
1595b482a8SLen Brown  *    notice, this list of conditions, and the following disclaimer,
1695b482a8SLen Brown  *    without modification.
1795b482a8SLen Brown  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
1895b482a8SLen Brown  *    substantially similar to the "NO WARRANTY" disclaimer below
1995b482a8SLen Brown  *    ("Disclaimer") and any redistribution must be conditioned upon
2095b482a8SLen Brown  *    including a substantially similar Disclaimer requirement for further
2195b482a8SLen Brown  *    binary redistribution.
2295b482a8SLen Brown  * 3. Neither the names of the above-listed copyright holders nor the names
2395b482a8SLen Brown  *    of any contributors may be used to endorse or promote products derived
2495b482a8SLen Brown  *    from this software without specific prior written permission.
2595b482a8SLen Brown  *
2695b482a8SLen Brown  * Alternatively, this software may be distributed under the terms of the
2795b482a8SLen Brown  * GNU General Public License ("GPL") version 2 as published by the Free
2895b482a8SLen Brown  * Software Foundation.
2995b482a8SLen Brown  *
3095b482a8SLen Brown  * NO WARRANTY
3195b482a8SLen Brown  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
3295b482a8SLen Brown  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
3395b482a8SLen Brown  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
3495b482a8SLen Brown  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
3595b482a8SLen Brown  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
3695b482a8SLen Brown  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
3795b482a8SLen Brown  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
3895b482a8SLen Brown  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
3995b482a8SLen Brown  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
4095b482a8SLen Brown  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
4195b482a8SLen Brown  * POSSIBILITY OF SUCH DAMAGES.
4295b482a8SLen Brown  */
4395b482a8SLen Brown 
44214f2c90SPaul Gortmaker #include <linux/export.h>
4595b482a8SLen Brown #include <acpi/acpi.h>
46e2f7a777SLen Brown #include "accommon.h"
4795b482a8SLen Brown 
4895b482a8SLen Brown #define _COMPONENT          ACPI_UTILITIES
4995b482a8SLen Brown ACPI_MODULE_NAME("utdebug")
5095b482a8SLen Brown #ifdef ACPI_DEBUG_OUTPUT
5195b482a8SLen Brown static acpi_thread_id acpi_gbl_prev_thread_id;
5295b482a8SLen Brown static char *acpi_gbl_fn_entry_str = "----Entry";
5395b482a8SLen Brown static char *acpi_gbl_fn_exit_str = "----Exit-";
5495b482a8SLen Brown 
5595b482a8SLen Brown /* Local prototypes */
5695b482a8SLen Brown 
5795b482a8SLen Brown static const char *acpi_ut_trim_function_name(const char *function_name);
5895b482a8SLen Brown 
5995b482a8SLen Brown /*******************************************************************************
6095b482a8SLen Brown  *
6195b482a8SLen Brown  * FUNCTION:    acpi_ut_init_stack_ptr_trace
6295b482a8SLen Brown  *
6395b482a8SLen Brown  * PARAMETERS:  None
6495b482a8SLen Brown  *
6595b482a8SLen Brown  * RETURN:      None
6695b482a8SLen Brown  *
6795b482a8SLen Brown  * DESCRIPTION: Save the current CPU stack pointer at subsystem startup
6895b482a8SLen Brown  *
6995b482a8SLen Brown  ******************************************************************************/
7095b482a8SLen Brown 
7195b482a8SLen Brown void acpi_ut_init_stack_ptr_trace(void)
7295b482a8SLen Brown {
7395b482a8SLen Brown 	acpi_size current_sp;
7495b482a8SLen Brown 
7595b482a8SLen Brown 	acpi_gbl_entry_stack_pointer = &current_sp;
7695b482a8SLen Brown }
7795b482a8SLen Brown 
7895b482a8SLen Brown /*******************************************************************************
7995b482a8SLen Brown  *
8095b482a8SLen Brown  * FUNCTION:    acpi_ut_track_stack_ptr
8195b482a8SLen Brown  *
8295b482a8SLen Brown  * PARAMETERS:  None
8395b482a8SLen Brown  *
8495b482a8SLen Brown  * RETURN:      None
8595b482a8SLen Brown  *
8695b482a8SLen Brown  * DESCRIPTION: Save the current CPU stack pointer
8795b482a8SLen Brown  *
8895b482a8SLen Brown  ******************************************************************************/
8995b482a8SLen Brown 
9095b482a8SLen Brown void acpi_ut_track_stack_ptr(void)
9195b482a8SLen Brown {
9295b482a8SLen Brown 	acpi_size current_sp;
9395b482a8SLen Brown 
9495b482a8SLen Brown 	if (&current_sp < acpi_gbl_lowest_stack_pointer) {
9595b482a8SLen Brown 		acpi_gbl_lowest_stack_pointer = &current_sp;
9695b482a8SLen Brown 	}
9795b482a8SLen Brown 
9895b482a8SLen Brown 	if (acpi_gbl_nesting_level > acpi_gbl_deepest_nesting) {
9995b482a8SLen Brown 		acpi_gbl_deepest_nesting = acpi_gbl_nesting_level;
10095b482a8SLen Brown 	}
10195b482a8SLen Brown }
10295b482a8SLen Brown 
10395b482a8SLen Brown /*******************************************************************************
10495b482a8SLen Brown  *
10595b482a8SLen Brown  * FUNCTION:    acpi_ut_trim_function_name
10695b482a8SLen Brown  *
10795b482a8SLen Brown  * PARAMETERS:  function_name       - Ascii string containing a procedure name
10895b482a8SLen Brown  *
10995b482a8SLen Brown  * RETURN:      Updated pointer to the function name
11095b482a8SLen Brown  *
11195b482a8SLen Brown  * DESCRIPTION: Remove the "Acpi" prefix from the function name, if present.
11295b482a8SLen Brown  *              This allows compiler macros such as __func__ to be used
11395b482a8SLen Brown  *              with no change to the debug output.
11495b482a8SLen Brown  *
11595b482a8SLen Brown  ******************************************************************************/
11695b482a8SLen Brown 
11795b482a8SLen Brown static const char *acpi_ut_trim_function_name(const char *function_name)
11895b482a8SLen Brown {
11995b482a8SLen Brown 
12095b482a8SLen Brown 	/* All Function names are longer than 4 chars, check is safe */
12195b482a8SLen Brown 
12295b482a8SLen Brown 	if (*(ACPI_CAST_PTR(u32, function_name)) == ACPI_PREFIX_MIXED) {
12395b482a8SLen Brown 
12495b482a8SLen Brown 		/* This is the case where the original source has not been modified */
12595b482a8SLen Brown 
12695b482a8SLen Brown 		return (function_name + 4);
12795b482a8SLen Brown 	}
12895b482a8SLen Brown 
12995b482a8SLen Brown 	if (*(ACPI_CAST_PTR(u32, function_name)) == ACPI_PREFIX_LOWER) {
13095b482a8SLen Brown 
13195b482a8SLen Brown 		/* This is the case where the source has been 'linuxized' */
13295b482a8SLen Brown 
13395b482a8SLen Brown 		return (function_name + 5);
13495b482a8SLen Brown 	}
13595b482a8SLen Brown 
13695b482a8SLen Brown 	return (function_name);
13795b482a8SLen Brown }
13895b482a8SLen Brown 
13995b482a8SLen Brown /*******************************************************************************
14095b482a8SLen Brown  *
14195b482a8SLen Brown  * FUNCTION:    acpi_debug_print
14295b482a8SLen Brown  *
14395b482a8SLen Brown  * PARAMETERS:  requested_debug_level - Requested debug print level
14495b482a8SLen Brown  *              line_number         - Caller's line number (for error output)
14595b482a8SLen Brown  *              function_name       - Caller's procedure name
14695b482a8SLen Brown  *              module_name         - Caller's module name
14795b482a8SLen Brown  *              component_id        - Caller's component ID
148*ba494beeSBob Moore  *              format              - Printf format field
14995b482a8SLen Brown  *              ...                 - Optional printf arguments
15095b482a8SLen Brown  *
15195b482a8SLen Brown  * RETURN:      None
15295b482a8SLen Brown  *
15395b482a8SLen Brown  * DESCRIPTION: Print error message with prefix consisting of the module name,
15495b482a8SLen Brown  *              line number, and component ID.
15595b482a8SLen Brown  *
15695b482a8SLen Brown  ******************************************************************************/
15795b482a8SLen Brown 
15895b482a8SLen Brown void ACPI_INTERNAL_VAR_XFACE
15995b482a8SLen Brown acpi_debug_print(u32 requested_debug_level,
16095b482a8SLen Brown 		 u32 line_number,
16195b482a8SLen Brown 		 const char *function_name,
16295b482a8SLen Brown 		 const char *module_name,
16395b482a8SLen Brown 		 u32 component_id, const char *format, ...)
16495b482a8SLen Brown {
16595b482a8SLen Brown 	acpi_thread_id thread_id;
16695b482a8SLen Brown 	va_list args;
16795b482a8SLen Brown 
16895b482a8SLen Brown 	/*
16995b482a8SLen Brown 	 * Stay silent if the debug level or component ID is disabled
17095b482a8SLen Brown 	 */
17195b482a8SLen Brown 	if (!(requested_debug_level & acpi_dbg_level) ||
17295b482a8SLen Brown 	    !(component_id & acpi_dbg_layer)) {
17395b482a8SLen Brown 		return;
17495b482a8SLen Brown 	}
17595b482a8SLen Brown 
17695b482a8SLen Brown 	/*
17795b482a8SLen Brown 	 * Thread tracking and context switch notification
17895b482a8SLen Brown 	 */
17995b482a8SLen Brown 	thread_id = acpi_os_get_thread_id();
18095b482a8SLen Brown 	if (thread_id != acpi_gbl_prev_thread_id) {
18195b482a8SLen Brown 		if (ACPI_LV_THREADS & acpi_dbg_level) {
18295b482a8SLen Brown 			acpi_os_printf
18328eb3fcfSLin Ming 			    ("\n**** Context Switch from TID %u to TID %u ****\n\n",
18428eb3fcfSLin Ming 			     (u32)acpi_gbl_prev_thread_id, (u32)thread_id);
18595b482a8SLen Brown 		}
18695b482a8SLen Brown 
18795b482a8SLen Brown 		acpi_gbl_prev_thread_id = thread_id;
18895b482a8SLen Brown 	}
18995b482a8SLen Brown 
19095b482a8SLen Brown 	/*
19195b482a8SLen Brown 	 * Display the module name, current line number, thread ID (if requested),
19295b482a8SLen Brown 	 * current procedure nesting level, and the current procedure name
19395b482a8SLen Brown 	 */
19495b482a8SLen Brown 	acpi_os_printf("%8s-%04ld ", module_name, line_number);
19595b482a8SLen Brown 
19695b482a8SLen Brown 	if (ACPI_LV_THREADS & acpi_dbg_level) {
19728eb3fcfSLin Ming 		acpi_os_printf("[%u] ", (u32)thread_id);
19895b482a8SLen Brown 	}
19995b482a8SLen Brown 
20095b482a8SLen Brown 	acpi_os_printf("[%02ld] %-22.22s: ",
20195b482a8SLen Brown 		       acpi_gbl_nesting_level,
20295b482a8SLen Brown 		       acpi_ut_trim_function_name(function_name));
20395b482a8SLen Brown 
20495b482a8SLen Brown 	va_start(args, format);
20595b482a8SLen Brown 	acpi_os_vprintf(format, args);
20695b482a8SLen Brown 	va_end(args);
20795b482a8SLen Brown }
20895b482a8SLen Brown 
20995b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_debug_print)
21095b482a8SLen Brown 
21195b482a8SLen Brown /*******************************************************************************
21295b482a8SLen Brown  *
21395b482a8SLen Brown  * FUNCTION:    acpi_debug_print_raw
21495b482a8SLen Brown  *
21595b482a8SLen Brown  * PARAMETERS:  requested_debug_level - Requested debug print level
21695b482a8SLen Brown  *              line_number         - Caller's line number
21795b482a8SLen Brown  *              function_name       - Caller's procedure name
21895b482a8SLen Brown  *              module_name         - Caller's module name
21995b482a8SLen Brown  *              component_id        - Caller's component ID
220*ba494beeSBob Moore  *              format              - Printf format field
22195b482a8SLen Brown  *              ...                 - Optional printf arguments
22295b482a8SLen Brown  *
22395b482a8SLen Brown  * RETURN:      None
22495b482a8SLen Brown  *
22595b482a8SLen Brown  * DESCRIPTION: Print message with no headers.  Has same interface as
22695b482a8SLen Brown  *              debug_print so that the same macros can be used.
22795b482a8SLen Brown  *
22895b482a8SLen Brown  ******************************************************************************/
22995b482a8SLen Brown void ACPI_INTERNAL_VAR_XFACE
23095b482a8SLen Brown acpi_debug_print_raw(u32 requested_debug_level,
23195b482a8SLen Brown 		     u32 line_number,
23295b482a8SLen Brown 		     const char *function_name,
23395b482a8SLen Brown 		     const char *module_name,
23495b482a8SLen Brown 		     u32 component_id, const char *format, ...)
23595b482a8SLen Brown {
23695b482a8SLen Brown 	va_list args;
23795b482a8SLen Brown 
23895b482a8SLen Brown 	if (!(requested_debug_level & acpi_dbg_level) ||
23995b482a8SLen Brown 	    !(component_id & acpi_dbg_layer)) {
24095b482a8SLen Brown 		return;
24195b482a8SLen Brown 	}
24295b482a8SLen Brown 
24395b482a8SLen Brown 	va_start(args, format);
24495b482a8SLen Brown 	acpi_os_vprintf(format, args);
24595b482a8SLen Brown 	va_end(args);
24695b482a8SLen Brown }
24795b482a8SLen Brown 
24895b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_debug_print_raw)
24995b482a8SLen Brown 
25095b482a8SLen Brown /*******************************************************************************
25195b482a8SLen Brown  *
25295b482a8SLen Brown  * FUNCTION:    acpi_ut_trace
25395b482a8SLen Brown  *
25495b482a8SLen Brown  * PARAMETERS:  line_number         - Caller's line number
25595b482a8SLen Brown  *              function_name       - Caller's procedure name
25695b482a8SLen Brown  *              module_name         - Caller's module name
25795b482a8SLen Brown  *              component_id        - Caller's component ID
25895b482a8SLen Brown  *
25995b482a8SLen Brown  * RETURN:      None
26095b482a8SLen Brown  *
26195b482a8SLen Brown  * DESCRIPTION: Function entry trace.  Prints only if TRACE_FUNCTIONS bit is
26295b482a8SLen Brown  *              set in debug_level
26395b482a8SLen Brown  *
26495b482a8SLen Brown  ******************************************************************************/
26595b482a8SLen Brown void
26695b482a8SLen Brown acpi_ut_trace(u32 line_number,
26795b482a8SLen Brown 	      const char *function_name,
26895b482a8SLen Brown 	      const char *module_name, u32 component_id)
26995b482a8SLen Brown {
27095b482a8SLen Brown 
27195b482a8SLen Brown 	acpi_gbl_nesting_level++;
27295b482a8SLen Brown 	acpi_ut_track_stack_ptr();
27395b482a8SLen Brown 
27495b482a8SLen Brown 	acpi_debug_print(ACPI_LV_FUNCTIONS,
27595b482a8SLen Brown 			 line_number, function_name, module_name, component_id,
27695b482a8SLen Brown 			 "%s\n", acpi_gbl_fn_entry_str);
27795b482a8SLen Brown }
27895b482a8SLen Brown 
27995b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_ut_trace)
28095b482a8SLen Brown 
28195b482a8SLen Brown /*******************************************************************************
28295b482a8SLen Brown  *
28395b482a8SLen Brown  * FUNCTION:    acpi_ut_trace_ptr
28495b482a8SLen Brown  *
28595b482a8SLen Brown  * PARAMETERS:  line_number         - Caller's line number
28695b482a8SLen Brown  *              function_name       - Caller's procedure name
28795b482a8SLen Brown  *              module_name         - Caller's module name
28895b482a8SLen Brown  *              component_id        - Caller's component ID
289*ba494beeSBob Moore  *              pointer             - Pointer to display
29095b482a8SLen Brown  *
29195b482a8SLen Brown  * RETURN:      None
29295b482a8SLen Brown  *
29395b482a8SLen Brown  * DESCRIPTION: Function entry trace.  Prints only if TRACE_FUNCTIONS bit is
29495b482a8SLen Brown  *              set in debug_level
29595b482a8SLen Brown  *
29695b482a8SLen Brown  ******************************************************************************/
29795b482a8SLen Brown void
29895b482a8SLen Brown acpi_ut_trace_ptr(u32 line_number,
29995b482a8SLen Brown 		  const char *function_name,
30095b482a8SLen Brown 		  const char *module_name, u32 component_id, void *pointer)
30195b482a8SLen Brown {
30295b482a8SLen Brown 	acpi_gbl_nesting_level++;
30395b482a8SLen Brown 	acpi_ut_track_stack_ptr();
30495b482a8SLen Brown 
30595b482a8SLen Brown 	acpi_debug_print(ACPI_LV_FUNCTIONS,
30695b482a8SLen Brown 			 line_number, function_name, module_name, component_id,
30795b482a8SLen Brown 			 "%s %p\n", acpi_gbl_fn_entry_str, pointer);
30895b482a8SLen Brown }
30995b482a8SLen Brown 
31095b482a8SLen Brown /*******************************************************************************
31195b482a8SLen Brown  *
31295b482a8SLen Brown  * FUNCTION:    acpi_ut_trace_str
31395b482a8SLen Brown  *
31495b482a8SLen Brown  * PARAMETERS:  line_number         - Caller's line number
31595b482a8SLen Brown  *              function_name       - Caller's procedure name
31695b482a8SLen Brown  *              module_name         - Caller's module name
31795b482a8SLen Brown  *              component_id        - Caller's component ID
318*ba494beeSBob Moore  *              string              - Additional string to display
31995b482a8SLen Brown  *
32095b482a8SLen Brown  * RETURN:      None
32195b482a8SLen Brown  *
32295b482a8SLen Brown  * DESCRIPTION: Function entry trace.  Prints only if TRACE_FUNCTIONS bit is
32395b482a8SLen Brown  *              set in debug_level
32495b482a8SLen Brown  *
32595b482a8SLen Brown  ******************************************************************************/
32695b482a8SLen Brown 
32795b482a8SLen Brown void
32895b482a8SLen Brown acpi_ut_trace_str(u32 line_number,
32995b482a8SLen Brown 		  const char *function_name,
33095b482a8SLen Brown 		  const char *module_name, u32 component_id, char *string)
33195b482a8SLen Brown {
33295b482a8SLen Brown 
33395b482a8SLen Brown 	acpi_gbl_nesting_level++;
33495b482a8SLen Brown 	acpi_ut_track_stack_ptr();
33595b482a8SLen Brown 
33695b482a8SLen Brown 	acpi_debug_print(ACPI_LV_FUNCTIONS,
33795b482a8SLen Brown 			 line_number, function_name, module_name, component_id,
33895b482a8SLen Brown 			 "%s %s\n", acpi_gbl_fn_entry_str, string);
33995b482a8SLen Brown }
34095b482a8SLen Brown 
34195b482a8SLen Brown /*******************************************************************************
34295b482a8SLen Brown  *
34395b482a8SLen Brown  * FUNCTION:    acpi_ut_trace_u32
34495b482a8SLen Brown  *
34595b482a8SLen Brown  * PARAMETERS:  line_number         - Caller's line number
34695b482a8SLen Brown  *              function_name       - Caller's procedure name
34795b482a8SLen Brown  *              module_name         - Caller's module name
34895b482a8SLen Brown  *              component_id        - Caller's component ID
349*ba494beeSBob Moore  *              integer             - Integer to display
35095b482a8SLen Brown  *
35195b482a8SLen Brown  * RETURN:      None
35295b482a8SLen Brown  *
35395b482a8SLen Brown  * DESCRIPTION: Function entry trace.  Prints only if TRACE_FUNCTIONS bit is
35495b482a8SLen Brown  *              set in debug_level
35595b482a8SLen Brown  *
35695b482a8SLen Brown  ******************************************************************************/
35795b482a8SLen Brown 
35895b482a8SLen Brown void
35995b482a8SLen Brown acpi_ut_trace_u32(u32 line_number,
36095b482a8SLen Brown 		  const char *function_name,
36195b482a8SLen Brown 		  const char *module_name, u32 component_id, u32 integer)
36295b482a8SLen Brown {
36395b482a8SLen Brown 
36495b482a8SLen Brown 	acpi_gbl_nesting_level++;
36595b482a8SLen Brown 	acpi_ut_track_stack_ptr();
36695b482a8SLen Brown 
36795b482a8SLen Brown 	acpi_debug_print(ACPI_LV_FUNCTIONS,
36895b482a8SLen Brown 			 line_number, function_name, module_name, component_id,
36995b482a8SLen Brown 			 "%s %08X\n", acpi_gbl_fn_entry_str, integer);
37095b482a8SLen Brown }
37195b482a8SLen Brown 
37295b482a8SLen Brown /*******************************************************************************
37395b482a8SLen Brown  *
37495b482a8SLen Brown  * FUNCTION:    acpi_ut_exit
37595b482a8SLen Brown  *
37695b482a8SLen Brown  * PARAMETERS:  line_number         - Caller's line number
37795b482a8SLen Brown  *              function_name       - Caller's procedure name
37895b482a8SLen Brown  *              module_name         - Caller's module name
37995b482a8SLen Brown  *              component_id        - Caller's component ID
38095b482a8SLen Brown  *
38195b482a8SLen Brown  * RETURN:      None
38295b482a8SLen Brown  *
38395b482a8SLen Brown  * DESCRIPTION: Function exit trace.  Prints only if TRACE_FUNCTIONS bit is
38495b482a8SLen Brown  *              set in debug_level
38595b482a8SLen Brown  *
38695b482a8SLen Brown  ******************************************************************************/
38795b482a8SLen Brown 
38895b482a8SLen Brown void
38995b482a8SLen Brown acpi_ut_exit(u32 line_number,
39095b482a8SLen Brown 	     const char *function_name,
39195b482a8SLen Brown 	     const char *module_name, u32 component_id)
39295b482a8SLen Brown {
39395b482a8SLen Brown 
39495b482a8SLen Brown 	acpi_debug_print(ACPI_LV_FUNCTIONS,
39595b482a8SLen Brown 			 line_number, function_name, module_name, component_id,
39695b482a8SLen Brown 			 "%s\n", acpi_gbl_fn_exit_str);
39795b482a8SLen Brown 
39895b482a8SLen Brown 	acpi_gbl_nesting_level--;
39995b482a8SLen Brown }
40095b482a8SLen Brown 
40195b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_ut_exit)
40295b482a8SLen Brown 
40395b482a8SLen Brown /*******************************************************************************
40495b482a8SLen Brown  *
40595b482a8SLen Brown  * FUNCTION:    acpi_ut_status_exit
40695b482a8SLen Brown  *
40795b482a8SLen Brown  * PARAMETERS:  line_number         - Caller's line number
40895b482a8SLen Brown  *              function_name       - Caller's procedure name
40995b482a8SLen Brown  *              module_name         - Caller's module name
41095b482a8SLen Brown  *              component_id        - Caller's component ID
411*ba494beeSBob Moore  *              status              - Exit status code
41295b482a8SLen Brown  *
41395b482a8SLen Brown  * RETURN:      None
41495b482a8SLen Brown  *
41595b482a8SLen Brown  * DESCRIPTION: Function exit trace.  Prints only if TRACE_FUNCTIONS bit is
41695b482a8SLen Brown  *              set in debug_level. Prints exit status also.
41795b482a8SLen Brown  *
41895b482a8SLen Brown  ******************************************************************************/
41995b482a8SLen Brown void
42095b482a8SLen Brown acpi_ut_status_exit(u32 line_number,
42195b482a8SLen Brown 		    const char *function_name,
42295b482a8SLen Brown 		    const char *module_name,
42395b482a8SLen Brown 		    u32 component_id, acpi_status status)
42495b482a8SLen Brown {
42595b482a8SLen Brown 
42695b482a8SLen Brown 	if (ACPI_SUCCESS(status)) {
42795b482a8SLen Brown 		acpi_debug_print(ACPI_LV_FUNCTIONS,
42895b482a8SLen Brown 				 line_number, function_name, module_name,
42995b482a8SLen Brown 				 component_id, "%s %s\n", acpi_gbl_fn_exit_str,
43095b482a8SLen Brown 				 acpi_format_exception(status));
43195b482a8SLen Brown 	} else {
43295b482a8SLen Brown 		acpi_debug_print(ACPI_LV_FUNCTIONS,
43395b482a8SLen Brown 				 line_number, function_name, module_name,
43495b482a8SLen Brown 				 component_id, "%s ****Exception****: %s\n",
43595b482a8SLen Brown 				 acpi_gbl_fn_exit_str,
43695b482a8SLen Brown 				 acpi_format_exception(status));
43795b482a8SLen Brown 	}
43895b482a8SLen Brown 
43995b482a8SLen Brown 	acpi_gbl_nesting_level--;
44095b482a8SLen Brown }
44195b482a8SLen Brown 
44295b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_ut_status_exit)
44395b482a8SLen Brown 
44495b482a8SLen Brown /*******************************************************************************
44595b482a8SLen Brown  *
44695b482a8SLen Brown  * FUNCTION:    acpi_ut_value_exit
44795b482a8SLen Brown  *
44895b482a8SLen Brown  * PARAMETERS:  line_number         - Caller's line number
44995b482a8SLen Brown  *              function_name       - Caller's procedure name
45095b482a8SLen Brown  *              module_name         - Caller's module name
45195b482a8SLen Brown  *              component_id        - Caller's component ID
452*ba494beeSBob Moore  *              value               - Value to be printed with exit msg
45395b482a8SLen Brown  *
45495b482a8SLen Brown  * RETURN:      None
45595b482a8SLen Brown  *
45695b482a8SLen Brown  * DESCRIPTION: Function exit trace.  Prints only if TRACE_FUNCTIONS bit is
45795b482a8SLen Brown  *              set in debug_level. Prints exit value also.
45895b482a8SLen Brown  *
45995b482a8SLen Brown  ******************************************************************************/
46095b482a8SLen Brown void
46195b482a8SLen Brown acpi_ut_value_exit(u32 line_number,
46295b482a8SLen Brown 		   const char *function_name,
4635df7e6cbSBob Moore 		   const char *module_name, u32 component_id, u64 value)
46495b482a8SLen Brown {
46595b482a8SLen Brown 
46695b482a8SLen Brown 	acpi_debug_print(ACPI_LV_FUNCTIONS,
46795b482a8SLen Brown 			 line_number, function_name, module_name, component_id,
46895b482a8SLen Brown 			 "%s %8.8X%8.8X\n", acpi_gbl_fn_exit_str,
46995b482a8SLen Brown 			 ACPI_FORMAT_UINT64(value));
47095b482a8SLen Brown 
47195b482a8SLen Brown 	acpi_gbl_nesting_level--;
47295b482a8SLen Brown }
47395b482a8SLen Brown 
47495b482a8SLen Brown ACPI_EXPORT_SYMBOL(acpi_ut_value_exit)
47595b482a8SLen Brown 
47695b482a8SLen Brown /*******************************************************************************
47795b482a8SLen Brown  *
47895b482a8SLen Brown  * FUNCTION:    acpi_ut_ptr_exit
47995b482a8SLen Brown  *
48095b482a8SLen Brown  * PARAMETERS:  line_number         - Caller's line number
48195b482a8SLen Brown  *              function_name       - Caller's procedure name
48295b482a8SLen Brown  *              module_name         - Caller's module name
48395b482a8SLen Brown  *              component_id        - Caller's component ID
484*ba494beeSBob Moore  *              ptr                 - Pointer to display
48595b482a8SLen Brown  *
48695b482a8SLen Brown  * RETURN:      None
48795b482a8SLen Brown  *
48895b482a8SLen Brown  * DESCRIPTION: Function exit trace.  Prints only if TRACE_FUNCTIONS bit is
48995b482a8SLen Brown  *              set in debug_level. Prints exit value also.
49095b482a8SLen Brown  *
49195b482a8SLen Brown  ******************************************************************************/
49295b482a8SLen Brown void
49395b482a8SLen Brown acpi_ut_ptr_exit(u32 line_number,
49495b482a8SLen Brown 		 const char *function_name,
49595b482a8SLen Brown 		 const char *module_name, u32 component_id, u8 *ptr)
49695b482a8SLen Brown {
49795b482a8SLen Brown 
49895b482a8SLen Brown 	acpi_debug_print(ACPI_LV_FUNCTIONS,
49995b482a8SLen Brown 			 line_number, function_name, module_name, component_id,
50095b482a8SLen Brown 			 "%s %p\n", acpi_gbl_fn_exit_str, ptr);
50195b482a8SLen Brown 
50295b482a8SLen Brown 	acpi_gbl_nesting_level--;
50395b482a8SLen Brown }
50495b482a8SLen Brown 
50595b482a8SLen Brown #endif
50695b482a8SLen Brown 
50795b482a8SLen Brown /*******************************************************************************
50895b482a8SLen Brown  *
50995b482a8SLen Brown  * FUNCTION:    acpi_ut_dump_buffer
51095b482a8SLen Brown  *
511*ba494beeSBob Moore  * PARAMETERS:  buffer              - Buffer to dump
512*ba494beeSBob Moore  *              count               - Amount to dump, in bytes
513*ba494beeSBob Moore  *              display             - BYTE, WORD, DWORD, or QWORD display
514*ba494beeSBob Moore  *              component_ID        - Caller's component ID
51595b482a8SLen Brown  *
51695b482a8SLen Brown  * RETURN:      None
51795b482a8SLen Brown  *
51895b482a8SLen Brown  * DESCRIPTION: Generic dump buffer in both hex and ascii.
51995b482a8SLen Brown  *
52095b482a8SLen Brown  ******************************************************************************/
52195b482a8SLen Brown 
52295b482a8SLen Brown void acpi_ut_dump_buffer2(u8 * buffer, u32 count, u32 display)
52395b482a8SLen Brown {
52495b482a8SLen Brown 	u32 i = 0;
52595b482a8SLen Brown 	u32 j;
52695b482a8SLen Brown 	u32 temp32;
52795b482a8SLen Brown 	u8 buf_char;
52895b482a8SLen Brown 
52995b482a8SLen Brown 	if (!buffer) {
53095b482a8SLen Brown 		acpi_os_printf("Null Buffer Pointer in DumpBuffer!\n");
53195b482a8SLen Brown 		return;
53295b482a8SLen Brown 	}
53395b482a8SLen Brown 
53495b482a8SLen Brown 	if ((count < 4) || (count & 0x01)) {
53595b482a8SLen Brown 		display = DB_BYTE_DISPLAY;
53695b482a8SLen Brown 	}
53795b482a8SLen Brown 
53895b482a8SLen Brown 	/* Nasty little dump buffer routine! */
53995b482a8SLen Brown 
54095b482a8SLen Brown 	while (i < count) {
54195b482a8SLen Brown 
54295b482a8SLen Brown 		/* Print current offset */
54395b482a8SLen Brown 
54495b482a8SLen Brown 		acpi_os_printf("%6.4X: ", i);
54595b482a8SLen Brown 
54695b482a8SLen Brown 		/* Print 16 hex chars */
54795b482a8SLen Brown 
54895b482a8SLen Brown 		for (j = 0; j < 16;) {
54995b482a8SLen Brown 			if (i + j >= count) {
55095b482a8SLen Brown 
55195b482a8SLen Brown 				/* Dump fill spaces */
55295b482a8SLen Brown 
55395b482a8SLen Brown 				acpi_os_printf("%*s", ((display * 2) + 1), " ");
55495b482a8SLen Brown 				j += display;
55595b482a8SLen Brown 				continue;
55695b482a8SLen Brown 			}
55795b482a8SLen Brown 
55895b482a8SLen Brown 			switch (display) {
55995b482a8SLen Brown 			case DB_BYTE_DISPLAY:
56095b482a8SLen Brown 			default:	/* Default is BYTE display */
56195b482a8SLen Brown 
56295b482a8SLen Brown 				acpi_os_printf("%02X ",
56395b482a8SLen Brown 					       buffer[(acpi_size) i + j]);
56495b482a8SLen Brown 				break;
56595b482a8SLen Brown 
56695b482a8SLen Brown 			case DB_WORD_DISPLAY:
56795b482a8SLen Brown 
56895b482a8SLen Brown 				ACPI_MOVE_16_TO_32(&temp32,
56995b482a8SLen Brown 						   &buffer[(acpi_size) i + j]);
57095b482a8SLen Brown 				acpi_os_printf("%04X ", temp32);
57195b482a8SLen Brown 				break;
57295b482a8SLen Brown 
57395b482a8SLen Brown 			case DB_DWORD_DISPLAY:
57495b482a8SLen Brown 
57595b482a8SLen Brown 				ACPI_MOVE_32_TO_32(&temp32,
57695b482a8SLen Brown 						   &buffer[(acpi_size) i + j]);
57795b482a8SLen Brown 				acpi_os_printf("%08X ", temp32);
57895b482a8SLen Brown 				break;
57995b482a8SLen Brown 
58095b482a8SLen Brown 			case DB_QWORD_DISPLAY:
58195b482a8SLen Brown 
58295b482a8SLen Brown 				ACPI_MOVE_32_TO_32(&temp32,
58395b482a8SLen Brown 						   &buffer[(acpi_size) i + j]);
58495b482a8SLen Brown 				acpi_os_printf("%08X", temp32);
58595b482a8SLen Brown 
58695b482a8SLen Brown 				ACPI_MOVE_32_TO_32(&temp32,
58795b482a8SLen Brown 						   &buffer[(acpi_size) i + j +
58895b482a8SLen Brown 							   4]);
58995b482a8SLen Brown 				acpi_os_printf("%08X ", temp32);
59095b482a8SLen Brown 				break;
59195b482a8SLen Brown 			}
59295b482a8SLen Brown 
59395b482a8SLen Brown 			j += display;
59495b482a8SLen Brown 		}
59595b482a8SLen Brown 
59695b482a8SLen Brown 		/*
59795b482a8SLen Brown 		 * Print the ASCII equivalent characters but watch out for the bad
59895b482a8SLen Brown 		 * unprintable ones (printable chars are 0x20 through 0x7E)
59995b482a8SLen Brown 		 */
60095b482a8SLen Brown 		acpi_os_printf(" ");
60195b482a8SLen Brown 		for (j = 0; j < 16; j++) {
60295b482a8SLen Brown 			if (i + j >= count) {
60395b482a8SLen Brown 				acpi_os_printf("\n");
60495b482a8SLen Brown 				return;
60595b482a8SLen Brown 			}
60695b482a8SLen Brown 
60795b482a8SLen Brown 			buf_char = buffer[(acpi_size) i + j];
60895b482a8SLen Brown 			if (ACPI_IS_PRINT(buf_char)) {
60995b482a8SLen Brown 				acpi_os_printf("%c", buf_char);
61095b482a8SLen Brown 			} else {
61195b482a8SLen Brown 				acpi_os_printf(".");
61295b482a8SLen Brown 			}
61395b482a8SLen Brown 		}
61495b482a8SLen Brown 
61595b482a8SLen Brown 		/* Done with that line. */
61695b482a8SLen Brown 
61795b482a8SLen Brown 		acpi_os_printf("\n");
61895b482a8SLen Brown 		i += 16;
61995b482a8SLen Brown 	}
62095b482a8SLen Brown 
62195b482a8SLen Brown 	return;
62295b482a8SLen Brown }
62395b482a8SLen Brown 
62495b482a8SLen Brown /*******************************************************************************
62595b482a8SLen Brown  *
62695b482a8SLen Brown  * FUNCTION:    acpi_ut_dump_buffer
62795b482a8SLen Brown  *
628*ba494beeSBob Moore  * PARAMETERS:  buffer              - Buffer to dump
629*ba494beeSBob Moore  *              count               - Amount to dump, in bytes
630*ba494beeSBob Moore  *              display             - BYTE, WORD, DWORD, or QWORD display
631*ba494beeSBob Moore  *              component_ID        - Caller's component ID
63295b482a8SLen Brown  *
63395b482a8SLen Brown  * RETURN:      None
63495b482a8SLen Brown  *
63595b482a8SLen Brown  * DESCRIPTION: Generic dump buffer in both hex and ascii.
63695b482a8SLen Brown  *
63795b482a8SLen Brown  ******************************************************************************/
63895b482a8SLen Brown 
63995b482a8SLen Brown void acpi_ut_dump_buffer(u8 * buffer, u32 count, u32 display, u32 component_id)
64095b482a8SLen Brown {
64195b482a8SLen Brown 
64295b482a8SLen Brown 	/* Only dump the buffer if tracing is enabled */
64395b482a8SLen Brown 
64495b482a8SLen Brown 	if (!((ACPI_LV_TABLES & acpi_dbg_level) &&
64595b482a8SLen Brown 	      (component_id & acpi_dbg_layer))) {
64695b482a8SLen Brown 		return;
64795b482a8SLen Brown 	}
64895b482a8SLen Brown 
64995b482a8SLen Brown 	acpi_ut_dump_buffer2(buffer, count, display);
65095b482a8SLen Brown }
651