Lorsque vous recherchez l'utilisation d'une commande Linux/Unix, vous n'avez pas besoin de Google ou de rechercher dans les forums de discussion, les pages wiki, les blogs ou toute autre ressource hors ligne/en ligne. Tout est documenté dans les pages de manuel (en abrégé pages de manuel) de la commande. Il vous suffit d'apprendre à utiliser efficacement les pages de manuel afin d'obtenir facilement et rapidement les détails d'une commande ou de ses options/drapeaux. Aujourd'hui, je vais partager une astuce de page de manuel moins connue, c'est-à-dire comment afficher une section spécifique dans les pages de manuel sous Linux et Unix.
Structure par défaut de la page de manuel
Une page de manuel se compose de plusieurs sections différentes, organisées avec des titres pour chaque section, tels que NOM, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, STATUT DE SORTIE, VALEUR DE RETOUR, ERREURS, ENVIRONNEMENT, FICHIERS, VERSIONS, CONFORMITÉ, NOTES, BOGUES, EXEMPLE, AUTEURS, et VOIR AUSSI. Chaque page de manuel a son nom de commande suivi du numéro de section entre parenthèses.
Voici la liste des numéros de chapitres du manuel suivis des types de pages qu'ils contiennent :
1 - Executable programs or shell commands. 2 - System calls (functions provided by the kernel). 3 - Library calls (functions within program libraries). 4 - Special files (usually found in /dev). 5 - File formats and conventions e.g. /etc/passwd. 6 - Games. 7 - Miscellaneous (including macro packages and conventions), e.g. man(7). 8 - System administration commands (usually only for root). 9 - Kernel routines [Non standard].
Certaines pages ont toutes ces sections et d'autres non. Voyons maintenant comment afficher une section spécifique de la page de manuel d'une commande.
Afficher une section spécifique dans les pages de manuel sous Linux
Ouvrons une page de manuel d'une commande, par exemple uname .
$ man uname
Faites défiler la fin de la page de manuel et vous verrez des références à d'autres commandes.
[...]
SEE ALSO
arch(1), uname(2)
[...] 
page de manuel de la commande uname
Voyez-vous tous ces chiffres derrière les commandes à la fin ? Vous verrez une ou plusieurs commandes de référence avec des numéros entre parenthèses à la fin de presque toutes les pages de manuel des commandes. Ces chiffres indiquent la section spécifique de la page de manuel de la commande que vous souhaitez consulter. En d'autres termes, le numéro correspond à la section du manuel d'où provient cette page.
Pour dire explicitement à man d'ouvrir la section 2 de la commande uname, exécutez simplement :
$ man 2 uname
Ou,
$ man uname.2
Dans la capture d'écran suivante, la fenêtre Terminal de gauche affiche la sortie de la commande "man uname". Le côté droit de la fenêtre du terminal affiche la sortie de "man 2 uname" (c'est-à-dire section 2 de uname ) commande.
Afficher une section spécifique dans les pages de manuel sous Linux
Veuillez noter que lorsque nous exécutons la commande man sans aucun numéro, cela équivaut généralement à :
$ man 1 <command>
Certaines pages de manuel n'ont pas de section spécifique. Dans ce cas, vous n'obtenez rien en retour lorsque vous essayez d'afficher la page de manuel avec le numéro de section. Par exemple, j'exécute la commande suivante pour voir la 5ème section de la commande uname :
$ man 5 uname
Comme la commande uname n'a pas de section 5, j'obtiens le résultat suivant :
No manual entry for uname in section 5 See 'man 7 undocumented' for help when manual pages are not available.
Afficher toutes les sections d'affilée
Comme je l'ai déjà dit, la page de manuel d'une commande spécifique comporte de nombreuses sections. Pour afficher toutes les pages correspondantes à la suite, utilisez -a drapeau comme ci-dessous.
$ man -a uname
Appuyez sur q pour quitter une section et passer à la section suivante.
Afficher toutes les commandes correspondant à une chaîne avec des numéros de section
Nous pouvons rechercher des pages de manuel contenant une chaîne de recherche en utilisant -k drapeau. Donc, si vous souhaitez récupérer tous les numéros de section d'une commande spécifique dans la page de manuel, utilisez -k comme ci-dessous.
$ man -k uname
Exemple de résultat :
arch (1) - print machine hardware name (same as uname -m) oldolduname (2) - get name and information about current kernel olduname (2) - get name and information about current kernel uname (1) - print system information uname (1posix) - return system name uname (2) - get name and information about current kernel
Comme vous le voyez dans la sortie ci-dessus, nous avons répertorié toutes les commandes (c'est-à-dire les sous-chaînes) qui correspondent à la chaîne de mots-clés donnée. Pour limiter strictement la recherche dans la chaîne correspondante, utilisez :
$ man -k '^uname'
Exemple de résultat :
uname (1) - print system information uname (1posix) - return system name uname (2) - get name and information about current kernel
Vous pouvez également utiliser -f drapeau.
$ man -f uname
Exemple de résultat :
uname (1) - print system information uname (2) - get name and information about current kernel uname (1posix) - return system name
Pour plus de détails, veuillez consulter les pages de manuel de "man".
$ man man
Consultez également les autres sections d'aide pour les pages de manuel.
$ man -k man
$ info man
Lecture recommandée :
- Bonnes alternatives aux pages de manuel que chaque utilisateur Linux doit connaître
- Comment trouver la page de manuel la plus longue sous Linux
- Comment rappeler facilement des commandes Linux oubliées
- Comment créer et gérer vos propres pages de manuel
- Comment installer les pages man manquantes des commandes sur Ubuntu
- Pinfo - Un programme CLI pour lire des informations et des pages de manuel en couleur
J'espère que cela vous aidera.