/

Comment utiliser la commande man de Linux (avec des exemples du niveau débutant au niveau avancé)

par Team Ninja
How to Use Linux’s man Command (With Examples from Beginner to Advanced) blog banner image
How to Use Linux’s man Command (With Examples from Beginner to Advanced) blog banner image

Essayez notre logiciel de gestion des terminaux n°1 sur G2

NinjaOne dashboard screenshot

Webinar

NinjaOne 12.0 Feature Updates: What You Need to Know

Automatisez les aspects les plus complexes de l'informatique

Le CLI (interface en ligne de commande) de Linux est une interface puissante qui permet aux utilisateurs d’interagir directement avec le système d’exploitation. Il est indispensable pour l’administration système, le développement logiciel et bien d’autres tâches techniques. Le CLI offre souplesse et contrôle sur les opérations du système, ce qui en fait un outil essentiel pour les professionnels.

Les pages de manuel (man pages) sont des ressources documentaires complètes qui décrivent les fonctionnalités, les options et l’utilisation des commandes et des programmes sous Linux. Elles constituent une référence incontournable : elles fournissent des informations détaillées et des exemples qui aident à comprendre et à exploiter efficacement les différents outils.

La commande man est la porte d’entrée vers ces pages de manuel. En proposant une interface simple pour interroger et lire les man pages, man permet de trouver rapidement l’information recherchée. C’est particulièrement utile pour résoudre des problèmes, apprendre de nouvelles commandes et maîtriser l’environnement Linux.

Ce guide vise à vous faire comprendre en détail la commande man sous Linux et à montrer son importance pour accéder aux pages de manuel (ou « man pages ») des différentes commandes et programmes. Vous y trouverez des connaissances pratiques, appuyées par des exemples concrets, pour utiliser la commande man efficacement et gagner en aisance en ligne de commande.

La commande man sous Linux : de quoi s’agit-il ?

La commande man est née au début des années 1970 avec le système d’exploitation Unix développé aux Bell Labs par Ken Thompson, Dennis Ritchie et d’autres. À l’origine, la documentation d’Unix était clairsemée, d’où le besoin d’un système normalisé pour documenter les commandes et les fonctions. Le premier Unix Programmer’s Manual a été publié en 1971 ; il contenait de brèves descriptions et des exemples d’utilisation pour différentes commandes et programmes.

La commande man a été conçue pour accéder aux copies électroniques de ces pages de manuel imprimées directement depuis la ligne de commande. Les utilisateurs pouvaient ainsi trouver plus facilement la documentation dont ils avaient besoin, sans avoir à consulter les manuels papier. Ce système a ensuite été affiné et étendu dans les versions suivantes d’Unix.

Lorsque Linus Torvalds a développé Linux au début des années 1990, le système a hérité de nombreuses caractéristiques d’Unix, dont la commande man. Le projet Linux man-pages a été lancé pour que la documentation propre à Linux soit facilement accessible, en couvrant un large éventail de sujets, des commandes de base aux appels système avancés et aux fichiers de configuration.

Lorsqu’un utilisateur tape man suivi du nom d’une commande, le système interroge la base de données des pages de manuel et récupère la documentation correspondante. Ce processus consiste à parcourir des répertoires prédéfinis où sont stockées les man pages et à construire une base de données à l’échelle du système, tenue à jour, afin de garantir des informations exactes et complètes.

