OpenBSD manual page server

Manual Page Search Parameters

PKG_MKLOCATEDB(1) General Commands Manual PKG_MKLOCATEDB(1)

pkg_mklocatedbcreate a locate database for packages

pkg_mklocatedb [-aKnPqu] [-d repository] [-p portsdir] [pkg-name ...]

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:

Prepend file names with pkgpath information and package names.
Scan directory repository for packages.
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.

Do not pipe output to /usr/libexec/locate.mklocatedb (default if standard output is a terminal).
Prepend file names with pkgpath information instead of package name.
Retrieve packing-lists from the ports tree instead of binary packages.
Be quiet: do not report every package processed to standard error.
Update an existing list. The list must come from standard input, and contain pkgpath information for items to be replaced.

locate(1), pkg_info(1)

Marc Espie

November 26, 2021 OpenBSD-7.1