Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 27 Nov 2025 19:53:26 +0000
From:      Konstantin Belousov <kib@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: e60861eb41ca - main - bsd.lib.mk: document INTERNALLIB and PRIVATELIB
Message-ID:  <6928ac36.27c06.6b843965@gitrepo.freebsd.org>

index | next in thread | raw e-mail

The branch main has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=e60861eb41ca9d141a0d967db3ecbe2b2909c300

commit e60861eb41ca9d141a0d967db3ecbe2b2909c300
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2025-11-27 16:41:29 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2025-11-27 19:53:19 +0000

    bsd.lib.mk: document INTERNALLIB and PRIVATELIB
    
    Reviewed by:    des, dim, emaste
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
    Differential revision:  https://reviews.freebsd.org/D53948
---
 share/mk/bsd.lib.mk | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/share/mk/bsd.lib.mk b/share/mk/bsd.lib.mk
index 159957b6300b..e3b3d760ff28 100644
--- a/share/mk/bsd.lib.mk
+++ b/share/mk/bsd.lib.mk
@@ -1,3 +1,18 @@
+# If INTERNALLIB is defined, we build lib<name>.a and lib<name>_pie.a,
+# i.e. only static archives without dso, in both non-PIE and PIE variants,
+# suitable for static linking into binaries.
+# INTERNALLIB library headers are not installed.  A component that uses
+# the library should add explicit -I$(LIB<name>DIR) to CFLAGS.
+#
+# If PRIVATELIB is defined, we build and install both libprivate<name>.a
+# and libprivate<name>.so, so the library can be linked dynamically, but
+# cannot be picked up by third-party configure scripts.
+# PRIVATELIB library headers are installed into include/private/<name>.
+#
+# If neither of control variables are defined, we install headers into
+# include/, and both non-pic static and shared libraries under the defined
+# name.
+
 .include <bsd.init.mk>
 .include <bsd.compiler.mk>
 .include <bsd.linker.mk>


help

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6928ac36.27c06.6b843965>