NAME
which
—
locate a program file (or files) in the
path
SYNOPSIS
which |
[-a ] name ... |
DESCRIPTION
which
takes a list of names and looks for
the files which would be executed had these names been given as commands.
Each argument is searched for along the user's path.
If the -a
flag is given,
which
will return a list of all matches instead of
just the first match.
ENVIRONMENT
The following environment variables affect the execution of
which
:
PATH
- A colon-separated list of directories in which to find executables. If
PATH
is not set, and the given name is not a fully qualified or relative pathname,which
will fail.
EXIT STATUS
The which
utility exits with one of the
following values:
- 0
- All names were successfully resolved.
- 1
- Some names were resolved but not all.
- 2
- No names were resolved.
DIAGNOSTICS
A diagnostic is given if an executable file with the argument name was not found in the path.
SEE ALSO
STANDARDS
which
also exists as a built-in to
csh(1), though with a different syntax.
HISTORY
A which
command first appeared in
3.0BSD.
The -a
option first appeared in
OpenBSD 2.3.