NAME

pkg_libchk — check packages for links against missing libraries

SYNOPSIS

pkg_libchk [-cmnoqv] [-j jobs] [-a]

pkg_libchk [-CcdgimnOoqrvx] [-j jobs] pkg-name ...

pkg_libchk -h

DESCRIPTION

The pkg_libchk script uses pkg-info(8), ldd(1) and readelf(1) to check whether a package is linked against missing libraries or using compatibility libraries (matching */lib*/compat/*).

Arguments

The following arguments are accepted:

jobs: The number of parallel process to perform library checks. The default is number of detected cores plus one.
pkg-name: Packages are package names or shell glob patterns matching these. Whatever works with pkg-info(8) is an acceptable package.

Options

The following options are available:

-a, --all: Check all packages. This is the default action in case no pkg-name has been specified.
-C, --case-sensitive: See pkg-info(8).
-c, --clean: Create clean output without status messages.
-d, --dependencies: Also operate on the dependencies of the provided pkg-name.
-g, --glob: See pkg-info(8).
-h, --help: Displays the available options.
-i, --case-insensitive: See pkg-info(8).
-j jobs, --jobs jobs: Set the number of parallel processes to perform library checks.
-m, --no-filter: In this mode all the checks to detect false positives are turned off.
It also causes indirect dependencies to be listed as missing dependencies.
-n, --no-compat: This deactivates detecting compatibility libraries.
-O, --by-origin: See pkg-info(8).
-o, --origin: Instead of the package name and version the package origin and flavour is printed.
-q, --quiet: Only print the names of affected packages. Do not print any details. This option is meant for machine readability.
This option cannot be combined with verbose output.
-r, --required-by: Also check packages that depend on the provided packages. This is a good idea when checking for the effects of a library update.
-v, --verbose: Be verbose about missing dependencies. Instead of rejecting indirect dependencies print them.
This option cannot be combined with quiet output.
-x, --regex: See pkg-info(8).

EXAMPLES

To check all your packages run:

pkg_libchk

To create plain output for everything connected to gtk.

pkg_libchk -q \*gtk\*

After upgrading a library, in this case icu, you can check all depending packages:

pkg_libchk -r icu

EXIT CODES

1: The script has terminated because it received SIGHUP, SIGINT or SIGTERM.
2: An unknown parameter has been supplied.
3: The incompatible parameters -v and -q have been supplied.
4: The parameter -j has been supplied without an acceptable number.

HISTORY

The pkg_libchk script first appeared in the bsdadminscripts-4.0 collection. It was rewritten for the bsda2 collection.

AUTHORS

Dominic Fandrey <freebsd@k4m1.org>