FreeBSD Manual Pages
PKG_LIBCHK(8) System Manager's Manual PKG_LIBCHK(8) 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 compatibil- ity libraries (matching */lib*/compat/*). Arguments The following arguments are accepted: jobs The number of parallel process to perform library checks. The de- fault 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 dependen- cies usually just requires some runtime information ldd is not privy to. * Dependencies of unbranded elf(3) binaries are no longer distin- guished 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 de- tails. 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 indi- rect 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. SEE ALSO pkg-info(8), ldd(1), readelf(1), hier(7) 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> FreeBSD ports 15.quarterly 29 July, 2024 PKG_LIBCHK(8)
NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | EXIT CODES | SEE ALSO | HISTORY | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkg_libchk&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>