Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 compati-
       bility 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	 pack-
	       age.

   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 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 up-
	       date.

       -v, --verbose
	       Be verbose about	missing	dependencies. Instead of rejecting in-
	       direct 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  depend-
       ing 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 num-
	       ber.

SEE ALSO
       pkg-info(8), ldd(1), readelf(1),	hier(7)

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

AUTHORS
       Dominic Fandrey <freebsd@k4m1.org>

FreeBSD	Ports 14.quarterly     18 November, 2023		 PKG_LIBCHK(8)

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+14.3.quarterly>

home | help