Scroll to navigation

SYSTEMD-COREDUMP(8) systemd-coredump SYSTEMD-COREDUMP(8)

BEZEICHNUNG

systemd-coredump, systemd-coredump.socket, systemd-coredump@.service, systemd-coredump-register.service, systemd-coredumpd.service - Erlangen, Speichern und Verarbeiten von Speicherauszügen

ÜBERSICHT

/usr/lib/systemd/systemd-coredump

/usr/lib/systemd/systemd-coredump --backtrace

/usr/lib/systemd/systemd-coredump --manager

/usr/lib/systemd/systemd-coredump --check-requirements

systemd-coredump.socket

systemd-coredump@.service

systemd-coredump-register.service

systemd-coredumpd.service

BESCHREIBUNG

systemd-coredump@.service ist ein System-Dienst, um Speicherauszüge zu verarbeiten. Es wird eine Zusammenfassung der Ereignisse nach systemd-journald.service(8) protokollieren, einschließlich Informationen über den Prozesskennzeichner, Eigentümer, das Signal, das den Prozess tötete und (falls möglich) die Stack-Ablaufverfolgung (»Stack-Trace«). Es kann die Speicherauszüge auch für eine spätere Verarbeitung speichern. Siehe den nachfolgenden Abschnitt »Informationen über abgestürzte Prozesse«.

Das Verhalten eines bestimmten Programms beim Empfang eines Signal wird durch zwei Faktoren geregelt, die in core(5) im Detail beschrieben sind. Insbesondere werden Speicherauszüge nur verarbeitet, wenn die zugehörigen Prozessressourcenbegrenzungen (RLIMIT_CORE) ausreichend sind.

Speicherauszüge können in das Journal geschrieben oder als Datei gespeichert werden. In beiden Fällen können sie für weitere Verarbeitungen, beispielsweise in gdb(1), abgefragt werden. Siehe coredumpctl(1), insbesondere die Verben list und debug.

Standardmäßig protokolliert systemd-coredump den Speicherauszug in das Journal, einschließlich (falls möglich) einer Ablaufverfolgung (Backtrace) und speichert den Speicherauszug (ein Abbild der Speicherinhalte des Prozesses) selbst in einer externen Datei in /var/lib/systemd/coredump/. Diese Speicherauszüge werden nach ein paar Tagen standardmäßig gelöscht; siehe /usr/lib/tmpfiles.d/systemd.conf für Details. Beachten Sie, dass die Entfernung von Speicherauszugsdateien aus dem Dateisystem und das Entfernen der Journal-Einträge voneinander unabhängig sind, und die Speicherauszugsdatei ohne den Journal-Eintrag vorhanden sein kann und Journal-Einträge auf bereits entfernte Speicherauszugsdateien verweisen können. Einige Metadaten werden an die Speicherauszugsdateien in Form von erweiterten Attributen angehängt, so dass die Speicherauszugsdateien für einige Zwecke selbst ohne die vollständigen Metadaten im Journal-Eintrag nützlich sein können.

Für weitere Details siehe Systemd-Speicherauszug-Handhabung[1].

Überblick

Die eigentliche Arbeit erfolgt durch das Programm systemd-coredump, aber abhängig von den Fähigkeiten des laufenden Kernels wird es verschieden aufgerufen.

Falls der Kernel das Kernel-Coredump-Socket-Protokoll unterstützt (lesen Sie weiter unten »Kernelanforderungen«, typischerweise Kernel v6.19 oder neuer), erstellt systemd-coredumpd.service ein Unix-Socket und wartet dort auf Anfragen und systemd-coredump-register.service schreibt den Socketpfad nach /proc/sys/kernel/core_pattern. Wenn ein Prozess abstürzt, verbindet sich der Kernel mit dem Socket und schickt den Speicherauszug des Prozesses über den Socket. Dann überträgt systemd-coredumpd.service den Speicherauszug an den entsprechenden Container, falls sich der abgestürzte Prozess in einer Container-Umgebung befindet. Andernfalls speichert es den Speicherauszug im lokalen Speicher und schreibt Informationen über den abgestürzten Prozess in das Journal.

