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 produced by ldd(1) are deactivated.

Indirect dependencies are no longer recognised as such.
Dependencies that are part of a package even though ldd(1) does not find them are no longer discarded - finding these dependencies usually just requires some runtime information ldd is not privy to.
Dependencies of unbranded elf(3) binaries are no longer distinguished from dependencies of native binaries.

-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>