make/Init.gmk - platform/libcore - Gitiles

 #
 # Copyright (c) 2012, 2018, Oracle and/or its affiliates. All rights reserved.
 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 #
 # This code is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License version 2 only, as
 # published by the Free Software Foundation.  Oracle designates this
 # particular file as subject to the "Classpath" exception as provided
 # by Oracle in the LICENSE file that accompanied this code.
 #
 # This code is distributed in the hope that it will be useful, but WITHOUT
 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 # FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 # version 2 for more details (a copy is included in the LICENSE file that
 # accompanied this code).
 #
 # You should have received a copy of the GNU General Public License version
 # 2 along with this work; if not, write to the Free Software Foundation,
 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 #
 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 # or visit www.oracle.com if you need additional information or have any
 # questions.
 #

 ################################################################################
 # This is the bootstrapping part of the build. This file is included from the
 # top level Makefile, and is responsible for launching the Main.gmk file with
 # the proper make and the proper make arguments.
 ################################################################################

 # This must be the first rule
 default:
 .PHONY: default

 # Inclusion of this pseudo-target will cause make to execute this file
 # serially, regardless of -j.
 .NOTPARALLEL:

 ifeq ($(HAS_SPEC),)
   ##############################################################################
   # This is the default mode. We have not been recursively called with a SPEC.
   ##############################################################################

   # Include our helper functions.
   include $(topdir)/make/InitSupport.gmk

   # Here are "global" targets, i.e. targets that can be executed without having
   # a configuration. This will define ALL_GLOBAL_TARGETS.
   include $(topdir)/make/Help.gmk

   # Targets provided by Init.gmk.
   ALL_INIT_TARGETS := print-modules print-targets print-configuration \
       print-tests reconfigure pre-compare-build post-compare-build

   # CALLED_TARGETS is the list of targets that the user provided,
   # or "default" if unspecified.
   CALLED_TARGETS := $(if $(MAKECMDGOALS), $(MAKECMDGOALS), default)

   # Extract non-global targets that require a spec file.
   CALLED_SPEC_TARGETS := $(filter-out $(ALL_GLOBAL_TARGETS), $(CALLED_TARGETS))

   # If we have only global targets, or if we are called with -qp (assuming an
   # external part, e.g. bash completion, is trying to understand our targets),
   # we will skip SPEC location and the sanity checks.
   ifeq ($(CALLED_SPEC_TARGETS), )
     ONLY_GLOBAL_TARGETS := true
   endif
   ifeq ($(findstring p, $(MAKEFLAGS))$(findstring q, $(MAKEFLAGS)), pq)
     ONLY_GLOBAL_TARGETS := true
   endif

   ifeq ($(ONLY_GLOBAL_TARGETS), true)
     ############################################################################
     # We have only global targets, or are called with -pq.
     ############################################################################

     ifeq ($(wildcard $(SPEC)), )
       # If we have no SPEC provided, we will just make a "best effort" target list.
       # First try to grab any available pre-existing main-targets.gmk.
       main_targets_file := $(firstword $(wildcard $(build_dir)/*/make-support/main-targets.gmk))
       ifneq ($(main_targets_file), )
         # Extract the SPEC that corresponds to this main-targets.gmk file.
         SPEC := $(patsubst %/make-support/main-targets.gmk, %/spec.gmk, $(main_targets_file))
       else
         # None found, pick an arbitrary SPEC for which to generate a file
         SPEC := $(firstword $(all_spec_files))
       endif
     endif

     ifneq ($(wildcard $(SPEC)), )
       $(eval $(call DefineMainTargets, LAZY, $(SPEC)))
     else
       # If we have no configurations we can not provide any main targets.
       ALL_MAIN_TARGETS :=
     endif

     ALL_TARGETS := $(sort $(ALL_GLOBAL_TARGETS) $(ALL_MAIN_TARGETS) $(ALL_INIT_TARGETS))

     # Just list all our targets.
     $(ALL_TARGETS):

     .PHONY: $(ALL_TARGETS)

   else
     ############################################################################
     # This is the normal case, we have been called from the command line by the
     # user and we need to call ourself back with a proper SPEC.
     # We have at least one non-global target, so we need to find a spec file.
     ############################################################################

     # Basic checks on environment and command line.
     $(eval $(call CheckControlVariables))
     $(eval $(call CheckDeprecatedEnvironment))
     $(eval $(call CheckInvalidMakeFlags))

     # Check that CONF_CHECK is valid.
     $(eval $(call ParseConfCheckOption))

     # Check that the LOG given is valid, and set LOG_LEVEL, LOG_NOFILE, MAKE_LOG_VARS and MAKE_LOG_FLAGS.
     $(eval $(call ParseLogLevel))

     # After this SPECS contain 1..N spec files (otherwise ParseConfAndSpec fails).
     $(eval $(call ParseConfAndSpec))

     # Extract main targets from Main.gmk using the spec(s) provided. In theory,
     # with multiple specs, we should find the intersection of targets provided
     # by all specs, but we approximate this by an arbitrary spec from the list.
     # This will setup ALL_MAIN_TARGETS.
     $(eval $(call DefineMainTargets, FORCE, $(firstword $(SPECS))))

     # Separate called targets depending on type.
     INIT_TARGETS := $(filter $(ALL_INIT_TARGETS), $(CALLED_SPEC_TARGETS))
     MAIN_TARGETS := $(filter $(ALL_MAIN_TARGETS), $(CALLED_SPEC_TARGETS))
     SEQUENTIAL_TARGETS := $(filter dist-clean clean%, $(MAIN_TARGETS))
     PARALLEL_TARGETS := $(filter-out $(SEQUENTIAL_TARGETS), $(MAIN_TARGETS))

     # The spec files depend on the autoconf source code. This check makes sure
     # the configuration is up to date after changes to configure.
     $(SPECS): $(wildcard $(topdir)/make/autoconf/*) \
             $(if $(CUSTOM_CONFIG_DIR), $(wildcard $(CUSTOM_CONFIG_DIR)/*))
         ifeq ($(CONF_CHECK), fail)
 	  @echo Error: The configuration is not up to date for \
 	      "'$(lastword $(subst /, , $(dir $@)))'."
 	  $(call PrintConfCheckFailed)
 	  @exit 2
         else ifeq ($(CONF_CHECK), auto)
 	  @echo Note: The configuration is not up to date for \
 	      "'$(lastword $(subst /, , $(dir $@)))'."
 	  @( cd $(topdir) && \
 	      $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -f $(topdir)/make/Init.gmk \
 	      SPEC=$@ HAS_SPEC=true ACTUAL_TOPDIR=$(topdir) \
 	      reconfigure )
         else ifeq ($(CONF_CHECK), ignore)
           # Do nothing
         endif

     # Do not let make delete spec files even if aborted while doing a reconfigure
     .PRECIOUS: $(SPECS)

     # Unless reconfigure is explicitly called, let all main targets depend on
     # the spec files to be up to date.
     ifeq ($(findstring reconfigure, $(INIT_TARGETS)), )
       $(MAIN_TARGETS): $(SPECS)
     endif

     make-info:
         ifneq ($(findstring $(LOG_LEVEL),info debug trace),)
 	  $(info Running make as '$(strip $(MAKE) $(MFLAGS) \
 	      $(COMMAND_LINE_VARIABLES) $(MAKECMDGOALS))')
         endif

     MAKE_INIT_WITH_SPEC_ARGUMENTS := ACTUAL_TOPDIR=$(topdir) \
         USER_MAKE_VARS="$(USER_MAKE_VARS)" MAKE_LOG_FLAGS=$(MAKE_LOG_FLAGS) \
         $(MAKE_LOG_VARS) \
         INIT_TARGETS="$(INIT_TARGETS)" \
         SEQUENTIAL_TARGETS="$(SEQUENTIAL_TARGETS)" \
         PARALLEL_TARGETS="$(PARALLEL_TARGETS)"

     # Now the init and main targets will be called, once for each SPEC. The
     # recipe will be run once for every target specified, but we only want to
     # execute the recipe a single time, hence the TARGET_DONE with a dummy
     # command if true.
     # The COMPARE_BUILD part implements special support for makefile development.
     $(ALL_INIT_TARGETS) $(ALL_MAIN_TARGETS): make-info
 	@$(if $(TARGET_DONE), \
 	  true \
 	, \
 	  ( cd $(topdir) && \
 	  $(foreach spec, $(SPECS), \
 	    $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -j 1 -f $(topdir)/make/Init.gmk \
 	        SPEC=$(spec) HAS_SPEC=true $(MAKE_INIT_WITH_SPEC_ARGUMENTS) \
 	        main && \
 	    $(if $(and $(COMPARE_BUILD), $(PARALLEL_TARGETS)), \
 	        $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -f $(topdir)/make/Init.gmk \
 	            SPEC=$(spec) HAS_SPEC=true ACTUAL_TOPDIR=$(topdir) \
 	            COMPARE_BUILD="$(COMPARE_BUILD)" pre-compare-build && \
 	        $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -j 1 -f $(topdir)/make/Init.gmk \
 	            SPEC=$(spec) HAS_SPEC=true $(MAKE_INIT_WITH_SPEC_ARGUMENTS) \
 	            COMPARE_BUILD="$(COMPARE_BUILD)" main && \
 	        $(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -f $(topdir)/make/Init.gmk \
 	            SPEC=$(spec) HAS_SPEC=true ACTUAL_TOPDIR=$(topdir) \
 	            COMPARE_BUILD="$(COMPARE_BUILD)" post-compare-build && \
 	    ) \
 	  ) true ) \
 	  $(eval TARGET_DONE=true) \
 	)

     .PHONY: $(ALL_MAIN_TARGETS) $(ALL_INIT_TARGETS)

   endif # $(ONLY_GLOBAL_TARGETS)!=true

 else # HAS_SPEC=true

   ##############################################################################
   # Now we have a spec. This part provides the "main" target that acts as a
   # trampoline to call the Main.gmk with the value of $(MAKE) found in the spec
   # file.
   ##############################################################################

   include $(SPEC)

   # Our helper functions.
   include $(TOPDIR)/make/InitSupport.gmk

   # Parse COMPARE_BUILD (for makefile development)
   $(eval $(call ParseCompareBuild))

   # If no LOG= was given on command line, but we have a non-standard default
   # value, use that instead and re-parse log level.
   ifeq ($(LOG), )
     ifneq ($(DEFAULT_LOG), )
       override LOG := $(DEFAULT_LOG)
       $(eval $(call ParseLogLevel))
     endif
   endif

   ifeq ($(LOG_NOFILE), true)
     # Disable build log if LOG=[level,]nofile was given
     override BUILD_LOG_PIPE :=
   endif

   ifeq ($(OUTPUT_SYNC_SUPPORTED), true)
     OUTPUT_SYNC_FLAG := -O$(OUTPUT_SYNC)
   endif

   ##############################################################################
   # Init targets
   ##############################################################################

   print-modules:
 	( cd $(TOPDIR) && \
 	    $(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \
 	    NO_RECIPES=true print-modules )

   print-targets:
 	( cd $(TOPDIR) && \
 	    $(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \
 	    NO_RECIPES=true print-targets )

   print-tests:
 	( cd $(TOPDIR) && \
 	    $(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \
 	    NO_RECIPES=true print-tests )

   print-configuration:
 	  $(ECHO) $(CONFIGURE_COMMAND_LINE)

   reconfigure:
         ifneq ($(CONFIGURE_COMMAND_LINE), )
 	  $(ECHO) "Re-running configure using arguments '$(CONFIGURE_COMMAND_LINE)'"
         else
 	  $(ECHO) "Re-running configure using default settings"
         endif
 	( cd $(OUTPUTDIR) && PATH="$(ORIGINAL_PATH)" \
 	    CUSTOM_ROOT="$(CUSTOM_ROOT)" \
 	    CUSTOM_CONFIG_DIR="$(CUSTOM_CONFIG_DIR)" \
 	    $(BASH) $(TOPDIR)/configure $(CONFIGURE_COMMAND_LINE) )

   ##############################################################################
   # The main target, for delegating into Main.gmk
   ##############################################################################

   MAIN_TARGETS := $(SEQUENTIAL_TARGETS) $(PARALLEL_TARGETS) $(COMPARE_BUILD_MAKE)
   # If building the default target, add what they are to the description.
   DESCRIPTION_TARGETS := $(strip $(MAIN_TARGETS))
   ifeq ($(DESCRIPTION_TARGETS), default)
     DESCRIPTION_TARGETS += ($(DEFAULT_MAKE_TARGET))
   endif
   TARGET_DESCRIPTION := target$(if $(word 2, $(MAIN_TARGETS)),s) \
       '$(strip $(DESCRIPTION_TARGETS))' in configuration '$(CONF_NAME)'

   # MAKEOVERRIDES is automatically set and propagated by Make to sub-Make calls.
   # We need to clear it of the init-specific variables. The user-specified
   # variables are explicitly propagated using $(USER_MAKE_VARS).
   main: MAKEOVERRIDES :=

   main: $(INIT_TARGETS)
         ifneq ($(SEQUENTIAL_TARGETS)$(PARALLEL_TARGETS), )
 	  $(call RotateLogFiles)
 	  $(PRINTF) "Building $(TARGET_DESCRIPTION)\n" $(BUILD_LOG_PIPE)
           ifneq ($(SEQUENTIAL_TARGETS), )
             # Don't touch build output dir since we might be cleaning. That
             # means no log pipe.
 	    ( cd $(TOPDIR) && \
 	        $(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \
 	        $(SEQUENTIAL_TARGETS) )
           endif
           ifneq ($(PARALLEL_TARGETS), )
 	    $(call PrepareFailureLogs)
 	    $(call StartGlobalTimer)
 	    $(call PrepareSmartJavac)
             # JOBS will only be empty for a bootcycle-images recursive call
             # or if specified via a make argument directly. In those cases
             # treat it as NOT using jobs at all.
 	    ( cd $(TOPDIR) && \
 	        $(NICE) $(MAKE) $(MAKE_ARGS) $(OUTPUT_SYNC_FLAG) \
                     $(if $(JOBS), -j $(JOBS)) \
 	            -f make/Main.gmk $(USER_MAKE_VARS) \
 	            $(PARALLEL_TARGETS) $(COMPARE_BUILD_MAKE) $(BUILD_LOG_PIPE) || \
 	        ( exitcode=$$? && \
 	        $(PRINTF) "\nERROR: Build failed for $(TARGET_DESCRIPTION) (exit code $$exitcode) \n" \
 	            $(BUILD_LOG_PIPE) && \
 	        cd $(TOPDIR) && $(MAKE) $(MAKE_ARGS) -j 1 -f make/Init.gmk \
 	            HAS_SPEC=true on-failure ; \
 	        exit $$exitcode ) )
 	    $(call CleanupSmartJavac)
 	    $(call StopGlobalTimer)
 	    $(call ReportBuildTimes)
           endif
 	  if test -f $(MAKESUPPORT_OUTPUTDIR)/exit-with-error ; then \
 	    exit 1 ; \
 	  fi
 	  $(PRINTF) "Finished building $(TARGET_DESCRIPTION)\n" $(BUILD_LOG_PIPE)
 	  $(call ReportProfileTimes)
         endif

     on-failure:
 	$(call CleanupSmartJavac)
 	$(call StopGlobalTimer)
 	$(call ReportBuildTimes)
 	$(call PrintFailureReports)
 	$(call PrintBuildLogFailures)
 	$(call ReportProfileTimes)
 	$(PRINTF) "Hint: See doc/building.html#troubleshooting for assistance.\n\n"
         ifneq ($(COMPARE_BUILD), )
 	  $(call CleanupCompareBuild)
         endif

     # Support targets for COMPARE_BUILD, used for makefile development
     pre-compare-build:
 	$(call WaitForSmartJavacFinish)
 	$(call PrepareCompareBuild)

     post-compare-build:
 	$(call WaitForSmartJavacFinish)
 	$(call CleanupCompareBuild)
 	$(call CompareBuildDoComparison)

   .PHONY: print-targets print-modules reconfigure main on-failure
 endif
	#
	# Copyright (c) 2012, 2018, Oracle and/or its affiliates. All rights reserved.
	# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
	#
	# This code is free software; you can redistribute it and/or modify it
	# under the terms of the GNU General Public License version 2 only, as
	# published by the Free Software Foundation. Oracle designates this
	# particular file as subject to the "Classpath" exception as provided
	# by Oracle in the LICENSE file that accompanied this code.
	#
	# This code is distributed in the hope that it will be useful, but WITHOUT
	# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
	# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
	# version 2 for more details (a copy is included in the LICENSE file that
	# accompanied this code).
	#
	# You should have received a copy of the GNU General Public License version
	# 2 along with this work; if not, write to the Free Software Foundation,
	# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
	#
	# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
	# or visit www.oracle.com if you need additional information or have any
	# questions.
	#

	################################################################################
	# This is the bootstrapping part of the build. This file is included from the
	# top level Makefile, and is responsible for launching the Main.gmk file with
	# the proper make and the proper make arguments.
	################################################################################

	# This must be the first rule
	default:
	.PHONY: default

	# Inclusion of this pseudo-target will cause make to execute this file
	# serially, regardless of -j.
	.NOTPARALLEL:

	ifeq ($(HAS_SPEC),)
	##############################################################################
	# This is the default mode. We have not been recursively called with a SPEC.
	##############################################################################

	# Include our helper functions.
	include $(topdir)/make/InitSupport.gmk

	# Here are "global" targets, i.e. targets that can be executed without having
	# a configuration. This will define ALL_GLOBAL_TARGETS.
	include $(topdir)/make/Help.gmk

	# Targets provided by Init.gmk.
	ALL_INIT_TARGETS := print-modules print-targets print-configuration \
	print-tests reconfigure pre-compare-build post-compare-build

	# CALLED_TARGETS is the list of targets that the user provided,
	# or "default" if unspecified.
	CALLED_TARGETS := $(if $(MAKECMDGOALS), $(MAKECMDGOALS), default)

	# Extract non-global targets that require a spec file.
	CALLED_SPEC_TARGETS := $(filter-out $(ALL_GLOBAL_TARGETS), $(CALLED_TARGETS))

	# If we have only global targets, or if we are called with -qp (assuming an
	# external part, e.g. bash completion, is trying to understand our targets),
	# we will skip SPEC location and the sanity checks.
	ifeq ($(CALLED_SPEC_TARGETS), )
	ONLY_GLOBAL_TARGETS := true
	endif
	ifeq ($(findstring p, $(MAKEFLAGS))$(findstring q, $(MAKEFLAGS)), pq)
	ONLY_GLOBAL_TARGETS := true
	endif

	ifeq ($(ONLY_GLOBAL_TARGETS), true)
	############################################################################
	# We have only global targets, or are called with -pq.
	############################################################################

	ifeq ($(wildcard $(SPEC)), )
	# If we have no SPEC provided, we will just make a "best effort" target list.
	# First try to grab any available pre-existing main-targets.gmk.
	main_targets_file := $(firstword $(wildcard $(build_dir)/*/make-support/main-targets.gmk))
	ifneq ($(main_targets_file), )
	# Extract the SPEC that corresponds to this main-targets.gmk file.
	SPEC := $(patsubst %/make-support/main-targets.gmk, %/spec.gmk, $(main_targets_file))
	else
	# None found, pick an arbitrary SPEC for which to generate a file
	SPEC := $(firstword $(all_spec_files))
	endif
	endif

	ifneq ($(wildcard $(SPEC)), )
	$(eval $(call DefineMainTargets, LAZY, $(SPEC)))
	else
	# If we have no configurations we can not provide any main targets.
	ALL_MAIN_TARGETS :=
	endif

	ALL_TARGETS := $(sort $(ALL_GLOBAL_TARGETS) $(ALL_MAIN_TARGETS) $(ALL_INIT_TARGETS))

	# Just list all our targets.
	$(ALL_TARGETS):

	.PHONY: $(ALL_TARGETS)

	else
	############################################################################
	# This is the normal case, we have been called from the command line by the
	# user and we need to call ourself back with a proper SPEC.
	# We have at least one non-global target, so we need to find a spec file.
	############################################################################

	# Basic checks on environment and command line.
	$(eval $(call CheckControlVariables))
	$(eval $(call CheckDeprecatedEnvironment))
	$(eval $(call CheckInvalidMakeFlags))

	# Check that CONF_CHECK is valid.
	$(eval $(call ParseConfCheckOption))

	# Check that the LOG given is valid, and set LOG_LEVEL, LOG_NOFILE, MAKE_LOG_VARS and MAKE_LOG_FLAGS.
	$(eval $(call ParseLogLevel))

	# After this SPECS contain 1..N spec files (otherwise ParseConfAndSpec fails).
	$(eval $(call ParseConfAndSpec))

	# Extract main targets from Main.gmk using the spec(s) provided. In theory,
	# with multiple specs, we should find the intersection of targets provided
	# by all specs, but we approximate this by an arbitrary spec from the list.
	# This will setup ALL_MAIN_TARGETS.
	$(eval $(call DefineMainTargets, FORCE, $(firstword $(SPECS))))

	# Separate called targets depending on type.
	INIT_TARGETS := $(filter $(ALL_INIT_TARGETS), $(CALLED_SPEC_TARGETS))
	MAIN_TARGETS := $(filter $(ALL_MAIN_TARGETS), $(CALLED_SPEC_TARGETS))
	SEQUENTIAL_TARGETS := $(filter dist-clean clean%, $(MAIN_TARGETS))
	PARALLEL_TARGETS := $(filter-out $(SEQUENTIAL_TARGETS), $(MAIN_TARGETS))

	# The spec files depend on the autoconf source code. This check makes sure
	# the configuration is up to date after changes to configure.
	$(SPECS): $(wildcard $(topdir)/make/autoconf/*) \
	$(if $(CUSTOM_CONFIG_DIR), $(wildcard $(CUSTOM_CONFIG_DIR)/*))
	ifeq ($(CONF_CHECK), fail)
	@echo Error: The configuration is not up to date for \
	"'$(lastword $(subst /, , $(dir $@)))'."
	$(call PrintConfCheckFailed)
	@exit 2
	else ifeq ($(CONF_CHECK), auto)
	@echo Note: The configuration is not up to date for \
	"'$(lastword $(subst /, , $(dir $@)))'."
	@( cd $(topdir) && \
	$(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -f $(topdir)/make/Init.gmk \
	SPEC=$@ HAS_SPEC=true ACTUAL_TOPDIR=$(topdir) \
	reconfigure )
	else ifeq ($(CONF_CHECK), ignore)
	# Do nothing
	endif

	# Do not let make delete spec files even if aborted while doing a reconfigure
	.PRECIOUS: $(SPECS)

	# Unless reconfigure is explicitly called, let all main targets depend on
	# the spec files to be up to date.
	ifeq ($(findstring reconfigure, $(INIT_TARGETS)), )
	$(MAIN_TARGETS): $(SPECS)
	endif

	make-info:
	ifneq ($(findstring $(LOG_LEVEL),info debug trace),)
	$(info Running make as '$(strip $(MAKE) $(MFLAGS) \
	$(COMMAND_LINE_VARIABLES) $(MAKECMDGOALS))')
	endif

	MAKE_INIT_WITH_SPEC_ARGUMENTS := ACTUAL_TOPDIR=$(topdir) \
	USER_MAKE_VARS="$(USER_MAKE_VARS)" MAKE_LOG_FLAGS=$(MAKE_LOG_FLAGS) \
	$(MAKE_LOG_VARS) \
	INIT_TARGETS="$(INIT_TARGETS)" \
	SEQUENTIAL_TARGETS="$(SEQUENTIAL_TARGETS)" \
	PARALLEL_TARGETS="$(PARALLEL_TARGETS)"

	# Now the init and main targets will be called, once for each SPEC. The
	# recipe will be run once for every target specified, but we only want to
	# execute the recipe a single time, hence the TARGET_DONE with a dummy
	# command if true.
	# The COMPARE_BUILD part implements special support for makefile development.
	$(ALL_INIT_TARGETS) $(ALL_MAIN_TARGETS): make-info
	@$(if $(TARGET_DONE), \
	true \
	, \
	( cd $(topdir) && \
	$(foreach spec, $(SPECS), \
	$(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -j 1 -f $(topdir)/make/Init.gmk \
	SPEC=$(spec) HAS_SPEC=true $(MAKE_INIT_WITH_SPEC_ARGUMENTS) \
	main && \
	$(if $(and $(COMPARE_BUILD), $(PARALLEL_TARGETS)), \
	$(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -f $(topdir)/make/Init.gmk \
	SPEC=$(spec) HAS_SPEC=true ACTUAL_TOPDIR=$(topdir) \
	COMPARE_BUILD="$(COMPARE_BUILD)" pre-compare-build && \
	$(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -j 1 -f $(topdir)/make/Init.gmk \
	SPEC=$(spec) HAS_SPEC=true $(MAKE_INIT_WITH_SPEC_ARGUMENTS) \
	COMPARE_BUILD="$(COMPARE_BUILD)" main && \
	$(MAKE) $(MFLAGS) $(MAKE_LOG_FLAGS) -r -R -f $(topdir)/make/Init.gmk \
	SPEC=$(spec) HAS_SPEC=true ACTUAL_TOPDIR=$(topdir) \
	COMPARE_BUILD="$(COMPARE_BUILD)" post-compare-build && \
	) \
	) true ) \
	$(eval TARGET_DONE=true) \
	)

	.PHONY: $(ALL_MAIN_TARGETS) $(ALL_INIT_TARGETS)

	endif # $(ONLY_GLOBAL_TARGETS)!=true

	else # HAS_SPEC=true

	##############################################################################
	# Now we have a spec. This part provides the "main" target that acts as a
	# trampoline to call the Main.gmk with the value of $(MAKE) found in the spec
	# file.
	##############################################################################

	include $(SPEC)

	# Our helper functions.
	include $(TOPDIR)/make/InitSupport.gmk

	# Parse COMPARE_BUILD (for makefile development)
	$(eval $(call ParseCompareBuild))

	# If no LOG= was given on command line, but we have a non-standard default
	# value, use that instead and re-parse log level.
	ifeq ($(LOG), )
	ifneq ($(DEFAULT_LOG), )
	override LOG := $(DEFAULT_LOG)
	$(eval $(call ParseLogLevel))
	endif
	endif

	ifeq ($(LOG_NOFILE), true)
	# Disable build log if LOG=[level,]nofile was given
	override BUILD_LOG_PIPE :=
	endif

	ifeq ($(OUTPUT_SYNC_SUPPORTED), true)
	OUTPUT_SYNC_FLAG := -O$(OUTPUT_SYNC)
	endif

	##############################################################################
	# Init targets
	##############################################################################

	print-modules:
	( cd $(TOPDIR) && \
	$(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \
	NO_RECIPES=true print-modules )

	print-targets:
	( cd $(TOPDIR) && \
	$(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \
	NO_RECIPES=true print-targets )

	print-tests:
	( cd $(TOPDIR) && \
	$(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \
	NO_RECIPES=true print-tests )

	print-configuration:
	$(ECHO) $(CONFIGURE_COMMAND_LINE)

	reconfigure:
	ifneq ($(CONFIGURE_COMMAND_LINE), )
	$(ECHO) "Re-running configure using arguments '$(CONFIGURE_COMMAND_LINE)'"
	else
	$(ECHO) "Re-running configure using default settings"
	endif
	( cd $(OUTPUTDIR) && PATH="$(ORIGINAL_PATH)" \
	CUSTOM_ROOT="$(CUSTOM_ROOT)" \
	CUSTOM_CONFIG_DIR="$(CUSTOM_CONFIG_DIR)" \
	$(BASH) $(TOPDIR)/configure $(CONFIGURE_COMMAND_LINE) )

	##############################################################################
	# The main target, for delegating into Main.gmk
	##############################################################################

	MAIN_TARGETS := $(SEQUENTIAL_TARGETS) $(PARALLEL_TARGETS) $(COMPARE_BUILD_MAKE)
	# If building the default target, add what they are to the description.
	DESCRIPTION_TARGETS := $(strip $(MAIN_TARGETS))
	ifeq ($(DESCRIPTION_TARGETS), default)
	DESCRIPTION_TARGETS += ($(DEFAULT_MAKE_TARGET))
	endif
	TARGET_DESCRIPTION := target$(if $(word 2, $(MAIN_TARGETS)),s) \
	'$(strip $(DESCRIPTION_TARGETS))' in configuration '$(CONF_NAME)'

	# MAKEOVERRIDES is automatically set and propagated by Make to sub-Make calls.
	# We need to clear it of the init-specific variables. The user-specified
	# variables are explicitly propagated using $(USER_MAKE_VARS).
	main: MAKEOVERRIDES :=

	main: $(INIT_TARGETS)
	ifneq ($(SEQUENTIAL_TARGETS)$(PARALLEL_TARGETS), )
	$(call RotateLogFiles)
	$(PRINTF) "Building $(TARGET_DESCRIPTION)\n" $(BUILD_LOG_PIPE)
	ifneq ($(SEQUENTIAL_TARGETS), )
	# Don't touch build output dir since we might be cleaning. That
	# means no log pipe.
	( cd $(TOPDIR) && \
	$(MAKE) $(MAKE_ARGS) -j 1 -f make/Main.gmk $(USER_MAKE_VARS) \
	$(SEQUENTIAL_TARGETS) )
	endif
	ifneq ($(PARALLEL_TARGETS), )
	$(call PrepareFailureLogs)
	$(call StartGlobalTimer)
	$(call PrepareSmartJavac)
	# JOBS will only be empty for a bootcycle-images recursive call
	# or if specified via a make argument directly. In those cases
	# treat it as NOT using jobs at all.
	( cd $(TOPDIR) && \
	$(NICE) $(MAKE) $(MAKE_ARGS) $(OUTPUT_SYNC_FLAG) \
	$(if $(JOBS), -j $(JOBS)) \
	-f make/Main.gmk $(USER_MAKE_VARS) \
	$(PARALLEL_TARGETS) $(COMPARE_BUILD_MAKE) $(BUILD_LOG_PIPE) \|\| \
	( exitcode=$$? && \
	$(PRINTF) "\nERROR: Build failed for $(TARGET_DESCRIPTION) (exit code $$exitcode) \n" \
	$(BUILD_LOG_PIPE) && \
	cd $(TOPDIR) && $(MAKE) $(MAKE_ARGS) -j 1 -f make/Init.gmk \
	HAS_SPEC=true on-failure ; \
	exit $$exitcode ) )
	$(call CleanupSmartJavac)
	$(call StopGlobalTimer)
	$(call ReportBuildTimes)
	endif
	if test -f $(MAKESUPPORT_OUTPUTDIR)/exit-with-error ; then \
	exit 1 ; \
	fi
	$(PRINTF) "Finished building $(TARGET_DESCRIPTION)\n" $(BUILD_LOG_PIPE)
	$(call ReportProfileTimes)
	endif

	on-failure:
	$(call CleanupSmartJavac)
	$(call StopGlobalTimer)
	$(call ReportBuildTimes)
	$(call PrintFailureReports)
	$(call PrintBuildLogFailures)
	$(call ReportProfileTimes)
	$(PRINTF) "Hint: See doc/building.html#troubleshooting for assistance.\n\n"
	ifneq ($(COMPARE_BUILD), )
	$(call CleanupCompareBuild)
	endif

	# Support targets for COMPARE_BUILD, used for makefile development
	pre-compare-build:
	$(call WaitForSmartJavacFinish)
	$(call PrepareCompareBuild)

	post-compare-build:
	$(call WaitForSmartJavacFinish)
	$(call CleanupCompareBuild)
	$(call CompareBuildDoComparison)

	.PHONY: print-targets print-modules reconfigure main on-failure
	endif