Skip to content

Commit

Permalink
doc-dyndbg: describe "class CLASS_NAME" query support
Browse files Browse the repository at this point in the history
Add an explanation of the new "class CLASS_NAME" syntax and meaning,
noting that the module determines if CLASS_NAME applies to it.

Signed-off-by: Jim Cromie <jim.cromie@gmail.com>
Link: https://lore.kernel.org/r/20220904214134.408619-19-jim.cromie@gmail.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
  • Loading branch information
jimc authored and gregkh committed Sep 7, 2022
1 parent a4a2a42 commit 753914e
Showing 1 changed file with 11 additions and 0 deletions.
11 changes: 11 additions & 0 deletions Documentation/admin-guide/dynamic-debug-howto.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@ Dynamic debug has even more useful features:
- line number (including ranges of line numbers)
- module name
- format string
- class name (as known/declared by each module)

* Provides a debugfs control file: ``<debugfs>/dynamic_debug/control``
which can be read to display the complete list of known debug
Expand Down Expand Up @@ -142,6 +143,7 @@ against. Possible keywords are:::
'file' string |
'module' string |
'format' string |
'class' string |
'line' line-range

line-range ::= lineno |
Expand Down Expand Up @@ -203,6 +205,15 @@ format
format "nfsd: SETATTR" // a neater way to match a format with whitespace
format 'nfsd: SETATTR' // yet another way to match a format with whitespace

class
The given class_name is validated against each module, which may
have declared a list of known class_names. If the class_name is
found for a module, callsite & class matching and adjustment
proceeds. Examples::

class DRM_UT_KMS # a DRM.debug category
class JUNK # silent non-match

line
The given line number or range of line numbers is compared
against the line number of each ``pr_debug()`` callsite. A single
Expand Down

0 comments on commit 753914e

Please sign in to comment.