Wenn der laufende Kernel diese Anforderungen nicht erfüllt, wird das Programm systemd-coredump zweimal aufgerufen: einmal als Handhabungsprogramm durch den Kernel und das zweite Mal in systemd-coredump@.service, um die Daten tatsächlich ins Journal zu schreiben und die Speicherauszugsdateien zu verarbeiten und zu speichern.

Wenn der Kernel systemd-coredump aufruft, um auf diese Art den Speicherauszug zu handhaben, läuft es im privilegierten Modus und wird sich mit dem durch die Unit systemd-coredump.socket erstellten Socket verbinden, die wiederum eine nicht privilegierte systemd-coredump@.service-Instanz erzeugen wird, um den Speicherauzug zu verarbeiten. Daher sind systemd-coredump.socket und systemd-coredump@.service Hilfs-Units, die die eigentliche Verarbeitung von Speicherauszügen vornehmen und der normalen Diensteverwaltung unterliegen.

Lesen Sie weiter unten »Units« zu Details über die einzelnen Units, die in beiden Modi beteiligt sind.

Befehlszeilenoptionen

systemd-coredump wird vom Benutzer normalerweise nicht direkt aufgerufen, sondern vom Kernel oder durch die nachfolgend beschriebenen Units. Es unterstützt die folgenden Aufrufmodi:

(keine Option)

Behandelt einen einzelnen Speicherauszug. Diesen Modus verwendet der Kernel, um systemd-coredump auf Kerneln direkt aufzurufen (mittels kernel.core_pattern), die das Kernel-Coredump-Socket-Protokoll nicht unterstützen. Dies ist auch der von systemd-coredump@.service verwandte Modus, um den Speicherauszug tatsächlich zu verarbeiten und zu speichern, der mittels systemd-coredump.socket an ihn übergeben wurde.

--backtrace

systemd-coredump erwartet auf der Standardeingabe einen Journaleintrag im Journal-Exportformat[2]. Der Eintrag sollte ein MESSAGE=-Feld und sämtliche zusätzliche Metadatenfelder, die der Aufrufende vernünftigerweise erwarten würde, enthalten. systemd-coredump hängt zusätzliche Metadatenfelder auf die gleiche Art an, wie es das für vom Kernel empfangene Speicherauszüge auch macht. In diesem Modus werden keine Speicherauszüge im Journal gespeichert.

--manager

Führt systemd-coredump als den langlaufenden Verwaltungsprozess aus, der auf dem Kernel-Coredump-Socket auf Anfragen wartet, Verbindungen vom Kernel akzeptiert und einen Arbeiterprozess abspaltet, um jeden einzelnen Speicherauszug zu verarbeiten. Dies ist der von systemd-coredumpd.service intern verwandte Modus, der nicht zum direkten Aufruf gedacht ist. Lesen Sie »Units« weiter unten.

Hinzugefügt in Version 262.

--check-requirements

Prüft, ob der laufende Kernel und die Ausführungsumgebung die Anforderungen für das Kernel-Coredump-Socket-Protokoll erfüllt (lesen Sie »Kernelanforderungen« weiter unten) und beendet sich mit einem von Null verschiedenen Status, falls diese nicht erfüllt sind. Dies wird intern von ExecCondition= von systemd-coredumpd.service und systemd-coredump-register.service verwandt, so dass diese Units auf Systemen, auf denen diese Funktionalität nicht verfügbar ist, übersprungen werden, ohne als fehlgeschlagen markiert zu werden. Dies ist nicht für den direkten Aufruf gedacht.

Hinzugefügt in Version 262.

Kernelanforderungen für das Coredump-Socket

Das von systemd-coredumpd.service und systemd-coredump-register.service verwandte Kernel-Coredump-Socket-Protokoll benötigt:

