whereis - Manpage - Tux24 Net - Linux Unix Network
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z




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

SYNOPSIS
    whereis [ -bmsu ] [ -BMS directory... -f ] filename ...

DESCRIPTION
    whereis 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, for example, .c.
    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 Linux places.

OPTIONS
    -b   Search only for binaries.

    -m   Search only for manual sections.

    -s   Search only for sources.

    -u   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 direc-
    tory which have no documentation.

    -B   Change or otherwise limit the places where whereis searches for
    binaries.

    -M   Change or otherwise limit the places where whereis searches for
    manual sections.

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

    -f   Terminate  the last directory list and signals the start of file
    names, and must be used when any of the -B, -M, or -S options
    are used.

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

    example% cd /usr/bin
    example% whereis -u -M /usr/man/man1 -S /usr/src -f *

FILES
    /{bin,sbin,etc}

    /usr/{lib,bin,old,new,local,games,include,etc,src,man,sbin,
     X386,TeX,g++-include}

    /usr/local/{X386,TeX,X11,include,lib,man,etc,bin,games,emacs}

SEE ALSO
    chdir(2V)

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

    whereis has a hard-coded path, so may not always find what you're look-
    ing for.