Tutoriel sur la commande manpath de Linux pour les débutants (5 exemples)

Les pages de manuel dans Linux sont le point de départ pour le support de premier niveau en ce qui concerne les utilitaires en ligne de commande. Comme la plupart d’entre vous le savent, il suffit d’écrire ‘man [nom-de-commande]’ et la page de manuel correspondante apparaît. Mais savez-vous le chemin où ces pages de manuel sont recherchées ?

Dans ce tutoriel, nous allons discuter de manpath, un utilitaire qui vous montre cette information. Mais avant de commencer l’explication, il convient de mentionner que tous les exemples ici ont été testés sur une machine Ubuntu 18.04 LTS.

Tutoriel manpath de Linux

La commande manpath dans Linux vous aide à déterminer le chemin de recherche pour les pages de manuel. Voici sa syntaxe :

manpath [-qgdc?V] [-m system[,...]] [-C file]

Et voici comment la page de manuel de l’outil la décrit :

       Si  $MANPATH est défini, manpath affichera simplement son contenu et émettra  
       un avertissement.  Sinon, manpath déterminera un chemin de recherche hiérarchique  
       de pages de manuel approprié et affichera les résultats.

       Le  chemin  délimité par des deux-points  est déterminé à l'aide des informations  
       obtenues à partir du fichier de configuration man-db - (/etc/manpath.config)  et  de  l'environnement  de  l'utilisateur.

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

Q1. Comment fonctionne la commande manpath ?

L’utilisation de base est assez simple - il suffit d’exécuter ‘manpath’ sans aucune option.

manpath

Par exemple, voici ce que la commande ci-dessus a produit comme sortie sur mon système :

/usr/local/man:/usr/local/share/man:/usr/share/man

Vous pouvez donc voir que manpath produit une liste de chemins pour les pages de manuel, séparée par des deux-points.

Notez que vous pouvez utiliser l’option de ligne de commande -g si vous souhaitez produire un manpath composé de tous les chemins nommés ‘global’ dans le fichier de configuration man-db.

Q2. Comment avoir catpath dans la sortie au lieu de manpath ?

Pour cela, utilisez l’option de ligne de commande -c.

manpath -c

Voici comment la page de manuel de l’outil explique cette opération :

Une fois que le manpath est déterminé, chaque élément de chemin est converti en son catpath relatif.

Par exemple, voici la sortie produite sur mon système :

/var/cache/man/oldlocal:/var/cache/man/local:/var/cache/man

Q3. Comment faire en sorte que manpath imprime des informations de débogage ?

Pour cela, utilisez l’option de ligne de commande -d.

manpath -d

Par exemple, voici la sortie que cette commande a produite sur mon système :

D’accord, vous ne pouvez pas utiliser cette option très fréquemment, mais vous devriez au moins en être conscient au cas où vous auriez besoin de déboguer la sortie de l’outil.

Q4. Comment faire en sorte que manpath accède aux hiérarchies de manuels d’autres systèmes d’exploitation ?

Pour cela, utilisez l’option de ligne de commande -m. Voici comment la page de manuel de l’outil explique cette option :

-m system[,...], --systems=system[,...]  
                
              Si  ce  système  a accès à d'autres hiérarchies de manuels de systèmes  
              d'exploitation, cette option peut être utilisée pour  
              les inclure dans la sortie de manpath.  Pour inclure  
              les hiérarchies de pages de manuel de NewOS, utilisez  l'option  -m  
              NewOS.

              Le  système  spécifié peut être une combinaison de noms de systèmes  
              d'exploitation délimités par des virgules.   Pour inclure  les  
              hiérarchies de pages de manuel du système d'exploitation natif,  
              le nom du système man doit être inclus dans la chaîne d'arguments.  
              Cette option remplacera la variable d'environnement $SYSTEM.

Q5. Comment faire en sorte que manpath utilise un fichier de configuration personnalisé ?

Par défaut, manpath récupère des informations à partir du fichier suivant :

/etc/manpath.config

Cependant, si vous le souhaitez, vous pouvez forcer manpath à lire un autre fichier. Cela peut être fait en utilisant l’option de ligne de commande -C.

manpath -C NEWFILE-PATH

Conclusion

Si votre travail en ligne de commande Linux implique de traiter avec des pages de manuel, la commande manpath est un outil utile pour vous. Ici, dans ce tutoriel, nous avons discuté de la majorité des options de ligne de commande de manpath. Pour plus d’infos sur l’outil, rendez-vous sur sa page de manuel.