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

Dans Linux, si vous avez besoin d’aide concernant une commande, il vous suffit d’ouvrir sa page de manuel. Mais que faire si une situation se présente où il est nécessaire de rechercher rapidement les noms et descriptions de toutes les pages de manuel disponibles ? Eh bien, Linux a ce qu’il vous faut, car il existe une commande appelée apropos qui fait exactement cela pour vous.

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

La commande apropos recherche les noms et descriptions des pages de manuel pour un mot-clé fourni par l’utilisateur. Voici sa syntaxe :

apropos [OPTIONS] mot-clé ...

Et voici ce que dit la page de manuel de l’outil à son sujet :

       Chaque page de manuel a une courte description disponible à l'intérieur.   apropos  
       recherche les descriptions pour des instances de mot-clé.  
       
       mot-clé est généralement une expression régulière, comme si (-r) était utilisé, ou peut  
       contenir des caractères génériques (-w), ou correspondre au mot-clé exact (-e).   En utilisant ces  
       options, il peut être nécessaire de mettre le mot-clé entre guillemets ou d'échapper (
) les  
       caractères spéciaux pour empêcher le shell de les interpréter.  
       
       Les règles de correspondance standard permettent de faire des correspondances contre le nom de la page  
       et les limites de mots dans la description.  
       
       La base de données recherchée par apropos est mise à jour par le programme mandb.  
       Selon votre installation, cela peut être exécuté par un travail cron périodique,  
       ou peut devoir être exécuté manuellement après que de nouvelles pages de manuel ont été  
       installées.

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 apropos.

Q1. Comment utiliser apropos ?

L’utilisation de base est simple. Il suffit de passer le mot-clé que vous souhaitez rechercher en entrée à la commande apropos.

Par exemple :

apropos dmesg

produit le résultat suivant :

dmesg (1)            - imprimer ou contrôler le tampon circulaire du noyau

Bien sûr, vous pouvez également passer plusieurs mots-clés.

Par exemple :

apropos dmesg whereis

Voici la sortie dans ce cas :

dmesg (1)            - imprimer ou contrôler le tampon circulaire du noyau  
whereis (1)          - localiser les fichiers binaires, sources et pages de manuel pour un...

Q2. Comment faire en sorte qu’apropos recherche des mots-clés exacts ?

Par défaut, l’entrée que vous passez à la commande apropos n’est pas recherchée exactement. Par exemple, si vous passez ‘who’ comme entrée, vous verrez également l’outil produire des résultats contenant des mots comme ‘whoami’.

Donc, ce n’est pas une recherche exacte. Cependant, vous pouvez forcer apropos à rechercher des mots-clés exacts en utilisant les options de ligne de commande -e ou –exact.

Ainsi, vous voyez maintenant que seules les entrées qui correspondent exactement à ‘who’ ont été affichées dans la sortie.

Q3. Comment faire en sorte qu’apropos affiche les entrées correspondant à tous les mots-clés ?

Si vous passez plusieurs mots-clés en entrée à la commande apropos, l’outil affichera des entrées qui correspondent/contiennent au moins un des mots-clés. Cependant, si vous souhaitez qu’apropos produise uniquement les entrées qui correspondent/contiennent tous les mots-clés, utilisez l’option de ligne de commande -a.

Par exemple, voici la sortie d’une commande apropos sans l’option -a :

Et voici la sortie avec l’option -a activée :

Q4. Comment forcer apropos à ne pas tronquer la sortie ?

Comme vous l’avez vu dans les sorties des Q&A précédents, l’outil tronque les entrées si elles sont trop longues. Par exemple, voyez la ligne surlignée dans la sortie suivante :

Cependant, si vous le souhaitez, vous pouvez forcer apropos à produire des lignes complètes dans la sortie, ce que vous pouvez faire en utilisant l’option de ligne de commande -l.

Q5. Comment interpréter le statut de sortie d’apropos ?

La commande apropos produit quatre statuts de sortie différents : 0, 1, 2 et 16. Voici ce que chacun d’eux représente :

       0      Exécution réussie du programme.  
       1      Erreur d'utilisation, de syntaxe ou de fichier de configuration.  
       2      Erreur opérationnelle.  
       16     Rien n'a été trouvé correspondant aux critères spécifiés

Conclusion

Selon votre profil de travail, vous n’aurez peut-être pas besoin de la commande apropos au quotidien, mais comme vous l’avez compris jusqu’à présent, cela pourrait être un sauveur dans certaines situations. Nous avons discuté de quelques options de ligne de commande ici. Pour en savoir plus sur l’outil, rendez-vous sur sa page de manuel.