From: Petr Mladek <pmladek@suse.com>
To: Chris Down <chris@chrisdown.name>
Cc: John Ogness <john.ogness@linutronix.de>,
Sergey Senozhatsky <senozhatsky@chromium.org>,
Steven Rostedt <rostedt@goodmis.org>,
Dave Chinner <david@fromorbit.com>,
"Darrick J . Wong" <djwong@kernel.org>,
linux-kernel@vger.kernel.org
Subject: Re: [PATCH] printk/index: Printk index feature documentation
Date: Wed, 13 Apr 2022 14:39:53 +0200 [thread overview]
Message-ID: <YlbEmZiGXZmhRvQs@alley> (raw)
In-Reply-To: <Ykw0mdX0GXZWJohH@chrisdown.name>
On Tue 2022-04-05 13:22:49, Chris Down wrote:
> Petr Mladek writes:
> > Document the printk index feature. The primary motivation is to
> > explain that it is not creating KABI from particular printk() calls.
> >
> > Signed-off-by: Petr Mladek <pmladek@suse.com>
> > Acked-by: Sergey Senozhatsky <senozhatsky@chromium.org>
>
> This looks great, thanks a lot for spending the time to write this up. Just
> some very minor comments.
Ah, I forgot to do the small fixup when pushing. So, I did it now are rebased.
> > --- /dev/null
> > +++ b/Documentation/core-api/printk-index.rst
> > +User Interface
> > +==============
> > +
> > +The index of printk formats are split in into separate files. The files are
> > +named according to the binaries where the printk formats are built-in. There
> > +is always "vmlinux" and optionally also modules, for example::
> > +
> > + /sys/kernel/debug/printk/index/vmlinux
> > + /sys/kernel/debug/printk/index/ext4
> > + /sys/kernel/debug/printk/index/scsi_mod
> > +
> > +Note that only loaded modules are shown. Also printk formats from a module
> > +might appear in "vmlinux" when the module is built-in.
> > +
> > +The content is inspired by the dynamic debug interface and looks like::
>
> s/::/:/
The double double dots '::' cause that the following paragraph will be
block quoting. There is only single ':' in the generated html.
> > + $> 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"
> > +
> > +, where the meaning is::
I uses only single double dot here.
> > + - level: log level
>
> Maybe worth noting that level may not be there if we have a KERN_CONT.
I added:
- :level: log level value: 0-7 for particular severity, -1 as default,
'c' as continuous line without an explicit log level
> > + - flags: optional flags: currently only 'c' for KERN_CONT
> + - filename:line: source filename and line number of the related
> > + printk() call. Note that there are many wrappers, for example,
> > + pr_warn(), pr_warn_once(), dev_warn().
> > + - function: function name where the printk() call is used.
> > + - format: format string
I added few more double dots to generate bold: 'level', 'flags',
'filename:line', etc.
See the updated commit at
https://git.kernel.org/pub/scm/linux/kernel/git/printk/linux.git/commit/?h=for-5.19&id=a5c7a39f508ae1fd3288493b96dd26079bae41bf
Best Regards,
Petr
next prev parent reply other threads:[~2022-04-13 12:40 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-04-05 11:48 Petr Mladek
2022-04-05 12:22 ` Chris Down
2022-04-13 12:39 ` Petr Mladek [this message]
2022-04-13 11:10 ` Petr Mladek
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=YlbEmZiGXZmhRvQs@alley \
--to=pmladek@suse.com \
--cc=chris@chrisdown.name \
--cc=david@fromorbit.com \
--cc=djwong@kernel.org \
--cc=john.ogness@linutronix.de \
--cc=linux-kernel@vger.kernel.org \
--cc=rostedt@goodmis.org \
--cc=senozhatsky@chromium.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
all inboxes | Powered by JetHome®