InitSupport.gmk revision 1862:5f3d162d11fc
168723Sru#
268723Sru# Copyright (c) 2011, 2015, Oracle and/or its affiliates. All rights reserved.
368723Sru# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
468723Sru#
568723Sru# This code is free software; you can redistribute it and/or modify it
668723Sru# under the terms of the GNU General Public License version 2 only, as
768723Sru# published by the Free Software Foundation.  Oracle designates this
868723Sru# particular file as subject to the "Classpath" exception as provided
968723Sru# by Oracle in the LICENSE file that accompanied this code.
1068723Sru#
1168723Sru# This code is distributed in the hope that it will be useful, but WITHOUT
1268723Sru# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
1368723Sru# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
1468723Sru# version 2 for more details (a copy is included in the LICENSE file that
1568723Sru# accompanied this code).
1668723Sru#
1768723Sru# You should have received a copy of the GNU General Public License version
1868723Sru# 2 along with this work; if not, write to the Free Software Foundation,
1968723Sru# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
2068723Sru#
2168723Sru# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2268723Sru# or visit www.oracle.com if you need additional information or have any
2368723Sru# questions.
2468723Sru#
2568723Sru
2668723Sru################################################################################
2768723Sru# This file contains helper functions for Init.gmk.
2868723Sru# It is divided in two parts, depending on if a SPEC is present or not
2968723Sru# (HAS_SPEC is true or not).
3068723Sru################################################################################
3168723Sru
3268723Sruifndef _INITSUPPORT_GMK
3368723Sru_INITSUPPORT_GMK := 1
3468723Sru
3568723Sruifeq ($(HAS_SPEC),)
3668723Sru  ##############################################################################
3768723Sru  # Helper functions for the initial part of Init.gmk, before the spec file is
3868723Sru  # loaded. Most of these functions provide parsing and setting up make options
3968723Sru  # from the command-line.
4068723Sru  ##############################################################################
4178719Sdd
42206471Sed  # Make control variables, handled by Init.gmk
4368723Sru  INIT_CONTROL_VARIABLES := LOG CONF CONF_NAME SPEC JOBS TEST_JOBS CONF_CHECK \
4468723Sru      COMPARE_BUILD
45202205Sed
4668723Sru  # All known make control variables
4799800Salfred  MAKE_CONTROL_VARIABLES := $(INIT_CONTROL_VARIABLES) TEST JDK_FILTER
48202205Sed
4999800Salfred  # Define a simple reverse function.
50222767Sed  # Should maybe move to MakeBase.gmk, but we can't include that file now.
5168723Sru  reverse = \
52222767Sed      $(if $(strip $(1)), $(call reverse, $(wordlist 2, $(words $(1)), $(1)))) \
53222767Sed          $(firstword $(1))
54222767Sed
55222767Sed  # The variable MAKEOVERRIDES contains variable assignments from the command
56206471Sed  # line, but in reverse order to what the user entered.
57222767Sed  # The '\#' <=> '\ 'dance is needed to keep values with space in them connected.
58206471Sed  COMMAND_LINE_VARIABLES := $(subst \#,\ , $(call reverse, $(subst \ ,\#,$(MAKEOVERRIDES))))
59206471Sed
60222767Sed  # A list like FOO="val1" BAR="val2" containing all user-supplied make
61206471Sed  # variables that we should propagate.
62206471Sed  # The '\#' <=> '\ 'dance is needed to keep values with space in them connected.
63206471Sed  USER_MAKE_VARS := $(subst \#,\ , $(filter-out $(addsuffix =%, $(INIT_CONTROL_VARIABLES)), \
64222767Sed      $(subst \ ,\#,$(MAKEOVERRIDES))))
65222767Sed
66222767Sed  # Setup information about available configurations, if any.
67222767Sed  build_dir=$(topdir)/build
68222767Sed  all_spec_files=$(wildcard $(build_dir)/*/spec.gmk)
69222767Sed  # Extract the configuration names from the path
70222767Sed  all_confs=$(patsubst %/spec.gmk, %, $(patsubst $(build_dir)/%, %, $(all_spec_files)))
71222767Sed
72222767Sed  # Check for unknown command-line variables
73222767Sed  define CheckControlVariables
7468723Sru    command_line_variables := $$(strip $$(foreach var, \
75201227Sed        $$(subst \ ,_,$$(MAKEOVERRIDES)), \
7668723Sru        $$(firstword $$(subst =, , $$(var)))))
77206471Sed    unknown_command_line_variables := $$(strip \
78206471Sed        $$(filter-out $$(MAKE_CONTROL_VARIABLES), $$(command_line_variables)))
7968723Sru    ifneq ($$(unknown_command_line_variables), )
80222767Sed      $$(info Note: Command line contains non-control variables:)
81222767Sed      $$(foreach var, $$(unknown_command_line_variables), $$(info * $$(var)=$$($$(var))))
82222767Sed      $$(info Make sure it is not mistyped, and that you intend to override this variable.)
83222767Sed      $$(info 'make help' will list known control variables.)
84222767Sed      $$(info )
85222767Sed    endif
86222767Sed  endef
87222767Sed
88222767Sed  # Check for deprecated ALT_ variables
89222767Sed  define CheckDeprecatedEnvironment
90222767Sed    defined_alt_variables := $$(filter ALT_%, $$(.VARIABLES))
91222767Sed    ifneq ($$(defined_alt_variables), )
92222767Sed      $$(info Warning: You have the following ALT_ variables set:)
93222767Sed      $$(foreach var, $$(defined_alt_variables), $$(info * $$(var)=$$($$(var))))
9468723Sru      $$(info ALT_ variables are deprecated, and may result in a failed build.)
95222767Sed      $$(info Please clean your environment.)
96222767Sed      $$(info )
9768723Sru    endif
98222767Sed  endef
99222767Sed
100222767Sed  # Check for invalid make flags like -j
101222767Sed  define CheckInvalidMakeFlags
102222767Sed    # This is a trick to get this rule to execute before any other rules
103202205Sed    # MAKEFLAGS only indicate -j if read in a recipe (!)
10468723Sru    $$(topdir)/make/Init.gmk: .FORCE
10568723Sru	$$(if $$(findstring --jobserver, $$(MAKEFLAGS)), \
10668723Sru	    $$(info Error: 'make -jN' is not supported, use 'make JOBS=N') \
107200303Sed	    $$(error Cannot continue) \
108202205Sed	)
10968723Sru    .FORCE:
110222767Sed    .PHONY: .FORCE
111222767Sed  endef
112222767Sed
113222767Sed  # Check that the CONF_CHECK option is valid and set up handling
114206471Sed  define ParseConfCheckOption
115206471Sed    ifeq ($$(CONF_CHECK), )
116202205Sed      # Default behavior is fail
117200303Sed      CONF_CHECK := fail
11868723Sru    else ifneq ($$(filter-out auto fail ignore, $$(CONF_CHECK)),)
119206472Sed      $$(info Error: CONF_CHECK must be one of: auto, fail or ignore.)
120206471Sed      $$(error Cannot continue)
121206471Sed    endif
122206472Sed  endef
123206472Sed
124206472Sed  define ParseLogLevel
125206471Sed    # Catch old-style VERBOSE= command lines.
12668723Sru    ifneq ($$(origin VERBOSE), undefined)
127202205Sed      $$(info Error: VERBOSE is deprecated. Use LOG=<warn|info|debug|trace> instead.)
128206471Sed      $$(error Cannot continue)
129206471Sed    endif
130206471Sed
131206471Sed    # Setup logging according to LOG
13268723Sru
13368723Sru    # If the "nofile" argument is given, act on it and strip it away
13468723Sru    ifneq ($$(findstring nofile, $$(LOG)),)
13568723Sru      LOG_NOFILE := true
13668723Sru      # COMMA is defined in spec.gmk, but that is not included yet
13768723Sru      COMMA := ,
13868723Sru      # First try to remove ",nofile" if it exists, otherwise just remove "nofile"
139202205Sed      LOG_STRIPPED := $$(subst nofile,, $$(subst $$(COMMA)nofile,, $$(LOG)))
14068723Sru      # We might have ended up with a leading comma. Remove it
141200303Sed      LOG_LEVEL := $$(strip $$(patsubst $$(COMMA)%, %, $$(LOG_STRIPPED)))
142200303Sed    else
143205365Sed      LOG_LEVEL := $$(LOG)
144202205Sed    endif
14568723Sru
14668723Sru    ifeq ($$(LOG_LEVEL),)
14768723Sru      # Set LOG to "warn" as default if not set
148201227Sed      LOG_LEVEL := warn
14968723Sru    endif
150222767Sed
15168723Sru    ifeq ($$(LOG_LEVEL), warn)
15268723Sru      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
308else # $(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	      $(CAT) $(logfile) | $(GREP) -v -e "^Note: including file:" $(NEWLINE) \
444	  ) \
445	  $(PRINTF) "=== End of repeated output ===\n" \
446	)
447  endef
448
449  define PrintBuildLogFailures
450	if $(GREP) -q "recipe for target .* failed" $(BUILD_LOG) 2> /dev/null; then  \
451	  $(PRINTF) "=== Make failure sequence repeated here ===\n" ; \
452	  $(GREP) "recipe for target .* failed" $(BUILD_LOG) ; \
453	  $(PRINTF) "=== End of repeated output ===\n" ; \
454	  $(PRINTF) "Hint: Try searching the build log for the name of the first failed target.\n" ; \
455	else \
456	  $(PRINTF) "No indication of failed target found.\n" ; \
457	  $(PRINTF) "Hint: Try searching the build log for '] Error'.\n" ; \
458	fi
459  endef
460
461  define RotateLogFiles
462	$(RM) $(BUILD_LOG).old 2> /dev/null && \
463	$(MV) $(BUILD_LOG) $(BUILD_LOG).old 2> /dev/null || true
464	$(if $(findstring trace, $(LOG_LEVEL)), \
465	  $(RM) $(BUILD_TRACE_LOG).old 2> /dev/null && \
466	  $(MV) $(BUILD_TRACE_LOG) $(BUILD_TRACE_LOG).old 2> /dev/null || true \
467	)
468  endef
469
470  define PrepareFailureLogs
471	$(RM) -r $(MAKESUPPORT_OUTPUTDIR)/failure-logs 2> /dev/null && \
472	$(MKDIR) -p $(MAKESUPPORT_OUTPUTDIR)/failure-logs
473  endef
474
475  # Remove any javac server logs and port files. This
476  # prevents a new make run to reuse the previous servers.
477  define PrepareSmartJavac
478	$(if $(SJAVAC_SERVER_DIR), \
479	  $(RM) -r $(SJAVAC_SERVER_DIR) 2> /dev/null && \
480	  $(MKDIR) -p $(SJAVAC_SERVER_DIR) \
481	)
482  endef
483
484  define CleanupSmartJavac
485	[ -f $(SJAVAC_SERVER_DIR)/server.port ] && $(ECHO) Stopping sjavac server && \
486	    $(TOUCH) $(SJAVAC_SERVER_DIR)/server.port.stop; true
487  endef
488
489  define StartGlobalTimer
490	$(RM) -r $(BUILDTIMESDIR) 2> /dev/null && \
491	$(MKDIR) -p $(BUILDTIMESDIR) && \
492	$(call RecordStartTime,TOTAL)
493  endef
494
495  define StopGlobalTimer
496	$(call RecordEndTime,TOTAL)
497  endef
498
499  # Find all build_time_* files and print their contents in a list sorted
500  # on the name of the sub repository.
501  define ReportBuildTimes
502	$(PRINTF) $(LOG_INFO) -- \
503	    "----- Build times -------\nStart %s\nEnd   %s\n%s\n%s\n-------------------------\n" \
504	    "`$(CAT) $(BUILDTIMESDIR)/build_time_start_TOTAL_human_readable`" \
505	    "`$(CAT) $(BUILDTIMESDIR)/build_time_end_TOTAL_human_readable`" \
506	    "`$(LS) $(BUILDTIMESDIR)/build_time_diff_* | $(GREP) -v _TOTAL | \
507	    $(XARGS) $(CAT) | $(SORT) -k 2`" \
508	    "`$(CAT) $(BUILDTIMESDIR)/build_time_diff_TOTAL`" \
509	    $(BUILD_LOG_PIPE)
510  endef
511
512endif # HAS_SPEC
513
514endif # _INITSUPPORT_GMK
515