Linux Audio

Check our new training course

Loading...
v6.8
  1// SPDX-License-Identifier: GPL-2.0
  2/* For general debugging purposes */
  3
  4#include <inttypes.h>
 
  5#include <string.h>
  6#include <stdarg.h>
  7#include <stdio.h>
  8#include <stdlib.h>
  9#include <sys/wait.h>
 10#include <api/debug.h>
 11#include <linux/kernel.h>
 12#include <linux/time64.h>
 13#include <sys/time.h>
 14#ifdef HAVE_BACKTRACE_SUPPORT
 15#include <execinfo.h>
 16#endif
 17#include "color.h"
 18#include "event.h"
 19#include "debug.h"
 20#include "print_binary.h"
 21#include "target.h"
 22#include "trace-event.h"
 23#include "ui/helpline.h"
 24#include "ui/ui.h"
 25#include "util/parse-sublevel-options.h"
 26
 27#include <linux/ctype.h>
 28
 29#ifdef HAVE_LIBTRACEEVENT
 30#include <traceevent/event-parse.h>
 31#else
 32#define LIBTRACEEVENT_VERSION 0
 33#endif
 34
 35int verbose;
 36int debug_peo_args;
 37bool dump_trace = false, quiet = false;
 38int debug_ordered_events;
 39static int redirect_to_stderr;
 40int debug_data_convert;
 41static FILE *_debug_file;
 42bool debug_display_time;
 43
 44FILE *debug_file(void)
 45{
 46	if (!_debug_file) {
 47		pr_warning_once("debug_file not set");
 48		debug_set_file(stderr);
 49	}
 50	return _debug_file;
 51}
 52
 53void debug_set_file(FILE *file)
 54{
 55	_debug_file = file;
 56}
 57
 58void debug_set_display_time(bool set)
 59{
 60	debug_display_time = set;
 61}
 62
 63static int fprintf_time(FILE *file)
 64{
 65	struct timeval tod;
 66	struct tm ltime;
 67	char date[64];
 68
 69	if (!debug_display_time)
 70		return 0;
 71
 72	if (gettimeofday(&tod, NULL) != 0)
 73		return 0;
 74
 75	if (localtime_r(&tod.tv_sec, &ltime) == NULL)
 76		return 0;
 77
 78	strftime(date, sizeof(date),  "%F %H:%M:%S", &ltime);
 79	return fprintf(file, "[%s.%06lu] ", date, (long)tod.tv_usec);
 80}
 81
 82int veprintf(int level, int var, const char *fmt, va_list args)
 83{
 84	int ret = 0;
 85
 86	if (var >= level) {
 87		if (use_browser >= 1 && !redirect_to_stderr) {
 88			ui_helpline__vshow(fmt, args);
 89		} else {
 90			ret = fprintf_time(debug_file());
 91			ret += vfprintf(debug_file(), fmt, args);
 92		}
 93	}
 94
 95	return ret;
 96}
 97
 98int eprintf(int level, int var, const char *fmt, ...)
 99{
100	va_list args;
101	int ret;
102
103	va_start(args, fmt);
104	ret = veprintf(level, var, fmt, args);
105	va_end(args);
106
107	return ret;
108}
109
110static int veprintf_time(u64 t, const char *fmt, va_list args)
111{
112	int ret = 0;
113	u64 secs, usecs, nsecs = t;
114
115	secs   = nsecs / NSEC_PER_SEC;
116	nsecs -= secs  * NSEC_PER_SEC;
117	usecs  = nsecs / NSEC_PER_USEC;
118
119	ret = fprintf(debug_file(), "[%13" PRIu64 ".%06" PRIu64 "] ", secs, usecs);
120	ret += vfprintf(debug_file(), fmt, args);
 
121	return ret;
122}
123
124int eprintf_time(int level, int var, u64 t, const char *fmt, ...)
125{
126	int ret = 0;
127	va_list args;
128
129	if (var >= level) {
130		va_start(args, fmt);
131		ret = veprintf_time(t, fmt, args);
132		va_end(args);
133	}
134
135	return ret;
136}
137
138/*
139 * Overloading libtraceevent standard info print
140 * function, display with -v in perf.
141 */
142void pr_stat(const char *fmt, ...)
143{
144	va_list args;
145
146	va_start(args, fmt);
147	veprintf(1, verbose, fmt, args);
148	va_end(args);
149	eprintf(1, verbose, "\n");
150}
151
152int dump_printf(const char *fmt, ...)
153{
154	va_list args;
155	int ret = 0;
156
157	if (dump_trace) {
158		va_start(args, fmt);
159		ret = vprintf(fmt, args);
160		va_end(args);
161	}
162
163	return ret;
164}
165
166static int trace_event_printer(enum binary_printer_ops op,
167			       unsigned int val, void *extra, FILE *fp)
168{
169	const char *color = PERF_COLOR_BLUE;
170	union perf_event *event = (union perf_event *)extra;
171	unsigned char ch = (unsigned char)val;
172	int printed = 0;
173
174	switch (op) {
175	case BINARY_PRINT_DATA_BEGIN:
176		printed += fprintf(fp, ".");
177		printed += color_fprintf(fp, color, "\n. ... raw event: size %d bytes\n",
178					 event->header.size);
179		break;
180	case BINARY_PRINT_LINE_BEGIN:
181		printed += fprintf(fp, ".");
182		break;
183	case BINARY_PRINT_ADDR:
184		printed += color_fprintf(fp, color, "  %04x: ", val);
185		break;
186	case BINARY_PRINT_NUM_DATA:
187		printed += color_fprintf(fp, color, " %02x", val);
188		break;
189	case BINARY_PRINT_NUM_PAD:
190		printed += color_fprintf(fp, color, "   ");
191		break;
192	case BINARY_PRINT_SEP:
193		printed += color_fprintf(fp, color, "  ");
194		break;
195	case BINARY_PRINT_CHAR_DATA:
196		printed += color_fprintf(fp, color, "%c",
197			      isprint(ch) && isascii(ch) ? ch : '.');
198		break;
199	case BINARY_PRINT_CHAR_PAD:
200		printed += color_fprintf(fp, color, " ");
201		break;
202	case BINARY_PRINT_LINE_END:
203		printed += color_fprintf(fp, color, "\n");
204		break;
205	case BINARY_PRINT_DATA_END:
206		printed += fprintf(fp, "\n");
207		break;
208	default:
209		break;
210	}
211
212	return printed;
213}
214
215void trace_event(union perf_event *event)
216{
217	unsigned char *raw_event = (void *)event;
218
219	if (!dump_trace)
220		return;
221
222	print_binary(raw_event, event->header.size, 16,
223		     trace_event_printer, event);
224}
225
226static struct sublevel_option debug_opts[] = {
227	{ .name = "verbose",		.value_ptr = &verbose },
228	{ .name = "ordered-events",	.value_ptr = &debug_ordered_events},
229	{ .name = "stderr",		.value_ptr = &redirect_to_stderr},
230	{ .name = "data-convert",	.value_ptr = &debug_data_convert },
231	{ .name = "perf-event-open",	.value_ptr = &debug_peo_args },
 
 
232	{ .name = NULL, }
233};
234
235int perf_debug_option(const char *str)
236{
237	int ret;
 
 
238
239	ret = perf_parse_sublevel_options(str, debug_opts);
240	if (ret)
241		return ret;
242
243	/* Allow only verbose value in range (0, 10), otherwise set 0. */
244	verbose = (verbose < 0) || (verbose > 10) ? 0 : verbose;
245
246#if LIBTRACEEVENT_VERSION >= MAKE_LIBTRACEEVENT_VERSION(1, 3, 0)
247	if (verbose == 1)
248		tep_set_loglevel(TEP_LOG_INFO);
249	else if (verbose == 2)
250		tep_set_loglevel(TEP_LOG_DEBUG);
251	else if (verbose >= 3)
252		tep_set_loglevel(TEP_LOG_ALL);
253#endif
254	return 0;
255}
256
257int perf_quiet_option(void)
258{
259	struct sublevel_option *opt = &debug_opts[0];
 
 
260
261	/* disable all debug messages */
262	while (opt->name) {
263		*opt->value_ptr = -1;
264		opt++;
265	}
266
267	/* For debug variables that are used as bool types, set to 0. */
268	redirect_to_stderr = 0;
269	debug_peo_args = 0;
 
 
 
 
 
270
 
 
271	return 0;
272}
273
274#define DEBUG_WRAPPER(__n, __l)				\
275static int pr_ ## __n ## _wrapper(const char *fmt, ...)	\
276{							\
277	va_list args;					\
278	int ret;					\
279							\
280	va_start(args, fmt);				\
281	ret = veprintf(__l, verbose, fmt, args);	\
282	va_end(args);					\
283	return ret;					\
284}
285
286DEBUG_WRAPPER(warning, 0);
287DEBUG_WRAPPER(debug, 1);
288
289void perf_debug_setup(void)
290{
291	debug_set_file(stderr);
292	libapi_set_print(pr_warning_wrapper, pr_warning_wrapper, pr_debug_wrapper);
293}
294
295/* Obtain a backtrace and print it to stdout. */
296#ifdef HAVE_BACKTRACE_SUPPORT
297void dump_stack(void)
298{
299	void *array[16];
300	size_t size = backtrace(array, ARRAY_SIZE(array));
301	char **strings = backtrace_symbols(array, size);
302	size_t i;
303
304	printf("Obtained %zd stack frames.\n", size);
305
306	for (i = 0; i < size; i++)
307		printf("%s\n", strings[i]);
308
309	free(strings);
310}
311#else
312void dump_stack(void) {}
313#endif
314
315void sighandler_dump_stack(int sig)
316{
317	psignal(sig, "perf");
318	dump_stack();
319	signal(sig, SIG_DFL);
320	raise(sig);
321}
v4.10.11
 
  1/* For general debugging purposes */
  2
  3#include "../perf.h"
  4
  5#include <string.h>
  6#include <stdarg.h>
  7#include <stdio.h>
 
 
  8#include <api/debug.h>
 
  9#include <linux/time64.h>
 10
 11#include "cache.h"
 
 
 12#include "color.h"
 13#include "event.h"
 14#include "debug.h"
 15#include "util.h"
 16#include "target.h"
 
 
 
 
 
 
 
 
 
 
 
 
 17
 18int verbose;
 
 19bool dump_trace = false, quiet = false;
 20int debug_ordered_events;
 21static int redirect_to_stderr;
 22int debug_data_convert;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 23
 24int veprintf(int level, int var, const char *fmt, va_list args)
 25{
 26	int ret = 0;
 27
 28	if (var >= level) {
 29		if (use_browser >= 1 && !redirect_to_stderr)
 30			ui_helpline__vshow(fmt, args);
 31		else
 32			ret = vfprintf(stderr, fmt, args);
 
 
 33	}
 34
 35	return ret;
 36}
 37
 38int eprintf(int level, int var, const char *fmt, ...)
 39{
 40	va_list args;
 41	int ret;
 42
 43	va_start(args, fmt);
 44	ret = veprintf(level, var, fmt, args);
 45	va_end(args);
 46
 47	return ret;
 48}
 49
 50static int veprintf_time(u64 t, const char *fmt, va_list args)
 51{
 52	int ret = 0;
 53	u64 secs, usecs, nsecs = t;
 54
 55	secs   = nsecs / NSEC_PER_SEC;
 56	nsecs -= secs  * NSEC_PER_SEC;
 57	usecs  = nsecs / NSEC_PER_USEC;
 58
 59	ret = fprintf(stderr, "[%13" PRIu64 ".%06" PRIu64 "] ",
 60		      secs, usecs);
 61	ret += vfprintf(stderr, fmt, args);
 62	return ret;
 63}
 64
 65int eprintf_time(int level, int var, u64 t, const char *fmt, ...)
 66{
 67	int ret = 0;
 68	va_list args;
 69
 70	if (var >= level) {
 71		va_start(args, fmt);
 72		ret = veprintf_time(t, fmt, args);
 73		va_end(args);
 74	}
 75
 76	return ret;
 77}
 78
 79/*
 80 * Overloading libtraceevent standard info print
 81 * function, display with -v in perf.
 82 */
 83void pr_stat(const char *fmt, ...)
 84{
 85	va_list args;
 86
 87	va_start(args, fmt);
 88	veprintf(1, verbose, fmt, args);
 89	va_end(args);
 90	eprintf(1, verbose, "\n");
 91}
 92
 93int dump_printf(const char *fmt, ...)
 94{
 95	va_list args;
 96	int ret = 0;
 97
 98	if (dump_trace) {
 99		va_start(args, fmt);
100		ret = vprintf(fmt, args);
101		va_end(args);
102	}
103
104	return ret;
105}
106
107static void trace_event_printer(enum binary_printer_ops op,
108				unsigned int val, void *extra)
109{
110	const char *color = PERF_COLOR_BLUE;
111	union perf_event *event = (union perf_event *)extra;
112	unsigned char ch = (unsigned char)val;
 
113
114	switch (op) {
115	case BINARY_PRINT_DATA_BEGIN:
116		printf(".");
117		color_fprintf(stdout, color, "\n. ... raw event: size %d bytes\n",
118				event->header.size);
119		break;
120	case BINARY_PRINT_LINE_BEGIN:
121		printf(".");
122		break;
123	case BINARY_PRINT_ADDR:
124		color_fprintf(stdout, color, "  %04x: ", val);
125		break;
126	case BINARY_PRINT_NUM_DATA:
127		color_fprintf(stdout, color, " %02x", val);
128		break;
129	case BINARY_PRINT_NUM_PAD:
130		color_fprintf(stdout, color, "   ");
131		break;
132	case BINARY_PRINT_SEP:
133		color_fprintf(stdout, color, "  ");
134		break;
135	case BINARY_PRINT_CHAR_DATA:
136		color_fprintf(stdout, color, "%c",
137			      isprint(ch) ? ch : '.');
138		break;
139	case BINARY_PRINT_CHAR_PAD:
140		color_fprintf(stdout, color, " ");
141		break;
142	case BINARY_PRINT_LINE_END:
143		color_fprintf(stdout, color, "\n");
144		break;
145	case BINARY_PRINT_DATA_END:
146		printf("\n");
147		break;
148	default:
149		break;
150	}
 
 
151}
152
153void trace_event(union perf_event *event)
154{
155	unsigned char *raw_event = (void *)event;
156
157	if (!dump_trace)
158		return;
159
160	print_binary(raw_event, event->header.size, 16,
161		     trace_event_printer, event);
162}
163
164static struct debug_variable {
165	const char *name;
166	int *ptr;
167} debug_variables[] = {
168	{ .name = "verbose",		.ptr = &verbose },
169	{ .name = "ordered-events",	.ptr = &debug_ordered_events},
170	{ .name = "stderr",		.ptr = &redirect_to_stderr},
171	{ .name = "data-convert",	.ptr = &debug_data_convert },
172	{ .name = NULL, }
173};
174
175int perf_debug_option(const char *str)
176{
177	struct debug_variable *var = &debug_variables[0];
178	char *vstr, *s = strdup(str);
179	int v = 1;
180
181	vstr = strchr(s, '=');
182	if (vstr)
183		*vstr++ = 0;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
184
185	while (var->name) {
186		if (!strcmp(s, var->name))
187			break;
188		var++;
189	}
190
191	if (!var->name) {
192		pr_err("Unknown debug variable name '%s'\n", s);
193		free(s);
194		return -1;
195	}
196
197	if (vstr) {
198		v = atoi(vstr);
199		/*
200		 * Allow only values in range (0, 10),
201		 * otherwise set 0.
202		 */
203		v = (v < 0) || (v > 10) ? 0 : v;
204	}
205
206	*var->ptr = v;
207	free(s);
208	return 0;
209}
210
211#define DEBUG_WRAPPER(__n, __l)				\
212static int pr_ ## __n ## _wrapper(const char *fmt, ...)	\
213{							\
214	va_list args;					\
215	int ret;					\
216							\
217	va_start(args, fmt);				\
218	ret = veprintf(__l, verbose, fmt, args);	\
219	va_end(args);					\
220	return ret;					\
221}
222
223DEBUG_WRAPPER(warning, 0);
224DEBUG_WRAPPER(debug, 1);
225
226void perf_debug_setup(void)
227{
 
228	libapi_set_print(pr_warning_wrapper, pr_warning_wrapper, pr_debug_wrapper);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
229}