Man

De wiki.nexiat.fr
Aller à la navigation Aller à la recherche
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)

man affiche les pages via less ; les raccourcis habituels du pager s'appliquent :

  • Espace / b — page suivante / précédente
  • /motif puis n / N — chercher un motif, occurrence suivante / précédente
  • q — quitter

Ressources

Voir aussi

  • Grep — pour filtrer manuellement la sortie d'une commande si apropos ne suffit pas