LV2SONAME(1)

πŸ“¦ version 1.0.5, in debian bookworm, ubuntu jammy

πŸ’– LV2SONAME πŸ’–

okay bestie, welcome to the lv2soname(1) page, a General Commands Manual moment, and honestly? it's giving "niche build-system queen". let's get into it πŸŽ€

✨ NAME ✨

lv2soname β€” a script you can drop into your build system to translate a linker option into the soname πŸ’…

🌸 DESCRIPTION 🌸

So this manual page is here to briefly document the lv2soname command, periodt. Fun fact tho: this page was written for the Debian distribution because the original program literally does not have a manual page. not one. we're doing charity work here 🫢

The lv2soname script can be used in your build system to translate a linker option β€” like, say, -lgtkmm2.4 β€” into the soname β€” in that case libgtkmm-2.4.so.1 β€” for the shared library that ld will link to when it's handed that command line option. it's literally a glow-up translator for your build system ✨

What it does with that info: it generates the RDF triples needed to tell hosts that the library with that soname must never be unloaded, even after your plugin GUI library has been unloaded. never ever. no cap πŸ”₯

e.g.

$ lv2soname '<http://my.gui>' '<http://lv2plug.in/ns/lv2core#requiredFeature>' -lgtkmm-2.4

If the script for some reason can't determine the soname, it will instead generate the RDF needed to tell the host to never unload the GUI library at all. so it's still got you, just with a bigger hammer πŸ’ͺ

⚠️ Okay but here's the tea: pretty much the exact same thing can be done by linking the plugin GUI using the -z nodelete linker option, which keeps the GUI library loaded even after the host runs dlclose(), and it requires no extra support from the host. so lv2soname is deprecated and will be removed in the next major version release. sad but iconic 😭

For more info, please visit http://ll-plugins.nongnu.org 🌈

πŸ‘‘ AUTHOR πŸ‘‘

lv2soname was written by Lars Luthman <lars.luthman@gmail.com>. king behavior 🫑

This manual page was written by JaromΓ­r MikeΕ‘ <mira.mikes@seznam.cz>, for the Debian project (but it may be used by others). generous fr fr πŸ’œ

and that's the whole vibe check, bestie β€” this page is from the General Commands Manual and it's dated May 12, 2010. stay slay, go link those GUIs πŸ¦‹πŸ’…βœ¨

πŸ“¦ where this page comes from