•Einen Kernel, der die Schalter PIDFD_INFO_COREDUMP (seit Kernel v6.16) und PIDFD_INFO_COREDUMP_SIGNAL (seit Kernel v6.19) für die Aktion PIDFD_GET_INFO ioctl(2) auf einem PID-Dateideskriptor (Informationen hierzu in pidfd_open(2)) unterstützt. Die Unterstützung für diese Schalter wird als Anzeichen verwandt, dass der Kernel auch neu genug ist, um das Anforderungsmodus- (»@@« vorangestellt) Kernel-Coredump-Socket kernel.core_pattern zu unterstützen, das in Kernel v6.17 eingeführt wurde.

•systemd-coredump muss im anfänglichen PID-, Benutzer- und Zeit-Namensraum laufen, d.h. auf der Hauptmaschine und nicht innerhalb eines Containers.

Diese Bedingungen werden mit systemd-coredump --check-requirements überprüft, bevor systemd-coredumpd.service und systemd-coredump-register.service gestartet werden. Falls die Bedingungen nicht erfüllt werden, fällt systemd-coredump stattdessen auf den veralteten Aufruf mittels systemd-coredump.socket und systemd-coredump@.service zurück.

Units

Die folgenden Units sind bei der Verarbeitung von Speicherauszügen beteiligt. Welche davon aktiv sind, hängt davon ab, ob das Coredump-Socket-Protokoll verfügbar ist, lesen Sie hierzu »Kernelanforderungen« weiter oben.

systemd-coredumpd.service

Ein langlaufender Verwalterdienst, der früh im Systemstart von Kerneln gestartet wird, die das Kernel-Coredump-Socket-Protokoll unterstützen. Es erstellt das AF_UNIX Socket /run/systemd/coredumpd/kernel (dieser Pfad wird auch wie nachfolgend beschrieben von systemd-coredump-register.service mittels kernel.core_pattern an den Kernel übergeben) und wartet dort auf Anfragen. Wenn sich der Kernel mit diesem Socket verbindet, um einen Speicherauszug einzureichen, akzeptiert systemd-coredumpd.service die Verbindung und spaltet einen Arbeiterprozess ab, um diesen konkreten Speicherauszug zu empfangen und zu bearbeiten, bis zu einer Grenze von 8 parallelen Arbeiterprozessen (sobald diese Begrenzung erreicht wurde, werden keine weiteren Verbindungen akzeptiert bis ein Arbeiterprozess sich beendet hat). Arbeiterprozesse, die länger als 5 Minuten laufen, werden automatisch beendet.

Die Konfiguration in coredump.conf(5) wird gelesen, sobald systemd-coredumpd.service startet. Da der Dienst danach weiterläuft (anstatt bei jedem Speicherauszug neu aufgerufen zu werden, wie das bei systemd-coredump@.service der Fall ist), werden Änderungen an coredump.conf und seinen Ergänzungen nicht automatisch aufgenommen. Laden Sie den Dienst neu, um Konfigurationsänderungen anzuwenden, Details dazu finden Sie in coredump.conf(5).

Hinzugefügt in Version 262.

systemd-coredump-register.service

Eine einmalig ausgeführte Unit, die von systemd-coredumpd.service hereingezogen wird und an dessen Lebensdauer gebunden ist (sie ist nicht für den manuellen Start oder Stopp gedacht). Sobald systemd-coredumpd.service oben ist, weist diese Unit den Kernel darauf, indem sie kernel.core_pattern auf den Anforderungsmodus- (»@@« vorangestellt) Socketpfad /run/systemd/coredumpd/kernel setzt und diese Einstellung nach /run/sysctl.d/60-coredump.conf mittels systemd-sysctl(8) dauerhaft macht. Wenn systemd-coredumpd.service gestoppt wird, wird systemd-coredump-register.service zusammen damit gestoppt und kernel.core_pattern wird auf seinen vorherigen Wert zurückgesetzt.

