* [Bug 97161] New: bootparam(7): 'debug' parameter: reference to <linux/kernel.h> for information on log levels is misleading.
@ 2015-04-23 17:07 bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
[not found] ` <bug-97161-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/>
0 siblings, 1 reply; 4+ messages in thread
From: bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r @ 2015-04-23 17:07 UTC (permalink / raw
To: linux-man-u79uwXL29TY76Z2rM5mHXA
https://bugzilla.kernel.org/show_bug.cgi?id=97161
Bug ID: 97161
Summary: bootparam(7): 'debug' parameter: reference to
<linux/kernel.h> for information on log levels is
misleading.
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
Assignee: documentation_man-pages-ztI5WcYan/vQLgFONoPN62D2FQJk+8+b@public.gmane.org
Reporter: a.c.kalker-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
Regression: No
The section on the 'debug' parameter refers the user to <linux/kernel.h> for
more information on kernel log levels, however, that file contains neither a
description of console_loglevel nor nor a description of the various log
levels.
The closest I can find is <include/linux/kern_levels.h>, which defines the
various log levels but doesn't explain console_loglevel, Also, it only exists
in recent kernels, version 3.5 and up.
Another candidate would be <include/linux/printk.h>, which does define
console_loglevel but doesn't explain the individual log levels.
Perhaps both references (<include/linux/printk.h>,
<include/linux/kern_levels.h>) could be included?
Kind regards,
Alain
--
You are receiving this mail because:
You are watching the assignee of the bug.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 4+ messages in thread
* [Bug 97161] bootparam(7): 'debug' parameter: reference to <linux/kernel.h> for information on log levels is misleading.
[not found] ` <bug-97161-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/>
@ 2015-04-23 17:10 ` bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
2015-04-23 22:19 ` bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
2015-04-24 11:50 ` bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
2 siblings, 0 replies; 4+ messages in thread
From: bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r @ 2015-04-23 17:10 UTC (permalink / raw
To: linux-man-u79uwXL29TY76Z2rM5mHXA
https://bugzilla.kernel.org/show_bug.cgi?id=97161
--- Comment #1 from Alain Kalker <a.c.kalker-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> ---
Found in Arch Linux, package man-pages 3.83-1. Confirmed in
http://man7.org/linux/man-pages/man7/bootparam.7.html
--
You are receiving this mail because:
You are watching the assignee of the bug.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 4+ messages in thread
* [Bug 97161] bootparam(7): 'debug' parameter: reference to <linux/kernel.h> for information on log levels is misleading.
[not found] ` <bug-97161-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/>
2015-04-23 17:10 ` [Bug 97161] " bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
@ 2015-04-23 22:19 ` bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
2015-04-24 11:50 ` bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
2 siblings, 0 replies; 4+ messages in thread
From: bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r @ 2015-04-23 22:19 UTC (permalink / raw
To: linux-man-u79uwXL29TY76Z2rM5mHXA
https://bugzilla.kernel.org/show_bug.cgi?id=97161
Stéphane Aulery <saulery-lkSrsyIBln0dnm+yROfE0A@public.gmane.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |saulery-lkSrsyIBln0dnm+yROfE0A@public.gmane.org
--- Comment #2 from Stéphane Aulery <saulery-lkSrsyIBln0dnm+yROfE0A@public.gmane.org> ---
Hello Alain and Michael,
We can quote every level rather than refer to two files.
What do you think about, Michael?
Regards,
--
Stéphane Aulery
--
You are receiving this mail because:
You are watching the assignee of the bug.--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 4+ messages in thread
* [Bug 97161] bootparam(7): 'debug' parameter: reference to <linux/kernel.h> for information on log levels is misleading.
[not found] ` <bug-97161-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/>
2015-04-23 17:10 ` [Bug 97161] " bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
2015-04-23 22:19 ` bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
@ 2015-04-24 11:50 ` bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
2 siblings, 0 replies; 4+ messages in thread
From: bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r @ 2015-04-24 11:50 UTC (permalink / raw
To: linux-man-u79uwXL29TY76Z2rM5mHXA
https://bugzilla.kernel.org/show_bug.cgi?id=97161
Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
CC| |mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
Resolution|--- |CODE_FIX
--- Comment #3 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> ---
(In reply to Alain Kalker from comment #0)
> The section on the 'debug' parameter refers the user to <linux/kernel.h> for
> more information on kernel log levels, however, that file contains neither a
> description of console_loglevel nor nor a description of the various log
> levels.
>
> The closest I can find is <include/linux/kern_levels.h>, which defines the
> various log levels but doesn't explain console_loglevel, Also, it only
> exists in recent kernels, version 3.5 and up.
> Another candidate would be <include/linux/printk.h>, which does define
> console_loglevel but doesn't explain the individual log levels.
>
> Perhaps both references (<include/linux/printk.h>,
> <include/linux/kern_levels.h>) could be included?
Hello Alain,
I must say I'm generally quite unhappy with the sate of the bootparam(7) page.
I'm actually not sure that it was ever a good idea to create it to begin with.
But that happened 20 years ago, well before my time as maintainer. As it is
now, the page is *horribly( dated, and your report made me seriously think of
just removing the page! As it is, I have settled for discarding 60% of the
page, and fixing a few of the more glaring errors in the remainder. Regarding
your report, I amended the test on 'debug' to read:
Boot arguments for use by kernel developers
'debug'
Kernel messages are handed off to a daemon (e.g.,
klogd(8) or similar) so that they may be logged to disk.
Messages with a priority above console_loglevel are also
printed on the console. (For a discussion of these lev‐
els, see syslog(2).) By default, console_loglevel is
set to log messages at levels higher than KERN_DEBUG.
This boot argument will cause the kernel to also print
messages logged at level KERN_DEBUG. The console
loglevel can also be set on a booted system via the
/proc/sys/kernel/printk file (described in syslog(2)),
the syslog(2) SYSLOG_ACTION_CONSOLE_LEVEL operation, or
dmesg(8).
I believe that should address your concerns, so I'm closing the bug.
Cheers,
Michael
--
You are receiving this mail because:
You are watching the assignee of the bug.--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2015-04-24 11:50 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-04-23 17:07 [Bug 97161] New: bootparam(7): 'debug' parameter: reference to <linux/kernel.h> for information on log levels is misleading bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
[not found] ` <bug-97161-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/>
2015-04-23 17:10 ` [Bug 97161] " bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
2015-04-23 22:19 ` bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
2015-04-24 11:50 ` bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.