Manuels pour la ligne de commande

Man » Manuel de multitail en ligne - documentation en ligne détaillée pour la page de manuel de multitail

🌍
MultiTail - permet de parcourir plusieurs fichiers à la fois

SYNTAXE

multitail [options]

options: [-cs|-Cs|-c-] [-s] [-i] fichier_entrée [-i autre_fichier_entrée] [...]

DESCRIPTION

Le programme MultiTail vous permet de visualiser un ou plusieurs fichiers comme le programme tail d'origine. La différence est qu'il crée plusieurs fenêtres sur votre console (avec ncurses). Il peut également surveiller des caractères génériques : si un autre fichier correspondant au caractère générique a une date de modification plus récente, il basculera automatiquement vers ce fichier. De cette manière, vous pouvez, par exemple, surveiller un répertoire complet de fichiers. La fusion de 2 voire plus de fichiers journaux est possible. Il peut également utiliser des couleurs lors de l'affichage des fichiers journaux (via des expressions régulières), pour identifier plus rapidement ce qui est important et ce qui ne l'est pas. Il peut également filtrer les lignes (à nouveau avec des expressions régulières). Il dispose de menus interactifs pour modifier les expressions régulières et supprimer et ajouter des fenêtres. On peut également avoir des fenêtres avec la sortie de scripts shell et d'autres logiciels. Lors de la visualisation de la sortie de logiciels externes, MultiTail peut imiter la fonctionnalité d'outils tels que « watch » et autres. Lorsqu'un nouveau courrier arrive pour l'utilisateur actuel, les lignes d'état deviennent vertes. Pour réinitialiser cet état « courrier arrivé », appuyez sur «  » (une espace). Pour obtenir de l'aide à tout moment, appuyez sur F1.

OPTIONS

-i fichier

Sélectionnez un fichier à surveiller. Vous pouvez avoir plusieurs paramètres -i fichier. Vous n'avez besoin d'ajouter -i fichier devant un nom de fichier que si le nom de fichier commence par un tiret (« - »).

-I fichier

Identique à -i fichier, mais ajoute la sortie à la fenêtre précédente (de sorte que la sortie soit fusionnée).

-iw fichier intervalle
-Iw fichier intervalle Similaire à « -i » / « -I » mais attend que le paramètre soit un caractère générique et le deuxième ! un intervalle. Initialement, MultiTail commencera à surveiller le premier fichier avec le
temps de modification le plus récent. À chaque intervalle, il vérifiera si de nouveaux fichiers ont été créés
(ou modifiés) et commencera à surveiller celui-ci. *N'oubliez pas* de mettre des guillemets autour du
nom de fichier, sinon le shell tentera de le remplacer !

-l commande

Commande à exécuter dans une fenêtre. Le paramètre est la commande. N'oubliez pas d'utiliser des apostrophes si la commande externe a besoin de paramètres (par exemple, -l « ping host »).

-L commande

Identique à -l, mais ajoute la sortie à la fenêtre précédente (de sorte que la sortie soit fusionnée).

-j Lit à partir de l'entrée standard (ne peut être utilisé qu'une seule fois car il n'y a qu'une seule entrée standard).

-J Identique à -j, mais ajoute la sortie à la fenêtre précédente (de sorte que la sortie soit fusionnée).

--mergeall

Fusionne tous les fichiers suivants dans la même fenêtre (voir « --no-mergeall »).


--no-mergeall
Empêche la fusion de tous les fichiers dans une seule fenêtre (voir « --mergeall »).

--no-repeat
Lorsqu’une même ligne est répétée, elle est supprimée lors de l’impression, et un message « Dernier message répété x fois » est affiché.

--mark-interval x
Affiche une ligne de marque tous les « x » secondes lorsqu’aucune autre donnée n’a été traitée.

