]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blame - lib/dynamic_debug.c
UBUNTU: Ubuntu-4.15.0-96.97
[mirror_ubuntu-bionic-kernel.git] / lib / dynamic_debug.c
CommitLineData
e9d376f0
JB
1/*
2 * lib/dynamic_debug.c
3 *
4 * make pr_debug()/dev_dbg() calls runtime configurable based upon their
5 * source module.
6 *
7 * Copyright (C) 2008 Jason Baron <jbaron@redhat.com>
8 * By Greg Banks <gnb@melbourne.sgi.com>
9 * Copyright (c) 2008 Silicon Graphics Inc. All Rights Reserved.
8ba6ebf5 10 * Copyright (C) 2011 Bart Van Assche. All Rights Reserved.
578b1e07 11 * Copyright (C) 2013 Du, Changbin <changbin.du@gmail.com>
e9d376f0
JB
12 */
13
4ad275e5
JP
14#define pr_fmt(fmt) KBUILD_MODNAME ":%s: " fmt, __func__
15
e9d376f0
JB
16#include <linux/kernel.h>
17#include <linux/module.h>
fef15d2f
GKH
18#include <linux/moduleparam.h>
19#include <linux/kallsyms.h>
20#include <linux/types.h>
e9d376f0 21#include <linux/mutex.h>
fef15d2f 22#include <linux/proc_fs.h>
e9d376f0 23#include <linux/seq_file.h>
fef15d2f
GKH
24#include <linux/list.h>
25#include <linux/sysctl.h>
e9d376f0 26#include <linux/ctype.h>
fef15d2f 27#include <linux/string.h>
578b1e07 28#include <linux/parser.h>
d338b137 29#include <linux/string_helpers.h>
fef15d2f 30#include <linux/uaccess.h>
e9d376f0
JB
31#include <linux/dynamic_debug.h>
32#include <linux/debugfs.h>
5a0e3ad6 33#include <linux/slab.h>
fef15d2f 34#include <linux/jump_label.h>
8ba6ebf5 35#include <linux/hardirq.h>
e8d9792a 36#include <linux/sched.h>
fef15d2f 37#include <linux/device.h>
ffa10cb4 38#include <linux/netdevice.h>
e9d376f0
JB
39
40extern struct _ddebug __start___verbose[];
41extern struct _ddebug __stop___verbose[];
42
e9d376f0
JB
43struct ddebug_table {
44 struct list_head link;
3e406b1d 45 const char *mod_name;
e9d376f0 46 unsigned int num_ddebugs;
e9d376f0
JB
47 struct _ddebug *ddebugs;
48};
49
50struct ddebug_query {
51 const char *filename;
52 const char *module;
53 const char *function;
54 const char *format;
55 unsigned int first_lineno, last_lineno;
56};
57
58struct ddebug_iter {
59 struct ddebug_table *table;
60 unsigned int idx;
61};
62
63static DEFINE_MUTEX(ddebug_lock);
64static LIST_HEAD(ddebug_tables);
f657fd21 65static int verbose;
74df138d 66module_param(verbose, int, 0644);
e9d376f0 67
2b678319
JC
68/* Return the path relative to source root */
69static inline const char *trim_prefix(const char *path)
70{
71 int skip = strlen(__FILE__) - strlen("lib/dynamic_debug.c");
72
73 if (strncmp(path, __FILE__, skip))
74 skip = 0; /* prefix mismatch, don't skip */
75
76 return path + skip;
77}
78
8ba6ebf5
BVA
79static struct { unsigned flag:8; char opt_char; } opt_array[] = {
80 { _DPRINTK_FLAGS_PRINT, 'p' },
81 { _DPRINTK_FLAGS_INCL_MODNAME, 'm' },
82 { _DPRINTK_FLAGS_INCL_FUNCNAME, 'f' },
83 { _DPRINTK_FLAGS_INCL_LINENO, 'l' },
84 { _DPRINTK_FLAGS_INCL_TID, 't' },
5ca7d2a6 85 { _DPRINTK_FLAGS_NONE, '_' },
8ba6ebf5
BVA
86};
87
e9d376f0
JB
88/* format a string into buf[] which describes the _ddebug's flags */
89static char *ddebug_describe_flags(struct _ddebug *dp, char *buf,
90 size_t maxlen)
91{
92 char *p = buf;
8ba6ebf5 93 int i;
e9d376f0 94
5ca7d2a6 95 BUG_ON(maxlen < 6);
8ba6ebf5
BVA
96 for (i = 0; i < ARRAY_SIZE(opt_array); ++i)
97 if (dp->flags & opt_array[i].flag)
98 *p++ = opt_array[i].opt_char;
e9d376f0 99 if (p == buf)
5ca7d2a6 100 *p++ = '_';
e9d376f0
JB
101 *p = '\0';
102
103 return buf;
104}
105
f657fd21 106#define vpr_info(fmt, ...) \
b8ccd5de 107do { \
f657fd21
JP
108 if (verbose) \
109 pr_info(fmt, ##__VA_ARGS__); \
574b3725
JC
110} while (0)
111
f657fd21
JP
112static void vpr_info_dq(const struct ddebug_query *query, const char *msg)
113{
114 /* trim any trailing newlines */
115 int fmtlen = 0;
116
117 if (query->format) {
118 fmtlen = strlen(query->format);
119 while (fmtlen && query->format[fmtlen - 1] == '\n')
120 fmtlen--;
121 }
122
123 vpr_info("%s: func=\"%s\" file=\"%s\" module=\"%s\" format=\"%.*s\" lineno=%u-%u\n",
124 msg,
125 query->function ? query->function : "",
126 query->filename ? query->filename : "",
127 query->module ? query->module : "",
128 fmtlen, query->format ? query->format : "",
129 query->first_lineno, query->last_lineno);
130}
131
e9d376f0 132/*
85f7f6c0
JC
133 * Search the tables for _ddebug's which match the given `query' and
134 * apply the `flags' and `mask' to them. Returns number of matching
135 * callsites, normally the same as number of changes. If verbose,
136 * logs the changes. Takes ddebug_lock.
e9d376f0 137 */
85f7f6c0
JC
138static int ddebug_change(const struct ddebug_query *query,
139 unsigned int flags, unsigned int mask)
e9d376f0
JB
140{
141 int i;
142 struct ddebug_table *dt;
143 unsigned int newflags;
144 unsigned int nfound = 0;
5ca7d2a6 145 char flagbuf[10];
e9d376f0
JB
146
147 /* search for matching ddebugs */
148 mutex_lock(&ddebug_lock);
149 list_for_each_entry(dt, &ddebug_tables, link) {
150
151 /* match against the module name */
578b1e07
DC
152 if (query->module &&
153 !match_wildcard(query->module, dt->mod_name))
e9d376f0
JB
154 continue;
155
f657fd21 156 for (i = 0; i < dt->num_ddebugs; i++) {
e9d376f0
JB
157 struct _ddebug *dp = &dt->ddebugs[i];
158
159 /* match against the source filename */
d6a238d2 160 if (query->filename &&
578b1e07
DC
161 !match_wildcard(query->filename, dp->filename) &&
162 !match_wildcard(query->filename,
163 kbasename(dp->filename)) &&
164 !match_wildcard(query->filename,
165 trim_prefix(dp->filename)))
e9d376f0
JB
166 continue;
167
168 /* match against the function */
d6a238d2 169 if (query->function &&
578b1e07 170 !match_wildcard(query->function, dp->function))
e9d376f0
JB
171 continue;
172
173 /* match against the format */
d6a238d2
JC
174 if (query->format &&
175 !strstr(dp->format, query->format))
e9d376f0
JB
176 continue;
177
178 /* match against the line number range */
179 if (query->first_lineno &&
180 dp->lineno < query->first_lineno)
181 continue;
182 if (query->last_lineno &&
183 dp->lineno > query->last_lineno)
184 continue;
185
186 nfound++;
187
188 newflags = (dp->flags & mask) | flags;
189 if (newflags == dp->flags)
190 continue;
9049fc74
JB
191#ifdef HAVE_JUMP_LABEL
192 if (dp->flags & _DPRINTK_FLAGS_PRINT) {
193 if (!(flags & _DPRINTK_FLAGS_PRINT))
194 static_branch_disable(&dp->key.dd_key_true);
195 } else if (flags & _DPRINTK_FLAGS_PRINT)
196 static_branch_enable(&dp->key.dd_key_true);
197#endif
e9d376f0 198 dp->flags = newflags;
b8ccd5de 199 vpr_info("changed %s:%d [%s]%s =%s\n",
f657fd21
JP
200 trim_prefix(dp->filename), dp->lineno,
201 dt->mod_name, dp->function,
202 ddebug_describe_flags(dp, flagbuf,
203 sizeof(flagbuf)));
e9d376f0
JB
204 }
205 }
206 mutex_unlock(&ddebug_lock);
207
208 if (!nfound && verbose)
4ad275e5 209 pr_info("no matches for query\n");
85f7f6c0
JC
210
211 return nfound;
e9d376f0
JB
212}
213
e9d376f0
JB
214/*
215 * Split the buffer `buf' into space-separated words.
9898abb3
GB
216 * Handles simple " and ' quoting, i.e. without nested,
217 * embedded or escaped \". Return the number of words
218 * or <0 on error.
e9d376f0
JB
219 */
220static int ddebug_tokenize(char *buf, char *words[], int maxwords)
221{
222 int nwords = 0;
223
9898abb3
GB
224 while (*buf) {
225 char *end;
226
227 /* Skip leading whitespace */
e7d2860b 228 buf = skip_spaces(buf);
9898abb3
GB
229 if (!*buf)
230 break; /* oh, it was trailing whitespace */
8bd6026e
JC
231 if (*buf == '#')
232 break; /* token starts comment, skip rest of line */
9898abb3 233
07100be7 234 /* find `end' of word, whitespace separated or quoted */
9898abb3
GB
235 if (*buf == '"' || *buf == '\'') {
236 int quote = *buf++;
f657fd21 237 for (end = buf; *end && *end != quote; end++)
9898abb3 238 ;
18c216c5
JC
239 if (!*end) {
240 pr_err("unclosed quote: %s\n", buf);
9898abb3 241 return -EINVAL; /* unclosed quote */
18c216c5 242 }
9898abb3 243 } else {
f657fd21 244 for (end = buf; *end && !isspace(*end); end++)
9898abb3
GB
245 ;
246 BUG_ON(end == buf);
247 }
9898abb3 248
07100be7 249 /* `buf' is start of word, `end' is one past its end */
18c216c5
JC
250 if (nwords == maxwords) {
251 pr_err("too many words, legal max <=%d\n", maxwords);
9898abb3 252 return -EINVAL; /* ran out of words[] before bytes */
18c216c5 253 }
9898abb3
GB
254 if (*end)
255 *end++ = '\0'; /* terminate the word */
256 words[nwords++] = buf;
257 buf = end;
258 }
e9d376f0
JB
259
260 if (verbose) {
261 int i;
4ad275e5 262 pr_info("split into words:");
f657fd21 263 for (i = 0; i < nwords; i++)
4ad275e5
JP
264 pr_cont(" \"%s\"", words[i]);
265 pr_cont("\n");
e9d376f0
JB
266 }
267
268 return nwords;
269}
270
271/*
272 * Parse a single line number. Note that the empty string ""
273 * is treated as a special case and converted to zero, which
274 * is later treated as a "don't care" value.
275 */
276static inline int parse_lineno(const char *str, unsigned int *val)
277{
e9d376f0
JB
278 BUG_ON(str == NULL);
279 if (*str == '\0') {
280 *val = 0;
281 return 0;
282 }
4592599a 283 if (kstrtouint(str, 10, val) < 0) {
18c216c5
JC
284 pr_err("bad line-number: %s\n", str);
285 return -EINVAL;
286 }
287 return 0;
e9d376f0
JB
288}
289
820874c7
JC
290static int check_set(const char **dest, char *src, char *name)
291{
292 int rc = 0;
293
294 if (*dest) {
295 rc = -EINVAL;
f657fd21
JP
296 pr_err("match-spec:%s val:%s overridden by %s\n",
297 name, *dest, src);
820874c7
JC
298 }
299 *dest = src;
300 return rc;
301}
302
e9d376f0
JB
303/*
304 * Parse words[] as a ddebug query specification, which is a series
305 * of (keyword, value) pairs chosen from these possibilities:
306 *
307 * func <function-name>
308 * file <full-pathname>
309 * file <base-filename>
310 * module <module-name>
311 * format <escaped-string-to-find-in-format>
312 * line <lineno>
313 * line <first-lineno>-<last-lineno> // where either may be empty
820874c7
JC
314 *
315 * Only 1 of each type is allowed.
316 * Returns 0 on success, <0 on error.
e9d376f0
JB
317 */
318static int ddebug_parse_query(char *words[], int nwords,
8e59b5cf 319 struct ddebug_query *query, const char *modname)
e9d376f0
JB
320{
321 unsigned int i;
bd8c154a 322 int rc = 0;
e9d376f0
JB
323
324 /* check we have an even number of words */
18c216c5
JC
325 if (nwords % 2 != 0) {
326 pr_err("expecting pairs of match-spec <value>\n");
e9d376f0 327 return -EINVAL;
18c216c5 328 }
e9d376f0
JB
329 memset(query, 0, sizeof(*query));
330
8e59b5cf
JC
331 if (modname)
332 /* support $modname.dyndbg=<multiple queries> */
333 query->module = modname;
334
f657fd21
JP
335 for (i = 0; i < nwords; i += 2) {
336 if (!strcmp(words[i], "func")) {
820874c7 337 rc = check_set(&query->function, words[i+1], "func");
f657fd21 338 } else if (!strcmp(words[i], "file")) {
820874c7 339 rc = check_set(&query->filename, words[i+1], "file");
f657fd21 340 } else if (!strcmp(words[i], "module")) {
820874c7 341 rc = check_set(&query->module, words[i+1], "module");
f657fd21 342 } else if (!strcmp(words[i], "format")) {
d338b137
AS
343 string_unescape_inplace(words[i+1], UNESCAPE_SPACE |
344 UNESCAPE_OCTAL |
345 UNESCAPE_SPECIAL);
346 rc = check_set(&query->format, words[i+1], "format");
f657fd21 347 } else if (!strcmp(words[i], "line")) {
e9d376f0
JB
348 char *first = words[i+1];
349 char *last = strchr(first, '-');
820874c7 350 if (query->first_lineno || query->last_lineno) {
18c216c5 351 pr_err("match-spec: line used 2x\n");
820874c7
JC
352 return -EINVAL;
353 }
e9d376f0
JB
354 if (last)
355 *last++ = '\0';
d9e133e6 356 if (parse_lineno(first, &query->first_lineno) < 0)
e9d376f0 357 return -EINVAL;
820874c7 358 if (last) {
e9d376f0 359 /* range <first>-<last> */
3ace678f
AR
360 if (parse_lineno(last, &query->last_lineno) < 0)
361 return -EINVAL;
362
1f3c790b
RD
363 /* special case for last lineno not specified */
364 if (query->last_lineno == 0)
365 query->last_lineno = UINT_MAX;
366
3ace678f 367 if (query->last_lineno < query->first_lineno) {
18c216c5
JC
368 pr_err("last-line:%d < 1st-line:%d\n",
369 query->last_lineno,
370 query->first_lineno);
e9d376f0 371 return -EINVAL;
820874c7 372 }
e9d376f0
JB
373 } else {
374 query->last_lineno = query->first_lineno;
375 }
376 } else {
ae27f86a 377 pr_err("unknown keyword \"%s\"\n", words[i]);
e9d376f0
JB
378 return -EINVAL;
379 }
820874c7
JC
380 if (rc)
381 return rc;
e9d376f0 382 }
574b3725 383 vpr_info_dq(query, "parsed");
e9d376f0
JB
384 return 0;
385}
386
387/*
388 * Parse `str' as a flags specification, format [-+=][p]+.
389 * Sets up *maskp and *flagsp to be used when changing the
390 * flags fields of matched _ddebug's. Returns 0 on success
391 * or <0 on error.
392 */
393static int ddebug_parse_flags(const char *str, unsigned int *flagsp,
394 unsigned int *maskp)
395{
396 unsigned flags = 0;
8ba6ebf5 397 int op = '=', i;
e9d376f0
JB
398
399 switch (*str) {
400 case '+':
401 case '-':
402 case '=':
403 op = *str++;
404 break;
405 default:
18c216c5 406 pr_err("bad flag-op %c, at start of %s\n", *str, str);
e9d376f0
JB
407 return -EINVAL;
408 }
b8ccd5de 409 vpr_info("op='%c'\n", op);
e9d376f0 410
f657fd21 411 for (; *str ; ++str) {
8ba6ebf5
BVA
412 for (i = ARRAY_SIZE(opt_array) - 1; i >= 0; i--) {
413 if (*str == opt_array[i].opt_char) {
414 flags |= opt_array[i].flag;
415 break;
416 }
e9d376f0 417 }
18c216c5
JC
418 if (i < 0) {
419 pr_err("unknown flag '%c' in \"%s\"\n", *str, str);
8ba6ebf5 420 return -EINVAL;
18c216c5 421 }
e9d376f0 422 }
b8ccd5de 423 vpr_info("flags=0x%x\n", flags);
e9d376f0
JB
424
425 /* calculate final *flagsp, *maskp according to mask and op */
426 switch (op) {
427 case '=':
428 *maskp = 0;
429 *flagsp = flags;
430 break;
431 case '+':
432 *maskp = ~0U;
433 *flagsp = flags;
434 break;
435 case '-':
436 *maskp = ~flags;
437 *flagsp = 0;
438 break;
439 }
b8ccd5de 440 vpr_info("*flagsp=0x%x *maskp=0x%x\n", *flagsp, *maskp);
e9d376f0
JB
441 return 0;
442}
443
8e59b5cf 444static int ddebug_exec_query(char *query_string, const char *modname)
fd89cfb8
TR
445{
446 unsigned int flags = 0, mask = 0;
447 struct ddebug_query query;
448#define MAXWORDS 9
85f7f6c0 449 int nwords, nfound;
fd89cfb8
TR
450 char *words[MAXWORDS];
451
452 nwords = ddebug_tokenize(query_string, words, MAXWORDS);
18c216c5
JC
453 if (nwords <= 0) {
454 pr_err("tokenize failed\n");
fd89cfb8 455 return -EINVAL;
18c216c5
JC
456 }
457 /* check flags 1st (last arg) so query is pairs of spec,val */
458 if (ddebug_parse_flags(words[nwords-1], &flags, &mask)) {
459 pr_err("flags parse failed\n");
fd89cfb8 460 return -EINVAL;
18c216c5
JC
461 }
462 if (ddebug_parse_query(words, nwords-1, &query, modname)) {
463 pr_err("query parse failed\n");
fd89cfb8 464 return -EINVAL;
18c216c5 465 }
fd89cfb8 466 /* actually go and implement the change */
85f7f6c0 467 nfound = ddebug_change(&query, flags, mask);
f657fd21 468 vpr_info_dq(&query, nfound ? "applied" : "no-match");
85f7f6c0
JC
469
470 return nfound;
471}
472
473/* handle multiple queries in query string, continue on error, return
474 last error or number of matching callsites. Module name is either
475 in param (for boot arg) or perhaps in query string.
476*/
8e59b5cf 477static int ddebug_exec_queries(char *query, const char *modname)
85f7f6c0
JC
478{
479 char *split;
480 int i, errs = 0, exitcode = 0, rc, nfound = 0;
481
482 for (i = 0; query; query = split) {
483 split = strpbrk(query, ";\n");
484 if (split)
485 *split++ = '\0';
486
487 query = skip_spaces(query);
488 if (!query || !*query || *query == '#')
489 continue;
490
b8ccd5de 491 vpr_info("query %d: \"%s\"\n", i, query);
85f7f6c0 492
8e59b5cf 493 rc = ddebug_exec_query(query, modname);
85f7f6c0
JC
494 if (rc < 0) {
495 errs++;
496 exitcode = rc;
f657fd21 497 } else {
85f7f6c0 498 nfound += rc;
f657fd21 499 }
85f7f6c0
JC
500 i++;
501 }
b8ccd5de 502 vpr_info("processed %d queries, with %d matches, %d errs\n",
85f7f6c0
JC
503 i, nfound, errs);
504
505 if (exitcode)
506 return exitcode;
507 return nfound;
fd89cfb8
TR
508}
509
431625da
JB
510#define PREFIX_SIZE 64
511
512static int remaining(int wrote)
513{
514 if (PREFIX_SIZE - wrote > 0)
515 return PREFIX_SIZE - wrote;
516 return 0;
517}
518
519static char *dynamic_emit_prefix(const struct _ddebug *desc, char *buf)
8ba6ebf5 520{
431625da
JB
521 int pos_after_tid;
522 int pos = 0;
8ba6ebf5 523
798efc60
JP
524 *buf = '\0';
525
431625da 526 if (desc->flags & _DPRINTK_FLAGS_INCL_TID) {
8ba6ebf5 527 if (in_interrupt())
798efc60 528 pos += snprintf(buf + pos, remaining(pos), "<intr> ");
8ba6ebf5 529 else
431625da 530 pos += snprintf(buf + pos, remaining(pos), "[%d] ",
798efc60 531 task_pid_vnr(current));
8ba6ebf5 532 }
431625da
JB
533 pos_after_tid = pos;
534 if (desc->flags & _DPRINTK_FLAGS_INCL_MODNAME)
535 pos += snprintf(buf + pos, remaining(pos), "%s:",
798efc60 536 desc->modname);
431625da
JB
537 if (desc->flags & _DPRINTK_FLAGS_INCL_FUNCNAME)
538 pos += snprintf(buf + pos, remaining(pos), "%s:",
798efc60 539 desc->function);
431625da 540 if (desc->flags & _DPRINTK_FLAGS_INCL_LINENO)
07100be7 541 pos += snprintf(buf + pos, remaining(pos), "%d:",
798efc60 542 desc->lineno);
431625da
JB
543 if (pos - pos_after_tid)
544 pos += snprintf(buf + pos, remaining(pos), " ");
545 if (pos >= PREFIX_SIZE)
546 buf[PREFIX_SIZE - 1] = '\0';
6c2140ee 547
431625da 548 return buf;
6c2140ee
JP
549}
550
906d2015 551void __dynamic_pr_debug(struct _ddebug *descriptor, const char *fmt, ...)
8ba6ebf5
BVA
552{
553 va_list args;
431625da
JB
554 struct va_format vaf;
555 char buf[PREFIX_SIZE];
8ba6ebf5
BVA
556
557 BUG_ON(!descriptor);
558 BUG_ON(!fmt);
559
560 va_start(args, fmt);
798efc60 561
431625da
JB
562 vaf.fmt = fmt;
563 vaf.va = &args;
798efc60 564
906d2015 565 printk(KERN_DEBUG "%s%pV", dynamic_emit_prefix(descriptor, buf), &vaf);
798efc60 566
8ba6ebf5 567 va_end(args);
8ba6ebf5
BVA
568}
569EXPORT_SYMBOL(__dynamic_pr_debug);
570
906d2015 571void __dynamic_dev_dbg(struct _ddebug *descriptor,
cbc46635
JP
572 const struct device *dev, const char *fmt, ...)
573{
574 struct va_format vaf;
575 va_list args;
cbc46635
JP
576
577 BUG_ON(!descriptor);
578 BUG_ON(!fmt);
579
580 va_start(args, fmt);
798efc60 581
cbc46635
JP
582 vaf.fmt = fmt;
583 vaf.va = &args;
798efc60
JP
584
585 if (!dev) {
906d2015 586 printk(KERN_DEBUG "(NULL device *): %pV", &vaf);
798efc60
JP
587 } else {
588 char buf[PREFIX_SIZE];
798efc60 589
a39d4a85 590 dev_printk_emit(LOGLEVEL_DEBUG, dev, "%s%s %s: %pV",
906d2015
JP
591 dynamic_emit_prefix(descriptor, buf),
592 dev_driver_string(dev), dev_name(dev),
593 &vaf);
798efc60
JP
594 }
595
cbc46635 596 va_end(args);
cbc46635
JP
597}
598EXPORT_SYMBOL(__dynamic_dev_dbg);
599
0feefd97
JB
600#ifdef CONFIG_NET
601
906d2015
JP
602void __dynamic_netdev_dbg(struct _ddebug *descriptor,
603 const struct net_device *dev, const char *fmt, ...)
ffa10cb4
JB
604{
605 struct va_format vaf;
606 va_list args;
ffa10cb4
JB
607
608 BUG_ON(!descriptor);
609 BUG_ON(!fmt);
610
611 va_start(args, fmt);
b004ff49 612
ffa10cb4
JB
613 vaf.fmt = fmt;
614 vaf.va = &args;
b004ff49
JP
615
616 if (dev && dev->dev.parent) {
617 char buf[PREFIX_SIZE];
666f355f 618
a39d4a85 619 dev_printk_emit(LOGLEVEL_DEBUG, dev->dev.parent,
906d2015
JP
620 "%s%s %s %s%s: %pV",
621 dynamic_emit_prefix(descriptor, buf),
622 dev_driver_string(dev->dev.parent),
623 dev_name(dev->dev.parent),
624 netdev_name(dev), netdev_reg_state(dev),
625 &vaf);
b004ff49 626 } else if (dev) {
906d2015
JP
627 printk(KERN_DEBUG "%s%s: %pV", netdev_name(dev),
628 netdev_reg_state(dev), &vaf);
b004ff49 629 } else {
906d2015 630 printk(KERN_DEBUG "(NULL net_device): %pV", &vaf);
b004ff49
JP
631 }
632
ffa10cb4 633 va_end(args);
ffa10cb4
JB
634}
635EXPORT_SYMBOL(__dynamic_netdev_dbg);
636
0feefd97
JB
637#endif
638
bc757f6f
JC
639#define DDEBUG_STRING_SIZE 1024
640static __initdata char ddebug_setup_string[DDEBUG_STRING_SIZE];
641
a648ec05
TR
642static __init int ddebug_setup_query(char *str)
643{
bc757f6f 644 if (strlen(str) >= DDEBUG_STRING_SIZE) {
4ad275e5 645 pr_warn("ddebug boot param string too large\n");
a648ec05
TR
646 return 0;
647 }
bc757f6f 648 strlcpy(ddebug_setup_string, str, DDEBUG_STRING_SIZE);
a648ec05
TR
649 return 1;
650}
651
652__setup("ddebug_query=", ddebug_setup_query);
653
e9d376f0 654/*
231821d4 655 * File_ops->write method for <debugfs>/dynamic_debug/control. Gathers the
e9d376f0
JB
656 * command text from userspace, parses and executes it.
657 */
7281491c 658#define USER_BUF_PAGE 4096
e9d376f0
JB
659static ssize_t ddebug_proc_write(struct file *file, const char __user *ubuf,
660 size_t len, loff_t *offp)
661{
7281491c 662 char *tmpbuf;
fd89cfb8 663 int ret;
e9d376f0
JB
664
665 if (len == 0)
666 return 0;
7281491c
JC
667 if (len > USER_BUF_PAGE - 1) {
668 pr_warn("expected <%d bytes into control\n", USER_BUF_PAGE);
e9d376f0 669 return -E2BIG;
7281491c 670 }
16e5c1fc
AV
671 tmpbuf = memdup_user_nul(ubuf, len);
672 if (IS_ERR(tmpbuf))
673 return PTR_ERR(tmpbuf);
b8ccd5de 674 vpr_info("read %d bytes from userspace\n", (int)len);
e9d376f0 675
8e59b5cf 676 ret = ddebug_exec_queries(tmpbuf, NULL);
7281491c 677 kfree(tmpbuf);
85f7f6c0 678 if (ret < 0)
fd89cfb8 679 return ret;
e9d376f0
JB
680
681 *offp += len;
682 return len;
683}
684
685/*
686 * Set the iterator to point to the first _ddebug object
687 * and return a pointer to that first object. Returns
688 * NULL if there are no _ddebugs at all.
689 */
690static struct _ddebug *ddebug_iter_first(struct ddebug_iter *iter)
691{
692 if (list_empty(&ddebug_tables)) {
693 iter->table = NULL;
694 iter->idx = 0;
695 return NULL;
696 }
697 iter->table = list_entry(ddebug_tables.next,
698 struct ddebug_table, link);
699 iter->idx = 0;
700 return &iter->table->ddebugs[iter->idx];
701}
702
703/*
704 * Advance the iterator to point to the next _ddebug
705 * object from the one the iterator currently points at,
706 * and returns a pointer to the new _ddebug. Returns
707 * NULL if the iterator has seen all the _ddebugs.
708 */
709static struct _ddebug *ddebug_iter_next(struct ddebug_iter *iter)
710{
711 if (iter->table == NULL)
712 return NULL;
713 if (++iter->idx == iter->table->num_ddebugs) {
714 /* iterate to next table */
715 iter->idx = 0;
716 if (list_is_last(&iter->table->link, &ddebug_tables)) {
717 iter->table = NULL;
718 return NULL;
719 }
720 iter->table = list_entry(iter->table->link.next,
721 struct ddebug_table, link);
722 }
723 return &iter->table->ddebugs[iter->idx];
724}
725
726/*
727 * Seq_ops start method. Called at the start of every
728 * read() call from userspace. Takes the ddebug_lock and
729 * seeks the seq_file's iterator to the given position.
730 */
731static void *ddebug_proc_start(struct seq_file *m, loff_t *pos)
732{
733 struct ddebug_iter *iter = m->private;
734 struct _ddebug *dp;
735 int n = *pos;
736
b8ccd5de 737 vpr_info("called m=%p *pos=%lld\n", m, (unsigned long long)*pos);
e9d376f0
JB
738
739 mutex_lock(&ddebug_lock);
740
741 if (!n)
742 return SEQ_START_TOKEN;
743 if (n < 0)
744 return NULL;
745 dp = ddebug_iter_first(iter);
746 while (dp != NULL && --n > 0)
747 dp = ddebug_iter_next(iter);
748 return dp;
749}
750
751/*
752 * Seq_ops next method. Called several times within a read()
753 * call from userspace, with ddebug_lock held. Walks to the
754 * next _ddebug object with a special case for the header line.
755 */
756static void *ddebug_proc_next(struct seq_file *m, void *p, loff_t *pos)
757{
758 struct ddebug_iter *iter = m->private;
759 struct _ddebug *dp;
760
b8ccd5de 761 vpr_info("called m=%p p=%p *pos=%lld\n",
f657fd21 762 m, p, (unsigned long long)*pos);
e9d376f0
JB
763
764 if (p == SEQ_START_TOKEN)
765 dp = ddebug_iter_first(iter);
766 else
767 dp = ddebug_iter_next(iter);
768 ++*pos;
769 return dp;
770}
771
772/*
773 * Seq_ops show method. Called several times within a read()
774 * call from userspace, with ddebug_lock held. Formats the
775 * current _ddebug as a single human-readable line, with a
776 * special case for the header line.
777 */
778static int ddebug_proc_show(struct seq_file *m, void *p)
779{
780 struct ddebug_iter *iter = m->private;
781 struct _ddebug *dp = p;
5ca7d2a6 782 char flagsbuf[10];
e9d376f0 783
b8ccd5de 784 vpr_info("called m=%p p=%p\n", m, p);
e9d376f0
JB
785
786 if (p == SEQ_START_TOKEN) {
787 seq_puts(m,
f657fd21 788 "# filename:lineno [module]function flags format\n");
e9d376f0
JB
789 return 0;
790 }
791
5ca7d2a6 792 seq_printf(m, "%s:%u [%s]%s =%s \"",
f657fd21
JP
793 trim_prefix(dp->filename), dp->lineno,
794 iter->table->mod_name, dp->function,
795 ddebug_describe_flags(dp, flagsbuf, sizeof(flagsbuf)));
e9d376f0
JB
796 seq_escape(m, dp->format, "\t\r\n\"");
797 seq_puts(m, "\"\n");
798
799 return 0;
800}
801
802/*
803 * Seq_ops stop method. Called at the end of each read()
804 * call from userspace. Drops ddebug_lock.
805 */
806static void ddebug_proc_stop(struct seq_file *m, void *p)
807{
b8ccd5de 808 vpr_info("called m=%p p=%p\n", m, p);
e9d376f0
JB
809 mutex_unlock(&ddebug_lock);
810}
811
812static const struct seq_operations ddebug_proc_seqops = {
813 .start = ddebug_proc_start,
814 .next = ddebug_proc_next,
815 .show = ddebug_proc_show,
816 .stop = ddebug_proc_stop
817};
818
819/*
07100be7
JC
820 * File_ops->open method for <debugfs>/dynamic_debug/control. Does
821 * the seq_file setup dance, and also creates an iterator to walk the
822 * _ddebugs. Note that we create a seq_file always, even for O_WRONLY
823 * files where it's not needed, as doing so simplifies the ->release
824 * method.
e9d376f0
JB
825 */
826static int ddebug_proc_open(struct inode *inode, struct file *file)
827{
b8ccd5de 828 vpr_info("called\n");
4bad78c5
RJ
829 return seq_open_private(file, &ddebug_proc_seqops,
830 sizeof(struct ddebug_iter));
e9d376f0
JB
831}
832
833static const struct file_operations ddebug_proc_fops = {
834 .owner = THIS_MODULE,
835 .open = ddebug_proc_open,
836 .read = seq_read,
837 .llseek = seq_lseek,
838 .release = seq_release_private,
839 .write = ddebug_proc_write
840};
841
842/*
843 * Allocate a new ddebug_table for the given module
844 * and add it to the global list.
845 */
846int ddebug_add_module(struct _ddebug *tab, unsigned int n,
847 const char *name)
848{
849 struct ddebug_table *dt;
3e406b1d 850 const char *new_name;
e9d376f0
JB
851
852 dt = kzalloc(sizeof(*dt), GFP_KERNEL);
853 if (dt == NULL)
854 return -ENOMEM;
3e406b1d 855 new_name = kstrdup_const(name, GFP_KERNEL);
e9d376f0
JB
856 if (new_name == NULL) {
857 kfree(dt);
858 return -ENOMEM;
859 }
860 dt->mod_name = new_name;
861 dt->num_ddebugs = n;
e9d376f0
JB
862 dt->ddebugs = tab;
863
864 mutex_lock(&ddebug_lock);
865 list_add_tail(&dt->link, &ddebug_tables);
866 mutex_unlock(&ddebug_lock);
867
b8ccd5de 868 vpr_info("%u debug prints in module %s\n", n, dt->mod_name);
e9d376f0
JB
869 return 0;
870}
871EXPORT_SYMBOL_GPL(ddebug_add_module);
872
6ab676e9
JC
873/* helper for ddebug_dyndbg_(boot|module)_param_cb */
874static int ddebug_dyndbg_param_cb(char *param, char *val,
875 const char *modname, int on_err)
b48420c1 876{
b48420c1
JC
877 char *sep;
878
879 sep = strchr(param, '.');
880 if (sep) {
6ab676e9 881 /* needed only for ddebug_dyndbg_boot_param_cb */
b48420c1
JC
882 *sep = '\0';
883 modname = param;
884 param = sep + 1;
885 }
886 if (strcmp(param, "dyndbg"))
6ab676e9 887 return on_err; /* determined by caller */
b48420c1 888
8e59b5cf
JC
889 ddebug_exec_queries((val ? val : "+p"), modname);
890
b48420c1
JC
891 return 0; /* query failure shouldnt stop module load */
892}
893
6ab676e9
JC
894/* handle both dyndbg and $module.dyndbg params at boot */
895static int ddebug_dyndbg_boot_param_cb(char *param, char *val,
ecc86170 896 const char *unused, void *arg)
b48420c1 897{
6ab676e9
JC
898 vpr_info("%s=\"%s\"\n", param, val);
899 return ddebug_dyndbg_param_cb(param, val, NULL, 0);
900}
b48420c1 901
6ab676e9
JC
902/*
903 * modprobe foo finds foo.params in boot-args, strips "foo.", and
904 * passes them to load_module(). This callback gets unknown params,
905 * processes dyndbg params, rejects others.
906 */
907int ddebug_dyndbg_module_param_cb(char *param, char *val, const char *module)
908{
909 vpr_info("module: %s %s=\"%s\"\n", module, param, val);
910 return ddebug_dyndbg_param_cb(param, val, module, -ENOENT);
b48420c1
JC
911}
912
e9d376f0
JB
913static void ddebug_table_free(struct ddebug_table *dt)
914{
915 list_del_init(&dt->link);
3e406b1d 916 kfree_const(dt->mod_name);
e9d376f0
JB
917 kfree(dt);
918}
919
920/*
921 * Called in response to a module being unloaded. Removes
922 * any ddebug_table's which point at the module.
923 */
ff49d74a 924int ddebug_remove_module(const char *mod_name)
e9d376f0
JB
925{
926 struct ddebug_table *dt, *nextdt;
927 int ret = -ENOENT;
928
b8ccd5de 929 vpr_info("removing module \"%s\"\n", mod_name);
e9d376f0
JB
930
931 mutex_lock(&ddebug_lock);
932 list_for_each_entry_safe(dt, nextdt, &ddebug_tables, link) {
933 if (!strcmp(dt->mod_name, mod_name)) {
934 ddebug_table_free(dt);
935 ret = 0;
936 }
937 }
938 mutex_unlock(&ddebug_lock);
939 return ret;
940}
941EXPORT_SYMBOL_GPL(ddebug_remove_module);
942
943static void ddebug_remove_all_tables(void)
944{
945 mutex_lock(&ddebug_lock);
946 while (!list_empty(&ddebug_tables)) {
947 struct ddebug_table *dt = list_entry(ddebug_tables.next,
948 struct ddebug_table,
949 link);
950 ddebug_table_free(dt);
951 }
952 mutex_unlock(&ddebug_lock);
953}
954
6a5c083d
TR
955static __initdata int ddebug_init_success;
956
957static int __init dynamic_debug_init_debugfs(void)
e9d376f0
JB
958{
959 struct dentry *dir, *file;
6a5c083d
TR
960
961 if (!ddebug_init_success)
962 return -ENODEV;
e9d376f0
JB
963
964 dir = debugfs_create_dir("dynamic_debug", NULL);
965 if (!dir)
966 return -ENOMEM;
967 file = debugfs_create_file("control", 0644, dir, NULL,
968 &ddebug_proc_fops);
969 if (!file) {
970 debugfs_remove(dir);
971 return -ENOMEM;
972 }
6a5c083d
TR
973 return 0;
974}
975
976static int __init dynamic_debug_init(void)
977{
978 struct _ddebug *iter, *iter_start;
979 const char *modname = NULL;
b48420c1 980 char *cmdline;
6a5c083d 981 int ret = 0;
41076927
JC
982 int n = 0, entries = 0, modct = 0;
983 int verbose_bytes = 0;
6a5c083d 984
b5b78f83 985 if (__start___verbose == __stop___verbose) {
f657fd21 986 pr_warn("_ddebug table is empty in a CONFIG_DYNAMIC_DEBUG build\n");
b5b78f83
JC
987 return 1;
988 }
989 iter = __start___verbose;
990 modname = iter->modname;
991 iter_start = iter;
992 for (; iter < __stop___verbose; iter++) {
41076927
JC
993 entries++;
994 verbose_bytes += strlen(iter->modname) + strlen(iter->function)
995 + strlen(iter->filename) + strlen(iter->format);
996
b5b78f83 997 if (strcmp(modname, iter->modname)) {
41076927 998 modct++;
b5b78f83
JC
999 ret = ddebug_add_module(iter_start, n, modname);
1000 if (ret)
af442399 1001 goto out_err;
b5b78f83
JC
1002 n = 0;
1003 modname = iter->modname;
1004 iter_start = iter;
e9d376f0 1005 }
b5b78f83 1006 n++;
e9d376f0 1007 }
b5b78f83
JC
1008 ret = ddebug_add_module(iter_start, n, modname);
1009 if (ret)
af442399 1010 goto out_err;
a648ec05 1011
af442399 1012 ddebug_init_success = 1;
f657fd21
JP
1013 vpr_info("%d modules, %d entries and %d bytes in ddebug tables, %d bytes in (readonly) verbose section\n",
1014 modct, entries, (int)(modct * sizeof(struct ddebug_table)),
1015 verbose_bytes + (int)(__stop___verbose - __start___verbose));
af442399
JC
1016
1017 /* apply ddebug_query boot param, dont unload tables on err */
a648ec05 1018 if (ddebug_setup_string[0] != '\0') {
f657fd21 1019 pr_warn("ddebug_query param name is deprecated, change it to dyndbg\n");
8e59b5cf 1020 ret = ddebug_exec_queries(ddebug_setup_string, NULL);
85f7f6c0 1021 if (ret < 0)
f657fd21 1022 pr_warn("Invalid ddebug boot param %s\n",
4ad275e5 1023 ddebug_setup_string);
a648ec05 1024 else
85f7f6c0 1025 pr_info("%d changes by ddebug_query\n", ret);
a648ec05 1026 }
b48420c1
JC
1027 /* now that ddebug tables are loaded, process all boot args
1028 * again to find and activate queries given in dyndbg params.
1029 * While this has already been done for known boot params, it
1030 * ignored the unknown ones (dyndbg in particular). Reusing
1031 * parse_args avoids ad-hoc parsing. This will also attempt
1032 * to activate queries for not-yet-loaded modules, which is
1033 * slightly noisy if verbose, but harmless.
1034 */
1035 cmdline = kstrdup(saved_command_line, GFP_KERNEL);
1036 parse_args("dyndbg params", cmdline, NULL,
ecc86170 1037 0, 0, 0, NULL, &ddebug_dyndbg_boot_param_cb);
b48420c1 1038 kfree(cmdline);
af442399 1039 return 0;
a648ec05 1040
af442399
JC
1041out_err:
1042 ddebug_remove_all_tables();
e9d376f0
JB
1043 return 0;
1044}
6a5c083d 1045/* Allow early initialization for boot messages via boot param */
3ec5652a 1046early_initcall(dynamic_debug_init);
b48420c1 1047
6a5c083d 1048/* Debugfs setup must be done later */
3ec5652a 1049fs_initcall(dynamic_debug_init_debugfs);