FreeBSD manual

download PDF document: pkg-check.8.pdf

PKG-CHECK(8) FreeBSD System Manager's Manual PKG-CHECK(8)
NAME pkg check - sanity check installed packages
SYNOPSIS pkg check -B|-d|-s|-r [-nqvy] -a pkg check -B|-d|-s|-r [-nqvy] [-Cgix] pattern
pkg check --{shlibs,dependencies,checksums,recompute} [--{dry-run,quiet,verbose,yes}] --all pkg check --{shlibs,dependencies,checksums,recompute} [--{dry-run,quiet,verbose,yes}] [--{case-sensitive,glob,case-insensitive,regex}] pattern
DESCRIPTION pkg check -B or pkg check --shlibs regenerates the library dependency metadata for a package by extracting library requirement information from the binary ELF files in the package.
pkg check -d or pkg check --dependencies checks for and installs missing dependencies.
pkg check -r or pkg check --recompute recalculates and sets the checksums of installed packages. This command should only be used when the administrator has made modifications that invalidate a package checksum. Spontaneous checksum problems can indicate data or security problems.
pkg check -s or pkg check --checksums detects installed packages with invalid checksums. An invalid checksum can be caused by data corruption or tampering.
OPTIONS These options are supported by pkg check:
-a, --all Process all packages.
-B, --shlibs Regenerates the library dependency metadata for a package
-C, --case-sensitive Use case sensitive standard or regular expression (-x) matching with pattern.
-d, --dependencies Checks for and installs missing dependencies
-g, --glob Treat pattern as a shell glob pattern.
-i, --case-insensitive Use case insensitive standard or regular expression (-x) matching with pattern. This is the default unless CASE_SENSITIVE_MATCH has been set to true in pkg.conf.
-n, --dry-run Only check for missing dependencies, do not install them.
-r, --recompute Recalculates and sets the checksums of installed packages
that the command explicitly requests. This is primarily intended for scripting use.
-x, --regex Treat pattern as a regular expression, using the "modern" or "extended" syntax described in re_format(7).
-y, --yes Assume "yes" when asked for confirmation before installing missing dependencies.
ENVIRONMENT These environment variables affect the execution of pkg check. See pkg.conf(5) for additional information.
PKG_DBDIR
CASE_SENSITIVE_MATCH
FILES See pkg.conf(5).
EXAMPLES Regenerate the library dependency metadata of all installed packages from the library information in each package's binary ELF files:
pkg check -Ba
Test for missing dependencies needed by nano, installing any that are missing:
pkg check -d nano
Test the checksums of all installed packages to make sure none are corrupted:
pkg check -sa
SEE ALSO pkg_create(3), pkg_printf(3), pkg_repos(3), pkg-keywords(5), pkg-lua-script(5), pkg-repository(5), pkg-script(5), pkg-triggers(5), pkg.conf(5), pkg(8), pkg-add(8), pkg-alias(8), pkg-annotate(8), pkg-audit(8), pkg-autoremove(8), pkg-clean(8), pkg-config(8), pkg-create(8), pkg-delete(8), pkg-fetch(8), pkg-info(8), pkg-install(8), pkg-lock(8), pkg-query(8), pkg-register(8), pkg-repo(8), pkg-rquery(8), pkg-search(8), pkg-set(8), pkg-shell(8), pkg-shlib(8), pkg-ssh(8), pkg-stats(8), pkg-triggers(8), pkg-update(8), pkg-updating(8), pkg-upgrade(8), pkg-version(8), pkg-which(8)
FreeBSD 14.2-RELEASE May 25, 2018 FreeBSD 14.2-RELEASE