Observer les codes de retour

Objectifs

À la fin de cette leçon, vous saurez :

• comprendre que chaque commande se termine par un code de retour ;
• lire ce code avec echo $? ;
• distinguer succès (0) et échec (autre valeur) ;
• utiliser &&, || et ; en conséquence.

🔗 Pour vous rafraîchir la mémoire : manipulation de fichiers (cp, mv, rm) · lecture de fichiers et aide (cat, grep, man) · redirections et pipes

Chaque commande se termine par un code

Quand une commande se termine, elle laisse derrière elle un code de retour : une valeur entière, disponible dans la variable spéciale $? du shell.

ls /home
echo $?

Le résultat est :

0

La règle de base

0 = succès
toute autre valeur = erreur

Observez :

ls /home
echo $?      # 0

ls /dossier-inexistant
echo $?      # 2 (par exemple)

La commande qui échoue affiche souvent un message d'erreur en plus. Le message informe l'utilisateur ; le code informe le programme. Les deux sont complémentaires.

Où vivent ces codes ?

Un processus se termine avec un entier :

• 0 : tout s'est bien passé ;
• 1 : erreur générique ;
• 2 : mauvaise utilisation (le plus souvent, un mauvais argument) ;
• 127 : commande introuvable ;
• 130 : interrompu par l'utilisateur (Ctrl+C).

Le code est rempli par la commande elle-même. Un script ou un programme peut décider d'adopter les mêmes conventions :

if (echoué) {
  process.exit(1);
}

Utiliser les codes dans une ligne

Une intention formulée en français — « prépare un dossier de test, liste son contenu, puis nettoie ; adapte la suite selon le résultat » — se traduit avec trois opérateurs différents :

mkdir /tmp/test-cours && ls /tmp/test-cours     # la 2e ne tourne que si la 1re réussit
rm /tmp/test-cours || echo "échec du nettoyage"  # l'écho ne tourne que si la 1re échoue
date ; grep dos /etc/hosts                        # les deux tournent, sans condition

• && vérifie le code de retour de la première.
• || exécute seulement en cas de code non nul.
• ; enchaîne sans vérifier.

Test pratique

which node
which programme-inconnu
echo $?

which programme-inconnu n'affiche rien (ou une erreur), et $? renvoie 1 : le programme n'existe pas dans le chemin de recherche. C'est un test fiable en une ligne :

which node && echo "node est prêt"

Exercice

1. Exécutez ls /etc puis echo $? : notez la valeur.
2. Exécutez ls /etc/zazoux puis echo $? : notez la valeur et comparez.
3. Testez cd / && echo $? puis cd /impossible et relisez $?.
4. Écrivez une ligne qui affiche « réseau ok » si which curl réussit, « curl manquant » sinon.
5. Expliquez pourquoi une commande qui n'a rien affiché peut avoir un code de retour 0.

Résumé

• Chaque processus rend un code : 0 = succès, ≠ 0 = échec.
• echo $? relit le code de retour de la dernière commande.
• && n'enchaîne que sur la réussite (code 0), || seulement sur l'échec (code ≠ 0), ; sans condition.
• Les codes permettent au shell d'automatiser des vérifications.

which curl && echo "réseau ok" || echo "curl manquant"

if which curl; then echo "réseau ok"; else echo "curl manquant"; fi