-q i path
Vérifie si de nouveaux fichiers sont présents dans « path » avec un intervalle de « i », et les affiche dans de nouvelles fenêtres. Vous pouvez indiquer ici des chemins compris par le shell. Par exemple, « /tmp/* ». Remarque : n’oubliez pas d’ajouter des guillemets autour du nom de fichier pour éviter que le shell ne l’analyse !

-Q i path
Similaire à « -q » : mais fusionne tous les fichiers dans une seule fenêtre.

--new-only
Pour « -q »/« -Q » : crée uniquement des fenêtres pour les fichiers créés après le démarrage de MultiTail.

--closeidle x
Ferme les fenêtres lorsque plus de « x » secondes se sont écoulées sans que de nouvelles données soient traitées.

-a x Écrit également la sortie dans le fichier « x » (comme « tee ») APRÈS qu’elle ait été filtrée par MultiTail. Remarque : vous devez placer « -a file » AVANT le fichier que vous surveillez !

-A x Écrit également la sortie dans le fichier « x » (comme « tee ») AVANT qu’elle ne soit filtrée par MultiTail. Voir également la note pour « -a ».

-g x Envoie également la sortie à la commande « x » APRÈS qu’elle ait été filtrée par MultiTail.

-G x Envoie également la sortie à la commande « x » AVANT qu’elle ne soit filtrée par MultiTail.

-S Ajoute le numéro de sous-fenêtre au début de la sortie fusionnée.

-t title
Avec cet interrupteur, « title » est affiché dans la ligne d’état au lieu du nom de fichier ou de la ligne de commande.

-n number_of_lines
Nombre de lignes à afficher initialement. La valeur par défaut dépend de la taille de la fenêtre du terminal.

-N number_of_lines
Similaire à « -n », mais ce paramètre sera utilisé pour tous les fichiers/commandes que vous suivrez après ce paramètre.

-r interval
Redémarre la commande (démarée avec « -l »/« -L ») après qu’elle s’est arrêtée. Vous pouvez définir l’intervalle de temps pendant lequel MultiTail attendra avant de redémarrer la commande.

-R interval
Redémarre une commande comme « -r », mais affiche également la différence de sortie par rapport à l’exécution précédente.

-rc / -Rc interval
Similaire à « -r »/« -R », mais efface la fenêtre avant chaque itération.

-h Affiche l’aide.

-f Suit le nom de fichier suivant, et non le descripteur.

--follow-all
Pour tous les fichiers après cet interrupteur : suit le nom de fichier suivant, et non le descripteur.

-fr filter
Utilise le ou les filtres prédéfinis du fichier de configuration.

-e Utilise la prochaine expression régulière sur le fichier suivant.

-ex Utilise une expression régulière sur le fichier suivant et exécute la commande lorsque l’expression correspond. La commande reçoit en paramètre la ligne correspondante complète.

-eX Similaire à « -ex », mais ne fournit qu’une sous-chaîne correspondante en paramètre. Cela nécessite une expression régulière avec « ( » et « ) ».

-ec Utilise une expression régulière sur le fichier suivant et affiche les correspondances.

-eC Utilise une expression régulière sur le fichier suivant, mais affiche tout en affichant les correspondances en inversé.

-E Utilise la prochaine expression régulière sur les fichiers suivants.

-v Inverse la prochaine expression régulière.

-s x Divise l’écran verticalement en « x » colonnes.

-sw x Indique la position à laquelle diviser l’écran. Par exemple, « -sw 20,40,,10 » ( = 4 colonnes).

-sn x  Nombre de fenêtres par colonne pour une division verticale (à utiliser avec -s ou -sw). par exemple, « -sn 3,,2 ».

-wh x  Définit la hauteur d’une fenêtre (conseil : si cela ne rentre pas, la hauteur est ajustée).

-cS schéma
Affiche le fichier suivant en utilisant le thème de couleurs sélectionné avec « schéma » (tel que défini dans multitail.conf).

-CS schéma
Affiche tous les fichiers suivants en utilisant le thème de couleurs sélectionné avec « schéma » (tel que défini dans multitail.conf).

-csn  Option supplémentaire pour les options suivantes ; ne pas utiliser les couleurs inversées.

-cs  Affiche le fichier suivant en couleurs (syslog).

-c  Affiche le fichier suivant en couleurs.

-Cs  Affiche tous les fichiers suivants en couleur (via syslog-scheme).

-C  Affiche tous les fichiers suivants en couleur.

-Cf index_champ délimiteur
Affiche tous les fichiers suivants en couleur en fonction du champ sélectionné avec index_champ. Les champs sont délimités par le délimiteur défini.

-cf index_champ délimiteur
Affiche le fichier suivant en couleur en fonction du champ sélectionné avec index_champ. Les champs sont délimités par le délimiteur défini.

-ci couleur
Utilise une couleur spécifique. Utile lors de la fusion de plusieurs sorties.

-cT mode_terminal
Interprète les codes de terminal. Seul ANSI est pris en charge pour le moment.

-c-  Ne pas coloriser le fichier suivant.

-C-  Ne pas coloriser les fichiers suivants.

-ts  Ajoute un horodatage à chaque ligne (le format est configurable dans multitail.conf).

-Z couleur
Spécifie les attributs de couleur pour la ligne de marqueur.

-T  Un horodatage sera placé dans la ligne de marqueur.

-d  Ne pas mettre à jour la ligne d’état.

-D  Ne pas afficher du tout la ligne d’état.

-du  Place la ligne d’état au-dessus de la fenêtre de données.

-z  Ne pas afficher les fenêtres « fermées ».

-u  Définit l’intervalle de mise à jour de l’écran (pour les connexions lentes).

-m n_lignes
Définit la taille du tampon : définissez n_lignes sur 0 si vous ne souhaitez pas de limites sur la mise en mémoire tampon.

-mb x  Définit la taille du tampon de défilement (en octets, utilisez xKB/MB/GB).

-M n_lignes
Définit la taille du tampon pour tous les fichiers suivants.

-p x [y]
Définit l’alignement des lignes : a = affiche tout, y compris l’alignement des lignes. l = affiche simplement tout à partir du côté gauche jusqu’à ce que le côté droit de la fenêtre soit atteint. r = affiche tout à partir du côté droit de la ligne. s = affiche tout en commençant par le nom du processus. S = affiche tout après le nom du processus. o = affiche tout en commençant par le décalage « y ».

-P x [y]
Comme -p, mais pour toutes les fenêtres suivantes.

-ke x  Supprime des parties de l’entrée en utilisant l’expression régulière « x ».

-kr x y
Supprime des parties de l’entrée en commençant au décalage x et en se terminant (sans l’inclure !) au décalage y.

-kc x y
Supprime des parties de l’entrée : supprime la colonne « y » avec le délimiteur « x ».

-ks x  Utilise le schéma d’édition « x » à partir du fichier de configuration.

-w  Ne pas utiliser les couleurs.

-b n  Définit la largeur du caractère de tabulation.

--config nom_fichier
Charge la configuration à partir du fichier spécifié.

-x  Définit le titre du terminal : %f sera remplacé par le dernier fichier modifié, %h par le nom d’hôte, %l par la charge du système, %m par « Nouveau courrier ! » lorsque l’utilisateur actuel a un nouveau courrier, %u par l’utilisateur effectif actuel, %t par l’horodatage du dernier fichier modifié, %% par un %.

-o configfile-item

Traite un élément de fichier de configuration via la ligne de commande dans le cas où vous ne pouvez pas modifier le fichier de configuration par défaut.

--cont Reconnecte les lignes qui se terminent par un caractère « ´ ».

--mark-interval interval

Lorsque rien ne se passe, affiche une ligne « ---mark--- » tous les « interval » secondes.

--mark-change

Lorsque plusieurs fichiers sont fusionnés et que multitail bascule entre deux fenêtres, affiche une ligne de marqueur avec le nom du fichier.

--no-mark-change

N'affiche PAS la ligne de marqueur lorsque le fichier change (remplace le fichier de configuration).

--label text

Ajoute « text » au début de chaque ligne. Utile lors de la fusion de plusieurs fichiers et/ou commandes.

--retry

Continue d'essayer d'ouvrir le fichier suivant s'il est inaccessible.

--retry-all

Comme « --retry », mais pour tous les fichiers suivants.

-cv x Utilise le schéma de conversion « x » (voir multitail.conf).

--basename

N'affiche que le nom du fichier (et non le chemin) dans la barre d'état.

-F file

Utilise « file » comme fichier de configuration (au lieu du fichier de configuration par défaut).

--no-load-global-config

Ne charge PAS le fichier de configuration global.

--beep-interval x

Fait émettre un bip par le terminal pour chaque x-ième ligne traitée. Appuyez sur « i » dans le menu principal pour voir combien de fois il a émis un bip.

--bi x Comme « --beep-interval », mais uniquement pour la fenêtre (sous-)actuelle. Les statistiques sur le nombre de bips se trouvent dans les statistiques de cette fenêtre (sous-). Appuyez sur « t » dans le menu principal.

-H Affiche une pulsation (pour maintenir vos sessions actives).

-V Affiche la version et quitte.

TOUCHES

Vous pouvez appuyer sur plusieurs touches pendant l'exécution du programme. Pour voir une liste de ces touches, appuyez sur F1 (ou ^h). Vous pouvez appuyer sur F1 (ou ^h) à tout moment : cela fournit des informations contextuelles. Appuyez sur « q » pour quitter le programme.

EXEMPLES

Voir http://www.vanheusden.com/multitail/examples.html pour plus d'exemples.

multitail /var/log/apache/access_log logfile -i -filestartingwithdatsh

Cela crée trois fenêtres. Une avec le contenu de /var/log/apache/access_log, une avec le contenu de logfile, etc.

multitail -R 2 -l "netstat -t"

Cela exécute netstat toutes les 2 secondes, puis affiche ce qui a changé par rapport à l'exécution précédente. De cette manière, vous pouvez voir les nouvelles connexions établies et les connexions fermées disparaître.

multitail logfile -l "ping 192.168.1.3"

Cela crée deux fenêtres. Une avec le contenu de logfile, et une autre avec la sortie de « ping 192.168.1.3 ».

multitail /var/log/apache/access_log -I /var/log/apache/error_log

Cela crée une fenêtre avec le contenu de /var/log/apache/access_log fusionné avec le contenu de /var/log/apache/error_log.

multitail -M 0 /var/log/apache/access_log -I /var/log/apache/error_log

Comme l'exemple précédent. Cet exemple stockera toutes les entrées enregistrées dans un tampon afin que vous puissiez plus tard les parcourir (en appuyant sur « b »).

FICHIERS

${XDG_CONFIG_HOME}/multitail/config

Si ${XDG_CONFIG_HOME} est défini.

${HOME}/.multitailrc

Si ${HOME} est défini.

~/.multitailrc
Lorsque ni ${XDG_CONFIG_HOME} ni ${HOME} ne sont définis, ce qui utilisera (struct passwd*)pp->pw_dir du fichier d'en-tête standard pwd.h.

BUGS

Au fur et à mesure que ce programme est devenu de plus en plus volumineux avec de nouvelles fonctionnalités ajoutées de manière ad hoc, certains bogues ont pu être introduits. Veuillez en informer _ si vous en trouvez.

Cependant, la redimensionnement de votre fenêtre de terminal est une exception. Le programme peut se bloquer lors de telles opérations. La mise à niveau de la bibliothèque ncurses vers la version 5.3 ou supérieure peut aider dans ce cas.

VOIR AUSSI

http://www.vanheusden.com/multitail/

NOTES

Cette page décrit MultiTail tel qu’il est présent dans le paquet multitail installé ; d’autres versions peuvent différer légèrement. Envoyez les corrections et ajouts à _. Signalez les bogues du programme à _.