which¶
Shows which program file is run when you type a command.

Syntax¶
which [-as] COMMAND...
Options¶
| Option | Description |
|---|---|
-a |
Show all matching programs in $PATH, not only the first one |
-s |
Print nothing, only return the exit status (0 found, 1 not found) |
Examples¶
Find out where a program is located:
which python3
/usr/bin/python3
Show all matches in the search path:
which -a ls
/usr/bin/ls
/bin/ls
On all current distributions, /bin is a link to /usr/bin. On Debian and Ubuntu, both
are in $PATH, so the same program is listed twice.
Check several commands at once:
which git curl rsync
/usr/bin/git
/usr/bin/curl
/usr/bin/rsync
A command that is not installed:
which nmap
echo $?
1
Find out what a command really is (with type):
which cd
type cd
type ls
cd is a shell builtin
ls is aliased to `ls --color=auto'
which only searches for program files. cd is built into the shell, so which finds
nothing. The shell builtin type also knows builtins, aliases and functions.
When do I need it?¶
- To check whether a program is installed and in your
$PATH - When several versions are installed (e.g. in
/usr/local/binand/usr/bin) and you want to know which one runs - To get the full path for a cron job, a systemd unit or a
sudoersrule, where you should always use absolute paths
In scripts: command -v
To check in a script whether a program exists, use the shell builtin command -v.
It works the same way on every system:
if command -v docker > /dev/null; then echo "Docker is installed"; fi
Commands in /usr/sbin
which only searches the directories in your $PATH. Admin programs like nginx
or sshd are in /usr/sbin, which is not always in the $PATH of normal users.
which then finds nothing, although the program is installed. whereis
finds it anyway.
Distribution differences¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Program | which from debianutils |
which from debianutils |
GNU which |
GNU which |
| Options | only -a and -s |
only -a and -s |
many more, e.g. --skip-alias |
many more, e.g. --skip-alias |
| Not found | no output, exit status 1 |
no output, exit status 1 |
message which: no nmap in (...) |
message which: no nmap in (...) |