


      WWWWHHHHEEEERRRREEEEIIIISSSS((((1111))))                  ((((bbbbssssdddd 4444....2222))))                  WWWWHHHHEEEERRRREEEEIIIISSSS((((1111))))



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

      SSSSYYYYNNNNTTTTAAAAXXXX
           wwwwhhhheeeerrrreeeeiiiissss [ ----ssssbbbbmmmm ] [ ----uuuu ] [ ----SSSSBBBBMMMM dir ...  ----ffff ] name ...

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _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
           extension 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 ----bbbb,,,, ----ssss
           or ----mmmm flags are given then _w_h_e_r_e_i_s searches only for
           binaries, sources or manual sections respectively (or any
           two thereof).  The ----uuuu 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 ----BBBB ----MMMM and ----SSSS flags may be used to change or
           otherwise limit the places where _w_h_e_r_e_i_s searches.  The ----ffff
           file flags is used to terminate the last such directory list
           and signal the start of file names.

      EEEEXXXXAAAAMMMMPPPPLLLLEEEE
           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 *

      FFFFIIIILLLLEEEESSSS
           /usr/src/*
           /usr/{doc,man}/*
           /lib, /etc, /usr/{lib,bin,ucb,old,new,local}

      BBBBUUUUGGGGSSSS
           Since the program uses _c_h_d_i_r(2) to run faster, pathnames
           given with the ----MMMM ----SSSS and ----BBBB must be full; i.e. they must
           begin with a ``/''.












      Page 1                                                   (9010-E)



