1 # 2 # Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved. 3 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 # 5 # This code is free software; you can redistribute it and/or modify it 6 # under the terms of the GNU General Public License version 2 only, as 7 # published by the Free Software Foundation. Oracle designates this 8 # particular file as subject to the "Classpath" exception as provided 9 # by Oracle in the LICENSE file that accompanied this code. 10 # 11 # This code is distributed in the hope that it will be useful, but WITHOUT 12 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 # version 2 for more details (a copy is included in the LICENSE file that 15 # accompanied this code). 16 # 17 # You should have received a copy of the GNU General Public License version 18 # 2 along with this work; if not, write to the Free Software Foundation, 19 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 # 21 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 # or visit www.oracle.com if you need additional information or have any 23 # questions. 24 # 25 26 ################################################################################ 27 # This is the bootstrapping part of the build. This file is included from the 28 # top level Makefile, and is responsible for launching the Main.gmk file with 29 # the proper make and the proper make arguments. 30 ################################################################################ 31 32 # This must be the first rule 33 default: 34 .PHONY: default 35 36 # Inclusion of this pseudo-target will cause make to execute this file 37 # serially, regardless of -j. 38 .NOTPARALLEL: 39 40 ifeq ($(HAS_SPEC),) 41 ############################################################################## 42 # This is the default mode. We have not been recursively called with a SPEC. 43 ############################################################################## 44 45 # Include our helper functions. 46 include $(topdir)/make/InitSupport.gmk 47 48 # Here are "global" targets, i.e. targets that can be executed without having 49 # a configuration. This will define ALL_GLOBAL_TARGETS. 50 include $(topdir)/make/Help.gmk 51 52 # Targets provided by Init.gmk. 53 ALL_INIT_TARGETS := print-modules print-targets print-configuration \ 54 reconfigure pre-compare-build post-compare-build 55 56 # CALLED_TARGETS is the list of targets that the user provided, 57 # or "default" if unspecified. 58 CALLED_TARGETS := $(if $(MAKECMDGOALS), $(MAKECMDGOALS), default) 59 60 # Extract non-global targets that require a spec file. 61 CALLED_SPEC_TARGETS := $(filter-out $(ALL_GLOBAL_TARGETS), $(CALLED_TARGETS)) 62 63 # If we have only global targets, or if we are called with -qp (assuming an 64 # external part, e.g. bash completion, is trying to understand our targets), 65 # we will skip SPEC location and the sanity checks. 66 ifeq ($(CALLED_SPEC_TARGETS), ) 67 ONLY_GLOBAL_TARGETS := true 68 endif 69 ifneq ($(findstring qp, $(MAKEFLAGS)),) 70 ONLY_GLOBAL_TARGETS := true 71 endif 72 73 ifeq ($(ONLY_GLOBAL_TARGETS), true) 74 ############################################################################ 75 # We have only global targets, or are called with -pq. 76 ############################################################################ 77 78 ifeq ($(wildcard $(SPEC)), ) 79 # If we have no SPEC provided, we will just make a "best effort" target list. 80 # First try to grab any available pre-existing main-targets.gmk. 81 main_targets_file := $(firstword $(wildcard $(build_dir)/*/make-support/main-targets.gmk)) 82 ifneq ($(main_targets_file), ) 83 # Extract the SPEC that corresponds to this main-targets.gmk file. 84 SPEC := $(patsubst %/make-support/main-targets.gmk, %/spec.gmk, $(main_targets_file)) 85 else 86 # None found, pick an arbitrary SPEC for which to generate a file 87 SPEC := $(firstword $(all_spec_files)) 88 endif 89 endif 90 91 ifneq ($(wildcard $(SPEC)), ) 92 $(eval $(call DefineMainTargets, LAZY, $(SPEC))) 93 else 94 # If we have no configurations we can not provide any main targets. 95 ALL_MAIN_TARGETS := 96 endif 97 98 ALL_TARGETS := $(sort $(ALL_GLOBAL_TARGETS) $(ALL_MAIN_TARGETS) $(ALL_INIT_TARGETS)) 99 100 # Just list all our targets. 101 $(ALL_TARGETS): 102 103 .PHONY: $(ALL_TARGETS) 104 105 else 106 ############################################################################ 107 # This is the normal case, we have been called from the command line by the 108 # user and we need to call ourself back with a proper SPEC. 109 # We have at least one non-global target, so we need to find a spec file. 110 ############################################################################ 111 112 # Basic checks on environment and command line. 113 $(eval $(call CheckControlVariables)) 114 $(eval $(call CheckDeprecatedEnvironment)) 115 $(eval $(call CheckInvalidMakeFlags)) 116 117 # Check that CONF_CHECK is valid. 118 $(eval $(call ParseConfCheckOption)) 119 120 # Check that the LOG given is valid, and set LOG_LEVEL, LOG_NOFILE and MAKE_LOG_FLAGS. 121 $(eval $(call ParseLogLevel)) 122 123 # After this SPECS contain 1..N spec files (otherwise ParseConfAndSpec fails). 124 $(eval $(call ParseConfAndSpec)) 125 126 # Extract main targets from Main.gmk using the spec(s) provided. In theory, 127 # with multiple specs, we should find the intersection of targets provided 128 # by all specs, but we approximate this by an arbitrary spec from the list. 129 # This will setup ALL_MAIN_TARGETS. 130 $(eval $(call DefineMainTargets, FORCE, $(firstword $(SPECS)))) 131 132 # Separate called targets depending on type. 133 INIT_TARGETS := $(filter $(ALL_INIT_TARGETS), $(CALLED_SPEC_TARGETS)) 134 MAIN_TARGETS := $(filter $(ALL_MAIN_TARGETS), $(CALLED_SPEC_TARGETS)) 135 SEQUENTIAL_TARGETS := $(filter dist-clean clean%, $(MAIN_TARGETS)) 136 PARALLEL_TARGETS := $(filter-out $(SEQUENTIAL_TARGETS), $(MAIN_TARGETS)) 137 138 # The spec files depend on the autoconf source code. This check makes sure 139 # the configuration is up to date after changes to configure. 140 CUSTOM_CONFIG_DIR ?= $(topdir)/closed/autoconf 141 142 $(SPECS): $(wildcard $(topdir)/common/autoconf/*) $(wildcard $(CUSTOM_CONFIG_DIR)/*) 143 ifeq ($(CONF_CHECK), fail) 144 @echo "Error: The configuration is not up to date for '$(lastword $(subst /, , $(dir $@)))'." 145 $(call PrintConfCheckFailed) 146 @exit 2 147 else ifeq ($(CONF_CHECK), auto) 148 @echo "Note: The configuration is not up to date for '$(lastword $(subst /, , $(dir $@)))'." 149 @( cd $(topdir) && \ 150 $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -f $(topdir)/make/Init.gmk \ 151 SPEC=$@ HAS_SPEC=true ACTUAL_TOPDIR=$(topdir) \ 152 reconfigure ) 153 else ifeq ($(CONF_CHECK), ignore) 154 # Do nothing 155 endif 156 157 # Unless reconfigure is explicitely called, let all main targets depend on 158 # the spec files to be up to date. 159 ifeq ($(findstring reconfigure, $(INIT_TARGETS)), ) 160 $(MAIN_TARGETS): $(SPECS) 161 endif 162 163 make-info: 164 ifneq ($(findstring $(LOG_LEVEL),info debug trace),) 165 $(info Running make as '$(strip $(MAKE) $(MFLAGS) \ 166 $(COMMAND_LINE_VARIABLES) $(MAKECMDGOALS))') 167 endif 168 169 MAKE_INIT_WITH_SPEC_ARGUMENTS := ACTUAL_TOPDIR=$(topdir) \ 170 USER_MAKE_VARS="$(USER_MAKE_VARS)" MAKE_LOG_FLAGS=$(MAKE_LOG_FLAGS) \ 171 LOG_LEVEL=$(LOG_LEVEL) LOG_NOFILE=$(LOG_NOFILE) \ 172 INIT_TARGETS="$(INIT_TARGETS)" \ 173 SEQUENTIAL_TARGETS="$(SEQUENTIAL_TARGETS)" \ 174 PARALLEL_TARGETS="$(PARALLEL_TARGETS)" 175 176 # Now the init and main targets will be called, once for each SPEC. The 177 # recipe will be run once for every target specified, but we only want to 178 # execute the recipe a single time, hence the TARGET_DONE with a dummy 179 # command if true. 180 # The COMPARE_BUILD part implements special support for makefile development. 181 $(ALL_INIT_TARGETS) $(ALL_MAIN_TARGETS): make-info 182 @$(if $(TARGET_DONE), \ 183 true \ 184 , \ 185 ( cd $(topdir) && \ 186 $(foreach spec, $(SPECS), \ 187 $(call GenerateModuleDeps, $(spec)) && \ 188 $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -j 1 -f $(topdir)/make/Init.gmk \ 189 SPEC=$(spec) HAS_SPEC=true $(MAKE_INIT_WITH_SPEC_ARGUMENTS) \ 190 main && \ 191 $(if $(and $(COMPARE_BUILD), $(PARALLEL_TARGETS)), \ 192 $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -f $(topdir)/make/Init.gmk \ 193 SPEC=$(spec) HAS_SPEC=true ACTUAL_TOPDIR=$(topdir) \ 194 COMPARE_BUILD="$(COMPARE_BUILD)" pre-compare-build && \ 195 $(call GenerateModuleDeps, $(spec)) && \ 196 $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -j 1 -f $(topdir)/make/Init.gmk \ 197 SPEC=$(spec) HAS_SPEC=true $(MAKE_INIT_WITH_SPEC_ARGUMENTS) \ 198 COMPARE_BUILD="$(COMPARE_BUILD)" main && \ 199 $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -f $(topdir)/make/Init.gmk \ 200 SPEC=$(spec) HAS_SPEC=true ACTUAL_TOPDIR=$(topdir) \ 201 COMPARE_BUILD="$(COMPARE_BUILD)" post-compare-build && \ 202 ) \ 203 ) true ) \ 204 $(eval TARGET_DONE=true) \ 205 ) 206 207 .PHONY: $(ALL_MAIN_TARGETS) $(ALL_INIT_TARGETS) 208 209 endif # $(ONLY_GLOBAL_TARGETS)!=true 210 211 else # HAS_SPEC=true 212 213 ############################################################################## 214 # Now we have a spec. This part provides the "main" target that acts as a 215 # trampoline to call the Main.gmk with the value of $(MAKE) found in the spec 216 # file. 217 ############################################################################## 218 219 include $(SPEC) 220 221 # Our helper functions. 222 include $(TOPDIR)/make/InitSupport.gmk 223 224 # Verify that the spec file we included seems okay. 225 $(eval $(call CheckSpecSanity)) 226 227 # Parse COMPARE_BUILD (for makefile development) 228 $(eval $(call ParseCompareBuild)) 229 230 ifeq ($(LOG_NOFILE), true) 231 # Disable build log if LOG=[level,]nofile was given 232 override BUILD_LOG_PIPE := 233 endif 234 235 ifeq ($(OUTPUT_SYNC_SUPPORTED), true) 236 OUTPUT_SYNC_FLAG := -O$(OUTPUT_SYNC) 237 endif 238 239 ############################################################################## 240 # Init targets 241 ############################################################################## 242 243 print-modules: 244 ( cd $(TOPDIR) && \ 245 $(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \ 246 NO_RECIPES=true print-modules ) 247 248 print-targets: 249 ( cd $(TOPDIR) && \ 250 $(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \ 251 NO_RECIPES=true print-targets ) 252 253 print-configuration: 254 $(ECHO) $(CONFIGURE_COMMAND_LINE) 255 256 reconfigure: 257 ifneq ($(CONFIGURE_COMMAND_LINE), ) 258 $(ECHO) "Re-running configure using arguments '$(CONFIGURE_COMMAND_LINE)'" 259 else 260 $(ECHO) "Re-running configure using default settings" 261 endif 262 ( cd $(OUTPUT_ROOT) && PATH="$(ORIGINAL_PATH)" \ 263 $(BASH) $(TOPDIR)/configure $(CONFIGURE_COMMAND_LINE) ) 264 265 ############################################################################## 266 # The main target, for delegating into Main.gmk 267 ############################################################################## 268 269 MAIN_TARGETS := $(SEQUENTIAL_TARGETS) $(PARALLEL_TARGETS) $(COMPARE_BUILD_MAKE) 270 TARGET_DESCRIPTION := target$(if $(word 2, $(MAIN_TARGETS)),s) \ 271 '$(strip $(MAIN_TARGETS))' in configuration '$(CONF_NAME)' 272 273 # MAKEOVERRIDES is automatically set and propagated by Make to sub-Make calls. 274 # We need to clear it of the init-specific variables. The user-specified 275 # variables are explicitely propagated using $(USER_MAKE_VARS). 276 main: MAKEOVERRIDES := 277 278 main: $(INIT_TARGETS) 279 ifneq ($(SEQUENTIAL_TARGETS)$(PARALLEL_TARGETS), ) 280 $(call RotateLogFiles) 281 $(call PrepareFailureLogs) 282 $(PRINTF) "Building $(TARGET_DESCRIPTION)\n" $(BUILD_LOG_PIPE) 283 ifneq ($(SEQUENTIAL_TARGETS), ) 284 # Don't touch build output dir since we might be cleaning. That 285 # means no log pipe. 286 ( cd $(TOPDIR) && \ 287 $(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \ 288 $(SEQUENTIAL_TARGETS) ) 289 endif 290 ifneq ($(PARALLEL_TARGETS), ) 291 $(call StartGlobalTimer) 292 $(call PrepareSmartJavac) 293 ( cd $(TOPDIR) && \ 294 $(NICE) $(MAKE) $(MAKE_ARGS) $(OUTPUT_SYNC_FLAG) \ 295 -j $(JOBS) -f make/Main.gmk $(USER_MAKE_VARS) \ 296 $(PARALLEL_TARGETS) $(COMPARE_BUILD_MAKE) $(BUILD_LOG_PIPE) || \ 297 ( exitcode=$$? && \ 298 $(PRINTF) "\nERROR: Build failed for $(TARGET_DESCRIPTION) (exit code $$exitcode) \n" \ 299 $(BUILD_LOG_PIPE) && \ 300 cd $(TOPDIR) && $(MAKE) $(MAKE_ARGS) -j 1 -f make/Init.gmk \ 301 HAS_SPEC=true on-failure ; \ 302 exit $$exitcode ) ) 303 $(call CleanupSmartJavac) 304 $(call StopGlobalTimer) 305 $(call ReportBuildTimes) 306 endif 307 $(PRINTF) "Finished building $(TARGET_DESCRIPTION)\n" $(BUILD_LOG_PIPE) 308 endif 309 310 on-failure: 311 $(call PrintFailureReports) 312 $(call PrintBuildLogFailures) 313 $(PRINTF) "Hint: If caused by a warning, try configure --disable-warnings-as-errors.\n\n" 314 ifneq ($(COMPARE_BUILD), ) 315 $(call CleanupCompareBuild) 316 endif 317 318 # Support targets for COMPARE_BUILD, used for makefile development 319 pre-compare-build: 320 $(call PrepareCompareBuild) 321 322 post-compare-build: 323 $(call CleanupCompareBuild) 324 $(call CompareBuildDoComparison) 325 326 .PHONY: print-targets print-modules reconfigure main on-failure 327 endif