whereis¶
Finds the program file, configuration and man pages of a command in the standard system directories.

Syntax¶
whereis [OPTION]... NAME...
Options¶
| Option | Description |
|---|---|
-b |
Only search for program files (binaries) |
-m |
Only search for man pages |
-s |
Only search for source files |
-u |
Only show names with unusual entries (missing or multiple matches) |
-B DIR... -f |
Only search for programs in the given directories |
-M DIR... -f |
Only search for man pages in the given directories |
-l |
Show the directories that whereis searches |
Examples¶
Find program and man page of a command:
whereis ls
ls: /usr/bin/ls /usr/share/man/man1/ls.1.gz
Find everything that belongs to a service:
whereis nginx
nginx: /usr/sbin/nginx /usr/lib/nginx /etc/nginx /usr/share/nginx /usr/share/man/man8/nginx.8.gz
Only show program files and directories:
whereis -b ssh
ssh: /usr/bin/ssh /etc/ssh
Only show the man page:
whereis -m ssh
ssh: /usr/share/man/man1/ssh.1.gz
A program that is not installed:
whereis nmap
nmap:
When do I need it?¶
- To find the configuration directory of a service quickly (
/etc/nginx,/etc/ssh) - To check whether a program and its man page are installed
- To find admin programs in
/usr/sbinthatwhichdoes not find as a normal user
whereis vs. which
which only searches your $PATH and shows the program that really runs.
whereis searches a fixed list of system directories (/usr/bin, /usr/sbin,
/etc, /usr/share/man …) and also finds man pages and configuration.
Only standard directories
Programs in unusual places, such as /opt/app/bin, are not found by whereis.
Use locate or find for those.