'\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH COREDUMPCTL 1 "" "systemd 262.1" coredumpctl .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 NOM coredumpctl –\ Récupération et traitement des métadonnées et des vidages mémoire enregistrés .SH SYNOPSIS .HP \w'\fBcoredumpctl\fR\ 'u \fBcoredumpctl\fP [\fIOPTIONS...\fP] {\fICOMMANDE\fP} [\fIPID\fP|\fICOMMANDE\fP|\fIEXE\fP|\fICORRESPONDANCE...\fP] .SH DESCRIPTION .PP \fBcoredumpctl\fP est un outil pouvant être utilisé pour la récupération et le traitement de vidages mémoire (clichés mémoire/système, core dump) et des métadonnées enregistrés par \fBsystemd\-coredump\fP(8)\&. .SH COMMANDES .PP Les commandes suivantes sont acceptées : .PP \fBlist\fP .RS 4 Lister les vidages mémoire capturés dans le journal correspondant aux caractéristiques spécifiées\&. Si aucune commande n’est indiquée, c’est le comportement par défaut\&. .sp La sortie est conçue pour être lisible humainement et contient une table comportant les colonnes suivantes\ : .PP TIME .RS 4 L’horodatage du plantage tel que rapporté par le noyau\&. .sp Ajouté dans la version 233\&. .RE .PP PID .RS 4 L’identifiant du processus ayant planté\&. .sp Ajouté dans la version 233\&. .RE .PP UID, GID .RS 4 Les identifiants d’utilisateur et de groupe du processus ayant planté\&. .sp Ajouté dans la version 233\&. .RE .PP SIGNAL .RS 4 Si applicable, le signal ayant causé le plantage du processus\&. .sp Ajouté dans la version 233\&. .RE .PP COREFILE .RS 4 Information indiquant si le vidage mémoire a été stocké et s’il est toujours accessible\ : «\ none\ » signifie qu’il n’a pas été stocké, «\ \-\ » signifie qu’il n’est pas disponible (par exemple, parce que le processus n’a pas été terminé par un signal), «\ present\ » signifie qu’il est accessible par l’utilisateur actuel, «\ journal\ » signifie qu’il a été stocké dans le «\ journal\ », «\ truncated\ » est similaire à une des deux précédentes, mais indique que le vidage était trop grand et qu’il n’a pas été stocké entièrement, «\ error\ » signifie qu’il n’est pas possible d’y accéder très vraisemblablement à cause de permissions insuffisantes et «\ missing\ » signifie qu’il a été stocké dans un fichier, mais que ce fichier a été supprimé depuis\&. .sp Ajouté dans la version 233\&. .RE .PP EXE .RS 4 Le chemin complet de l’exécutable\&. Pour les traces d’appel de script, c’est le nom de l’interpréteur\&. .sp Ajouté dans la version 233\&. .RE .sp Il convient de noter que des restrictions différentes s’appliquent aux données enregistrées dans le journal et aux fichiers de vidage mémoire enregistrés dans \fI/var/lib/systemd/coredump\fP\ ; voir la présentation générale dans \fBsystemd\-coredump\fP(8)\&. Il peut donc très bien arriver qu’un vidage mémoire particulier figure toujours dans le journal alors que le fichier de vidage mémoire correspondant a déjà été supprimé\&. .sp Ajouté dans la version 215\&. .RE .PP \fBinfo\fP .RS 4 Afficher des informations détaillées sur le dernier vidage mémoire ou sur les vidages mémoire correspondant aux caractéristiques spécifiées, capturées dans le journal\&. .sp Ajouté dans la version 215\&. .RE .PP \fBdump\fP .RS 4 Extraire le dernier vidage mémoire correspondant aux caractéristiques spécifiées\&. Le vidage mémoire est écrit sur la sortie standard à moins qu’un fichier de sortie soit indiqué avec l’option \fB\-\-output=\fP\&. .sp Ajouté dans la version 215\&. .RE .PP \fBdebug\fP .RS 4 Invoquer un débogueur pour le dernier vidage mémoire correspondant aux caractéristiques spécifiées\&. Par défaut, \fBgdb\fP(1) est utilisé\&. Cela peut être modifié en utilisant l’option \fB\-\-debugger=\fP ou la variable d’environnement \fI$SYSTEMD_DEBUGGER\fP\&. Utiliser l’option \fB\-\-debugger\-arguments=\fP pour passer des arguments supplémentaires au débogueur\&. .sp Ajouté dans la version 239\&. .RE .SH OPTIONS .PP Les options suivantes sont comprises : .PP \fB\-h\fP, \fB\-\-help\fP .RS 4 Afficher un aide\-mémoire succinct et quitter\&. .RE .PP \fB\-\-version\fP .RS 4 Afficher une information de version courte et quitter\&. .RE .PP \fB\-\-no\-pager\fP .RS 4 Ne pas rediriger (pipe) la sortie vers un afficheur (pager)\&. .RE .PP \fB\-\-no\-legend\fP .RS 4 Ne pas afficher de légende, c'est\-à\-dire les en\-têtes de colonne et le pied de page contenant des remarques. .RE .PP \fB\-\-json=\fP\fIMODE\fP .RS 4 Afficher la sortie formatée en JSON\&. Le mode attendu est « short » (pour la sortie la plus concise possible sans redondance d’espace ou de saut de ligne), « pretty » (pour une plus jolie version de la même chose avec indentation et sauts de ligne) ou « off » (pour désactiver la sortie JSON, comportement par défaut)\&. .RE .PP \fB\-1\fP .RS 4 Afficher des informations à propos du vidage mémoire le plus récent plutôt que de lister tous les vidages mémoire connus\&. C’est équivalent à \fB\-\-reverse \-n 1\fP\&. .sp Ajouté dans la version 215\&. .RE .PP \fB\-n\fP \fIENTIER\fP .RS 4 Afficher le nombre indiqué d’entrées\&. Le paramètre indiqué est un entier supérieur ou égal à 1\&. .sp Ajouté dans la version 248\&. .RE .PP \fB\-S\fP, \fB\-\-since\fP .RS 4 Afficher les entrées existant depuis la date indiquée\&. .sp Ajouté dans la version 233\&. .RE .PP \fB\-U\fP, \fB\-\-until\fP .RS 4 N’afficher que les entrées antérieures à la date indiquée\&. .sp Ajouté dans la version 233\&. .RE .PP \fB\-r\fP, \fB\-\-reverse\fP .RS 4 Inverser la sortie de manière que les enregistrements les plus récents soient affichés en premier\&. .sp Ajouté dans la version 233\&. .RE .PP \fB\-F\fP \fICHAMP\fP, \fB\-\-field=\fP\fICHAMP\fP .RS 4 Afficher toutes les valeurs possibles des données que prend le champ spécifié dans les entrées correspondantes de vidage mémoire du journal\&. .sp Ajouté dans la version 215\&. .RE .PP \fB\-o\fP \fIFICHIER\fP, \fB\-\-output=\fP\fIFICHIER\fP .RS 4 Enregistrer le vidage mémoire dans \fIFICHIER\fP\&. .sp Ajouté dans la version 215\&. .RE .PP \fB\-\-debugger=\fP\fIDÉBOGUEUR\fP .RS 4 Utiliser le débogueur indiqué pour la commande \fBdebug\fP\&. S’il n’est pas indiqué et que la variable d’environnement \fI$SYSTEMD_DEBUGGER\fP n’est pas définie, alors \fBgdb\fP(1) est utilisé\&. .sp Ajouté dans la version 239\&. .RE .PP \fB\-A\fP \fIARGS\fP, \fB\-\-debugger\-arguments=\fP\fIARGS\fP .RS 4 Passer les \fIARGS\fP comme arguments supplémentaires de la ligne de commande au débogueur\&. Mettre entre des guillemets appropriés quand \fIARGS\fP contient des blancs (voir Exemples)\&. .sp Ajouté dans la version 248\&. .RE .PP \fB\-\-file=\fP\fIGLOB\fP .RS 4 Cette option prend des métacaractères (glob) de fichier comme argument\&. Si spécifié, \fBcoredumpctl\fP opère sur les fichiers de journal correspondant au \fIGLOB\fP au lieu des chemins par défaut de journaux d’exécution\&. Cette option peut être spécifiée plusieurs fois, auquel cas les fichiers seront correctement entrelacés\&. .sp Ajouté dans la version 246\&. .RE .PP \fB\-D\fP \fIRÉP\fP, \fB\-\-directory=\fP\fIRÉP\fP .RS 4 Utiliser les fichiers de journal dans le \fIRÉP\fP spécifié\&. .sp Ajouté dans la version 225\&. .RE .PP \fB\-\-root=\fP\fIRACINE\fP .RS 4 Utiliser le répertoire racine \fIRACINE\fP lors de la recherche de vidages mémoire\&. .sp Ajouté dans la version 252\&. .RE .PP \fB\-\-image=\fP\fIimage\fP .RS 4 Cette option prend un chemin d’image disque ou un nœud de périphérique bloc\&. Si elle est indiquée, toutes les opérations sont effectuées dans le système de fichiers de l’image disque indiquée\&. Cette option est similaire à l’option \fB\-\-root=\fP, mais agit sur des systèmes de fichiers stockés dans des images disque ou des périphériques blocs\&. L’image disque doit contenir soit un seul système de fichiers, soit un ensemble de systèmes de fichiers d’une table de partitionnement GPT, suivant les \m[blue]\fBSpécifications UAPI\&.2 des Partitions Détectables\fP\m[]\&\s-2\u[1]\d\s+2\&. Pour de plus amples informations sur les images disque gérées, consulter l’option de \fBsystemd\-nspawn\fP(1) de même nom\&. .sp Ajouté dans la version 252\&. .RE .PP \fB\-\-image\-policy=\fP\fIpolitique\fP .RS 4 Cette option prend pour argument une chaine de politique d’image, comme pour \fBsystemd.image\-policy\fP(7)\&. La politique est imposée lors d'une opération sur l'image disque indiquée par \fB\-\-image=\fP, voir ci\-dessus\&. La politique par défaut est « * » si rien n'est indiqué, c'est\-à\-dire que tous les systèmes de fichiers reconnus de l'image sont utilisés\&. .RE .PP \fB\-q\fP, \fB\-\-quiet\fP .RS 4 Supprimer les messages informationnels concernant l’impossibilité d’accéder aux fichiers de journal et aux possibles vidages mémoire en cours\&. .sp Ajouté dans la version 233\&. .RE .PP \fB\-\-all\fP .RS 4 Regarder tous les fichiers de journal disponibles dans \fI/var/log/journal/\fP (en excluant les espaces de noms de journal) au lieu de ne regarder que les fichiers locaux\&. .sp Ajouté dans la version 250\&. .RE .SH CORRESPONDANCE .PP Une correspondance peut être\ : .PP \fIPID\fP .RS 4 Identifiant de processus du processus ayant généré un vidage mémoire\&. Un entier\&. .sp Ajouté dans la version 215\&. .RE .PP \fICOMM\fP .RS 4 Nom de l’exécutable (correspond à \fBCOREDUMP_COMM=\fP)\&. Ne doit pas contenir de barre oblique\&. .sp Ajouté dans la version 215\&. .RE .PP \fIEXE\fP .RS 4 Chemin de l’exécutable (correspond à \fBCOREDUMP_EXE=\fP)\&. Doit contenir au moins une barre oblique\&. .sp Ajouté dans la version 215\&. .RE .PP \fIMATCH\fP .RS 4 Filtre général des correspondances de \fBjournalctl\fP ; doit contenir un signe égal («\ =\ »)\&. Consulter \fBjournalctl\fP(1)\&. .sp Ajouté dans la version 215\&. .RE .SH "CODE DE RETOUR" .PP En cas de réussite, \fB0\fP est renvoyé, un code d'échec différent de zéro sinon\&. Ne trouver aucun vidage mémoire correspondant est traité comme un échec\&. .SH ENVIRONNEMENT .PP \fI$SYSTEMD_DEBUGGER\fP .RS 4 Utiliser le débogueur indiqué pour la commande \fBdebug\fP\&. Voir l’option \fB\-\-debugger=\fP\&. .sp Ajouté dans la version 239\&. .RE .SH EXEMPLES .PP \fBExemple\ \&1.\ \&Liste de tous les vidages mémoire d’un programme\fP .sp .if n \{\ .RS 4 .\} .nf $ coredumpctl list /usr/lib64/firefox/firefox TIME PID UID GID SIG COREFILE EXE SIZE Tue \&... 8018 1000 1000 SIGSEGV missing /usr/lib64/firefox/firefox \- Wed \&... 251609 1000 1000 SIGTRAP missing /usr/lib64/firefox/firefox \- Fri \&... 552351 1000 1000 SIGSEGV present /usr/lib64/firefox/firefox 28\&.7M .fi .if n \{\ .RE .\} .PP Le journal a trois entrées relatives à \fI/usr/lib64/firefox/firefox\fP, et seule la dernière entrée a encore un fichier de vidage mémoire disponible (dans un stockage externe sur disque)\&. .PP Notez que \fBcoredumpctl\fP doit pouvoir accéder aux fichiers de journal pour récupérer les entrées pertinentes dans le journal\&. Par conséquent, un utilisateur non privilégié ne pourra normalement voir que les informations concernant des plantages de programme de cet utilisateur\&. .PP \fBExemple\ \&2.\ \&Invoquer gdb sur le dernier vidage mémoire\fP .sp .if n \{\ .RS 4 .\} .nf $ coredumpctl debug .fi .if n \{\ .RE .\} .PP \fBExemple\ \&3.\ \&Utiliser gdb pour afficher les informations complètes de registre dans le dernier vidage mémoire\fP .sp .if n \{\ .RS 4 .\} .nf $ coredumpctl debug \-\-debugger\-arguments="\-batch \-ex \*(Aqinfo all\-registers\*(Aq" .fi .if n \{\ .RE .\} .PP \fBExemple\ \&4.\ \&Afficher les informations concernant un vidage mémoire correspondant au PID\fP .sp .if n \{\ .RS 4 .\} .nf $ coredumpctl info 6654 PID: 6654 (bash) UID: 1000 (user) GID: 1000 (user) Signal: 11 (SEGV) Timestamp: Mon 2021\-01\-01 00:00:01 CET (20s ago) Command Line: bash \-c $\*(Aqkill \-SEGV $$\*(Aq Executable: /usr/bin/bash Control Group: /user\&.slice/user\-1000\&.slice/\&... Unit: user@1000\&.service User Unit: vte\-spawn\-\&...\&.scope Slice: user\-1000\&.slice Owner UID: 1000 (user) Boot ID: \&... Machine ID: \&... Hostname: \&... Storage: /var/lib/systemd/coredump/core\&.bash\&.1000\&.\&...\&.zst (present) Size on Disk: 51\&.7K Message: Process 130414 (bash) of user 1000 dumped core\&. Stack trace of thread 130414: #0 0x00007f398142358b kill (libc\&.so\&.6 + 0x3d58b) #1 0x0000558c2c7fda09 kill_builtin (bash + 0xb1a09) #2 0x0000558c2c79dc59 execute_builtin\&.lto_priv\&.0 (bash + 0x51c59) #3 0x0000558c2c79709c execute_simple_command (bash + 0x4b09c) #4 0x0000558c2c798408 execute_command_internal (bash + 0x4c408) #5 0x0000558c2c7f6bdc parse_and_execute (bash + 0xaabdc) #6 0x0000558c2c85415c run_one_command\&.isra\&.0 (bash + 0x10815c) #7 0x0000558c2c77d040 main (bash + 0x31040) #8 0x00007f398140db75 __libc_start_main (libc\&.so\&.6 + 0x27b75) #9 0x0000558c2c77dd1e _start (bash + 0x31d1e) .fi .if n \{\ .RE .\} .PP \fBExemple\ \&5.\ \&Extraire le dernier vidage mémoire de /usr/bin/toto dans un fichier toto\&.coredump\fP .sp .if n \{\ .RS 4 .\} .nf $ coredumpctl \-o toto\&.coredump dump /usr/bin/toto .fi .if n \{\ .RE .\} .SH "VOIR AUSSI" .PP \fBsystemd\-coredump\fP(8), \fBcoredump.conf\fP(5), \fBsystemd\-journald.service\fP(8), \fBgdb\fP(1) .SH NOTES .IP " 1." 4 UAPI.2 Spécification des Partitions Détectables .RS 4 \%https://uapi\-group.org/specifications/specs/discoverable_partitions_specification .RE .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Jean-Paul Guillonneau . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .