dynamic_debug.c 24.1 KB
Newer Older
1 2 3 4 5 6 7 8 9
/*
 * lib/dynamic_debug.c
 *
 * make pr_debug()/dev_dbg() calls runtime configurable based upon their
 * source module.
 *
 * Copyright (C) 2008 Jason Baron <jbaron@redhat.com>
 * By Greg Banks <gnb@melbourne.sgi.com>
 * Copyright (c) 2008 Silicon Graphics Inc.  All Rights Reserved.
B
Bart Van Assche 已提交
10
 * Copyright (C) 2011 Bart Van Assche.  All Rights Reserved.
11 12
 */

13 14
#define pr_fmt(fmt) KBUILD_MODNAME ":%s: " fmt, __func__

15 16 17 18 19 20 21 22 23 24 25
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/moduleparam.h>
#include <linux/kallsyms.h>
#include <linux/types.h>
#include <linux/mutex.h>
#include <linux/proc_fs.h>
#include <linux/seq_file.h>
#include <linux/list.h>
#include <linux/sysctl.h>
#include <linux/ctype.h>
26
#include <linux/string.h>
27 28 29
#include <linux/uaccess.h>
#include <linux/dynamic_debug.h>
#include <linux/debugfs.h>
30
#include <linux/slab.h>
31
#include <linux/jump_label.h>
B
Bart Van Assche 已提交
32
#include <linux/hardirq.h>
33
#include <linux/sched.h>
34
#include <linux/device.h>
35
#include <linux/netdevice.h>
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62

extern struct _ddebug __start___verbose[];
extern struct _ddebug __stop___verbose[];

struct ddebug_table {
	struct list_head link;
	char *mod_name;
	unsigned int num_ddebugs;
	struct _ddebug *ddebugs;
};

struct ddebug_query {
	const char *filename;
	const char *module;
	const char *function;
	const char *format;
	unsigned int first_lineno, last_lineno;
};

struct ddebug_iter {
	struct ddebug_table *table;
	unsigned int idx;
};

static DEFINE_MUTEX(ddebug_lock);
static LIST_HEAD(ddebug_tables);
static int verbose = 0;
63
module_param(verbose, int, 0644);
64 65 66 67 68 69 70 71

/* Return the last part of a pathname */
static inline const char *basename(const char *path)
{
	const char *tail = strrchr(path, '/');
	return tail ? tail+1 : path;
}

72 73 74 75 76 77 78 79 80 81 82
/* Return the path relative to source root */
static inline const char *trim_prefix(const char *path)
{
	int skip = strlen(__FILE__) - strlen("lib/dynamic_debug.c");

	if (strncmp(path, __FILE__, skip))
		skip = 0; /* prefix mismatch, don't skip */

	return path + skip;
}

B
Bart Van Assche 已提交
83 84 85 86 87 88
static struct { unsigned flag:8; char opt_char; } opt_array[] = {
	{ _DPRINTK_FLAGS_PRINT, 'p' },
	{ _DPRINTK_FLAGS_INCL_MODNAME, 'm' },
	{ _DPRINTK_FLAGS_INCL_FUNCNAME, 'f' },
	{ _DPRINTK_FLAGS_INCL_LINENO, 'l' },
	{ _DPRINTK_FLAGS_INCL_TID, 't' },
89
	{ _DPRINTK_FLAGS_NONE, '_' },
B
Bart Van Assche 已提交
90 91
};

92 93 94 95 96
/* format a string into buf[] which describes the _ddebug's flags */
static char *ddebug_describe_flags(struct _ddebug *dp, char *buf,
				    size_t maxlen)
{
	char *p = buf;
B
Bart Van Assche 已提交
97
	int i;
98

99
	BUG_ON(maxlen < 6);
B
Bart Van Assche 已提交
100 101 102
	for (i = 0; i < ARRAY_SIZE(opt_array); ++i)
		if (dp->flags & opt_array[i].flag)
			*p++ = opt_array[i].opt_char;
103
	if (p == buf)
104
		*p++ = '_';
105 106 107 108 109
	*p = '\0';

	return buf;
}

110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125
#define vpr_info(fmt, ...) \
	if (verbose) do { pr_info(fmt, ##__VA_ARGS__); } while (0)

#define vpr_info_dq(q, msg)					\
do {								\
	/* trim last char off format print */			\
	vpr_info("%s: func=\"%s\" file=\"%s\" "			\
		"module=\"%s\" format=\"%.*s\" "		\
		"lineno=%u-%u",					\
		msg,						\
		q->function ? q->function : "",			\
		q->filename ? q->filename : "",			\
		q->module ? q->module : "",			\
		(int)(q->format ? strlen(q->format) - 1 : 0),	\
		q->format ? q->format : "",			\
		q->first_lineno, q->last_lineno);		\
126 127
} while (0)

128
/*
129 130 131 132
 * Search the tables for _ddebug's which match the given `query' and
 * apply the `flags' and `mask' to them.  Returns number of matching
 * callsites, normally the same as number of changes.  If verbose,
 * logs the changes.  Takes ddebug_lock.
133
 */
134 135
static int ddebug_change(const struct ddebug_query *query,
			unsigned int flags, unsigned int mask)
136 137 138 139 140
{
	int i;
	struct ddebug_table *dt;
	unsigned int newflags;
	unsigned int nfound = 0;
141
	char flagbuf[10];
142 143 144 145 146 147

	/* search for matching ddebugs */
	mutex_lock(&ddebug_lock);
	list_for_each_entry(dt, &ddebug_tables, link) {

		/* match against the module name */
148
		if (query->module && strcmp(query->module, dt->mod_name))
149 150 151 152 153 154
			continue;

		for (i = 0 ; i < dt->num_ddebugs ; i++) {
			struct _ddebug *dp = &dt->ddebugs[i];

			/* match against the source filename */
155
			if (query->filename &&
156
			    strcmp(query->filename, dp->filename) &&
157 158
			    strcmp(query->filename, basename(dp->filename)) &&
			    strcmp(query->filename, trim_prefix(dp->filename)))
159 160 161
				continue;

			/* match against the function */
162
			if (query->function &&
163 164 165 166
			    strcmp(query->function, dp->function))
				continue;

			/* match against the format */
167 168
			if (query->format &&
			    !strstr(dp->format, query->format))
169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184
				continue;

			/* match against the line number range */
			if (query->first_lineno &&
			    dp->lineno < query->first_lineno)
				continue;
			if (query->last_lineno &&
			    dp->lineno > query->last_lineno)
				continue;

			nfound++;

			newflags = (dp->flags & mask) | flags;
			if (newflags == dp->flags)
				continue;
			dp->flags = newflags;
185 186 187 188 189
			vpr_info("changed %s:%d [%s]%s =%s\n",
				trim_prefix(dp->filename), dp->lineno,
				dt->mod_name, dp->function,
				ddebug_describe_flags(dp, flagbuf,
						sizeof(flagbuf)));
190 191 192 193 194
		}
	}
	mutex_unlock(&ddebug_lock);

	if (!nfound && verbose)
195
		pr_info("no matches for query\n");
196 197

	return nfound;
198 199 200 201
}

/*
 * Split the buffer `buf' into space-separated words.
202 203 204
 * Handles simple " and ' quoting, i.e. without nested,
 * embedded or escaped \".  Return the number of words
 * or <0 on error.
205 206 207 208 209
 */
static int ddebug_tokenize(char *buf, char *words[], int maxwords)
{
	int nwords = 0;

210 211 212 213
	while (*buf) {
		char *end;

		/* Skip leading whitespace */
214
		buf = skip_spaces(buf);
215 216
		if (!*buf)
			break;	/* oh, it was trailing whitespace */
217 218
		if (*buf == '#')
			break;	/* token starts comment, skip rest of line */
219

220
		/* find `end' of word, whitespace separated or quoted */
221 222 223 224 225 226 227 228 229 230 231 232
		if (*buf == '"' || *buf == '\'') {
			int quote = *buf++;
			for (end = buf ; *end && *end != quote ; end++)
				;
			if (!*end)
				return -EINVAL;	/* unclosed quote */
		} else {
			for (end = buf ; *end && !isspace(*end) ; end++)
				;
			BUG_ON(end == buf);
		}

233
		/* `buf' is start of word, `end' is one past its end */
234 235 236 237 238 239 240
		if (nwords == maxwords)
			return -EINVAL;	/* ran out of words[] before bytes */
		if (*end)
			*end++ = '\0';	/* terminate the word */
		words[nwords++] = buf;
		buf = end;
	}
241 242 243

	if (verbose) {
		int i;
244
		pr_info("split into words:");
245
		for (i = 0 ; i < nwords ; i++)
246 247
			pr_cont(" \"%s\"", words[i]);
		pr_cont("\n");
248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311
	}

	return nwords;
}

/*
 * Parse a single line number.  Note that the empty string ""
 * is treated as a special case and converted to zero, which
 * is later treated as a "don't care" value.
 */
static inline int parse_lineno(const char *str, unsigned int *val)
{
	char *end = NULL;
	BUG_ON(str == NULL);
	if (*str == '\0') {
		*val = 0;
		return 0;
	}
	*val = simple_strtoul(str, &end, 10);
	return end == NULL || end == str || *end != '\0' ? -EINVAL : 0;
}

/*
 * Undo octal escaping in a string, inplace.  This is useful to
 * allow the user to express a query which matches a format
 * containing embedded spaces.
 */
#define isodigit(c)		((c) >= '0' && (c) <= '7')
static char *unescape(char *str)
{
	char *in = str;
	char *out = str;

	while (*in) {
		if (*in == '\\') {
			if (in[1] == '\\') {
				*out++ = '\\';
				in += 2;
				continue;
			} else if (in[1] == 't') {
				*out++ = '\t';
				in += 2;
				continue;
			} else if (in[1] == 'n') {
				*out++ = '\n';
				in += 2;
				continue;
			} else if (isodigit(in[1]) &&
			         isodigit(in[2]) &&
			         isodigit(in[3])) {
				*out++ = ((in[1] - '0')<<6) |
				          ((in[2] - '0')<<3) |
				          (in[3] - '0');
				in += 4;
				continue;
			}
		}
		*out++ = *in++;
	}
	*out = '\0';

	return str;
}

312 313 314 315 316 317 318 319 320 321 322 323 324
static int check_set(const char **dest, char *src, char *name)
{
	int rc = 0;

	if (*dest) {
		rc = -EINVAL;
		pr_err("match-spec:%s val:%s overridden by %s",
			name, *dest, src);
	}
	*dest = src;
	return rc;
}

325 326 327 328 329 330 331 332 333 334 335
/*
 * Parse words[] as a ddebug query specification, which is a series
 * of (keyword, value) pairs chosen from these possibilities:
 *
 * func <function-name>
 * file <full-pathname>
 * file <base-filename>
 * module <module-name>
 * format <escaped-string-to-find-in-format>
 * line <lineno>
 * line <first-lineno>-<last-lineno> // where either may be empty
336 337 338
 *
 * Only 1 of each type is allowed.
 * Returns 0 on success, <0 on error.
339 340 341 342 343
 */
static int ddebug_parse_query(char *words[], int nwords,
			       struct ddebug_query *query)
{
	unsigned int i;
344
	int rc;
345 346 347 348 349 350 351 352

	/* check we have an even number of words */
	if (nwords % 2 != 0)
		return -EINVAL;
	memset(query, 0, sizeof(*query));

	for (i = 0 ; i < nwords ; i += 2) {
		if (!strcmp(words[i], "func"))
353
			rc = check_set(&query->function, words[i+1], "func");
354
		else if (!strcmp(words[i], "file"))
355
			rc = check_set(&query->filename, words[i+1], "file");
356
		else if (!strcmp(words[i], "module"))
357
			rc = check_set(&query->module, words[i+1], "module");
358
		else if (!strcmp(words[i], "format"))
359 360
			rc = check_set(&query->format, unescape(words[i+1]),
				"format");
361 362 363
		else if (!strcmp(words[i], "line")) {
			char *first = words[i+1];
			char *last = strchr(first, '-');
364 365 366 367
			if (query->first_lineno || query->last_lineno) {
				pr_err("match-spec:line given 2 times\n");
				return -EINVAL;
			}
368 369 370 371
			if (last)
				*last++ = '\0';
			if (parse_lineno(first, &query->first_lineno) < 0)
				return -EINVAL;
372
			if (last) {
373
				/* range <first>-<last> */
374 375 376
				if (parse_lineno(last, &query->last_lineno)
				    < query->first_lineno) {
					pr_err("last-line < 1st-line\n");
377
					return -EINVAL;
378
				}
379 380 381 382
			} else {
				query->last_lineno = query->first_lineno;
			}
		} else {
383
			pr_err("unknown keyword \"%s\"\n", words[i]);
384 385
			return -EINVAL;
		}
386 387
		if (rc)
			return rc;
388
	}
389
	vpr_info_dq(query, "parsed");
390 391 392 393 394 395 396 397 398 399 400 401 402
	return 0;
}

/*
 * Parse `str' as a flags specification, format [-+=][p]+.
 * Sets up *maskp and *flagsp to be used when changing the
 * flags fields of matched _ddebug's.  Returns 0 on success
 * or <0 on error.
 */
static int ddebug_parse_flags(const char *str, unsigned int *flagsp,
			       unsigned int *maskp)
{
	unsigned flags = 0;
B
Bart Van Assche 已提交
403
	int op = '=', i;
404 405 406 407 408 409 410 411 412 413

	switch (*str) {
	case '+':
	case '-':
	case '=':
		op = *str++;
		break;
	default:
		return -EINVAL;
	}
414
	vpr_info("op='%c'\n", op);
415 416

	for ( ; *str ; ++str) {
B
Bart Van Assche 已提交
417 418 419 420 421
		for (i = ARRAY_SIZE(opt_array) - 1; i >= 0; i--) {
			if (*str == opt_array[i].opt_char) {
				flags |= opt_array[i].flag;
				break;
			}
422
		}
B
Bart Van Assche 已提交
423 424
		if (i < 0)
			return -EINVAL;
425
	}
426
	vpr_info("flags=0x%x\n", flags);
427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442

	/* calculate final *flagsp, *maskp according to mask and op */
	switch (op) {
	case '=':
		*maskp = 0;
		*flagsp = flags;
		break;
	case '+':
		*maskp = ~0U;
		*flagsp = flags;
		break;
	case '-':
		*maskp = ~flags;
		*flagsp = 0;
		break;
	}
443
	vpr_info("*flagsp=0x%x *maskp=0x%x\n", *flagsp, *maskp);
444 445 446
	return 0;
}

447 448 449 450 451
static int ddebug_exec_query(char *query_string)
{
	unsigned int flags = 0, mask = 0;
	struct ddebug_query query;
#define MAXWORDS 9
452
	int nwords, nfound;
453 454 455 456 457 458 459 460 461 462 463
	char *words[MAXWORDS];

	nwords = ddebug_tokenize(query_string, words, MAXWORDS);
	if (nwords <= 0)
		return -EINVAL;
	if (ddebug_parse_query(words, nwords-1, &query))
		return -EINVAL;
	if (ddebug_parse_flags(words[nwords-1], &flags, &mask))
		return -EINVAL;

	/* actually go and implement the change */
464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487
	nfound = ddebug_change(&query, flags, mask);
	vpr_info_dq((&query), (nfound) ? "applied" : "no-match");

	return nfound;
}

/* handle multiple queries in query string, continue on error, return
   last error or number of matching callsites.  Module name is either
   in param (for boot arg) or perhaps in query string.
*/
static int ddebug_exec_queries(char *query)
{
	char *split;
	int i, errs = 0, exitcode = 0, rc, nfound = 0;

	for (i = 0; query; query = split) {
		split = strpbrk(query, ";\n");
		if (split)
			*split++ = '\0';

		query = skip_spaces(query);
		if (!query || !*query || *query == '#')
			continue;

488
		vpr_info("query %d: \"%s\"\n", i, query);
489 490 491 492 493 494 495 496 497

		rc = ddebug_exec_query(query);
		if (rc < 0) {
			errs++;
			exitcode = rc;
		} else
			nfound += rc;
		i++;
	}
498
	vpr_info("processed %d queries, with %d matches, %d errs\n",
499 500 501 502 503
		 i, nfound, errs);

	if (exitcode)
		return exitcode;
	return nfound;
504 505
}

506 507 508 509 510 511 512 513 514 515
#define PREFIX_SIZE 64

static int remaining(int wrote)
{
	if (PREFIX_SIZE - wrote > 0)
		return PREFIX_SIZE - wrote;
	return 0;
}

static char *dynamic_emit_prefix(const struct _ddebug *desc, char *buf)
B
Bart Van Assche 已提交
516
{
517 518
	int pos_after_tid;
	int pos = 0;
B
Bart Van Assche 已提交
519

520 521
	pos += snprintf(buf + pos, remaining(pos), "%s", KERN_DEBUG);
	if (desc->flags & _DPRINTK_FLAGS_INCL_TID) {
B
Bart Van Assche 已提交
522
		if (in_interrupt())
523 524
			pos += snprintf(buf + pos, remaining(pos), "%s ",
						"<intr>");
B
Bart Van Assche 已提交
525
		else
526 527
			pos += snprintf(buf + pos, remaining(pos), "[%d] ",
						task_pid_vnr(current));
B
Bart Van Assche 已提交
528
	}
529 530 531 532 533 534 535 536
	pos_after_tid = pos;
	if (desc->flags & _DPRINTK_FLAGS_INCL_MODNAME)
		pos += snprintf(buf + pos, remaining(pos), "%s:",
					desc->modname);
	if (desc->flags & _DPRINTK_FLAGS_INCL_FUNCNAME)
		pos += snprintf(buf + pos, remaining(pos), "%s:",
					desc->function);
	if (desc->flags & _DPRINTK_FLAGS_INCL_LINENO)
537 538
		pos += snprintf(buf + pos, remaining(pos), "%d:",
					desc->lineno);
539 540 541 542
	if (pos - pos_after_tid)
		pos += snprintf(buf + pos, remaining(pos), " ");
	if (pos >= PREFIX_SIZE)
		buf[PREFIX_SIZE - 1] = '\0';
543

544
	return buf;
545 546
}

B
Bart Van Assche 已提交
547 548 549 550
int __dynamic_pr_debug(struct _ddebug *descriptor, const char *fmt, ...)
{
	va_list args;
	int res;
551 552
	struct va_format vaf;
	char buf[PREFIX_SIZE];
B
Bart Van Assche 已提交
553 554 555 556 557

	BUG_ON(!descriptor);
	BUG_ON(!fmt);

	va_start(args, fmt);
558 559 560
	vaf.fmt = fmt;
	vaf.va = &args;
	res = printk("%s%pV", dynamic_emit_prefix(descriptor, buf), &vaf);
B
Bart Van Assche 已提交
561 562 563 564 565 566
	va_end(args);

	return res;
}
EXPORT_SYMBOL(__dynamic_pr_debug);

567 568 569 570 571 572
int __dynamic_dev_dbg(struct _ddebug *descriptor,
		      const struct device *dev, const char *fmt, ...)
{
	struct va_format vaf;
	va_list args;
	int res;
573
	char buf[PREFIX_SIZE];
574 575 576 577 578 579 580

	BUG_ON(!descriptor);
	BUG_ON(!fmt);

	va_start(args, fmt);
	vaf.fmt = fmt;
	vaf.va = &args;
581
	res = __dev_printk(dynamic_emit_prefix(descriptor, buf), dev, &vaf);
582 583 584 585 586 587
	va_end(args);

	return res;
}
EXPORT_SYMBOL(__dynamic_dev_dbg);

588 589
#ifdef CONFIG_NET

590 591 592 593 594 595
int __dynamic_netdev_dbg(struct _ddebug *descriptor,
		      const struct net_device *dev, const char *fmt, ...)
{
	struct va_format vaf;
	va_list args;
	int res;
596
	char buf[PREFIX_SIZE];
597 598 599 600 601 602 603

	BUG_ON(!descriptor);
	BUG_ON(!fmt);

	va_start(args, fmt);
	vaf.fmt = fmt;
	vaf.va = &args;
604
	res = __netdev_printk(dynamic_emit_prefix(descriptor, buf), dev, &vaf);
605 606 607 608 609 610
	va_end(args);

	return res;
}
EXPORT_SYMBOL(__dynamic_netdev_dbg);

611 612
#endif

613 614 615
#define DDEBUG_STRING_SIZE 1024
static __initdata char ddebug_setup_string[DDEBUG_STRING_SIZE];

616 617
static __init int ddebug_setup_query(char *str)
{
618
	if (strlen(str) >= DDEBUG_STRING_SIZE) {
619
		pr_warn("ddebug boot param string too large\n");
620 621
		return 0;
	}
622
	strlcpy(ddebug_setup_string, str, DDEBUG_STRING_SIZE);
623 624 625 626 627
	return 1;
}

__setup("ddebug_query=", ddebug_setup_query);

628 629 630 631
/*
 * File_ops->write method for <debugfs>/dynamic_debug/conrol.  Gathers the
 * command text from userspace, parses and executes it.
 */
632
#define USER_BUF_PAGE 4096
633 634 635
static ssize_t ddebug_proc_write(struct file *file, const char __user *ubuf,
				  size_t len, loff_t *offp)
{
636
	char *tmpbuf;
637
	int ret;
638 639 640

	if (len == 0)
		return 0;
641 642
	if (len > USER_BUF_PAGE - 1) {
		pr_warn("expected <%d bytes into control\n", USER_BUF_PAGE);
643
		return -E2BIG;
644 645 646 647 648 649
	}
	tmpbuf = kmalloc(len + 1, GFP_KERNEL);
	if (!tmpbuf)
		return -ENOMEM;
	if (copy_from_user(tmpbuf, ubuf, len)) {
		kfree(tmpbuf);
650
		return -EFAULT;
651
	}
652
	tmpbuf[len] = '\0';
653
	vpr_info("read %d bytes from userspace\n", (int)len);
654

655
	ret = ddebug_exec_queries(tmpbuf);
656
	kfree(tmpbuf);
657
	if (ret < 0)
658
		return ret;
659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715

	*offp += len;
	return len;
}

/*
 * Set the iterator to point to the first _ddebug object
 * and return a pointer to that first object.  Returns
 * NULL if there are no _ddebugs at all.
 */
static struct _ddebug *ddebug_iter_first(struct ddebug_iter *iter)
{
	if (list_empty(&ddebug_tables)) {
		iter->table = NULL;
		iter->idx = 0;
		return NULL;
	}
	iter->table = list_entry(ddebug_tables.next,
				 struct ddebug_table, link);
	iter->idx = 0;
	return &iter->table->ddebugs[iter->idx];
}

/*
 * Advance the iterator to point to the next _ddebug
 * object from the one the iterator currently points at,
 * and returns a pointer to the new _ddebug.  Returns
 * NULL if the iterator has seen all the _ddebugs.
 */
static struct _ddebug *ddebug_iter_next(struct ddebug_iter *iter)
{
	if (iter->table == NULL)
		return NULL;
	if (++iter->idx == iter->table->num_ddebugs) {
		/* iterate to next table */
		iter->idx = 0;
		if (list_is_last(&iter->table->link, &ddebug_tables)) {
			iter->table = NULL;
			return NULL;
		}
		iter->table = list_entry(iter->table->link.next,
					 struct ddebug_table, link);
	}
	return &iter->table->ddebugs[iter->idx];
}

/*
 * Seq_ops start method.  Called at the start of every
 * read() call from userspace.  Takes the ddebug_lock and
 * seeks the seq_file's iterator to the given position.
 */
static void *ddebug_proc_start(struct seq_file *m, loff_t *pos)
{
	struct ddebug_iter *iter = m->private;
	struct _ddebug *dp;
	int n = *pos;

716
	vpr_info("called m=%p *pos=%lld\n", m, (unsigned long long)*pos);
717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739

	mutex_lock(&ddebug_lock);

	if (!n)
		return SEQ_START_TOKEN;
	if (n < 0)
		return NULL;
	dp = ddebug_iter_first(iter);
	while (dp != NULL && --n > 0)
		dp = ddebug_iter_next(iter);
	return dp;
}

/*
 * Seq_ops next method.  Called several times within a read()
 * call from userspace, with ddebug_lock held.  Walks to the
 * next _ddebug object with a special case for the header line.
 */
static void *ddebug_proc_next(struct seq_file *m, void *p, loff_t *pos)
{
	struct ddebug_iter *iter = m->private;
	struct _ddebug *dp;

740 741
	vpr_info("called m=%p p=%p *pos=%lld\n",
		m, p, (unsigned long long)*pos);
742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760

	if (p == SEQ_START_TOKEN)
		dp = ddebug_iter_first(iter);
	else
		dp = ddebug_iter_next(iter);
	++*pos;
	return dp;
}

/*
 * Seq_ops show method.  Called several times within a read()
 * call from userspace, with ddebug_lock held.  Formats the
 * current _ddebug as a single human-readable line, with a
 * special case for the header line.
 */
static int ddebug_proc_show(struct seq_file *m, void *p)
{
	struct ddebug_iter *iter = m->private;
	struct _ddebug *dp = p;
761
	char flagsbuf[10];
762

763
	vpr_info("called m=%p p=%p\n", m, p);
764 765 766 767 768 769 770

	if (p == SEQ_START_TOKEN) {
		seq_puts(m,
			"# filename:lineno [module]function flags format\n");
		return 0;
	}

771
	seq_printf(m, "%s:%u [%s]%s =%s \"",
772
		trim_prefix(dp->filename), dp->lineno,
773 774
		iter->table->mod_name, dp->function,
		ddebug_describe_flags(dp, flagsbuf, sizeof(flagsbuf)));
775 776 777 778 779 780 781 782 783 784 785 786
	seq_escape(m, dp->format, "\t\r\n\"");
	seq_puts(m, "\"\n");

	return 0;
}

/*
 * Seq_ops stop method.  Called at the end of each read()
 * call from userspace.  Drops ddebug_lock.
 */
static void ddebug_proc_stop(struct seq_file *m, void *p)
{
787
	vpr_info("called m=%p p=%p\n", m, p);
788 789 790 791 792 793 794 795 796 797 798
	mutex_unlock(&ddebug_lock);
}

static const struct seq_operations ddebug_proc_seqops = {
	.start = ddebug_proc_start,
	.next = ddebug_proc_next,
	.show = ddebug_proc_show,
	.stop = ddebug_proc_stop
};

/*
799 800 801 802 803
 * File_ops->open method for <debugfs>/dynamic_debug/control.  Does
 * the seq_file setup dance, and also creates an iterator to walk the
 * _ddebugs.  Note that we create a seq_file always, even for O_WRONLY
 * files where it's not needed, as doing so simplifies the ->release
 * method.
804 805 806 807 808 809
 */
static int ddebug_proc_open(struct inode *inode, struct file *file)
{
	struct ddebug_iter *iter;
	int err;

810
	vpr_info("called\n");
811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859

	iter = kzalloc(sizeof(*iter), GFP_KERNEL);
	if (iter == NULL)
		return -ENOMEM;

	err = seq_open(file, &ddebug_proc_seqops);
	if (err) {
		kfree(iter);
		return err;
	}
	((struct seq_file *) file->private_data)->private = iter;
	return 0;
}

static const struct file_operations ddebug_proc_fops = {
	.owner = THIS_MODULE,
	.open = ddebug_proc_open,
	.read = seq_read,
	.llseek = seq_lseek,
	.release = seq_release_private,
	.write = ddebug_proc_write
};

/*
 * Allocate a new ddebug_table for the given module
 * and add it to the global list.
 */
int ddebug_add_module(struct _ddebug *tab, unsigned int n,
			     const char *name)
{
	struct ddebug_table *dt;
	char *new_name;

	dt = kzalloc(sizeof(*dt), GFP_KERNEL);
	if (dt == NULL)
		return -ENOMEM;
	new_name = kstrdup(name, GFP_KERNEL);
	if (new_name == NULL) {
		kfree(dt);
		return -ENOMEM;
	}
	dt->mod_name = new_name;
	dt->num_ddebugs = n;
	dt->ddebugs = tab;

	mutex_lock(&ddebug_lock);
	list_add_tail(&dt->link, &ddebug_tables);
	mutex_unlock(&ddebug_lock);

860
	vpr_info("%u debug prints in module %s\n", n, dt->mod_name);
861 862 863 864
	return 0;
}
EXPORT_SYMBOL_GPL(ddebug_add_module);

865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899
/* handle both dyndbg=".." and $module.dyndbg=".." params at boot */
static int ddebug_dyndbg_boot_param_cb(char *param, char *val,
				const char *unused)
{
	const char *modname = NULL;
	char *sep;

	sep = strchr(param, '.');
	if (sep) {
		*sep = '\0';
		modname = param;
		param = sep + 1;
	}
	if (strcmp(param, "dyndbg"))
		return 0; /* skip all other params w/o error */

	vpr_info("module: %s %s=\"%s\"\n", modname, param, val);

	ddebug_exec_queries(val ? val : "+p");
	return 0; /* query failure shouldnt stop module load */
}

/* handle dyndbg args to modprobe */
int ddebug_dyndbg_module_param_cb(char *param, char *val, const char *doing)
{
	if (strcmp(param, "dyndbg"))
		return -ENOENT;

	vpr_info("module: %s %s=\"%s\"\n", doing, param, val);

	ddebug_exec_queries((val ? val : "+p"));

	return 0; /* query failure shouldnt stop module load */
}

900 901 902 903 904 905 906 907 908 909 910
static void ddebug_table_free(struct ddebug_table *dt)
{
	list_del_init(&dt->link);
	kfree(dt->mod_name);
	kfree(dt);
}

/*
 * Called in response to a module being unloaded.  Removes
 * any ddebug_table's which point at the module.
 */
911
int ddebug_remove_module(const char *mod_name)
912 913 914 915
{
	struct ddebug_table *dt, *nextdt;
	int ret = -ENOENT;

916
	vpr_info("removing module \"%s\"\n", mod_name);
917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941

	mutex_lock(&ddebug_lock);
	list_for_each_entry_safe(dt, nextdt, &ddebug_tables, link) {
		if (!strcmp(dt->mod_name, mod_name)) {
			ddebug_table_free(dt);
			ret = 0;
		}
	}
	mutex_unlock(&ddebug_lock);
	return ret;
}
EXPORT_SYMBOL_GPL(ddebug_remove_module);

static void ddebug_remove_all_tables(void)
{
	mutex_lock(&ddebug_lock);
	while (!list_empty(&ddebug_tables)) {
		struct ddebug_table *dt = list_entry(ddebug_tables.next,
						      struct ddebug_table,
						      link);
		ddebug_table_free(dt);
	}
	mutex_unlock(&ddebug_lock);
}

942 943 944
static __initdata int ddebug_init_success;

static int __init dynamic_debug_init_debugfs(void)
945 946
{
	struct dentry *dir, *file;
947 948 949

	if (!ddebug_init_success)
		return -ENODEV;
950 951 952 953 954 955 956 957 958 959

	dir = debugfs_create_dir("dynamic_debug", NULL);
	if (!dir)
		return -ENOMEM;
	file = debugfs_create_file("control", 0644, dir, NULL,
					&ddebug_proc_fops);
	if (!file) {
		debugfs_remove(dir);
		return -ENOMEM;
	}
960 961 962 963 964 965 966
	return 0;
}

static int __init dynamic_debug_init(void)
{
	struct _ddebug *iter, *iter_start;
	const char *modname = NULL;
967
	char *cmdline;
968 969 970
	int ret = 0;
	int n = 0;

971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986
	if (__start___verbose == __stop___verbose) {
		pr_warn("_ddebug table is empty in a "
			"CONFIG_DYNAMIC_DEBUG build");
		return 1;
	}
	iter = __start___verbose;
	modname = iter->modname;
	iter_start = iter;
	for (; iter < __stop___verbose; iter++) {
		if (strcmp(modname, iter->modname)) {
			ret = ddebug_add_module(iter_start, n, modname);
			if (ret)
				goto out_free;
			n = 0;
			modname = iter->modname;
			iter_start = iter;
987
		}
988
		n++;
989
	}
990 991 992
	ret = ddebug_add_module(iter_start, n, modname);
	if (ret)
		goto out_free;
993 994 995

	/* ddebug_query boot param got passed -> set it up */
	if (ddebug_setup_string[0] != '\0') {
996 997
		pr_warn("ddebug_query param name is deprecated,"
			" change it to dyndbg\n");
998 999
		ret = ddebug_exec_queries(ddebug_setup_string);
		if (ret < 0)
1000 1001
			pr_warn("Invalid ddebug boot param %s",
				ddebug_setup_string);
1002
		else
1003 1004 1005 1006
			pr_info("%d changes by ddebug_query\n", ret);

		/* keep tables even on ddebug_query parse error */
		ret = 0;
1007
	}
1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019
	/* now that ddebug tables are loaded, process all boot args
	 * again to find and activate queries given in dyndbg params.
	 * While this has already been done for known boot params, it
	 * ignored the unknown ones (dyndbg in particular).  Reusing
	 * parse_args avoids ad-hoc parsing.  This will also attempt
	 * to activate queries for not-yet-loaded modules, which is
	 * slightly noisy if verbose, but harmless.
	 */
	cmdline = kstrdup(saved_command_line, GFP_KERNEL);
	parse_args("dyndbg params", cmdline, NULL,
		   0, 0, 0, &ddebug_dyndbg_boot_param_cb);
	kfree(cmdline);
1020

1021
out_free:
1022
	if (ret)
1023
		ddebug_remove_all_tables();
1024 1025
	else
		ddebug_init_success = 1;
1026 1027
	return 0;
}
1028 1029
/* Allow early initialization for boot messages via boot param */
arch_initcall(dynamic_debug_init);
1030

1031 1032
/* Debugfs setup must be done later */
module_init(dynamic_debug_init_debugfs);