whereis(1) whereis(1)
NAME
whereis - locate source, binary, and online help file for a
command
SYNOPSIS
whereis [-b] [-m] [-s] [-u] [-B dir [-f]] [-M dir [-f]] [-
S dir [-f]] name ...
DESCRIPTION
whereis locates source/binary and manual sections for speci-
fied files. The supplied names are first stripped of lead-
ing pathname components and standard extensions for source
files and manual entries, for example, .c and .1m. 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. If any of the -b, -s,
or -m flags are given, then whereis searches only for
binaries, sources, or manual sections respectively (or any
two thereof). The -u flag may be used to search 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 docu-
mentation.
Finally, the -B, -M, and -S flags may be used to change or
otherwise limit the places where whereis searches. The -f
file flag is used to terminate the last such directory list
and signal the start of file names.
EXAMPLES
The following finds 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/bin/whereis
/usr/src/*
/usr/catman/man/*
/bin
/lib
/etc
/usr/bin
/usr/lib
/usr/etc
/usr/ucb
SEE ALSO
whatis(1), which(1).
April, 1990 1
BUGS
Since the program uses chdir(2) to run faster, pathnames
given with the -M, -S, and -B must be full; that is, they
must begin with a /.
2 April, 1990