DragonFly On-Line Manual Pages

Search: Section:  

PSEARCH(1)             DragonFly General Commands Manual            PSEARCH(1)


NAME

       psearch - search the FreeBSD ports


SYNOPSIS

       psearch [options] PATTERN [PATTERN ...]


DESCRIPTION

       Searches ports for PATTERN. PATTERN is a case-insensitive regular
       expression).  If there is more than one PATTERN, each of them is
       searched for. By default, ports are shown that match all patterns.

       By default, the name and the short description are searched. If you
       specify the -s option, then the long description is searched as well.
       Since this will slow down searching substantially, it is recommended
       that the -c option is also used to reduce the number of pkg-descr files
       that need to be searched.

       psearch uses IEEE Std 1003.2 (``POSIX.2'') regular expressions as
       explained 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,
              especially when --search_long is also specified

       -f FILE, --file=FILE
              Path to INDEX file. The default is the default location of the
              INDEX file on the FreeBSD system that psearch runs on. Non-
              standard locations that are specified in /etc/make.conf are
              ignored.

       -l, --long
              Display long description (pkg-descr file) for any match found.
              Does not automatically search the long description.

       -m, --maintainer
              Display the maintainer's email address instead of the short
              description for any match found, and switch on searching the
              maintainer'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
              Search for ports that match any PATTERN, instead of all of them.
              in other words, OR the PATTERNs, instead of ANDing them.

       -s, --search_long
              Search long descriptions (pkg-descr file), which slows down
              searching. Does not automatically display the long description.

       -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 (http://public.xdi.org/=Benjamin.Lutz)

psearch 2.0.2                      June 2012                        PSEARCH(1)

Search: Section: