tebako 0.5.12 → 0.6.2

data/lib/tebako/packager/pass2.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright (c) 2021-2023 [Ribose Inc](https://www.ribose.com).
+# Copyright (c) 2021-2024 [Ribose Inc](https://www.ribose.com).
 # All rights reserved.
 # This file is a part of tebako
 #
@@ -26,7 +26,9 @@
 # POSSIBILITY OF SUCH DAMAGE.
 
 require_relative "patch_literals"
+require_relative "patch_libraries"
 require_relative "patch_helpers"
+require_relative "patch_buildsystem"
 
 # Tebako - an executable packager
 module Tebako
@@ -37,134 +39,102 @@ module Tebako
         def get_patch_map(ostype, deps_lib_dir, ruby_ver)
           patch_map = get_patch_map_base(ostype, deps_lib_dir, ruby_ver)
 
-          C_FILES_TO_PATCH.each { |patch| patch_map.store(patch[0], patch_c_file(patch[1])) }
           patch_map.store("thread_pthread.c", LINUX_MUSL_THREAD_PTHREAD_PATCH) if ostype =~ /linux-musl/
-          patch_map.store("common.mk", COMMON_MK_PATCH) if PatchHelpers.ruby3x?(ruby_ver)
 
-          ostype =~ /msys/ ? patch_map.merge!(MSYS_PATCHES) : patch_map
-          #          patch_map.merge!(LINUX_PATCHES)
+          if PatchHelpers.msys?(ostype)
+            patch_map.merge!(get_msys_patches(ruby_ver))
+          elsif PatchHelpers.ruby3x?(ruby_ver)
+            # [TODO] Do we really need it for platforms other then Windows ??
+            patch_map.store("common.mk", COMMON_MK_PATCH)
+          end
+
+          patch_map
         end
 
         private
 
+        include Tebako::Packager::PatchBuildsystem
         include Tebako::Packager::PatchLiterals
 
         def get_dir_c_patch(ostype)
-          dir_c_patch = patch_c_file(ostype =~ /msys/ ? "/* define system APIs */" : "#ifdef HAVE_GETATTRLIST")
+          pattern = PatchHelpers.msys?(ostype) ? "/* define system APIs */" : "#ifdef HAVE_GETATTRLIST"
+          dir_c_patch = PatchHelpers.patch_c_file(pattern)
           dir_c_patch.merge!(DIR_C_BASE_PATCH)
+          dir_c_patch
         end
 
-        def get_patch_map_base(ostype, deps_lib_dir, ruby_ver)
-          {
-            "template/Makefile.in" => template_makefile_in_patch(ostype, deps_lib_dir, ruby_ver),
-            "main.c" => MAIN_C_PATCH,
-            "tool/mkconfig.rb" => TOOL_MKCONFIG_RB_PATCH,
-            "gem_prelude.rb" => GEM_PRELUDE_RB_PATCH,
-            "dir.c" => get_dir_c_patch(ostype)
+        def get_dln_c_patch(ostype, ruby_ver)
+          # Not using substitutions of dlxxx functions on Windows
+          dln_c_patch = {
+            "static const char funcname_prefix[sizeof(FUNCNAME_PREFIX) - 1] = FUNCNAME_PREFIX;" =>
+              "#{PatchHelpers.msys?(ostype) ? C_FILE_SUBST_LESS : C_FILE_SUBST}\n" \
+              "static const char funcname_prefix[sizeof(FUNCNAME_PREFIX) - 1] = FUNCNAME_PREFIX;\n"
           }
-        end
 
-        def process_brew_libs!(libs, brew_libs)
-          brew_libs.each { |lib| libs << "#{PatchHelpers.get_prefix_macos(lib[0]).chop}/lib/lib#{lib[1]}.a " }
-        end
-
-        def darwin_libs(deps_lib_dir, ruby_ver)
-          libs = String.new
+          if PatchHelpers.msys?(ostype)
+            patch = PatchHelpers.ruby32?(ruby_ver) ? DLN_C_MSYS_PATCH : DLN_C_MSYS_PATCH_PRE32
+            dln_c_patch.merge!(patch)
+          end
 
-          process_brew_libs!(libs, PatchHelpers.ruby31?(ruby_ver) ? DARWIN_BREW_LIBS_31 : DARWIN_BREW_LIBS_PRE_31)
-          process_brew_libs!(libs, DARWIN_BREW_LIBS)
+          dln_c_patch
+        end
 
-          DARWIN_DEP_LIBS.each { |lib| libs << "#{deps_lib_dir}/lib#{lib}.a " }
-          <<~SUBST
-            -ltebako-fs -ldwarfs-wr -ldwarfs -force_load #{deps_lib_dir}/libdwarfs_compression.a -lfolly -lfsst -lmetadata_thrift -lthrift_light -lxxhash \
-            -lzstd #{libs} -ljemalloc -lc++ -lc++abi
-          SUBST
+        def get_io_c_msys_patch(ruby_ver)
+          io_c_msys_patch = PatchHelpers.ruby32?(ruby_ver) ? IO_C_MSYS_PATCH : IO_C_MSYS_PATCH_PRE_32
+          io_c_msys_patch.merge(IO_C_MSYS_BASE_PATCH)
         end
 
-        # .....................................................
-        #  Notes re linux libraries
-        #   1) This order is important: -lgcc_eh -l:libunwind.a -l:liblzma.a  lzma is used to process debug sections.
-        #      gcc_eh shall be linked before unwind to avoid duplicate symbols.
-        #   2) -lgcc_eh assumes -static-libgcc (applied in CMakeLists.ext, RUBY_C_FLAGS)
-        #   3) -static-libstdc++ did not work, not sure why  [TODO ?]
-        #   4) When clang is used linker links libraries specified in exensions in such way that they are linked shared
-        #      (libz, libffi, libreadline, libncurses, libtinfo, ... )
-        #      Using stuff like -l:libz.a  does not help; there is a reference to libz.so anyway.
-        #      This is fixed by ext/extmk.rb patch [TODO ?]
-        # .....................................................
-
-        def linux_gnu_libs(ruby_ver)
-          <<~SUBST
-            -l:libtebako-fs.a -l:libdwarfs-wr.a -l:libdwarfs.a -Wl,--push-state,--whole-archive -l:libdwarfs_compression.a -Wl,--pop-state -l:libfolly.a -l:libfsst.a       \
-            -l:libmetadata_thrift.a -l:libthrift_light.a -l:libxxhash.a -l:libarchive.a -l:libfmt.a -l:libdouble-conversion.a -l:libglog.a -l:libgflags.a -l:libevent.a     \
-            -l:libiberty.a -l:libacl.a -l:libssl.a -l:libcrypto.a -l:liblz4.a -l:libz.a -l:libzstd.a -l:libbrotlienc.a -l:libbrotlidec.a -l:libbrotlicommon.a -l:libgdbm.a  \
-            -l:libreadline.a -l:libtinfo.a -l:libffi.a -l:libncurses.a -l:libjemalloc.a -l:libcrypt.a -l:libanl.a #{PatchHelpers.yaml_reference(ruby_ver)}                  \
-            -l:libboost_system.a -l:libboost_chrono.a  -l:libutil.a -l:libstdc++.a -lgcc_eh -l:libunwind.a -l:liblzma.a -l:librt.a -ldl -lpthread -lm
-          SUBST
+        def get_io_c_patch(ostype, ruby_ver)
+          io_c_patch = PatchHelpers.patch_c_file("/* define system APIs */")
+          io_c_patch.merge!(get_io_c_msys_patch(ruby_ver)) if PatchHelpers.msys?(ostype)
+          io_c_patch
         end
 
-        def linux_musl_libs(ruby_ver)
-          <<~SUBST
-            -l:libtebako-fs.a -l:libdwarfs-wr.a -l:libdwarfs.a -Wl,--push-state,--whole-archive -l:libdwarfs_compression.a -Wl,--pop-state -l:libfolly.a -l:libfsst.a         \
-            -l:libmetadata_thrift.a -l:libthrift_light.a -l:libxxhash.a -l:libfmt.a -l:libdouble-conversion.a -l:libglog.a -l:libgflags.a -l:libevent.a -l:libiberty.a        \
-            -l:libacl.a -l:libssl.a -l:libcrypto.a -l:liblz4.a -l:libz.a -l:libzstd.a -l:libbrotlienc.a -l:libbrotlidec.a -l:libbrotlicommon.a -l:libgdbm.a -l:libreadline.a  \
-            -l:libffi.a -l:libncurses.a -l:libjemalloc.a -l:libcrypt.a  #{PatchHelpers.yaml_reference(ruby_ver)} -l:libboost_system.a -l:libboost_chrono.a -l:librt.a         \
-            -l:libstdc++.a -lgcc_eh -l:libunwind.a -l:liblzma.a -ldl -lpthread
-          SUBST
+        def get_msys_mkconfig_rb_patches(ruby_ver)
+          {
+            "    if fast[name]" => TOOLS_MKCONFIG_RB_SUBST,
+            "when /RUBYGEMS/; next" =>
+              "when /RUBYGEMS/; next\n\n" \
+              "# Start of tebako patch\n" \
+              "when /MAINLIBS/; val = #{PatchLibraries.msys_base_libs(ruby_ver)}\n" \
+              "# End of tebako patch"
+          }
         end
 
-        def msys_libs(ruby_ver)
-          <<~SUBST
-            -l:libtebako-fs.a -l:libdwarfs-wr.a -l:libdwarfs.a -l:libfolly.a -l:libfsst.a -l:libmetadata_thrift.a -l:libthrift_light.a -l:libxxhash.a \
-            -l:libfmt.a -l:libdouble-conversion.a -l:libglog.a -l:libgflags.a -l:libevent.a -l:libssl.a -l:libcrypto.a -l:liblz4.a -l:libz.a \
-            -l:libzstd.a -l:libffi.a -l:libgdbm.a -l:libncurses.a -l:libjemalloc.a -l:libunwind.a -l:liblzma.a -l:libiberty.a \
-            #{PatchHelpers.yaml_reference(ruby_ver)} -l:libstdc++.a -l:libdl.a -lole32 -loleaut32 -luuid
-          SUBST
+        def get_msys_patches(ruby_ver)
+          {
+            "cygwin/GNUmakefile.in" => get_gnumakefile_in_patch_p2(ruby_ver),
+            "ruby.c" => RUBY_C_MSYS_PATCHES,
+            "win32/file.c" => WIN32_FILE_C_MSYS_PATCHES,
+            "win32/win32.c" => WIN32_WIN32_C_MSYS_PATCHES
+          }
         end
 
-        # rubocop:disable Metrics/MethodLength
-        def mlibs(ostype, deps_lib_dir, ruby_ver)
-          case ostype
-          when /linux-gnu/
-            linux_gnu_libs(ruby_ver)
-          when /linux-musl/
-            linux_musl_libs(ruby_ver)
-          when /darwin/
-            darwin_libs(deps_lib_dir, ruby_ver)
-          when /msys/
-            msys_libs(ruby_ver)
-          else
-            raise Tebako::Error, "Unknown ostype #{ostype}"
-          end
+        def get_patch_map_base(ostype, deps_lib_dir, ruby_ver)
+          mcrb_subst = PatchHelpers.msys?(ostype) ? get_msys_mkconfig_rb_patches(ruby_ver) : TOOL_MKCONFIG_RB_PATCH
+          {
+            "template/Makefile.in" => template_makefile_in_patch(ostype, deps_lib_dir, ruby_ver),
+            "tool/mkconfig.rb" => mcrb_subst,
+            "gem_prelude.rb" => GEM_PRELUDE_RB_PATCH,
+            "dir.c" => get_dir_c_patch(ostype),            "dln.c" => get_dln_c_patch(ostype, ruby_ver),
+            "io.c" => get_io_c_patch(ostype, ruby_ver),    "main.c" => MAIN_C_PATCH,
+            "file.c" => PatchHelpers.patch_c_file("/* define system APIs */"),
+            "util.c" => PatchHelpers.patch_c_file("#ifndef S_ISDIR")
+          }
         end
-        # rubocop:enable Metrics/MethodLength
 
         def mlibs_subst(ostype, deps_lib_dir, ruby_ver)
           yjit_libs = PatchHelpers.ruby32only?(ruby_ver) ? "$(YJIT_LIBS) " : ""
           {
             "MAINLIBS = #{yjit_libs}@MAINLIBS@" =>
               "# -- Start of tebako patch -- \n" \
-              "MAINLIBS = #{yjit_libs}#{mlibs(ostype, deps_lib_dir, ruby_ver)}" \
+              "MAINLIBS = #{yjit_libs}#{PatchLibraries.mlibs(ostype, deps_lib_dir, ruby_ver)}" \
               "# -- End of tebako patch -- \n"
           }
         end
 
-        def patch_c_file(pattern)
-          {
-            pattern => "#{C_FILE_SUBST}\n#{pattern}"
-          }
-        end
-
         def template_makefile_in_patch(ostype, deps_lib_dir, ruby_ver)
-          template_makefile_in_patch_two(ruby_ver).merge(mlibs_subst(ostype, deps_lib_dir, ruby_ver))
-        end
-
-        def template_makefile_in_patch_two(ruby_ver)
-          if PatchHelpers.ruby31?(ruby_ver)
-            { TEMPLATE_MAKEFILE_IN_BASE_PATTERN => TEMPLATE_MAKEFILE_IN_BASE_PATCH }
-          else
-            { TEMPLATE_MAKEFILE_IN_BASE_PATTERN_PRE_3_1 => TEMPLATE_MAKEFILE_IN_BASE_PATCH_PRE_3_1 }
-          end
+          template_makefile_in_patch_two(ostype, ruby_ver).merge(mlibs_subst(ostype, deps_lib_dir, ruby_ver))
         end
       end
     end

data/lib/tebako/packager/patch_buildsystem.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2023-2024 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of tebako
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require_relative "patch_helpers"
+
+# Tebako - an executable packager
+module Tebako
+  module Packager
+    # Ruby buildsystem patches (pass2)
+    module PatchBuildsystem
+      # This patch forces rebuild of extinit.c when exts.mk changes
+      # exts.mk changes when we rebuild extensions to make them statically linked
+      # [TODO] it is possible that we can build extensions statically on pass1 and it will
+      #        eliminate the need for this patch
+      COMMON_MK_PATCH = {
+        "ext/extinit.c: $(srcdir)/template/extinit.c.tmpl $(PREP)" =>
+          "ext/extinit.c: $(srcdir)/template/extinit.c.tmpl $(PREP) $(EXTS_MK)"
+      }.freeze
+
+      # This patch changes libraries that are used for Ruby linking
+      # MAINLIBS is patched elsewhere (not with literal but dynamically)
+      #          to haold the list of sattic libraries and related options
+      # Also we have to put LIBRUBYARG_STATIC instead of LIBRUBYARG to link with static libruby,
+      # configure's --disable-shared option does not do it
+      # Several variants depending on os and version
+      TEMPLATE_MAKEFILE_IN_BASE_PATTERN_PRE_3_1 =
+        "\t\t$(Q) $(PURIFY) $(CC) $(LDFLAGS) $(XLDFLAGS) $(MAINOBJ) " \
+        "$(EXTOBJS) $(LIBRUBYARG) $(MAINLIBS) $(LIBS) $(EXTLIBS) $(OUTFLAG)$@"
+
+      TEMPLATE_MAKEFILE_IN_BASE_PATCH_PRE_3_1 =
+        "# -- Start of tebako patch --\n" \
+        "\t\t$(Q) $(PURIFY) $(CC) $(LDFLAGS) $(XLDFLAGS) $(MAINOBJ) " \
+        "$(EXTOBJS) $(LIBRUBYARG_STATIC) $(OUTFLAG)$@\n" \
+        "# -- End of tebako patch --"
+
+      TEMPLATE_MAKEFILE_IN_BASE_PATTERN =
+        "\t\t$(Q) $(PURIFY) $(CC) $(EXE_LDFLAGS) $(XLDFLAGS) $(MAINOBJ) $(EXTOBJS) " \
+        "$(LIBRUBYARG) $(MAINLIBS) $(LIBS) $(EXTLIBS) $(OUTFLAG)$@"
+
+      TEMPLATE_MAKEFILE_IN_BASE_PATCH =
+        "# -- Start of tebako patch --\n" \
+        "\t\t$(Q) $(PURIFY) $(CC) $(EXE_LDFLAGS) $(XLDFLAGS) $(MAINOBJ) " \
+        "$(EXTOBJS) $(LIBRUBYARG_STATIC) $(OUTFLAG)$@\n" \
+        "# -- End of tebako patch --"
+
+      TEMPLATE_MAKEFILE_IN_BASE_PATCH_MSYS =
+        "# -- Start of tebako patch --\n" \
+        "\t\t$(Q) $(PURIFY) $(CC) $(EXE_LDFLAGS) $(XLDFLAGS) $(RUBY_EXP) $(MAINOBJ) " \
+        "$(EXTOBJS) $(LIBRUBYARG_STATIC) $(OUTFLAG)$@\n" \
+        "# -- End of tebako patch --"
+
+      def template_makefile_in_patch_two(ostype, ruby_ver)
+        if PatchHelpers.msys?(ostype)
+          { TEMPLATE_MAKEFILE_IN_BASE_PATTERN => TEMPLATE_MAKEFILE_IN_BASE_PATCH_MSYS }
+        elsif PatchHelpers.ruby31?(ruby_ver)
+          { TEMPLATE_MAKEFILE_IN_BASE_PATTERN => TEMPLATE_MAKEFILE_IN_BASE_PATCH }
+        else
+          { TEMPLATE_MAKEFILE_IN_BASE_PATTERN_PRE_3_1 => TEMPLATE_MAKEFILE_IN_BASE_PATCH_PRE_3_1 }
+        end
+      end
+
+      # This MSYS specific thing ensure compilation of winmain.c
+      # Did try to understand why it did not work out of the box
+      GNUMAKEFILE_IN_WINMAIN_SUBST = <<~SUBST
+        RUBYDEF = $(DLL_BASE_NAME).def
+
+        # Start of tebako patch
+        WINMAINOBJ    = win32/winmain.$(OBJEXT)
+        $(WINMAINOBJ): win32/winmain.c
+        # End of tebako patch
+      SUBST
+
+      # Other MSYS (GNUMakefile) specific patches
+      #  - The same issue with libraries as for Makefile above
+      #  - 'Kill' ruby.exp regeneration on pass2
+      #     since we want to use outpu from pass1 for implib generation
+      #     [VERY UGLY HACK]
+      #  - Introduce LIBRUBY dependency on static extensions
+      #    This is an addition to COMMON_MK_PATCH specified above
+      def get_gnumakefile_in_patch_p2(ruby_ver) # rubocop:disable Metrics/MethodLength
+        objext = PatchHelpers.ruby32?(ruby_ver) ? "$(OBJEXT)" : "@OBJEXT@"
+
+        {
+          "$(WPROGRAM): $(RUBYW_INSTALL_NAME).res.#{objext}" =>
+            "$(WPROGRAM): $(RUBYW_INSTALL_NAME).res.#{objext} $(WINMAINOBJ)  # tebako patched",
+
+          "RUBYDEF = $(DLL_BASE_NAME).def" => GNUMAKEFILE_IN_WINMAIN_SUBST,
+
+          "$(MAINOBJ) $(EXTOBJS) $(LIBRUBYARG) $(LIBS) -o $@" =>
+            "$(WINMAINOBJ) $(EXTOBJS) $(LIBRUBYARG) $(MAINLIBS) -o $@  # tebako patched",
+
+          "$(RUBY_EXP): $(LIBRUBY_A)" => "dummy.exp: $(LIBRUBY_A) # tebako patched",
+
+          "$(PROGRAM): $(RUBY_INSTALL_NAME).res.#{objext}" =>
+            "$(PROGRAM): $(RUBY_INSTALL_NAME).res.#{objext} $(LIBRUBY_A) # tebako patched\n" \
+            "$(LIBRUBY_A): $(LIBRUBY_A_OBJS) $(INITOBJS) # tebako patched\n"
+        }
+      end
+    end
+  end
+end

data/lib/tebako/packager/patch_helpers.rb

@@ -61,6 +61,16 @@ module Tebako
           out
         end
 
+        def msys?(ostype)
+          ostype =~ /msys|cygwin|mingw/
+        end
+
+        def patch_c_file(pattern)
+          {
+            pattern => "#{PatchLiterals::C_FILE_SUBST}\n#{pattern}"
+          }
+        end
+
         def recreate(dirname)
           FileUtils.rm_rf(dirname, noop: nil, verbose: nil, secure: true)
           FileUtils.mkdir(dirname)

data/lib/tebako/packager/patch_libraries.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2021-2024 [Ribose Inc](https://www.ribose.com).
+# All rights reserved.
+# This file is a part of tebako
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+require_relative "patch_helpers"
+
+# Tebako - an executable packager
+module Tebako
+  module Packager
+    # Ruby patching definitions (pass2)
+    module PatchLibraries
+      class << self
+        # rubocop:disable Style/WordArray
+
+        # NOTE: folly provides build-in implementation of jemalloc
+
+        DARWIN_BREW_LIBS = [
+          ["zlib", "z"],            ["gdbm", "gdbm"],           ["readline", "readline"], ["libffi", "ffi"],
+          ["ncurses", "ncurses"],   ["fmt", "fmt"],             ["lz4", "lz4"],           ["xz", "lzma"],
+          ["libyaml", "yaml"],      ["boost", "boost_chrono"],
+          ["double-conversion", "double-conversion"]
+        ].freeze
+
+        DARWIN_BREW_LIBS_PRE_31 = [["openssl@1.1", "ssl"], ["openssl@1.1", "crypto"]].freeze
+
+        DARWIN_BREW_LIBS_31 = [["libyaml", "yaml"], ["openssl@3", "ssl"], ["openssl@3", "crypto"]].freeze
+
+        DARWIN_DEP_LIBS = ["glog", "gflags", "brotlienc", "brotlidec", "brotlicommon"].freeze
+        # rubocop:enable Style/WordArray
+
+        def process_brew_libs!(libs, brew_libs)
+          brew_libs.each { |lib| libs << "#{PatchHelpers.get_prefix_macos(lib[0]).chop}/lib/lib#{lib[1]}.a " }
+        end
+
+        def darwin_libs(deps_lib_dir, ruby_ver)
+          libs = String.new
+
+          process_brew_libs!(libs, PatchHelpers.ruby31?(ruby_ver) ? DARWIN_BREW_LIBS_31 : DARWIN_BREW_LIBS_PRE_31)
+          process_brew_libs!(libs, DARWIN_BREW_LIBS)
+
+          DARWIN_DEP_LIBS.each { |lib| libs << "#{deps_lib_dir}/lib#{lib}.a " }
+          <<~SUBST
+            -ltebako-fs -ldwarfs-wr -ldwarfs -force_load #{deps_lib_dir}/libdwarfs_compression.a -lfolly -lfsst -lmetadata_thrift -lthrift_light -lxxhash \
+            -lzstd #{libs} -ljemalloc -lc++ -lc++abi
+          SUBST
+        end
+
+        # .....................................................
+        #  Notes re linux libraries
+        #   1) This order is important: -lgcc_eh -l:libunwind.a -l:liblzma.a  lzma is used to process debug sections.
+        #      gcc_eh shall be linked before unwind to avoid duplicate symbols.
+        #   2) -lgcc_eh assumes -static-libgcc (applied in CMakeLists.ext, RUBY_C_FLAGS)
+        #   3) -static-libstdc++ did not work, not sure why  [TODO ?]
+        #   4) When clang is used linker links libraries specified in exensions in such way that they are linked shared
+        #      (libz, libffi, libreadline, libncurses, libtinfo, ... )
+        #      Using stuff like -l:libz.a  does not help; there is a reference to libz.so anyway.
+        #      This is fixed by ext/extmk.rb patch [TODO ?]
+        # .....................................................
+
+        def linux_common_libs
+          <<~SUBST
+            -l:libtebako-fs.a -l:libdwarfs-wr.a -l:libdwarfs.a -Wl,--push-state,--whole-archive -l:libdwarfs_compression.a -Wl,--pop-state -l:libfolly.a -l:libfsst.a           \\
+            -l:libmetadata_thrift.a -l:libthrift_light.a -l:libxxhash.a -l:libfmt.a -l:libdouble-conversion.a -l:libglog.a -l:libgflags.a -l:libevent.a                         \\
+          SUBST
+        end
+
+        def common_enc_libs
+          "-l:liblz4.a -l:libz.a -l:libzstd.a -l:libbrotlienc.a -l:libbrotlidec.a -l:libbrotlicommon.a -l:liblzma.a"
+        end
+
+        def linux_gnu_libs(ruby_ver)
+          <<~SUBST
+            #{linux_common_libs} \
+            -l:libarchive.a -l:libiberty.a -l:libacl.a -l:libssl.a -l:libcrypto.a #{common_enc_libs} \\
+            -l:libgdbm.a -l:libreadline.a -l:libtinfo.a -l:libffi.a -l:libncurses.a -l:libjemalloc.a -l:libcrypt.a -l:libanl.a #{PatchHelpers.yaml_reference(ruby_ver)} \\
+            -l:libboost_system.a -l:libboost_chrono.a -l:libutil.a -l:libstdc++.a -lgcc_eh -l:libunwind.a -l:liblzma.a -l:librt.a -ldl -lpthread -lm
+          SUBST
+        end
+
+        def linux_musl_libs(ruby_ver)
+          <<~SUBST
+            #{linux_common_libs} \
+            -l:libiberty.a  -l:libacl.a -l:libssl.a -l:libcrypto.a #{common_enc_libs} -l:libreadline.a  \\
+            -l:libgdbm.a  -l:libffi.a -l:libncurses.a -l:libjemalloc.a -l:libcrypt.a  #{PatchHelpers.yaml_reference(ruby_ver)} -l:libboost_system.a -l:libboost_chrono.a \\
+            -l:librt.a -l:libstdc++.a -lgcc_eh -l:libunwind.a -l:liblzma.a -ldl -lpthread
+          SUBST
+        end
+
+        # Used for mkconfig.rb
+        def msys_base_libs(ruby_ver)
+          <<~SUBST
+            "-l:libtebako-fs.a -l:libdwarfs-wr.a -l:libdwarfs.a -l:libdwarfs_compression.a -l:libfolly.a -l:libfsst.a "          \\
+            "-l:libmetadata_thrift.a -l:libthrift_light.a -l:libxxhash.a -l:libfmt.a -l:libdouble-conversion.a -l:libglog.a -l:libgflags.a -l:libevent.a " \\
+            "-l:liblz4.a -l:libz.a -l:libzstd.a -l:liblzma.a -l:libncurses.a -l:libunwind.a -l:liblzma.a -l:libiberty.a #{PatchHelpers.yaml_reference(ruby_ver)} " \\
+            "-l:libffi.a -l:libboost_system-mt.a -l:libboost_chrono-mt.a -l:libstdc++.a -l:libdl.a -static-libgcc -static-libstdc++ -l:libssl.a -l:libcrypto.a " \\
+            "-l:libz.a -l:libwinpthread.a -lcrypt32 -lshlwapi -lwsock32 -liphlpapi -limagehlp -lbcrypt -lole32 -loleaut32 -luuid"
+          SUBST
+        end
+
+        # Used in Makefile
+        def msys_libs(ruby_ver)
+          <<~SUBST
+            -Wl,-Bstatic #{linux_common_libs} \
+            -l:liblz4.a -l:libz.a -l:libzstd.a -l:liblzma.a -l:libncurses.a -l:libunwind.a -l:liblzma.a -l:libiberty.a #{PatchHelpers.yaml_reference(ruby_ver)}            \\
+            -l:libffi.a -l:libboost_system-mt.a -l:libboost_chrono-mt.a -l:libstdc++.a -l:libdl.a -static-libgcc -static-libstdc++ -l:libssl.a -l:libcrypto.a -l:libz.a    \\
+            -l:libwinpthread.a -lcrypt32 -lshlwapi -lwsock32 -liphlpapi -limagehlp -lshlwapi -lbcrypt -lws2_32 -lole32 -loleaut32 -luuid
+          SUBST
+        end
+
+        def mlibs(ostype, deps_lib_dir, ruby_ver) # rubocop:disable Metrics/MethodLength
+          case ostype
+          when /linux-gnu/
+            linux_gnu_libs(ruby_ver)
+          when /linux-musl/
+            linux_musl_libs(ruby_ver)
+          when /darwin/
+            darwin_libs(deps_lib_dir, ruby_ver)
+          when /msys/
+            msys_libs(ruby_ver)
+          else
+            raise Tebako::Error, "Unknown ostype #{ostype}"
+          end
+        end
+      end
+    end
+  end
+end