De kernel log buffer

The kernel has a cyclic buffer of size LOG_BUF_LEN in which messages given as arguments to the kernel function printk() are stored (regardless of their log level). In early kernels, LOG_BUF_LEN had the value 4096; from Linux 1.3.54, it was 8192; from Linux 2.1.113, it was 16384; since Linux 2.4.23/2.6, the value is a kernel configuration option (CONFIG_LOG_BUF_SHIFT, default value dependent on the architecture). Since Linux 2.6.6, the size can be queried with command type 10 (see below).

Commando's

Het type argument bepaald de actie die deze functie uitvoert. De lijst hieronder bepaald de waarden van type. De symbolische namen worden gedefinieerd in de kernel broncode, maar worden niet geëxporteerd naar de gebruiker; u zult ofwel getallen moeten gebruiken, of zelf de namen definiëren.

SYSLOG_ACTION_CLOSE (0)

Sluit het log. Momenteel een NOP.

SYSLOG_ACTION_OPEN (1)

Open het log. Momenteel een NOP.

SYSLOG_ACTION_READ (2)

Lees van de log. De aanroep wacht totdat de kernel log buffer niet leeg is, en leest vervolgens op zijn meest len bytes in de buffer aangewezen door bufp. De aanroep retourneert het aantal gelezen bytes. Gelezen bytes van de log verdwijnen uit de log buffer: de informatie kan slecht eenmaal gelezen worden. Dit is de functie die uitgevoerd wordt door de kernel wanneer een gebruikers programma leest van proc/kmsg.

SYSLOG_ACTION_READ_ALL (3)

Lees alle resterende berichten van de ring buffer, en plaats ze in een buffer die aangewezen wordt door bufp. De aanroep leest de laatste len bytes van de log buffer (niet destructief), maar leest niet meer dan was geschreven in de buffer sinds het laatste "wis ring buffer" commando (zie commando 5 hieronder). De aanroep retourneert het aantal gelezen bytes.

SYSLOG_ACTION_READ_CLEAR (4)

Lees en wis alle resterende berichten in de ring buffer. De aanroep doet precies hetzelfde als voor een type van 3, maar voert ook het "wis ring buffer" commando uit.

SYSLOG_ACTION_CLEAR (5)

The call executes just the "clear ring buffer" command. The bufp and size arguments are ignored.

Dit commando wist de ring buffer niet echt. In plaats daarvan zet het een boekhoud variabele in de kernel die de resultaten bepaald die teruggegeven worden door de commando´s 3 3 (SYSLOG_ACTION_READ_ALL) en 4 (SYSLOG_ACTION_READ_CLEAR). Dit commando heeft geen effect op commando´s 2 (SYSLOG_ACTION_READ) en 9 (SYSLOG_ACTION_SIZE_UNREAD).

SYSLOG_ACTION_CONSOLE_OFF (6)

Het commando bewaart de huidige waarde van console_loglevel en zet vervolgens console_loglevel op minimum_console_loglevel, zodat er geen berichten op de console getoond worden. Voor Linux 2.6.32, zet dit commando eenvoudig console_loglevel op minimum_console_loglevel. Zie de discussie over/proc/sys/kernel/printk, hieronder.

The bufp and size arguments are ignored.

SYSLOG_ACTION_CONSOLE_ON (7)

Als een voorgaand SYSLOG_ACTION_CONSOLE_OFF commando wordt uitgevoerd, dan herstelt dit commando console_loglevel naar de waarde die werd bewaard door dat commando. Voor Linux 2.6.32, zette die commando eenvoudig weg console_loglevel op default_console_loglevel. Zie de discussie over /proc/sys/kernel/printk, hieronder.

The bufp and size arguments are ignored.

SYSLOG_ACTION_CONSOLE_LEVEL (8)

The call sets console_loglevel to the value given in size, which must be an integer between 1 and 8 (inclusive). The kernel silently enforces a minimum value of minimum_console_loglevel for size. See the log level section for details. The bufp argument is ignored.

SYSLOG_ACTION_SIZE_UNREAD (9) (sinds Linux 2.4.10)

The call returns the number of bytes currently available to be read from the kernel log buffer via command 2 (SYSLOG_ACTION_READ). The bufp and size arguments are ignored.

SYSLOG_ACTION_SIZE_BUFFER (10) (sinds Linux 2.6.6)

This command returns the total size of the kernel log buffer. The bufp and size arguments are ignored.

Alle commando´s behalve 3 en 10 vereisen privilege. In Linux kernels voor 2.6.37, zijn commando types 3 en 10 toegestaan voor niet-geprivilegieerde processen; vanaf Linux 2.6.37, worden deze commando´s alleen toegestaan aan niet-geprivilegieerde processen als /proc/sys/kernel/dmesg_restrict de waarde 0 heeft. Voor Linux 2.6.37, betekende "geprivilegieerd" dat de aanroeper de CAP_SYS_ADMIN capaciteit had. Vanaf Linux 2.6.37 betekende "geprivilegieerd" dat de aanroeper hetzij de CAP_SYS_ADMIN capaciteit (nu verouderd voor dit doel) of de (nieuwe) CAP_SYSLOG capaciteit.

/proc/sys/kernel/printk

/proc/sys/kernel/printk is een schrijfbaar bestand dat vier gehele getallen bevat die het kernel printk() gedrag beïnvloed bij het tonen of loggen van fout meldingen. De vier waarden zijn:

console_loglevel

Alleen berichten met een log niveau lager dan deze waarden worden getoond in de terminal. De standaard waarde voor dit veld is DEFAULT_CONSOLE_LOGLEVEL (7), maar wordt gezet op 4 als de kernel commando regel het woord "quiet" bevat, 10 als de kernel commando regel het woord "debug" bevat, en op 15 in het geval van een kernel fout (de 10 en 15 zijn een beetje gek, en equivalent aan 8). De waarde van console_loglevel kan worden gezet (op een waarde in het bereik van 1–8) met de syslog() aanroep met een type van 8.

default_message_loglevel

Deze waarde zal worden gebruikt als het log niveau voor printk() berichten die geen expliciet niveau hebben. Tot en met Linux 2.6.38, was de hard-gecodeerde standaard waarde voor dit veld 4 (KERN_WARNING); vanaf Linux 2.6.39, is de standaard waarde gedefinieerd door een kernel configuratie optie CONFIG_DEFAULT_MESSAGE_LOGLEVEL, die standaard op 4 staat.

minimum_console_loglevel

De waarde in dit veld is de minimale waarde op welke console_loglevel kan worden ingesteld.

default_console_loglevel

Dit is de standaard waarde van console_loglevel.

Het log niveau

Elke printk() bericht heeft zijn eigen log niveau. Als dit niveau niet expliciet werd gespecificeerd als onderdeel van het bericht, dan heeft dit de standaardwaarde default_message_loglevel. De gebruikelijke betekenis van het log niveau is als volgt:

De printk kernel routine zal alleen een bericht op de console laten zien als het een log niveau heeft die kleiner is dan de waarde van console_loglevel.