Ligne de Commande · Leçon 17

whatis

Apprenez à obtenir de brèves descriptions de pages de manuel et à interpréter leurs numéros de section.

Lorsque vous reconnaissez le nom d'une commande, mais avez oublié son rôle, whatis fournit un bref rappel provenant de la base des pages de manuel.

Rechercher un nom exact

Fournissez un ou plusieurs noms de sujets exacts à whatis. Chaque résultat provient de la section NAME d'une page de manuel installée :

$ whatis cat
cat (1)              - concatenate files and print on the standard output

La sortie est une description et non une liste d'options ou d'exemples. Utilisez man cat ou cat --help pour davantage de détails.

Vous connaissez le nom cat et voulez sa description de manuel en une ligne. Quelle commande faut-il exécuter ?

Lire les numéros de section

Si un sujet possède des pages dans plusieurs sections, whatis peut afficher plusieurs résultats :

$ whatis passwd
passwd (1)           - change user password
passwd (5)           - the password file

Le nombre entre parenthèses est la section du manuel. Ici, passwd(1) décrit la commande utilisateur et passwd(5) un format de fichier. Ouvrez l'une d'elles avec man 1 passwd ou man 5 passwd.

Dans la sortie passwd (5) - the password file, que désigne (5) ?

Choisir entre whatis, man et apropos

whatis NAME : afficher les descriptions concises d'un nom exact de sujet ;
man NAME : ouvrir une page de manuel complète ;
apropos KEYWORD : rechercher un mot-clé dans les noms et descriptions des pages.

Par exemple :

$ apropos password

Utilisez apropos lorsque vous connaissez la tâche, mais pas le nom de la commande. Utilisez whatis lorsque vous connaissez déjà ce nom.

Vous ignorez le nom de la commande, mais voulez rechercher le mot-clé password dans les descriptions des manuels. Quelle commande convient ?

Lorsqu'aucune description n'apparaît

Si whatis ne trouve rien d'approprié, le sujet peut ne pas posséder de page installée ou la base peut être obsolète. Ce résultat ne prouve pas qu'aucun exécutable, alias, fonction ou commande intégrée de ce nom n'existe. Utilisez type NAME pour savoir comment Bash le résout, puis choisissez la source d'aide appropriée.

whatis deploy ne trouve aucune description. Quelle commande vérifie si Bash résout deploy comme alias, fonction, commande intégrée ou exécutable ?

Leçon terminée

Vous avez terminé whatis

Vous savez maintenant récupérer et interpréter les descriptions concises de la base des manuels.

Rechercher un sujet exact avec whatis.
Lire la section du manuel entre parenthèses.
Utiliser man pour la page complète.
Utiliser apropos lorsque vous connaissez un mot-clé plutôt qu'un nom.

Conservez votre progression

Créez un compte gratuit pour enregistrer cette leçon et continuer sur n'importe quel appareil.

Créer un compte gratuit

Leçon Suivante

Retour à Ligne de Commande