Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
WHEREIS(1)		  BSD General Commands Manual		    WHEREIS(1)

NAME
     whereis --	locate programs

SYNOPSIS
     whereis [-bms] [-u] [-BMS -dir -... -f] program ...

DESCRIPTION
     The whereis utility checks	the standard binary, manual page, and source
     directories for the specified programs, printing out the paths of any it
     finds.  The supplied names	are first stripped of leading path name	compo-
     nents, any	single trailing	extension added	by gzip(1) or compress(1), and
     the leading `s.' or trailing `,v' from a source code control system.

     The default path searched is the string returned by the sysctl(8) utility
     for the "user.cs_path" string, with /usr/libexec and the current user's
     $PATH appended.  Manual pages are searched	by default along the $MANPATH.
     Program sources are located in a list of known standard places, including
     all the subdirectories of /usr/src	and /usr/ports.

     The following options are available:

     -B	     Specify directories to search for binaries.  Requires the -f op-
	     tion.

     -M	     Specify directories to search for manual pages.  Requires the -f
	     option.

     -S	     Specify directories to search for program sources.	 Requires the
	     -f	option.

     -b	     Search for	binaries.

     -f	     Delimits the list of directories after the	-B, -M,	or -S options,
	     and indicates the beginning of the	name list.

     -m	     Search for	manual pages.

     -s	     Search for	source directories.

     -u	     Search for	"unusual" entries.  A file is said to be unusual if it
	     does not have one entry of	each requested type.

EXAMPLES
     The following finds all utilities under /usr/bin that do not have docu-
     mentation:
	   whereis -m -u /usr/bin/*

SEE ALSO
     find(1), locate(1), man(1), which(1), sysctl(8)

BUGS
     The search	for sources is implemented as a	quick search as	the first-
     level subdirectory	of each	element	of the list of source directories
     first.  If	this didn't succeed, the utility locate(1) is requested	to do
     the search	in deeper nested subdirectories.  This might take some time,
     and will only succeed if the locate database is up-to-date.

HISTORY
     The whereis command appeared in 3.0BSD.  This version re-implements the
     historical	functionality that was lost in 4.4BSD.

BSD				 June 15, 1996				   BSD

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | BUGS | HISTORY

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=whereis&sektion=1&manpath=FreeBSD+4.9-RELEASE>

home | help