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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | BUGS | AUTHOR

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

home | help