.\" -*- coding: UTF-8 -*- .\" Copyright (C) 1995 Andries Brouwer (aeb@cwi.nl) .\" and Copyright (C) 2012, 2014 Michael Kerrisk .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\" Written 11 June 1995 by Andries Brouwer .\" 2008-02-15, Jeremy Kerr .\" Add info on command type 10; add details on types 6, 7, 8, & 9. .\" 2008-02-15, Michael Kerrisk .\" Update LOG_BUF_LEN details; update RETURN VALUE section. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYSLOG 2 "13 augustus 2020" Linux "Linux Programmeurs Handleiding" .SH NAAM syslog \- lees en/of wis kernel bericht\-ring\-buffer; zet "console_loglevel" .SH SAMENVATTING .nf \fBint syslog(int \fP\fItype\fP\fB, char *\fP\fIbufp\fP\fB, int \fP\fIlen\fP\fB);\fP \fB/* No wrapper provided in glibc */\fP .PP /* Het glibc interface */ \fB#include \fP .PP \fBint klogctl(int \fP\fItype\fP\fB, char *\fP\fIbufw\fP\fB, int \fP\fIlen\fP\fB);\fP .fi .SH BESCHRIJVING \fIOpmerking\fP: Mogelijk zoekt u de C bibliotheek functie \fBsyslog\fP(), die praat met \fBsyslogd\fP(8), zie \fBsyslog\fP(3) voor details. .PP Deze pagina beschrijft de kernel \fBsyslog\fP() systeem aanroep, die wordt gebruikt om de kernel \fIprintk\fP() buffer te controleren, de glibc omwikkel functie voor de systeem aanroep wordt \fBklogctl\fP() genoemd. .SS "De kernel log buffer" .\" Under "General setup" ==> "Kernel log buffer size" .\" For 2.6, precisely the option seems to have appeared in 2.5.55. De kernel heeft een ring buffer met lengte \fBLOG_BUF_LEN\fP waarin berichten die opgegeven werden als argument aan de kernel functie \fBprintk\fP() bewaard worden (ongeacht hun log niveau). In vroegere kernels had \fBLOG_BUF_LEN\fP de waarde 4096; vanaf kernel 1.3.54 was dit 8192; vanaf kernel 2.1.113 was het 16384; en vanaf kernel 2.4.23/2.6 is deze waarde de kernel configuratie optie (\fBCONFIG_LOG_BUF_SHIFT\fP, standaard waarde is afhankelijk van de architectuur). Vanaf Linux 2.6.6, kan de grootte worden opgevraagd met commando type 10 (zie hieronder). .SS Commando's Het \fItype\fP argument bepaald de actie die deze functie uitvoert. De lijst hieronder bepaald de waarden van \fItype\fP. 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. .TP \fBSYSLOG_ACTION_CLOSE\fP (0) Sluit het log. Momenteel een NOP. .TP \fBSYSLOG_ACTION_OPEN\fP (1) Open het log. Momenteel een NOP. .TP \fBSYSLOG_ACTION_READ\fP (2) Lees van de log. De aanroep wacht totdat de kernel log buffer niet leeg is, en leest vervolgens op zijn meest \fIlen\fP bytes in de buffer aangewezen door \fIbufp\fP. 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 \fIproc/kmsg\fP. .TP \fBSYSLOG_ACTION_READ_ALL\fP (3) Lees alle resterende berichten van de ring buffer, en plaats ze in een buffer die aangewezen wordt door \fIbufp\fP. De aanroep leest de laatste \fIlen\fP 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. .TP \fBSYSLOG_ACTION_READ_CLEAR\fP (4) Lees en wis alle resterende berichten in de ring buffer. De aanroep doet precies hetzelfde als voor een \fItype\fP van 3, maar voert ook het "wis ring buffer" commando uit. .TP \fBSYSLOG_ACTION_CLEAR\fP (5) De aanroep voert alleen het "wis ring buffer" commando uit. De \fIbufp\fP en \fIlen\fP argumenten worden genegeerd. .IP 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 (\fBSYSLOG_ACTION_READ_ALL\fP) en 4 (\fBSYSLOG_ACTION_READ_CLEAR\fP). Dit commando heeft geen effect op commando´s 2 (\fBSYSLOG_ACTION_READ\fP) en 9 (\fBSYSLOG_ACTION_SIZE_UNREAD\fP). .TP \fBSYSLOG_ACTION_CONSOLE_OFF\fP (6) .\" commit 1aaad49e856ce41adc07d8ae0c8ef35fc4483245 Het commando bewaart de huidige waarde van \fIconsole_loglevel\fP en zet vervolgens \fIconsole_loglevel\fP op \fIminimum_console_loglevel\fP, zodat er geen berichten op de console getoond worden. Voor Linux 2.6.32, zet dit commando eenvoudig \fIconsole_loglevel\fP op \fIminimum_console_loglevel\fP. Zie de discussie over\fI/proc/sys/kernel/printk\fP, hieronder. .IP De \fIbufp\fP en \fIlen\fP argumenten worden genegeerd. .TP \fBSYSLOG_ACTION_CONSOLE_ON\fP (7) .\" commit 1aaad49e856ce41adc07d8ae0c8ef35fc4483245 Als een voorgaand \fBSYSLOG_ACTION_CONSOLE_OFF\fP commando wordt uitgevoerd, dan herstelt dit commando \fIconsole_loglevel\fP naar de waarde die werd bewaard door dat commando. Voor Linux 2.6.32, zette die commando eenvoudig weg \fIconsole_loglevel\fP op \fIdefault_console_loglevel\fP. Zie de discussie over \fI/proc/sys/kernel/printk\fP, hieronder. .IP De \fIbufp\fP en \fIlen\fP argumenten worden genegeerd. .TP \fBSYSLOG_ACTION_CONSOLE_LEVEL\fP (8) Deze aanroep zet \fIconsole_loglevel\fP op de waarde gegeven in \fIlen\fP, dit dient een geheel getal te zijn met een waarde tussen 1 and 8 (inclusief). De kernel dwingt stilzwijgend een minimum waarde van \fIminimum_console_loglevel\fP al voor \fIlen\fP. Zie de \fIlog level\fP sectie voor details. Het \fIbufp\fP argument wordt genegeerd. .TP \fBSYSLOG_ACTION_SIZE_UNREAD\fP (9) (sinds Linux 2.4.10) De aanroep retourneert het aantal bytes die momenteel beschikbaar zijn om te lezen van de kernel log buffer via het commando 2 (\fBSYSLOG_ACTION_READ\fP). De \fIbufp\fP en \fIlen\fP argumenten worden genegeerd. .TP \fBSYSLOG_ACTION_SIZE_BUFFER\fP (10) (sinds Linux 2.6.6) Het commando retourneert de totale grootte van de kernel log buffer. De \fIbufp\fP en \fIlen\fP argumenten worden genegeerd. .PP .\" .\" Alle commando´s behalve 3 en 10 vereisen privilege. In de Linux kernel voor 2.6.37, commando types 3 en 10 zijn toegestaan voor niet\-geprivilegieerde processen; vanaf Linux 2.6.37, worden deze commando´s alleen toegestaan aan niet\-geprivilegieerde processen als \fI/proc/sys/kernel/dmesg_restrict\fP de waarde 0 heeft. Voor Linux 2.6.37, betekende "geprivilegieerd" dat de aanroeper de \fBCAP_SYS_ADMIN\fP capacitiet had. Vanaf Linux 2.6.37 betekende "geprivilegieerd" dat de aanroeper hetzij de \fBCAP_SYS_ADMIN\fP capaciteit (nu verouderd voor dit doel) of de (nieuwe) \fBCAP_SYSLOG\fP capaciteit. .SS /proc/sys/kernel/printk \fI/proc/sys/kernel/printk\fP is een schrijfbaar bestand dat vier gehele getallen bevat die het kernel \fIprintk()\fP gedrag beïnvloed bij het tonen of loggen van fout meldingen. De vier waarden zijn: .TP \fIconsole_loglevel\fP .\" since Linux 2.4 Alleen berichten met een log niveau lager dan deze waarden worden getoond in de terminal. De standaard waarde voor dit veld is \fBDEFAULT_CONSOLE_LOGLEVEL\fP (7), maar wordt gezet op 4 als de kernel commando regel het woord "quiet" bevat, 10 als de kernel commando regel het worod "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 \fIconsole_loglevel\fP kan worden gezet (op een waarde in het bereik van 1\(en8) met de \fBsyslog\fP() aanroep met een \fItype\fP van 8. .TP \fIdefault_message_loglevel\fP .\" commit 5af5bcb8d37f99ba415a1adc6da71051b84f93a5 Deze waarde zal worden gebruikt als het log niveau voor \fIprintk()\fP berichten die geen expliciet niveau hebben. Tot en met Linux 2.6.38, was de hard\-gecodeerde standaard waarde voor dit veld 4 (\fBKERN_WARNING\fP); vanaf Linux 2.6.39, is de standaard waarde gedefinieerd door een kernel configuratie optie \fBCONFIG_DEFAULT_MESSAGE_LOGLEVEL\fP, die standaard op 4 staat. .TP \fIminimum_console_loglevel\fP De waarde in dit veld is de minimale waarde op welke \fIconsole_loglevel\fP kan worden ingesteld. .TP \fIdefault_console_loglevel\fP .\" .\" Dit is de standaard waarde van \fIconsole_loglevel\fP. .SS "Het log niveau" Elke \fIprintk\fP() bericht heeft zijn eigen log niveau. Als dit niveau niet expliciet werd gespecificeerd als onderdeel van het bericht, dan heeft dit de standaardwaarde \fIdefault_message_loglevel\fP. De gebruikelijke betekenis van het log niveau is als volgt: .TS lB lB lB lB c l. Kernel constanten Niveau waarde Betekenis KERN_EMERG 0 Systeem is onbruikbaar KERN_ALERT 1 Actie moet onmiddellijk genomen worden KERN_CRIT 2 Kritieke toestand KERN_ERR 3 Fouttoestanden KERN_WARNING 4 Waarschuwings toestanden KERN_NOTICE 5 Normale maar belangwekkende toestanden KERN_INFO 6 Informatie KERN_DEBUG 7 Debug\-niveau berichten .TE .sp 1 De \fIprintk\fP kernel routine zal alleen een bericht op de console laten zien als het een log niveau heeft die kleiner is dan de waarde van \fIconsole_loglevel\fP. .SH "EIND WAARDE" Voor \fItype\fP gelijk aan 2,3 of 4 retourneert een succesvolle aanroep van \fBsyslog\fP() het aantal gelezen bytes. Voor \fItype\fP 9, retourneert \fBsyslog\fP() het aantal momentaan beschikbare bytes die van de kernel log buffer gelezen kunnen worden. Voor \fItype\fP 10, retourneert \fBsyslog\fP() de totale grootte van de kernel log buffer. Voor andere waarden van \fItype\fP, wordt een 0 teruggegeven bij succes. .PP In het geval van een fout wordt \-1 teruggegeven, en \fIerrno\fP wordt gezet om de fout te indiceren. .SH FOUTEN .TP \fBEINVAL\fP Ongeldig argument (b.v. fout \fItype\fP; of voor \fItype\fP 2,3, of 4, \fIbuf\fP is NULL, of \fIlen\fP is kleiner dan nul; of voor \fItype\fP 8, het \fIlevel\fP is buiten het 1 tot 8 bereik. .TP \fBENOSYS\fP De \fBsyslog\fP() systeem aanroep is niet beschikbaar, omdat de kernel werd gecompileerd met de uitgeschakelde \fBCONFIG_PRINTK\fP kernel\-configuratie optie. .TP \fBEPERM\fP Een poging werd gedaan om console_loglevel te veranderen of de kernel berichten ring buffer te wissen door een proces zonder voldoende privilege (preciezer: zonder de \fBCAP_SYS_ADMIN\fP of \fBCAP_SYSLOG\fP capaciteit). .TP \fBERESTARTSYS\fP Systeem aanroep werd onderbroken door een signaal; \- niets werd gelezen. (Dit kan alleen worden gezien gedurende een trace.) .SH "VOLDOET AAN" Deze functie is Linux\-specifiek, en zou niet gebruikt moeten worden in programma's die als overdraagbaar bedoeld zijn. .SH OPMERKINGEN .\" In libc4 and libc5 the number of this call was defined by .\" .BR SYS_klog . .\" In glibc 2.0 the syscall is baptized .\" .BR klogctl (). Vanaf het begin merkten mensen op dat het ongelukkig was dat een systeem aanroep en een bibliotheek routine met dezelfde naam erg verschillende beesten zijn. .SH "ZIE OOK" \fBdmesg\fP(1), \fBsyslog\fP(3), \fBcapabilities\fP(7) .SH COLOFON Deze pagina is onderdeel van release 5.10 van het Linux \fIman\-pages\fP\-project. Een beschrijving van het project, informatie over het melden van bugs en de nieuwste versie van deze pagina zijn op \%https://www.kernel.org/doc/man\-pages/ te vinden. .PP .SH VERTALING De Nederlandse vertaling van deze handleiding is geschreven door Jos Boersema , Mario Blättermann en Luc Castermans . .PP Deze vertaling is vrije documentatie; lees de .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE of later over de Copyright-voorwaarden. Er is geen AANSPRAKELIJKHEID. .PP Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar .MT debian-l10n-dutch@lists.debian.org .ME .