Da /run/sysctl.d/60-coredump.conf gegenüber der nachfolgend in »Konfiguration« beschriebenen Datei /usr/lib/sysctl.d/50-coredump.conf gemäß der gewöhnlichen sysctl.d(5)-Ordnungsregeln Vorrang hat, reicht das Maskieren oder Außerkraftsetzen von 50-coredump.conf alleine nicht aus, um eine angepasste kernel.core_pattern auf einem System zu installieren, auf dem systemd-coredumpd.service aktiv ist. Lesen Sie das nachfolgende »Konfiguration« um zu erfahren, wie Sie das vermeiden können.

Hinzugefügt in Version 262.

systemd-coredump.socket, systemd-coredump@.service

Veraltete Handhabungs-Units, die auf Kerneln verwandt werden, die das Kernel-Speicherauszugs-Socket-Protokoll nicht unterstützen (lesen Sie »Kernelanforderungen« weiter oben). Der Kernel ruft systemd-coredump direkt im privilegierten Modus für jeden Absturz auf; diese Instanz verbindet sich mit systemd-coredump.socket, das wieder eine nicht privilegierte Instanz systemd-coredump@.service startet, um den Speicherauszug tatsächlich zu verarbeiten und zu speichern. Anders als bei systemd-coredumpd.service wird für jeden Speicherauszug eine frische Instanz von systemd-coredump@.service gestartet, die daher immer die aktuelle coredump.conf-Konfiguration liest.

Speicherauszüge in Containern/Namensräumen

Der Dienst systemd-coredump@.service wird automatisch versuchen, einen Stacktrace aus einem Prozess beim Absturz zu extrahieren. Für diesen Stacktrace werden Symbole basierend auf Informationen, die in dem abstürzenden ELF-Abbild eingebettet sind oder aus äquivalenten Fehlersuchinformationen, die auf dem Hauptbetriebssystem verfügbar sind, aufgelöst. Für Prozesse, die innerhalb von lokalen Containern oder anderen, Einhänge-Namensraum-basierten Sandboxes abstürzen, ist diese externe Fehlersuchinformation typischerweise nicht auf dem Hauptsystem verfügbar (einfach deshalb, weil Container typischerweise andere Software-Versionen als das Hauptsystem verwenden). systemd-coredump(8) stellt zwei Mechanismen bereit, um dies zu adressieren:

1.Für Container mit vollständigen Betriebssystemen, die innerhalb Systemd betreiben, wird empfohlen, CoredumpReceive= auf der Unit zu aktivieren (siehe systemd.resource-control(5)). Damit ist sichergestellt, dass versucht wird, Speicherauszüge eines Containers an den im Container betriebenen systemd-coredump@.service weiterzuleiten, d.h. der Container erhält den Prozess und speichert seine eigenen Speicherauszüge. Beachten Sie, dass systemd-nspawn(1) standardmäßig diesen Modus verwendet, falls es mit dem Schalter --boot aufgerufen wird. Diese Arbeitsweise wird im Allgemeinen aus Sicherheitsgründen empfohlen: die sicherheitsrelevante Verarbeitung des Speicherauszugs erfolgt innerhalb der Begrenzungen des Containers selbst, durch den Code des Containers und hinterlegt durch den eigenen Speicher des Containers.

2.Für restriktivere Container (die kein ordentliches Init-System als PID 1 verwenden) ist es alternativ möglich, die Verarbeitung des Speicherauszugs auf dem Hauptsystem zu aktivieren, mit Zugriff auf die Fehlersuchinformationsdaten aus dem Container selbst. Diese Arbeitsweise muss mittels EnterNamespace= in coredump.conf(5) aktiviert werden und ist standardmäßig aus Sicherheitsgründen ausgeschaltet.

Falls sowohl CoredumpReceive= auf der Unit des Containers, zu dem der Speicherauszug gehört, als auch EnterNamespace= in der Konfigurationsdatei coredump.conf aktiviert sind, hat erstere Einstellung den Vorrang.

KONFIGURATION

Für von systemd gestartete Programme können Prozessressourcenbegrenzungen mit der Direktive LimitCORE= eingerichtet werden, siehe systemd.exec(5).

