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   define ParseLogLevel
 125     # Catch old-style VERBOSE= command lines.
 126     ifneq ($$(origin VERBOSE), undefined)
 127       $$(info Error: VERBOSE is deprecated. Use LOG=<warn|info|debug|trace> instead.)
 128       $$(error Cannot continue)
 129     endif
 130 
 131     # Setup logging according to LOG
 132 
 133     # If the "nofile" argument is given, act on it and strip it away
 134     ifneq ($$(findstring nofile, $$(LOG)),)
 135       LOG_NOFILE := true
 136       # COMMA is defined in spec.gmk, but that is not included yet
 137       COMMA := ,
 138       # First try to remove ",nofile" if it exists, otherwise just remove "nofile"
 139       LOG_STRIPPED := $$(subst nofile,, $$(subst $$(COMMA)nofile,, $$(LOG)))
 140       # We might have ended up with a leading comma. Remove it
 141       LOG_LEVEL := $$(strip $$(patsubst $$(COMMA)%, %, $$(LOG_STRIPPED)))
 142     else
 143       LOG_LEVEL := $$(LOG)
 144     endif
 145 
 146     ifeq ($$(LOG_LEVEL),)
 147       # Set LOG to "warn" as default if not set
 148       LOG_LEVEL := warn
 149     endif
 150 
 151     ifeq ($$(LOG_LEVEL), warn)
 152       MAKE_LOG_FLAGS := -s
 153     else ifeq ($$(LOG_LEVEL), info)
 154       MAKE_LOG_FLAGS := -s
 155     else ifeq ($$(LOG_LEVEL), debug)
 156       MAKE_LOG_FLAGS :=
 157     else ifeq ($$(LOG_LEVEL), trace)
 158       MAKE_LOG_FLAGS :=
 159     else
 160       $$(info Error: LOG must be one of: warn, info, debug or trace.)
 161       $$(error Cannot continue)
 162     endif
 163   endef
 164 
 165   define ParseConfAndSpec
 166     ifneq ($$(origin SPEC), undefined)
 167       # We have been given a SPEC, check that it works out properly
 168       ifneq ($$(origin CONF), undefined)
 169         # We also have a CONF argument. We can't have both.
 170         $$(info Error: Cannot use CONF=$$(CONF) and SPEC=$$(SPEC) at the same time. Choose one.)
 171         $$(error Cannot continue)
 172       endif
 173       ifneq ($$(origin CONF_NAME), undefined)
 174         # We also have a CONF_NAME argument. We can't have both.
 175         $$(info Error: Cannot use CONF_NAME=$$(CONF_NAME) and SPEC=$$(SPEC) at the same time. Choose one.)
 176         $$(error Cannot continue)
 177       endif
 178       ifeq ($$(wildcard $$(SPEC)),)
 179         $$(info Error: Cannot locate spec.gmk, given by SPEC=$$(SPEC).)
 180         $$(error Cannot continue)
 181       endif
 182       ifeq ($$(filter /%, $$(SPEC)),)
 183         # If given with relative path, make it absolute
 184         SPECS := $$(CURDIR)/$$(strip $$(SPEC))
 185       else
 186         SPECS := $$(SPEC)
 187       endif
 188 
 189       # For now, unset this SPEC variable.
 190       override SPEC :=
 191     else
 192       # Use spec.gmk files in the build output directory
 193       ifeq ($$(all_spec_files),)
 194         $$(info Error: No configurations found for $$(topdir).)
 195         $$(info Please run 'bash configure' to create a configuration.)
 196         $$(info )
 197         $$(error Cannot continue)
 198       endif
 199 
 200       ifneq ($$(origin CONF_NAME), undefined)
 201         ifneq ($$(origin CONF), undefined)
 202           # We also have a CONF argument. We can't have both.
 203           $$(info Error: Cannot use CONF=$$(CONF) and CONF_NAME=$$(CONF_NAME) at the same time. Choose one.)
 204           $$(error Cannot continue)
 205         endif
 206         matching_conf := $$(strip $$(filter $$(CONF_NAME), $$(all_confs)))
 207         ifeq ($$(matching_conf),)
 208           $$(info Error: No configurations found matching CONF_NAME=$$(CONF_NAME).)
 209           $$(info Available configurations in $$(build_dir):)
 210           $$(foreach var, $$(all_confs), $$(info * $$(var)))
 211           $$(error Cannot continue)
 212         else ifneq ($$(words $$(matching_conf)), 1)
 213           $$(info Error: Matching more than one configuration CONF_NAME=$$(CONF_NAME).)
 214           $$(info Available configurations in $$(build_dir):)
 215           $$(foreach var, $$(all_confs), $$(info * $$(var)))
 216           $$(error Cannot continue)
 217         else
 218           $$(info Building configuration '$$(matching_conf)' (matching CONF_NAME=$$(CONF_NAME)))
 219         endif
 220         # Create a SPEC definition. This will contain the path to exactly one spec file.
 221         SPECS := $$(build_dir)/$$(matching_conf)/spec.gmk
 222       else ifneq ($$(origin CONF), undefined)
 223         # User have given a CONF= argument.
 224         ifeq ($$(CONF),)
 225           # If given CONF=, match all configurations
 226           matching_confs := $$(strip $$(all_confs))
 227         else
 228           # Otherwise select those that contain the given CONF string
 229           matching_confs := $$(strip $$(foreach var, $$(all_confs), \
 230               $$(if $$(findstring $$(CONF), $$(var)), $$(var))))
 231         endif
 232         ifeq ($$(matching_confs),)
 233           $$(info Error: No configurations found matching CONF=$$(CONF).)
 234           $$(info Available configurations in $$(build_dir):)
 235           $$(foreach var, $$(all_confs), $$(info * $$(var)))
 236           $$(error Cannot continue)
 237         else
 238           # Don't repeat this output on make restarts caused by including
 239           # generated files.
 240           ifeq ($$(MAKE_RESTARTS),)
 241             ifeq ($$(words $$(matching_confs)), 1)
 242               $$(info Building configuration '$$(matching_confs)' (matching CONF=$$(CONF)))
 243             else
 244               $$(info Building these configurations (matching CONF=$$(CONF)):)
 245               $$(foreach var, $$(matching_confs), $$(info * $$(var)))
 246             endif
 247           endif
 248         endif
 249 
 250         # Create a SPEC definition. This will contain the path to one or more spec.gmk files.
 251         SPECS := $$(addsuffix /spec.gmk, $$(addprefix $$(build_dir)/, $$(matching_confs)))
 252       else
 253         # No CONF or SPEC given, check the available configurations
 254         ifneq ($$(words $$(all_spec_files)), 1)
 255           $$(info Error: No CONF given, but more than one configuration found.)
 256           $$(info Available configurations in $$(build_dir):)
 257           $$(foreach var, $$(all_confs), $$(info * $$(var)))
 258           $$(info Please retry building with CONF=<config pattern> (or SPEC=<spec file>).)
 259           $$(info )
 260           $$(error Cannot continue)
 261         endif
 262 
 263         # We found exactly one configuration, use it
 264         SPECS := $$(strip $$(all_spec_files))
 265       endif
 266     endif
 267   endef
 268 
 269   # Extract main targets from Main.gmk using the spec provided in $2.
 270   #
 271   # Param 1: FORCE = force generation of main-targets.gmk or LAZY = do not force.
 272   # Param 2: The SPEC file to use.
 273   define DefineMainTargets
 274 
 275     # We will start by making sure the main-targets.gmk file is removed, if
 276     # make has not been restarted. By the -include, we will trigger the
 277     # rule for generating the file (which is never there since we removed it),
 278     # thus generating it fresh, and make will restart, incrementing the restart
 279     # count.
 280     main_targets_file := $$(dir $(strip $2))make-support/main-targets.gmk
 281 
 282     ifeq ($$(MAKE_RESTARTS),)
 283       # Only do this if make has not been restarted, and if we do not force it.
 284       ifeq ($(strip $1), FORCE)
 285         $$(shell rm -f $$(main_targets_file))
 286       endif
 287     endif
 288 
 289     $$(main_targets_file):
 290         @( cd $$(topdir) && \
 291         $$(MAKE) $$(MAKE_LOG_FLAGS) -r -R -f $$(topdir)/make/Main.gmk \
 292             -I $$(topdir)/make/common SPEC=$(strip $2) NO_RECIPES=true \
 293             LOG_LEVEL=$$(LOG_LEVEL) \
 294             create-main-targets-include )
 295 
 296     # Now include main-targets.gmk. This will define ALL_MAIN_TARGETS.
 297     -include $$(main_targets_file)
 298   endef
 299 
 300   define PrintConfCheckFailed
 301         @echo ' '
 302         @echo "Please rerun configure! Easiest way to do this is by running"
 303         @echo "'make reconfigure'."
 304         @echo "This behavior may also be changed using CONF_CHECK=<ignore|auto>."
 305         @echo ' '
 306   endef
 307 
 308 else # $(HAS_SPEC)=true
 309   ##############################################################################
 310   # Helper functions for the 'main' target. These functions assume a single,
 311   # proper and existing SPEC is included.
 312   ##############################################################################
 313 
 314   include $(SRC_ROOT)/make/common/MakeBase.gmk
 315 
 316   # Define basic logging setup
 317   BUILD_LOG := $(OUTPUT_ROOT)/build.log
 318   BUILD_TRACE_LOG := $(OUTPUT_ROOT)/build-trace-time.log
 319 
 320   BUILD_LOG_PIPE := > >($(TEE) -a $(BUILD_LOG)) 2> >($(TEE) -a $(BUILD_LOG) >&2)
 321 
 322   # Sanity check the spec file, so it matches this source code
 323   define CheckSpecSanity
 324     ifneq ($$(ACTUAL_TOPDIR), $$(TOPDIR))
 325       ifneq ($$(ACTUAL_TOPDIR), $$(ORIGINAL_TOPDIR))
 326         ifneq ($$(ACTUAL_TOPDIR), $$(CANONICAL_TOPDIR))
 327           $$(info Error: SPEC mismatch! Current working directory)
 328           $$(info $$(ACTUAL_TOPDIR))
 329           $$(info does not match either TOPDIR, ORIGINAL_TOPDIR or CANONICAL_TOPDIR)
 330           $$(info $$(TOPDIR))
 331           $$(info $$(ORIGINAL_TOPDIR))
 332           $$(info $$(CANONICAL_TOPDIR))
 333           $$(error Cannot continue)
 334         endif
 335       endif
 336     endif
 337   endef
 338 
 339   # Parse COMPARE_BUILD into COMPARE_BUILD_*
 340   # Syntax: COMPARE_BUILD=CONF=<configure options>:PATCH=<patch file>:
 341   #         MAKE=<make targets>:COMP_OPTS=<compare script options>:
 342   #         COMP_DIR=<compare script base dir>|<default>
 343   # If neither CONF or PATCH is given, assume <default> means CONF if it
 344   # begins with "--", otherwise assume it means PATCH.
 345   # MAKE and COMP_OPTS can only be used with CONF and/or PATCH specified.
 346   # If any value contains "+", it will be replaced by space.
 347   define ParseCompareBuild
 348     ifneq ($$(COMPARE_BUILD), )
 349       COMPARE_BUILD_OUTPUT_ROOT := $(TOPDIR)/build/compare-build/$(CONF_NAME)
 350 
 351       ifneq ($$(findstring :, $$(COMPARE_BUILD)), )
 352         $$(foreach part, $$(subst :, , $$(COMPARE_BUILD)), \
 353           $$(if $$(filter PATCH=%, $$(part)), \
 354             $$(eval COMPARE_BUILD_PATCH=$$(strip $$(patsubst PATCH=%, %, $$(part)))) \
 355           ) \
 356           $$(if $$(filter CONF=%, $$(part)), \
 357             $$(eval COMPARE_BUILD_CONF=$$(strip $$(subst +, , $$(patsubst CONF=%, %, $$(part))))) \
 358           ) \
 359           $$(if $$(filter MAKE=%, $$(part)), \
 360             $$(eval COMPARE_BUILD_MAKE=$$(strip $$(subst +, , $$(patsubst MAKE=%, %, $$(part))))) \
 361           ) \
 362           $$(if $$(filter COMP_OPTS=%, $$(part)), \
 363             $$(eval COMPARE_BUILD_COMP_OPTS=$$(strip $$(subst +, , $$(patsubst COMP_OPTS=%, %, $$(part))))) \
 364           ) \
 365           $$(if $$(filter COMP_DIR=%, $$(part)), \
 366             $$(eval COMPARE_BUILD_COMP_DIR=$$(strip $$(subst +, , $$(patsubst COMP_DIR=%, %, $$(part))))) \
 367           ) \
 368         )
 369       else
 370         # Separate handling for single field case, to allow for spaces in values.
 371         ifneq ($$(filter PATCH=%, $$(COMPARE_BUILD)), )
 372           COMPARE_BUILD_PATCH=$$(strip $$(patsubst PATCH=%, %, $$(COMPARE_BUILD)))
 373         else ifneq ($$(filter CONF=%, $$(COMPARE_BUILD)), )
 374           COMPARE_BUILD_CONF=$$(strip $$(subst +, , $$(patsubst CONF=%, %, $$(COMPARE_BUILD))))
 375         else ifneq ($$(filter --%, $$(COMPARE_BUILD)), )
 376           # Assume CONF if value begins with --
 377           COMPARE_BUILD_CONF=$$(strip $$(subst +, , $$(COMPARE_BUILD)))
 378         else
 379           # Otherwise assume patch file
 380           COMPARE_BUILD_PATCH=$$(strip $$(COMPARE_BUILD))
 381         endif
 382       endif
 383       ifneq ($$(COMPARE_BUILD_PATCH), )
 384         ifneq ($$(wildcard $$(TOPDIR)/$$(COMPARE_BUILD_PATCH)), )
 385           # Assume relative path, if file exists
 386           COMPARE_BUILD_PATCH := $$(wildcard $$(TOPDIR)/$$(COMPARE_BUILD_PATCH))
 387         else ifeq ($$(wildcard $$(COMPARE_BUILD_PATCH)), )
 388           $$(error Patch file $$(COMPARE_BUILD_PATCH) does not exist)
 389         endif
 390       endif
 391     endif
 392   endef
 393 
 394   # Prepare for a comparison rebuild
 395   define PrepareCompareBuild
 396         $(ECHO) "Preparing for comparison rebuild"
 397         # Apply patch, if any
 398         $(if $(COMPARE_BUILD_PATCH), $(PATCH) -p1 < $(COMPARE_BUILD_PATCH))
 399         # Move the first build away temporarily
 400         $(RM) -r $(TOPDIR)/build/.compare-build-temp
 401         $(MKDIR) -p $(TOPDIR)/build/.compare-build-temp
 402         $(MV) $(OUTPUT_ROOT) $(TOPDIR)/build/.compare-build-temp
 403         # Restore an old compare-build, or create a new compare-build directory.
 404         if test -d $(COMPARE_BUILD_OUTPUT_ROOT); then \
 405           $(MV) $(COMPARE_BUILD_OUTPUT_ROOT) $(OUTPUT_ROOT); \
 406         else \
 407           $(MKDIR) -p $(OUTPUT_ROOT); \
 408         fi
 409         # Re-run configure with the same arguments (and possibly some additional),
 410         # must be done after patching.
 411         ( cd $(OUTPUT_ROOT) && PATH="$(ORIGINAL_PATH)" \
 412             $(BASH) $(TOPDIR)/configure $(CONFIGURE_COMMAND_LINE) $(COMPARE_BUILD_CONF))
 413   endef
 414 
 415   # Cleanup after a compare build
 416   define CleanupCompareBuild
 417         # If running with a COMPARE_BUILD patch, reverse-apply it
 418         $(if $(COMPARE_BUILD_PATCH), $(PATCH) -R -p1 < $(COMPARE_BUILD_PATCH))
 419         # Move this build away and restore the original build
 420         $(MKDIR) -p $(TOPDIR)/build/compare-build
 421         $(MV) $(OUTPUT_ROOT) $(COMPARE_BUILD_OUTPUT_ROOT)
 422         $(MV) $(TOPDIR)/build/.compare-build-temp/$(CONF_NAME) $(OUTPUT_ROOT)
 423         $(RM) -r $(TOPDIR)/build/.compare-build-temp
 424   endef
 425 
 426   # Do the actual comparison of two builds
 427   define CompareBuildDoComparison
 428         # Compare first and second build. Ignore any error code from compare.sh.
 429         $(ECHO) "Comparing between comparison rebuild (this/new) and baseline (other/old)"
 430         $(if $(COMPARE_BUILD_COMP_DIR), \
 431           +(cd $(COMPARE_BUILD_OUTPUT_ROOT) && ./compare.sh $(COMPARE_BUILD_COMP_OPTS) \
 432               -2dirs $(COMPARE_BUILD_OUTPUT_ROOT)/$(COMPARE_BUILD_COMP_DIR) $(OUTPUT_ROOT)/$(COMPARE_BUILD_COMP_DIR) || true), \
 433           +(cd $(COMPARE_BUILD_OUTPUT_ROOT) && ./compare.sh $(COMPARE_BUILD_COMP_OPTS) \
 434               -o $(OUTPUT_ROOT) || true) \
 435         )
 436   endef
 437 
 438   define PrintFailureReports
 439         $(if $(wildcard $(MAKESUPPORT_OUTPUTDIR)/failure-logs/*), \
 440           $(PRINTF) "=== Output from failing command(s) repeated here ===\n" $(NEWLINE) \
 441           $(foreach logfile, $(sort $(wildcard $(MAKESUPPORT_OUTPUTDIR)/failure-logs/*)), \
 442               $(PRINTF) "* For target $(notdir $(basename $(logfile))):\n" $(NEWLINE) \
 443               ($(GREP) -v -e "^Note: including file:" <  $(logfile) || true) | $(HEAD) -n 12 $(NEWLINE) \
 444               if test `$(WC) -l < $(logfile)` -gt 12; then \
 445                 $(ECHO) "   ... (rest of output omitted)" ; \
 446               fi $(NEWLINE) \
 447           ) \
 448           $(PRINTF) "=== End of repeated output ===\n" \
 449         )
 450   endef
 451 
 452   define PrintBuildLogFailures
 453         if $(GREP) -q "recipe for target .* failed" $(BUILD_LOG) 2> /dev/null; then  \
 454           $(PRINTF) "=== Make failure sequence repeated here ===\n" ; \
 455           $(GREP) "recipe for target .* failed" $(BUILD_LOG) ; \
 456           $(PRINTF) "=== End of repeated output ===\n" ; \
 457           $(PRINTF) "Hint: Try searching the build log for the name of the first failed target.\n" ; \
 458         else \
 459           $(PRINTF) "No indication of failed target found.\n" ; \
 460           $(PRINTF) "Hint: Try searching the build log for '] Error'.\n" ; \
 461         fi
 462   endef
 463 
 464   define RotateLogFiles
 465         $(RM) $(BUILD_LOG).old 2> /dev/null && \
 466         $(MV) $(BUILD_LOG) $(BUILD_LOG).old 2> /dev/null || true
 467         $(if $(findstring trace, $(LOG_LEVEL)), \
 468           $(RM) $(BUILD_TRACE_LOG).old 2> /dev/null && \
 469           $(MV) $(BUILD_TRACE_LOG) $(BUILD_TRACE_LOG).old 2> /dev/null || true \
 470         )
 471   endef
 472 
 473   define PrepareFailureLogs
 474         $(RM) -r $(MAKESUPPORT_OUTPUTDIR)/failure-logs 2> /dev/null && \
 475         $(MKDIR) -p $(MAKESUPPORT_OUTPUTDIR)/failure-logs
 476   endef
 477 
 478   # Remove any javac server logs and port files. This
 479   # prevents a new make run to reuse the previous servers.
 480   define PrepareSmartJavac
 481         $(if $(SJAVAC_SERVER_DIR), \
 482           $(RM) -r $(SJAVAC_SERVER_DIR) 2> /dev/null && \
 483           $(MKDIR) -p $(SJAVAC_SERVER_DIR) \
 484         )
 485   endef
 486 
 487   define CleanupSmartJavac
 488         [ -f $(SJAVAC_SERVER_DIR)/server.port ] && $(ECHO) Stopping sjavac server && \
 489             $(TOUCH) $(SJAVAC_SERVER_DIR)/server.port.stop; true
 490   endef
 491 
 492   ifeq ($(OPENJDK_BUILD_OS), windows)
 493     # On windows we need to synchronize with the javac server to be able to
 494     # move or remove the build output directory. Since we have no proper
 495     # synchronization process, wait for a while and hope it helps. This is only
 496     # used by build comparisons.
 497     define WaitForSmartJavacFinish
 498         $(if $(SJAVAC_SERVER_DIR), \
 499           sleep 5\
 500         )
 501     endef
 502   else
 503     define WaitForSmartJavacFinish
 504     endef
 505   endif
 506 
 507   define StartGlobalTimer
 508         $(RM) -r $(BUILDTIMESDIR) 2> /dev/null && \
 509         $(MKDIR) -p $(BUILDTIMESDIR) && \
 510         $(call RecordStartTime,TOTAL)
 511   endef
 512 
 513   define StopGlobalTimer
 514         $(call RecordEndTime,TOTAL)
 515   endef
 516 
 517   # Find all build_time_* files and print their contents in a list sorted
 518   # on the name of the sub repository.
 519   define ReportBuildTimes
 520         $(PRINTF) $(LOG_INFO) -- \
 521             "----- Build times -------\nStart %s\nEnd   %s\n%s\n%s\n-------------------------\n" \
 522             "`$(CAT) $(BUILDTIMESDIR)/build_time_start_TOTAL_human_readable`" \
 523             "`$(CAT) $(BUILDTIMESDIR)/build_time_end_TOTAL_human_readable`" \
 524             "`$(LS) $(BUILDTIMESDIR)/build_time_diff_* | $(GREP) -v _TOTAL | \
 525             $(XARGS) $(CAT) | $(SORT) -k 2`" \
 526             "`$(CAT) $(BUILDTIMESDIR)/build_time_diff_TOTAL`" \
 527             $(BUILD_LOG_PIPE)
 528   endef
 529 
 530 endif # HAS_SPEC
 531 
 532 endif # _INITSUPPORT_GMK