Les manuels de Linux recèlent toutes les informations essentielles. Vous pouvez y chercher une commande pour effectuer une tâche spécifique, même si vous ignorez son nom. Mais comment accéder à ces précieuses pages de manuel ? Voici quelques techniques pour vous guider.
Le Manuel Intégré de Linux : Votre Référence Essentielle
Une plaisanterie bien connue dans le monde Linux (datant de l’âge d’or d’Unix) stipule que la seule commande que vous devez maîtriser est man
, le point d’accès universel aux manuels. Bien qu’il y ait une part de vérité, l’utilisation de man
peut s’avérer déroutante pour les débutants, notamment pour la recherche d’informations spécifiques.
N’avez-vous jamais eu l’idée précise de ce que vous vouliez accomplir, sans toutefois connaître le nom de la commande appropriée ? Nous sommes nombreux à avoir vécu cette situation. C’est un peu comme tenter de retrouver un mot dans un dictionnaire sans le connaître.
Alors, comment trouver votre chemin dans ce labyrinthe d’informations? Heureusement, il existe des moyens de naviguer avec succès à travers man
.
Les chiffres associés aux commandes peuvent également poser problème au début. Que représentent-ils et quelle est leur signification ? Il n’est pas rare de rencontrer des notations telles que man (2)
ou man (5)
dans la documentation, ou des commandes suivies de chiffres comme mount (2)
et mount (8)
. L’existence de plusieurs commandes « mount » peut surprendre. En fait, ces chiffres sont cruciaux et leur compréhension est relativement simple.
De plus, une fois la logique de la commande man
assimilée, la recherche devient assez aisée. Il existe plusieurs astuces pour explorer et naviguer dans les manuels. Découvrons ensemble comment en tirer le meilleur parti !
Comment Consulter le Manuel
Pour utiliser man
, saisissez simplement man
, suivi d’un espace, puis de la commande Linux concernée. man
affichera alors la « page de manuel » décrivant cette commande, si elle existe bien entendu.
Essayons la commande suivante pour voir ce que man
a à dire sur lui-même :
man man
La page de manuel de man
s’affiche.
Comme vous le voyez, il s’agit de la page man (1)
.
Voici quelques astuces pour naviguer dans une page de manuel :
- Pour vous déplacer ligne par ligne : utilisez la molette de votre souris, les flèches haut et bas, ou la touche Entrée.
- Pour vous déplacer écran par écran : appuyez sur la barre d’espace, les touches PgDn et PgUp.
- Pour atteindre le début ou la fin de la page : utilisez les touches Début et Fin.
En appuyant sur H, vous accédez à une section d’aide présentant un tableau des raccourcis clavier disponibles. Ceux mentionnés ci-dessus sont généralement les plus intuitifs pour la plupart des utilisateurs.
Pour quitter man
, il suffit d’appuyer sur la touche Q.
Structure d’une Page de Manuel
En haut de la page, vous trouverez les en-têtes « Nom » et « Synopsis ». Les pages de manuel suivent une convention de mise en page. Il existe des pages pour les commandes, les programmes et les fonctions de programmation (routines de bibliothèque). Tous les en-têtes ne seront pas présents systématiquement, car certains ne s’appliquent qu’à certains types de commandes.
Voici quelques-uns des titres que vous pourriez rencontrer :
- Nom : Le nom de la commande que décrit la page de manuel.
- Synopsis : Un résumé de la commande et de sa syntaxe.
- Configuration : Les détails de configuration d’un périphérique.
- Description : Une explication du rôle du programme.
- Options : Une description des options de ligne de commande acceptées par la commande.
- État de sortie : Les valeurs possibles de l’état de sortie de la commande, et les conditions qui peuvent les provoquer.
- Valeur de retour : Si la page concerne une routine de bibliothèque, cette section décrit la valeur que la routine peut renvoyer à la fonction appelante.
- Erreurs : Une liste des valeurs qui peuvent être placées dans
errno
en cas d’erreur. - Environnement : La liste des variables d’environnement qui influencent la commande ou le programme, et de quelle manière.
- Fichiers : La liste des fichiers utilisés par la commande ou le programme, tels que les fichiers de configuration.
- Attributs : Un résumé des attributs divers de la commande.
- Versions : Les détails des versions du noyau Linux ou des bibliothèques où un appel système ou une fonction de bibliothèque est apparu pour la première fois ou a subi des changements importants par rapport aux versions précédentes.
- Conforme à : Une description des normes respectées par la commande, comme POSIX.
- Notes : Des notes diverses.
- Bogues : Les problèmes connus.
- Exemples : Un ou plusieurs exemples d’utilisation de la commande.
- Auteurs : Les personnes qui ont écrit ou qui maintiennent la commande.
- Voir aussi : Les références recommandées relatives à la commande ou au sujet.
Les Sections du Manuel
Si vous faites défiler vers le bas, vous verrez une liste des sections du manuel.
Voici les sections :
- Commandes générales : Les commandes que vous utilisez sur la ligne de commande.
- Appels système : Les fonctions fournies par le noyau et qu’un programme peut appeler.
- Fonctions de bibliothèque : Les fonctions que les programmes peuvent appeler à partir des bibliothèques de code (principalement la bibliothèque C standard).
- Fichiers spéciaux : Généralement les périphériques, tels que ceux que l’on trouve dans /dev, et leurs pilotes.
- Formats de fichier et conventions : Les formats des fichiers, tels que passwd, la table cron, et les archives tar.
- Jeux : Les descriptions de commandes, comme fortune, qui affichent des citations à partir d’une base de données.
- Divers : Les descriptions de sujets tels que les inodes, les paramètres de démarrage et man lui-même.
- Administration système : Les commandes et les démons généralement réservés à l’administrateur (root).
- Routines du noyau : Les informations relatives au fonctionnement interne du noyau. Cela inclut les interfaces de fonctions et les variables utiles pour les développeurs de pilotes de périphériques par exemple. Cette section n’est généralement pas installée sur la plupart des systèmes.
Lorsqu’une commande est suivie d’un nombre, cela fait référence à sa description dans cette section spécifique du manuel. Par exemple, man (1)
désigne l’entrée de la première section du manuel, qui décrit la commande man
elle-même.
Dans l’image ci-dessus, vous pouvez voir une référence à man (7)
. Cela signifie qu’il existe des informations complémentaires sur man
dans une autre section. Lorsque nous avons ouvert la page de manuel pour la première fois, elle a affiché man (1)
. Si vous saisissez uniquement man
sans numéro de section, man
effectuera une recherche dans toutes les sections dans l’ordre, afin de trouver une entrée pour la commande que vous avez saisie. Bien évidemment, elle a trouvé man (1)
avant man (7)
.
Si vous souhaitez forcer man
à rechercher une entrée dans une section spécifique, vous devez inclure le numéro de section sur la ligne de commande.
Par exemple, saisissez la commande suivante pour ouvrir l’entrée pour man dans la section sept :
man 7 man
Le manuel s’ouvre sur l’entrée de man dans la section sept.
Cette page de manuel donne des instructions sur la manière de rédiger des pages de manuel. Elle décrit le format du fichier et les macros que vous pouvez utiliser pour faciliter votre travail. La page man (1)
de la première section, que nous avons consultée précédemment, explique comment utiliser man
lui-même.
Comment Trouver des Entrées par Section
En général, si vous voulez simplement savoir comment utiliser une commande, vous n’avez pas besoin d’indiquer un numéro de section. man
trouvera l’entrée standard qui décrit l’utilisation de cette commande dans la première section du manuel. Cependant, il est parfois nécessaire de consulter une entrée de commande dans une section spécifique, pour obtenir des informations différentes.
Vous pouvez facilement identifier les sections du manuel qui contiennent des entrées pour une commande particulière. Chaque page de manuel possède un titre et une brève description. L’option -f
(whatis) recherche les titres des pages et retourne une liste de correspondances.
Par exemple, nous saisissons la commande suivante :
man -f man
Les deux pages de manuel de man
sont listées, avec leurs numéros de section et de brèves descriptions. Attention toutefois, certaines entrées peuvent avoir le même nom, mais décrire des commandes ou des fonctions différentes.
Par exemple, saisissons la commande suivante :
man -f printf
Il semble que deux entrées aient été trouvées pour printf
: la première dans la première section, et l’autre dans la troisième section. Ce sont pourtant des commandes distinctes. La page de manuel de la section 1 décrit la commande printf
en ligne de commande, qui met en forme la sortie dans la fenêtre du terminal. La page de manuel de la section trois décrit la famille de fonctions de bibliothèque printf
dans le langage de programmation C.
Il est également possible d’effectuer des recherches dans les brèves descriptions, en plus des titres des pages. Pour ce faire, utilisez l’option -k
(apropos). Cela correspondra également aux occurrences du terme de recherche dans d’autres mots plus longs.
Nous saisissons par exemple la commande suivante :
man -k printf
Un grand nombre de ces commandes sont décrites dans les mêmes pages de manuel, car leurs fonctionnalités de base sont essentiellement identiques. La page de manuel de vprintf
décrit les fonctionnalités de 10 des commandes listées dans l’image ci-dessus.
Vous pouvez utiliser cette fonctionnalité pour trouver des informations relatives à la tâche que vous souhaitez accomplir, même si vous ne connaissez pas le nom de la commande appropriée.
Supposons que vous souhaitiez modifier le mot de passe d’un compte utilisateur. Nous pouvons rechercher toutes les commandes qui mentionnent « utilisateur » dans les titres ou les descriptions des pages de manuel. Ensuite, nous pouvons utiliser grep pour trouver les entrées contenant « mot de passe ».
Pour ce faire, saisissez la commande suivante :
man -k 'user ' | grep password
En plaçant le mot « utilisateur » entre guillemets simples, et en incluant un espace à la fin, nous garantissons que seules les correspondances exactes avec « utilisateur » (et non « utilisateurs ») seront trouvées. Un rapide coup d’œil aux résultats de la recherche révèle que le candidat le plus probable est passwd
.
Comme il s’agit d’une page de manuel de la section 1, et qu’il n’est pas nécessaire d’inclure le numéro de section dans la commande, nous saisissons ce qui suit :
man passwd
Imaginons maintenant que vous avez besoin d’une commande pour compter le nombre de mots dans un fichier texte. Nous pouvons vérifier si une commande de ce type existe avec la requête suivante :
man -k word | grep count
Pour tout savoir sur le comptage des mots, nous exécutons la commande :
man wc
À propos de wc
, il est également possible d’utiliser l’option -k
(apropos) avec un simple point (.
) comme cible de recherche, ce qui correspond à tout. Si nous redirigeons cette commande vers wc
et utilisons l’option -l
(lines), nous obtiendrons le nombre total de pages de manuel présentes sur le système.
Pour réaliser tout cela, nous tapons la commande suivante :
man -k . | wc -l
Il y a 6706 pages de manuel sur cet ordinateur Ubuntu, mais ne soyez pas surpris si le nombre diffère sur votre système. Ce nombre peut varier en fonction des logiciels et des utilitaires installés, ainsi que des pages de manuel pré-installées.
Recherche dans une Page de Manuel
Vous pouvez également effectuer des recherches en avant ou en arrière à partir de votre position actuelle dans une page de manuel.
Pour cet exemple, nous saisissons la commande suivante afin d’ouvrir la page de manuel de la commande history
:
man history
Pour rechercher en avant, appuyez sur la barre oblique (/
), puis saisissez le mot « événement ». La cible de recherche s’affiche en bas de la fenêtre du terminal. Appuyez sur Entrée pour lancer la recherche.
La fenêtre affichera le premier résultat trouvé, mis en surbrillance.
Appuyez sur la touche « n » pour passer au résultat suivant vers le bas de la page. Pour rechercher en arrière dans la page, appuyez sur « N »; cela vous ramènera vers le haut de la page.
Pour activer ou désactiver la mise en surbrillance, appuyez sur Échap + U.
Si vous êtes près du bas de la page de manuel et que vous souhaitez rechercher vers le haut, appuyez sur le point d’interrogation (?
), puis saisissez le terme recherché. Nous avons cherché « entrée ».
À nouveau, tous les résultats trouvés sont mis en évidence.
Pour passer au résultat correspondant suivant, appuyez sur « n » afin de vous déplacer vers le début de la page de manuel. Appuyez sur « N » pour aller au résultat correspondant précédent, vers la fin de la page de manuel.
Une autre méthode permet d’effectuer des recherches dans une page de manuel. Elle masque toutes les lignes qui ne contiennent pas le terme de recherche. Il est donc préférable d’utiliser les numéros de ligne avec cette technique.
Si nous tapons « -N » et appuyons sur Entrée, nous pouvons afficher les numéros de ligne dans la page de manuel.
Nous appuyons sur l’esperluette (&
), saisissons notre terme de recherche (numéro), puis appuyons sur Entrée.
Seules les lignes contenant notre terme de recherche sont affichées.
Il est facile de les parcourir et de repérer celles qui semblent intéressantes. Nous estimons que la ligne 292 est pertinente. Nous allons donc consulter cette section de la page de manuel.
Pour afficher à nouveau toutes les lignes, nous appuyons sur l’esperluette (&
), puis nous appuyons sur Entrée.
Nous saisissons « 292 », puis « g » pour atteindre cette ligne.
Dès que nous tapons « g », nous sommes redirigés vers la ligne 292 (c’est pourquoi le « g » n’apparaît pas dans l’image ci-dessus). La ligne 292 est alors affichée en haut de la fenêtre du terminal.
Vous pouvez appuyer sur « -n » et Entrée pour masquer les numéros de ligne.
Explorez le Manuel avec Assiduité
Les pages de manuel contiennent une quantité impressionnante d’informations. Même pour les commandes que vous pensez bien connaître, il est probable que vous y découvriez des options dont vous ignoriez l’existence.
De plus, vous découvrirez certainement des commandes dont vous ne soupçonniez pas l’existence. Avec de nombreuses façons différentes de chercher et de retrouver des informations, il est rassurant de savoir que tout cela est disponible à portée de main.