Man
| Fiche express | |
|---|---|
| Domaine | Documentation des commandes (pages de manuel Unix) |
| Commande | man
|
| Contexte | Universel — toutes distributions Unix/Linux |
| Voir aussi | apropos, whatis, whereis
|
man affiche les pages de manuel installées sur le système : documentation des commandes, des appels système, des fichiers de configuration, etc. Les pages sont organisées en sections numérotées, et plusieurs commandes annexes (apropos, whatis, man -k) permettent de chercher parmi elles sans connaître le nom exact de la page.
Commandes de base
man man # le manuel de man lui-même
man man-pages # conventions générales des pages de manuel
man ls # manuel d'une commande
Sections du manuel
Une même entrée (par exemple glob) peut exister dans plusieurs sections ; man affiche par défaut la première trouvée, sauf si la section est précisée explicitement.
| Section | Contenu |
|---|---|
| 1 | Commandes utilisateur (invoquées depuis un interpréteur de commandes) |
| 2 | Appels système (fonctions fournies par le noyau) |
| 3 | Fonctions de bibliothèques (la plupart des fonctions de la libc) |
| 4 | Fichiers spéciaux (périphériques, généralement sous /dev)
|
| 5 | Formats de fichiers et conventions (par exemple /etc/passwd)
|
| 6 | Jeux |
| 7 | Panorama, conventions, divers (normes, protocoles, jeux de caractères...) |
| 8 | Commandes d'administration système (réservées à root, comme mount(8))
|
man 7 glob # force la section 7 (panorama/conventions)
man 3 printf # force la section 3 (fonction de bibliothèque), différent de la commande printf(1)
man -a printf # parcourt toutes les sections où "printf" existe, l'une après l'autre
Chercher une page sans connaître son nom exact
man -k find # recherche "find" dans les noms et descriptions courtes (équivalent à apropos)
apropos find # identique à "man -k"
whatis find # affiche uniquement la description courte (une ligne), nom exact requis
man -f find # identique à whatis
⚠️ apropos/whatis s'appuient sur une base d'index (mandb) construite à partir des pages installées. Si une page installée récemment n'apparaît pas dans les résultats, reconstruire l'index :
mandb # reconstruit l'index utilisé par apropos/whatis/man -k
Localiser les fichiers d'une commande
whereis find # binaire, sources et page de man associés à une commande
which find # chemin du binaire réellement exécuté (dans le PATH)
Navigation dans une page (pager less)
man affiche les pages via less ; les raccourcis habituels du pager s'appliquent :
Espace/b— page suivante / précédente/motifpuisn/N— chercher un motif, occurrence suivante / précédenteq— quitter
Ressources
- http://man.developpez.com/ — traduction française des pages de manuel
Voir aussi
- Grep — pour filtrer manuellement la sortie d'une commande si
aproposne suffit pas