mk/main.mk

   1 # Copyright 2014-2015 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 # Version numbers and strings
  13 ######################################################################
  14
  15 # The version number
  16 CFG_RELEASE_NUM=1.7.0
  17
  18 # An optional number to put after the label, e.g. '.2' -> '-beta.2'
  19 # NB Make sure it starts with a dot to conform to semver pre-release
  20 # versions (section 9)
  21 CFG_PRERELEASE_VERSION=.1
  22
  23 # Append a version-dependent hash to each library, so we can install different
  24 # versions in the same place
  25 CFG_FILENAME_EXTRA=$(shell printf '%s' $(CFG_RELEASE) | $(CFG_HASH_COMMAND))
  26
  27 ifeq ($(CFG_RELEASE_CHANNEL),stable)
  28 # This is the normal semver version string, e.g. "0.12.0", "0.12.0-nightly"
  29 CFG_RELEASE=$(CFG_RELEASE_NUM)
  30 # This is the string used in dist artifact file names, e.g. "0.12.0", "nightly"
  31 CFG_PACKAGE_VERS=$(CFG_RELEASE_NUM)
  32 CFG_DISABLE_UNSTABLE_FEATURES=1
  33 endif
  34 ifeq ($(CFG_RELEASE_CHANNEL),beta)
  35 CFG_RELEASE=$(CFG_RELEASE_NUM)-beta$(CFG_PRERELEASE_VERSION)
  36 # When building beta distributables just reuse the same "beta" name
  37 # so when we upload we'll always override the previous beta. This
  38 # doesn't actually impact the version reported by rustc - it's just
  39 # for file naming.
  40 CFG_PACKAGE_VERS=beta
  41 CFG_DISABLE_UNSTABLE_FEATURES=1
  42 endif
  43 ifeq ($(CFG_RELEASE_CHANNEL),nightly)
  44 CFG_RELEASE=$(CFG_RELEASE_NUM)-nightly
  45 # When building nightly distributables just reuse the same "nightly" name
  46 # so when we upload we'll always override the previous nighly. This
  47 # doesn't actually impact the version reported by rustc - it's just
  48 # for file naming.
  49 CFG_PACKAGE_VERS=nightly
  50 endif
  51 ifeq ($(CFG_RELEASE_CHANNEL),dev)
  52 CFG_RELEASE=$(CFG_RELEASE_NUM)-dev
  53 CFG_PACKAGE_VERS=$(CFG_RELEASE_NUM)-dev
  54 endif
  55
  56 # The name of the package to use for creating tarballs, installers etc.
  57 CFG_PACKAGE_NAME=rustc-$(CFG_PACKAGE_VERS)
  58
  59 # The version string plus commit information - this is what rustc reports
  60 CFG_VERSION = $(CFG_RELEASE)
  61 CFG_GIT_DIR := $(CFG_SRC_DIR).git
  62 # since $(CFG_GIT) may contain spaces (especially on Windows),
  63 # we need to escape them. (" " to r"\ ")
  64 # Note that $(subst ...) ignores space after `subst`,
  65 # so we use a hack: define $(SPACE) which contains space character.
  66 SPACE :=
  67 SPACE +=
  68 ifneq ($(CFG_GIT),)
  69 ifneq ($(wildcard $(subst $(SPACE),\$(SPACE),$(CFG_GIT_DIR))),)
  70     CFG_VER_DATE = $(shell git --git-dir='$(CFG_GIT_DIR)' log -1 --date=short --pretty=format:'%cd')
  71     CFG_VER_HASH = $(shell git --git-dir='$(CFG_GIT_DIR)' rev-parse HEAD)
  72     CFG_SHORT_VER_HASH = $(shell git --git-dir='$(CFG_GIT_DIR)' rev-parse --short=9 HEAD)
  73     CFG_VERSION += ($(CFG_SHORT_VER_HASH) $(CFG_VER_DATE))
  74 endif
  75 endif
  76
  77 # Windows exe's need numeric versions - don't use anything but
  78 # numbers and dots here
  79 CFG_VERSION_WIN = $(CFG_RELEASE_NUM)
  80
  81 CFG_INFO := $(info cfg: version $(CFG_VERSION))
  82
  83 ######################################################################
  84 # More configuration
  85 ######################################################################
  86
  87 MKFILE_DEPS := config.stamp $(call rwildcard,$(CFG_SRC_DIR)mk/,*)
  88 MKFILES_FOR_TARBALL:=$(MKFILE_DEPS)
  89 ifneq ($(NO_MKFILE_DEPS),)
  90 MKFILE_DEPS :=
  91 endif
  92 NON_BUILD_HOST = $(filter-out $(CFG_BUILD),$(CFG_HOST))
  93 NON_BUILD_TARGET = $(filter-out $(CFG_BUILD),$(CFG_TARGET))
  94
  95 ifneq ($(MAKE_RESTARTS),)
  96 CFG_INFO := $(info cfg: make restarts: $(MAKE_RESTARTS))
  97 endif
  98
  99 CFG_INFO := $(info cfg: build triple $(CFG_BUILD))
 100 CFG_INFO := $(info cfg: host triples $(CFG_HOST))
 101 CFG_INFO := $(info cfg: target triples $(CFG_TARGET))
 102
 103 ifneq ($(wildcard $(NON_BUILD_HOST)),)
 104 CFG_INFO := $(info cfg: non-build host triples $(NON_BUILD_HOST))
 105 endif
 106 ifneq ($(wildcard $(NON_BUILD_TARGET)),)
 107 CFG_INFO := $(info cfg: non-build target triples $(NON_BUILD_TARGET))
 108 endif
 109
 110 CFG_RUSTC_FLAGS := $(RUSTFLAGS)
 111 CFG_GCCISH_CFLAGS :=
 112 CFG_GCCISH_LINK_FLAGS :=
 113
 114 CFG_JEMALLOC_FLAGS :=
 115
 116 ifdef CFG_DISABLE_OPTIMIZE
 117   $(info cfg: disabling rustc optimization (CFG_DISABLE_OPTIMIZE))
 118   CFG_RUSTC_FLAGS +=
 119   CFG_JEMALLOC_FLAGS += --enable-debug
 120 else
 121   # The rtopt cfg turns off runtime sanity checks
 122   CFG_RUSTC_FLAGS += -O --cfg rtopt
 123 endif
 124
 125 CFG_JEMALLOC_FLAGS += $(JEMALLOC_FLAGS)
 126
 127 ifdef CFG_ENABLE_DEBUG_ASSERTIONS
 128   $(info cfg: enabling debug assertions (CFG_ENABLE_DEBUG_ASSERTIONS))
 129   CFG_RUSTC_FLAGS += -C debug-assertions=on
 130 endif
 131
 132 ifdef CFG_ENABLE_DEBUGINFO
 133   $(info cfg: enabling debuginfo (CFG_ENABLE_DEBUGINFO))
 134   # FIXME: Re-enable -g in stage0 after new snapshot
 135   #CFG_RUSTC_FLAGS += -g
 136   RUSTFLAGS_STAGE1 += -g
 137   RUSTFLAGS_STAGE2 += -g
 138   RUSTFLAGS_STAGE3 += -g
 139 endif
 140
 141 ifdef SAVE_TEMPS
 142   CFG_RUSTC_FLAGS += --save-temps
 143 endif
 144 ifdef ASM_COMMENTS
 145   CFG_RUSTC_FLAGS += -Z asm-comments
 146 endif
 147 ifdef TIME_PASSES
 148   CFG_RUSTC_FLAGS += -Z time-passes
 149 endif
 150 ifdef TIME_LLVM_PASSES
 151   CFG_RUSTC_FLAGS += -Z time-llvm-passes
 152 endif
 153 ifdef TRACE
 154   CFG_RUSTC_FLAGS += -Z trace
 155 endif
 156 ifdef CFG_ENABLE_RPATH
 157 CFG_RUSTC_FLAGS += -C rpath
 158 endif
 159
 160 # The executables crated during this compilation process have no need to include
 161 # static copies of libstd and libextra. We also generate dynamic versions of all
 162 # libraries, so in the interest of space, prefer dynamic linking throughout the
 163 # compilation process.
 164 #
 165 # Note though that these flags are omitted for the *bins* in stage2+. This means
 166 # that the snapshot will be generated with a statically linked rustc so we only
 167 # have to worry about the distribution of one file (with its native dynamic
 168 # dependencies)
 169 RUSTFLAGS_STAGE0 += -C prefer-dynamic -C no-stack-check
 170 RUSTFLAGS_STAGE1 += -C prefer-dynamic
 171 RUST_LIB_FLAGS_ST2 += -C prefer-dynamic
 172 RUST_LIB_FLAGS_ST3 += -C prefer-dynamic
 173
 174 # Landing pads require a lot of codegen. We can get through bootstrapping faster
 175 # by not emitting them.
 176
 177 ifdef CFG_DISABLE_STAGE0_LANDING_PADS
 178   RUSTFLAGS_STAGE0 += -Z no-landing-pads
 179 endif
 180
 181 # platform-specific auto-configuration
 182 include $(CFG_SRC_DIR)mk/platform.mk
 183
 184 # Run the stage1/2 compilers under valgrind
 185 ifdef VALGRIND_COMPILE
 186   CFG_VALGRIND_COMPILE := $(CFG_VALGRIND)
 187 else
 188   CFG_VALGRIND_COMPILE :=
 189 endif
 190
 191
 192 ifndef CFG_DISABLE_VALGRIND_RPASS
 193   $(info cfg: enabling valgrind run-pass tests (CFG_ENABLE_VALGRIND_RPASS))
 194   $(info cfg: valgrind-rpass command set to $(CFG_VALGRIND))
 195   CFG_VALGRIND_RPASS :=$(CFG_VALGRIND)
 196 else
 197   $(info cfg: disabling valgrind run-pass tests)
 198   CFG_VALGRIND_RPASS :=
 199 endif
 200
 201
 202 ifdef CFG_ENABLE_VALGRIND
 203   $(info cfg: enabling valgrind (CFG_ENABLE_VALGRIND))
 204   CFG_JEMALLOC_FLAGS += --enable-valgrind
 205 else
 206   CFG_VALGRIND :=
 207 endif
 208
 209 ######################################################################
 210 # Target-and-rule "utility variables"
 211 ######################################################################
 212
 213 define DEF_FOR_TARGET
 214 X_$(1) := $(CFG_EXE_SUFFIX_$(1))
 215 ifndef CFG_LLVM_TARGET_$(1)
 216 CFG_LLVM_TARGET_$(1) := $(1)
 217 endif
 218 endef
 219 $(foreach target,$(CFG_TARGET), \
 220   $(eval $(call DEF_FOR_TARGET,$(target))))
 221
 222 # "Source" files we generate in builddir along the way.
 223 GENERATED :=
 224
 225 # Delete the built-in rules.
 226 .SUFFIXES:
 227 %:: %,v
 228 %:: RCS/%,v
 229 %:: RCS/%
 230 %:: s.%
 231 %:: SCCS/s.%
 232
 233
 234 ######################################################################
 235 # Cleaning out old crates
 236 ######################################################################
 237
 238 # $(1) is the path for directory to match against
 239 # $(2) is the glob to use in the match
 240 #
 241 # Note that a common bug is to accidentally construct the glob denoted
 242 # by $(2) with a space character prefix, which invalidates the
 243 # construction $(1)$(2).
 244 define CHECK_FOR_OLD_GLOB_MATCHES
 245   $(Q)MATCHES="$(wildcard $(1))"; if [ -n "$$MATCHES" ] ; then echo "warning: there are previous" \'$(notdir $(2))\' "libraries:" $$MATCHES; fi
 246 endef
 247
 248 # Same interface as above, but deletes rather than just listing the files.
 249 ifdef VERBOSE
 250 define REMOVE_ALL_OLD_GLOB_MATCHES
 251   $(Q)MATCHES="$(wildcard $(1))"; if [ -n "$$MATCHES" ] ; then echo "warning: removing previous" \'$(notdir $(1))\' "libraries:" $$MATCHES; rm $$MATCHES ; fi
 252 endef
 253 else
 254 define REMOVE_ALL_OLD_GLOB_MATCHES
 255   $(Q)MATCHES="$(wildcard $(1))"; if [ -n "$$MATCHES" ] ; then rm $$MATCHES ; fi
 256 endef
 257 endif
 258
 259 # We use a different strategy for LIST_ALL_OLD_GLOB_MATCHES_EXCEPT
 260 # than in the macros above because it needs the result of running the
 261 # `ls` command after other rules in the command list have run; the
 262 # macro-expander for $(wildcard ...) would deliver its results too
 263 # soon. (This is in contrast to the macros above, which are meant to
 264 # be run at the outset of a command list in a rule.)
 265 ifdef VERBOSE
 266 define LIST_ALL_OLD_GLOB_MATCHES
 267   @echo "info: now are following matches for" '$(notdir $(1))' "libraries:"
 268   @( ls $(1) 2>/dev/null || true )
 269 endef
 270 else
 271 define LIST_ALL_OLD_GLOB_MATCHES
 272 endef
 273 endif
 274
 275 ######################################################################
 276 # LLVM macros
 277 ######################################################################
 278
 279 LLVM_OPTIONAL_COMPONENTS=x86 arm aarch64 mips powerpc
 280 LLVM_REQUIRED_COMPONENTS=ipo bitreader bitwriter linker asmparser mcjit \
 281                 interpreter instrumentation
 282
 283 ifneq ($(CFG_LLVM_ROOT),)
 284 # Ensure we only try to link targets that the installed LLVM actually has:
 285 LLVM_COMPONENTS := $(filter $(shell $(CFG_LLVM_ROOT)/bin/llvm-config$(X_$(CFG_BUILD)) --components),\
 286                         $(LLVM_OPTIONAL_COMPONENTS)) $(LLVM_REQUIRED_COMPONENTS)
 287 else
 288 LLVM_COMPONENTS := $(LLVM_OPTIONAL_COMPONENTS) $(LLVM_REQUIRED_COMPONENTS)
 289 endif
 290
 291 # Only build these LLVM tools
 292 LLVM_TOOLS=bugpoint llc llvm-ar llvm-as llvm-dis llvm-mc opt llvm-extract
 293
 294 define DEF_LLVM_VARS
 295 # The configure script defines these variables with the target triples
 296 # separated by Z. This defines new ones with the expected format.
 297 ifeq ($$(CFG_LLVM_ROOT),)
 298 CFG_LLVM_BUILD_DIR_$(1):=$$(CFG_LLVM_BUILD_DIR_$(subst -,_,$(1)))
 299 CFG_LLVM_INST_DIR_$(1):=$$(CFG_LLVM_INST_DIR_$(subst -,_,$(1)))
 300 else
 301 CFG_LLVM_INST_DIR_$(1):=$$(CFG_LLVM_ROOT)
 302 endif
 303
 304 # Any rules that depend on LLVM should depend on LLVM_CONFIG
 305 LLVM_CONFIG_$(1):=$$(CFG_LLVM_INST_DIR_$(1))/bin/llvm-config$$(X_$(1))
 306 LLVM_MC_$(1):=$$(CFG_LLVM_INST_DIR_$(1))/bin/llvm-mc$$(X_$(1))
 307 LLVM_AR_$(1):=$$(CFG_LLVM_INST_DIR_$(1))/bin/llvm-ar$$(X_$(1))
 308 LLVM_VERSION_$(1)=$$(shell "$$(LLVM_CONFIG_$(1))" --version)
 309 LLVM_BINDIR_$(1)=$$(shell "$$(LLVM_CONFIG_$(1))" --bindir)
 310 LLVM_INCDIR_$(1)=$$(shell "$$(LLVM_CONFIG_$(1))" --includedir)
 311 LLVM_LIBDIR_$(1)=$$(shell "$$(LLVM_CONFIG_$(1))" --libdir)
 312 LLVM_LIBDIR_RUSTFLAGS_$(1)=-L native="$$(LLVM_LIBDIR_$(1))"
 313 LLVM_LDFLAGS_$(1)=$$(shell "$$(LLVM_CONFIG_$(1))" --ldflags)
 314 ifeq ($$(findstring freebsd,$(1)),freebsd)
 315 # On FreeBSD, it may search wrong headers (that are for pre-installed LLVM),
 316 # so we replace -I with -iquote to ensure that it searches bundled LLVM first.
 317 LLVM_CXXFLAGS_$(1)=$$(subst -I, -iquote , $$(shell "$$(LLVM_CONFIG_$(1))" --cxxflags))
 318 else
 319 LLVM_CXXFLAGS_$(1)=$$(shell "$$(LLVM_CONFIG_$(1))" --cxxflags)
 320 endif
 321 LLVM_HOST_TRIPLE_$(1)=$$(shell "$$(LLVM_CONFIG_$(1))" --host-target)
 322
 323 LLVM_AS_$(1)=$$(CFG_LLVM_INST_DIR_$(1))/bin/llvm-as$$(X_$(1))
 324 LLC_$(1)=$$(CFG_LLVM_INST_DIR_$(1))/bin/llc$$(X_$(1))
 325
 326 LLVM_ALL_COMPONENTS_$(1)=$$(shell "$$(LLVM_CONFIG_$(1))" --components)
 327
 328 endef
 329
 330 $(foreach host,$(CFG_HOST), \
 331  $(eval $(call DEF_LLVM_VARS,$(host))))
 332
 333 ######################################################################
 334 # Exports for sub-utilities
 335 ######################################################################
 336
 337 # Note that any variable that re-configure should pick up needs to be
 338 # exported
 339
 340 export CFG_SRC_DIR
 341 export CFG_SRC_DIR_RELATIVE
 342 export CFG_BUILD_DIR
 343 ifdef CFG_VER_DATE
 344 export CFG_VER_DATE
 345 endif
 346 ifdef CFG_VER_HASH
 347 export CFG_VER_HASH
 348 endif
 349 export CFG_VERSION
 350 export CFG_VERSION_WIN
 351 export CFG_RELEASE
 352 export CFG_PACKAGE_NAME
 353 export CFG_BUILD
 354 export CFG_RELEASE_CHANNEL
 355 export CFG_LLVM_ROOT
 356 export CFG_PREFIX
 357 export CFG_LIBDIR
 358 export CFG_LIBDIR_RELATIVE
 359 export CFG_DISABLE_INJECT_STD_VERSION
 360 ifdef CFG_DISABLE_UNSTABLE_FEATURES
 361 CFG_INFO := $(info cfg: disabling unstable features (CFG_DISABLE_UNSTABLE_FEATURES))
 362 # Turn on feature-staging
 363 export CFG_DISABLE_UNSTABLE_FEATURES
 364 # Subvert unstable feature lints to do the self-build
 365 export RUSTC_BOOTSTRAP_KEY:=$(CFG_BOOTSTRAP_KEY)
 366 endif
 367 export CFG_BOOTSTRAP_KEY
 368
 369 ######################################################################
 370 # Per-stage targets and runner
 371 ######################################################################
 372
 373 # Valid setting-strings are 'all', 'none', 'gdb', 'lldb'
 374 # This 'function' will determine which debugger scripts to copy based on a
 375 # target triple. See debuggers.mk for more information.
 376 TRIPLE_TO_DEBUGGER_SCRIPT_SETTING=\
 377  $(if $(findstring windows,$(1)),none,$(if $(findstring darwin,$(1)),lldb,gdb))
 378
 379 STAGES = 0 1 2 3
 380
 381 define SREQ
 382 # $(1) is the stage number
 383 # $(2) is the target triple
 384 # $(3) is the host triple
 385
 386 # Destinations of artifacts for the host compiler
 387 HROOT$(1)_H_$(3) = $(3)/stage$(1)
 388 HBIN$(1)_H_$(3) = $$(HROOT$(1)_H_$(3))/bin
 389
 390 ifeq ($$(CFG_WINDOWSY_$(3)),1)
 391 # On Windows we always store host runtime libraries in the 'bin' directory because
 392 # there's no rpath. Target libraries go under $CFG_LIBDIR_RELATIVE (usually 'lib').
 393 HLIB_RELATIVE$(1)_H_$(3) = bin
 394 TROOT$(1)_T_$(2)_H_$(3) = $$(HROOT$(1)_H_$(3))/$$(CFG_LIBDIR_RELATIVE)/rustlib/$(2)
 395 # Remove the next 3 lines after a snapshot
 396 ifeq ($(1),0)
 397 RUSTFLAGS_STAGE0 += -L $$(TROOT$(1)_T_$(2)_H_$(3))/lib
 398 endif
 399
 400 else
 401
 402 ifeq ($(1),0)
 403 HLIB_RELATIVE$(1)_H_$(3) = lib
 404 else
 405 HLIB_RELATIVE$(1)_H_$(3) = $$(CFG_LIBDIR_RELATIVE)
 406 endif
 407 TROOT$(1)_T_$(2)_H_$(3) = $$(HLIB$(1)_H_$(3))/rustlib/$(2)
 408
 409 endif
 410 HLIB$(1)_H_$(3) = $$(HROOT$(1)_H_$(3))/$$(HLIB_RELATIVE$(1)_H_$(3))
 411
 412 # Destinations of artifacts for target architectures
 413 TBIN$(1)_T_$(2)_H_$(3) = $$(TROOT$(1)_T_$(2)_H_$(3))/bin
 414 TLIB$(1)_T_$(2)_H_$(3) = $$(TROOT$(1)_T_$(2)_H_$(3))/lib
 415
 416 # Preqrequisites for using the stageN compiler
 417 ifeq ($(1),0)
 418 HSREQ$(1)_H_$(3) = $$(HBIN$(1)_H_$(3))/rustc$$(X_$(3))
 419 else
 420 HSREQ$(1)_H_$(3) = \
 421         $$(HBIN$(1)_H_$(3))/rustc$$(X_$(3)) \
 422         $$(MKFILE_DEPS) \
 423         tmp/install-debugger-scripts$(1)_H_$(3)-$$(call TRIPLE_TO_DEBUGGER_SCRIPT_SETTING,$(3)).done
 424 endif
 425
 426 # Prerequisites for using the stageN compiler to build target artifacts
 427 TSREQ$(1)_T_$(2)_H_$(3) = \
 428         $$(HSREQ$(1)_H_$(3)) \
 429         $$(foreach obj,$$(REQUIRED_OBJECTS_$(2)),\
 430                 $$(TLIB$(1)_T_$(2)_H_$(3))/$$(obj))
 431
 432 # Prerequisites for a working stageN compiler and libraries, for a specific
 433 # target
 434 SREQ$(1)_T_$(2)_H_$(3) = \
 435         $$(TSREQ$(1)_T_$(2)_H_$(3)) \
 436         $$(foreach dep,$$(TARGET_CRATES), \
 437             $$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$$(dep)) \
 438         tmp/install-debugger-scripts$(1)_T_$(2)_H_$(3)-$$(call TRIPLE_TO_DEBUGGER_SCRIPT_SETTING,$(2)).done
 439
 440 # Prerequisites for a working stageN compiler and complete set of target
 441 # libraries
 442 CSREQ$(1)_T_$(2)_H_$(3) = \
 443         $$(TSREQ$(1)_T_$(2)_H_$(3)) \
 444         $$(HBIN$(1)_H_$(3))/rustdoc$$(X_$(3)) \
 445         $$(foreach dep,$$(CRATES),$$(TLIB$(1)_T_$(2)_H_$(3))/stamp.$$(dep))
 446
 447 ifeq ($(1),0)
 448 # Don't run the stage0 compiler under valgrind - that ship has sailed
 449 CFG_VALGRIND_COMPILE$(1) =
 450 else
 451 CFG_VALGRIND_COMPILE$(1) = $$(CFG_VALGRIND_COMPILE)
 452 endif
 453
 454 # Add RUSTFLAGS_STAGEN values to the build command
 455 EXTRAFLAGS_STAGE$(1) = $$(RUSTFLAGS_STAGE$(1))
 456
 457 CFGFLAG$(1)_T_$(2)_H_$(3) = stage$(1)
 458
 459 endef
 460
 461 # Same macro/variables as above, but defined in a separate loop so it can use
 462 # all the variables above for all archs. The RPATH_VAR setup sometimes needs to
 463 # reach across triples to get things in order.
 464 #
 465 # Defines (with the standard $(1)_T_$(2)_H_$(3) suffix):
 466 # * `LD_LIBRARY_PATH_ENV_NAME`: the name for the key to use in the OS
 467 #   environment to access or extend the lookup path for dynamic
 468 #   libraries.  Note on Windows, that key is `$PATH`, and thus not
 469 #   only conflates programs with dynamic libraries, but also often
 470 #   contains spaces which confuse make.
 471 # * `LD_LIBRARY_PATH_ENV_HOSTDIR`: the entry to add to lookup path for the host
 472 # * `LD_LIBRARY_PATH_ENV_TARGETDIR`: the entry to add to lookup path for target
 473 #
 474 # Below that, HOST_RPATH_VAR and TARGET_RPATH_VAR are defined in terms of the
 475 # above settings.
 476 #
 477 define SREQ_CMDS
 478
 479 ifeq ($$(OSTYPE_$(3)),apple-darwin)
 480   LD_LIBRARY_PATH_ENV_NAME$(1)_T_$(2)_H_$(3) := DYLD_LIBRARY_PATH
 481 else
 482 ifeq ($$(CFG_WINDOWSY_$(3)),1)
 483   LD_LIBRARY_PATH_ENV_NAME$(1)_T_$(2)_H_$(3) := PATH
 484 else
 485   LD_LIBRARY_PATH_ENV_NAME$(1)_T_$(2)_H_$(3) := LD_LIBRARY_PATH
 486 endif
 487 endif
 488
 489 LD_LIBRARY_PATH_ENV_HOSTDIR$(1)_T_$(2)_H_$(3) := \
 490     $$(CURDIR)/$$(HLIB$(1)_H_$(3)):$$(CFG_LLVM_INST_DIR_$(3))/lib
 491 LD_LIBRARY_PATH_ENV_TARGETDIR$(1)_T_$(2)_H_$(3) := \
 492     $$(CURDIR)/$$(TLIB1_T_$(2)_H_$(CFG_BUILD))
 493
 494 HOST_RPATH_VAR$(1)_T_$(2)_H_$(3) := \
 495   $$(LD_LIBRARY_PATH_ENV_NAME$(1)_T_$(2)_H_$(3))=$$(LD_LIBRARY_PATH_ENV_HOSTDIR$(1)_T_$(2)_H_$(3)):$$$$$$(LD_LIBRARY_PATH_ENV_NAME$(1)_T_$(2)_H_$(3))
 496 TARGET_RPATH_VAR$(1)_T_$(2)_H_$(3) := \
 497   $$(LD_LIBRARY_PATH_ENV_NAME$(1)_T_$(2)_H_$(3))=$$(LD_LIBRARY_PATH_ENV_TARGETDIR$(1)_T_$(2)_H_$(3)):$$$$$$(LD_LIBRARY_PATH_ENV_NAME$(1)_T_$(2)_H_$(3))
 498
 499 RPATH_VAR$(1)_T_$(2)_H_$(3) := $$(HOST_RPATH_VAR$(1)_T_$(2)_H_$(3))
 500
 501 # Pass --cfg stage0 only for the build->host part of stage0;
 502 # if you're building a cross config, the host->* parts are
 503 # effectively stage1, since it uses the just-built stage0.
 504 #
 505 # This logic is similar to how the LD_LIBRARY_PATH variable must
 506 # change be slightly different when doing cross compilations.
 507 # The build doesn't copy over all target libraries into
 508 # a new directory, so we need to point the library path at
 509 # the build directory where all the target libraries came
 510 # from (the stage0 build host). Otherwise the relative rpaths
 511 # inside of the rustc binary won't get resolved correctly.
 512 ifeq ($(1),0)
 513 ifneq ($(strip $(CFG_BUILD)),$(strip $(3)))
 514 CFGFLAG$(1)_T_$(2)_H_$(3) = stage1
 515
 516 RPATH_VAR$(1)_T_$(2)_H_$(3) := $$(TARGET_RPATH_VAR$(1)_T_$(2)_H_$(3))
 517 endif
 518 endif
 519
 520 STAGE$(1)_T_$(2)_H_$(3) := \
 521         $$(Q)$$(RPATH_VAR$(1)_T_$(2)_H_$(3)) \
 522                 $$(call CFG_RUN_TARG_$(3),$(1), \
 523                 $$(CFG_VALGRIND_COMPILE$(1)) \
 524                 $$(HBIN$(1)_H_$(3))/rustc$$(X_$(3)) \
 525                 --cfg $$(CFGFLAG$(1)_T_$(2)_H_$(3)) \
 526                 $$(CFG_RUSTC_FLAGS) $$(EXTRAFLAGS_STAGE$(1)) --target=$(2)) \
 527                 $$(RUSTC_FLAGS_$(2))
 528
 529 PERF_STAGE$(1)_T_$(2)_H_$(3) := \
 530         $$(Q)$$(call CFG_RUN_TARG_$(3),$(1), \
 531                 $$(CFG_PERF_TOOL) \
 532                 $$(HBIN$(1)_H_$(3))/rustc$$(X_$(3)) \
 533                 --cfg $$(CFGFLAG$(1)_T_$(2)_H_$(3)) \
 534                 $$(CFG_RUSTC_FLAGS) $$(EXTRAFLAGS_STAGE$(1)) --target=$(2)) \
 535                 $$(RUSTC_FLAGS_$(2))
 536
 537 endef
 538
 539 $(foreach build,$(CFG_HOST), \
 540  $(eval $(foreach target,$(CFG_TARGET), \
 541   $(eval $(foreach stage,$(STAGES), \
 542    $(eval $(call SREQ,$(stage),$(target),$(build))))))))
 543
 544 $(foreach build,$(CFG_HOST), \
 545  $(eval $(foreach target,$(CFG_TARGET), \
 546   $(eval $(foreach stage,$(STAGES), \
 547    $(eval $(call SREQ_CMDS,$(stage),$(target),$(build))))))))
 548
 549 ######################################################################
 550 # rustc-H-targets
 551 #
 552 # Builds a functional Rustc for the given host.
 553 ######################################################################
 554
 555 define DEF_RUSTC_STAGE_TARGET
 556 # $(1) == architecture
 557 # $(2) == stage
 558
 559 rustc-stage$(2)-H-$(1): \
 560         $$(foreach target,$$(CFG_TARGET),$$(SREQ$(2)_T_$$(target)_H_$(1)))
 561
 562 endef
 563
 564 $(foreach host,$(CFG_HOST), \
 565  $(eval $(foreach stage,1 2 3, \
 566   $(eval $(call DEF_RUSTC_STAGE_TARGET,$(host),$(stage))))))
 567
 568 rustc-stage1: rustc-stage1-H-$(CFG_BUILD)
 569 rustc-stage2: rustc-stage2-H-$(CFG_BUILD)
 570 rustc-stage3: rustc-stage3-H-$(CFG_BUILD)
 571
 572 define DEF_RUSTC_TARGET
 573 # $(1) == architecture
 574
 575 rustc-H-$(1): rustc-stage2-H-$(1)
 576 endef
 577
 578 $(foreach host,$(CFG_TARGET), \
 579  $(eval $(call DEF_RUSTC_TARGET,$(host))))
 580
 581 rustc-stage1: rustc-stage1-H-$(CFG_BUILD)
 582 rustc-stage2: rustc-stage2-H-$(CFG_BUILD)
 583 rustc-stage3: rustc-stage3-H-$(CFG_BUILD)
 584 rustc: rustc-H-$(CFG_BUILD)
 585
 586 rustc-H-all: $(foreach host,$(CFG_HOST),rustc-H-$(host))
 587
 588 ######################################################################
 589 # Entrypoint rule
 590 ######################################################################
 591
 592 .DEFAULT_GOAL := all
 593
 594 define ALL_TARGET_N
 595 ifneq ($$(findstring $(1),$$(CFG_HOST)),)
 596 # This is a host
 597 all-target-$(1)-host-$(2): $$(CSREQ2_T_$(1)_H_$(2))
 598 else
 599 # This is a target only
 600 all-target-$(1)-host-$(2): $$(SREQ2_T_$(1)_H_$(2))
 601 endif
 602 endef
 603
 604 $(foreach target,$(CFG_TARGET), \
 605  $(foreach host,$(CFG_HOST), \
 606  $(eval $(call ALL_TARGET_N,$(target),$(host)))))
 607
 608 ALL_TARGET_RULES = $(foreach target,$(CFG_TARGET), \
 609         $(foreach host,$(CFG_HOST), \
 610  all-target-$(target)-host-$(host)))
 611
 612 all: $(ALL_TARGET_RULES) $(GENERATED) docs
 613
 614 ######################################################################
 615 # Build system documentation
 616 ######################################################################
 617
 618 # $(1) is the name of the doc <section> in Makefile.in
 619 # pick everything between tags | remove first line | remove last line
 620 # | remove extra (?) line | strip leading `#` from lines
 621 SHOW_DOCS = $(Q)awk '/<$(1)>/,/<\/$(1)>/' $(S)/Makefile.in | sed '1d' | sed '$$d' | sed 's/^\# \?//'
 622
 623 help:
 624         $(call SHOW_DOCS,help)
 625
 626 tips:
 627         $(call SHOW_DOCS,tips)
 628
 629 nitty-gritty:
 630         $(call SHOW_DOCS,nitty-gritty)