version 1.3, 1997/01/07 15:57:48 |
version 1.4, 1997/02/21 18:34:59 |
|
|
.\" |
.\" |
.\" from: @(#)which.1 6.3 (Berkeley) 4/23/91 |
.\" from: @(#)which.1 6.3 (Berkeley) 4/23/91 |
.\" |
.\" |
.Dd April 23, 1991 |
.Dd February 21, 1997 |
.Dt WHICH 1 |
.Dt WHICH 1 |
.Os BSD 3 |
.Os |
.Sh NAME |
.Sh NAME |
.Nm which |
.Nm which |
.Nd "locate a program file including aliases and paths" |
.Nd "locate a program file (or files) in the path" |
.Pq Xr csh 1 |
|
only) |
|
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm which |
.Nm which |
.Op Ar name |
.Op Ar name |
|
|
.Nm Which |
.Nm Which |
takes a list of names and looks for the files which would be |
takes a list of names and looks for the files which would be |
executed had these names been given as commands. |
executed had these names been given as commands. |
Each argument is expanded if it is aliased, |
Each argument is searched for along the user's path. |
and searched for along the user's path. |
.Sh RETURN VALUES |
Both aliases and path are taken from the user's |
|
.Pa \&.cshrc |
|
file. |
|
.Pp |
|
The |
The |
.Nm which |
.Nm |
utility exits with one of the following values: |
utility exits with one of the following values: |
.Bl -tag -width 4n |
.Bl -tag -width 4n |
.It 0 |
.It 0 |
|
|
Some names got resolved but not all. |
Some names got resolved but not all. |
.It 2 |
.It 2 |
No names got resolved. |
No names got resolved. |
|
.It -1 |
|
A system error occurred. |
.El |
.El |
.Sh FILES |
|
.Bl -tag -width ~/\&.cshrc |
|
.It Pa ~/\&.cshrc |
|
source of aliases and path values |
|
.El |
|
.Sh DIAGNOSTICS |
.Sh DIAGNOSTICS |
A diagnostic is given for names which are aliased to more than a single |
A diagnostic is given if an executable file with the argument |
word, |
name was not found in the path. |
or if an executable file with the argument name was not found in the path. |
.Sh ENVIRONMENT VARIABLES |
.Sh BUGS |
.Bl -tag -width PATH |
Must be executed by a |
.It Ev PATH |
|
.Nm |
|
uses the environment variable |
|
.Ev PATH |
|
as a colon-separated list of directories in which to find executables. |
|
If |
|
.Ev PATH |
|
is not set, and the given name is not a fully-qualified |
|
or relative pathname, |
|
.Nm |
|
will fail. |
|
.El |
|
.Sh CAVEATS |
|
The |
|
.Nm |
|
command formerly was a |
|
.Xr csh 1 |
|
script and could expand aliases. |
|
.Xr csh 1 |
|
now has a built-in |
|
.Nm |
|
comand so this version is intended for use |
|
with other shells like |
|
.Xr sh 1 . |
|
.Sh SEE ALSO |
.Xr csh 1 , |
.Xr csh 1 , |
or some other shell which knows about aliases. |
.Xr sh 1 , |
|
.Xr environ 7 |
.Sh HISTORY |
.Sh HISTORY |
The |
A |
.Nm |
.Nm |
command appeared in |
command appeared in |
.Bx 3.0 . |
.Bx 3.0 . |