printk
printk is a printf-like function of the Linux kernel interface for formatting and writing kernel log entries.[1] Since the C standard library (which contains the ubiquitous printf-like functions) is not available in kernel mode, printk provides for general-purpose output in the kernel.[2] Due to limitations of the kernel design, the function is often used to aid debugging kernel mode software.[1]
printk can be called from anywhere in the kernel except during early stages of the boot process; before the system console is initialized.[3] The alternative function early_printk is implemented on some architectures and is used identically to printk but during the early stages of the boot process.[3]
Use
[edit]printk has the same syntax as printf, but somewhat different semantics. Like printf, printk accepts a format c-string argument and a list of value arguments[1]. Both format text based on the input parameters and with significantly similar behavior, but there are also significant differences.[1] The printk function prototype (which matches that of printf) is:
int printk(const char *format, ...);
The features different from printf are described below.
Log level
[edit]printk allows a caller to specify a log level – the type and importance of the message being sent. The level is specified by prepending text that identifies a log level. Typically the text is prepended via C's string literal concatenation and via one of the macros designed for this purpose. For example, a message could be logged at the informational level as:[1]
printk(KERN_INFO "Message: %s", arg)
The text specifying the log level consists of the ASCII SOH character followed by a digit that identifies the log level or the letter 'c' to indicate the message is a continuation of the previous message.[1][4] The following table lists each log level with its canonical meaning.[3]
| 0 | KERN_EMERG | An emergency condition; the system is probably dead |
| 1 | KERN_ALERT | A problem that requires immediate attention |
| 2 | KERN_CRIT | A critical condition |
| 3 | KERN_ERR | An error |
| 4 | KERN_WARNING | A warning |
| 5 | KERN_NOTICE | A normal, but perhaps noteworthy, condition |
| 6 | KERN_INFO | An informational message |
| 7 | KERN_DEBUG | A debug message |
When no log level is specified, the entry is logged as the default level which is typically KERN_WARNING,[1] but can be set; such as via the loglevel= boot argument.[5]
Log levels are defined in header file <linux/kern_levels.h>.[4] Which log levels are printed is configured using the sysctl file /proc/sys/kernel/printk.[1]
Pointer formats
[edit]The %p format specifier which is supported by printf, is extended with additional formatting modes. For example, requesting to print a struct sockaddr * using %pISpc formats an IPv4/v6 address and port in a human-friendly format such as 1.2.3.4:12345 or [1:2:3:4:5:6:7:8]:
No floating point support
[edit]While printf supports formatting floating point numbers, printk does not,[6] since the Linux kernel does not support floating point numbers.[7]
Implementation
[edit]The function tries to lock the semaphore controlling access to the Linux system console.[1][8] If it succeeds, the output is logged and the console drivers are called.[1] If it is not possible to acquire the semaphore the output is placed into the log buffer, and the current holder of the console semaphore will notice the new output when they release the console semaphore and will send the buffered output to the console before releasing the semaphore.[1]
One effect of this deferred printing is that code which calls printk and then changes the log levels to be printed may break. This is because the log level to be printed is inspected when the actual printing occurs.[1]
References
[edit]- ^ a b c d e f g h i j k l "Message logging with printk — The Linux Kernel documentation". www.kernel.org. Retrieved September 9, 2020.
- ^ ISO/IEC 9899:2018. International Standards Organization. 2018.
- ^ a b c "printk()". archive.is. August 30, 2007. Archived from the original on August 30, 2007. Retrieved September 9, 2020.
- ^ a b "kern_levels.h". GitHub. Retrieved September 27, 2020.
- ^ "The kernel's command-line parameters". kernel.org. Retrieved September 27, 2023.
- ^ a b "How to get printk format specifiers right — The Linux Kernel documentation". www.kernel.org. Retrieved September 9, 2020.
- ^ "Re: Linux kernel and floating point". www.redhat.com. Archived from the original on July 21, 2019. Retrieved September 9, 2020.
- ^ "Driver Basics — The Linux Kernel documentation". www.kernel.org. Retrieved September 9, 2020.