Skip to content

Commit

Permalink
netconsole: docs: document the task name feature
Browse files Browse the repository at this point in the history
Add documentation for the netconsole task name feature in
Documentation/networking/netconsole.rst. This explains how to enable
task name via configfs and demonstrates the output format.

The documentation includes:
- How to enable/disable the feature via taskname_enabled
- The format of the task name in the output
- An example showing the task name appearing in messages

Signed-off-by: Breno Leitao <leitao@debian.org>
Reviewed-by: Simon Horman <horms@kernel.org>
Signed-off-by: Paolo Abeni <pabeni@redhat.com>
  • Loading branch information
Breno Leitao authored and Paolo Abeni committed Mar 4, 2025
1 parent dd30ae5 commit 7010b61
Showing 1 changed file with 28 additions and 0 deletions.
28 changes: 28 additions & 0 deletions Documentation/networking/netconsole.rst
Original file line number Diff line number Diff line change
Expand Up @@ -240,6 +240,34 @@ Delete `userdata` entries with `rmdir`::

It is recommended to not write user data values with newlines.

Task name auto population in userdata
-------------------------------------

Inside the netconsole configfs hierarchy, there is a file called
`taskname_enabled` under the `userdata` directory. This file is used to enable
or disable the automatic task name population feature. This feature
automatically populates the current task name that is scheduled in the CPU
sneding the message.

To enable task name auto-population::

echo 1 > /sys/kernel/config/netconsole/target1/userdata/taskname_enabled

When this option is enabled, the netconsole messages will include an additional
line in the userdata field with the format `taskname=<task name>`. This allows
the receiver of the netconsole messages to easily find which application was
currently scheduled when that message was generated, providing extra context
for kernel messages and helping to categorize them.

Example::

echo "This is a message" > /dev/kmsg
12,607,22085407756,-;This is a message
taskname=echo

In this example, the message was generated while "echo" was the current
scheduled process.

CPU number auto population in userdata
--------------------------------------

Expand Down

0 comments on commit 7010b61

Please sign in to comment.