Um vom Kernel für den Umgang mit Speicherauszügen eingesetzt zu werden, muss systemd-coredump im Parameter kernel.core_pattern von sysctl(8) konfiguriert sein. Die Syntax dieses Parameters wird in core(5) erklärt. Systemd installiert die Datei /usr/lib/sysctl.d/50-coredump.conf, die kernel.core_pattern entsprechend konfiguriert. Diese Datei kann gemäß normaler sysctl.d(5)-Regeln maskiert oder außer Kraft gesetzt werden, um eine andere Einstellung zu verwenden. Falls die Sysctl-Konfiguration verändert wird, muss diese im Kernel aktualisiert werden, bevor sie wirksam wird, siehe sysctl(8) und systemd-sysctl(8).

Auf Systemen, auf denen systemd-coredumpd.service aktiv ist (lesen Sie »Kernelanforderungen« und »Units« weiter oben) schreibt systemd-coredump-register.service seine eigene Einstellung kernel.core_pattern nach /run/sysctl.d/60-coredump.conf, wanimmer systemd-coredumpd.service ausgeführt wird. Diese Datei hat gegenüber /usr/lib/sysctl.d/50-coredump.conf Vorrang. Somit setzt die Erstellung oder Außerkraftsetzung von 50-coredump.conf allein nicht die standardmäßige kernel.core_pattern auf solchen Systemen außer Kraft. Um ein angepasstes eigenes kernel.core_pattern auf einem System, auf dem systemd-coredumpd.service aktiv ist, zu setzen, stoppen und deaktivieren Sie es:

systemctl disable --now systemd-coredumpd.service

Um im Modus --backtrace eingesetzt zu werden, muss ein geeignetes Backtrace-Handhabungsprogramm auf der Senderseite installiert sein. Im Falle von python(1) bedeutet dies beispielsweise, dass ein sys.excepthook installiert sein muss, siehe systemd-coredump-python[3].

