[0m


WHEREIS(1)	    UNIX Programmer's Manual	       WHEREIS(1)



[1mNAME
     [0mwhereis - locate source, binary, and or manual for program

[1mSYNOPSIS
     whereis [0m[ [1m-sbm [0m] [ [1m-u [0m] [ [1m-SBM [0mdir ...  [1m-f [0m] name ...

[1mDESCRIPTION
     [0m_W_h_e_r_e_i_s locates source/binary and manuals sections for
     specified files.  The supplied names are first stripped of
     leading pathname components and any (single) trailing exten-
     sion of the form ``.ext'', e.g. ``.c''.  Prefixes of ``s.''
     resulting from use of source code control are also dealt
     with.  _W_h_e_r_e_i_s then attempts to locate the desired program
     in a list of standard places.  If any of the [1m-b, -s [0mor [1m-m
     [0mflags are given then _w_h_e_r_e_i_s searches only for binaries,
     sources or manual sections respectively (or any two
     thereof).	The [1m-u [0mflag 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 [1m-B -M [0mand [1m-S [0mflags may be used to change or
     otherwise limit the places where _w_h_e_r_e_i_s searches.  The [1m-f
     [0mfile flags is used to terminate the last such directory list
     and signal the start of file names.

[1mEXAMPLE
     [0mThe following finds all the files in /usr/bin which are not
     documented in /usr/share/man/man1 with source in
     /usr/src/cmd:

	  cd /usr/ucb
	  whereis -u -M /usr/share/man/man1 -S /usr/src/cmd -f *

[1mFILES
     [0m/usr/src/*
     /usr/{doc,man}/*
     /lib, /etc, /usr/{lib,bin,ucb,old,new,local}

[1mBUGS
     [0mSince the program uses _c_h_d_i_r(2) to run faster, pathnames
     given with the [1m-M -S [0mand [1m-B [0mmust be full; i.e. they must
     begin with a ``/''.











Printed 29/3/95     Revision 1.3 of 18/06/90			1



[0m