'\" t
.\"     Title: dmesg
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-03
.\"    Manual: Dienstprogramme für Benutzer
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "DMESG" "1" "2024-04-03" "util\-linux 2.40" "Dienstprogramme für Benutzer"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "BEZEICHNUNG"
dmesg \- den Kernel\-Ringpuffer anzeigen und steuern
.SH "ÜBERSICHT"
.sp
\fBdmesg\fP [options]
.sp
\fBdmesg\fP \fB\-\-clear\fP
.sp
\fBdmesg\fP \fB\-\-read\-clear\fP [options]
.sp
\fBdmesg\fP \fB\-\-console\-level\fP \fIlevel\fP
.sp
\fBdmesg\fP \fB\-\-console\-on\fP
.sp
\fBdmesg\fP \fB\-\-console\-off\fP
.SH "BESCHREIBUNG"
.sp
\fBdmesg\fP is used to examine or control the kernel ring buffer.
.sp
Die Vorgabeaktion beinhaltet das Anzeigen aller Meldungen des Kernel\-Ringpuffers.
.SH "OPTIONEN"
.sp
Die Optionen \fB\-\-clear\fP, \fB\-\-read\-clear\fP, \fB\-\-console\-on\fP, \fB\-\-console\-off\fP und \fB\-\-console\-level\fP schließen sich gegenseitig aus.
.sp
\fB\-C\fP, \fB\-\-clear\fP
.RS 4
leert den Ringpuffer.
.RE
.sp
\fB\-c\fP, \fB\-\-read\-clear\fP
.RS 4
löscht den Inhalt des Ringpuffers, nachdem dessen Inhalt ausgegeben wurde.
.RE
.sp
\fB\-D\fP, \fB\-\-console\-off\fP
.RS 4
deaktiviert die Ausgabe der Meldungen in der Konsole.
.RE
.sp
\fB\-d\fP, \fB\-\-show\-delta\fP
.RS 4
zeigt den Zeitstempel und die zwischen den Meldungen vergangene Zeit an. Wenn Sie dies zusammen mit \fB\-\-notime\fP verwenden, werden nur die Zeiträume ohne Zeitstempel angezeigt.
.RE
.sp
\fB\-E\fP, \fB\-\-console\-on\fP
.RS 4
aktiviert die Ausgabe der Meldungen in der Konsole.
.RE
.sp
\fB\-e\fP, \fB\-\-reltime\fP
.RS 4
zeigt die lokale Zeit und den Zeitversatz im menschenlesbaren Format an. Denken Sie daran, dass die Umwandlung in die lokale Zeit ungenau sein kann. Weitere Details finden Sie in den Erläuterungen zu \fB\-T\fP.
.RE
.sp
\fB\-F\fP, \fB\-\-file\fP \fIDatei\fP
.RS 4
liest die Syslog\-Nachrichten aus der angegebenen \fIDatei\fP. Beachten Sie, dass \fB\-F\fP keine Nachrichten im Kmsg\-Format unterstützt. Siehe \fB\-K\fP als Alternative.
.RE
.sp
\fB\-f\fP, \fB\-\-facility\fP \fIListe\fP
.RS 4
begrenzt die Ausgabe auf eine (durch Kommata getrennte) \fIListe\fP der Einrichtungen. Zum Beispiel gibt
.sp
\fBdmesg \-\-facility=daemon\fP
.sp
ausschließlich Meldungen von Daemons (Systemdiensten) aus. Eine Liste aller möglichen Einrichtungen finden Sie in der Ausgabe des Befehls mit der Option \fB\-\-help\fP.
.RE
.sp
\fB\-H\fP, \fB\-\-human\fP
.RS 4
aktiviert die menschenlesbare Ausgabe. Siehe auch die Optionen \fB\-\-color\fP, \fB\-\-reltime\fP und \fB\-\-nopager\fP.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
verwendet das JSON\-Ausgabeformat. Die Zeit kann nur im Format »Sekunden.Mikrosekunden« angegeben werden und die Prioritätsstufe der Protokollierung wird standardmäßig nicht ausgewertet (verwenden Sie \fB\-\-decode\fP, um zwischen Einrichtung und Priorität zu teilen). Die anderen Optionen zur Steuerung des Ausgabe\- oder Zeitformats werden stillschweigend ignoriert.
.RE
.sp
\fB\-K\fP, \fB\-\-kmsg\-file\fP \fIDatei\fP
.RS 4
liest die /dev/kmsg\-Meldungen aus der angegebenen \fIDatei\fP. Die Datensätze werden wie üblich durch ein NULL\-Byte getrennt.
.RE
.sp
\fB\-k\fP, \fB\-\-kernel\fP
.RS 4
gibt Kernelmeldungen aus.
.RE
.sp
\fB\-L\fP, \fB\-\-color\fP[=\fIwann\fP]
.RS 4
stellt die Ausgabe farbig dar. Das optionale Argument \fIwann\fP kann \fBauto\fP, \fBnever\fP oder \fBalways\fP sein. Falls \fIwann\fP nicht angegeben ist, ist \fBauto\fP die Voreinstellung. Die Farben können deaktiviert werden, für die aktuellen eingebauten Vorgabewerte schauen Sie sich die Ausgabe von \fB\-\-help\fP an. Siehe auch den Abschnitt \fBFARBEN\fP weiter unten.
.RE
.sp
\fB\-l\fP, \fB\-\-level\fP \fIListe\fP
.RS 4
beschränkt die Ausgabe auf die (durch Kommata getrennte) \fIListe\fP der Stufen. Zum Beispiel gibt
.sp
\fBdmesg \-\-level=err,warn\fP
.sp
gibt nur Fehlermeldungen und Warnungen aus. Rufen Sie \fBdmesg \-\-help\fP auf, um eine Liste aller unterstützten Stufen zu sehen.
.sp
Anhängen eines \fB+\fP an einen Stufennamen schließt alle höheren Stufen ein. Zum Beispiel gibt
.sp
\fBdmesg \-\-level=err+\fP
.sp
die Stufen \fBerr\fP, \fBcrit\fP, \fBalert\fP und \fBemerg\fP aus.
.sp
Voranstellen schließt alle niedrigeren Stufen ein.
.RE
.sp
\fB\-n\fP, \fB\-\-console\-level\fP \fIStufe\fP
.RS 4
setzt die \fIStufe\fP (die Protokollierstufe) für die Ausgabe der Meldungen in der Konsole. \fIStufe\fP ist dabei als Nummer oder Abkürzung des Namens der Stufe anzugeben. Rufen Sie \fBdmesg \-\-help\fP auf, um eine Liste der unterstützten Stufen anzeigen zu lassen.
.sp
Zum Beispiel unterdrücken \fB\-n 1\fP oder \fB\-n emerg\fP alle Meldungen außer Notfallmeldungen (»panic«). Sämtliche Nachrichtenstufen werden noch nach \fI/proc/kmsg\fP geschrieben, so dass Sie mit \fBsyslogd\fP(8) steuern können, wo Kernelmeldungen erscheinen. Mit der Option \fB\-n\fP gibt \fBdmesg\fP \fIkeine\fP Meldungen aus und löscht den Ringpuffer nicht.
.RE
.sp
\fB\-\-noescape\fP
.RS 4
Die nicht darstellbaren und potenziell unsicheren Zeichen (zum Beispiel beschädigte Multibyte\-Sequenzen, Terminal\-Steuerzeichen usw.) werden aus Sicherheitsgründen standardmäßig im Format \(rsx<hex> maskiert. Diese Option deaktiviert dieses Funktionsmerkmal völlig. Es ist zum Beispiel zusammen mit \fB\-\-raw\fP für Debugging\-Zwecke nützlich. Seien Sie vorsichtig und verwenden Sie es nicht standardmäßig.
.RE
.sp
\fB\-P\fP, \fB\-\-nopager\fP
.RS 4
leitet die Ausgabe nicht an ein Textanzeigeprogramm weiter. Ein Textanzeigeprogramm ist in der Voreinstellung aktiviert, wenn die Option \fB\-\-human\fP verwendet wird.
.RE
.sp
\fB\-p\fP, \fB\-\-force\-prefix\fP
.RS 4
Fügt Einrichtungs\-, Stufen\- oder Zeitstempelinformationen zu jeder Zeile einer mehrzeiligen Nachricht hinzu.
.RE
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
zeigt den unverarbeiteten Meldungspuffer an. Die Präfixe der Protokollierstufen werden nicht entfernt, aber alle nicht darstellbaren Zeichen sind noch maskiert (siehe auch \fB\-\-noescape\fP).
.sp
Beachten Sie, dass das reale unverarbeitete Format davon abhängt, wie \fBdmesg\fP Kernelmeldungen liest. Das Gerät /dev/kmsg verwendet ein anderes Format als \fBsyslog\fP(2). Um Abwärtskompatibilität zu gewährleisten, gibt \fBdmesg\fP die Daten stets im \fBsyslog\fP(2)\-Format zurück. Es ist dennoch möglich, dass die echten Rohdaten, beispielsweise mit dem Befehl »dd if=/dev/kmsg iflag=nonblock« aus \fI/dev/kmsg\fP gelesen werden.
.RE
.sp
\fB\-S\fP, \fB\-\-syslog\fP
.RS 4
erzwingt, dass \fBdmesg\fP die \fBsyslog\fP(2)\-Kernelschnittstelle zum Lesen der Kernelmeldungen verwendet. In der Voreinstellung wird seit Kernel 3.5.0 \fI/dev/kmsg\fP anstatt \fBsyslog\fP(2) bevorzugt.
.RE
.sp
\fB\-s\fP, \fB\-\-buffer\-size\fP \fIGröe\fP
.RS 4
verwendet einen Puffer der angegebenen \fIGröße\fP zur Abfrage des Kernel\-Ringpuffers. Die vorgegebene Größe ist 16392. (Die Vorgabegröße war in der Vergangenheit zunächst 4096, dann 8192 seit Kernel 1.3.54 und 16384 seit Kernel 2.1.113) Falls Sie den Kernelpuffer größer gewählt haben als die Vorgabe, kann diese Option zur Anzeige des gesamten Puffers verwendet werden.
.RE
.sp
\fB\-T\fP, \fB\-\-ctime\fP
.RS 4
gibt menschenlesbare Zeitstempel aus.
.sp
\fBBe aware that the timestamp could be inaccurate!\fP The \fBtime\fP source used for the logs is \fBnot updated after\fP system \fBSUSPEND\fP/\fBRESUME\fP. Timestamps are adjusted according to current delta between boottime and monotonic clocks, this works only for messages printed after last resume.
.RE
.sp
\fB\-\-since\fP \fIZeit\fP
.RS 4
zeigt die Aufzeichnungen seit der angegebenen Zeit an. Unterstützt wird eine Granularität von unter einer Sekunde. Sie können die Zeit sowohl absolut als auch in relativer Notation angeben (zum Beispiel \*(Aq1 hour ago\*(Aq). Rechnen Sie damit, dass der Zeitstempel ungenau sein könnte; siehe \fB\-\-ctime\fP für weitere Details.
.RE
.sp
\fB\-\-until\fP \fIZeit\fP
.RS 4
zeigt die Aufzeichnungen bis zur angegebenen Zeit an. Unterstützt wird eine Granularität von unter einer Sekunde. Sie können die Zeit sowohl absolut als auch in relativer Notation angeben (zum Beispiel \*(Aq1 hour ago\*(Aq). Rechnen Sie damit, dass der Zeitstempel ungenau sein könnte; siehe \fB\-\-ctime\fP für weitere Details.
.RE
.sp
\fB\-t\fP, \fB\-\-notime\fP
.RS 4
verhindert die Ausgabe von Zeitstempeln des Kernels.
.RE
.sp
\fB\-\-time\-format\fP \fIFormat\fP
.RS 4
gibt Zeitstempel im angegebenen \fIFormat\fP aus, welches \fBctime\fP, \fBreltime\fP, \fBdelta\fP, \fBiso\fP oder \fBraw\fP sein kann. Die ersten drei Formate sind Aliase der Zeitformat\-spezifischen Optionen. Das \fBraw\fP\-Format verwendet das standardmäßige Zeitstempelformat in Sekunden seit dem Systemstart. Das \fBiso\fP\-Format ist eine \fBdmesg\fP\-Implementierung des Zeitstempelformats ISO\-8601. Dieses Format dient dazu, den Vergleich der Zeitstempel zweier Systeme und deren weitere Verarbeitung zu erleichtern. Die Definition des \fBiso\fP\-Zeitstempels lautet: YYYY\-MM\-DD<T>HH:MM:SS,<Mikrosekunden>\(<-+><Zeitzonenversatz zur Weltzeit>.
.sp
Das \fBiso\fP\-Format hat das gleiche Problem wie \fBctime\fP: Die Zeit kann ungenau sein, wenn ein System in einen Energiesparmodus versetzt und wieder aufgeweckt wird.
.sp
\fB\-\-time\-format\fP may be used multiple times with different values for \fIformat\fP to output each specified format.
.sp
The \fBdelta\fP always follows \fBctime\fP or \fBraw\fP if specified together.
.RE
.sp
\fB\-u\fP, \fB\-\-userspace\fP
.RS 4
gibt Meldungen der Anwendungsebene aus.
.RE
.sp
\fB\-w\fP, \fB\-\-follow\fP
.RS 4
wartet auf neue Meldungen. Dieses Funktionsmerkmal wird nur auf Systemen unterstützt, auf denen \fI/dev/kmsg\fP lesbar ist (seit Kernel 3.5.0).
.RE
.sp
\fB\-W\fP, \fB\-\-follow\-new\fP
.RS 4
wartet und gibt nur neue Meldungen aus.
.RE
.sp
\fB\-x\fP, \fB\-\-decode\fP
.RS 4
dekodiert die Einrichtungs\- und Stufennummer (Priorität) in menschenlesbare Präfixe.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
zeigt einen Hilfetext an und beendet das Programm.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
zeigt Versionsinformationen an und beendet das Programm.
.RE
.SH "FARBEN"
.sp
Die farbige Darstellung der Ausgabe wird über die Funktionen in \fBterminal\-colors.d\fP(5) gesteuert. Die implizierte Einfärbung kann deaktiviert werden, indem Sie folgende (leere) Datei anlegen:
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/dmesg.disable\fP
.br
.RE
.ll
.sp
für den Befehl \fBdmesg\fP oder für alle Befehle mit
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/disable\fP
.br
.RE
.ll
.sp
Die benutzerspezifischen Dateien \fI$XDG_CONFIG_HOME/terminal−colors.d\fP oder \fI$HOME/.config/terminal−colors.d\fP setzen die globale Einstellung außer Kraft.
.sp
Beachten Sie, dass die Einfärbung der Ausgabe standardmäßig aktiviert sein könnte und in diesem Fall die \fIterminal\-colors.d\fP\-Verzeichnisse noch nicht zwangsläufig vorhanden sein müssen.
.sp
Folgende logische Farbnamen werden von \fBdmesg\fP unterstützt:
.sp
\fBsubsys\fP
.RS 4
Das Subsystem\-Präfix der Meldung (z.B. »ACPI:«).
.RE
.sp
\fBtime\fP
.RS 4
Der Zeitstempel der Meldung.
.RE
.sp
\fBtimebreak\fP
.RS 4
zeigt den Zeitstempel der Meldung im gekürzten ctime\-Format in der Ausgabe mit \fB\-\-reltime\fP oder \fB\-\-human\fP.
.RE
.sp
\fBalert\fP
.RS 4
zeigt den Text der Meldung mit der Protokollpriorität »alert« an.
.RE
.sp
\fBcrit\fP
.RS 4
zeigt den Text der Meldung mit der Protokollpriorität »critical« an.
.RE
.sp
\fBerr\fP
.RS 4
zeigt den Text der Meldung mit der Protokollpriorität »error« an.
.RE
.sp
\fBwarn\fP
.RS 4
zeigt den Text der Meldung mit der Protokollpriorität »warning« an.
.RE
.sp
\fBsegfault\fP
.RS 4
Der Text der Meldung, die über Speicherzugriffsfehler informiert.
.RE
.SH "EXIT\-STATUS"
.sp
\fBdmesg\fP can fail reporting permission denied error. This is usually caused by \fBdmesg_restrict\fP kernel setting, please see \fBsyslog\fP(2) for more details.
.SH "AUTOREN"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.sp
\fBdmesg\fP was originally written by \c
.MTO "tytso\(atathena.mit.edu" "Theodore Ts\(cqo" "."
.SH "SIEHE AUCH"
.sp
\fBterminal\-colors.d\fP(5),
\fBsyslogd\fP(8)
.SH "FEHLER MELDEN"
.sp
Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "VERFÜGBARKEIT"
.sp
Der Befehl \fBdmesg\fP ist Teil des Pakets util\-linux, welches aus dem \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux\-Kernel\-Archiv" ""
heruntergeladen werden kann.