whereis(1)                                             whereis(1)



NAME
     whereis - reports the locations of the source,  binary,  and
     online help files for a specified command

SYNOPSIS
     whereis [-b] [-B dir [-f]] [-m] [-M dir [-f]] [-s]
     [-S dir [-f]] [-u] file...

ARGUMENTS
     -b   Searches only for binaries.

     -B dir
          Searches in the specified directory, dir, for binaries.

     -f   Terminates the last specified directory list and
          signals the start of the filenames.

     -m   Searches only for manual sections.

     -M dir
          Searches in the specified directory, dir, for manual
          sections.

     file Specifies the file to be located.

     -s   Searches only for sources.

     -S dir [-f]
          Searches in the specified directory, dir, for sources.

     -u   Searches for unusual entries.  A file is considered
          unusual if it does not have one entry of each requested
          type.

DESCRIPTION
     whereis locates source, binary, and manual sections for
     specified files.  The supplied file(s) are first stripped of
     leading pathname components and standard extensions for
     source files and manual entries (such as .c and .1m).
     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.

EXAMPLES
     To ask for those files in the current directory which have
     no documentation, enter:

        whereis -m -u *

     The following finds all the files in /usr/bin which are not
     documented in /usr/man/man1 with source in /usr/src/cmd:




January 1992                                                    1

whereis(1)                                             whereis(1)



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


LIMITATIONS
     Since the program uses chdir to run faster, pathnames given
     with the -M, -S, and -B must be full; that is, they must
     begin with a /.

FILES
     /usr/bin/whereis
          Executable file
     /usr/src/*
          Source files
     /usr/catman/man/*
          Files containing on-line manual pages
     /bin Directory containing administrative binary files
     /lib Directory containing administrative library files
     /etc Directory containing administrative executable command
          files
     /usr/bin
          Directory containing user binary files
     /usr/lib
          Directory containing user library files
     /usr/etc
          Directory containing user executable command files
     /usr/ucb
          Directory containing user executable files

SEE ALSO
     whatis(1), which(1)
























2                                                    January 1992