New: bootparam(7): 'debug' parameter: reference to <linux/kernel.h> for information on log levels is misleading.
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/[email protected]
Reporter: [email protected]
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
Signature · 6 lines
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 [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): bug-97161-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/
[Bug 97161] bootparam(7): 'debug' parameter: reference to <linux/kernel.h> for information on log levels is misleading.
https://bugzilla.kernel.org/show_bug.cgi?id=97161
--- Comment #1 from Alain Kalker <[email protected]> --- Found in Arch Linux, package man-pages 3.83-1. Confirmed in
http://man7.org/linux/man-pages/man7/bootparam.7.html
Signature · 6 lines
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 [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 97161] bootparam(7): 'debug' parameter: reference to <linux/kernel.h> for information on log levels is misleading.
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=97161
Stéphane Aulery <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected]
--- Comment #2 from Stéphane Aulery <[email protected]> --- Hello Alain and Michael,
We can quote every level rather than refer to two files.
What do you think about, Michael?
Regards,
Signature · 8 lines
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 [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
[Bug 97161] bootparam(7): 'debug' parameter: reference to <linux/kernel.h> for information on log levels is misleading.
In reply to a message not in the archivehttps://bugzilla.kernel.org/show_bug.cgi?id=97161
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
CC| |[email protected]
Resolution|--- |CODE_FIX--- Comment #3 from Michael Kerrisk <[email protected]> --- (In reply to Alain Kalker from comment #0)
Quoted 5 lines
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 ofconsole_loglevelnor nor a description of the various log levels.
Quoted 8 lines
The closest I can find is <
include/linux/kern_levels.h>, which defines the various log levels but doesn't explainconsole_loglevel, Also, it only exists in recent kernels, version 3.5 and up.
Another candidate would be <include/linux/printk.h>, which does defineconsole_loglevelbut 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
Signature · 5 lines
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 [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html