(La mise à jour de la « man db » (base de données) est souvent déclenchée comme étape post-installation par les systèmes de gestion de paquets de nombreuses distributions Linux ; cela permet de garantir que les mises à jour, les installations et les désinstallations laissent votre documentation aussi fraîche, propre et (en théorie) aussi exempte de bugs que vos logiciels eux-mêmes.

Utiliser man : des exemples simples aux plus avancés

Comme indiqué plus haut, vous pouvez consulter les pages de manuel des commandes courantes (par exemple ls, grep ou ssh) directement depuis la ligne de commande avec man [commande] pour la ou les commandes qui vous intéressent. Les fonctionnalités plus avancées, comme la recherche par mot-clé, sont abordées ci-dessous.

Se déplacer dans une page de manuel

La navigation dans les man pages est simple. Les utilisateurs d’éditeurs compatibles vim reconnaîtront les conventions de touches :

ActionToucheDescription
Afficher l’aide.hAffiche l’écran d’aide avec la liste de toutes les commandes de navigation.
Rechercher un terme./ suivi du termeLance une recherche du terme indiqué dans la page de manuel.
Aller à l’occurrence suivante.nPasse à l’occurrence suivante du terme recherché dans la page de manuel.
Aller à l’occurrence précédente.NRevient à l’occurrence précédente du terme recherché dans la page de manuel.
Quitter le lecteur de pages de manuel.qFerme le lecteur de pages de manuel et revient à l’invite de commande.
Défiler vers le bas.Flèche bas ou jFait défiler d’une ligne vers le bas.
Défiler vers le haut.Flèche haut ou kFait défiler d’une ligne vers le haut.
Page suivante.Espace / Ctrl + FFait défiler d’une page vers le bas.
Page précédente.b ou Ctrl + BFait défiler d’une page vers le haut.
Aller au début du document.gPlace le curseur au début de la page de manuel.
Aller à la fin du document.GPlace le curseur à la fin de la page de manuel.
Rafraîchir l’écran.Ctrl + LRedessine l’écran, utile si l’affichage est altéré.
Aller à la section suivante.}Saute au titre de section suivant.
Aller à la section précédente.{Saute au titre de section précédent.

Exemples avancés :

  • Accéder à des sections précises des pages de manuel : la documentation de certaines commandes est répartie en plusieurs sections. Par exemple, man 5 passwd donne accès au format du fichier de configuration de la commande passwd, tandis que man 1 passwd décrit la commande utilisateur.
  • Rechercher par mot-clé dans les pages de manuel : la commande man -k [mot-clé] recherche toutes les pages de manuel contenant le mot-clé indiqué. Par exemple, man -k network liste toutes les man pages liées au réseau.

Conseils et astuces pour maîtriser la commande man

Personnaliser la sortie de la commande man :

  • Associer man à d’autres commandes pour aller plus loin : vous pouvez combiner man avec d’autres commandes afin de traiter la sortie d’une page de manuel. Par exemple, man ls | grep -i sort filtre la page de manuel de ls pour n’afficher que les lignes contenant le terme « sort ».
  • Personnaliser le format d’affichage des pages de manuel : par défaut, la commande less est utilisée pour afficher le contenu des man pages dans un format navigable et interrogeable. En définissant des variables d’environnement comme MANPAGER et MANWIDTH, vous pouvez modifier la sortie. Par exemple, export MANPAGER= »less -S » configure l’affichage des pages de manuel dans less avec le défilement horizontal activé.

Une page de manuel classique comporte des sections telles que NAME, SYNOPSIS, DESCRIPTION, OPTIONS et EXAMPLES. Cette organisation en sections offre une structure homogène qui permet de trouver plus rapidement l’information recherchée.

Elle améliore la lisibilité et garantit que les détails importants ne passent pas entre les mailles du filet, ce qui rend la documentation plus accessible et plus efficace, aussi bien pour les débutants que pour les utilisateurs expérimentés.

Chaque section a un rôle précis :

  • NAME : brève description de la commande. Elle donne immédiatement une idée de son objectif.
  • SYNOPSIS : résumé de la syntaxe de la commande. Cette section indique comment l’utiliser, avec ses paramètres et ses options.
  • DESCRIPTION : explication détaillée du fonctionnement de la commande. Elle décrit en profondeur ce que fait la commande et comment elle opère.
  • OPTIONS : liste des options disponibles et leur description. Cette section aide à comprendre les différents indicateurs et paramètres qui modifient le comportement de la commande.
  • EXAMPLES : exemples d’utilisation concrets. Ils illustrent les cas d’usage courants et montrent comment appliquer la commande dans des situations réelles.

Cas d’usage avancés de man

Accéder à des sections précises et en extraire le contenu

  • Filtrer par numéro de section : pour accéder à des sections précises des pages de manuel. Par exemple, man 3 printf affiche la documentation de la fonction printf de la bibliothèque standard C. Voici la liste des numéros de section des pages de manuel :
    • 1 : commandes utilisateur (programmes exécutables ou commandes shell)
    • 2 : appels système (fonctions fournies par le noyau)
    • 3 : appels de bibliothèque (fonctions des bibliothèques de programmes)
    • 4 : fichiers spéciaux (généralement dans /dev)
    • 5 : formats de fichiers et conventions (par exemple /etc/passwd)
    • 6 : jeux et économiseurs d’écran
    • 7 : divers (y compris les paquets de macros et les conventions)
    • 8 : commandes d’administration système (généralement réservées à root)
    • 9 : routines du noyau (non standard)
  • Isoler des sections précises : extrayez des sections détaillées, comme la section EXAMPLES, à l’aide d’outils tels que awk ou sed. Exemple : man ls | sed -n ‘/^EXAMPLES/,/^$/p’ extrait la section EXAMPLES de la page de manuel de ls.

Créer ses propres pages de manuel

  • Rédiger sa propre documentation : créez des pages de manuel personnalisées pour vos scripts et commandes propriétaires. Il s’agit d’écrire une page de manuel dans un fichier texte, puis de l’installer pour la rendre accessible via la commande man. Exemple : sudo cp mycommand.1 /usr/local/man/man1/ installe une page de manuel personnalisée.
  • Intégrer des pages man dans les scripts : incluez dans vos scripts une documentation intégrée, accessible via man. Utilisez la commande cat pour afficher le texte de la page de manuel intégrée. Exemple : man ./myscript affiche la page de manuel intégrée de myscript.

Combiner man avec d’autres outils

  • Associer man et apropos : utilisez apropos pour trouver les commandes liées à un mot-clé, puis transmettez les résultats à man via un pipe. Exemple : apropos network | xargs -n 1 man -k recherche les commandes liées au réseau et affiche leurs pages de manuel.
    • Remarque : man vs apropos vs info : la commande man fournit des pages de manuel détaillées pour les commandes et les programmes dans un format structuré, apropos recherche des mots-clés dans les descriptions des pages de manuel afin de repérer les commandes liées à un sujet précis, et info affiche la documentation dans un format hypertexte, souvent plus détaillé et plus facile à parcourir que man.
  • Automatiser la consultation de la documentation : créez des scripts qui automatisent la recherche et l’affichage des pages de manuel en fonction de la saisie de l’utilisateur. Exemple : # !/bin/bash read -p « Enter command:  » cmd; man $cmd demande une commande à l’utilisateur et affiche sa page de manuel.

Personnaliser et améliorer l’affichage

  • Mettre en forme la sortie pour une meilleure lisibilité : utilisez des variables d’environnement et des options pour personnaliser la sortie des pages de manuel. Exemple : export MANWIDTH=80; man ls définit la largeur d’affichage pour une meilleure lisibilité sur les écrans étroits.
  • Convertir les pages de manuel dans d’autres formats : convertissez les man pages en HTML ou en PDF pour les lire hors ligne ou les imprimer. Exemple : man -t ls | ps2pdf – ls.pdf convertit la page de manuel de ls en fichier PDF.

Techniques de recherche avancées

  • Recherche en texte intégral dans les pages de manuel : effectuez une recherche en texte intégral dans toutes les pages de manuel installées à l’aide d’outils comme grep. Exemple : grep -r ‘keyword’ /usr/share/man/man* recherche un mot-clé dans toutes les man pages.
  • Utiliser les expressions régulières : servez-vous des expressions régulières pour repérer des motifs complexes dans les pages de manuel. Exemple : man ls | grep -E ‘\-l | \-a’ recherche à la fois les options -l et -a dans la page de manuel de ls.

Localisation et internationalisation

  • Consulter les pages de manuel dans d’autres langues : définissez la variable d’environnement LANG pour accéder aux pages de manuel dans d’autres langues. Exemple : LANG=es_ES.UTF-8 man ls affiche la page de manuel de ls en espagnol.
  • Créer des pages de manuel multilingues : rédigez et installez des pages de manuel multilingues pour vos commandes personnalisées, afin de les rendre accessibles dans différentes locales.

Intégrer les pages de manuel aux EDI et aux éditeurs

  • Intégration à un EDI : configurez votre EDI (environnement de développement intégré) pour qu’il affiche les pages de manuel des commandes ou fonctions sélectionnées. Exemple : configurer Vim avec la commande :Man pour consulter les man pages directement dans l’éditeur.
  • Plugins d’éditeur : utilisez des plugins d’éditeur qui donnent un accès rapide aux pages de manuel. Exemple : installer le plugin vim-man pour consulter les pages de manuel dans Vim à l’aide d’une simple commande.

Utiliser man dans les scripts et l’automatisation

  • L’utilitaire man peut servir dans des scripts pour automatiser l’extraction d’informations issues des pages de manuel. Par exemple, man ls | col -b | grep -A2 ‘^ *-l ‘ extrait la description de l’option -l de la commande ls. Cette technique est utile pour créer des outils de documentation automatisés ou intégrer l’aide des commandes dans vos propres scripts.

Progressez dans votre apprentissage de Linux

La commande man est un outil précieux pour les utilisateurs de Linux : elle donne un accès immédiat à une documentation complète sur les commandes et les programmes. Elle renforce la capacité à comprendre et à utiliser efficacement les différents outils de l’environnement Linux.

N’hésitez pas à explorer man et à expérimenter d’autres commandes Linux pour approfondir vos connaissances et gagner en aisance. Plus vous serez familier de ces outils, plus vous saurez gérer et dépanner vos systèmes efficacement. Vous pouvez prolonger cet apprentissage pratique avec notre guide vidéo sur les commandes Linux essentielles

Quelques mots pour conclure sur le rôle de man dans l’utilisation de la ligne de commande Linux : maîtriser la commande man est une compétence fondamentale pour quiconque utilise l’interface en ligne de commande de Linux. Elle fournit non seulement une documentation essentielle, mais elle permet aussi de gagner en autonomie et en confiance pour se repérer dans le système d’exploitation Linux et en exploiter les possibilités.

Vous pouvez également regarder la vidéo Comment utiliser la commande man de Linux (avec des exemples du niveau débutant au niveau avancé).

Vous pourriez aussi aimer

Prêt à simplifier les aspects les plus complexes de l'informatique et de la sécurité ?