xref: /linux/tools/perf/util/debug.h (revision 6fdcba32711044c35c0e1b094cbd8f3f0b4472c9)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /* For debugging general purposes */
3 #ifndef __PERF_DEBUG_H
4 #define __PERF_DEBUG_H
5 
6 #include <stdarg.h>
7 #include <stdbool.h>
8 #include <linux/compiler.h>
9 
10 extern int verbose;
11 extern int debug_peo_args;
12 extern bool quiet, dump_trace;
13 extern int debug_ordered_events;
14 extern int debug_data_convert;
15 
16 #ifndef pr_fmt
17 #define pr_fmt(fmt) fmt
18 #endif
19 
20 #define pr_err(fmt, ...) \
21 	eprintf(0, verbose, pr_fmt(fmt), ##__VA_ARGS__)
22 #define pr_warning(fmt, ...) \
23 	eprintf(0, verbose, pr_fmt(fmt), ##__VA_ARGS__)
24 #define pr_info(fmt, ...) \
25 	eprintf(0, verbose, pr_fmt(fmt), ##__VA_ARGS__)
26 #define pr_debug(fmt, ...) \
27 	eprintf(1, verbose, pr_fmt(fmt), ##__VA_ARGS__)
28 #define pr_debugN(n, fmt, ...) \
29 	eprintf(n, verbose, pr_fmt(fmt), ##__VA_ARGS__)
30 #define pr_debug2(fmt, ...) pr_debugN(2, pr_fmt(fmt), ##__VA_ARGS__)
31 #define pr_debug3(fmt, ...) pr_debugN(3, pr_fmt(fmt), ##__VA_ARGS__)
32 #define pr_debug4(fmt, ...) pr_debugN(4, pr_fmt(fmt), ##__VA_ARGS__)
33 
34 /* Special macro to print perf_event_open arguments/return value. */
35 #define pr_debug2_peo(fmt, ...) {				\
36 	if (debug_peo_args)						\
37 		pr_debugN(0, pr_fmt(fmt), ##__VA_ARGS__);	\
38 	else							\
39 		pr_debugN(2, pr_fmt(fmt), ##__VA_ARGS__);	\
40 }
41 
42 #define pr_time_N(n, var, t, fmt, ...) \
43 	eprintf_time(n, var, t, fmt, ##__VA_ARGS__)
44 
45 #define pr_oe_time(t, fmt, ...)  pr_time_N(1, debug_ordered_events, t, pr_fmt(fmt), ##__VA_ARGS__)
46 #define pr_oe_time2(t, fmt, ...) pr_time_N(2, debug_ordered_events, t, pr_fmt(fmt), ##__VA_ARGS__)
47 
48 #define STRERR_BUFSIZE	128	/* For the buffer size of str_error_r */
49 
50 union perf_event;
51 
52 int dump_printf(const char *fmt, ...) __printf(1, 2);
53 void trace_event(union perf_event *event);
54 
55 int ui__error(const char *format, ...) __printf(1, 2);
56 int ui__warning(const char *format, ...) __printf(1, 2);
57 
58 void pr_stat(const char *fmt, ...);
59 
60 int eprintf(int level, int var, const char *fmt, ...) __printf(3, 4);
61 int eprintf_time(int level, int var, u64 t, const char *fmt, ...) __printf(4, 5);
62 int veprintf(int level, int var, const char *fmt, va_list args);
63 
64 int perf_debug_option(const char *str);
65 void perf_debug_setup(void);
66 int perf_quiet_option(void);
67 
68 void dump_stack(void);
69 void sighandler_dump_stack(int sig);
70 
71 #endif	/* __PERF_DEBUG_H */
72