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

FreeBSD Manual Pages

  
 
  

home | help
PSEARCH(1)		    General Commands Manual		    PSEARCH(1)

NAME
       psearch - search	the FreeBSD ports

SYNOPSIS
       psearch [options] PATTERN [PATTERN ...]

DESCRIPTION
       Lists ports whose description matches PATTERN. PATTERN is a case-insen-
       sitive regular expression.

       If  more	than one pattern is given, a port description has to match all
       of them for the port to be listed. If -o	is  given,  a  single  pattern
       match suffices instead.

       By  default,  the name and the short description	are searched. If -s is
       given, the long description is searched as  well,  which	 slows	things
       down  a lot. This can be	compensated for	by limiting searches to	a port
       category	with -c, thus reducing the number of pkg-plist files that need
       to be searched.

       psearch uses IEEE Std 1003.2 (``POSIX.2'') regular expressions  as  ex-
       plained by re_format(7).

OPTIONS
       -V, --version
	      Show program's version number and	exit.

       -h, --help
	      Show a brief help	message	explaining the options and exit.

       -c CATEGORY, --category=CATEGORY
	      Only  search  for	 ports in CATEGORY. Speeds up searching, espe-
	      cially when --search_long	is also	specified.

       -f FILE,	--file=FILE
	      Path to INDEX file. Defaults to the standard location of the IN-
	      DEX file on the FreeBSD system that psearch runs	on.  Non-stan-
	      dard locations given in /etc/make.conf are ignored.

       -l, --long
	      Display  the  long  description  (pkg-descr  file) for any match
	      found. They are not searched however,  unless  --search_long  is
	      also given.

       -m, --maintainer
	      Display  the maintainer's	email address instead of the short de-
	      scription	for any	match found, and switch	on searching the main-
	      tainer's email address.  Specifying this parameter and searching
	      for ports@freebsd.org displays all unmaintained ports.

       -n, --name
	      Print canonical name of a	port, including	its version.

       -o, --or
	      List ports whose description match any PATTERN, instead  of  re-
	      quiring it to match all of them.

       -s, --search_long
	      Search  long  descriptions  (pkg-descr  file),  which slows down
	      searching. The long descriptions are not displayed however,  un-
	      less --long is also given.

       -v INVERSE_PATTERN, --inverse=INVERSE_PATTERN
	      Searches	for  ports  that  do not match INVERSE_PATTERN.	May be
	      specified	several	times.

SEE ALSO
       re_format(7)

BUGS
       Any relevant values stored in environment variables  or	/etc/make.conf
       are  ignored.   This  means  that if your INDEX file does not reside in
       /usr/ports, you'll need to use the -f option when running psearch.

AUTHOR
       Benjamin	Lutz

psearch	2.0.2			   June	2012			    PSEARCH(1)

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

home | help