NAME

revdep — find packages with broken shared library dependencies

SYNOPSIS

DESCRIPTION

revdep checks installed packages for shared libraries that the dynamic linker would not find. Without a package, every installed package is checked.

The files of a package are read from the package database. Each one that is an x86_64 executable or shared object is inspected: every library in its DT_NEEDED entries must be found, as described in LIBRARY SEARCH, and must itself be an x86_64 ELF file. Other files, and ELF files for other architectures, are skipped. A package is broken if one of its files needs a library that is not found, or if it has files in the directory of an older Python or Perl; see STALE LANGUAGE PATHS.

With -r, revdep reports the reverse: the packages that link against a shared library of one of the named packages. Run it after updating a library to see what may need rebuilding. A shared library is a file named name.so or name.so.N ...; a package depends on it if a DT_NEEDED entry of one of its files is that name.

Options must come before the package names. The options are as follows:

-h

Print a usage summary.

-i package,...

Ignore the listed packages: they are not checked, and with -r not reported. May be given more than once.

-r

Reverse mode, as described above. Needs at least one package.

-V

Print the version.

-v

More output; may be given up to four times:

none

The names of the broken packages, or with -r of the dependent packages, one per line, for use in scripts.

-v

A status line for every package.

-vv

Also the broken files, or with -r the files that need a library of the named packages.

-vvv

Also which library each broken file misses.

-vvvv

A trace of everything checked.

LIBRARY SEARCH

A library is looked for the way the musl dynamic linker does:

1. A DT_NEEDED entry containing a ‘/’ is taken as a path.
2. The directories in DT_RUNPATH, or in DT_RPATH if there is no DT_RUNPATH. $ORIGIN is replaced by the directory of the file being checked and $LIB by lib.
3. The system path: the directories in /etc/ld-musl-x86_64.path, separated by ‘:’ or new lines, if that file exists, otherwise /lib, /usr/local/lib and /usr/lib.
4. The directories listed for the package in /etc/revdep.d/; see FILES.

STALE LANGUAGE PATHS

Modules built for one Python or Perl version are installed in a directory named after it, and are not found once another version is installed.

If the package python3 is installed, a package with a file under /usr/lib/pythonX.Y/ is broken when X.Y is not the major and minor version of that package.

If the package perl is installed, a package with a file under /usr/lib/perl5/site_perl/version/ is broken when version is not the version of that package.

FILES

/var/lib/pkg/db

Package database.

/etc/revdep.d/package

Extra library directories for the files of package, one per line. Lines starting with ‘#’ are comments.

/etc/ld-musl-x86_64.path

System library path of the musl dynamic linker, if present.

EXIT STATUS

Without -r, revdep exits 0 if no checked package is broken and 1 otherwise. With -r, finding dependent packages is not an error; it exits 0. Both exit 1 if a named package is not installed or the package database cannot be read.

EXAMPLES

Check every installed package:

Check two packages, showing the broken files:

After updating wlroots and wayland, list what links against them:

Check everything except the kernel and firmware:

To rebuild a broken package, raise release in its port and run pkg sysup; see pkg(8).

SEE ALSO

ldd(1), readelf(1), addpkg(8), infopkg(8), mkpkg(8), pkg(8)

AUTHORS

zorz <zorz@gmx.com>, after the revdep of James Buren for CRUX.

CAVEATS

musl also looks for a library in the DT_RPATH or DT_RUNPATH of the program or library that loaded the one needing it. revdep checks each file on its own, so a library found only that way is reported missing.