whereis(1)


NAME

whereis - locate the binary, source, and manual page files for a command

SYNOPSIS

whereis [ -bmsu ] [ -BMS directory ... -f ] filename ...

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, for example, .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 Linux places:

/bin
/usr/bin
/etc
/usr/etc
/sbin
/usr/sbin
/usr/games
/usr/games/bin
/usr/emacs/etc
/usr/lib/emacs/19.22/etc
/usr/lib/emacs/19.23/etc
/usr/lib/emacs/19.24/etc
/usr/lib/emacs/19.25/etc
/usr/lib/emacs/19.26/etc
/usr/lib/emacs/19.27/etc
/usr/lib/emacs/19.28/etc
/usr/lib/emacs/19.29/etc
/usr/lib/emacs/19.30/etc
/usr/TeX/bin
/usr/tex/bin
/usr/interviews/bin/LINUX
/usr/bin/X11
/usr/X11/bin
/usr/X11R5/bin
/usr/X11R6/bin
/usr/X386/bin
/usr/local/bin
/usr/local/etc
/usr/local/sbin
/usr/local/games
/usr/local/games/bin
/usr/local/emacs/etc
/usr/local/TeX/bin
/usr/local/tex/bin
/usr/local/bin/X11

/usr/contrib", /usr/hosts", /usr/include",
/usr/g++-include",

OPTIONS

-b
Search only for binaries.

-m
Search only for manual sections.

-s
Search only for sources.

-u
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.

-B
Change or otherwise limit the places where whereis searches for binaries.

-M
Change or otherwise limit the places where whereis searches for manual sections.

-S
Change or otherwise limit the places where whereis searches for sources.

-f
Terminate the last directory list and signals the start of file names, and must be used when any of the -B , -M , or -S options are used.

EXAMPLE

Find all files in /usr/bin which are not documented in /usr/man/man1 with source in /usr/src :

example% cd /usr/bin
example% whereis -u -M /usr/man/man1 -S /usr/src -f *

FILES

/{bin,sbin,etc}

/usr/{lib,bin,old,new,local,games,include,etc,src,man,sbin,
X386,TeX,g++-include}

/usr/local/{X386,TeX,X11,include,lib,man,etc,bin,games,
emacs}

SEE ALSO

chdir (2V)

BUGS

Since whereis uses chdir (2V) to run faster, pathnames given with the -M , -S , or -B must be full; that is, they must begin with a ` / '.