scripts/libtool.mk

   1 # Copyright 2008, 2009, 2010 Dan Moulding, Alan T. DeKok
   2 #
   3 # This program is free software: you can redistribute it and/or modify
   4 # it under the terms of the GNU General Public License as published by
   5 # the Free Software Foundation, either version 3 of the License, or
   6 # (at your option) any later version.
   7 #
   8 # This program is distributed in the hope that it will be useful,
   9 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11 # GNU General Public License for more details.
  12 #
  13 # You should have received a copy of the GNU General Public License
  14 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  15
  16 # Add these rules only when LIBTOOL is being used.
  17 ifneq "${LIBTOOL}" ""
  18
  19 # JLIBTOOL - check if we're using the local (fast) jlibtool, rather
  20 #   than the GNU (slow) libtool shell script.  If so, add rules
  21 #   to build it.
  22
  23 ifeq "${LIBTOOL}" "JLIBTOOL"
  24     JLIBTOOL := ${BUILD_DIR}/make/jlibtool
  25
  26     # Add a rule to build jlibtool BEFORE any other targets.  This
  27     # means that we can use it to build the later targets.
  28     all install: ${JLIBTOOL}
  29
  30     # Note that we need to use a compilation rule that does NOT
  31     # include referencing ${LIBTOOL}, as we don't have a jlibtool
  32     # binary!
  33     ${JLIBTOOL}: ${top_makedir}/jlibtool.c
  34         @mkdir -p $(dir $@)
  35         @echo CC jlibtool.c
  36         @${CC} $< -o $@
  37
  38     clean: jlibtool_clean
  39
  40     .PHONY: jlibtool_clean
  41     jlibtool_clean:
  42         @rm -f ${JLIBTOOL}
  43
  44     # Tell GNU Make to use this value, rather than anything specified
  45     # on the command line.
  46     override LIBTOOL := ${JLIBTOOL}
  47 endif    # else we're not using jlibtool
  48
  49 # When using libtool, it produces a '.libs' directory.  Ensure that it
  50 # is removed on "make clean", too.
  51 #
  52 clean: .libs_clean
  53
  54 .PHONY: .libs_clean
  55 .libs_clean:
  56         @rm -rf ${BUILD_DIR}/.libs/
  57
  58 # Re-define compilers and linkers
  59 #
  60 OBJ_EXT = lo
  61 COMPILE.c = ${LIBTOOL} --silent --mode=compile ${CC}
  62 COMPILE.cxx = ${LIBTOOL} --mode=compile ${CXX}
  63 LINK.c = ${LIBTOOL} --silent --mode=link ${CC}
  64 LINK.cxx = ${LIBTOOL} --mode=link ${CXX}
  65 PROGRAM_INSTALL = ${LIBTOOL} --silent --mode=install ${INSTALL}
  66
  67
  68 # LIBTOOL_ENDINGS - Given a library ending in ".a" or ".so", replace that
  69 #   extension with ".la".
  70 #
  71 define LIBTOOL_ENDINGS
  72 $(patsubst %.a,%.la,$(patsubst %.so,%.la,${1}))
  73 endef
  74
  75 # ADD_TARGET_RULE.la - Build a ".la" target.
  76 #
  77 #   USE WITH EVAL
  78 #
  79 define ADD_TARGET_RULE.la
  80     # So "make ${1}" works
  81     .PHONY: ${1}
  82     ${1}: $${${1}_BUILD}/${1}
  83
  84     # Create libtool library ${1}
  85     $${${1}_BUILD}/${1}: $${${1}_OBJS} $${${1}_PRLIBS}
  86             @$(strip mkdir -p $(dir $${${1}_BUILD}/${1}))
  87             @$(ECHO) LINK $${${1}_BUILD}/${1}
  88             @$${${1}_LINKER} -o $${${1}_BUILD}/${1} $${RPATH_FLAGS} $${LDFLAGS} \
  89                 $${${1}_LDFLAGS} $${${1}_OBJS} $${LDLIBS} $${${1}_LDLIBS} \
  90                 $${${1}_PRLIBS}
  91             @$${${1}_POSTMAKE}
  92
  93 endef
  94
  95 # ADD_RELINK_RULE.exe - Parametric "function" that adds a rule to relink
  96 #   the target before installation, so that the paths are correct.
  97 #
  98 #   USE WITH EVAL
  99 #
 100 define ADD_RELINK_RULE.exe
 101     ${1}: $${${1}_BUILD}/$${RELINK}${1}
 102
 103     # used to fix up RPATH for ${1} on install.
 104     $${${1}_BUILD}/$${${1}_RELINK}: $${${1}_OBJS} $${${1}_PRBIN} $${${1}_R_PRLIBS}
 105             @$(strip mkdir -p $${${1}_BUILD}/${RELINK}/)
 106             @$${${1}_LINKER} -o $${${1}_BUILD}/$${RELINK}${1} $${RELINK_FLAGS} $${LDFLAGS} \
 107                 $${${1}_LDFLAGS} $${${1}_OBJS} $${${1}_R_PRLIBS} \
 108                 $${LDLIBS} $${${1}_LDLIBS}
 109             @$${${1}_POSTMAKE}
 110 endef
 111
 112 # ADD_RELINK_RULE.la - Parametric "function" that adds a rule to relink
 113 #   the target before installation, so that the paths are correct.
 114 #
 115 #   USE WITH EVAL
 116 #
 117 define ADD_RELINK_RULE.la
 118     ${1}: $${${1}_BUILD}/$${RELINK}${1}
 119
 120     # used to fix up RPATH for ${1} on install.
 121     $${${1}_BUILD}/$${${1}_RELINK}: $${${1}_OBJS} $${${1}_PRLIBS}
 122             @$(strip mkdir -p $${${1}_BUILD}/${RELINK}/)
 123             @$${${1}_LINKER} -o $${${1}_BUILD}/$${RELINK}${1} $${RELINK_FLAGS} $${LDFLAGS} \
 124                 $${${1}_LDFLAGS} $${${1}_OBJS} $${LDLIBS} $${${1}_LDLIBS}
 125             @$${${1}_POSTMAKE}
 126
 127 endef
 128
 129 # By default, if libdir is defined, we build shared libraries.
 130 # However, we can disable shared libraries if explicitly told to.
 131 ifneq "${libdir}" ""
 132     ifneq "bm_shared_libs" "no"
 133         bm_shared_libs := yes
 134     endif
 135 endif
 136
 137 # Default to building static libraries, too.
 138 ifneq "${bm_static_libs}" "no"
 139     bm_static_libs := yes
 140 endif
 141
 142 # Check if we build shared libraries.
 143 ifeq "${bm_shared_libs}" "yes"
 144     RELINK := local/
 145
 146     # RPATH  : flags use to build executables that are installed,
 147     #          with no dependency on the source.
 148     # RELINL : flags use to build executables that can be run
 149     #          from the build directory / source tree.
 150     RPATH_FLAGS := -rpath ${libdir} -rdynamic
 151     RELINK_FLAGS := -rpath $(abspath ${BUILD_DIR})/lib/${RELINK}/.libs -rdynamic
 152     RELINK_FLAGS_MIN := -rpath ${libdir}
 153
 154     ifneq "${bm_static_libs}" "yes"
 155         RPATH_FLAGS += --shared
 156         RELINK_FLAGS += --shared
 157     endif
 158 else
 159     ifneq "${bm_static_libs}" "yes"
 160         $(error Building without static libraries requires you to set 'INSTALL' or 'libdir')
 161     endif
 162
 163     RPATH_FLAGS := -static
 164 endif
 165
 166 # UPDATE_TARGET_ENDINGS - Function to turn target into a libtool target
 167 #   e.g. "libfoo.a" -> libfoo.la"
 168 #
 169 #   If the target is an executable, then its extension doesn't change
 170 #   when we use libtool, and we don't do any re-writing.
 171 #
 172 #   USE WITH EVAL
 173 #
 174 define ADD_LIBTOOL_SUFFIX
 175     ifneq "$$(call LIBTOOL_ENDINGS,$${TGT})" "$${TGT}"
 176         TGT_NOLIBTOOL := $${TGT}
 177         TGT := $$(call LIBTOOL_ENDINGS,$${TGT})
 178         $${TGT}_NOLIBTOOL := $${TGT_NOLIBTOOL}
 179     endif
 180
 181     ifneq "$${RELINK_FLAGS}" ""
 182         $${TGT}_RELINK := ${RELINK}$${TGT}
 183     endif
 184
 185     # re-write all of the dependencies to have the libtool endings.
 186     TGT_PREREQS := $$(call LIBTOOL_ENDINGS,$${TGT_PREREQS})
 187 endef
 188
 189 # ADD_LIBTOOL_TARGET - Function to ensure that the object files depend
 190 #   on our jlibtool target.  This ensures that jlibtool is built before
 191 #   it's used to build the object files.
 192 #
 193 #   USE WITH EVAL
 194 #
 195 define ADD_LIBTOOL_TARGET
 196     ifneq "${JLIBTOOL}" ""
 197         $${$${TGT}_OBJS}: $${JLIBTOOL}
 198     endif
 199
 200     ifneq "$${$${TGT}_NOLIBTOOL}" ""
 201         $$(notdir $${$${TGT}_NOLIBTOOL}): $${TGT}
 202     endif
 203
 204     # If we need to relink, add the relink targets now.
 205     ifneq "$${$${TGT}_RELINK}" ""
 206         # add rules to relink the target
 207
 208         $${TGT}_R_PRLIBS := $$(subst /lib/,/lib/${RELINK},$${$${TGT}_PRLIBS})
 209
 210         $$(eval $$(call ADD_RELINK_RULE$${$${TGT}_SUFFIX},$${TGT}))
 211     endif
 212
 213 endef
 214
 215
 216 endif