The whatis
command is used to query the manual pages for a brief description of the function of a given command. This command is particularly useful when you are unfamiliar with a command and need to get a quick overview of what it does.
Overview
The syntax for the whatis
command is:
whatis [options] keyword
The keyword
argument is the name of the command you want to look up. When you run the whatis
command, it searches through the manual pages for a brief description of the command and prints it to the terminal.
For example, to look up the ls
command, you would run:
whatis ls
This would produce output similar to the following:
ls (1) - list directory contents
The number in parentheses after the command name indicates the section of the manual where the command is documented. In this case, ls
is documented in section 1 of the manual.
Options
The following table lists the available options for the whatis
command:
Option | Description |
---|---|
-r |
Search for regular expressions instead of exact matches. |
-s section |
Only search for matches in the specified manual section. |
-w |
Search for whole words only. |
Troubleshooting Tips
One common issue with the whatis
command is that it may not find the command you are looking for if the command is not installed on your system. Make sure that the command you are trying to look up is installed before using the whatis
command.
Another issue is that the whatis
command may not find a match if the command is spelled incorrectly or if the keyword argument is not a command at all. Double-check the spelling of the command and make sure that it is a valid command before using whatis
.
Notes
The whatis
command is a quick and easy way to get a brief overview of what a command does. Keep in mind that the description provided by whatis
is usually very brief and may not provide enough information to fully understand how to use the command. For more detailed information, you should consult the manual pages for the command.