PKG_MKLOCATEDB(1)          OpenBSD Reference Manual          PKG_MKLOCATEDB(1)

NAME
     pkg_mklocatedb - create a locate database for packages

SYNOPSIS
     pkg_mklocatedb [-anPq] [-d repository] [-p portsdir] [-r release]
                    [-s src] [-x X11src] [pkg-name [...]]

DESCRIPTION
     The pkg_mklocatedb command is used to create a file database for binary
     packages, which can be searched using the locate(1) utility.

     Entries created for each package will have the package name prepended:
     kdelibs-3.3.2p2:/usr/local/bin/meinproc.

     If the -p option is used, pkg_mklocatedb will retrieve all package en-
     tries from the ports tree.  Otherwise, pkg_mklocatedb will build database
     entries for every file object for each pkg-name given on the command
     line, or for every package in a repository specified as the -d option.
     If no package name is given, pkg_mklocatedb will build database entries
     for all currently installed packages.

     By default (unless standard output is a terminal), the list of names is
     fed to /usr/libexec/locate.mklocatedb and the end result should be redi-
     rected to a file.

     In addition, pkg_mklocatedb can also list files in the base sets of an
     OpenBSD distribution, which are not exactly packages in the usual sense.

     The options are as follows:

     -a      Prepend file names with pkgpath information and package names.

     -d repository
             Scan directory repository for packages.

     -n      Do not pipe output to /usr/libexec/locate.mklocatedb (default if
             standard output is a terminal).

     -P      Prepend file names with pkgpath information instead of package
             name.

     -p portsdir
             Retrieve packing lists from the ports tree instead of binary
             packages.

     -q      Be quiet: do not report every package processed to standard er-
             ror.

     -r release
             Specify the location of a release directory (see release(8)).
             pkg_mklocatedb will list release tar balls from that directory.

     -s src  Specify the location of OpenBSD source.  pkg_mklocatedb will list
             sets found under that source directory.

     -x X11src
             Specify the location of X11 source.  pkg_mklocatedb will list
             sets found under that X11 source directory.

SEE ALSO
     locate(1), pkg_info(1)

AUTHORS
     Marc Espie

OpenBSD 4.7                      May 16, 2008                                1
