CHECK-LIB-DEPENDS(1)

💅 check-lib-depends(1) — the group-chat guide

okay so bestie, welcome to check-lib-depends, from the General Commands Manual section. she's the one who checks that every shared library your port or package needs is actually, like, recorded properly. no cap. ✨

---

🌸 NAME 🌸

check-lib-depends — scan port for shared libraries 🫶

✨ SYNOPSIS ✨

check-lib-depends [-fimqx] [-B destdir] [-d pkgrepo] [-D directory]
                  [-F missing] [-O dest] [-S VAR=value] [-s source]
                  [package ...]

💖 DESCRIPTION 💖

check-lib-depends scans a port or a package for shared libraries and verifies that all of them are properly recorded. literally all of them. it's giving responsible.

she can either scan files from a built port after the fake stage from the WRKINST directory, or look directly inside a package.

likewise (iconic word), she can also verify dependencies of installed packages, or figure them out directly from the port directory. versatile queen 👑

check-lib-depends actually consists of two distinct stages, and honestly the way she splits it up? main character energy:

• scan all binaries inside a package to extract libraries and rpaths, using objdump(1).
• compare those libraries against the port's registered dependencies and report problems. 🚨

the options are as follows, bestie — every single one, no skipping:

• -B destdir — scan files under destdir. like, go look over there instead.
• -d pkgrepo — look for all needed packages under directory pkgrepo.
• -D directory — create debug log files under directory that show in more details the run of objdump(1). detective mode 🕵️‍♀️
• -f — give full reports of every file that requires a missing library. full receipts, not just a summary.
• -F missing — works in tandem with -S. allow backsubstituting even if the missing library is actually not part of the actual WANTLIB of the package. mostly used to waive the presence of pthread, a mandatory dependency of C++ libraries on some architectures. iykyk.
• -i — read packing-list from standard input. stdin girlie 💌
• -m — always show progress-meter, even if not run from terminal. she's showing up regardless.
• -O dest — save result of first stage in file dest. stash it for later 🎀
• -q — be quiet, do not emit ‘Extra:’ wantlibs unless there's also an actual problem. no unnecessary noise, periodt.
• -S var=value — recognize list of libraries listed in a variable, and replace said list with variable value. for instance, -S COMPILER_LIBCXX=stdc++ will replace ‘stdc++’ with ‘${COMPILER_LIBCXX}’ in WANTLIB lists for compatibility with both clang and gcc. order matters. the first -S option will be handled first. 👑
• -s src — don't scan, directly read result of first stage from file src. trust the file, bestie.
• -x — don't show progress-meter, even if run from terminal. hidden mode 🙈

if no package is given, and the -i option is used, check-lib-depends will retrieve the packing-list from stdin, and scan the package according to other options. simple as that 💅

🦋 SEE ALSO 🦋

ldd(1), objdump(1), bsd.port.mk(5), elf(5)

💀 BUGS 💀

currently, check-lib-depends doesn't handle libraries living in subdirectories of ‘${LOCALBASE}’ correctly. yeah. that's the bug. we know. 😭

---

bestie heads up: that subdirectory thing is a real known limitation, not a vibe — don't come for her, she's working on it 🧚

okay that's the whole page!! this was the check-lib-depends(1) manual page, Debian edition, dated May 24, 2024 — mwah, slay, go record your libraries properly 💖✨🎀