pkg_mklocatedb1

Usage

Overview

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, and SUBDIRLIST is not defined, pkg_mklocatedb will retrieve all package entries from the ports tree.

If the -p option is used together with SUBDIRLIST, pkg_mklocatedb will retrieve the package entries listed in SUBDIRLIST 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 redirected to a file.

The options are as follows:

-a

Prepend file names with pkgpath information and package names.

-d repository

Scan directory repository for packages.

-K

Include keyword in each object full name. This is more accurate, but defeats locate(1) compression.

However, note that some meta annotations always make it into the database: @*exec*, @define-tag, @newgroup, @newuser, @option no-default-conflict and @tag.

-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 error.

-u

Update an existing list. The list must come from standard input, and contain pkgpath information for items to be replaced.