From: Mingzhu Wang <mingzhu.wang@transsion.com>
To: "corbet@lwn.net" <corbet@lwn.net>
Cc: "chris@chrisdown.name" <chris@chrisdown.name>,
"skhan@linuxfoundation.org" <skhan@linuxfoundation.org>,
Jiazi Li <jiazi.li@transsion.com>,
Hongyan Xia <hongyan.xia@transsion.com>,
"linux-doc@vger.kernel.org" <linux-doc@vger.kernel.org>,
Mingzhu Wang <mingzhu.wang@transsion.com>
Subject: [PATCH] docs: printk-index: refresh sample index entries
Date: Fri, 3 Jul 2026 01:50:26 +0000 [thread overview]
Message-ID: <20260703014954.780-1-mingzhu.wang@transsion.com> (raw)
From: Mingzhu Wang <mingzhu.wang@transsion.com>
Update the example printk index lines in the User Interface section to
match the current source code. The previous examples contained stale
line numbers, an obsolete function name, and incorrect format strings.
- block/blk-settings.c: disk_stack_limits -> queue_limits_stack_bdev,
and use %pg instead of %s for the device pointer
- kernel/trace/trace.c: update line number for trace_create_file()
- arch/x86/kernel/hpet.c: update line number for _hpet_print_config()
- init/do_mounts.c: prepare_namespace -> wait_for_root, with updated
line number
- drivers/acpi/osl.c: update line number, include the "OSL:" prefix
from pr_fmt(), and fix capitalization of "Auto-serialization"
Signed-off-by: Mingzhu Wang <mingzhu.wang@transsion.com>
---
Documentation/core-api/printk-index.rst | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/Documentation/core-api/printk-index.rst b/Documentation/core-api/printk-index.rst
index 1979c5dd32fe..40023f7dfe98 100644
--- a/Documentation/core-api/printk-index.rst
+++ b/Documentation/core-api/printk-index.rst
@@ -47,11 +47,11 @@ The content is inspired by the dynamic debug interface and looks like::
$> head -1 /sys/kernel/debug/printk/index/vmlinux; shuf -n 5 vmlinux
# <level[,flags]> filename:line function "format"
- <5> block/blk-settings.c:661 disk_stack_limits "%s: Warning: Device %s is misaligned\n"
- <4> kernel/trace/trace.c:8296 trace_create_file "Could not create tracefs '%s' entry\n"
- <6> arch/x86/kernel/hpet.c:144 _hpet_print_config "hpet: %s(%d):\n"
- <6> init/do_mounts.c:605 prepare_namespace "Waiting for root device %s...\n"
- <6> drivers/acpi/osl.c:1410 acpi_no_auto_serialize_setup "ACPI: auto-serialization disabled\n"
+ <5> block/blk-settings.c:955 queue_limits_stack_bdev "%s: Warning: Device %pg is misaligned\n"
+ <4> kernel/trace/trace.c:7861 trace_create_file "Could not create tracefs '%s' entry\n"
+ <6> arch/x86/kernel/hpet.c:147 _hpet_print_config "hpet: %s(%d):\n"
+ <6> init/do_mounts.c:413 wait_for_root "Waiting for root device %s...\n"
+ <6> drivers/acpi/osl.c:1455 acpi_no_auto_serialize_setup "ACPI: OSL: Auto-serialization disabled\n"
, where the meaning is:
@@ -130,7 +130,7 @@ For example, drivers/acpi/osl.c contains::
This results in the following printk index entry::
- <6> drivers/acpi/osl.c:1410 acpi_no_auto_serialize_setup "ACPI: auto-serialization disabled\n"
+ <6> drivers/acpi/osl.c:1455 acpi_no_auto_serialize_setup "ACPI: OSL: Auto-serialization disabled\n"
It helps matching messages from the real log with printk index.
Then the source file name, line number, and function name can
--
2.53.0
next reply other threads:[~2026-07-03 1:50 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-07-03 1:50 Mingzhu Wang [this message]
2026-07-10 19:36 ` [PATCH] docs: printk-index: refresh sample index entries Jonathan Corbet
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260703014954.780-1-mingzhu.wang@transsion.com \
--to=mingzhu.wang@transsion.com \
--cc=chris@chrisdown.name \
--cc=corbet@lwn.net \
--cc=hongyan.xia@transsion.com \
--cc=jiazi.li@transsion.com \
--cc=linux-doc@vger.kernel.org \
--cc=skhan@linuxfoundation.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox