SunOS/BSD Compatibility Package Commands              whereis(1B)



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

SYNOPSIS
     /usr/ucb/whereis [-bmsu] [-BMS directory... -f] filename...


DESCRIPTION
     The whereis utility locates source/binary and  manuals  sec-
     tions  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. Pre-
     fixes 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:

       etc
       /sbin
       /usr/bin
       /usr/ccs/bin
       /usr/ccs/lib
       /usr/lang
       /usr/lbin
       /usr/lib
       /usr/sbin
       /usr/ucb
       /usr/ucblib
       /usr/ucbinclude
       /usr/games
       /usr/local
       /usr/local/bin
       /usr/new
       /usr/old
       /usr/hosts
       /usr/include
       /usr/etc



OPTIONS
     The following options are supported:

     -b    Searches only for binaries.


     -B    Changes or otherwise limits the places  where  whereis
           searches for binaries.


     -f    Terminates the last directory  list  and  signals  the
           start  of file names, and must be used when any of the



SunOS 5.11          Last change: 10 Jan 2000                    1






SunOS/BSD Compatibility Package Commands              whereis(1B)



           -B, -M, or -S options are used.


     -m    Searches only for manual sections.


     -M    Changes or otherwise limits the places  where  whereis
           searches for manual sections.


     -s    Searches only for sources.


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


     -u    Searches 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 documen-
           tation.


EXAMPLES
     Example 1 Finding files


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


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



FILES
         o    /usr/src/*

         o    /usr/{doc,man}/*

         o    /etc, /usr/{lib,bin,ucb,old,new,local}

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:








SunOS 5.11          Last change: 10 Jan 2000                    2






SunOS/BSD Compatibility Package Commands              whereis(1B)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWscpu                    
    


SEE ALSO
     chdir(2), attributes(5)

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









































SunOS 5.11          Last change: 10 Jan 2000                    3