Home > Environment & Utility > whatis

whatis: Check Command Summary Information

The whatis command displays a one-line manual page description for a given keyword. This is useful for quickly understanding the function or purpose of a specific command. It provides the same information as the first line of a man page, helping you get a brief overview before diving into the details.

Overview

`whatis` searches the manual page database for installed commands, functions, and file formats, and outputs a brief description of the matching entries. This is suitable for quickly checking what a command does before opening its full manual page with the `man` command.

Key Features

  • Provides a one-line summary for commands/functions/file formats
  • Searches the manual page database
  • Supports quick information retrieval

Key Options

The `whatis` command offers several useful options to control the search behavior or specify particular manual sections.

Search and Output

Generated command:

Try combining the commands.

Description:

`whatis` Executes the command.

Combine the above options to virtually execute commands with AI.

Usage Examples

Various examples of how to use the `whatis` command.

Basic Usage

whatis ls

Check the summary information for the `ls` command.

Wildcard Search

whatis -w 'grep*'

Find summary information for all commands starting with `grep`.

Search Specific Sections

whatis -s 1,5 passwd

Check information for the `passwd` command in user commands (section 1) and file formats (section 5).

Regular Expression Search

whatis -r 'user|group'

Search for commands containing 'user' or 'group' using a regular expression.

Tips & Notes

Useful tips and points to note when using `whatis`.

Database Updates

whatis uses a manual page database. If new manual pages are installed or existing ones are updated, whatis might not find the information. In such cases, you need to update the database by running the sudo mandb command.

Update Manual Database

sudo mandb

Manually update the `whatis` database.

Difference from apropos

whatis searches for the first line of the manual page for the exact keyword specified, whereas apropos (equivalent to man -k) searches for keywords within the names and descriptions of manual pages. Therefore, apropos provides broader search results.



Same category commands