NAME
pkg_mklocatedb
—
create a locate database for
packages
SYNOPSIS
pkg_mklocatedb |
[-aKnPqu ]
[-d repository]
[-p portsdir]
[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, 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.
SEE ALSO
AUTHORS
Marc Espie