BUILD.LIB.MK(5)

📦 version 3.1, in nixos 26.05, nixpkgs unstable

🦋 build.lib.mk(5) — bsdbuild’s library-compilation era 🦋

Okay bestie, welcome to build.lib.mk(5) from the File Formats Manual — this is the page for the bsdbuild module that handles compilation of libraries. It’s lowkey iconic, no cap.

✨ NAME ✨

build.lib.mk — bsdbuild — compilation of libraries. Yup, that’s the whole vibe: it compiles static and/or shared libraries, and it’s literally about to make your build feel like main character energy. 💅

🌸 SYNOPSIS 🌸

.include <bsd.lib.mk>

💖 DESCRIPTION 💖

The build.lib.mk module compiles static and/or shared libraries from a set of source files. For shared libraries, it uses a bundled copy of GNU libtool. The module provides built-in support for sources in the following languages:

  • C (*.c)
  • C++ (*.cc or *.cpp)
  • Objective C (*.m)
  • Assembler (*.asm)
  • Lex (*.l)
  • Yacc (*.y)

🎀 TARGETS 🎀

  • lib${LIB}.a — compile the source files into a static library. slay. ✨
  • lib${LIB}.la — compile the source files into static and shared libraries using libtool. and yes, libtool comes bundled with BSDBuild. 🫶
  • clean-lib — clean up object and library files. self-care. 🧚
  • cleandir-lib — clean up for packaging. 📦
  • install-lib — install library files to the target installation directory (see csoft.common.mk(5)). 💖
  • deinstall-lib — uninstall libraries from the installation directory. bye bestie. 👋

👑 VARIABLES 👑

  • LIB — name of target library. Platform-specific transforms will be applied to the name. 🎯
  • LIBDIR — target installation directory for libraries (usually set by configure). 📁
  • LIB_INSTALL — if set to Yes, the install target will install the library files; otherwise it will be a no-op. Defaults to No. 🙈
  • LIB_SHARED — if set to Yes, a shared library will be built. Default is No. 🔥
  • LIB_MODULE — if set to Yes, a dlopen(3) compatible module will be built. Default is No. 🧩
  • LIB_GUID — a Global Unique Identifier (GUID) for the library. Exact interpretation is platform-specific. 🪪
  • LIB_MAJOR — major version number for shared libraries. 1️⃣
  • LIB_MINOR — minor version number for shared libraries. 2️⃣
  • LIB_REVISION — revision number for shared libraries. 🔁
  • LIBS — specify other libraries to link against this library. Bare filename arguments are interpreted as archive files ("foo.a" or "foo.la"). Arguments of the form -L/path/to/dir and -lfoo specify shared libraries. 🔗
  • USE_LIBTOOL — if set to Yes, use libtool(1) to build the libraries. If set to No, generate the library using the traditional method involving ar(1), ranlib(1), and -fPIC. 🛠️
  • LIBTOOL — path to GNU libtool(1). This is usually set by the configure script. BSDBuild-generated configure scripts will select BSDBuild’s bundled copy of libtool by default (recommended), but an alternate libtool may be specified using --with-libtool=PATH. 🌟
  • LIBTOOLOPTS — specify general libtool arguments (passed before --mode). Defaults to "--quiet". 🤫
  • LIBTOOLOPTS_SHARED — specify extra libtool arguments for linking of shared libraries. 💞
  • LIBTOOLOPTS_STATIC — specify extra libtool arguments for linking of static libraries. 🧱
  • CC — compiler for C, C++ and Objective C sources. Defaults to the CC environment variable, or "cc". ⚙️
  • CFLAGS — compiler flags for C sources. Defaults to the CFLAGS environment variable. 🌈
  • CXXFLAGS — compiler flags for C++ sources. Defaults to the CXXFLAGS environment variable. 🦋
  • OBJCFLAGS — compiler flags for Objective C sources. Defaults to ${CFLAGS}. 🍓
  • CPPFLAGS — compiler preprocessor flags, for sources in all languages featuring a C preprocessor. 🧠
  • ASM — compiler for assembler sources. Defaults to nasm. 💀
  • ASMFLAGS — compiler flags for assembler. Defaults to -g -w-orphan-labels. 🔧
  • LEX — path to the lex(1) lexical analyzer generator. 🌀
  • YACC — path to the yacc(1) parser generator. 🌪️
  • LFLAGS — options for lex(1), defaults to ''. 🪄
  • YFLAGS — options for yacc(1), defaults to -d. 🎀
  • LIBL — libraries to use for Lex lexers. Defaults to -ll. 📚
  • WINDRES — (Specific to the win32 platform) path to the windres(1) utility, which generates windows resource files. 🪟
  • WINRES — (Specific to the win32 platform) resource file to use with windres(1). 🧾
  • DATAFILES — list of data files to install into ${DATADIR}. The files must have been generated from the build process (i.e., if using a separate build with --srcdir, the specified files must exist in the build directory). 📂
  • DATAFILES_SRC — files to install into ${DATADIR}. This variable is handled similarly to DATAFILES, except that the specified files must exist in the source directory. 🗂️
  • INCLDIR — library header files will be installed into this directory. See build.common.mk(5). 📁
  • INCL — list of library header files. 📜
  • CONFDIR — system-wide configuration files will be installed into this directory. It is usually set relative to ${SYSCONFDIR}, for example ${SYSCONFDIR}/MyLibrary. 🛠️
  • CONF — list of configuration files to install into ${CONFDIR}. Note that the install target will not override existing configuration files; instead it will output a “The following configuration files have been preserved” message. 🫶
  • CONF_OVERWRITE — overwrite any existing configuration file on installation. Default is "No". 💅

🌈 SEE ALSO 🌈

⭐ HISTORY ⭐

build.lib.mk first appeared in BSDBuild 1.0. ✨

BSDBuild is based on the 4.4BSD build system. 🧚

— Debian edition of BUILD.LIB.MK(5), dated July 18, 2007, signing off with a library-sized 💖

📦 where this page comes from