BPKG(8)                 FreeBSD System Manager's Manual 		BPKG(8)


NAME
     bpkg -- a simple tool for displaying information about ports.

SYNOPSIS
     bpkg [-abDdEeFfgIijkLMmOopQqrswz] pkg-name ...
     bpkg [-BCchltvZ]

DESCRIPTION
     bpkg is a simple tool written in sh(1) for displaying information about
     ports.  Its main goal is to provide a quick way to display all kinds of
     useful info about installed ports and the whole ports tree.

OPTIONS
     The following command line arguments are supported:

     -a  show what dependent ports are, and are not installed. [portmaster
	 required]

     -B  create backup packages in /usr/ports/packages/bpkg from all locally
	 installed ports.

     -b  create backup package in /usr/ports/packages/bpkg from a locally
	 installed port.

     -C  clean all distfiles in /usr/ports/distfiles/* and also all work
	 directories of the ports tree /usr/ports/*/*/work [no arguments]

     -c  clean all distfiles in /usr/ports/distfiles/* [no arguments]

     -D  display size of port's source files.

     -d  display description of the port.

     -E  display available package in the FreeBSD repository. [-CURRENT]

     -e  configure OPTIONS for the specified port.

     -F  browse www.freshports.org port's entry. [text WWW browser required]

     -f  show the packing list instructions for the port.

     -g  show files that do not match the recorded checksum in the specified
	 installed port.

     -h  display help. [no arguments]

     -i  display short description of the port [priority -- installed ports]

     -I  display info about the port.

     -j  search the ports tree according to ports' descriptions.

     -k  show the deinstall script (if any) for the installed port.

     -L  show the files within the installed port.

     -l  display short info about all installed ports. [no arguments]
     
     -M  show the install-message file for the installed port.

     -m  display port's Makefile.

     -O  remove config OPTIONS for the specified port.

     -o  display config OPTIONS for the specified port.

     -p  search the ports tree and display short info about each port.

     -Q  display available package in the FreeBSD repository. [-STABLE]

     -q  display available package in the FreeBSD repository. [-RELEASE]

     -r  show the list of all port's dependencies.

     -s  show the total size occupied by files installed within the port.

     -t  list all installed ports with dates of their installation. [no argu-
	 ments]

     -w  which installed port owns the specified file.

     -v  list all installed ports and possible updates. [no arguments]

     -Z  display all missing dynamic object dependencies. [no arguments]

     -z  display dynamic object dependencies for the specified port.

EXIT STATUS
     The bpkg utility exits 0 on success, and >0 if an error occurs.

EXAMPLES
     The following is an example of a typical usage of the bpkg command:

	   $ bpkg -i foo

     Display short description about port foo.

	   $ bpkg -p foo.*

     Display all ports matching the regular expression.

	   $ bpkg -t | head

     Display 10 most recently installed ports.

	   $ bpkg -b 'foo bar'

     Create backup packages of foo and bar in /usr/ports/packages/bpkg direc-
     tory.

SEE ALSO
     pkg_add(1), pkg_create(1), pkg_delete(1), pkg_info(1), pkg_version(1),
     ports(7)

AUTHORS
     Andy Kosela <akosela@andykosela.com>

FreeBSD 7.3		       February 6, 2012 		   FreeBSD 7.3