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.
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.
11 ################################################################################
12 # Native libraries built as part of the rust build process
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.
19 # This section should need minimal modification to add new libraries. The
20 # relevant variables are:
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
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
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
37 ################################################################################
38 NATIVE_LIBS := rust_builtin hoedown miniz \
39 rust_test_helpers morestack
41 # $(1) is the target triple
42 define NATIVE_LIBRARIES
44 NATIVE_DEPS_hoedown_$(1) := hoedown/src/autolink.c \
45 hoedown/src/buffer.c \
46 hoedown/src/document.c \
47 hoedown/src/escape.c \
49 hoedown/src/html_blocks.c \
50 hoedown/src/html_smartypants.c \
53 NATIVE_DEPS_miniz_$(1) = miniz.c
54 NATIVE_DEPS_rust_builtin_$(1) := rust_builtin.c \
56 NATIVE_DEPS_rust_test_helpers_$(1) := rust_test_helpers.c
57 NATIVE_DEPS_morestack_$(1) := empty.c
59 ################################################################################
60 # You shouldn't find it that necessary to edit anything below this line.
61 ################################################################################
63 # While we're defining the native libraries for each target, we define some
64 # common rules used to build files for various targets.
66 RT_OUTPUT_DIR_$(1) := $(1)/rt
68 $$(RT_OUTPUT_DIR_$(1))/%.o: $(S)src/rt/%.c $$(MKFILE_DEPS)
70 @$$(call E, compile: $$@)
71 $$(Q)$$(call CFG_COMPILE_C_$(1), $$@, \
72 $$(call CFG_CC_INCLUDE_$(1),$$(S)src/rt/hoedown/src) \
73 $$(call CFG_CC_INCLUDE_$(1),$$(S)src/rt) \
74 $$(RUNTIME_CFLAGS_$(1))) $$<
76 $$(RT_OUTPUT_DIR_$(1))/%.o: $(S)src/rt/%.S $$(MKFILE_DEPS) \
77 $$(LLVM_CONFIG_$$(CFG_BUILD))
79 @$$(call E, compile: $$@)
80 $$(Q)$$(call CFG_ASSEMBLE_$(1),$$@,$$<)
82 # On MSVC targets the compiler's default include path (e.g. where to find system
83 # headers) is specified by the INCLUDE environment variable. This may not be set
84 # so the ./configure script scraped the relevant values and this is the location
85 # that we put them into cl.exe's environment.
86 ifeq ($$(findstring msvc,$(1)),msvc)
87 $$(RT_OUTPUT_DIR_$(1))/%.o: \
88 export INCLUDE := $$(CFG_MSVC_INCLUDE_PATH_$$(HOST_$(1)))
90 export INCLUDE := $$(CFG_MSVC_INCLUDE_PATH_$$(HOST_$(1)))
94 $(foreach target,$(CFG_TARGET),$(eval $(call NATIVE_LIBRARIES,$(target))))
96 # A macro for devining how to build third party libraries listed above (based
97 # on their dependencies).
100 # $(2) is the lib name
101 define THIRD_PARTY_LIB
103 OBJS_$(2)_$(1) := $$(NATIVE_DEPS_$(2)_$(1):%=$$(RT_OUTPUT_DIR_$(1))/%)
104 OBJS_$(2)_$(1) := $$(OBJS_$(2)_$(1):.c=.o)
105 OBJS_$(2)_$(1) := $$(OBJS_$(2)_$(1):.cpp=.o)
106 OBJS_$(2)_$(1) := $$(OBJS_$(2)_$(1):.S=.o)
107 NATIVE_$(2)_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),$(2))
108 $$(RT_OUTPUT_DIR_$(1))/$$(NATIVE_$(2)_$(1)): $$(OBJS_$(2)_$(1))
109 @$$(call E, link: $$@)
110 $$(Q)$$(call CFG_CREATE_ARCHIVE_$(1),$$@) $$^
114 $(foreach target,$(CFG_TARGET), \
115 $(eval $(call RUNTIME_RULES,$(target))))
116 $(foreach lib,$(NATIVE_LIBS), \
117 $(foreach target,$(CFG_TARGET), \
118 $(eval $(call THIRD_PARTY_LIB,$(target),$(lib)))))
121 ################################################################################
122 # Building third-party targets with external build systems
124 # This location is meant for dependencies which have external build systems. It
125 # is still assumed that the output of each of these steps is a static library
126 # in the correct location.
127 ################################################################################
129 define DEF_THIRD_PARTY_TARGETS
131 # $(1) is the target triple
133 ifeq ($$(CFG_WINDOWSY_$(1)), 1)
134 # This isn't necessarily a desired option, but it's harmless and works around
135 # what appears to be a mingw-w64 bug.
137 # https://sourceforge.net/p/mingw-w64/bugs/395/
138 JEMALLOC_ARGS_$(1) := --enable-lazy-lock
139 else ifeq ($(OSTYPE_$(1)), apple-ios)
140 JEMALLOC_ARGS_$(1) := --disable-tls
141 else ifeq ($(findstring android, $(OSTYPE_$(1))), android)
142 JEMALLOC_ARGS_$(1) := --disable-tls
145 ifdef CFG_ENABLE_DEBUG_JEMALLOC
146 JEMALLOC_ARGS_$(1) += --enable-debug --enable-fill
149 ################################################################################
151 ################################################################################
153 ifdef CFG_ENABLE_FAST_MAKE
154 JEMALLOC_DEPS := $(S)/.gitmodules
156 JEMALLOC_DEPS := $(wildcard \
158 $(S)src/jemalloc/*/* \
159 $(S)src/jemalloc/*/*/* \
160 $(S)src/jemalloc/*/*/*/*)
163 # See #17183 for details, this file is touched during the build process so we
164 # don't want to consider it as a dependency.
165 JEMALLOC_DEPS := $(filter-out $(S)src/jemalloc/VERSION,$(JEMALLOC_DEPS))
167 JEMALLOC_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),jemalloc)
168 ifeq ($$(CFG_WINDOWSY_$(1)),1)
169 JEMALLOC_REAL_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),jemalloc_s)
171 JEMALLOC_REAL_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),jemalloc_pic)
173 JEMALLOC_LIB_$(1) := $$(RT_OUTPUT_DIR_$(1))/$$(JEMALLOC_NAME_$(1))
174 JEMALLOC_BUILD_DIR_$(1) := $$(RT_OUTPUT_DIR_$(1))/jemalloc
175 JEMALLOC_LOCAL_$(1) := $$(JEMALLOC_BUILD_DIR_$(1))/lib/$$(JEMALLOC_REAL_NAME_$(1))
177 $$(JEMALLOC_LOCAL_$(1)): $$(JEMALLOC_DEPS) $$(MKFILE_DEPS)
178 @$$(call E, make: jemalloc)
179 cd "$$(JEMALLOC_BUILD_DIR_$(1))"; "$(S)src/jemalloc/configure" \
180 $$(JEMALLOC_ARGS_$(1)) --with-jemalloc-prefix=je_ $(CFG_JEMALLOC_FLAGS) \
181 --build=$$(CFG_GNU_TRIPLE_$(CFG_BUILD)) --host=$$(CFG_GNU_TRIPLE_$(1)) \
182 CC="$$(CC_$(1)) $$(CFG_JEMALLOC_CFLAGS_$(1))" \
184 RANLIB="$$(AR_$(1)) s" \
185 CPPFLAGS="-I $(S)src/rt/" \
186 EXTRA_CFLAGS="-g1 -ffunction-sections -fdata-sections"
187 $$(Q)$$(MAKE) -C "$$(JEMALLOC_BUILD_DIR_$(1))" build_lib_static
189 ifeq ($$(CFG_DISABLE_JEMALLOC),)
190 RUSTFLAGS_alloc := --cfg jemalloc
191 ifeq ($(1),$$(CFG_BUILD))
192 ifneq ($$(CFG_JEMALLOC_ROOT),)
193 $$(JEMALLOC_LIB_$(1)): $$(CFG_JEMALLOC_ROOT)/libjemalloc_pic.a
194 @$$(call E, copy: jemalloc)
197 $$(JEMALLOC_LIB_$(1)): $$(JEMALLOC_LOCAL_$(1))
201 $$(JEMALLOC_LIB_$(1)): $$(JEMALLOC_LOCAL_$(1))
205 $$(JEMALLOC_LIB_$(1)): $$(MKFILE_DEPS)
209 ################################################################################
211 ################################################################################
213 ifdef CFG_ENABLE_FAST_MAKE
214 COMPRT_DEPS := $(S)/.gitmodules
216 COMPRT_DEPS := $(wildcard \
217 $(S)src/compiler-rt/* \
218 $(S)src/compiler-rt/*/* \
219 $(S)src/compiler-rt/*/*/* \
220 $(S)src/compiler-rt/*/*/*/*)
223 COMPRT_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),compiler-rt)
224 COMPRT_LIB_$(1) := $$(RT_OUTPUT_DIR_$(1))/$$(COMPRT_NAME_$(1))
225 COMPRT_BUILD_DIR_$(1) := $$(RT_OUTPUT_DIR_$(1))/compiler-rt
227 # Note that on MSVC-targeting builds we hardwire CC/AR to gcc/ar even though
228 # we're targeting MSVC. This is because although compiler-rt has a CMake build
229 # config I can't actually figure out how to use it, so I'm not sure how to use
230 # cl.exe to build the objects. Additionally, the compiler-rt library when built
231 # with gcc has the same ABI as cl.exe, so they're largely compatible
232 COMPRT_CC_$(1) := $$(CC_$(1))
233 COMPRT_AR_$(1) := $$(AR_$(1))
234 COMPRT_CFLAGS_$(1) := $$(CFG_GCCISH_CFLAGS_$(1))
235 ifeq ($$(findstring msvc,$(1)),msvc)
236 COMPRT_CC_$(1) := gcc
238 ifeq ($$(findstring i686,$(1)),i686)
239 COMPRT_CFLAGS_$(1) := $$(CFG_GCCISH_CFLAGS_$(1)) -m32
241 COMPRT_CFLAGS_$(1) := $$(CFG_GCCISH_CFLAGS_$(1)) -m64
245 $$(COMPRT_LIB_$(1)): $$(COMPRT_DEPS) $$(MKFILE_DEPS)
246 @$$(call E, make: compiler-rt)
247 $$(Q)$$(MAKE) -C "$(S)src/compiler-rt" \
248 ProjSrcRoot="$(S)src/compiler-rt" \
249 ProjObjRoot="$$(abspath $$(COMPRT_BUILD_DIR_$(1)))" \
250 CC='$$(COMPRT_CC_$(1))' \
251 AR='$$(COMPRT_AR_$(1))' \
252 RANLIB='$$(COMPRT_AR_$(1)) s' \
253 CFLAGS="$$(COMPRT_CFLAGS_$(1))" \
256 $$(Q)cp $$(COMPRT_BUILD_DIR_$(1))/triple/builtins/libcompiler_rt.a $$@
258 ################################################################################
261 # We use libbacktrace on linux to get symbols in backtraces, but only on linux.
262 # Elsewhere we use other system utilities, so this library is only built on
264 ################################################################################
266 BACKTRACE_NAME_$(1) := $$(call CFG_STATIC_LIB_NAME_$(1),backtrace)
267 BACKTRACE_LIB_$(1) := $$(RT_OUTPUT_DIR_$(1))/$$(BACKTRACE_NAME_$(1))
268 BACKTRACE_BUILD_DIR_$(1) := $$(RT_OUTPUT_DIR_$(1))/libbacktrace
270 # We don't use this on platforms that aren't linux-based, so just make the file
271 # available, the compilation of libstd won't actually build it.
272 ifeq ($$(findstring darwin,$$(OSTYPE_$(1))),darwin)
274 $$(BACKTRACE_LIB_$(1)):
278 ifeq ($$(findstring ios,$$(OSTYPE_$(1))),ios)
280 $$(BACKTRACE_LIB_$(1)):
284 ifeq ($$(CFG_WINDOWSY_$(1)),1)
286 $$(BACKTRACE_LIB_$(1)):
290 ifdef CFG_ENABLE_FAST_MAKE
291 BACKTRACE_DEPS := $(S)/.gitmodules
293 BACKTRACE_DEPS := $(wildcard $(S)src/libbacktrace/*)
296 # We need to export CFLAGS because otherwise it doesn't pick up cross compile
297 # builds. If libbacktrace doesn't realize this, it will attempt to read 64-bit
298 # elf headers when compiled for a 32-bit system, yielding blank backtraces.
300 # This also removes the -Werror flag specifically to prevent errors during
303 # Down below you'll also see echos into the config.h generated by the
304 # ./configure script. This is done to force libbacktrace to *not* use the
305 # atomic/sync functionality because it pulls in unnecessary dependencies and we
306 # never use it anyway.
307 $$(BACKTRACE_BUILD_DIR_$(1))/Makefile: $$(BACKTRACE_DEPS) $$(MKFILE_DEPS)
308 @$$(call E, configure: libbacktrace for $(1))
309 $$(Q)rm -rf $$(BACKTRACE_BUILD_DIR_$(1))
310 $$(Q)mkdir -p $$(BACKTRACE_BUILD_DIR_$(1))
311 $$(Q)(cd $$(BACKTRACE_BUILD_DIR_$(1)) && \
314 RANLIB="$$(AR_$(1)) s" \
315 CFLAGS="$$(CFG_GCCISH_CFLAGS_$(1):-Werror=) -fno-stack-protector" \
316 $(S)src/libbacktrace/configure --target=$(1) --host=$(CFG_BUILD))
317 $$(Q)echo '#undef HAVE_ATOMIC_FUNCTIONS' >> \
318 $$(BACKTRACE_BUILD_DIR_$(1))/config.h
319 $$(Q)echo '#undef HAVE_SYNC_FUNCTIONS' >> \
320 $$(BACKTRACE_BUILD_DIR_$(1))/config.h
322 $$(BACKTRACE_LIB_$(1)): $$(BACKTRACE_BUILD_DIR_$(1))/Makefile $$(MKFILE_DEPS)
323 @$$(call E, make: libbacktrace)
324 $$(Q)$$(MAKE) -C $$(BACKTRACE_BUILD_DIR_$(1)) \
325 INCDIR=$(S)src/libbacktrace
326 $$(Q)cp $$(BACKTRACE_BUILD_DIR_$(1))/.libs/libbacktrace.a $$@
328 endif # endif for windowsy
329 endif # endif for ios
330 endif # endif for darwin
332 ################################################################################
333 # libc/libunwind for musl
335 # When we're building a musl-like target we're going to link libc/libunwind
336 # statically into the standard library and liblibc, so we need to make sure
337 # they're in a location that we can find
338 ################################################################################
340 ifeq ($$(findstring musl,$(1)),musl)
341 $$(RT_OUTPUT_DIR_$(1))/%: $$(CFG_MUSL_ROOT)/lib/%
347 # Instantiate template for all stages/targets
348 $(foreach target,$(CFG_TARGET), \
349 $(eval $(call DEF_THIRD_PARTY_TARGETS,$(target))))