'\" t
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SYSTEMD\-COREDUMP 8 "" "systemd 262.1" systemd\-coredump
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH BEZEICHNUNG
systemd\-coredump, systemd\-coredump.socket, systemd\-coredump@.service,
systemd\-coredump\-register.service, systemd\-coredumpd.service \- Erlangen,
Speichern und Verarbeiten von Speicherauszügen
.SH ÜBERSICHT
.PP
/usr/lib/systemd/systemd\-coredump
.PP
/usr/lib/systemd/systemd\-coredump \fB\-\-backtrace\fP
.PP
/usr/lib/systemd/systemd\-coredump \fB\-\-manager\fP
.PP
/usr/lib/systemd/systemd\-coredump \fB\-\-check\-requirements\fP
.PP
systemd\-coredump\&.socket
.PP
systemd\-coredump@\&.service
.PP
systemd\-coredump\-register\&.service
.PP
systemd\-coredumpd\&.service
.SH BESCHREIBUNG
.PP
systemd\-coredump@\&.service ist ein System\-Dienst, um Speicherauszüge zu
verarbeiten\&. Es wird eine Zusammenfassung der Ereignisse nach
\fBsystemd\-journald.service\fP(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«\&.
.PP
Das Verhalten eines bestimmten Programms beim Empfang eines Signal wird
durch zwei Faktoren geregelt, die in \fBcore\fP(5) im Detail beschrieben
sind\&. Insbesondere werden Speicherauszüge nur verarbeitet, wenn die
zugehörigen Prozessressourcenbegrenzungen (\fBRLIMIT_CORE\fP) ausreichend
sind\&.
.PP
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 \fBgdb\fP(1), abgefragt werden\&. Siehe \fBcoredumpctl\fP(1),
insbesondere die Verben \fBlist\fP und \fBdebug\fP\&.
.PP
Standardmäßig protokolliert \fBsystemd\-coredump\fP 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\&.
.PP
Für weitere Details siehe
\m[blue]\fBSystemd\-Speicherauszug\-Handhabung\fP\m[]\&\s-2\u[1]\d\s+2\&.
.SS Überblick
.PP
Die eigentliche Arbeit erfolgt durch das Programm \fBsystemd\-coredump\fP, aber
abhängig von den Fähigkeiten des laufenden Kernels wird es verschieden
aufgerufen\&.
.PP
Falls der Kernel das Kernel\-Coredump\-Socket\-Protokoll unterstützt (lesen Sie
weiter unten »Kernelanforderungen«, typischerweise Kernel v6\&.19 oder
neuer), erstellt \fBsystemd\-coredumpd\&.service\fP ein Unix\-Socket und wartet
dort auf Anfragen und \fBsystemd\-coredump\-register\&.service\fP 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 \fBsystemd\-coredumpd\&.service\fP
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\&.
.PP
Wenn der laufende Kernel diese Anforderungen nicht erfüllt, wird das
Programm \fBsystemd\-coredump\fP 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\&.
.PP
Wenn der Kernel \fBsystemd\-coredump\fP 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\&.
.PP
Lesen Sie weiter unten »Units« zu Details über die einzelnen Units, die in
beiden Modi beteiligt sind\&.
.SS Befehlszeilenoptionen
.PP
\fBsystemd\-coredump\fP wird vom Benutzer normalerweise nicht direkt aufgerufen,
sondern vom Kernel oder durch die nachfolgend beschriebenen Units\&. Es
unterstützt die folgenden Aufrufmodi:
.PP
(keine Option)
.RS 4
Behandelt einen einzelnen Speicherauszug\&. Diesen Modus verwendet der
Kernel, um \fBsystemd\-coredump\fP auf Kerneln direkt aufzurufen (mittels
\fIkernel\&.core_pattern\fP), die das Kernel\-Coredump\-Socket\-Protokoll nicht
unterstützen\&. Dies ist auch der von \fBsystemd\-coredump@\&.service\fP
verwandte Modus, um den Speicherauszug tatsächlich zu verarbeiten und zu
speichern, der mittels systemd\-coredump\&.socket an ihn übergeben wurde\&.
.RE
.PP
\fB\-\-backtrace\fP
.RS 4
\fBsystemd\-coredump\fP erwartet auf der Standardeingabe einen Journaleintrag im
\m[blue]\fBJournal\-Exportformat\fP\m[]\&\s-2\u[2]\d\s+2\&. Der Eintrag sollte
ein \fIMESSAGE=\fP\-Feld und sämtliche zusätzliche Metadatenfelder, die der
Aufrufende vernünftigerweise erwarten würde,
enthalten\&. \fBsystemd\-coredump\fP 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\&.
.RE
.PP
\fB\-\-manager\fP
.RS 4
Führt \fBsystemd\-coredump\fP 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\&.
.sp
Hinzugefügt in Version 262\&.
.RE
.PP
\fB\-\-check\-requirements\fP
.RS 4
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
\fIExecCondition=\fP 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\&.
.sp
Hinzugefügt in Version 262\&.
.RE
.SS "Kernelanforderungen für das Coredump\-Socket"
.PP
Das von systemd\-coredumpd\&.service und systemd\-coredump\-register\&.service
verwandte Kernel\-Coredump\-Socket\-Protokoll benötigt:
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Einen Kernel, der die Schalter \fBPIDFD_INFO_COREDUMP\fP (seit Kernel v6\&.16)
und \fBPIDFD_INFO_COREDUMP_SIGNAL\fP (seit Kernel v6\&.19) für die Aktion
\fBPIDFD_GET_INFO\fP \fBioctl\fP(2) auf einem PID\-Dateideskriptor (Informationen
hierzu in \fBpidfd_open\fP(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
\fIkernel\&.core_pattern\fP zu unterstützen, das in Kernel v6\&.17 eingeführt
wurde\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBsystemd\-coredump\fP muss im anfänglichen PID\-, Benutzer\- und Zeit\-Namensraum
laufen, d\&.h\&. auf der Hauptmaschine und nicht innerhalb eines
Containers\&.
.RE
.PP
Diese Bedingungen werden mit \fBsystemd\-coredump\fP \fB\-\-check\-requirements\fP
überprüft, bevor systemd\-coredumpd\&.service und
systemd\-coredump\-register\&.service gestartet werden\&. Falls die
Bedingungen nicht erfüllt werden, fällt \fBsystemd\-coredump\fP stattdessen auf
den veralteten Aufruf mittels systemd\-coredump\&.socket und
systemd\-coredump@\&.service zurück\&.
.SS Units
.PP
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\&.
.PP
systemd\-coredumpd\&.service
.RS 4
Ein langlaufender Verwalterdienst, der früh im Systemstart von Kerneln
gestartet wird, die das Kernel\-Coredump\-Socket\-Protokoll unterstützen\&. Es
erstellt das \fBAF_UNIX\fP Socket /run/systemd/coredumpd/kernel (dieser Pfad
wird auch wie nachfolgend beschrieben von
systemd\-coredump\-register\&.service mittels \fIkernel\&.core_pattern\fP 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\&.
.sp
Die Konfiguration in \fBcoredump.conf\fP(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 \fInicht\fP automatisch
aufgenommen\&. Laden Sie den Dienst neu, um Konfigurationsänderungen
anzuwenden, Details dazu finden Sie in \fBcoredump.conf\fP(5)\&.
.sp
Hinzugefügt in Version 262\&.
.RE
.PP
systemd\-coredump\-register\&.service
.RS 4
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 \fIkernel\&.core_pattern\fP auf den Anforderungsmodus\- (»@@«
vorangestellt) Socketpfad /run/systemd/coredumpd/kernel setzt und diese
Einstellung nach /run/sysctl\&.d/60\-coredump\&.conf mittels
\fBsystemd\-sysctl\fP(8) dauerhaft macht\&. Wenn systemd\-coredumpd\&.service
gestoppt wird, wird systemd\-coredump\-register\&.service zusammen damit
gestoppt und \fIkernel\&.core_pattern\fP wird auf seinen vorherigen Wert
zurückgesetzt\&.
.sp
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 \fBsysctl.d\fP(5)\-Ordnungsregeln Vorrang hat, reicht das
Maskieren oder Außerkraftsetzen von 50\-coredump\&.conf alleine \fInicht\fP aus,
um eine angepasste \fIkernel\&.core_pattern\fP 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\&.
.sp
Hinzugefügt in Version 262\&.
.RE
.PP
systemd\-coredump\&.socket, systemd\-coredump@\&.service
.RS 4
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 \fBsystemd\-coredump\fP
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\&.
.RE
.SS "Speicherauszüge in Containern/Namensräumen"
.PP
Der Dienst \fBsystemd\-coredump@\&.service\fP 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)\&. \fBsystemd\-coredump\fP(8)
stellt zwei Mechanismen bereit, um dies zu adressieren:
.sp
.RS 4
.ie  n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Für Container mit vollständigen Betriebssystemen, die innerhalb Systemd
betreiben, wird empfohlen, \fICoredumpReceive=\fP auf der Unit zu aktivieren
(siehe \fBsystemd.resource\-control\fP(5))\&. Damit ist sichergestellt, dass
versucht wird, Speicherauszüge eines Containers an den im Container
betriebenen \fBsystemd\-coredump@\&.service\fP weiterzuleiten, d\&.h\&. der
Container erhält den Prozess und speichert seine eigenen
Speicherauszüge\&. Beachten Sie, dass \fBsystemd\-nspawn\fP(1) standardmäßig
diesen Modus verwendet, falls es mit dem Schalter \fB\-\-boot\fP 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\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.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 \fIEnterNamespace=\fP in \fBcoredump.conf\fP(5) aktiviert werden und
ist standardmäßig aus Sicherheitsgründen ausgeschaltet\&.
.RE
.PP
Falls sowohl \fICoredumpReceive=\fP auf der Unit des Containers, zu dem der
Speicherauszug gehört, als auch \fIEnterNamespace=\fP in der
Konfigurationsdatei coredump\&.conf aktiviert sind, hat erstere Einstellung
den Vorrang\&.
.SH KONFIGURATION
.PP
Für von \fBsystemd\fP gestartete Programme können Prozessressourcenbegrenzungen
mit der Direktive \fILimitCORE=\fP eingerichtet werden, siehe
\fBsystemd.exec\fP(5)\&.
.PP
Um vom Kernel für den Umgang mit Speicherauszügen eingesetzt zu werden, muss
\fBsystemd\-coredump\fP im Parameter \fIkernel\&.core_pattern\fP von \fBsysctl\fP(8)
konfiguriert sein\&. Die Syntax dieses Parameters wird in \fBcore\fP(5)
erklärt\&. Systemd installiert die Datei
/usr/lib/sysctl\&.d/50\-coredump\&.conf, die \fIkernel\&.core_pattern\fP
entsprechend konfiguriert\&. Diese Datei kann gemäß normaler
\fBsysctl.d\fP(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 \fBsysctl\fP(8) und \fBsystemd\-sysctl\fP(8)\&.
.PP
Auf Systemen, auf denen systemd\-coredumpd\&.service aktiv ist (lesen Sie
»Kernelanforderungen« und »Units« weiter oben) schreibt
systemd\-coredump\-register\&.service seine eigene Einstellung
\fIkernel\&.core_pattern\fP 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 \fIallein\fP nicht die
standardmäßige \fIkernel\&.core_pattern\fP auf solchen Systemen außer
Kraft\&. Um ein angepasstes eigenes \fIkernel\&.core_pattern\fP auf einem
System, auf dem systemd\-coredumpd\&.service aktiv ist, zu setzen, stoppen
und deaktivieren Sie es:
.sp
.if  n \{\
.RS 4
.\}
.nf
systemctl disable \-\-now systemd\-coredumpd\&.service
.fi
.if  n \{\
.RE
.\}
.PP
Um im Modus \fB\-\-backtrace\fP eingesetzt zu werden, muss ein geeignetes
Backtrace\-Handhabungsprogramm auf der Senderseite installiert sein\&. Im
Falle von \fBpython\fP(1) bedeutet dies beispielsweise, dass ein
\fIsys\&.excepthook\fP installiert sein muss, siehe
\m[blue]\fBsystemd\-coredump\-python\fP\m[]\&\s-2\u[3]\d\s+2\&.
.PP
Das Verhalten von \fBsystemd\-coredump\fP selbst wird mittels der
Konfigurationsdatei /etc/systemd/coredump\&.conf und entsprechenden
Schnippseln in /etc/systemd/coredump\&.conf\&.d/*\&.conf konfiguriert, siehe
\fBcoredump.conf\fP(5)\&. Wenn Speicherauszüge mittels
systemd\-coredump@\&.service verarbeitet werden (lesen Sie »Units« weiter
oben), wird ein neue Instanz von \fBsystemd\-coredump\fP 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
\fBcoredump.conf\fP(5) zu Details\&.
.PP
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 \fBsystemd\-tmpfiles\fP 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\&.
.SS "Deaktivierung der Verarbeitung von Speicherauszügen"
.PP
Um die möglicherweise ressourcenintensive Verarbeitung durch
\fBsystemd\-coredump\fP zu deaktivieren, setzen Sie
.sp
.if  n \{\
.RS 4
.\}
.nf
Storage=none
ProcessSizeMax=0
.fi
.if  n \{\
.RE
.\}
.sp
in \fBcoredump.conf\fP(5)\&.
.SH "INFORMATIONEN ÜBER ABGESTÜRZTE PROZESSE"
.PP
\fBcoredumpctl\fP(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\&.
.PP
Im Journal gespeicherte Daten können auch wie gewöhnlich mit
\fBjournalctl\fP(1) (oder von einem anderen Prozess mittels der
\fBsd\-journal\fP(3)\-API) betrachtet werden\&. Die relevanten Nachrichten
enthalten \fBMESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1\fP:
.sp
.if  n \{\
.RS 4
.\}
.nf
$ 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
…
.fi
.if  n \{\
.RE
.\}
.PP
Die folgenden Felder werden (falls bekannt) mit dem Journal\-Eintrag
gespeichert:
.PP
\fICOREDUMP_UID=\fP, \fICOREDUMP_PID=\fP, \fICOREDUMP_GID=\fP
.RS 4
Die Prozessnummer (PID), die Benutzernummer (UID) und die Gruppennummer
(GID) des Eigentümers des abgestürzten Prozesses\&.
.sp
Falls der abgestürzte Prozess Teil eines Containers war (oder im allgemeinen
in einem Prozess\- oder Benutzernamensraum war), sind dies die von \fIaußen\fP
gesehenen Werte, im Namensraum, in dem systemd\-coredump läuft\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_BY_PIDFD=\fP
.RS 4
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\&.
.sp
Hinzugefügt in Version 258\&.
.RE
.PP
\fICOREDUMP_TIMESTAMP=\fP
.RS 4
Die Uhrzeit vom Absturz, wie vom Kernel gemeldet (in µs seit der Epoch)\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_RLIMIT=\fP
.RS 4
Die weiche Ressourcenbegrenzung für Speicherauszugsdateien, siehe
\fBgetrlimit\fP(2)\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_UNIT=\fP, \fICOREDUMP_SLICE=\fP
.RS 4
Die Namen der System\-Unit und der Scheibe\&.
.sp
Wenn der abgestürzte Prozess sich in einem Container befand, sind dies die
Unit\-Namen \fIaußerhalb\fP, im Haupt\-Systemverwalter\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_CGROUP=\fP
.RS 4
Die primäre Cgrup der Unit des abgestürzten Prozesses\&.
.sp
Wenn der abgestürzte Prozess sich in einem Container befand, ist dies der
vollständige Pfad, wie er außerhalb des Containers gesehen wird\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_PROC_CGROUP=\fP
.RS 4
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\&.
.sp
Wenn der abgestürzte Prozess sich in einem Container befand, ist dies der
vollständige Pfad, wie er außerhalb des Containers gesehen wird\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_OWNER_UID=\fP, \fICOREDUMP_USER_UNIT=\fP, \fICOREDUMP_SESSION=\fP
.RS 4
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\&.
.sp
Wenn sich der abgestürzte Prozess in einem Container befand, sind dies die
Werte \fIaußerhalb\fP, im Hauptsystem\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_SIGNAL_NAME=\fP, \fICOREDUMP_SIGNAL=\fP
.RS 4
Der Name des beendenden Signals (mit »SIG« am Anfang \&\s-2\u[4]\d\s+2) und
der numerische Wert\&. (Beide sind enthalten, da sich die Signalnummern
zwischen Architekturen unterscheiden\&.)
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_CODE=\fP
.RS 4
Der Grund, warum das Signal als nummerischer Wert gesandt wurde\&. Der Code
ist im Feld \fIsi_code\fP in der Struktur \fIsiginfo_t\fP definiert und in
\fBsigaction\fP(2) dokumentiert\&.
.sp
Hinzugefügt in Version 261\&.
.RE
.PP
\fICOREDUMP_CWD=\fP, \fICOREDUMP_ROOT=\fP
.RS 4
Das aktuelle Arbeitsverzeichnis und Wurzelverzeichnis des abgestürzten
Prozesses\&.
.sp
Wenn sich der abgestürzte Prozess in einem Container befand, sind diese
Pfade relativ zur Wurzel des Einhängenamensraums des Containers\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_DUMPABLE=\fP
.RS 4
Das vom Kernel berichtete Feld \fBPR_GET_DUMPABLE\fP, siehe \fBprctl\fP(2)\&.
.sp
Hinzugefügt in Version 258\&.
.RE
.PP
\fICOREDUMP_OPEN_FDS=\fP
.RS 4
Informationen über offene Dateideskriptoren, in den folgenden Formaten:
.sp
.if  n \{\
.RS 4
.\}
.nf
\fIfd\fP:\fI/Pfad/zur/Datei\fP
pos:     …
flags:   …
…

\fIfd\fP:\fI/Pfad/zur/Datei\fP
pos:     …
flags:   …
…
.fi
.if  n \{\
.RE
.\}
.sp
Die erste Zeile enthält die Dateideskriptorennummer \fIfd\fP und den Pfad,
während nachfolgende Zeilen die Inhalte von /proc/\fIPID\fP/fdinfo/\fIfd\fP
anzeigen\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_EXE=\fP
.RS 4
Das Ziel des Symlinks /proc/\fIPID\fP/exe\&.
.sp
Wenn sich der abgestürzte Prozess in einem Container befindet, ist der Pfad
relativ zu der Wurzel des Einhängenamensraums des Containers\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_CMDLINE=\fP, \fICOREDUMP_COMM=\fP, \fICOREDUMP_ENVIRON=\fP,
\fICOREDUMP_PROC_AUXV=\fP, \fICOREDUMP_PROC_LIMITS=\fP, \fICOREDUMP_PROC_MAPS=\fP,
\fICOREDUMP_PROC_MOUNTINFO=\fP, \fICOREDUMP_PROC_STATUS=\fP
.RS 4
Felder, die die prozessbezogenen Einträge im Dateisystem /proc zuordnen:
/proc/\fIPID\fP/cmdline (die Befehlszeile des abgestürzten Prozesses),
/proc/\fIPID\fP/comm (der dem Prozess zugeordnete Befehlsname),
/proc/\fIPID\fP/environ (der Umgebungsblock des abgestürzten Prozesses),
/proc/\fIPID\fP/auxv (der Hilfsvektor des abgestürzten Prozesses, siehe
\fBgetauxval\fP(3)), /proc/\fIPID\fP/limits (die weichen und die harten
Ressourcenbegrenzungen), /proc/\fIPID\fP/maps (Speicherregionen, die für den
Prozess sichtbar sind und die zugehörigen Zugriffsberechtigungen),
/proc/\fIPID\fP/mountinfo (Einhängepunkte im Einhängenamensraum des Prozesses),
/proc/\fIPID\fP/status (verschiedene Metadaten des Prozesses)\&.
.sp
Siehe \fBproc\fP(5) für weitere Informationen.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_HOSTNAME=\fP
.RS 4
Der System\-Rechnername\&.
.sp
Wenn sich der abgestürzte Prozess in einem Container befand, ist dies der
Rechnername des Containers\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_CONTAINER_CMDLINE=\fP
.RS 4
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)\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP=\fP
.RS 4
Wenn der Speicherauszug im Journal gespeichert wurde, das
Speicherauszugsabbild selbst\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_FILENAME=\fP
.RS 4
Wenn der Speicherauszug extern gespeichert wurde, der Pfad zu der
Speicherauszugsdatei\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_TRUNCATED=\fP
.RS 4
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\&.)
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
\fICOREDUMP_PACKAGE_NAME=\fP, \fICOREDUMP_PACKAGE_VERSION=\fP,
\fICOREDUMP_PACKAGE_JSON=\fP
.RS 4
Falls das Programm \&.package\-Metadaten\-ELF\-Bemerkungen enthält, werden
diese ausgewertet und angehängt\&. Das \fIPaket\fP und die \fIVersion\fP des
\*»Haupt\*«\-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
\m[blue]\fBPaket\-Metadaten für ausführbare Dateien\fP\m[]\&\s-2\u[5]\d\s+2\&.
.sp
Hinzugefügt in Version 249\&.
.RE
.PP
\fIMESSAGE=\fP
.RS 4
Die durch \fBsystemd\-coredump\fP erstellte Nachricht, die die Ablaufverfolgung
enthält, falls sie erfolgreich erstellt wurde\&. Wird \fBsystemd\-coredump\fP
mit \fB\-\-backtrace\fP aufgerufen, dann wird das Feld vom Aufrufenden
bereitgestellt\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
Im Journal\-Eintrag existieren eine Reihe von weiteren Feldern, die aber dem
Protokollierungsprozess betreffen, d\&.h\&. \fBsystemd\-coredump\fP und nicht
den abgestürzten Prozess\&. Siehe \fBsystemd.journal\-fields\fP(7)\&.
.PP
Die folgenden Felder werden mit der in \fICOREDUMP_FILENAME=\fP aufgeführten
externen Datei als erweiterte Attribute gespeichert (falls bekannt):
.PP
\fIuser\&.coredump\&.pid\fP, \fIuser\&.coredump\&.uid\fP,
\fIuser\&.coredump\&.gid\fP, \fIuser\&.coredump\&.signal\fP,
\fIuser\&.coredump\&.timestamp\fP, \fIuser\&.coredump\&.rlimit\fP,
\fIuser\&.coredump\&.hostname\fP, \fIuser\&.coredump\&.comm\fP,
\fIuser\&.coredump\&.exe\fP
.RS 4
Diese sind identisch zu den oben beschriebenen \fICOREDUMP_PID=\fP,
\fICOREDUMP_UID=\fP, \fICOREDUMP_GID=\fP, \fICOREDUMP_SIGNAL=\fP,
\fICOREDUMP_TIMESTAMP=\fP, \fICOREDUMP_RLIMIT=\fP, \fICOREDUMP_HOSTNAME=\fP,
\fICOREDUMP_COMM=\fP und \fICOREDUMP_EXE=\fP\&.
.sp
Hinzugefügt in Version 248\&.
.RE
.PP
Diese können sich mittels \fBgetfattr\fP(1) angeschaut werden\&. Für die im
obigen Journal\-Eintrag gezeigte Speicherauszugsdatei:
.sp
.if  n \{\
.RS 4
.\}
.nf
$ 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"
…
.fi
.if  n \{\
.RE
.\}
.sp
.SH "SIEHE AUCH"
.PP
\fBcoredump.conf\fP(5), \fBcoredumpctl\fP(1), \fBsystemd\-journald.service\fP(8),
\fBsystemd\-tmpfiles\fP(8), \fBcore\fP(5), \fBsysctl.d\fP(5),
\fBsystemd\-sysctl.service\fP(8),
\m[blue]\fBSystemd\-Speicherauszug\-Handhabung\fP\m[]\&\s-2\u[1]\d\s+2
.SH ANMERKUNGEN
.IP " 1." 4
Systemd\-Speicherauszug\-Handhabung
.RS 4
\%https://systemd.io/COREDUMP
.RE
.IP " 2." 4
Journal\-Exportformat
.RS 4
\%https://systemd.io/JOURNAL_EXPORT_FORMATS#journal\-export\-format
.RE
.IP " 3." 4
systemd\-coredump\-python
.RS 4
\%https://github.com/systemd/systemd\-coredump\-python
.RE
.IP " 4." 4
\fBkill\fP(1) erwartet Signalnamen \fIohne\fP den Präfix; \fBkill\fP(2) verwendet den
Präfix; alle Systemd\-Werkzeuge akzeptieren Signalnamen sowohl ohne als auch
mit dem Präfix.
.IP " 5." 4
Paket\-Metadaten für ausführbare Dateien
.RS 4
\%https://systemd.io/PACKAGE_METADATA_FOR_EXECUTABLE_FILES/
.RE
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .
