Commande man de Linux : Comment lire et rechercher des pages de manuel

Sous Linux, utiliser la commande man vous permet de consulter les pages de manuel des commandes et des fonctions du système installées. Par exemple, exécuter man ls vous permet de lire l'utilisation et les options de ls, et en général, vous pouvez appuyer sur q pour quitter l'écran.

Ouverture d'une page de manuel

man signifie manuel et aide à trouver et afficher les pages de manuel installées sur le système. En plus des programmes, il existe des pages relatives aux formats de fichiers de configuration, aux appels système et aux fonctions de bibliothèque. Par exemple, la commande suivante ouvre le manuel pour ls.

man ls

Les manuels incluent généralement le nom et une courte description dans NAME, le format de la commande dans SYNOPSIS, et les fonctions et options dans DESCRIPTION et OPTIONS. Le contenu et les titres des sections peuvent varier selon le programme. Lire le manuel n’exécute pas les commandes décrites ni ne modifie les paramètres du système.

Navigation et recherche à l’écran

man utilise un programme de pagination pour afficher un contenu long une page à la fois. Les instructions ci-dessous sont basées sur le less couramment utilisé. Si un programme différent est configuré, les touches peuvent différer.

• Flèche Bas/Haut : Se déplacer d'une ligne à la fois.
• Espace ou Page Bas : Descendre d'un écran. b ou Page Haut monte d'un écran.
• / suivi d'un terme de recherche et Entrée : Rechercher vers l'avant à partir de la position actuelle. n se déplace vers le résultat suivant dans la même direction, N se déplace vers le résultat dans la direction opposée.
• g et G : Aller respectivement au début et à la fin du document. Sensible à la casse.
• h et q : h ouvre l'aide de l'opération, et q quitte l'aide ou l'écran du manuel.

Par exemple, si vous saisissez /sort sur l'écran man ls et appuyez sur Entrée, cela recherche en avant cette expression. Le terme de recherche est saisi dans l'écran du manuel, et non en tant que commande shell. Pour les touches détaillées et les règles de recherche, consultez le manuel less.

Sélection des sections du manuel ayant le même nom

Les manuels sont divisés en sections numérotées selon les sujets. Si un nom de page existe dans plusieurs sections, vous pouvez spécifier un numéro pour ouvrir la page souhaitée. Par exemple, passwd est utilisé à la fois pour les commandes liées au mot de passe utilisateur et pour les noms de fichiers d'informations de compte.

man 1 passwd
man 5 passwd

La première commande trouve le manuel pour la commande, et la seconde trouve le manuel pour le format de fichier. La page correspondante doit être installée sur le système pour être affichée. Si le numéro est omis, la page trouvée en premier selon l'ordre de recherche configuré sera ouverte.

• 1 : Commandes générales et programmes exécutables
• 2 : Appels système
• 3 : Fonctions de la bibliothèque
• 5 : Formats de fichiers et règles
• 8 : Commandes de gestion du système

La notation passwd(5) indique le nom de la page et le numéro de section. Les sections complètes et les méthodes de recherche peuvent être trouvées dans le manuel man.

Trouver une page par nom ou par sujet

Si vous ne connaissez pas le nom exact de la commande, vous pouvez rechercher le nom du manuel et une brève description en utilisant man -k. L'exemple suivant trouve des éléments liés à password.

man -k password

Les résultats afficheront le nom de la page, le numéro de section et une courte description. Les termes de recherche peuvent être interprétés comme des expressions régulières, et cette recherche ne couvre pas tout le texte du manuel. Les éléments trouvés peuvent être ouverts comme man 5 passwd en utilisant le nom et le numéro de section.

Si vous connaissez déjà le nom et souhaitez uniquement voir la courte description, exécutez-le comme suit.

man -f ls

man -k et man -f utilisent l'index du manuel, donc les résultats peuvent varier en fonction des documents installés ou du statut de l'index.

Lorsque le manuel ne peut pas être trouvé

• Page introuvable : Vérifiez l'orthographe du nom et assurez-vous que le programme et le paquet de documents associé sont installés. Le manuel peut manquer dans un environnement d'installation minimale.
• Commandes intégrées : Les commandes intégrées au shell, comme cd, peuvent ne pas avoir de pages séparées. Dans Bash, vous pouvez vérifier help cd ou man bash.
• Aucun résultat de recherche : Assurez-vous que la documentation est installée et que l'index du manuel est préparé. Pour régénérer l'index et gérer les permissions, suivez la documentation de la distribution.
• Langue différente : Selon la traduction installée et les paramètres régionaux, il peut apparaître en anglais. Vérifiez les options et les exemples en fonction de la documentation pour la version du logiciel installée.

Si vous avez besoin d'une aide simple fournie par la commande elle-même, vous pouvez également vérifier l'option --help de ce programme. L'utilisation de man elle-même peut être vue dans man man.