NAME

SYNOPSIS

DESCRIPTION

pkg_which looks in the package database to tell which package each specified file came from. If the database is outdated but you do not have permission to update it, it delegates tasks to pkg_info(1).

Actually, pkgdb and pkg_which are the same command, and are equivalent.

The pkgdb command also works as an interactive tool for fixing the package registry database when -F is specified. It helps you resolve stale dependencies, unlink cyclic dependencies, complete stale or missing origins and remove duplicates. You should run this command periodically so portupgrade(1) and other pkg_* tools can work effectively and reliably.

OPTIONS

file

Inquire which package file came from. If the file is not present, pkg_which calls which(1) to search PATH for the file.

-h

 

--help

Show help and exit.

-a

 

--auto

Turn on automatic mode when -F is also specified. pkgdb only fixes discrepancies that can be fixed securely and leaves the others.

--autofix

Shorthand of --auto --fix (-aF).

-c PKGNAME

 

--collate PKGNAME

Show files installed by the given package that have been overwritten by other packages.

-f

 

--force

Force; Specified with -u, update database regardless of timestamps. Specified with -F, fix "held" packages too.

-F

 

--fix

Interactively fix the package registry database.

-i

 

--interactive

Turn on interactive mode.

-L

 

--fix-lost

Check and restore lost dependencies against the ports tree.

-o PKGNAME

 

--origin PKGNAME

Look up the origin of the given package in the package database.

-O

 

--omit-check

Specified with -F, turn off check dependencies against the ports tree. Useful if you need a speed-up.

-Q

 

--quiet

Do not write anything to stdout. Specified twice, do not write anything to stderr either. This is for internal use.

-q

 

--noconfig

Do not read the configuration file - $PREFIX/etc/pkgtools.conf.

-s /OLD/NEW/

 

--substitute /OLD/NEW/

Substitute all the dependencies recorded as OLD with NEW and exit.

-u

 

--update

Update or create the package database file pkgdb.db in $PKG_DBDIR, which is /var/db/pkg by default.

Note: if the ports database files are stale, pkgdb will automatically update them before proceeding, so manual updating is not mandatory.

-v

 

--verbose

Turn on verbose output.

ENVIRONMENT

PKG_DBDIR

Alternative location for the installed package database. Default is “/var/db/pkg”.

PORTSDIR

Alternative location for the ports tree. Default is “/usr/ports”.

PORTS_INDEX

Alternative location for the ports INDEX file. Default is “$PORTSDIR/INDEX”.

PORTS_DBDIR

Alternative location for the ports database files. Default is “$PORTSDIR”. The database files in the directory are automatically created or updated as necessary. See portsdb(1) for details.

PKGTOOLS_CONF

Configuration file for the pkgtools suite. Default is “$PREFIX/etc/pkgtools.conf”.

FILES

/var/db/pkg

Default location of the package database.

$PREFIX/etc/pkgtools.conf

Default location of the pkgtools configuration file.

EXAMPLES

• Get a list of files under /usr/local and /usr/X11R6 that do not belong to any package:
  find /usr/local /usr/X11R6 -type f -print0 | xargs -0 pkg_which -v | fgrep '?'

SEE ALSO

HISTORY

AUTHORS

BUGS