1 # Copyright 2012 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 # This is the compile-time target-triple for the compiler. For the compiler at
12 # runtime, this should be considered the host-triple. More explanation for why
13 # this exists can be found on issue #2400
14 export CFG_COMPILER_HOST_TRIPLE
16 # The standard libraries should be held up to a higher standard than any old
17 # code, make sure that these common warnings are denied by default. These can
18 # be overridden during development temporarily. For stage0, we allow warnings
19 # which may be bugs in stage0 (should be fixed in stage1+)
20 RUST_LIB_FLAGS_ST0 += -W warnings
21 RUST_LIB_FLAGS_ST1 += -D warnings
22 RUST_LIB_FLAGS_ST2 += -D warnings
24 # Macro that generates the full list of dependencies for a crate at a particular
25 # stage/target/host tuple.
31 define RUST_CRATE_FULLDEPS
32 CRATE_FULLDEPS_$(1)_T_$(2)_H_$(3)_$(4) := \
35 $$(foreach dep,$$(RUST_DEPS_$(4)), \
36 $$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$$(dep)) \
37 $$(foreach dep,$$(NATIVE_DEPS_$(4)), \
38 $$(RT_OUTPUT_DIR_$(2))/$$(call CFG_STATIC_LIB_NAME_$(2),$$(dep))) \
39 $$(foreach dep,$$(NATIVE_DEPS_$(4)_T_$(2)), \
40 $$(RT_OUTPUT_DIR_$(2))/$$(dep)) \
41 $$(foreach dep,$$(NATIVE_TOOL_DEPS_$(4)_T_$(2)), \
42 $$(TBIN$(1)_T_$(3)_H_$(3))/$$(dep)) \
43 $$(CUSTOM_DEPS_$(4)_T_$(2))
46 $(foreach host,$(CFG_HOST), \
47 $(foreach target,$(CFG_TARGET), \
48 $(foreach stage,$(STAGES), \
49 $(foreach crate,$(CRATES), \
50 $(eval $(call RUST_CRATE_FULLDEPS,$(stage),$(target),$(host),$(crate)))))))
52 # RUST_TARGET_STAGE_N template: This defines how target artifacts are built
53 # for all stage/target architecture combinations. This is one giant rule which
56 # 1. The immediate dependencies are the rust source files
57 # 2. Each rust crate dependency is listed (based on their stamp files),
58 # as well as all native dependencies (listed in RT_OUTPUT_DIR)
59 # 3. The stage (n-1) compiler is required through the TSREQ dependency
60 # 4. When actually executing the rule, the first thing we do is to clean out
61 # old libs and rlibs via the REMOVE_ALL_OLD_GLOB_MATCHES macro
62 # 5. Finally, we get around to building the actual crate. It's just one
63 # "small" invocation of the previous stage rustc. We use -L to
64 # RT_OUTPUT_DIR so all the native dependencies are picked up.
65 # Additionally, we pass in the llvm dir so rustc can link against it.
66 # 6. Some cleanup is done (listing what was just built) if verbose is turned
70 # $(2) is the target triple
71 # $(3) is the host triple
72 # $(4) is the crate name
73 define RUST_TARGET_STAGE_N
75 $$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$(4): CFG_COMPILER_HOST_TRIPLE = $(2)
76 $$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$(4): \
78 $$(CRATE_FULLDEPS_$(1)_T_$(2)_H_$(3)_$(4)) \
79 $$(LLVM_CONFIG_$(2)) \
80 $$(TSREQ$(1)_T_$(2)_H_$(3)) \
81 | $$(TLIB$(1)_T_$(2)_H_$(3))/
82 @$$(call E, rustc: $$(@D)/lib$(4))
84 $$(call REMOVE_ALL_OLD_GLOB_MATCHES, \
85 $$(dir $$@)$$(call CFG_LIB_GLOB_$(2),$(4)))
86 $$(call REMOVE_ALL_OLD_GLOB_MATCHES, \
87 $$(dir $$@)$$(call CFG_RLIB_GLOB,$(4)))
88 $(Q)CFG_LLVM_LINKAGE_FILE=$$(LLVM_LINKAGE_PATH_$(2)) \
89 $$(subst @,,$$(STAGE$(1)_T_$(2)_H_$(3))) \
90 $$(RUST_LIB_FLAGS_ST$(1)) \
91 -L "$$(RT_OUTPUT_DIR_$(2))" \
92 $$(LLVM_LIBDIR_RUSTFLAGS_$(2)) \
93 $$(LLVM_STDCPP_RUSTFLAGS_$(2)) \
95 $$(RUSTFLAGS_$(4)_T_$(2)) \
97 -C extra-filename=-$$(CFG_FILENAME_EXTRA) \
99 @touch -r $$@.start_time $$@ && rm $$@.start_time
100 $$(call LIST_ALL_OLD_GLOB_MATCHES, \
101 $$(dir $$@)$$(call CFG_LIB_GLOB_$(2),$(4)))
102 $$(call LIST_ALL_OLD_GLOB_MATCHES, \
103 $$(dir $$@)$$(call CFG_RLIB_GLOB,$(4)))
107 # Macro for building any tool as part of the rust compilation process. Each
108 # tool is defined in crates.mk with a list of library dependencies as well as
109 # the source file for the tool. Building each tool will also be passed '--cfg
110 # <tool>' for usage in driver.rs
112 # This build rule is similar to the one found above, just tweaked for
113 # locations and things.
116 # $(2) - target triple
118 # $(4) - name of the tool being built
121 $$(TBIN$(1)_T_$(2)_H_$(3))/$(4)$$(X_$(2)): \
122 $$(TOOL_SOURCE_$(4)) \
123 $$(TOOL_INPUTS_$(4)) \
124 $$(foreach dep,$$(TOOL_DEPS_$(4)), \
125 $$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$$(dep)) \
126 $$(TSREQ$(1)_T_$(2)_H_$(3)) \
127 | $$(TBIN$(1)_T_$(2)_H_$(3))/
128 @$$(call E, rustc: $$@)
129 $$(STAGE$(1)_T_$(2)_H_$(3)) -o $$@ $$< --cfg $(4)
133 # Every recipe in RUST_TARGET_STAGE_N outputs to $$(TLIB$(1)_T_$(2)_H_$(3),
134 # a directory that can be cleaned out during the middle of a run of
135 # the get-snapshot.py script. Therefore, every recipe needs to have
136 # an order-only dependency either on $(SNAPSHOT_RUSTC_POST_CLEANUP) or
137 # on $$(TSREQ$(1)_T_$(2)_H_$(3)), to ensure that no products will be
138 # put into the target area until after the get-snapshot.py script has
139 # had its chance to clean it out; otherwise the other products will be
140 # inadvertently included in the clean out.
141 SNAPSHOT_RUSTC_POST_CLEANUP=$(HBIN0_H_$(CFG_BUILD))/rustc$(X_$(CFG_BUILD))
143 define TARGET_HOST_RULES
145 $$(TBIN$(1)_T_$(2)_H_$(3))/:
148 $$(TLIB$(1)_T_$(2)_H_$(3))/:
151 $$(TLIB$(1)_T_$(2)_H_$(3))/%: $$(RT_OUTPUT_DIR_$(2))/% \
152 | $$(TLIB$(1)_T_$(2)_H_$(3))/ $$(SNAPSHOT_RUSTC_POST_CLEANUP)
156 $$(TBIN$(1)_T_$(2)_H_$(3))/%: $$(CFG_LLVM_INST_DIR_$(2))/bin/% \
157 | $$(TBIN$(1)_T_$(2)_H_$(3))/ $$(SNAPSHOT_RUSTC_POST_CLEANUP)
162 $(foreach source,$(CFG_HOST), \
163 $(foreach target,$(CFG_TARGET), \
164 $(eval $(call TARGET_HOST_RULES,0,$(target),$(source))) \
165 $(eval $(call TARGET_HOST_RULES,1,$(target),$(source))) \
166 $(eval $(call TARGET_HOST_RULES,2,$(target),$(source))) \
167 $(eval $(call TARGET_HOST_RULES,3,$(target),$(source)))))
169 # In principle, each host can build each target for both libs and tools
170 $(foreach crate,$(CRATES), \
171 $(foreach source,$(CFG_HOST), \
172 $(foreach target,$(CFG_TARGET), \
173 $(eval $(call RUST_TARGET_STAGE_N,0,$(target),$(source),$(crate))) \
174 $(eval $(call RUST_TARGET_STAGE_N,1,$(target),$(source),$(crate))) \
175 $(eval $(call RUST_TARGET_STAGE_N,2,$(target),$(source),$(crate))) \
176 $(eval $(call RUST_TARGET_STAGE_N,3,$(target),$(source),$(crate))))))
178 $(foreach host,$(CFG_HOST), \
179 $(foreach target,$(CFG_TARGET), \
180 $(foreach stage,$(STAGES), \
181 $(foreach tool,$(TOOLS), \
182 $(eval $(call TARGET_TOOL,$(stage),$(target),$(host),$(tool)))))))
184 # We have some triples which are bootstrapped from other triples, and this means
185 # that we need to fixup some of the native tools that a triple depends on.
187 # For example, MSVC requires the llvm-ar.exe executable to manage archives, but
188 # it bootstraps from the GNU Windows triple. This means that the compiler will
189 # add this directory to PATH when executing new processes:
191 # $SYSROOT/rustlib/x86_64-pc-windows-gnu/bin
193 # Unfortunately, however, the GNU triple is not known about in stage0, so the
194 # tools are actually located in:
196 # $SYSROOT/rustlib/x86_64-pc-windows-msvc/bin
198 # To remedy this problem, the rules below copy all native tool dependencies into
199 # the bootstrap triple's location in stage 0 so the bootstrap compiler can find
200 # the right sets of tools. Later stages (1+) will have the right host triple for
201 # the compiler, so there's no need to worry there.
204 # $(2) - triple that's being used as host/target
205 # $(3) - triple snapshot is built for
208 define MOVE_TOOLS_TO_SNAPSHOT_HOST_DIR
210 $$(TLIB$(1)_T_$(2)_H_$(2))/stamp.$(4): $$(HLIB$(1)_H_$(2))/rustlib/$(3)/bin/$(5)
212 $$(HLIB$(1)_H_$(2))/rustlib/$(3)/bin/$(5): $$(TBIN$(1)_T_$(2)_H_$(2))/$(5)
218 $(foreach target,$(CFG_TARGET), \
219 $(foreach crate,$(CRATES), \
220 $(foreach tool,$(NATIVE_TOOL_DEPS_$(crate)_T_$(target)), \
221 $(eval $(call MOVE_TOOLS_TO_SNAPSHOT_HOST_DIR,0,$(target),$(BOOTSTRAP_FROM_$(target)),$(crate),$(tool))))))
223 # For MSVC targets we need to set up some environment variables for the linker
224 # to work correctly when building Rust crates. These two variables are:
226 # - LIB tells the linker the default search path for finding system libraries,
227 # for example kernel32.dll
228 # - PATH needs to be modified to ensure that MSVC's link.exe is first in the
229 # path instead of MinGW's /usr/bin/link.exe (entirely unrelated)
231 # The values for these variables are detected by the configure script.
232 define SETUP_LIB_MSVC_ENV_VARS
233 ifeq ($$(findstring msvc,$(2)),msvc)
234 $$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$(4): \
235 export LIB := $$(CFG_MSVC_LIB_PATH_$$(HOST_$(2)))
236 $$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$(4): \
237 export PATH := $$(CFG_MSVC_BINDIR_$$(HOST_$(2))):$$(PATH)
240 define SETUP_TOOL_MSVC_ENV_VARS
241 ifeq ($$(findstring msvc,$(2)),msvc)
242 $$(TBIN$(1)_T_$(2)_H_$(3))/$(4)$$(X_$(2)): \
243 export LIB := $$(CFG_MSVC_LIB_PATH_$$(HOST_$(2)))
244 $$(TBIN$(1)_T_$(2)_H_$(3))/$(4)$$(X_$(2)): \
245 export PATH := $$(CFG_MSVC_BINDIR_$$(HOST_$(2))):$$(PATH)
249 $(foreach host,$(CFG_HOST), \
250 $(foreach target,$(CFG_TARGET), \
251 $(foreach crate,$(CRATES), \
252 $(eval $(call SETUP_LIB_MSVC_ENV_VARS,0,$(target),$(host),$(crate))))))
253 $(foreach host,$(CFG_HOST), \
254 $(foreach target,$(CFG_TARGET), \
255 $(foreach tool,$(TOOLS), \
256 $(eval $(call SETUP_TOOL_MSVC_ENV_VARS,0,$(target),$(host),$(tool))))))