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 Main.gmk.
  28 ################################################################################
  29 
  30 ifndef _MAINSUPPORT_GMK
  31 _MAINSUPPORT_GMK := 1
  32 
  33 # Run the tests specified by $1, with PRODUCT_HOME specified by $2
  34 # JT_JAVA is picked up by the jtreg launcher and used to run Jtreg itself.
  35 define RunTests
  36         ($(CD) $(SRC_ROOT)/test && $(MAKE) $(MAKE_ARGS) -j1 -k MAKEFLAGS= \
  37             JT_HOME=$(JT_HOME) PRODUCT_HOME=$(strip $2) \
  38             TEST_IMAGE_DIR=$(TEST_IMAGE_DIR) \
  39             ALT_OUTPUTDIR=$(OUTPUT_ROOT) TEST_JOBS=$(TEST_JOBS) \
  40             JT_JAVA=$(BOOT_JDK) \
  41             JOBS=$(JOBS) $1) || true
  42 endef
  43 
  44 # Cleans the dir given as $1
  45 define CleanDir
  46         @$(PRINTF) "Cleaning $(strip $1) build artifacts ..."
  47         @$(PRINTF) "\n" $(LOG_DEBUG)
  48         ($(CD) $(OUTPUT_ROOT) && $(RM) -r $1)
  49         @$(PRINTF) " done\n"
  50 endef
  51 
  52 define CleanSupportDir
  53         @$(PRINTF) "Cleaning $(strip $1) build artifacts ..."
  54         @$(PRINTF) "\n" $(LOG_DEBUG)
  55         $(RM) -r $(SUPPORT_OUTPUTDIR)/$(strip $1)
  56         @$(PRINTF) " done\n"
  57 endef
  58 
  59 define CleanTest
  60         @$(PRINTF) "Cleaning test $(strip $1) ..."
  61         @$(PRINTF) "\n" $(LOG_DEBUG)
  62         $(RM) -r $(SUPPORT_OUTPUTDIR)/test/$(strip $(subst -,/,$1))
  63         # Remove as much of the test directory structure as is empty
  64         $(RMDIR) -p $(dir $(SUPPORT_OUTPUTDIR)/test/$(strip $(subst -,/,$1))) 2> /dev/null || true
  65         @$(PRINTF) " done\n"
  66 endef
  67 
  68 define Clean-gensrc
  69         @$(PRINTF) "Cleaning gensrc $(if $1,for $(strip $1) )..."
  70         @$(PRINTF) "\n" $(LOG_DEBUG)
  71         $(RM) -r $(SUPPORT_OUTPUTDIR)/gensrc/$(strip $1)
  72         @$(PRINTF) " done\n"
  73 endef
  74 
  75 define Clean-java
  76         @$(PRINTF) "Cleaning java $(if $1,for $(strip $1) )..."
  77         @$(PRINTF) "\n" $(LOG_DEBUG)
  78         $(RM) -r $(JDK_OUTPUTDIR)/modules/$(strip $1)
  79         $(RM) -r $(SUPPORT_OUTPUTDIR)/special_classes/$(strip $1)
  80         $(PRINTF) " done\n"
  81         $(PRINTF) "Cleaning headers $(if $1,for $(strip $1)) ..."
  82         $(RM) -r $(SUPPORT_OUTPUTDIR)/headers/$(strip $1)
  83         @$(PRINTF) " done\n"
  84 endef
  85 
  86 define Clean-native
  87         @$(PRINTF) "Cleaning native $(if $1,for $(strip $1) )..."
  88         @$(PRINTF) "\n" $(LOG_DEBUG)
  89         $(RM) -r $(SUPPORT_OUTPUTDIR)/native/$(strip $1)
  90         $(RM) -r $(SUPPORT_OUTPUTDIR)/modules_libs/$(strip $1)
  91         $(RM) -r $(SUPPORT_OUTPUTDIR)/modules_libs-stripped/$(strip $1)
  92         $(RM) -r $(SUPPORT_OUTPUTDIR)/modules_cmds/$(strip $1)
  93         $(RM) -r $(SUPPORT_OUTPUTDIR)/modules_cmds-stripped/$(strip $1)
  94         @$(PRINTF) " done\n"
  95 endef
  96 
  97 define Clean-include
  98         @$(PRINTF) "Cleaning include $(if $1,for $(strip $1) )..."
  99         @$(PRINTF) "\n" $(LOG_DEBUG)
 100         $(RM) -r $(SUPPORT_OUTPUTDIR)/modules_include/$(strip $1)
 101         @$(PRINTF) " done\n"
 102 endef
 103 
 104 define Clean-docs
 105         @$(PRINTF) "Cleaning docs ..."
 106         @$(PRINTF) "\n" $(LOG_DEBUG)
 107         $(RM) -r $(SUPPORT_OUTPUTDIR)/docs
 108         $(RM) -r $(IMAGES_OUTPUTDIR)/docs
 109         $(RM) $(OUTPUT_ROOT)/bundles/jdk-*-docs.zip
 110         @$(PRINTF) " done\n"
 111 endef
 112 
 113 define CleanModule
 114   $(call Clean-gensrc, $1)
 115   $(call Clean-java, $1)
 116   $(call Clean-native, $1)
 117   $(call Clean-include, $1)
 118 endef
 119 
 120 
 121 ################################################################################
 122 
 123 MAKE_TOPDIR_LIST := $(JDK_TOPDIR) $(CORBA_TOPDIR) $(LANGTOOLS_TOPDIR) \
 124     $(HOTSPOT_TOPDIR)
 125 MAKE_MAKEDIR_LIST := make
 126 
 127 # Helper macro for DeclareRecipesForPhase
 128 # Declare a recipe for calling the module and phase specific makefile.
 129 # If there are multiple makefiles to call, create a rule for each topdir
 130 # that contains a makefile with the target $module-$suffix-$repodir,
 131 # (i.e: java.base-gensrc-jdk)
 132 # Normally there is only one makefile, and the target will just be
 133 # $module-$suffix
 134 # Param 1: Name of list to add targets to
 135 # Param 2: Module name
 136 # Param 3: Topdir
 137 define DeclareRecipeForModuleMakefile
 138   ifeq ($$($1_MULTIPLE_MAKEFILES), true)
 139     $2-$$($1_TARGET_SUFFIX): $2-$$($1_TARGET_SUFFIX)-$$(notdir $3)
 140     $1 += $2-$$($1_TARGET_SUFFIX)-$$(notdir $3)
 141 
 142     $2-$$($1_TARGET_SUFFIX)-$$(notdir $3):
 143   else
 144     $2-$$($1_TARGET_SUFFIX):
 145   endif
 146         ifeq ($$($1_USE_WRAPPER), true)
 147           +($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) \
 148               -f ModuleWrapper.gmk \
 149                   $$(addprefix -I, $$(wildcard $$(addprefix $3/, $(MAKE_MAKEDIR_LIST)) \
 150                   $$(addsuffix /$$($1_MAKE_SUBDIR), $$(addprefix $3/, $(MAKE_MAKEDIR_LIST))))) \
 151                   MODULE=$2 MAKEFILE_PREFIX=$$($1_FILE_PREFIX))
 152         else
 153           +($(CD) $$(dir $$(firstword $$(wildcard $$(patsubst %, \
 154                   $3/%/$$($1_MAKE_SUBDIR)/$$($1_FILE_PREFIX)-$2.gmk, $(MAKE_MAKEDIR_LIST))))) \
 155             && $(MAKE) $(MAKE_ARGS) \
 156                   -f $$($1_FILE_PREFIX)-$2.gmk \
 157                   $$(addprefix -I, $$(wildcard $$(addprefix $3/, $(MAKE_MAKEDIR_LIST)) \
 158                   $$(addsuffix /$$($1_MAKE_SUBDIR), $$(addprefix $3/, $(MAKE_MAKEDIR_LIST))))) \
 159                   MODULE=$2)
 160         endif
 161 
 162 endef
 163 
 164 # Helper macro for DeclareRecipesForPhase
 165 # Param 1: Name of list to add targets to
 166 # Param 2: Module name
 167 define DeclareRecipesForPhaseAndModule
 168   $1_$2_TOPDIRS := $$(strip $$(sort $$(foreach d, $(MAKE_TOPDIR_LIST), \
 169       $$(patsubst $$d/%, $$d, $$(filter $$d/%, \
 170           $$(wildcard $$(patsubst %, %/$$($1_MAKE_SUBDIR)/$$($1_FILE_PREFIX)-$2.gmk, \
 171           $$(foreach s, $(MAKE_MAKEDIR_LIST), \
 172               $$(addsuffix /$$s, $(MAKE_TOPDIR_LIST))))))))))
 173 
 174   # Only declare recipes if there are makefiles to call
 175   ifneq ($$($1_$2_TOPDIRS), )
 176     ifeq ($(NO_RECIPES),)
 177       $$(foreach d, $$($1_$2_TOPDIRS), \
 178           $$(eval $$(call DeclareRecipeForModuleMakefile,$1,$2,$$d)))
 179     endif
 180     $1 += $2-$$($1_TARGET_SUFFIX)
 181     $1_MODULES += $2
 182   endif
 183 endef
 184 
 185 # Declare recipes for a specific module and build phase if there are makefiles
 186 # present for the specific combination.
 187 # Param 1: Name of list to add targets to
 188 # Named params:
 189 # TARGET_SUFFIX : Suffix of target to create for recipe
 190 # MAKE_SUBDIR : Subdir for this build phase
 191 # FILE_PREFIX : File prefix for this build phase
 192 # USE_WRAPPER : Set to true to use ModuleWrapper.gmk
 193 # CHECK_MODULES : List of modules to try
 194 # MULTIPLE_MAKEFILES : Set to true to handle makefiles for the same module and
 195 #                      phase in multiple repos
 196 # Exported variables:
 197 # $1_MODULES : All modules that had rules generated
 198 # $1_TARGETS : All targets generated
 199 define DeclareRecipesForPhase
 200   $(foreach i,2 3 4 5 6 7, $(if $($i),$(strip $1)_$(strip $($i)))$(NEWLINE))
 201   $(if $(8),$(error Internal makefile error: Too many arguments to \
 202       DeclareRecipesForPhase, please update MakeHelper.gmk))
 203 
 204   $$(foreach m, $$($(strip $1)_CHECK_MODULES), \
 205       $$(eval $$(call DeclareRecipesForPhaseAndModule,$(strip $1),$$m)))
 206 
 207   $(strip $1)_TARGETS := $$($(strip $1))
 208 endef
 209 
 210 ################################################################################
 211 
 212 endif # _MAINSUPPORT_GMK