linux-stable.git/Documentation/dynamic-debug-howto.txt, branch linux-4.2.y

doc: spelling error changes

2014-05-05T13:32:05+00:00

Fixed multiple spelling errors.

Acked-by: Randy Dunlap 
Signed-off-by: Carlos E. Garcia 
Signed-off-by: Jiri Kosina

dynamic-debug-howto.txt: update since new wildcard support

2014-01-24T00:36:55+00:00

Add the usage of using new feature wildcard support.

Signed-off-by: Du, Changbin 
Cc: Jason Baron 
Cc: Joe Perches 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

doc: fix misspellings with 'codespell' tool

2013-05-28T10:02:12+00:00

Signed-off-by: Anatol Pomozov 
Signed-off-by: Jiri Kosina

dynamic_debug: dynamic hex dump

2013-01-17T20:19:09+00:00

Introduce print_hex_dump_debug() that can be dynamically controlled, similar to
pr_debug.

Also, make print_hex_dump_bytes() dynamically controlled

Implement only 'p' flag (_DPRINTK_FLAGS_PRINT) to keep it simple since hex dump prints
multiple lines and long prefix would impact readability.
To provide line/file etc. information, use pr_debug or similar
before/after print_hex_dump_debug()

Signed-off-by: Vladimir Kondratiev 
Signed-off-by: Jason Baron 
Signed-off-by: Greg Kroah-Hartman

dynamic_debug: update Documentation/*, Kconfig.debug

2012-04-30T20:26:30+00:00

In dynamic-debug-howto.txt:

- add section: Debug Messages at Module Initialization Time
- update flags indicators in example outputs to include '='
- make flags descriptions tabular
- add item on '_' flag-char
- add dyndbg, boot-args examples
- rewrap some paragraphs with long lines

In Kconfig.debug, note that compiling with -DDEBUG enables all
pr_debug()s in that code.

In kernel-parameters.txt, add dyndbg and module.dyndbg items,
and deprecate ddebug_query.

Signed-off-by: Jim Cromie 
Acked-by: Jason Baron 
Signed-off-by: Greg Kroah-Hartman

dynamic_debug: process multiple debug-queries on a line

2012-01-24T20:50:36+00:00

Insert ddebug_exec_queries() in place of ddebug_exec_query().  It
splits the query string on [;\n], and calls ddebug_exec_query() on
each.  All queries are processed independent of errors, allowing a
query to fail, for example when a module is not installed.  Empty
lines and comments are skipped.  Errors are counted, and the last
error seen (negative) or the number of callsites found (0 or positive)
is returned.  Return code checks are altered accordingly.

With this, multiple queries can be given in ddebug_query, allowing
more selective enabling of callsites.  As a side effect, a set of
commands can be batched in:

	cat cmd-file > $DBGMT/dynamic_debug/control

We dont want a ddebug_query syntax error to kill the dynamic debug
facility, so dynamic_debug_init() zeros ddebug_exec_queries()'s return
code after logging the appropriate message, so that ddebug tables are
preserved and $DBGMT/dynamic_debug/control file is created.  This
would be appropriate even without accepting multiple queries.

This patch also alters ddebug_change() to return number of callsites
matched (which typically is the same as number of callsites changed).
ddebug_exec_query() also returns the number found, or a negative value
if theres a parse error on the query.

Splitting on [;\n] prevents their use in format-specs, but selecting
callsites on punctuation is brittle anyway, meaningful and selective
substrings are more typical.

Note: splitting queries on ';' before handling trailing #comments
means that a ';' also terminates a comment, and text after the ';' is
treated as another query.  This trailing query will almost certainly
result in a parse error and thus have no effect other than the error
message.  The double corner case with unexpected results is:

     ddebug_query="func foo +p # enable foo ; +p"

Signed-off-by: Jim Cromie 
Signed-off-by: Jason Baron 
Signed-off-by: Greg Kroah-Hartman

dynamic_debug: add trim_prefix() to provide source-root relative paths

2012-01-24T20:48:55+00:00

trim_prefix(path) skips past the absolute source path root, and
returns the pointer to the relative path from there.  It is used to
shorten the displayed path in $DBGMT/dynamic_debug/control via
ddebug_proc_show(), and in ddebug_change() to allow relative filenames
to be used in applied queries.  For example:

  ~# echo file kernel/freezer.c +p > $DBGMT/dynamic_debug/control

  kernel/freezer.c:128 [freezer]cancel_freezing p "  clean up: %s\012"

trim_prefix(path) insures common prefix before trimming it, so
out-of-tree module paths are shown as full absolute paths.

Signed-off-by: Jim Cromie 
Signed-off-by: Jason Baron 
Signed-off-by: Greg Kroah-Hartman

Merge branch 'docs-next' of git://git.lwn.net/linux-2.6

2011-03-28T02:46:59+00:00

* 'docs-next' of git://git.lwn.net/linux-2.6:
  docs: update the development process document
  docs: fix dev_debug() braino in dynamic-debug-howto.txt

docs: fix dev_debug() braino in dynamic-debug-howto.txt

2011-03-25T16:42:17+00:00

While looking at dynamic-debug-howto.txt, I noticed that it references
dev_debug() (which doesn't exist) instead of dev_dbg() (which does
exist).  I'm lazy, so I choose to fix the document rather than changing
every dev_dbg() call.

Signed-off-by: Jonathan Corbet

Dynamic debug: Add more flags

2011-02-03T23:39:16+00:00

Add flags that allow the user to specify via debugfs whether or not the
module name, function name, line number and/or thread ID have to be
included in the printed message.

Signed-off-by: Bart Van Assche 
Cc: Greg Banks 
Cc: Konrad Rzeszutek Wilk 
Signed-off-by: Greg Kroah-Hartman