Capturer et afficher simultanément une sortie avec la commande tee sous Linux¶

Contexte¶

Sous Linux, l'opérateur de redirection > (vu dans le tutoriel sur les redirections des sorties standard et d'erreur) permet d'envoyer la sortie d'une commande dans un fichier. Le problème : le résultat n'apparaît plus à l'écran. Impossible donc de suivre en direct une commande longue comme une compilation, une mise à jour système ou un script de sauvegarde, tout en gardant une trace exacte de ce qui s'est affiché.

La commande tee résout ce problème en agissant comme un té (la lettre T) : le flux d'entrée arrive par le bas, puis se divise en deux sorties distinctes — l'écran d'un côté, un fichier de l'autre.

            ┌──► stdout (écran)
stdin ──► tee ┤
            └──► fichier(s)

Prérequis¶

• Une machine Linux (VM, WSL, distribution de test) avec un shell Bash.
• Avoir exécuté au moins une fois des redirections simples (>, 2>) — voir la section « Contexte ».
• Des droits suffisants pour écrire dans le répertoire de travail (utilisateur courant, pas besoin de root sauf pour l'usage avancé avec sudo).

Procédure¶

Étape 1 : Comportement de base — afficher ET sauvegarder¶

La syntaxe minimale est la suivante :

commande | tee fichier.log

tee intercale dans le tuyau (pipe). Il récupère la sortie de commande, l'affiche dans le terminal et l'écrit dans fichier.log. Si le fichier n'existe pas, il est créé ; s'il existe, il est écrasé.

# Lister le contenu du répertoire à l'écran et dans une trace
ls -la /etc | tee /tmp/ls-etc.log

Vérifiez le contenu du fichier créé :

cat /tmp/ls-etc.log

Étape 2 : Ajouter à la fin d'un fichier (mode append)¶

Comme pour la redirection >>, l'option -a (append) ajoute les données à la fin du fichier sans l'écraser. C'est indispensable pour tenir un journal cumulatif :

# Ajoute la date et l'heure de chaque exécution à un journal
date "+%F %T — exécution du script de sauvegarde" | tee -a /tmp/sauvegarde.log

# On relance plus tard : la ligne précédente est conservée
date "+%F %T — seconde exécution" | tee -a /tmp/sauvegarde.log

Étape 3 : Capturer stderr en plus de stdout¶

Par défaut, tee ne traite que la sortie standard (stdout). Les messages d'erreur (stderr) passent au travers sans être enregistrés. Pour tout capturer, redirigez d'abord stderr vers stdout avec 2>&1 :

# find génère souvent des "Permission denied" sur stderr
# Cette commande affiche ET enregistre succès ET erreurs
find /var/log -name "*.log" 2>&1 | tee /tmp/find-log-all.txt

find /var/log -name "*.log" |& tee /tmp/find-log-all.txt

Étape 4 : Écrire dans plusieurs fichiers en une seule commande¶

tee accepte plusieurs noms de fichiers en arguments et écrit dans tous simultanément :

# Tracer une commande d'installation dans deux journaux distincts
echo "Début de l'installation" | tee install.log journal.log

Utile pour garder une copie locale d'un log tout en alimentant un emplacement réseau (point de montage secondaire, NAS, etc.).

Étape 5 : Écrire dans un fichier root avec sudo¶

Un cas très fréquent en administration système : on veut écrire depuis son utilisateur courant dans un fichier que seul root peut modifier (par exemple /etc/hosts ou un fichier de log système). La redirection > classique ne fonctionne pas car la redirection est exécutée par le shell de l'utilisateur, pas par sudo :

# ❌ NE FONCTIONNE PAS : le shell ouvre le fichier AVANT le sudo
echo "127.0.0.1 monsite.local" | sudo > /etc/hosts

Avec tee, le programme sudo s'exécute en premier, et c'est tee (devenu root) qui ouvre et écrit le fichier :

# ✅ Correct : tee écrit avec les droits root
echo "127.0.0.1 monsite.local" | sudo tee -a /etc/hosts

Étape 6 : Ne rien afficher à l'écran (mode silencieux pour les scripts)¶

Parfois, on veut simplement écrire dans un fichier comme le ferait >, mais en profitant du contournement de droits offert par tee. On redirige alors la sortie de tee vers /dev/null pour la faire disparaître de l'écran :

# Écrit dans le log système root sans rien afficher
echo "Ligne de maintenance" | sudo tee /var/log/maintenance.log > /dev/null

Étape 7 : Combiner tee avec un pipeline long¶

tee s'intercale dans n'importe quel pipeline. On peut ainsi tracer une étape intermédiaire tout en continuant à traiter les données :

# 1. Lister les fichiers .conf → 2. (tee) garder une copie → 3. Filtrer avec grep
ls /etc/*.conf 2>/dev/null | tee /tmp/conf-brut.txt | grep "^/etc/net"

Le fichier /tmp/conf-brut.txt contient la liste complète avant filtrage, tandis que l'écran n'affiche que le résultat filtré. Très pratique pour déboguer un pipeline qui ne produit pas le résultat attendu.

Vérification¶

Tapez successivement les commandes ci-dessous dans votre terminal de test :

# 1. Création et écriture
echo "première ligne" | tee /tmp/test-tee.log
cat /tmp/test-tee.log

# 2. Ajout
echo "deuxième ligne" | tee -a /tmp/test-tee.log
cat /tmp/test-tee.log

# 3. Capture de stderr
ls /repertoire_inexistant 2>&1 | tee /tmp/test-erreurs.log
cat /tmp/test-erreurs.log

Aide-mémoire¶

Ce qu'il faut retenir¶

• tee = afficher ET sauvegarder simultanément, là où > ne fait que sauvegarder.
• L'option -a évite l'écrasement accidentel d'un journal existant.
• 2>&1 (ou |&) est nécessaire pour capturer aussi les messages d'erreur.
• sudo tee est la méthode propre pour écrire dans un fichier root depuis un utilisateur non privilégié.
• tee s'intercale dans n'importe quel pipeline : parfait pour tracer une étape intermédiaire pendant le debug.

Ressources¶

• Man page tee(1) — Linux man-pages — Page de manuel officielle et complète.
• Documentation GNU Coreutils — tee invocation — Référence de la version GNU de tee (implémentation par défaut sur la plupart des Linux).
• POSIX.1-2017 — tee utility — Spécification POSIX minimale respectée par tous les Unix.
• Man page tee(1) — die.net — Miroir de la page de manuel en ligne.