src/Makefile.shlib

   1 #-------------------------------------------------------------------------
   2 #
   3 # Makefile.shlib
   4 #    Common rules for building shared libraries
   5 #
   6 # Copyright (c) 1998, Regents of the University of California
   7 #
   8 # IDENTIFICATION
   9 #    src/Makefile.shlib
  10 #
  11 #-------------------------------------------------------------------------
  12
  13 # This file should be included by any Postgres module Makefile that
  14 # wants to build a shared library (if possible for the current
  15 # platform). A static library is also built from the same object
  16 # files. Only one library can be built per makefile.
  17 #
  18 # Before including this file, the module Makefile must define these
  19 # variables:
  20 #
  21 # NAME                  Name of library to build (no suffix nor "lib" prefix)
  22 # OBJS                  List of object files to include in library
  23 # SHLIB_LINK            Stuff to append to library's link command
  24 #                       (typically, -L and -l switches for external libraries)
  25 # SHLIB_LINK_INTERNAL   -L and -l switches for Postgres-supplied libraries
  26 # SHLIB_PREREQS         Order-only prerequisites for library build target
  27 # SHLIB_EXPORTS         (optional) Name of file containing list of symbols to
  28 #                       export, in the format "function_name  number"
  29 #
  30 # Don't use SHLIB_LINK for references to files in the build tree, or the
  31 # wrong things will happen --- use SHLIB_LINK_INTERNAL for those!
  32 #
  33 # When building a shared library, the following version information
  34 # must also be set.  It should be omitted when building a dynamically
  35 # loadable module.
  36 #
  37 # SO_MAJOR_VERSION      Major version number to use for shared library
  38 # SO_MINOR_VERSION      Minor version number to use for shared library
  39 # (If you want a patchlevel, include it in SO_MINOR_VERSION, e.g., "6.2".)
  40 #
  41 # The module Makefile must also include
  42 # $(top_builddir)/src/Makefile.global before including this file.
  43 # (Makefile.global sets PORTNAME and other needed symbols.)
  44 #
  45 # This makefile provides the following (phony) targets:
  46 #
  47 # all-lib               build the static and shared (if applicable) libraries
  48 # install-lib           install the libraries into $(libdir)
  49 # installdirs-lib       create installation directory $(libdir)
  50 # uninstall-lib         remove the libraries from $(libdir)
  51 # clean-lib             delete the static and shared libraries from the build dir
  52 #
  53 # Typically you would add `all-lib' to the `all' target so that `make all'
  54 # builds the libraries.  In the most simple case it would look like this:
  55 #
  56 #     all: all-lib
  57 #
  58 # Similarly, the install rule might look like
  59 #
  60 #     install: install-lib
  61 #
  62 # plus any additional things you want to install. Et cetera.
  63 #
  64 # Got that?  Look at src/interfaces/libpq/Makefile for an example.
  65 #
  66
  67
  68 COMPILER = $(CC) $(CFLAGS)
  69 LINK.static = $(AR) $(AROPT)
  70
  71 LDFLAGS_INTERNAL += $(SHLIB_LINK_INTERNAL)
  72
  73
  74
  75 ifdef SO_MAJOR_VERSION
  76 # Default library naming convention used by the majority of platforms
  77 shlib           = lib$(NAME)$(DLSUFFIX).$(SO_MAJOR_VERSION).$(SO_MINOR_VERSION)
  78 shlib_major     = lib$(NAME)$(DLSUFFIX).$(SO_MAJOR_VERSION)
  79 shlib_bare      = lib$(NAME)$(DLSUFFIX)
  80 # Testing the soname variable is a reliable way to determine whether a
  81 # linkable library is being built.
  82 soname          = $(shlib_major)
  83 pkgconfigdir = $(libdir)/pkgconfig
  84 else
  85 # Naming convention for dynamically loadable modules
  86 shlib           = $(NAME)$(DLSUFFIX)
  87 endif
  88 stlib           = lib$(NAME).a
  89
  90 ifndef soname
  91 # additional flags for backend modules
  92 SHLIB_LINK += $(BE_DLLLIBS)
  93 endif
  94
  95 # For each platform we support shared libraries on, set shlib to the
  96 # name of the library (if default above is not right), set
  97 # LINK.shared to the command to link the library,
  98 # and adjust SHLIB_LINK if necessary.
  99
 100 # Try to keep the sections in some kind of order, folks...
 101
 102 override CFLAGS += $(CFLAGS_SL)
 103 override CXXFLAGS += $(CFLAGS_SL)
 104 ifdef SO_MAJOR_VERSION
 105 # libraries ought to use this to refer to versioned gettext domain names
 106 override CPPFLAGS += -DSO_MAJOR_VERSION=$(SO_MAJOR_VERSION)
 107 endif
 108
 109 ifeq ($(PORTNAME), aix)
 110   ifdef SO_MAJOR_VERSION
 111     shlib               = lib$(NAME)$(DLSUFFIX).$(SO_MAJOR_VERSION)
 112   endif
 113   haslibarule   = yes
 114   # $(exports_file) is also usable as an import file
 115   exports_file          = lib$(NAME).exp
 116 endif
 117
 118 ifeq ($(PORTNAME), darwin)
 119   ifdef soname
 120     # linkable library
 121     DLSUFFIX            = .dylib
 122     ifneq ($(SO_MAJOR_VERSION), 0)
 123       version_link      = -compatibility_version $(SO_MAJOR_VERSION) -current_version $(SO_MAJOR_VERSION).$(SO_MINOR_VERSION)
 124     endif
 125     LINK.shared         = $(COMPILER) -dynamiclib -install_name '$(libdir)/lib$(NAME).$(SO_MAJOR_VERSION)$(DLSUFFIX)' $(version_link) $(exported_symbols_list) -multiply_defined suppress
 126     shlib               = lib$(NAME).$(SO_MAJOR_VERSION).$(SO_MINOR_VERSION)$(DLSUFFIX)
 127     shlib_major         = lib$(NAME).$(SO_MAJOR_VERSION)$(DLSUFFIX)
 128   else
 129     # loadable module
 130     DLSUFFIX            = .so
 131     LINK.shared         = $(COMPILER) -bundle -multiply_defined suppress
 132   endif
 133   BUILD.exports         = $(AWK) '/^[^\#]/ {printf "_%s\n",$$1}' $< >$@
 134   exports_file          = $(SHLIB_EXPORTS:%.txt=%.list)
 135   ifneq (,$(exports_file))
 136     exported_symbols_list = -exported_symbols_list $(exports_file)
 137   endif
 138 endif
 139
 140 ifeq ($(PORTNAME), openbsd)
 141   LINK.shared           = $(COMPILER) -shared
 142   ifdef soname
 143     LINK.shared         += -Wl,-x,-soname,$(soname)
 144   endif
 145   BUILD.exports         = ( echo '{ global:'; $(AWK) '/^[^\#]/ {printf "%s;\n",$$1}' $<; echo ' local: *; };' ) >$@
 146   exports_file          = $(SHLIB_EXPORTS:%.txt=%.list)
 147   ifneq (,$(exports_file))
 148     LINK.shared         += -Wl,--version-script=$(exports_file)
 149   endif
 150   SHLIB_LINK            += -lc
 151 endif
 152
 153 ifeq ($(PORTNAME), freebsd)
 154   ifdef SO_MAJOR_VERSION
 155     shlib               = lib$(NAME)$(DLSUFFIX).$(SO_MAJOR_VERSION)
 156   endif
 157   LINK.shared           = $(COMPILER) -shared
 158   ifdef soname
 159     LINK.shared         += -Wl,-x,-soname,$(soname)
 160   endif
 161   BUILD.exports         = ( echo '{ global:'; $(AWK) '/^[^\#]/ {printf "%s;\n",$$1}' $<; echo ' local: *; };' ) >$@
 162   exports_file          = $(SHLIB_EXPORTS:%.txt=%.list)
 163   ifneq (,$(exports_file))
 164     LINK.shared         += -Wl,--version-script=$(exports_file)
 165   endif
 166 endif
 167
 168 ifeq ($(PORTNAME), netbsd)
 169   LINK.shared           = $(COMPILER) -shared
 170   ifdef soname
 171     LINK.shared         += -Wl,-x,-soname,$(soname)
 172   endif
 173   BUILD.exports         = ( echo '{ global:'; $(AWK) '/^[^\#]/ {printf "%s;\n",$$1}' $<; echo ' local: *; };' ) >$@
 174   exports_file          = $(SHLIB_EXPORTS:%.txt=%.list)
 175   ifneq (,$(exports_file))
 176     LINK.shared         += -Wl,--version-script=$(exports_file)
 177   endif
 178 endif
 179
 180 ifeq ($(PORTNAME), hpux)
 181   ifdef SO_MAJOR_VERSION
 182     shlib                       = lib$(NAME)$(DLSUFFIX).$(SO_MAJOR_VERSION)
 183   endif
 184   ifeq ($(with_gnu_ld), yes)
 185     LINK.shared         = $(CC) -shared -Wl,-Bsymbolic
 186     ifdef soname
 187       LINK.shared       += -Wl,-h -Wl,$(soname)
 188     endif
 189   else
 190     LINK.shared         = $(LD) -b -Bsymbolic
 191     ifdef soname
 192       LINK.shared       += +h $(soname)
 193     endif
 194     # can't use the CC-syntax rpath pattern here, so instead:
 195     rpath =
 196     ifeq ($(enable_rpath), yes)
 197       LINK.shared       += +s +b '$(rpathdir)'
 198     endif
 199     # On HPUX platforms, gcc is usually configured to search for libraries
 200     # in /usr/local/lib, but ld won't do so.  Add an explicit -L switch so
 201     # ld can find the same libraries gcc does.  Make sure it goes after any
 202     # -L switches provided explicitly.
 203     ifeq ($(GCC), yes)
 204       SHLIB_LINK        += -L/usr/local/lib
 205     endif
 206   endif
 207   # And we need to link with libgcc, too
 208   ifeq ($(GCC), yes)
 209     SHLIB_LINK          += `$(CC) $(LDFLAGS) -print-libgcc-file-name`
 210   endif
 211 endif
 212
 213 ifeq ($(PORTNAME), linux)
 214   LINK.shared           = $(COMPILER) -shared
 215   ifdef soname
 216     LINK.shared         += -Wl,-soname,$(soname)
 217   endif
 218   BUILD.exports         = ( echo '{ global:'; $(AWK) '/^[^\#]/ {printf "%s;\n",$$1}' $<; echo ' local: *; };' ) >$@
 219   exports_file          = $(SHLIB_EXPORTS:%.txt=%.list)
 220   ifneq (,$(exports_file))
 221     LINK.shared         += -Wl,--version-script=$(exports_file)
 222   endif
 223 endif
 224
 225 ifeq ($(PORTNAME), solaris)
 226   ifeq ($(GCC), yes)
 227     LINK.shared         = $(COMPILER) -shared -Wl,-Bsymbolic
 228   else
 229     LINK.shared         = $(COMPILER) -G -Bsymbolic
 230   endif
 231   ifdef soname
 232     ifeq ($(with_gnu_ld), yes)
 233       LINK.shared       += -Wl,-soname,$(soname)
 234     else
 235       LINK.shared       += -h $(soname)
 236     endif
 237   endif
 238 endif
 239
 240 ifeq ($(PORTNAME), cygwin)
 241   LINK.shared           = $(CC) -shared
 242   ifdef SO_MAJOR_VERSION
 243     shlib               = cyg$(NAME)$(DLSUFFIX)
 244   endif
 245   haslibarule   = yes
 246 endif
 247
 248 ifeq ($(PORTNAME), win32)
 249   ifdef SO_MAJOR_VERSION
 250     shlib               = lib$(NAME)$(DLSUFFIX)
 251   endif
 252   haslibarule   = yes
 253 endif
 254
 255
 256
 257 ##
 258 ## BUILD
 259 ##
 260
 261 .PHONY: all-lib all-static-lib all-shared-lib
 262
 263 all-lib: all-shared-lib
 264 ifdef soname
 265 # no static library when building a dynamically loadable module
 266 all-lib: all-static-lib
 267 all-lib: lib$(NAME).pc
 268 endif
 269
 270 all-static-lib: $(stlib)
 271
 272 all-shared-lib: $(shlib)
 273
 274 # In this rule, "touch $@" works around a problem on some platforms wherein
 275 # ranlib updates the library file's mod time with a value calculated to
 276 # seconds precision.  If the filesystem has sub-second timestamps, this can
 277 # cause the library file to appear older than its input files, triggering
 278 # parallel-make problems.
 279 ifndef haslibarule
 280 $(stlib): $(OBJS) | $(SHLIB_PREREQS)
 281         rm -f $@
 282         $(LINK.static) $@ $^
 283         $(RANLIB) $@
 284         touch $@
 285 endif #haslibarule
 286
 287
 288 ifeq (,$(filter cygwin win32,$(PORTNAME)))
 289 ifneq ($(PORTNAME), aix)
 290
 291 # Normal case
 292 $(shlib): $(OBJS) | $(SHLIB_PREREQS)
 293         $(LINK.shared) -o $@ $(OBJS) $(LDFLAGS) $(LDFLAGS_SL) $(SHLIB_LINK)
 294 ifdef shlib_major
 295 # If we're using major and minor versions, then make a symlink to major-version-only.
 296 ifneq ($(shlib), $(shlib_major))
 297         rm -f $(shlib_major)
 298         $(LN_S) $(shlib) $(shlib_major)
 299 endif
 300 # Make sure we have a link to a name without any version numbers
 301 ifneq ($(shlib), $(shlib_bare))
 302         rm -f $(shlib_bare)
 303         $(LN_S) $(shlib) $(shlib_bare)
 304 endif
 305 endif # shlib_major
 306
 307 # Where possible, restrict the symbols exported by the library to just the
 308 # official list, so as to avoid unintentional ABI changes.  On recent macOS
 309 # this also quiets multiply-defined-symbol warnings in programs that use
 310 # libpgport along with libpq.
 311 ifneq (,$(SHLIB_EXPORTS))
 312 ifdef BUILD.exports
 313 $(shlib): $(SHLIB_EXPORTS:%.txt=%.list)
 314
 315 $(SHLIB_EXPORTS:%.txt=%.list): %.list: %.txt
 316         $(BUILD.exports)
 317 endif
 318 endif
 319
 320 else # PORTNAME == aix
 321
 322 # AIX case
 323
 324 # See notes in src/backend/parser/Makefile about the following two rules
 325 $(stlib): $(shlib)
 326         touch $@
 327
 328 $(shlib): $(OBJS) | $(SHLIB_PREREQS)
 329         rm -f $(stlib)
 330         $(LINK.static) $(stlib) $^
 331         $(RANLIB) $(stlib)
 332         $(MKLDEXPORT) $(stlib) $(shlib) >$(exports_file)
 333         $(COMPILER) -o $(shlib) $(stlib) -Wl,-bE:$(exports_file) $(LDFLAGS) $(LDFLAGS_SL) $(SHLIB_LINK)
 334         rm -f $(stlib)
 335         $(AR) $(AROPT) $(stlib) $(shlib)
 336
 337 endif # PORTNAME == aix
 338
 339 else # PORTNAME == cygwin || PORTNAME == win32
 340
 341 ifeq ($(PORTNAME), cygwin)
 342
 343 # Cygwin case
 344
 345 $(shlib): $(OBJS) | $(SHLIB_PREREQS)
 346         $(CC) $(CFLAGS)  -shared -o $@ -Wl,--out-implib=$(stlib) $(OBJS) $(LDFLAGS) $(LDFLAGS_SL) $(SHLIB_LINK) $(LIBS) $(LDAP_LIBS_BE)
 347
 348 # see notes in src/backend/parser/Makefile  about use of this type of rule
 349 $(stlib): $(shlib)
 350         touch $@
 351
 352 else
 353
 354 # Win32 case
 355
 356 # See notes in src/backend/parser/Makefile about the following two rules
 357 $(stlib): $(shlib)
 358         touch $@
 359
 360 # XXX A backend that loads a module linked with libgcc_s_dw2-1.dll will exit
 361 # uncleanly, hence -static-libgcc.  (Last verified with MinGW-w64 compilers
 362 # from i686-4.9.1-release-win32-dwarf-rt_v3-rev1.)  Shared libgcc has better
 363 # support for C++/Java exceptions; while core PostgreSQL does not use them, it
 364 # would be nice to support shared libgcc for the benefit of extensions.
 365 #
 366 # If SHLIB_EXPORTS is set, the rules below will build a .def file from that.
 367 # Else we just use --export-all-symbols.
 368 ifeq (,$(SHLIB_EXPORTS))
 369 $(shlib): $(OBJS) | $(SHLIB_PREREQS)
 370         $(CC) $(CFLAGS)  -shared -static-libgcc -o $@  $(OBJS) $(LDFLAGS) $(LDFLAGS_SL) $(SHLIB_LINK) $(LIBS) -Wl,--export-all-symbols -Wl,--out-implib=$(stlib)
 371 else
 372 DLL_DEFFILE = lib$(NAME)dll.def
 373
 374 $(shlib): $(OBJS) $(DLL_DEFFILE) | $(SHLIB_PREREQS)
 375         $(CC) $(CFLAGS)  -shared -static-libgcc -o $@  $(OBJS) $(DLL_DEFFILE) $(LDFLAGS) $(LDFLAGS_SL) $(SHLIB_LINK) $(LIBS) -Wl,--out-implib=$(stlib)
 376
 377 UC_NAME = $(shell echo $(NAME) | tr 'abcdefghijklmnopqrstuvwxyz' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ')
 378
 379 $(DLL_DEFFILE): $(SHLIB_EXPORTS)
 380         echo 'LIBRARY LIB$(UC_NAME).dll' >$@
 381         echo 'EXPORTS' >>$@
 382         sed -e '/^#/d' -e 's/^\(.*[     ]\)\([0-9][0-9]*\)/    \1@ \2/' $< >>$@
 383 endif
 384
 385 endif # PORTNAME == cygwin
 386 endif # PORTNAME == cygwin || PORTNAME == win32
 387
 388
 389 %.pc: $(MAKEFILE_LIST)
 390         echo 'Name: lib$(NAME)' >$@
 391         echo 'Description: PostgreSQL lib$(NAME) library' >>$@
 392         echo 'Url: $(PACKAGE_URL)' >>$@
 393         echo 'Version: $(VERSION)' >>$@
 394         echo 'Requires: ' >>$@
 395         echo 'Requires.private: $(PKG_CONFIG_REQUIRES_PRIVATE)' >>$@
 396         echo 'Cflags: -I$(includedir)' >>$@
 397         echo 'Libs: -L$(libdir) -l$(NAME)' >>$@
 398 # Record -L flags that the user might have passed in to the PostgreSQL
 399 # build to locate third-party libraries (e.g., ldap, ssl).  Filter out
 400 # those that point inside the build or source tree.  Use sort to
 401 # remove duplicates.  Also record the -l flags necessary for static
 402 # linking, but not those already covered by Requires.private.
 403         echo 'Libs.private: $(sort $(filter-out -L.% -L$(top_srcdir)/%,$(filter -L%,$(LDFLAGS) $(SHLIB_LINK)))) $(filter-out $(PKG_CONFIG_REQUIRES_PRIVATE:lib%=-l%),$(filter -l%,$(SHLIB_LINK)))' >>$@
 404
 405
 406 ##
 407 ## INSTALL
 408 ##
 409
 410 .PHONY: install-lib install-lib-static install-lib-shared installdirs-lib
 411 install-lib: install-lib-shared
 412 ifdef soname
 413 install-lib: install-lib-static
 414 install-lib: install-lib-pc
 415 endif
 416
 417 install-lib-pc: lib$(NAME).pc installdirs-lib
 418         $(INSTALL_DATA) $< '$(DESTDIR)$(pkgconfigdir)/lib$(NAME).pc'
 419
 420 install-lib-static: $(stlib) installdirs-lib
 421         $(INSTALL_STLIB) $< '$(DESTDIR)$(libdir)/$(stlib)'
 422 ifeq ($(PORTNAME), darwin)
 423         cd '$(DESTDIR)$(libdir)' && \
 424         $(RANLIB) $(stlib)
 425 endif
 426
 427 install-lib-shared: $(shlib) installdirs-lib
 428 ifdef soname
 429 # we don't install $(shlib) on AIX
 430 # (see http://archives.postgresql.org/message-id/52EF20B2E3209443BC37736D00C3C1380A6E79FE@EXADV1.host.magwien.gv.at)
 431 ifneq ($(PORTNAME), aix)
 432         $(INSTALL_SHLIB) $< '$(DESTDIR)$(libdir)/$(shlib)'
 433 ifneq ($(PORTNAME), cygwin)
 434 ifneq ($(PORTNAME), win32)
 435 ifneq ($(shlib), $(shlib_major))
 436         cd '$(DESTDIR)$(libdir)' && \
 437         rm -f $(shlib_major) && \
 438         $(LN_S) $(shlib) $(shlib_major)
 439 endif
 440 ifneq ($(shlib), $(shlib_bare))
 441         cd '$(DESTDIR)$(libdir)' && \
 442         rm -f $(shlib_bare) && \
 443         $(LN_S) $(shlib) $(shlib_bare)
 444 endif
 445 endif # not win32
 446 endif # not cygwin
 447 endif # not aix
 448 ifneq (,$(findstring $(PORTNAME),win32 cygwin))
 449         $(INSTALL_SHLIB) $< '$(DESTDIR)$(bindir)/$(shlib)'
 450 endif
 451 else # no soname
 452         $(INSTALL_SHLIB) $< '$(DESTDIR)$(pkglibdir)/$(shlib)'
 453 endif
 454
 455
 456 installdirs-lib:
 457 ifdef soname
 458         $(MKDIR_P) '$(DESTDIR)$(libdir)' '$(DESTDIR)$(pkgconfigdir)' $(if $(findstring $(PORTNAME),win32 cygwin),'$(DESTDIR)$(bindir)')
 459 else
 460         $(MKDIR_P) '$(DESTDIR)$(pkglibdir)'
 461 endif
 462
 463
 464 ##
 465 ## UNINSTALL
 466 ##
 467
 468 .PHONY: uninstall-lib
 469 uninstall-lib:
 470 ifdef soname
 471         rm -f '$(DESTDIR)$(libdir)/$(stlib)'
 472         rm -f '$(DESTDIR)$(libdir)/$(shlib_bare)' \
 473           '$(DESTDIR)$(libdir)/$(shlib_major)' \
 474           '$(DESTDIR)$(libdir)/$(shlib)' $(if $(findstring $(PORTNAME),win32 cygwin),'$(DESTDIR)$(bindir)/$(shlib)') \
 475           '$(DESTDIR)$(pkgconfigdir)/lib$(NAME).pc'
 476 else # no soname
 477         rm -f '$(DESTDIR)$(pkglibdir)/$(shlib)'
 478 endif # no soname
 479
 480
 481 ##
 482 ## CLEAN
 483 ##
 484
 485 .PHONY: clean-lib
 486 clean-lib:
 487         rm -f $(shlib) $(shlib_bare) $(shlib_major) $(stlib) $(exports_file) lib$(NAME).pc
 488 ifneq (,$(DLL_DEFFILE))
 489         rm -f $(DLL_DEFFILE)
 490 endif