JOURNALCTL(1) journalctl JOURNALCTL(1) NOM journalctl -- Afficher les enregistrements du journal de systemd SYNOPSIS journalctl [OPTIONS...] [CORRESPONDANCES...] DESCRIPTION journalctl permet d'afficher les enregistrements stockes dans le journal par systemd-journald.service(8) et systemd-journal-remote.service(8). Si journalctl est appele sans parametres, il affichera le contenu du journal accessible a l'utilisateur appelant en commencant par le plus ancien enregistrement collecte. Si un ou plusieurs arguments de correspondance sont passes, la sortie sera filtree en consequence. Une correspondance est dans le format << CHAMP=VALEUR >>, c'est a dire << _SYSTEMD_UNIT=httpd.service >>, faisant reference aux composants d'un enregistrement de journal structure. Consulter systemd.journal-fields(7) pour une liste des champs bien connus. Si plusieurs correspondances sont indiquees et correspondent a differents champs, les enregistrements sont filtres en fonction des deux, c'est a dire que la sortie resultante affichera seulement les enregistrements correspondant a toutes les correspondances specifiees de ce type. Si deux correspondances s'appliquent au meme champ, elles sont automatiquement mises en correspondance comme alternatives, c'est-a-dire que la sortie resultante affichera les enregistrements qui correspondent a une des correspondances indiquees pour le meme champ. Enfin, le caractere << + >> peut apparaitre comme un terme distinct des autres termes sur la ligne de commande. Cela resulte en une combinaison de toutes les correspondances indiquees avant et apres dans une disjonction (c'est-a-dire un OU logique). Il est aussi possible de filtrer les enregistrements du journal en indiquant un chemin absolu de fichier comme argument. Le chemin de fichier peut etre un fichier ou un lien symbolique et le fichier doit exister au moment de la demande. Si un chemin de fichier fait reference a un fichier binaire executable, une correspondance << _EXE= >> pour le chemin canonique du binaire est ajoutee a la demande. Si un chemin de fichier fait reference a un script executable, une correspondance << _COMM= >> au nom du script est ajoutee a la requete. Si un chemin de fichier fait reference a un noeud de peripherique, des correspondances << _KERNEL_DEVICE= >> au nom du peripherique dans le noyau et a chacun de ses peripheriques ancetres sont ajoutees a la requete. Les liens symboliques sont dereferences, les noms dans le noyau sont synthetises, et les peripheriques parents sont identifies a partir l'environnement au moment de la requete. En general, un noeud de peripherique est le meilleur mandataire pour un peripherique physique, car les enregistrements ne contiennent habituellement pas de champs qui identifient un peripherique physique.Pour que les enregistrements qui en resultent soient correctes pour le peripherique physique, les elements pertinents de l'environnement au moment ou l'enregistrement a ete ecrit, en particulier le peripherique physique correspondant au noeud du peripherique ree, doivent etre les memes que ceux au moment de la requete. Car les noeuds de peripherique changent generalement leurs peripheriques correspondants lors des reamorcages. Indiquer un chemin de noeud de peripherique entrainera les enregistrements resultants a etre restreints a ceux de l'amorcage actuel. Des restrictions supplementaires peuvent etre ajoutees en utilisant les options --boot, unit=, etc., pour limiter davantage les enregistrements du journal qui seront affiches (ET logique). La sortie est construite a partir de tous les fichiers journaux accessibles, qu'ils soient en cours d'ecriture ou qu'ils aient subi une rotation, et indifferemment qu'ils appartiennent au systeme ou soient des journaux accessibles de l'utilisateur. L'option --header peut etre utilisee pour identifier quels fichiers sont montres. L'ensemble des fichiers de journal qui seront utilises peut etre modifie en utilisant les options --user, --system, --directory et --file ; voir ci-dessous. Tous les utilisateurs ont acces a leurs propres journaux prives. Neanmoins, par defaut, seul << root >> et les utilisateurs membres de quelques groupes speciaux ont la permission d'acceder au journal du systeme et aux journaux d'autres utilisateurs. Les membres des groupes << systemd-journal >>, << adm >> et << wheel >> peuvent lire tous les fichiers de journal. Notez que ces deux derniers groupes ont traditionnellement des privileges supplementaires specifiques a la distribution utilisee. Les membres du groupe << wheel >> peuvent souvent effectuer les taches administratives. La sortie est affichee par less (par defaut) et les longues lignes sont << tronquees >> a la largeur de l'ecran. La partie cachee peut etre visualisee en utilisant les touches fleche-gauche et fleche-droite. L'utilisation du visionneur peut etre desactivee ; voir l'option --no-pager et la section << Environnement >> ci-dessous. Lorsque la sortie est sur une console tty, les lignes sont coloriees suivant leur priorite : les lignes des niveaux << ERROR >> et superieurs sont coloriees en rouge, les lignes du niveau << WARNING >> sont coloriees en jaune, les lignes du niveau << NOTICE >> sont en surbrillance, les lignes du niveau << INFO >> sont affichees normalement et les lignes du niveau << DEBUG >> sont coloriees en gris. Pour ecrire des enregistrements dans le journal, plusieurs methodes peuvent etre utilisees. En general, la sortie des unites systemd est automatiquement connectee au journal ; voir systemd-journal.service(8). De plus, systemd-cat peut etre utilise pour envoyer directement des messages au journal. OPTIONS DE DEFINITION DE LA SOURCE Les options suivantes controlent l'origine des enregistrements du journal a lire : --system, --user Afficher les messages des services du systeme et du noyau (avec --system). Afficher les messages des services de l'utilisateur actuel (avec --user). Si aucun des deux n'est indique, afficher tous les messages que l'utilisateur peut lire. L'option --user affecte le traitement des arguments --unit=. Voir --unit=. Notez que --user ne fonctionne que si la journalisation persistante est activee avec le reglage Storage= dans journal.conf(5). Ajoute dans la version 205. -M, --machine= Afficher les messages d'un conteneur local en fonctionnement. Indiquer un nom de conteneur auquel se connecter. Ajoute dans la version 206. -m, --merge Afficher les enregistrements construits a partir de tous les journaux accessibles, y compris ceux distants. Ajoute dans la version 190. -D REP, --directory=REP Prend un chemin de repertoire comme argument. Si indique, journalctl operera sur le repertoire de journaux indique par REP au lieu de l'environnement d'execution par defaut et des chemins du journal du systeme. Ajoute dans la version 187. --file=GLOB Prend un glob de fichier comme argument. Si indique, journalctl operera sur les fichiers de journal indiques correspondants a GLOB au lieu de l'environnement d'execution par defaut et des chemins du journal du systeme. Cela peut etre indique plusieurs fois, auquel cas les fichiers seront entrelaces de maniere appropriee. Ajoute dans la version 205. --root=ROOT Prend un chemin de repertoire comme argument. Si indique, journalctl operera sur les repertoires de journal et la hierarchie des catalogues de fichiers sous le repertoire indique au lieu du repertoire racine (par exemple, --update-catalog creera ROOT/var/lib/systemd/catalog/database et les fichiers de journal sous ROOT/run/journal/ ou ROOT/var/log/journal/ seront affiches). Ajoute dans la version 201. --image=IMAGE Prend un chemin vers un fichier d'image disque ou un noeud de peripherique bloc comme argument. Si indique, journalctl operera sur le systeme de fichiers de l'image disque indiquee. Cette option est similaire a --root=, mais agit sur les systemes de fichiers stockes dans des images disque ou des peripheriques bloc, fournissant ainsi une methode simple d'extraire les donnees des journaux des images disque. L'image disque doit contenir un seul systeme de fichiers, ou un ensemble de systemes de fichiers dans une table de partitionnement GPT, en suivant la Specification des partitions detectables[1]. Pour plus d'informations sur les images disque prises en charge, voir systemd-nspawn(1) et son commutateur du meme nom. Ajoute dans la version 247. --image-policy=politique Cette option prend pour argument une image de chaine de politique, comme pour systemd.image-policy(7). La politique est imposee lors d'une operation sur l'image disque indiquee par --image=, voir ci-dessus. C'est par defaut la politique << * >> si rien n'est indique, c'est-a-dire tous les systemes de fichiers reconnus de l'image sont utilises. --namespace=ESPACE_NOM Prend une chaine d'identifiant d'espace de noms de journaux comme argument. Si cet argument n'est pas indique, les donnees collectees par l'espace de noms par defaut sont affichees. Si indique, les donnees de journaux de l'espace de noms indique sont affichees. Si l'espace de noms indique est << * >>, les donnees de tous les espaces de noms sont affichees, entrelacees. Si l'identifiant d'espace de noms est prefixe avec << + >>, les donnees de l'espace de noms indique et de l'espace de noms par defaut sont affichees, entrelacees, mais pas celles des autres. Pour plus de details sur les espaces de noms de journaux, consulter systemd-journals-service(8). Ajoute dans la version 245. OPTIONS DE FILTRAGE Les options suivantes controlent comment filtrer les enregistrements du journal : -S, --since=, -U, --until= Commencer a montrer les enregistrements soit plus recentes que la date specifiee, soit anterieures a la date specifiee, respectivement. Les indications de date doivent etre du format << 2012-10-30 18:17:16 >>. Si la partie temps est omise, << 00:00:00 >> est implicite. Si seul le composant secondes est omis, << :00 >> est implicite. Si le composant date est omis, la date du jour courant est implicite. Comme alternative les chaines << yesterday >>, << today >>, << tomorrow >> sont comprises, comme se referant a 00:00:00 le jour avant le jour actuel, le jour actuel, ou le jour apres le jour actuel, respectivement. << now >> se refere au moment present. Et des temps relatifs peuvent etre indiques prefixes avec << - >> ou << + >>, en fonction des moments voulus avant ou apres le moment present, respectivement. Pour des informations completes sur les specifications de dates et de temps voir systemd.time(7). Notez que --output=short-full affiche les horodateurs qui suivent precisement ce format. Ajoute dans la version 195. -c, --cursor= Commencer a montrer les enregistrements depuis l'endroit dans le journal indique par la valeur du curseur passee en parametre. Rajoute dans la version 193. --after-cursor= Commencer a montrer les enregistrements a partir de l'endroit dans le journal indique par la valeur du curseur passee en parametre. Le curseur est affiche en utilisant l'option --show-cursor. Ajoute dans la version 206. --cursor-file=FICHIER Si FICHIER existe et contient un curseur, commencer a afficher les enregistrements apres cet endroit. Sinon, les enregistrements sont affiches en fonction des autres options donnees. A la fin, ecrire le curseur de la derniere entree dans FICHIER. Utiliser cette option pour lire le journal continuellement a travers des appels sequentiels a journalctl. Ajoute dans la version 242. -b [[ID][+-decalage]|all], --boot[=[ID][+-decalage]|all] Afficher les messages depuis un demarrage specifique. Cela ajoutera une correspondance pour << _BOOT_ID= >>. L'argument peut etre vide, auquel cas les journaux du demarrage actuel seront montres. Si l'identifiant du demarrage est omis, un decalage positif permet de rechercher les demarrages a partir du debut du journal, et un decalage egal ou inferieur a zero cherchera les demarrages depuis la fin du journal. Ainsi, 1 signifie le premier demarrage trouve dans le journal par ordre chronologique, 2 sera le second, etc ; alors que -0 est le dernier demarrage, -1 le demarrage avant le dernier, etc. Un decalage vide est equivalent a indiquer -0, sauf lorsque le demarrage actuel n'est pas le dernier demarrage (car par exemple --directory a ete indique pour regarder les journaux d'une autre machine). Si l'ID de 32 caracteres est indique, il peut eventuellement etre suivi du decalage qui identifie le demarrage relatif a celui donne par l'ID du demarrage. Les valeurs negatives signifient les demarrages plus anciens, et les valeurs positives les demarrages plus recents. Si decalage n'est pas indique, une valeur de zero est implicite, et les journaux du demarrage donne par l'ID sont montres. L'argument special all peut etre utilise pour inhiber l'effet d'un usage precedent de -b. Ajoute dans la version 186. -u, --unit=UNITE|MOTIF Afficher les messages de l'unite systemd UNITE indiquee (telle une unite service), ou toute autre unite correspondant au MOTIF. Si un motif est indique, une liste de noms d'unite trouves dans le journal est comparee avec le motif indique et toutes les correspondances sont utilisees. Pour chaque nom d'unite, une correspondance est ajoutee dans les messages de l'unite (<< _SYSTEMD_UNIT=UNITE >>), avec des correspondances supplementaires des messages de systemd et des messages a propos des coredumps de l'unite indiquee. Une correspondance est aussi ajoutee pour << _SYSTEMD_SLICE=UNITE >>, de facon que si l'UNITE fournie est une unite systemd.slice(5), tous les journaux des enfants de la << slice >> (tranche) seront affiches. Avec --user, tous les arguments --unit= seront convertis pour correspondre aux messages utilisateur comme s'ils etaient specifies avec --user-unit=. Ce parametre peut etre indique plusieurs fois. Ajoute dans la version 195. --user-unit= Afficher les messages pour l'unite de la session utilisateur indiquee. Cela ajoutera une correspondance pour les messages de l'unite (<< _SYSTEMD_USER_UNIT= >> et << UID= >>) et des correspondances supplementaires des messages de la session de systemd et des messages a propos des coredumps de l'unite indiquee. Une correspondance est aussi ajoutee a << _SYSTEMD_SLICE=UNITE >>, ainsi si l'UNITE fournie est une unite systemd.slice(5), tous les journaux des enfants de l'unite seront montres. Ce parametre peut etre indique plusieurs fois. Ajoute dans la version 198. -t, --identifier=SYSLOG_IDENTIFIER Afficher les messages pour l'identifiant syslog SYSLOG_IDENTIFIER. Ce parametre peut etre indique plusieurs fois. Ajoute dans la version 217. -p, --priority= Filtrer la sortie par priorite des messages ou par plage de priorites. Prend soit un seul chiffre ou un niveau de journalisation textuel (c'est-a-dire entre 0/<< emerg >> et 7/<< debug >>), ou une plage de niveaux de journalisation numeriques ou textuels de la forme FROM..TO. les niveaux de journalisation sont les niveaux habituels de syslog comme documente dans syslog(3), c'est-a-dire << emerg >> (0), << alert >> (1), << crit >> (2), << err >> (3), << warning >> (4), << notice >> (5), << info >> (6), << debug >> (7). Si un seul niveau de journalisation est indique, tous les messages de ce niveau de journalisation ou d'un niveau plus bas (de ce fait plus importants) sont affiches. Si une plage est indiquee, tous les messages a l'interieur de cette plage sont affiches, incluant aussi la valeur de debut et celle de fin de la plage. Cela ajoutera les correspondances << PRIORITY= >> pour les priorites indiquees. Ajoute dans la version 188. --facility= Filtrer la sortie en fonction de l'installation syslog. Prend une liste de numeros ou de noms de << facility >> separes par une virgule. Les noms sont les noms usuels de << facilities >> de syslog, consulter syslog(3). --facility=help permet d'afficher une liste de noms de << facility >> connus et quitter. Ajoute dans la version 245. -g, --grep= Filtrer la sortie aux enregistrements ou le champ MESSAGE= correspond a l'expression rationnelle indiquee. Les expressions rationnelles compatibles avec PERL sont utilisees, voir pcre2pattern(3) pour une description detaillee de la syntaxe. Si le motif est entierement compose de caracteres en minuscules, la correspondance se fera de maniere insensible a la casse. Autrement, la comparaison est sensible a la casse. Cela peut etre ecrase avec l'option --case-sensitive, voir ci-dessous. Lorsque utilise avec --lines= (sans prefixe << + >>), --reverse est implicite. Ajoute dans la version 237. --case-sensitive[=BOOLEAN] Rendre le motif de comparaison sensible ou insensible a la casse. Ajoute dans la version 237. -k, --dmesg N'afficher que les messages du noyau. Cela implique -b et ajoute la correspondance << _TRANSPORT=kernel >>. Ajoute dans la version 205. OPTIONS DE SORTIE Les options suivantes controlent comment sont affiches les enregistrements du journal : -o, --output= Controle le formatage des enregistrements du journal qui sont affiches. Prend une des options suivantes : short est l'option par defaut qui genere une sortie presque identique au formatage des fichiers syslog classiques, affichant une ligne par enregistrement du journal. Ajoute dans la version 206. short-full est tres similaire, mais affiche les horodateurs dans un format accepte par les options --since= et --until=. Contrairement a l'information d'horodatage montree dans le mode de sortie de short, ce mode inclut le jour de la semaine, l'annee et le fuseau horaire dans la sortie, et est independant des parametres regionaux. Ajoute dans la version 232. short-iso est tres similaire, mais montre les horodatages sous forme de profil ISO 8601 RFC 3339[2]. Ajoute dans la version 206. short-iso-precise comme pour short-iso mais inclut une precision a la microseconde pres. Ajoute dans la version 234. short-precise est tres similaire, mais montre les horodatages syslog classiques avec une precision a la microseconde pres. Ajoute dans la version 207. short-monotonic est tres similaire, mais montre les horodatages monotoniques au lieu des horodatages locaux. Ajoute dans la version 206. short-delta comme pour short-monotonic mais incluant l'ecart de temps avec l'entree precedente. Les ecarts de temps non fiables sont marques comme << * >>. Ajoute dans la version 252. short-unix est tres similaire, mais montre les secondes passees depuis le premier janvier 1970 UTC au lieu des temporisateurs horloge (<< temps UNIX >>). Le temps est montre avec une exactitude a la microseconde pres. Ajoute dans la version 198. verbose affiche les elements d'enregistrement entierement structures avec tous les champs. Ajoute dans la version 206. export serialise le journal en un flux binaire (mais principalement base sur du texte) adapte aux sauvegardes et aux transferts reseau (voir Format Export du journal[3] pour plus d'informations). Pour reimporter le flux binaire dans un format natif de journald, utiliser systemd-journal-remote(8). Ajoute dans la version 206. json formate les enregistrements en objets JSON, separes par un caractere nouvelle ligne (voir Format JSON du journal[4] pour plus d'informations). Les valeurs de champ sont generalement encodees comme chaine JSON, avec trois exceptions : 1. Les champs plus grands que 4096 octets sont encodes comme valeurs null. Cela peut etre desactive en passant --all, mais attention car cela peut allouer des objets JSON excessivement longs. 2. Les enregistrements du journal permettent des champs non uniques dans le meme enregistrement. JSON n'autorise pas les champs non uniques dans ses objets. Pour cette raison, si un champ non unique est rencontre, un tableau JSON est utilise comme valeur du champ, listant toutes les valeurs de champ comme elements. 3. Les champs qui contiennent des octets non imprimables ou non UTF-8 sont encodes en tableaux contenant les octets bruts formates comme nombres non-signes. Notez que cet encodage est reversible (avec l'exception de la limitation de taille). Ajoute dans la version 206. json-pretty formate les enregistrements JSON comme des structures de donnees, mais les formate sur plusieurs lignes pour les rendre plus lisibles par un humain. Ajoute dans la version 206. json-sse formate les enregistrements en structures de donnees JSON, mais les enveloppe dans un format utilisable pour Server-Sent Events[5]. Ajoute dans la version 206. json-seq formate les enregistrements en structures de donnees JSON, mais les prefixe avec le caractere separateur d'enregistrement ASCII (Ox1E) et les suffixe d'un caractere de saut de ligne ASCII (0x0A), en accord avec JavaScript Object Notation (JSON) Text Sequences[6] (<< application/json-seq >>). Ajoute dans la version 240. cat genere une sortie tres succincte, n'affichant que le message reel de chaque enregistrement du journal, sans aucune metadonnee, pas meme un horodatage. Si combine avec l'option --output-fields=, la sortie listera les champs pour chaque enregistrement de journal, au lieu du message. Ajoute dans la version 206. with-unit similaire a short-full, mais prefixe les noms d'unite et d'utilisateur de l'unite au lieu de l'identifiant syslog habituel. Utile lors de l'utilisation d'instances modelisees, car il inclura les arguments dans les noms d'unites&. Ajoute dans la version 239. --truncate-newline Tronquer chaque message du journal au premier caractere de nouvelle ligne sur la sortie, de facon que seule la premiere ligne de chaque message soit affichee. Ajoute dans la version 254. --output-fields= Une liste separee par des virgules de champs qui devraient etre inclus dans la sortie. Cela a un impact seulement sur les modes de sortie qui montrent normalement tous les champs (verbose, export, json, json-pretty, json-sse et json-seq), comme avec cat. Pour le premier, les champs << __CURSOR >>, << __REALTIME_TIMESTAMP >>, << __MONOTONIC_TIMESTAMP >> et << _BOOT_ID >> sont toujours affiches. Ajoute dans la version 236. -n, --lines= Afficher les evenements les plus recents du journal et limiter le nombre d'evenements affiches. L'argument est un entier positif ou << all >> pour desactiver la limitation. De plus, si le nombre est prefixe avec << + >>, les plus vieux evenements du journal sont utilises a la place. La valeur par defaut est 10 si aucun argument n'est donne. Si --follow est utilisee, cette option est implicite. Lorsque non prefixee avec << + >> et utilisee avec --grep=, --reverse est implicite. -r, --reverse Inverser la sortie de maniere a ce que les enregistrements les plus recents soient affiches en premier. Ajoute dans la version 198. --show-cursor Le curseur est affiche apres la derniere entree apres deux tirets : -- cursor: s=0639... Le format du curseur est personnel et sujet a modification. Ajoute dans la version 206. --utc Afficher le temps en Temps Universel Coordonne (UTC). Ajoute dans la version 217. -x, --catalog Augmenter la taille des lignes des journaux avec des textes explicatifs du catalogue des messages. Cela ajoutera des textes explicatifs d'aide des messages de journaux dans la sortie quand cela est possible. Ces courts textes d'aide expliquent le contexte d'une erreur ou d'un evenement de journal, les solutions possibles, ainsi que des pointeurs vers des forums de support, la documentation de developpeur et toute autre chose relevant du manuel. Notez que les textes d'aide ne sont pas disponibles pour tous les messages, mais seulement ceux selectionnes. Pour plus d'informations sur le catalogue de messages, veuillez lire la Documentation du developpeur du catalogue de messages[7]. Note : Lorsque vous attachez une sortie de journalctl a un rapport de bogue, veuillez ne pas utiliser -x. Ajoute dans la version 196. --no-hostname Ne pas montrer le champ du nom d'hote des messages journaux originaires de l'hote local. Cette directive n'a un effet que sur les modes de sortie de la famille short, voir ci-dessus. Note : cette option n'enleve pas les occurrences de nom d'hote des enregistrements des journaux, donc cela n'empeche pas le nom d'hote d'etre visible dans les journaux. Ajoute dans la version 198. --no-full, --full, -l Ellipser les champs lorsqu'ils ne tiennent pas dans les colonnes disponibles. Par defaut, tous les champs sont montres, pouvant etre replies ou tronques par un visionneur, si on en utilise un. Les anciennes options -l/--full ne sont plus utiles, sauf pour annuler --no-full. Ajoute dans la version 196. -a, --all Afficher tous les champs en entier, meme s'ils contiennent des caracteres non imprimables ou sont tres longs. Par defaut les champs contenant des caracteres non imprimables sont abreges en << donnees blob >> (notez que le visionneur pourrait encore echapper les caracteres non imprimables.) -f, --follow Ne montrer que les enregistrements du journal les plus recents, en affichant de maniere continue les nouveaux enregistrements au fur et a mesure de leur apparition dans le journal. --no-tail Afficher toutes les lignes de sortie stockees, meme en mode << follow >>. Annule l'effet de --lines=. -q, --quiet Supprimer tous les messages informatifs (c'est-a-dire << --Journal begins at... >>, << -- Reboot -- >>), tous les messages d'avertissement a propos de journaux systeme inaccessibles lors d'une execution en tant qu'utilisateur normal. OPTIONS DE CONTROLE DU VISIONNEUR Les options suivantes controlent la prise en charge de l'affichage : --no-pager Ne pas rediriger (pipe) la sortie vers un afficheur (pager). -e, --pager-end Sauter immediatement a la fin du journal dans l'outil du visionneur implique. Cela implique -n1000 pour s'assurer que le visionneur ne mettra pas en memoire tampon des journaux de taille illimitee. Cela peut etre outrepasse avec un -n explicite avec une autre valeur numerique, alors que -nall desactivera cette directive. Notez que cette option n'est prise en charge que par le visionneur less(1). Ajoute dans la version 198. OPTIONS FSS (FORWARD SECURE SEALING) Les options suivantes peuvent etre utilisees avec la commande --setup-keys decrite ci-dessous : --interval= Indiquer l'intervalle de changement pour la cle de securisation lors de la generation d'une paire de cle FSS avec --setup-keys. Des intervalles plus courts augmentent la consommation de l'unite centrale mais raccourcissent la periode pendant laquelle les modifications du journal sont indetectables. Par defaut, 15 mn. Ajoute dans la version 189. --verify-key= Indiquer la cle de verification FSS a utiliser pour l'operation --verify. Ajoute dans la version 189. --force Lorsque --setup-keys est passee et que FSS a deja ete configure, recreer des cles FSS. Ajoute dans la version 206. COMMANDES Les commandes suivantes sont prises en compte. Si aucune n'est indiquee, les enregistrements du journal seront affiches par defaut. -N, --fields Afficher tous les noms des champs actuellement utilises dans tous les enregistrements du journal. Ajoute dans la version 229. -F, --field= Afficher toutes les valeurs de donnees possibles que le champ specifie peut prendre dans tous les enregistrements du journal. Ajoute dans la version 195. --list-boots Montrer une liste tabulaire de numeros de demarrage (relatifs au demarrage actuel), leurs identifiants, et l'horodatage du premier et dernier message se rapportant au demarrage. Ajoute dans la version 206. --disk-usage Afficher l'utilisation actuelle du disque par tous les fichiers de journal. Cela affiche la somme de l'utilisation du disque pour tous les fichiers actifs ou archives de journal. Ajoute dans la version 190. --vacuum-size=, --vacuum-time=, --vacuum-files= --vacuum-size= supprime les fichiers journaux archives les plus anciens jusqu'a ce que l'espace disque qu'ils utilisent tombe en dessous de la taille specifiee. Accepte les suffixes habituels << K >>, << M >> et << T >> (sur une base de 1024). --vacuum-time= supprime les fichiers journaux archives plus vieux que l'intervalle de temps indique. Accepte les suffixes habituels << s >> (par defaut), << m >>, << h >>, << days >>, << months >>, << weeks >> et << years >>, consulter systemd.time(7) pour les details. --vacuum-files= ne laisse que le nombre specifie de fichiers journaux distincts. Notez qu'executer --vacuum-size= a seulement un effet indirect sur la sortie affichee par --disk-usage, ce dernier incluant les fichiers journaux actifs, alors que l'operation de nettoyage n'opere que sur les fichiers journaux archives. De facon similaire,, --vacuum-files= peut ne pas reduire reellement le nombre de fichiers journaux en dessous du nombre specifie, car il ne supprimera pas les fichiers journaux actifs. --vacuum-size=, --vacuum-time= et --vacuum-files= peuvent etre combines en une seule invocation pour assurer toute combinaison de taille, de temps et de nombre limite pour les fichiers de journal archives. Le fait de specifier l'un de ces trois parametres comme etant egal a zero equivaut a ne pas appliquer la limite specifique et est donc redondant. Ces trois directives peuvent aussi etre combinees avec --rotate dans une commande. Ainsi, tous les fichiers actifs sont mis en rotation en premier, et l'operation de nettoyage est executee juste apres. La rotation a pour effet que tous les fichiers actuellement actifs sont archives (et potentiellement des nouveaux fichiers non vides sont ouverts en remplacement), et c'est pourquoi l'operation de nettoyage a le plus grand effet, car elle permet de prendre en compte toutes les donnees ecrites jusqu'a present. Ajoute dans la version 218. --verify Verifier la coherence interne du fichier journal. Si le fichier a ete produit avec FSS active et que la cle FSS de verification a ete specifiee avec --verify-key=, l'authenticite du fichier journal est verifiee. Ajoute dans la version 189. --sync Demander au demon de journalisation d'ecrire toutes les donnees du journal non encore ecrites sur le systeme de fichiers de sauvegarde et de synchroniser tous les journaux. Cet appel ne rend la main qu'une fois l'operation de synchronisation terminee. Cette commande assure que tout message de journaux ecrit avant cette invocation soit stocke en toute securite sur le disque lorsqu'elle rend la main. Ajoute dans la version 228. --relinquish-var Demander au demon de journalisation l'operation inverse de --flush : sur demande, le demon ecrira d'autres donnees de journalisation dans /run/log/journal/ et arretera d'ecrire dans /var/log/journal/. Un appel ulterieur a --flush fait rebasculer la sortie du journal dans /var/log/journal/, voir ci-dessus. Ajoute dans la version 243. --smart-relinquish-var Similaire a --relinquish-var, mais n'execute aucune operation si le fichier racine du systeme et /var/log/journal/ sont sur le meme point de montage. Cette operation s'execute lors de l'arret pour que le demon de journalisation arrete d'ecrire des donnees dans /var/log/journal/ au cas ou ce repertoire serait situe sur un point de montage qui necessiterait d'etre demonte. Ajoute dans la version 243. --flush Demander au demon de journalisation de deplacer toutes les donnees du journal stockees dans /run/log/journal/ dans /var/log/journal/, si le stockage persistant est active. Cet appel ne rend la main qu'une fois l'operation terminee. Notez que cet appel est idempotent : les donnees sont deplacees de /run/log/journal/ dans /var/log/journal une fois seulement lors de l'execution du systeme (voir --relinquish-var ci-dessous), et cette commande finit proprement sans executer aucune operation si cela a deja ete fait. Cette operation assure qu'effectivement toutes les donnees sont deplacees dans /var/log/journal/ au moment ou elle rend la main. Ajoute dans la version 217. --rotate Demander au demon de journalisation de faire tourner les fichiers journaux. Cet appel ne rend la main qu'une fois l'operation de rotation terminee. La rotation de fichiers journal a pour effet que tous les fichiers de journal actifs sont marques comme archives et renommes, ainsi ils ne seront plus ecrits dans le futur. Des nouveaux fichiers (vides) du journal sont ainsi crees a leur place. Cette operation peut etre combinee avec --vacuum-size=, --vacuum-time= et --vacuum-file= dans une seule commande, voir ci-dessus. Ajoute dans la version 227. --header Au lieu de montrer le contenu du journal, afficher l'information interne des en-tetes des champs du journal accede. Cette option est particulierement utile pour essayer d'identifier des enregistrements du journal en desordre, comme cela arrive si la machine est amorcee avec un mauvais temps systeme. Ajoute dans la version 187. --list-catalog [ID_128_bits...] Lister le contenu du catalogue des messages sous forme de tableau d'identifiants de messages, avec leurs chaines de description courte. Si des identifiants ID_128_bits sont indiques, seuls ces enregistrements sont affiches. Ajoute dans la version 196. --dump-catalog [ID_128_bits-...] Afficher le contenu du catalogue de messages, les enregistrements etant separes par une ligne constituee de deux tirets et de l'ID (le format est le meme que celui des fichiers .catalog). Si des identifiants ID_128_bits sont indiques, seuls ces enregistrements sont affiches. Ajoute dans la version 199. --update-catalog Mettre a jour l'index du catalogue de messages. Cette commande doit etre executee chaque fois que des nouveaux fichiers du catalogue sont installes, supprimes ou mis a jour pour reconstruire l'index binaire du catalogue. Ajoute dans la version 196. --setup-keys Au lieu de montrer le contenu du journal, generer une nouvelle paire de cles FSS. Cela generera une cle de securisation ainsi qu'une cle de verification. La cle de securisation est stockee dans le repertoire de donnees du journal et doit rester sur l'hote. La cle de verification doit etre stockee a l'exterieur. Voir l'option Seal= dans journald.conf(5) pour des informations sur FSS et pour un lien vers un article scientifique detaillant la theorie cryptographique sur laquelle il est base. Ajoute dans la version 189. -h, --help Afficher un aide-memoire succinct et quitter. --version Afficher une information de version courte et quitter. CODE DE RETOUR En cas de reussite, 0 est renvoye, un code d'echec different de zero sinon. ENVIRONNEMENT $SYSTEMD_LOG_LEVEL Le niveau maximal de journalisation des messages emis (les messages avec un niveau de journalisation plus eleve, c'est-a-dire les moins importants seront supprimes). Soit un de ces niveaux (par ordre d'importance decroissante) emerg, alert, crit, err, warning, notice, info, debug ou un entier dans l'intervalle 0...7. Consultez syslog(3) pour plus d'informations. $SYSTEMD_LOG_COLOR Un booleen. Si la valeur est vrai, les messages ecrits sur le terminal seront colores selon la priorite. Ce reglage est utile uniquement quand les messages sont ecrits directement dans un terminal ou un fichier parce que journalctl(1) et d'autres outils qui affichent des journaux coloreront par eux-memes les messages selon le niveau de journalisation. $SYSTEMD_LOG_TIME Un booleen. Si la valeur est vrai, les messages du journal de la console seront prefixes d'un horodatage. Ce reglage est utile uniquement quand les messages sont ecrits directement dans un terminal ou un fichier parce que journalctl(1) et d'autres outils qui affichent des journaux attacheront par eux-memes un horodatage selon les metadonnees de l'entree. $SYSTEMD_LOG_LOCATION Un booleen. Si la valeur est vrai, les messages seront prefixes par un nom de fichier et du numero de ligne du code source d'ou vient le message. Notez que l'emplacement du journal est souvent attache comme metadonnee aux entrees du journal de toute facon. L'inclure directement dans le texte du message peut neanmoins etre opportun lors du debogage de programmes. $SYSTEMD_LOG_TID Un booleen. Si la valeur est vrai, les messages seront prefixes par l'identifiant numerique du thread actuel (TID). Notez que cette information est attachee comme metadonnee aux entrees du journal de toute facon. L'inclure directement dans le texte du message peut neanmoins etre opportun lors du debogage de programmes. $SYSTEMD_LOG_TARGET Destination pour journaliser les messages. Une des destinations parmi console (journaliser dans le terminal attache), console-prefixed (journaliser dans le terminal attache, mais avec des prefixes qui codent le niveau et le << service >> de journalisation, consultez syslog(3)), kmsg (journaliser dans le tampon de journalisation circulaire du noyau), journal (journaliser dans le journal), journal-or-kmsg (journaliser dans le journal s'il est disponible et sinon dans kmsg), auto (determiner automatiquement la cible appropriee de journalisation, c'est la destination par defaut), null (desactive la sortie de journalisation). $SYSTEMD_LOG_RATELIMIT_KMSG Limiter le taux de requetes kmsg ou pas. Prend un booleen. Par defaut << vrai >>. Si desactive, systemd ne limitera pas le taux de messages ecrits a kmsg. $SYSTEMD_PAGER Afficheur a utiliser lorsque --no-pager n'est pas precise ; outrepasse $PAGER. Si ni $SYSTEMD_PAGER, ni $PAGER n'ont de valeur, un ensemble d'afficheurs bien connus sont essayes a tour de role, incluant less(1) et more(1), jusqu'a ce qu'il y en ait un qui soit trouve. Si aucun afficheur n'est trouve, aucun afficheur n'est appele. Definir cette variable d'environnement a une chaine vide ou a << cat >> est equivalent a l'utilisation de --no-pager. Remarque : si $SYSTEMD_PAGERSECURE n'est pas defini, $SYSTEMD_PAGER (tout comme $PAGER) sera ignore silencieusement. $SYSTEMD_LESS Outrepasser les options passees a less (par defaut << FRSXMK >>). Les utilisateurs voudront peut-etre changer deux options en particulier : K Cette option ordonne a l'afficheur de quitter immediatement lorsque Ctrl+C est entre. Pour permettre a less de gerer Ctrl+C lui-meme le retour a l'invite de commande de l'afficheur, ne pas fournir cette option. Si la valeur de $SYSTEMD_LESS n'inclut pas << K >> et si l'afficheur appele est less, Ctrl+C sera ignore par l'executable et doit etre gere par l'afficheur. X Cette option ordonne a l'afficheur de ne pas envoyer les chaines d'initialisation et de desinitialisation de termcap au terminal. C'est le choix par defaut afin de permettre aux sorties des commandes de rester visibles dans le terminal meme apres que l'afficheur soit ferme. Toutefois, cela empeche quelques fonctionnalites de l'afficheur de fonctionner, en particulier, il n'est pas possible de faire defiler les sorties affichees avec la souris. Voir less(1) pour plus de details. $SYSTEMD_LESSCHARSET Outrepasser le jeu de caracteres passe a less (par defaut << utf-8 >>, si le terminal invoque est compatible avec l'UTF-8). $SYSTEMD_PAGERSECURE Prend un argument booleen. Quand c'est << vrai >>, le mode << secure >> de l'afficheur est active et quand c'est << faux >>, il est desactive. Si $SYSTEMD_PAGERSECURE n'est pas du tout defini, le mode << secure >> est active si l'UID effectif n'est pas le meme que celle du proprietaire de la session connectee, consulter geteuid(2) et sd_pid_get_owner_uid(3). En mode << secure >>, LESSSECURE=1 sera defini lors de l'invocation de l'afficheur, et l'afficheur desactivera les commandes qui ouvrent ou creent de nouveaux fichiers ou lancent de nouveaux sous-processus. Quand $SYSTEMD_PAGERSECURE n'est pas du tout defini, les afficheurs qui ne sont pas reconnus comme implementant le mode << secure >> ne seront pas utilises. (Actuellement seul less(1) implemente le mode << secure >>.) Note : quand des commandes sont invoquees avec des privileges eleves, par exemple avec sudo(8) ou pkexec(1), des precautions doivent etre prises pour s'assurer que des fonctions interactives indesirables ne sont pas activees. Le mode << Secure >> de l'afficheur interactif peut etre active automatiquement comme decrit plus haut. Definir SYSTEMD_PAGERSECURE=0 ou ne pas le supprimer de l'environnement herite autorise l'utilisateur a invoquer des commandes arbitraires. Notez que si les variables $SYSTEMD_PAGER ou $PAGER doivent etre respectees, $SYSTEMD_PAGERSECURE doit aussi etre defini. Il pourrait etre raisonnable de desactiver completement l'afficheur interactif en utilisant plutot --no-pager. $SYSTEMD_COLORS Prend un argument booleen. Quand c'est << vrai >>, systemd et les utilitaires lies utiliseront la couleur pour leurs sorties, autrement, la sortie sera monochrome. En plus, la variable peut prendre une des valeurs speciales suivantes : 16 ou 256 pour limiter l'usage des couleurs aux couleurs ANSI base 16 ou base 256 respectivement. Cela peut etre precise pour outrepasser la decision automatique prise sur $TERM et quel que soit ce a quoi la console est connectee. $SYSTEMD_URLIFY La valeur doit etre un booleen. Controle si les liens cliquables doivent etre generes dans la sortie pour des emulateurs de terminaux le prenant en charge. Cela peut etre indique pour passer outre la decision faite par systemd basee sur $TERM et d'autres conditions. EXEMPLES Sans arguments, tous les journaux collectes sont montres sans filtre : journalctl Avec une correspondance indiquee, tous les enregistrements avec un champ correspondant a l'expression sont affiches : journalctl _SYSTEMD_UNIT=avahi-daemon.service journalctl _SYSTEMD_CGROUP=/user.slice/user-42.slice/session-c1.scope Si deux champs differents correspondent, seulement les enregistrements correspondant aux deux expressions au meme moment sont affiches : journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097 Si deux correspondances se rapportent au meme champ, tous les enregistrements correspondant a l'une ou l'autre expression sont affiches : journalctl _SYSTEMD_UNIT=avahi-daemon.service _SYSTEMD_UNIT=dbus.service Si le separateur << + >> est utilise, deux expressions peuvent etre combinees dans un OU logique. La sequence suivante affichera tous les messages du processus du service Avahi ayant le PID 28097 plus tous les messages du service D-Bus (de tous ses processus) : journalctl _SYSTEMD_UNIT=avahi-daemon.service _PID=28097 + _SYSTEMD_UNIT=dbus.service L'option -u/--unit= doit etre utilisee pour afficher tous les champs emis par une unite et a propos d'une unite. journalctl -u nom se transforme en un filtre complexe similaire a _SYSTEMD_UNIT=nom.service + UNIT=nom.service _PID=1 + OBJECT_SYSTEMD_UNIT=nom.service _UID=0 + COREDUMP_UNIT=nom.service _UID=0 MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1 (voir systemd.journal-fields(7) pour une explication sur ces motifs. Afficher tous les journaux generes par l'executable de D-Bus : journalctl /usr/bin/dbus-daemon Afficher tous les journaux du noyau depuis le demarrage precedent : journalctl -k -b -1 Montrer un affichage en direct de journaux du service de systeme apache.service : journalctl -f -u apache VOIR AUSSI systemd(1), systemd-cat(1), systemd-journald.service(8), systemctl(1), coredumpctl(1), systemd.journal-fields(7), journald.conf(5), systemd.time(7), systemd-journal-remote.service(8), systemd-journal-upload.service(8) NOTES 1. Specification des partitions detectables https://uapi-group.org/specifications/specs/discoverable_partitions_specification 2. RFC 3339 https://tools.ietf.org/html/rfc3339 3. Format d'export de journal https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-export-format 4. Format JSON du journal https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-json-format 5. Server-Sent Events https://developer.mozilla.org/en-US/docs/Server-sent_events/Using_server-sent_events 6. JavaScript Object Notation (JSON) Text Sequences https://tools.ietf.org/html/rfc7464 7. Documentation du developpeur du Catalogue de messages https://www.freedesktop.org/wiki/Software/systemd/catalog TRADUCTION La traduction francaise de cette page de manuel a ete creee par French translation of man-pages, Copyright (C) 2023. et bubu Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . systemd 255 JOURNALCTL(1)