NAME

whereis − locate source, binary, and or manual for program

SYNOPSIS

whereis [ options ] filenames

DESCRIPTION

Whereis locates source/binary and manuals sections for specified files.  The supplied names are first stripped of leading pathname components and any (single) trailing extension of the form “.ext”, e.g. “.c”.  Prefixes of “s.” resulting from use of source code control are also dealt with.  Whereis then attempts to locate the desired program in a list of standard places. 

OPTIONS

−b Searches only for binaries. 

−B dir Searches for binaries in the specified directory or directories. 

−f Terminates the last such directory list and signal the start of filenames. 

−m Searches only for manual sections respectively. 

−M dir Searches for manual entries in the specified directory or directories. 

−s Searches only for sources. 

−S dir Searches for sources in the specified directory or directories. 

−u Searches for unusual entries.  A file is said to be unusual if it does not have one entry of each requested type.  Thus “whereis -m -u ∗” asks for those files in the current directory which have no documentation. 

EXAMPLE

The following set of commands find all the files in /usr/bin which are not documented in /usr/man/man1 with source in /usr/src/cmd:

cd /usr/ucb
whereis −u −M /usr/man/man1 −S /usr/src/cmd −f ∗

FILES

/usr/src/∗
/usr/{doc,man}/∗
/lib, /etc, /usr/{lib,bin,ucb,old,new,local}

BUGS

Since the program uses chdir(2) to run faster, pathnames given with the −M −S and −B must be full; i.e. they must begin with a “/”. 

3rd Berkeley Distribution  —  May 7, 1986