1 #
   2 # Copyright (c) 2011, 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 file contains helper functions for Init.gmk.
  28 # It is divided in two parts, depending on if a SPEC is present or not
  29 # (HAS_SPEC is true or not).
  30 ################################################################################
  31 
  32 ifndef _INITSUPPORT_GMK
  33 _INITSUPPORT_GMK := 1
  34 
  35 ifeq ($(HAS_SPEC),)
  36   ##############################################################################
  37   # Helper functions for the initial part of Init.gmk, before the spec file is
  38   # loaded. Most of these functions provide parsing and setting up make options
  39   # from the command-line.
  40   ##############################################################################
  41 
  42   # Make control variables, handled by Init.gmk
  43   INIT_CONTROL_VARIABLES := LOG CONF CONF_NAME SPEC JOBS TEST_JOBS CONF_CHECK \
  44       COMPARE_BUILD
  45 
  46   # All known make control variables
  47   MAKE_CONTROL_VARIABLES := $(INIT_CONTROL_VARIABLES) TEST JDK_FILTER
  48 
  49   # Define a simple reverse function.
  50   # Should maybe move to MakeBase.gmk, but we can't include that file now.
  51   reverse = \
  52       $(if $(strip $(1)), $(call reverse, $(wordlist 2, $(words $(1)), $(1)))) \
  53           $(firstword $(1))
  54 
  55   # The variable MAKEOVERRIDES contains variable assignments from the command
  56   # line, but in reverse order to what the user entered.
  57   # The '\#' <=> '\ 'dance is needed to keep values with space in them connected.
  58   COMMAND_LINE_VARIABLES := $(subst \#,\ , $(call reverse, $(subst \ ,\#,$(MAKEOVERRIDES))))
  59 
  60   # A list like FOO="val1" BAR="val2" containing all user-supplied make
  61   # variables that we should propagate.
  62   # The '\#' <=> '\ 'dance is needed to keep values with space in them connected.
  63   USER_MAKE_VARS := $(subst \#,\ , $(filter-out $(addsuffix =%, $(INIT_CONTROL_VARIABLES)), \
  64       $(subst \ ,\#,$(MAKEOVERRIDES))))
  65 
  66   # Setup information about available configurations, if any.
  67   build_dir=$(topdir)/build
  68   all_spec_files=$(wildcard $(build_dir)/*/spec.gmk)
  69   # Extract the configuration names from the path
  70   all_confs=$(patsubst %/spec.gmk, %, $(patsubst $(build_dir)/%, %, $(all_spec_files)))
  71 
  72   # Check for unknown command-line variables
  73   define CheckControlVariables
  74     command_line_variables := $$(strip $$(foreach var, \
  75         $$(subst \ ,_,$$(MAKEOVERRIDES)), \
  76         $$(firstword $$(subst =, , $$(var)))))
  77     unknown_command_line_variables := $$(strip \
  78         $$(filter-out $$(MAKE_CONTROL_VARIABLES), $$(command_line_variables)))
  79     ifneq ($$(unknown_command_line_variables), )
  80       $$(info Note: Command line contains non-control variables:)
  81       $$(foreach var, $$(unknown_command_line_variables), $$(info * $$(var)=$$($$(var))))
  82       $$(info Make sure it is not mistyped, and that you intend to override this variable.)
  83       $$(info 'make help' will list known control variables.)
  84       $$(info )
  85     endif
  86   endef
  87 
  88   # Check for deprecated ALT_ variables
  89   define CheckDeprecatedEnvironment
  90     defined_alt_variables := $$(filter ALT_%, $$(.VARIABLES))
  91     ifneq ($$(defined_alt_variables), )
  92       $$(info Warning: You have the following ALT_ variables set:)
  93       $$(foreach var, $$(defined_alt_variables), $$(info * $$(var)=$$($$(var))))
  94       $$(info ALT_ variables are deprecated, and may result in a failed build.)
  95       $$(info Please clean your environment.)
  96       $$(info )
  97     endif
  98   endef
  99 
 100   # Check for invalid make flags like -j
 101   define CheckInvalidMakeFlags
 102     # This is a trick to get this rule to execute before any other rules
 103     # MAKEFLAGS only indicate -j if read in a recipe (!)
 104     $$(topdir)/make/Init.gmk: .FORCE
 105         $$(if $$(findstring --jobserver, $$(MAKEFLAGS)), \
 106             $$(info Error: 'make -jN' is not supported, use 'make JOBS=N') \
 107             $$(error Cannot continue) \
 108         )
 109     .FORCE:
 110     .PHONY: .FORCE
 111   endef
 112 
 113   # Check that the CONF_CHECK option is valid and set up handling
 114   define ParseConfCheckOption
 115     ifeq ($$(CONF_CHECK), )
 116       # Default behavior is fail
 117       CONF_CHECK := fail
 118     else ifneq ($$(filter-out auto fail ignore, $$(CONF_CHECK)),)
 119       $$(info Error: CONF_CHECK must be one of: auto, fail or ignore.)
 120       $$(error Cannot continue)
 121     endif
 122   endef
 123 
 124   # Look for a given option in the LOG variable, and if found, set a variable
 125   # and remove the option from the LOG variable
 126   # $1: The option to look for
 127   # $2: The option to set to "true" if the option is found
 128   define ParseLogOption
 129     ifneq ($$(findstring $1, $$(LOG)),)
 130       $2 := true
 131       # COMMA is defined in spec.gmk, but that is not included yet
 132       COMMA := ,
 133       # First try to remove ",<option>" if it exists, otherwise just remove "<option>"
 134       LOG_STRIPPED := $$(subst $1,, $$(subst $$(COMMA)$(strip $1),, $$(LOG)))
 135       # We might have ended up with a leading comma. Remove it. Need override
 136       # since LOG is set from the command line.
 137       override LOG := $$(strip $$(patsubst $$(COMMA)%, %, $$(LOG_STRIPPED)))
 138     endif
 139   endef
 140 
 141   define ParseLogLevel
 142     # Catch old-style VERBOSE= command lines.
 143     ifneq ($$(origin VERBOSE), undefined)
 144       $$(info Error: VERBOSE is deprecated. Use LOG=<warn|info|debug|trace> instead.)
 145       $$(error Cannot continue)
 146     endif
 147 
 148     # Setup logging according to LOG
 149 
 150     # If the "nofile" argument is given, act on it and strip it away
 151     $$(eval $$(call ParseLogOption, nofile, LOG_NOFILE))
 152 
 153     # If the "cmdline" argument is given, act on it and strip it away
 154     $$(eval $$(call ParseLogOption, cmdlines, LOG_CMDLINES))
 155 
 156     LOG_LEVEL := $$(LOG)
 157 
 158     ifeq ($$(LOG_LEVEL),)
 159       # Set LOG to "warn" as default if not set
 160       LOG_LEVEL := warn
 161     endif
 162 
 163     ifeq ($$(LOG_LEVEL), warn)
 164       MAKE_LOG_FLAGS := -s
 165     else ifeq ($$(LOG_LEVEL), info)
 166       MAKE_LOG_FLAGS := -s
 167     else ifeq ($$(LOG_LEVEL), debug)
 168       MAKE_LOG_FLAGS :=
 169     else ifeq ($$(LOG_LEVEL), trace)
 170       MAKE_LOG_FLAGS :=
 171     else
 172       $$(info Error: LOG contains unknown option or log level: $$(LOG).)
 173       $$(info LOG can be <level>[,<opt>[...]] where <opt> is nofile | cmdlines)
 174       $$(info and <level> is warn | info | debug | trace)
 175       $$(error Cannot continue)
 176     endif
 177   endef
 178 
 179   define ParseConfAndSpec
 180     ifneq ($$(origin SPEC), undefined)
 181       # We have been given a SPEC, check that it works out properly
 182       ifneq ($$(origin CONF), undefined)
 183         # We also have a CONF argument. We can't have both.
 184         $$(info Error: Cannot use CONF=$$(CONF) and SPEC=$$(SPEC) at the same time. Choose one.)
 185         $$(error Cannot continue)
 186       endif
 187       ifneq ($$(origin CONF_NAME), undefined)
 188         # We also have a CONF_NAME argument. We can't have both.
 189         $$(info Error: Cannot use CONF_NAME=$$(CONF_NAME) and SPEC=$$(SPEC) at the same time. Choose one.)
 190         $$(error Cannot continue)
 191       endif
 192       ifeq ($$(wildcard $$(SPEC)),)
 193         $$(info Error: Cannot locate spec.gmk, given by SPEC=$$(SPEC).)
 194         $$(error Cannot continue)
 195       endif
 196       ifeq ($$(filter /%, $$(SPEC)),)
 197         # If given with relative path, make it absolute
 198         SPECS := $$(CURDIR)/$$(strip $$(SPEC))
 199       else
 200         SPECS := $$(SPEC)
 201       endif
 202 
 203       # For now, unset this SPEC variable.
 204       override SPEC :=
 205     else
 206       # Use spec.gmk files in the build output directory
 207       ifeq ($$(all_spec_files),)
 208         $$(info Error: No configurations found for $$(topdir).)
 209         $$(info Please run 'bash configure' to create a configuration.)
 210         $$(info )
 211         $$(error Cannot continue)
 212       endif
 213 
 214       ifneq ($$(origin CONF_NAME), undefined)
 215         ifneq ($$(origin CONF), undefined)
 216           # We also have a CONF argument. We can't have both.
 217           $$(info Error: Cannot use CONF=$$(CONF) and CONF_NAME=$$(CONF_NAME) at the same time. Choose one.)
 218           $$(error Cannot continue)
 219         endif
 220         matching_conf := $$(strip $$(filter $$(CONF_NAME), $$(all_confs)))
 221         ifeq ($$(matching_conf),)
 222           $$(info Error: No configurations found matching CONF_NAME=$$(CONF_NAME).)
 223           $$(info Available configurations in $$(build_dir):)
 224           $$(foreach var, $$(all_confs), $$(info * $$(var)))
 225           $$(error Cannot continue)
 226         else ifneq ($$(words $$(matching_conf)), 1)
 227           $$(info Error: Matching more than one configuration CONF_NAME=$$(CONF_NAME).)
 228           $$(info Available configurations in $$(build_dir):)
 229           $$(foreach var, $$(all_confs), $$(info * $$(var)))
 230           $$(error Cannot continue)
 231         else
 232           $$(info Building configuration '$$(matching_conf)' (matching CONF_NAME=$$(CONF_NAME)))
 233         endif
 234         # Create a SPEC definition. This will contain the path to exactly one spec file.
 235         SPECS := $$(build_dir)/$$(matching_conf)/spec.gmk
 236       else ifneq ($$(origin CONF), undefined)
 237         # User have given a CONF= argument.
 238         ifeq ($$(CONF),)
 239           # If given CONF=, match all configurations
 240           matching_confs := $$(strip $$(all_confs))
 241         else
 242           # Otherwise select those that contain the given CONF string
 243           matching_confs := $$(strip $$(foreach var, $$(all_confs), \
 244               $$(if $$(findstring $$(CONF), $$(var)), $$(var))))
 245         endif
 246         ifeq ($$(matching_confs),)
 247           $$(info Error: No configurations found matching CONF=$$(CONF).)
 248           $$(info Available configurations in $$(build_dir):)
 249           $$(foreach var, $$(all_confs), $$(info * $$(var)))
 250           $$(error Cannot continue)
 251         else
 252           # Don't repeat this output on make restarts caused by including
 253           # generated files.
 254           ifeq ($$(MAKE_RESTARTS),)
 255             ifeq ($$(words $$(matching_confs)), 1)
 256               $$(info Building configuration '$$(matching_confs)' (matching CONF=$$(CONF)))
 257             else
 258               $$(info Building these configurations (matching CONF=$$(CONF)):)
 259               $$(foreach var, $$(matching_confs), $$(info * $$(var)))
 260             endif
 261           endif
 262         endif
 263 
 264         # Create a SPEC definition. This will contain the path to one or more spec.gmk files.
 265         SPECS := $$(addsuffix /spec.gmk, $$(addprefix $$(build_dir)/, $$(matching_confs)))
 266       else
 267         # No CONF or SPEC given, check the available configurations
 268         ifneq ($$(words $$(all_spec_files)), 1)
 269           $$(info Error: No CONF given, but more than one configuration found.)
 270           $$(info Available configurations in $$(build_dir):)
 271           $$(foreach var, $$(all_confs), $$(info * $$(var)))
 272           $$(info Please retry building with CONF=<config pattern> (or SPEC=<spec file>).)
 273           $$(info )
 274           $$(error Cannot continue)
 275         endif
 276 
 277         # We found exactly one configuration, use it
 278         SPECS := $$(strip $$(all_spec_files))
 279       endif
 280     endif
 281   endef
 282 
 283   # Extract main targets from Main.gmk using the spec provided in $2.
 284   #
 285   # Param 1: FORCE = force generation of main-targets.gmk or LAZY = do not force.
 286   # Param 2: The SPEC file to use.
 287   define DefineMainTargets
 288 
 289     # We will start by making sure the main-targets.gmk file is removed, if
 290     # make has not been restarted. By the -include, we will trigger the
 291     # rule for generating the file (which is never there since we removed it),
 292     # thus generating it fresh, and make will restart, incrementing the restart
 293     # count.
 294     main_targets_file := $$(dir $(strip $2))make-support/main-targets.gmk
 295 
 296     ifeq ($$(MAKE_RESTARTS),)
 297       # Only do this if make has not been restarted, and if we do not force it.
 298       ifeq ($(strip $1), FORCE)
 299         $$(shell rm -f $$(main_targets_file))
 300       endif
 301     endif
 302 
 303     $$(main_targets_file):
 304         @( cd $$(topdir) && \
 305         $$(MAKE) $$(MAKE_LOG_FLAGS) -r -R -f $$(topdir)/make/Main.gmk \
 306             -I $$(topdir)/make/common SPEC=$(strip $2) NO_RECIPES=true \
 307             LOG_LEVEL=$$(LOG_LEVEL) \
 308             create-main-targets-include )
 309 
 310     # Now include main-targets.gmk. This will define ALL_MAIN_TARGETS.
 311     -include $$(main_targets_file)
 312   endef
 313 
 314   define PrintConfCheckFailed
 315         @echo ' '
 316         @echo "Please rerun configure! Easiest way to do this is by running"
 317         @echo "'make reconfigure'."
 318         @echo "This behavior may also be changed using CONF_CHECK=<ignore|auto>."
 319         @echo ' '
 320   endef
 321 
 322 else # $(HAS_SPEC)=true
 323   ##############################################################################
 324   # Helper functions for the 'main' target. These functions assume a single,
 325   # proper and existing SPEC is included.
 326   ##############################################################################
 327 
 328   include $(SRC_ROOT)/make/common/MakeBase.gmk
 329 
 330   # Define basic logging setup
 331   BUILD_LOG := $(OUTPUT_ROOT)/build.log
 332   BUILD_TRACE_LOG := $(OUTPUT_ROOT)/build-trace-time.log
 333 
 334   BUILD_LOG_PIPE := > >($(TEE) -a $(BUILD_LOG)) 2> >($(TEE) -a $(BUILD_LOG) >&2)
 335 
 336   # Sanity check the spec file, so it matches this source code
 337   define CheckSpecSanity
 338     ifneq ($$(ACTUAL_TOPDIR), $$(TOPDIR))
 339       ifneq ($$(ACTUAL_TOPDIR), $$(ORIGINAL_TOPDIR))
 340         ifneq ($$(ACTUAL_TOPDIR), $$(CANONICAL_TOPDIR))
 341           $$(info Error: SPEC mismatch! Current working directory)
 342           $$(info $$(ACTUAL_TOPDIR))
 343           $$(info does not match either TOPDIR, ORIGINAL_TOPDIR or CANONICAL_TOPDIR)
 344           $$(info $$(TOPDIR))
 345           $$(info $$(ORIGINAL_TOPDIR))
 346           $$(info $$(CANONICAL_TOPDIR))
 347           $$(error Cannot continue)
 348         endif
 349       endif
 350     endif
 351   endef
 352 
 353   # Parse COMPARE_BUILD into COMPARE_BUILD_*
 354   # Syntax: COMPARE_BUILD=CONF=<configure options>:PATCH=<patch file>:FAIL_BUILD=<bool>
 355   #         MAKE=<make targets>:COMP_OPTS=<compare script options>:
 356   #         COMP_DIR=<compare script base dir>|<default>
 357   #         FAIL=<bool>
 358   # If neither CONF or PATCH is given, assume <default> means CONF if it
 359   # begins with "--", otherwise assume it means PATCH.
 360   # MAKE and COMP_OPTS can only be used with CONF and/or PATCH specified.
 361   # If any value contains "+", it will be replaced by space.
 362   # FAIL can be set to false to have the return value of compare be ignored.
 363   define ParseCompareBuild
 364     ifneq ($$(COMPARE_BUILD), )
 365       COMPARE_BUILD_OUTPUT_ROOT := $(TOPDIR)/build/compare-build/$(CONF_NAME)
 366       COMPARE_BUILD_FAILE := true
 367 
 368       ifneq ($$(findstring :, $$(COMPARE_BUILD)), )
 369         $$(foreach part, $$(subst :, , $$(COMPARE_BUILD)), \
 370           $$(if $$(filter PATCH=%, $$(part)), \
 371             $$(eval COMPARE_BUILD_PATCH=$$(strip $$(patsubst PATCH=%, %, $$(part)))) \
 372           ) \
 373           $$(if $$(filter CONF=%, $$(part)), \
 374             $$(eval COMPARE_BUILD_CONF=$$(strip $$(subst +, , $$(patsubst CONF=%, %, $$(part))))) \
 375           ) \
 376           $$(if $$(filter MAKE=%, $$(part)), \
 377             $$(eval COMPARE_BUILD_MAKE=$$(strip $$(subst +, , $$(patsubst MAKE=%, %, $$(part))))) \
 378           ) \
 379           $$(if $$(filter COMP_OPTS=%, $$(part)), \
 380             $$(eval COMPARE_BUILD_COMP_OPTS=$$(strip $$(subst +, , $$(patsubst COMP_OPTS=%, %, $$(part))))) \
 381           ) \
 382           $$(if $$(filter COMP_DIR=%, $$(part)), \
 383             $$(eval COMPARE_BUILD_COMP_DIR=$$(strip $$(subst +, , $$(patsubst COMP_DIR=%, %, $$(part))))) \
 384           ) \
 385           $$(if $$(filter FAIL=%, $$(part)), \
 386             $$(eval COMPARE_BUILD_FAIL=$$(strip $$(subst +, , $$(patsubst FAIL=%, %, $$(part))))) \
 387           ) \
 388         )
 389       else
 390         # Separate handling for single field case, to allow for spaces in values.
 391         ifneq ($$(filter PATCH=%, $$(COMPARE_BUILD)), )
 392           COMPARE_BUILD_PATCH=$$(strip $$(patsubst PATCH=%, %, $$(COMPARE_BUILD)))
 393         else ifneq ($$(filter CONF=%, $$(COMPARE_BUILD)), )
 394           COMPARE_BUILD_CONF=$$(strip $$(subst +, , $$(patsubst CONF=%, %, $$(COMPARE_BUILD))))
 395         else ifneq ($$(filter --%, $$(COMPARE_BUILD)), )
 396           # Assume CONF if value begins with --
 397           COMPARE_BUILD_CONF=$$(strip $$(subst +, , $$(COMPARE_BUILD)))
 398         else
 399           # Otherwise assume patch file
 400           COMPARE_BUILD_PATCH=$$(strip $$(COMPARE_BUILD))
 401         endif
 402       endif
 403       ifneq ($$(COMPARE_BUILD_PATCH), )
 404         ifneq ($$(wildcard $$(TOPDIR)/$$(COMPARE_BUILD_PATCH)), )
 405           # Assume relative path, if file exists
 406           COMPARE_BUILD_PATCH := $$(wildcard $$(TOPDIR)/$$(COMPARE_BUILD_PATCH))
 407         else ifeq ($$(wildcard $$(COMPARE_BUILD_PATCH)), )
 408           $$(error Patch file $$(COMPARE_BUILD_PATCH) does not exist)
 409         endif
 410       endif
 411       ifneq ($$(COMPARE_BUILD_FAIL), true)
 412         COMPARE_BUILD_IGNORE_RESULT := || true
 413       endif
 414     endif
 415   endef
 416 
 417   # Prepare for a comparison rebuild
 418   define PrepareCompareBuild
 419         $(ECHO) "Preparing for comparison rebuild"
 420         # Apply patch, if any
 421         $(if $(COMPARE_BUILD_PATCH), $(PATCH) -p1 < $(COMPARE_BUILD_PATCH))
 422         # Move the first build away temporarily
 423         $(RM) -r $(TOPDIR)/build/.compare-build-temp
 424         $(MKDIR) -p $(TOPDIR)/build/.compare-build-temp
 425         $(MV) $(OUTPUT_ROOT) $(TOPDIR)/build/.compare-build-temp
 426         # Restore an old compare-build, or create a new compare-build directory.
 427         if test -d $(COMPARE_BUILD_OUTPUT_ROOT); then \
 428           $(MV) $(COMPARE_BUILD_OUTPUT_ROOT) $(OUTPUT_ROOT); \
 429         else \
 430           $(MKDIR) -p $(OUTPUT_ROOT); \
 431         fi
 432         # Re-run configure with the same arguments (and possibly some additional),
 433         # must be done after patching.
 434         ( cd $(OUTPUT_ROOT) && PATH="$(ORIGINAL_PATH)" \
 435             $(BASH) $(TOPDIR)/configure $(CONFIGURE_COMMAND_LINE) $(COMPARE_BUILD_CONF))
 436   endef
 437 
 438   # Cleanup after a compare build
 439   define CleanupCompareBuild
 440         # If running with a COMPARE_BUILD patch, reverse-apply it
 441         $(if $(COMPARE_BUILD_PATCH), $(PATCH) -R -p1 < $(COMPARE_BUILD_PATCH))
 442         # Move this build away and restore the original build
 443         $(MKDIR) -p $(TOPDIR)/build/compare-build
 444         $(MV) $(OUTPUT_ROOT) $(COMPARE_BUILD_OUTPUT_ROOT)
 445         $(MV) $(TOPDIR)/build/.compare-build-temp/$(CONF_NAME) $(OUTPUT_ROOT)
 446         $(RM) -r $(TOPDIR)/build/.compare-build-temp
 447   endef
 448 
 449   # Do the actual comparison of two builds
 450   define CompareBuildDoComparison
 451         # Compare first and second build. Ignore any error code from compare.sh.
 452         $(ECHO) "Comparing between comparison rebuild (this/new) and baseline (other/old)"
 453         $(if $(COMPARE_BUILD_COMP_DIR), \
 454           +(cd $(COMPARE_BUILD_OUTPUT_ROOT) && ./compare.sh $(COMPARE_BUILD_COMP_OPTS) \
 455               -2dirs $(COMPARE_BUILD_OUTPUT_ROOT)/$(COMPARE_BUILD_COMP_DIR) \
 456               $(OUTPUT_ROOT)/$(COMPARE_BUILD_COMP_DIR) $(COMPARE_BUILD_IGNORE_RESULT)), \
 457           +(cd $(COMPARE_BUILD_OUTPUT_ROOT) && ./compare.sh $(COMPARE_BUILD_COMP_OPTS) \
 458               -o $(OUTPUT_ROOT) $(COMPARE_BUILD_IGNORE_RESULT)) \
 459         )
 460   endef
 461 
 462   define PrintFailureReports
 463         $(if $(wildcard $(MAKESUPPORT_OUTPUTDIR)/failure-logs/*), \
 464           $(PRINTF) "=== Output from failing command(s) repeated here ===\n" $(NEWLINE) \
 465           $(foreach logfile, $(sort $(wildcard $(MAKESUPPORT_OUTPUTDIR)/failure-logs/*)), \
 466               $(PRINTF) "* For target $(notdir $(basename $(logfile))):\n" $(NEWLINE) \
 467               ($(GREP) -v -e "^Note: including file:" <  $(logfile) || true) | $(HEAD) -n 12 $(NEWLINE) \
 468               if test `$(WC) -l < $(logfile)` -gt 12; then \
 469                 $(ECHO) "   ... (rest of output omitted)" ; \
 470               fi $(NEWLINE) \
 471           ) \
 472           $(PRINTF) "=== End of repeated output ===\n" \
 473         )
 474   endef
 475 
 476   define PrintBuildLogFailures
 477         if $(GREP) -q "recipe for target .* failed" $(BUILD_LOG) 2> /dev/null; then  \
 478           $(PRINTF) "=== Make failure sequence repeated here ===\n" ; \
 479           $(GREP) "recipe for target .* failed" $(BUILD_LOG) ; \
 480           $(PRINTF) "=== End of repeated output ===\n" ; \
 481           $(PRINTF) "Hint: Try searching the build log for the name of the first failed target.\n" ; \
 482         else \
 483           $(PRINTF) "No indication of failed target found.\n" ; \
 484           $(PRINTF) "Hint: Try searching the build log for '] Error'.\n" ; \
 485         fi
 486   endef
 487 
 488   define RotateLogFiles
 489         $(RM) $(BUILD_LOG).old 2> /dev/null && \
 490         $(MV) $(BUILD_LOG) $(BUILD_LOG).old 2> /dev/null || true
 491         $(if $(findstring trace, $(LOG_LEVEL)), \
 492           $(RM) $(BUILD_TRACE_LOG).old 2> /dev/null && \
 493           $(MV) $(BUILD_TRACE_LOG) $(BUILD_TRACE_LOG).old 2> /dev/null || true \
 494         )
 495   endef
 496 
 497   define PrepareFailureLogs
 498         $(RM) -r $(MAKESUPPORT_OUTPUTDIR)/failure-logs 2> /dev/null && \
 499         $(MKDIR) -p $(MAKESUPPORT_OUTPUTDIR)/failure-logs
 500   endef
 501 
 502   # Remove any javac server logs and port files. This
 503   # prevents a new make run to reuse the previous servers.
 504   define PrepareSmartJavac
 505         $(if $(SJAVAC_SERVER_DIR), \
 506           $(RM) -r $(SJAVAC_SERVER_DIR) 2> /dev/null && \
 507           $(MKDIR) -p $(SJAVAC_SERVER_DIR) \
 508         )
 509   endef
 510 
 511   define CleanupSmartJavac
 512         [ -f $(SJAVAC_SERVER_DIR)/server.port ] && $(ECHO) Stopping sjavac server && \
 513             $(TOUCH) $(SJAVAC_SERVER_DIR)/server.port.stop; true
 514   endef
 515 
 516   ifeq ($(OPENJDK_BUILD_OS), windows)
 517     # On windows we need to synchronize with the javac server to be able to
 518     # move or remove the build output directory. Since we have no proper
 519     # synchronization process, wait for a while and hope it helps. This is only
 520     # used by build comparisons.
 521     define WaitForSmartJavacFinish
 522         $(if $(SJAVAC_SERVER_DIR), \
 523           sleep 5\
 524         )
 525     endef
 526   else
 527     define WaitForSmartJavacFinish
 528     endef
 529   endif
 530 
 531   define StartGlobalTimer
 532         $(RM) -r $(BUILDTIMESDIR) 2> /dev/null && \
 533         $(MKDIR) -p $(BUILDTIMESDIR) && \
 534         $(call RecordStartTime,TOTAL)
 535   endef
 536 
 537   define StopGlobalTimer
 538         $(call RecordEndTime,TOTAL)
 539   endef
 540 
 541   # Find all build_time_* files and print their contents in a list sorted
 542   # on the name of the sub repository.
 543   define ReportBuildTimes
 544         $(PRINTF) $(LOG_INFO) -- \
 545             "----- Build times -------\nStart %s\nEnd   %s\n%s\n%s\n-------------------------\n" \
 546             "`$(CAT) $(BUILDTIMESDIR)/build_time_start_TOTAL_human_readable`" \
 547             "`$(CAT) $(BUILDTIMESDIR)/build_time_end_TOTAL_human_readable`" \
 548             "`$(LS) $(BUILDTIMESDIR)/build_time_diff_* | $(GREP) -v _TOTAL | \
 549             $(XARGS) $(CAT) | $(SORT) -k 2`" \
 550             "`$(CAT) $(BUILDTIMESDIR)/build_time_diff_TOTAL`" \
 551             $(BUILD_LOG_PIPE)
 552   endef
 553 
 554 endif # HAS_SPEC
 555 
 556 endif # _INITSUPPORT_GMK