Das Verhalten von systemd-coredump selbst wird mittels der Konfigurationsdatei /etc/systemd/coredump.conf und entsprechenden Schnippseln in /etc/systemd/coredump.conf.d/*.conf konfiguriert, siehe coredump.conf(5). Wenn Speicherauszüge mittels systemd-coredump@.service verarbeitet werden (lesen Sie »Units« weiter oben), wird ein neue Instanz von systemd-coredump nach jedem Empfang eines Speicherauszuges aufgerufen und Änderungen in diesen Dateien werden wirksam, wenn das nächste Mal ein Speicherauszug empfangen wird. Werden Speicherauszüge stattdessen von dem langlaufenden systemd-coredumpd.service verarbeitet, benötigen Konfigurationsänderungen ein explizites Neuladen dieses Dienstes, um wirksam zu werden; lesen Sie coredump.conf(5) zu Details.

Die von Speicherauszügen verwandten Ressourcen werden auf zwei Arten begrenzt. Parameter wie die maximale Größe empfangener Speicherauszüge und Dateien können in den oben erwähnten Dateien /etc/systemd/coredump.conf und Schnippseln geändert werden. Zusätzlich wird die Speicherdauer von Speicherauszügen durch systemd-tmpfiles beschränkt, entsprechende Einstellungen sind standardmäßig in /usr/lib/tmpfiles.d/systemd.conf. Standardmäßig werden die Speicherauszüge nach ein paar Tagen gelöscht; weitere Details finden Sie in obiger Datei.

Deaktivierung der Verarbeitung von Speicherauszügen

Um die möglicherweise ressourcenintensive Verarbeitung durch systemd-coredump zu deaktivieren, setzen Sie

Storage=none
ProcessSizeMax=0

in coredump.conf(5).

INFORMATIONEN ÜBER ABGESTÜRZTE PROZESSE

coredumpctl(1) kann zur Abfrage gespeicherter Speicherauszüge, unabhängig von ihrem Ort, zur Anzeige von Informationen und zur Verarbeitung z.B. durch Weitergabe an den GNU-Debugger (gdb) verwandt werden.

Im Journal gespeicherte Daten können auch wie gewöhnlich mit journalctl(1) (oder von einem anderen Prozess mittels der sd-journal(3)-API) betrachtet werden. Die relevanten Nachrichten enthalten MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1:

$ journalctl MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1 -o verbose
…
MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1
COREDUMP_PID=552351
COREDUMP_UID=1000
COREDUMP_GID=1000
COREDUMP_SIGNAL_NAME=SIGSEGV
COREDUMP_SIGNAL=11
COREDUMP_CODE=2
COREDUMP_TIMESTAMP=1614342930000000
COREDUMP_COMM=Web Content
COREDUMP_EXE=/usr/lib64/firefox/firefox
COREDUMP_USER_UNIT=app-gnome-firefox-552136.scope
COREDUMP_CMDLINE=/usr/lib64/firefox/firefox -contentproc -childID 5 -isForBrowser …
COREDUMP_CGROUP=/user.slice/user-1000.slice/user@1000.service/app.slice/app-….scope
COREDUMP_FILENAME=/var/lib/systemd/coredump/core.Web….552351.….zst
…

Die folgenden Felder werden (falls bekannt) mit dem Journal-Eintrag gespeichert:

COREDUMP_UID=, COREDUMP_PID=, COREDUMP_GID=

Die Prozessnummer (PID), die Benutzernummer (UID) und die Gruppennummer (GID) des Eigentümers des abgestürzten Prozesses.

Falls der abgestürzte Prozess Teil eines Containers war (oder im allgemeinen in einem Prozess- oder Benutzernamensraum war), sind dies die von außen gesehenen Werte, im Namensraum, in dem systemd-coredump läuft.

Hinzugefügt in Version 248.

COREDUMP_BY_PIDFD=

Falls der abgestürzte Prozess mittels einer vom Kernel bereitgestellten PIDFD analysiert wurde (benötigt Kernel v6.16), dann wird dieses Feld vorhanden und auf »1« gesetzt sein. Falls dieses Feld nicht gesetzt ist, dann wurde dieser Prozess mittels einer PID analysiert, die bekanntermaßen Wettläufen um Ressourcen unterliegt.

Hinzugefügt in Version 258.

COREDUMP_TIMESTAMP=

Die Uhrzeit vom Absturz, wie vom Kernel gemeldet (in µs seit der Epoch).

Hinzugefügt in Version 248.

COREDUMP_RLIMIT=

Die weiche Ressourcenbegrenzung für Speicherauszugsdateien, siehe getrlimit(2).

Hinzugefügt in Version 248.

COREDUMP_UNIT=, COREDUMP_SLICE=

Die Namen der System-Unit und der Scheibe.

Wenn der abgestürzte Prozess sich in einem Container befand, sind dies die Unit-Namen außerhalb, im Haupt-Systemverwalter.

Hinzugefügt in Version 248.

COREDUMP_CGROUP=

Die primäre Cgrup der Unit des abgestürzten Prozesses.

Wenn der abgestürzte Prozess sich in einem Container befand, ist dies der vollständige Pfad, wie er außerhalb des Containers gesehen wird.

Hinzugefügt in Version 248.

COREDUMP_PROC_CGROUP=

Control-Gruppen-Informationen in dem Format, das in /proc/self/cgroup genutzt wird. Auf Systemen mit vereinigter Cgroup-Hierarchie, ist dies der einzelne Pfad, dem »0::« vorangestellt wurde, und mehrere Pfade, denen die Controller-Nummer vorangestellt wurden, auf Altsystemen.

Wenn der abgestürzte Prozess sich in einem Container befand, ist dies der vollständige Pfad, wie er außerhalb des Containers gesehen wird.

Hinzugefügt in Version 248.

COREDUMP_OWNER_UID=, COREDUMP_USER_UNIT=, COREDUMP_SESSION=

Die numerische UID des Benutzers, dem die Anmeldesitzung oder die Systemd-Benutzer-Unit des abgestürzten Prozesses gehört, die Benutzerverwalter-Unit und den Sitzungskennzeichner. Alle drei Felder sind nur für Benutzerprozesse vorhanden.

Wenn sich der abgestürzte Prozess in einem Container befand, sind dies die Werte außerhalb, im Hauptsystem.

Hinzugefügt in Version 248.

COREDUMP_SIGNAL_NAME=, COREDUMP_SIGNAL=

Der Name des beendenden Signals (mit »SIG« am Anfang [4]) und der numerische Wert. (Beide sind enthalten, da sich die Signalnummern zwischen Architekturen unterscheiden.)

Hinzugefügt in Version 248.

COREDUMP_CODE=

Der Grund, warum das Signal als nummerischer Wert gesandt wurde. Der Code ist im Feld si_code in der Struktur siginfo_t definiert und in sigaction(2) dokumentiert.

Hinzugefügt in Version 261.

COREDUMP_CWD=, COREDUMP_ROOT=

Das aktuelle Arbeitsverzeichnis und Wurzelverzeichnis des abgestürzten Prozesses.

Wenn sich der abgestürzte Prozess in einem Container befand, sind diese Pfade relativ zur Wurzel des Einhängenamensraums des Containers.

Hinzugefügt in Version 248.

COREDUMP_DUMPABLE=

Das vom Kernel berichtete Feld PR_GET_DUMPABLE, siehe prctl(2).

Hinzugefügt in Version 258.

COREDUMP_OPEN_FDS=

Informationen über offene Dateideskriptoren, in den folgenden Formaten:

fd:/Pfad/zur/Datei
pos:     …
flags:   …
…
fd:/Pfad/zur/Datei
pos:     …
flags:   …
…

Die erste Zeile enthält die Dateideskriptorennummer fd und den Pfad, während nachfolgende Zeilen die Inhalte von /proc/PID/fdinfo/fd anzeigen.

Hinzugefügt in Version 248.

COREDUMP_EXE=

Das Ziel des Symlinks /proc/PID/exe.

Wenn sich der abgestürzte Prozess in einem Container befindet, ist der Pfad relativ zu der Wurzel des Einhängenamensraums des Containers.

Hinzugefügt in Version 248.

COREDUMP_CMDLINE=, COREDUMP_COMM=, COREDUMP_ENVIRON=, COREDUMP_PROC_AUXV=, COREDUMP_PROC_LIMITS=, COREDUMP_PROC_MAPS=, COREDUMP_PROC_MOUNTINFO=, COREDUMP_PROC_STATUS=

Felder, die die prozessbezogenen Einträge im Dateisystem /proc zuordnen: /proc/PID/cmdline (die Befehlszeile des abgestürzten Prozesses), /proc/PID/comm (der dem Prozess zugeordnete Befehlsname), /proc/PID/environ (der Umgebungsblock des abgestürzten Prozesses), /proc/PID/auxv (der Hilfsvektor des abgestürzten Prozesses, siehe getauxval(3)), /proc/PID/limits (die weichen und die harten Ressourcenbegrenzungen), /proc/PID/maps (Speicherregionen, die für den Prozess sichtbar sind und die zugehörigen Zugriffsberechtigungen), /proc/PID/mountinfo (Einhängepunkte im Einhängenamensraum des Prozesses), /proc/PID/status (verschiedene Metadaten des Prozesses).

Siehe proc(5) für weitere Informationen.

Hinzugefügt in Version 248.

COREDUMP_HOSTNAME=

Der System-Rechnername.

Wenn sich der abgestürzte Prozess in einem Container befand, ist dies der Rechnername des Containers.

Hinzugefügt in Version 248.

COREDUMP_CONTAINER_CMDLINE=

Für Prozesse, die in einem Container ausgeführt werden, die Befehlszeile des Prozesses, der den Container gestartet hat (der erste übergeordnete Prozess mit einem anderen Einhängenamensraum).

Hinzugefügt in Version 248.

COREDUMP=

Wenn der Speicherauszug im Journal gespeichert wurde, das Speicherauszugsabbild selbst.

Hinzugefügt in Version 248.

COREDUMP_FILENAME=

Wenn der Speicherauszug extern gespeichert wurde, der Pfad zu der Speicherauszugsdatei.

Hinzugefügt in Version 248.

COREDUMP_TRUNCATED=

Auf »1« gesetzt, wenn der gespeicherte Speicherauszug abgeschnitten wurde. (Eine unvollständige Speicherauszugsdatei kann von einigen Werkzeugen noch verarbeitet werden, obwohl logischerweise nicht die vollständigen Informationen vorhanden sind.)

Hinzugefügt in Version 248.

COREDUMP_PACKAGE_NAME=, COREDUMP_PACKAGE_VERSION=, COREDUMP_PACKAGE_JSON=

Falls das Programm .package-Metadaten-ELF-Bemerkungen enthält, werden diese ausgewertet und angehängt. Das Paket und die Version des [u00BB]Haupt[u00AB]-ELF-Moduls (d.h. des Programms) werden einzeln angehängt. Der JSON-formatierte Inhalt aller Module wird als einzelnes JSON-Objekt angehängt, jedes mit dem Modulnamen als Schlüssel. Für weitere Informationen über dieses Metadatenformat und den Inhalt, siehe die Paket-Metadaten für ausführbare Dateien[5].

Hinzugefügt in Version 249.

MESSAGE=

Die durch systemd-coredump erstellte Nachricht, die die Ablaufverfolgung enthält, falls sie erfolgreich erstellt wurde. Wird systemd-coredump mit --backtrace aufgerufen, dann wird das Feld vom Aufrufenden bereitgestellt.

Hinzugefügt in Version 248.

Im Journal-Eintrag existieren eine Reihe von weiteren Feldern, die aber dem Protokollierungsprozess betreffen, d.h. systemd-coredump und nicht den abgestürzten Prozess. Siehe systemd.journal-fields(7).

Die folgenden Felder werden mit der in COREDUMP_FILENAME= aufgeführten externen Datei als erweiterte Attribute gespeichert (falls bekannt):

user.coredump.pid, user.coredump.uid, user.coredump.gid, user.coredump.signal, user.coredump.timestamp, user.coredump.rlimit, user.coredump.hostname, user.coredump.comm, user.coredump.exe

Diese sind identisch zu den oben beschriebenen COREDUMP_PID=, COREDUMP_UID=, COREDUMP_GID=, COREDUMP_SIGNAL=, COREDUMP_TIMESTAMP=, COREDUMP_RLIMIT=, COREDUMP_HOSTNAME=, COREDUMP_COMM= und COREDUMP_EXE=.

Hinzugefügt in Version 248.

Diese können sich mittels getfattr(1) angeschaut werden. Für die im obigen Journal-Eintrag gezeigte Speicherauszugsdatei:

$ getfattr --absolute-names -d /var/lib/systemd/coredump/core.Web….552351.….zst
# file: /var/lib/systemd/coredump/core.Web….552351.….zst
user.coredump.pid="552351"
user.coredump.uid="1000"
user.coredump.gid="1000"
user.coredump.signal="11"
user.coredump.timestamp="1614342930000000"
user.coredump.comm="Web Content"
user.coredump.exe="/usr/lib64/firefox/firefox"
…

SIEHE AUCH

coredump.conf(5), coredumpctl(1), systemd-journald.service(8), systemd-tmpfiles(8), core(5), sysctl.d(5), systemd-sysctl.service(8), Systemd-Speicherauszug-Handhabung[1]

ANMERKUNGEN

1.
Systemd-Speicherauszug-Handhabung
2.
Journal-Exportformat
3.
systemd-coredump-python
4.
kill(1) erwartet Signalnamen ohne den Präfix; kill(2) verwendet den Präfix; alle Systemd-Werkzeuge akzeptieren Signalnamen sowohl ohne als auch mit dem Präfix.
5.
Paket-Metadaten für ausführbare Dateien

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.

systemd 262.1