NAME

whereis − locate source, binary, and/or manual for program

SYNOPSIS

whereis [−bsm] [−u] [−BMS dir ... −f] name ... 

DESCRIPTION

whereis 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, such as .c.  Prefixes of s.  resulting from use of SCCS are also dealt with.  whereis then attempts to locate the desired program in a list of standard places.  If any of the −b, −s, or −m flags are given, whereis searches only for binaries, sources or manual sections, respectively (or any two thereof).  The −u flag can 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 that have no documentation. 

Finally, the −B, −M and −S flags can 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. 

EXTERNAL INFLUENCES

International Code Set Support

Single- and multi-byte character code sets are supported. 

EXAMPLES

The following finds all the files in /usr/bin that 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 ∗

WARNINGS

Since the program uses chdir(2) to run faster, path names given with the −B, −M, and −S flags must be absolute path names. 

AUTHOR

whereis was developed by the University of California, Berkeley. 

FILES

/usr/src/∗
/bin, /etc, /lib, /usr/{bin, games, lib}
/usr/man/∗
/usr/local/{man/∗, bin, games, include, lib}
/usr/contrib/{man/∗, bin, games, include, lib}
/usr/man/$LANG/*
/usr/local/man/$LANG/*
/usr/contrib/man/$LANG/*

Hewlett-Packard Company  —  HP-UX Release 8.05: June 1991