WHEREIS(1)							    WHEREIS(1)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     whereis [ -sbm ] [	-u ] [ -P ] [ -SBM dir ...  -f ] name ...

DESCRIPTION    [Toc]    [Back]

     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.

     The -P flag may be	used to	add the	paths specified	by the environment
     variables PATH and	MANPATH	to the list of standard	places to search.

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     /sbin, /etc
     /lib, /lib32, /lib64
     /usr/{bin,	sbin, bsd, ucb,	etc, games, demos, lbin}
     /usr/{lib,	lib32, lib64}
     /usr/local/{bin, etc, lib}
     /usr/bin/X11
     /usr/freeware/{bin, lib, lib32, lib64}
     /usr/share/catman/*
     /usr/share/man/*
     /usr/catman/*
     /usr/man/*
     /usr/freeware/catman/*
     /usr/src/cmd







									Page 1






WHEREIS(1)							    WHEREIS(1)



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 ``/''.


									PPPPaaaaggggeeee 2222