mk/rt.mk

   1 # Copyright 2014 The Rust Project Developers. See the COPYRIGHT
   2 # file at the top-level directory of this distribution and at
   3 # http://rust-lang.org/COPYRIGHT.
   4 #
   5 # Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
   6 # http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
   7 # <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
   8 # option. This file may not be copied, modified, or distributed
   9 # except according to those terms.
  10
  11 ################################################################################
  12 # Native libraries built as part of the rust build process
  13 #
  14 # This portion of the rust build system is meant to keep track of native
  15 # dependencies and how to build them. It is currently required that all native
  16 # dependencies are built as static libraries, as slinging around dynamic
  17 # libraries isn't exactly the most fun thing to do.
  18 #
  19 # This section should need minimal modification to add new libraries. The
  20 # relevant variables are:
  21 #
  22 #   NATIVE_LIBS
  23 #       This is a list of all native libraries which are built as part of the
  24 #       build process. It will build all libraries into RT_OUTPUT_DIR with the
  25 #       appropriate name of static library as dictated by the target platform
  26 #
  27 #   NATIVE_DEPS_<lib>
  28 #       This is a list of files relative to the src/rt directory which are
  29 #       needed to build the native library. Each file will be compiled to an
  30 #       object file, and then all the object files will be assembled into an
  31 #       archive (static library). The list contains files of any extension
  32 #
  33 # If adding a new library, you should update the NATIVE_LIBS list, and then list
  34 # the required files below it. The list of required files is a list of files
  35 # that's per-target so you're allowed to conditionally add files based on the
  36 # target.
  37 ################################################################################
  38 NATIVE_LIBS := rust_builtin hoedown morestack miniz \
  39                 rustrt_native rust_test_helpers
  40
  41 # $(1) is the target triple
  42 define NATIVE_LIBRARIES
  43
  44 NATIVE_DEPS_hoedown_$(1) := hoedown/src/autolink.c \
  45                         hoedown/src/buffer.c \
  46                         hoedown/src/document.c \
  47                         hoedown/src/escape.c \
  48                         hoedown/src/html.c \
  49                         hoedown/src/html_blocks.c \
  50                         hoedown/src/html_smartypants.c \
  51                         hoedown/src/stack.c \
  52                         hoedown/src/version.c
  53 NATIVE_DEPS_miniz_$(1) = miniz.c
  54 NATIVE_DEPS_rust_builtin_$(1) := rust_builtin.c \
  55                         rust_android_dummy.c
  56 NATIVE_DEPS_rustrt_native_$(1) := arch/$$(HOST_$(1))/record_sp.S
  57 NATIVE_DEPS_rust_test_helpers_$(1) := rust_test_helpers.c
  58 NATIVE_DEPS_morestack_$(1) := arch/$$(HOST_$(1))/morestack.S
  59
  60
  61 ################################################################################
  62 # You shouldn't find it that necessary to edit anything below this line.
  63 ################################################################################
  64
  65 # While we're defining the native libraries for each target, we define some
  66 # common rules used to build files for various targets.
  67
  68 RT_OUTPUT_DIR_$(1) := $(1)/rt
  69
  70 $$(RT_OUTPUT_DIR_$(1))/%.o: $(S)src/rt/%.c $$(MKFILE_DEPS)
  71         @mkdir -p $$(@D)
  72         @$$(call E, compile: $$@)
  73         $$(Q)$$(call CFG_COMPILE_C_$(1), $$@, \
  74                 $$(call CFG_CC_INCLUDE_$(1),$$(S)src/rt/hoedown/src) \
  75                 $$(call CFG_CC_INCLUDE_$(1),$$(S)src/rt) \
  76                  $$(RUNTIME_CFLAGS_$(1))) $$<
  77
  78 $$(RT_OUTPUT_DIR_$(1))/%.o: $(S)src/rt/%.S $$(MKFILE_DEPS) \
  79             $$(LLVM_CONFIG_$$(CFG_BUILD))
  80         @mkdir -p $$(@D)
  81         @$$(call E, compile: $$@)
  82         $$(Q)$$(call CFG_ASSEMBLE_$(1),$$@,$$<)
  83
  84 # On MSVC targets the compiler's default include path (e.g. where to find system
  85 # headers) is specified by the INCLUDE environment variable. This may not be set
  86 # so the ./configure script scraped the relevant values and this is the location
  87 # that we put them into cl.exe's environment.
  88 ifeq ($$(findstring msvc,$(1)),msvc)
  89 $$(RT_OUTPUT_DIR_$(1))/%.o: \
  90         export INCLUDE := $$(CFG_MSVC_INCLUDE_PATH_$$(HOST_$(1)))
  91 $(1)/rustllvm/%.o: \
  92         export INCLUDE := $$(CFG_MSVC_INCLUDE_PATH_$$(HOST_$(1)))
  93 endif
  94 endef
  95
  96 $(foreach target,$(CFG_TARGET),$(eval $(call NATIVE_LIBRARIES,$(target))))
  97
  98 # A macro for devining how to build third party libraries listed above (based
  99 # on their dependencies).
 100 #
 101 # $(1) is the target
 102 # $(2) is the lib name
 103 define THIRD_PARTY_LIB
 104
 105 OBJS_$(2)_$(1) := $$(NATIVE_DEPS_$(2)_$(1):%=$$(RT_OUTPUT_DIR_$(1))/%)
 106 OBJS_$(2)_$(1) := $$(OBJS_$(2)_$(1):.c=.o)
 107 OBJS_$(2)_$(1) := $$(OBJS_$(2)_$(1):.cpp=.o)
 108 OBJS_$(2)_$(1) := $$(OBJS_$(2)_$(1):.S=.o)
 109 NATIVE_$(2)_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),$(2))
 110 $$(RT_OUTPUT_DIR_$(1))/$$(NATIVE_$(2)_$(1)): $$(OBJS_$(2)_$(1))
 111         @$$(call E, link: $$@)
 112         $$(Q)$$(call CFG_CREATE_ARCHIVE_$(1),$$@) $$^
 113
 114 endef
 115
 116 $(foreach target,$(CFG_TARGET), \
 117  $(eval $(call RUNTIME_RULES,$(target))))
 118 $(foreach lib,$(NATIVE_LIBS), \
 119  $(foreach target,$(CFG_TARGET), \
 120   $(eval $(call THIRD_PARTY_LIB,$(target),$(lib)))))
 121
 122
 123 ################################################################################
 124 # Building third-party targets with external build systems
 125 #
 126 # This location is meant for dependencies which have external build systems. It
 127 # is still assumed that the output of each of these steps is a static library
 128 # in the correct location.
 129 ################################################################################
 130
 131 define DEF_THIRD_PARTY_TARGETS
 132
 133 # $(1) is the target triple
 134
 135 ifeq ($$(CFG_WINDOWSY_$(1)), 1)
 136   # This isn't necessarily a desired option, but it's harmless and works around
 137   # what appears to be a mingw-w64 bug.
 138   #
 139   # https://sourceforge.net/p/mingw-w64/bugs/395/
 140   JEMALLOC_ARGS_$(1) := --enable-lazy-lock
 141 else ifeq ($(OSTYPE_$(1)), apple-ios)
 142   JEMALLOC_ARGS_$(1) := --disable-tls
 143 else ifeq ($(findstring android, $(OSTYPE_$(1))), android)
 144   JEMALLOC_ARGS_$(1) := --disable-tls
 145 endif
 146
 147 ifdef CFG_ENABLE_DEBUG_JEMALLOC
 148   JEMALLOC_ARGS_$(1) += --enable-debug --enable-fill
 149 endif
 150
 151 ################################################################################
 152 # jemalloc
 153 ################################################################################
 154
 155 ifdef CFG_ENABLE_FAST_MAKE
 156 JEMALLOC_DEPS := $(S)/.gitmodules
 157 else
 158 JEMALLOC_DEPS := $(wildcard \
 159                    $(S)src/jemalloc/* \
 160                    $(S)src/jemalloc/*/* \
 161                    $(S)src/jemalloc/*/*/* \
 162                    $(S)src/jemalloc/*/*/*/*)
 163 endif
 164
 165 # See #17183 for details, this file is touched during the build process so we
 166 # don't want to consider it as a dependency.
 167 JEMALLOC_DEPS := $(filter-out $(S)src/jemalloc/VERSION,$(JEMALLOC_DEPS))
 168
 169 JEMALLOC_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),jemalloc)
 170 ifeq ($$(CFG_WINDOWSY_$(1)),1)
 171   JEMALLOC_REAL_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),jemalloc_s)
 172 else
 173   JEMALLOC_REAL_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),jemalloc_pic)
 174 endif
 175 JEMALLOC_LIB_$(1) := $$(RT_OUTPUT_DIR_$(1))/$$(JEMALLOC_NAME_$(1))
 176 JEMALLOC_BUILD_DIR_$(1) := $$(RT_OUTPUT_DIR_$(1))/jemalloc
 177 JEMALLOC_LOCAL_$(1) := $$(JEMALLOC_BUILD_DIR_$(1))/lib/$$(JEMALLOC_REAL_NAME_$(1))
 178
 179 $$(JEMALLOC_LOCAL_$(1)): $$(JEMALLOC_DEPS) $$(MKFILE_DEPS)
 180         @$$(call E, make: jemalloc)
 181         cd "$$(JEMALLOC_BUILD_DIR_$(1))"; "$(S)src/jemalloc/configure" \
 182                 $$(JEMALLOC_ARGS_$(1)) --with-jemalloc-prefix=je_ $(CFG_JEMALLOC_FLAGS) \
 183                 --build=$$(CFG_GNU_TRIPLE_$(CFG_BUILD)) --host=$$(CFG_GNU_TRIPLE_$(1)) \
 184                 CC="$$(CC_$(1)) $$(CFG_JEMALLOC_CFLAGS_$(1))" \
 185                 AR="$$(AR_$(1))" \
 186                 RANLIB="$$(AR_$(1)) s" \
 187                 CPPFLAGS="-I $(S)src/rt/" \
 188                 EXTRA_CFLAGS="-g1 -ffunction-sections -fdata-sections"
 189         $$(Q)$$(MAKE) -C "$$(JEMALLOC_BUILD_DIR_$(1))" build_lib_static
 190
 191 ifeq ($$(CFG_DISABLE_JEMALLOC),)
 192 RUSTFLAGS_alloc := --cfg jemalloc
 193 ifeq ($(1),$$(CFG_BUILD))
 194 ifneq ($$(CFG_JEMALLOC_ROOT),)
 195 $$(JEMALLOC_LIB_$(1)): $$(CFG_JEMALLOC_ROOT)/libjemalloc_pic.a
 196         @$$(call E, copy: jemalloc)
 197         $$(Q)cp $$< $$@
 198 else
 199 $$(JEMALLOC_LIB_$(1)): $$(JEMALLOC_LOCAL_$(1))
 200         $$(Q)cp $$< $$@
 201 endif
 202 else
 203 $$(JEMALLOC_LIB_$(1)): $$(JEMALLOC_LOCAL_$(1))
 204         $$(Q)cp $$< $$@
 205 endif
 206 else
 207 $$(JEMALLOC_LIB_$(1)): $$(MKFILE_DEPS)
 208         $$(Q)touch $$@
 209 endif
 210
 211 ################################################################################
 212 # compiler-rt
 213 ################################################################################
 214
 215 ifdef CFG_ENABLE_FAST_MAKE
 216 COMPRT_DEPS := $(S)/.gitmodules
 217 else
 218 COMPRT_DEPS := $(wildcard \
 219               $(S)src/compiler-rt/* \
 220               $(S)src/compiler-rt/*/* \
 221               $(S)src/compiler-rt/*/*/* \
 222               $(S)src/compiler-rt/*/*/*/*)
 223 endif
 224
 225 COMPRT_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),compiler-rt)
 226 COMPRT_LIB_$(1) := $$(RT_OUTPUT_DIR_$(1))/$$(COMPRT_NAME_$(1))
 227 COMPRT_BUILD_DIR_$(1) := $$(RT_OUTPUT_DIR_$(1))/compiler-rt
 228
 229 # Note that on MSVC-targeting builds we hardwire CC/AR to gcc/ar even though
 230 # we're targeting MSVC. This is because although compiler-rt has a CMake build
 231 # config I can't actually figure out how to use it, so I'm not sure how to use
 232 # cl.exe to build the objects. Additionally, the compiler-rt library when built
 233 # with gcc has the same ABI as cl.exe, so they're largely compatible
 234 COMPRT_CC_$(1) := $$(CC_$(1))
 235 COMPRT_AR_$(1) := $$(AR_$(1))
 236 COMPRT_CFLAGS_$(1) := $$(CFG_GCCISH_CFLAGS_$(1))
 237 ifeq ($$(findstring msvc,$(1)),msvc)
 238 COMPRT_CC_$(1) := gcc
 239 COMPRT_AR_$(1) := ar
 240 ifeq ($$(findstring i686,$(1)),i686)
 241 COMPRT_CFLAGS_$(1) := $$(CFG_GCCISH_CFLAGS_$(1)) -m32
 242 else
 243 COMPRT_CFLAGS_$(1) := $$(CFG_GCCISH_CFLAGS_$(1)) -m64
 244 endif
 245 endif
 246
 247 $$(COMPRT_LIB_$(1)): $$(COMPRT_DEPS) $$(MKFILE_DEPS)
 248         @$$(call E, make: compiler-rt)
 249         $$(Q)$$(MAKE) -C "$(S)src/compiler-rt" \
 250                 ProjSrcRoot="$(S)src/compiler-rt" \
 251                 ProjObjRoot="$$(abspath $$(COMPRT_BUILD_DIR_$(1)))" \
 252                 CC='$$(COMPRT_CC_$(1))' \
 253                 AR='$$(COMPRT_AR_$(1))' \
 254                 RANLIB='$$(COMPRT_AR_$(1)) s' \
 255                 CFLAGS="$$(COMPRT_CFLAGS_$(1))" \
 256                 TargetTriple=$(1) \
 257                 triple-builtins
 258         $$(Q)cp $$(COMPRT_BUILD_DIR_$(1))/triple/builtins/libcompiler_rt.a $$@
 259
 260 ################################################################################
 261 # libbacktrace
 262 #
 263 # We use libbacktrace on linux to get symbols in backtraces, but only on linux.
 264 # Elsewhere we use other system utilities, so this library is only built on
 265 # linux.
 266 ################################################################################
 267
 268 BACKTRACE_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),backtrace)
 269 BACKTRACE_LIB_$(1) := $$(RT_OUTPUT_DIR_$(1))/$$(BACKTRACE_NAME_$(1))
 270 BACKTRACE_BUILD_DIR_$(1) := $$(RT_OUTPUT_DIR_$(1))/libbacktrace
 271
 272 # We don't use this on platforms that aren't linux-based, so just make the file
 273 # available, the compilation of libstd won't actually build it.
 274 ifeq ($$(findstring darwin,$$(OSTYPE_$(1))),darwin)
 275 # See comment above
 276 $$(BACKTRACE_LIB_$(1)):
 277         touch $$@
 278
 279 else
 280 ifeq ($$(findstring ios,$$(OSTYPE_$(1))),ios)
 281 # See comment above
 282 $$(BACKTRACE_LIB_$(1)):
 283         touch $$@
 284 else
 285
 286 ifeq ($$(CFG_WINDOWSY_$(1)),1)
 287 # See comment above
 288 $$(BACKTRACE_LIB_$(1)):
 289         touch $$@
 290 else
 291
 292 ifdef CFG_ENABLE_FAST_MAKE
 293 BACKTRACE_DEPS := $(S)/.gitmodules
 294 else
 295 BACKTRACE_DEPS := $(wildcard $(S)src/libbacktrace/*)
 296 endif
 297
 298 # We need to export CFLAGS because otherwise it doesn't pick up cross compile
 299 # builds. If libbacktrace doesn't realize this, it will attempt to read 64-bit
 300 # elf headers when compiled for a 32-bit system, yielding blank backtraces.
 301 #
 302 # This also removes the -Werror flag specifically to prevent errors during
 303 # configuration.
 304 #
 305 # Down below you'll also see echos into the config.h generated by the
 306 # ./configure script. This is done to force libbacktrace to *not* use the
 307 # atomic/sync functionality because it pulls in unnecessary dependencies and we
 308 # never use it anyway.
 309 $$(BACKTRACE_BUILD_DIR_$(1))/Makefile: $$(BACKTRACE_DEPS) $$(MKFILE_DEPS)
 310         @$$(call E, configure: libbacktrace for $(1))
 311         $$(Q)rm -rf $$(BACKTRACE_BUILD_DIR_$(1))
 312         $$(Q)mkdir -p $$(BACKTRACE_BUILD_DIR_$(1))
 313         $$(Q)(cd $$(BACKTRACE_BUILD_DIR_$(1)) && \
 314               CC="$$(CC_$(1))" \
 315               AR="$$(AR_$(1))" \
 316               RANLIB="$$(AR_$(1)) s" \
 317               CFLAGS="$$(CFG_GCCISH_CFLAGS_$(1):-Werror=) -fno-stack-protector" \
 318               $(S)src/libbacktrace/configure --target=$(1) --host=$(CFG_BUILD))
 319         $$(Q)echo '#undef HAVE_ATOMIC_FUNCTIONS' >> \
 320               $$(BACKTRACE_BUILD_DIR_$(1))/config.h
 321         $$(Q)echo '#undef HAVE_SYNC_FUNCTIONS' >> \
 322               $$(BACKTRACE_BUILD_DIR_$(1))/config.h
 323
 324 $$(BACKTRACE_LIB_$(1)): $$(BACKTRACE_BUILD_DIR_$(1))/Makefile $$(MKFILE_DEPS)
 325         @$$(call E, make: libbacktrace)
 326         $$(Q)$$(MAKE) -C $$(BACKTRACE_BUILD_DIR_$(1)) \
 327                 INCDIR=$(S)src/libbacktrace
 328         $$(Q)cp $$(BACKTRACE_BUILD_DIR_$(1))/.libs/libbacktrace.a $$@
 329
 330 endif # endif for windowsy
 331 endif # endif for ios
 332 endif # endif for darwin
 333
 334 ################################################################################
 335 # libc/libunwind for musl
 336 #
 337 # When we're building a musl-like target we're going to link libc/libunwind
 338 # statically into the standard library and liblibc, so we need to make sure
 339 # they're in a location that we can find
 340 ################################################################################
 341
 342 ifeq ($$(findstring musl,$(1)),musl)
 343 $$(RT_OUTPUT_DIR_$(1))/%: $$(CFG_MUSL_ROOT)/lib/%
 344         cp $$^ $$@
 345 endif
 346
 347 endef
 348
 349 # Instantiate template for all stages/targets
 350 $(foreach target,$(CFG_TARGET), \
 351      $(eval $(call DEF_THIRD_PARTY_TARGETS,$(target))))