Tutoriel sur la commande man de Linux pour les débutants (8 exemples)

Un aspect très utile de la ligne de commande Linux est que la documentation pour presque tous les outils de ligne de commande est facilement accessible. Ces documents sont connus sous le nom de pages man, et vous pouvez y accéder facilement via la ligne de commande en utilisant la commande man.

Dans ce tutoriel, nous allons discuter des bases de man en utilisant des exemples faciles à comprendre. Mais avant cela, il convient de mentionner que tous les exemples de cet article ont été testés sur une machine Ubuntu 16.04 LTS.

Commande man de Linux

La commande man donne aux utilisateurs accès aux pages de manuel pour les utilitaires et outils de ligne de commande. Voici la syntaxe de cette commande :

man [nom de la commande/de l'outil]

Et voici comment la propre page de manuel de man la décrit :

 man - une interface aux manuels de référence en ligne  
  man est le pager de manuel du système. Chaque argument de page donné à man est  
 normalement le nom d'un programme, d'un utilitaire ou d'une fonction. La page de manuel  
 associée à chacun de ces arguments est alors trouvée et affichée. Une  
 section, si fournie, dirigera man à ne regarder que dans cette section du  
 manuel. L'action par défaut est de rechercher dans toutes les sections  
 disponibles suivant un ordre pré-défini ("1 n l 8 3 2 3posix 3pm 3perl 5  
 4 9 6 7" par défaut, sauf si remplacé par la directive SECTION dans  
 /etc/manpath.config), et d'afficher seulement la première page trouvée, même si  
 la page existe dans plusieurs sections.  

 Le tableau ci-dessous montre les numéros de section du manuel suivis des  
 types de pages qu'ils contiennent.  

 1 Programmes exécutables ou commandes shell  
 2 Appels système (fonctions fournies par le noyau)  
 3 Appels de bibliothèque (fonctions au sein des bibliothèques de programmes)  
 4 Fichiers spéciaux (généralement trouvés dans /dev)  
 5 Formats de fichiers et conventions par ex. /etc/passwd  
 6 Jeux  
 7 Divers (y compris les paquets de macros et conventions), par ex.  
 man(7), groff(7)  
 8 Commandes d'administration système (généralement uniquement pour root)  
 9 Routines du noyau [Non standard]  

 Une page de manuel se compose de plusieurs sections.  

 Les noms de section conventionnels incluent NOM, SYNOPSIS, CONFIGURATION,  
 DESCRIPTION, OPTIONS, ÉTAT DE SORTIE, VALEUR DE RETOUR, ERREURS, ENVIRONNEMENT,  
 FICHIERS, VERSIONS, CONFORMITÉ, NOTES, BUGS, EXEMPLE, AUTEURS, et  
 VOIR ÉGALEMENT.

Voici quelques exemples sous forme de questions-réponses qui devraient vous donner une bonne idée de la façon dont fonctionne la commande man.

Q1. Comment utiliser la commande man ?

L’utilisation de base de man est très simple - il suffit d’exécuter la commande avec le nom de l’outil dont vous souhaitez accéder au manuel de référence.

man [nom de la commande/de l'outil]

Par exemple :

man ls

Q2. Comment faire en sorte que man affiche la page de manuel à partir de sections spécifiques ?

Comme déjà mentionné au début, toutes les pages de manuel disponibles sont réparties en sections, et il existe des sections qui contiennent des entrées de page man du même nom. Pour vous faciliter la tâche, la commande man vous permet d’accéder directement aux pages de manuel à partir de sections spécifiques, ce que vous pouvez faire en spécifiant simplement le numéro de section avant le nom de la commande/de l’outil.

man [numéro-de-section] [nom de la commande/de l'outil]

Par exemple :

man 3 printf 

Q3. Comment rechercher des pages de manuel et imprimer également des descriptions courtes ?

En parcourant la Q&A 2, on peut se demander comment se souvenir des numéros de section pour les entrées de manuel ayant le même nom. Eh bien, vous n’avez pas à le faire car il existe une option de ligne de commande ‘f’ qui permet à man d’afficher toutes les pages de manuel qui correspondent au nom dans l’entrée.

Par exemple :

man -f printf

Voici la sortie produite par la commande ci-dessus sur mon système :

Ainsi, vous pouvez voir toutes les entrées avec le nom ‘printf’ - accompagnées des numéros de section - ont été affichées dans la sortie.

Q4. Comment faire en sorte que man affiche toutes les pages de manuel pour une entrée donnée ?

Maintenant, que faire si vous voulez que man affiche une par une toutes les pages de manuel correspondant à une entrée donnée ? Eh bien, c’est possible, et vous devrez utiliser l’option de ligne de commande -a pour cela.

Par exemple, si vous souhaitez voir en série toutes les pages man pour ‘printf’, vous pouvez le faire de la manière suivante :

man -a printf

La commande ci-dessus ouvrira d’abord la page man de printf de la section 1, et lorsque vous la quitterez, la commande vous demandera si vous souhaitez voir la prochaine page man de ‘printf’.

Q5. Comment faire en sorte que man recherche en considérant l’entrée comme une expression régulière ?

Dans le cas où vous souhaitez que la commande man recherche et liste les pages de manuel en considérant l’entrée comme une expression régulière, vous pouvez le faire en utilisant l’option de ligne de commande -k.

man -k [nom de la commande/de l'outil]

Par exemple :

man -k printf

Voici la sortie produite par la commande ci-dessus sur mon système :

Q6. Comment faire en sorte que man affiche l’emplacement des pages de manuel ?

Dans le cas où le besoin est de connaître uniquement l’emplacement des pages de manuel, vous pouvez forcer man à le faire en utilisant l’option de ligne de commande -w.

man -w [nom de la commande/de l'outil]

Par exemple :

man -w printf

Voici la sortie produite par cette commande sur mon système :

/usr/share/man/man1/printf.1.gz

Q7. Comment faire en sorte que man affiche les pages de manuel dans le navigateur Web ?

Utilisez l’option de ligne de commande -H pour cela.

man -H[commande-navigateur] [nom de la commande/de l'outil]

Par exemple :

man -Hfirefox printf

Q8. Comment rendre la commande man sensible à la casse ?

Par défaut, la commande man ignore la casse lors de la recherche de pages de manuel. Cependant, si vous le souhaitez, vous pouvez activer la sensibilité à la casse en utilisant l’option de ligne de commande -I.

man -I [nom de la commande/de l'outil]

Conclusion

Ainsi, vous pouvez voir que man est une commande extrêmement importante que les utilisateurs - tant les débutants que les professionnels - devraient savoir comment utiliser. Nous n’avons ici qu’effleuré la surface, car l’outil offre de nombreuses fonctionnalités. Pratiquez d’abord celles-ci, et lorsque vous aurez terminé, rendez-vous sur la page de manuel de man pour plus d’infos.