NAME
      listpkg - List port name & origin installed via freebsd ports

SYNOPSIS
      listpkg -usage

      listpkg [ -show-dbdir ]
                   [ -dbdir=<installed package database directory> ]
                   [ -descr=<none | short | long> ]
                   [ -find=<port | origin> ]
                   [ -sort=<port | origin> ]
                   [ pattern ]

DESCRIPTION
      Listpkg produces port lists installed via freebsd ports.  First
      column contains the port origin, second port name, and optional third
      column has port name prepended with the installed package database
      directory.

      Optional port names can be specified as a perl regular expression.  If
      missing, a listing of ports will be created which start with any of
      digits and alphas characters, [[:alnum:]]. For en_US.ISO8859-1 locale,
      it's [a-zA-Z0-9].

      The given arguments/patterns separated by spaces/tabs are turned into an
      OR'd regex.  To avoid this behaviour, protect the spaces.  In other
      words, take care to avoid shell interpretation.

OPTIONS
    -usage
         Show this message.  It overrides any other option.

    -dbdir=*package database directory*
         Specify installed package database directory.

         If unspecified, PKG_DBDIR envrionment variable is checked.  If this
         is also unspecified, /var/db/pkg is used as the default.

         -dbdir option overrides PKG_DBDIR which overrides default
         /var/db/pkg.

    -show-dbdir
         Show ports package database directory along with installed
         port's name/version

    -in-port
    -find-port
    -in-origin
    -find-origin
    -in=*port*|*origin*
    -find=*port*|*origin*
         Specify search preference.

         port:    Default.  Listing is searched by port name.

         origin: Listing is searched by port origin.

     Mind that a option like *-find=port* can be specified as *-in=port*,
     *-find-port*, or *-in-port*; similarly for the *origin* option.

    -sort-port, -sort-origin
    -sort=*port*|*origin*
         Specify sort, case insensitive, preference.

         port, sort-port:    Default.  Listing is sorted by port name.

         origin, sort-origin: Listing is sorted by port origin.  It makes for
                              slower output (than -sort-port).

    -short, -long
    -descr=*none*|*short*|*long*
         TO BE IMPLEMENTED.  Specify whether to print any, short, or long port
         description.

         none:   Default.  Don't print any port description.

         short:  Short port description would be printed ('+COMMENT' file).

         long:   Long port description would be printed ('+DESC' file).

EXAMPLES
      - To list all the ports beginning w/ any of [[:alnum:]] characters...

          listpkg

      - To list ports matching a particular perl regex...

          listpkg .\*font
          listpkg fvwm t?vtwm

      ...in the second example, final regex will be (fvwm|t?vtwm) for which
      ports will be searched.

      - To list port sorted by port origin...

          listpkg -sort=origin 'ruby|perl'

ENVIRONMENT
      PKG_DBDIR  Specifies alternate location of installed package database.
                 It is overridden by -dbddir option.  Default is /var/db/pkg.

FILES
      /var/db/pkg  Default location of the installed package database.

      /var/db/pkg/port/+COMMENT
                   File containing a port's short description, usually a line.

      /var/db/pkg/port/+CONTENTS
                   File containing a port's dependency list, installed files,
                   deinstall & install scripts, etc.

      /var/db/pkg/port/+DESC
                   file containing a port's longer description.

      /var/db/pkg/port/+REQUIRED_BY
                   File containing list of ports which require the port in
                   question.

SEE ALSO
      pkg_info(1), ports(7)
      pkg_version(1), portupgrade(1), pkg_tree(7)

      FreeBSD ports collection: http://www.freebsd.org/ports/

Author, Distribution and such
      Parv, parv(at)pair(dot)com

      Version: 0.22  Mar 21 2003

      This software is free to be used in any form only if proper credit is
      given.  I am not liable for any harm done; use it at your own risk.