WHEREIS(1) WHEREIS(1)
NAME
whereis - locate source, binary, and or manual for program
SYNOPSIS
whereis [ -sbm ] [ -u ] [ -SBM dir ... -f ] name ...
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. 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
documentation.
Finally, the -B , -M , and -S flags may be used to change or
otherwise limit the places where whereis searches. The -f
file flags is used to terminate the last such directory list
and signal the start of file names.
EXAMPLE
The following finds all the files in /usr/bin which are not
documented in /usr/man/u_man/man1 with source in
/usr/src/cmd:
cd /usr/bin
whereis -u -M /usr/man/u_man/man1 -S /usr/src/cmd -f *
FILES
/bin, /etc, /lib
/usr/{bin, sbin, bsd, etc, games, demos, lib, lbin}
/usr/local/{bin, etc, lib}
/usr/man/u_man/{man1, man2, man3, man4, man5, man6}
/usr/man/a_man/{man1, man7}
/usr/src/cmd
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 ``/''.
ORIGIN
4.2 BSD
Page 1 (last mod. 8/20/87)