Vous ne retiendrez jamais toutes les options de toutes les commandes Linux — et c’est normal. La vraie compétence d’un administrateur système n’est pas de tout connaître par cœur, mais de savoir trouver l’information en quelques secondes sans quitter le terminal. Ce guide vous montre les outils intégrés à tout système Linux pour y parvenir.
Ce que vous allez apprendre
Section intitulée « Ce que vous allez apprendre »- Afficher l’aide rapide d’une commande avec
--help - Consulter la documentation complète avec
man - Naviguer dans une page man (chercher, avancer, quitter)
- Trouver une commande par mot-clé avec
aproposetwhatis - Choisir le bon outil d’aide selon la situation
Installer les outils d’aide
Section intitulée « Installer les outils d’aide »Sur une installation minimale (Debian netinst, Rocky Minimal), seul --help fonctionne d’office. Les autres outils présentés dans ce guide nécessitent l’installation de paquets supplémentaires.
sudo apt install man-db manpages manpages-dev info pipxpipx install tldrsudo mandbtldr --updatesudo dnf install man-db man-pages info pipxpipx install tldrsudo mandbtldr --updateDétail des paquets :
| Paquet | Fournit | Pourquoi c’est nécessaire |
|---|---|---|
man-db | man, apropos, whatis | Le moteur de documentation — sans lui, aucune page man n’est consultable |
manpages / man-pages | Les pages man elles-mêmes | Sans ce paquet, man et apropos ne trouvent rien |
info | info | Documentation étendue GNU (optionnel) |
pipx | pipx | Installer des outils Python en isolation |
tldr (via pipx) | tldr | Fiches d’exemples pratiques communautaires (optionnel) |
La commande sudo mandb construit l’index utilisé par apropos et whatis. Sans cette étape, ces commandes retournent toujours nothing appropriate.
Aide rapide : --help
Section intitulée « Aide rapide : --help »C’est le réflexe le plus simple. La quasi-totalité des commandes Linux acceptent l’option --help :
ls --helpVous obtenez un résumé de la syntaxe, des options principales et parfois des exemples. La sortie tient généralement sur un écran.
cp --helpmkdir --helpCertaines commandes utilisent -h au lieu de --help (ou en plus). Si --help ne fonctionne pas, essayez -h.
Documentation complète : man
Section intitulée « Documentation complète : man »man (manual) est le système de documentation intégré à Linux. Chaque commande, fichier de configuration et fonction système possède une page man.
man lsVous entrez dans un afficheur interactif (le pager less). Voici les contrôles essentiels :
| Touche | Action |
|---|---|
| Espace | Avancer d’une page |
| b | Reculer d’une page |
| / puis un mot | Chercher dans la page |
| n | Résultat suivant de la recherche |
| N | Résultat précédent |
| q | Quitter |
Structure d’une page man
Section intitulée « Structure d’une page man »Les pages man suivent un plan standard. Connaître ces sections vous permet de trouver l’information sans tout lire :
| Section | Contenu | Ce que vous y cherchez |
|---|---|---|
| NAME | Nom et description courte | Vérifier que c’est la bonne commande |
| SYNOPSIS | Syntaxe d’utilisation | Voir les options et arguments attendus |
| DESCRIPTION | Explication détaillée | Comprendre ce que fait la commande |
| OPTIONS | Liste complète des options | Trouver l’option dont vous avez besoin |
| EXAMPLES | Exemples d’utilisation | Copier un exemple et l’adapter |
| FILES | Fichiers de configuration liés | Trouver où modifier le comportement |
| SEE ALSO | Commandes et pages liées | Découvrir des commandes complémentaires |
| EXIT STATUS | Codes de retour | Comprendre les erreurs dans un script |
Les sections du manuel
Section intitulée « Les sections du manuel »Le manuel est organisé en sections numérotées. Certaines commandes existent dans plusieurs sections :
| Section | Contenu |
|---|---|
| 1 | Commandes utilisateur |
| 5 | Formats de fichiers et conventions |
| 8 | Commandes d’administration système |
Pour consulter une section précise :
man 5 passwd # le format du fichier /etc/passwdman 1 passwd # la commande passwdSans numéro, man affiche la première section trouvée.
Chercher une commande : apropos et whatis
Section intitulée « Chercher une commande : apropos et whatis »apropos : « je ne connais pas la commande »
Section intitulée « apropos : « je ne connais pas la commande » »Vous savez ce que vous voulez faire, mais pas quelle commande utiliser. apropos cherche dans les descriptions de toutes les pages man :
apropos "copy files"apropos partitionapropos "network interface"cp (1) - copy files and directoriesscp (1) - OpenSSH secure file copyrsync (1) - a fast, versatile, remote (and local) file-copying toolwhatis : « je connais la commande, c’est quoi en un mot ? »
Section intitulée « whatis : « je connais la commande, c’est quoi en un mot ? » »whatis affiche la description courte (section NAME) d’une commande :
whatis ls cp mkdir rmls (1) - list directory contentscp (1) - copy files and directoriesmkdir (1) - make directoriesrm (1) - remove files or directoriesinfo : documentation étendue (GNU)
Section intitulée « info : documentation étendue (GNU) »Certains outils GNU (coreutils, grep, sed, awk) proposent des pages info plus détaillées que les pages man, avec des exemples supplémentaires :
info coreutilsinfo grepLa navigation est différente : Entrée suit un lien, u remonte, q quitte. En pratique, les pages man suffisent dans 95 % des cas.
tldr : des exemples concrets, tout de suite
Section intitulée « tldr : des exemples concrets, tout de suite »Les pages man sont complètes mais parfois intimidantes pour un débutant. tldr (Too Long; Didn’t Read) propose des fiches d’exemples pratiques communautaires, directement dans le terminal :
tldr tar tar
Archiving utility. Often combined with a compression method, such as gzip or bzip2.
- Create an archive from files: tar cf target.tar file1 file2 file3
- Extract an archive in the current directory: tar xf source.tar
- Create a gzipped archive: tar czf target.tar.gz file1 file2 file3
- Extract a gzipped archive in the current directory: tar xzf source.tar.gzChaque fiche montre les 5 à 8 cas d’usage les plus fréquents avec les commandes prêtes à copier.
Documentation hors-ligne : /usr/share/doc
Section intitulée « Documentation hors-ligne : /usr/share/doc »Les paquets installés déposent parfois de la documentation dans /usr/share/doc/ :
ls /usr/share/doc/openssh-server/Vous y trouverez des fichiers README, CHANGELOG, des exemples de configuration. C’est utile quand la page man ne couvre pas un cas précis.
Quel outil utiliser ?
Section intitulée « Quel outil utiliser ? »| Situation | Outil | Exemple |
|---|---|---|
| Je connais la commande, je cherche une option | --help | tar --help |
| Je veux des exemples concrets rapidement | tldr | tldr tar |
| Je cherche des exemples détaillés (GNU) | info | info tar |
| Je cherche un fichier de config | man 5 | man 5 fstab |
Exercice pratique
Section intitulée « Exercice pratique »-
Affichez l’aide rapide de
ls:Fenêtre de terminal ls --helpRepérez l’option qui affiche les tailles en format lisible (Ko, Mo).
-
Ouvrez la page man de
cp:Fenêtre de terminal man cpCherchez
/recursivepour trouver l’option de copie de répertoires. Quittez avec q. -
Cherchez une commande pour afficher l’espace disque :
Fenêtre de terminal apropos "disk usage"Vous devriez trouver
dfetdu. -
Vérifiez avec
whatis:Fenêtre de terminal whatis df du
Dépannage
Section intitulée « Dépannage »| Symptôme | Cause | Solution |
|---|---|---|
No manual entry for xxx | Page man non installée | Installer le paquet man-db et le paquet de la commande |
whatis: command not found ou apropos: command not found | man-db non installé | sudo apt install man-db manpages (Debian) ou sudo dnf install man-db man-pages (RHEL) |
apropos retourne nothing appropriate | Pages man absentes ou index non construit | Installer manpages (Debian) / man-pages (RHEL), puis sudo mandb |
tldr ne retourne rien | Base locale absente | Exécuter tldr --update pour télécharger les fiches |
tldr --update échoue avec Did not find end of central directory signature | Client Haskell buggé (paquet tldr des dépôts Debian/RHEL) | Désinstaller le paquet système (sudo apt remove tldr), puis installer le client Python : pipx install tldr |
--help affiche trop de texte | Sortie longue | Utiliser `ls —help |
À retenir
Section intitulée « À retenir »--helpdonne un rappel rapide des options d’une commande.tldraffiche des exemples pratiques prêts à copier — idéal pour les commandes qu’on utilise rarement.manest la documentation de référence. Tapez/pour chercher, q pour quitter.aproposcherche une commande par mot-clé quand vous ne connaissez pas son nom.whatisdonne la description en une ligne d’une commande connue.man,apropos,whatis,infoettldrne sont pas installés par défaut sur une installation minimale — installez-les avec la commande en début de guide.- La vraie compétence n’est pas de tout retenir, c’est de savoir chercher vite.