whereis(1) — AIX PS/2 1.2.1



WHEREIS(1,C)                AIX Commands Reference                 WHEREIS(1,C)



-------------------------------------------------------------------------------
whereis



PURPOSE

Locates source, binary and/or manual for program.

SYNTAX


           +--------+   +---------------------+
whereis ---| +----+ |---|   +--------+        |--- name ---|
           +-| -s |-+   +---| -S dir |--- -f -+
            ^| -b ||      ^ | -B dir | |
            || -m ||      | | -M dir | |
            || -u ||      | +--------+ |
            |+----+|      +------------+
            +------+


DESCRIPTION

The whereis command locates source/binary and manuals sections for specified
files.  The supplied names are first stripped of leading path name components
and any (single) trailing extension of the form ".ext", for example ".c".
Prefixes of "s." resulting from use of source code control are also dealt with.
The whereis command 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 the whereis
command 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.

Finally, the -B, -M, and -S flags may be used to change or otherwise limit the
places where whereis searches.  The -f file flag is used to terminate the last
such directory list and signal the start of file names.

Note:  Since the program uses chdir to run faster, path names given with the
       -M, -S and -B must be full; they must begin with a /.

EXAMPLES

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/bin

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




Processed November 8, 1990       WHEREIS(1,C)                                 1



WHEREIS(1,C)                AIX Commands Reference                 WHEREIS(1,C)



FILES

   /usr/src/*
   /usr/{doc,man}/*
   /lib, /etc, /usg, /usr/{lib,bin,ucb,lpp}


















































Processed November 8, 1990       WHEREIS(1,C)                                 2

Museum