Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   6889 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

WHEREIS(1)			 User Commands			    WHEREIS(1)

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

SYNOPSIS
       whereis [options] [-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 directory which have no documentation.

       -B list
	      Change  or  otherwise  limit  the	 places	 where	whereis
	      searches	for  binaries  by white-space separated list of
	      directories.

       -M list
	      Change  or  otherwise  limit  the	 places	 where	whereis
	      searches	for  manual  sections  by white-space separated
	      list of directories.

       -S list
	      -S Change or otherwise limit  the	 places	 where	whereis
	      searches for sources white-space separated list of direc‐
	      tories.

       -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:

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

FILES
       whereis	has  basic  set of hard-coded paths (see below). If the
       option -B is not specified then also follows  $PATH  environment
       variable (since version 2.21).

       /{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
       `/'.

AVAILABILITY
       The whereis command is part of the  util-linux  package	and  is
       available from ftp://ftp.kernel.org/pub/linux/utils/util-linux/.

util-linux			   June 2012			    WHEREIS(1)

Vote for polarhome