1# 2# Shown below is a simplified dependency graph of the OpenZFS provided 3# libraries. Administrative commands (`zfs`, `zpool`, etc) interface with 4# the kernel modules using the `libzfs.so` and `libzfs_core.so` libraries. 5# These libraries provide a stable ABI across OpenZFS point releases. 6# 7# The `libzpool.so` library is a user space build of the DMU and SPA layers 8# used to implement debugging tools (zdb) and code validation tools (ztest). 9# These library interfaces are subject to change at any time. 10# 11# 12# CMDS: zhack/ztest/zdb/ zfs/zpool/zed/ 13# raidz_{test,bench} zinject/zstream 14# | | 15# LIBS: | | libzfsbootenv* 16# | | | 17# | | | 18# libzpool libzfs* ----------------+ 19# | | | \ / | | | 20# libicp --/ | | \ / | | \------- libshare 21# | | \ / | | 22# libzstd ---/ | \ / | \--------- libuutil 23# | \ / \ | | 24# libunicode --/ \ / \ | | 25# \ / \ | | 26# libzutil libzfs_core* | | 27# | | | | \ | | | | 28# | | | | | | | | | 29# | | | | | | | | | 30# libtpool -------------/ | | | \---- libnvpair* | | | 31# | | | | | | 32# libefi -----------------/ | \------ libavl* --------/ | 33# | | | 34# \-------- libspl ----+------/ 35# 36# 37# NB: GNU Automake Manual, Chapter 8.3.5: Libtool Convenience Libraries 38# These nine libraries are intermediary build components. 39# 40# * - A stable ABI is provided for these libraries; 41# when performing an ABI check the following options are applied: 42# 43# --no-unreferenced-symbols: Exclude symbols which are not referenced by 44# any debug information. Without this _init() and _fini() are incorrectly 45# reported on CentOS7 for libuutil.so. 46# 47# --headers-dir1: Limit ABI checks to public OpenZFS headers, otherwise 48# changes in public system headers are also reported. 49# 50# --suppressions: Honor a suppressions file for each library to provide 51# a mechanism for suppressing harmless warnings. 52# 53 54noinst_LTLIBRARIES = 55lib_LTLIBRARIES = 56pkgconfig_DATA = 57include $(srcdir)/%D%/libavl/Makefile.am 58include $(srcdir)/%D%/libicp/Makefile.am 59include $(srcdir)/%D%/libnvpair/Makefile.am 60include $(srcdir)/%D%/libshare/Makefile.am 61include $(srcdir)/%D%/libspl/Makefile.am 62include $(srcdir)/%D%/libtpool/Makefile.am 63include $(srcdir)/%D%/libunicode/Makefile.am 64include $(srcdir)/%D%/libuutil/Makefile.am 65include $(srcdir)/%D%/libzfs_core/Makefile.am 66include $(srcdir)/%D%/libzfs/Makefile.am 67include $(srcdir)/%D%/libzfsbootenv/Makefile.am 68include $(srcdir)/%D%/libzpool/Makefile.am 69include $(srcdir)/%D%/libzstd/Makefile.am 70include $(srcdir)/%D%/libzutil/Makefile.am 71if BUILD_LINUX 72include $(srcdir)/%D%/libefi/Makefile.am 73endif 74 75 76PHONY += lib 77lib: $(noinst_LTLIBRARIES) $(lib_LTLIBRARIES) 78 79 80PHONY += checkabi storeabi check_libabi_version allow_libabi_only_for_x86_64 81 82check_libabi_version: 83 if [ $$(abidw -v | $(SED) 's/[^0-9]//g') -lt 200 ]; then \ 84 printf '%s\n' "" \ 85 "*** Please use libabigail 2.0.0 version or newer;" \ 86 "*** otherwise results are not consistent!" \ 87 "(or see https://github.com/openzfs/libabigail-docker)"; \ 88 exit 1; \ 89 fi 90 91allow_libabi_only_for_x86_64: 92 echo '*** ABI definitions provided apply only to x86_64:' 93 echo '*** not checking or storing ABI and assuming success.' 94 95if TARGET_CPU_X86_64 96# These should depend on $(lib_LTLIBRARIES), but this breaks on CI when bound into Docker 97checkabi: check_libabi_version 98 err=0; \ 99 for lib in $(lib_LTLIBRARIES); do \ 100 lib=$${lib%.la}; \ 101 [ -f $(srcdir)/lib/$$lib/$$lib.suppr ] || continue; \ 102 echo $$lib:; \ 103 abidiff --no-unreferenced-symbols \ 104 --headers-dir1 include \ 105 --suppressions $(srcdir)/lib/$$lib/$$lib.suppr \ 106 $(srcdir)/lib/$$lib/$$lib.abi .libs/$$lib.so || err=$$((err + 1)); \ 107 done; \ 108 exit $$err 109 110storeabi: check_libabi_version 111 for lib in $(lib_LTLIBRARIES); do \ 112 lib=$${lib%.la}; \ 113 [ -f $(srcdir)/lib/$$lib/$$lib.suppr ] || continue; \ 114 abidw --no-show-locs \ 115 --no-corpus-path \ 116 --no-comp-dir-path \ 117 --type-id-style hash \ 118 .libs/$$lib.so > $(srcdir)/lib/$$lib/$$lib.abi; \ 119 done 120else 121checkabi: allow_libabi_only_for_x86_64 122storeabi: allow_libabi_only_for_x86_64 123endif 124