1 #
   2 # Copyright (c) 2011, 2019, 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 is the main makefile containing most actual top level targets. It needs
  28 # to be called with a SPEC file defined.
  29 ################################################################################
  30 
  31 # Declare default target
  32 default:
  33 
  34 ifeq ($(wildcard $(SPEC)),)
  35   $(error Main.gmk needs SPEC set to a proper spec.gmk)
  36 endif
  37 
  38 # Now load the spec
  39 include $(SPEC)
  40 
  41 include $(TOPDIR)/make/MainSupport.gmk
  42 
  43 # Load the vital tools for all the makefiles.
  44 include $(TOPDIR)/make/common/MakeBase.gmk
  45 include $(TOPDIR)/make/common/Modules.gmk
  46 include $(TOPDIR)/make/common/FindTests.gmk
  47 
  48 # Declare ALL_TARGETS as an immediate variable. This variable is a list of all
  49 # valid top level targets. It's used to declare them all as PHONY and to
  50 # generate the -only targets.
  51 ALL_TARGETS :=
  52 
  53 # Hook to include the corresponding custom file, if present.
  54 $(eval $(call IncludeCustomExtension, Main.gmk))
  55 
  56 # All modules for the current target platform.
  57 ALL_MODULES := $(call FindAllModules)
  58 
  59 ################################################################################
  60 ################################################################################
  61 #
  62 # Recipes for all targets. Only recipes, dependencies are declared later.
  63 #
  64 ################################################################################
  65 
  66 ################################################################################
  67 # Interim/build tools targets, compiling tools used during the build
  68 
  69 # When creating a BUILDJDK, the buildtools and interim targets have already
  70 # been built and should not be built again.
  71 ifneq ($(CREATING_BUILDJDK), true)
  72   buildtools-langtools:
  73         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f ToolsLangtools.gmk)
  74 
  75   interim-langtools:
  76         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileInterimLangtools.gmk)
  77 
  78   interim-rmic:
  79         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileInterimRmic.gmk)
  80 
  81   interim-cldrconverter:
  82         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CopyInterimCLDRConverter.gmk)
  83 
  84   buildtools-jdk:
  85         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileToolsJdk.gmk)
  86 
  87   buildtools-modules:
  88         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileModuleTools.gmk)
  89 
  90   buildtools-hotspot:
  91         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileToolsHotspot.gmk)
  92 endif
  93 
  94 ALL_TARGETS += buildtools-langtools interim-langtools \
  95     interim-rmic interim-cldrconverter buildtools-jdk buildtools-modules \
  96     buildtools-hotspot
  97 
  98 ################################################################################
  99 # Special targets for certain modules
 100 
 101 generate-exported-symbols:
 102         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f BuildStatic.gmk)
 103 
 104 ALL_TARGETS += generate-exported-symbols
 105 
 106 ################################################################################
 107 # Gensrc targets, generating source before java compilation can be done
 108 #
 109 # When creating a BUILDJDK, the java targets have already been built and copied
 110 # into the buildjdk so no need to generate sources.
 111 ifneq ($(CREATING_BUILDJDK), true)
 112   $(eval $(call DeclareRecipesForPhase, GENSRC, \
 113       TARGET_SUFFIX := gensrc-src, \
 114       FILE_PREFIX := Gensrc, \
 115       MAKE_SUBDIR := gensrc, \
 116       CHECK_MODULES := $(ALL_MODULES), \
 117   ))
 118 
 119   $(foreach m, $(GENSRC_MODULES), $(eval $m-gensrc: $m-gensrc-src))
 120 
 121   LANGTOOLS_GENSRC_TARGETS := $(filter $(addsuffix -%, $(LANGTOOLS_MODULES)), $(GENSRC_TARGETS))
 122   INTERIM_LANGTOOLS_GENSRC_TARGETS := $(filter $(addsuffix -%, \
 123       $(INTERIM_LANGTOOLS_BASE_MODULES)), $(GENSRC_TARGETS))
 124   HOTSPOT_GENSRC_TARGETS := $(filter $(addsuffix -%, $(HOTSPOT_MODULES)), $(GENSRC_TARGETS))
 125   JDK_GENSRC_TARGETS := $(filter-out $(LANGTOOLS_GENSRC_TARGETS) \
 126       $(HOTSPOT_GENSRC_TARGETS), $(GENSRC_TARGETS))
 127 
 128   GENSRC_MODULEINFO_MODULES := $(ALL_MODULES)
 129   GENSRC_MODULEINFO_TARGETS := $(addsuffix -gensrc-moduleinfo, \
 130       $(GENSRC_MODULEINFO_MODULES))
 131 
 132   GENSRC_MODULES := $(GENSRC_MODULEINFO_MODULES)
 133   GENSRC_TARGETS += $(sort $(GENSRC_MODULEINFO_TARGETS) \
 134       $(addsuffix -gensrc, $(GENSRC_MODULES)))
 135 
 136   define DeclareModuleInfoRecipe
 137     $1-gensrc-moduleinfo:
 138         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) \
 139             -f GensrcModuleInfo.gmk MODULE=$1)
 140 
 141     $1-gensrc: $1-gensrc-moduleinfo
 142   endef
 143 
 144   $(foreach m, $(GENSRC_MODULEINFO_MODULES), $(eval $(call DeclareModuleInfoRecipe,$m)))
 145 endif
 146 
 147 ALL_TARGETS += $(GENSRC_TARGETS)
 148 
 149 ################################################################################
 150 # Generate data targets
 151 $(eval $(call DeclareRecipesForPhase, GENDATA, \
 152     TARGET_SUFFIX := gendata, \
 153     FILE_PREFIX := Gendata, \
 154     MAKE_SUBDIR := gendata, \
 155     CHECK_MODULES := $(ALL_MODULES), \
 156     USE_WRAPPER := true))
 157 
 158 ALL_TARGETS += $(GENDATA_TARGETS)
 159 
 160 ################################################################################
 161 # Copy files targets
 162 $(eval $(call DeclareRecipesForPhase, COPY, \
 163     TARGET_SUFFIX := copy, \
 164     FILE_PREFIX := Copy, \
 165     MAKE_SUBDIR := copy, \
 166     CHECK_MODULES := $(ALL_MODULES), \
 167     USE_WRAPPER := true, \
 168 ))
 169 
 170 ALL_COPY_MODULES += $(COPY_MODULES)
 171 ALL_COPY_TARGETS += $(COPY_TARGETS)
 172 
 173 IMPORT_COPY_MODULES := $(call FindImportedModules)
 174 IMPORT_COPY_TARGETS := $(addsuffix -copy, $(IMPORT_COPY_MODULES))
 175 ALL_COPY_MODULES += $(IMPORT_COPY_MODULES)
 176 ALL_COPY_TARGETS += $(IMPORT_COPY_TARGETS)
 177 
 178 define DeclareImportCopyRecipe
 179   $1-copy:
 180         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) \
 181             -f CopyImportModules.gmk MODULE=$1)
 182 endef
 183 
 184 $(foreach m, $(IMPORT_COPY_MODULES), $(eval $(call DeclareImportCopyRecipe,$m)))
 185 
 186 ALL_TARGETS += $(ALL_COPY_TARGETS)
 187 
 188 ################################################################################
 189 # Targets for compiling all java modules.
 190 JAVA_MODULES := $(ALL_MODULES)
 191 JAVA_TARGETS := $(addsuffix -java, $(JAVA_MODULES))
 192 
 193 define DeclareCompileJavaRecipe
 194   $1-java:
 195         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) \
 196             -f CompileJavaModules.gmk MODULE=$1)
 197 endef
 198 
 199 $(foreach m, $(JAVA_MODULES), $(eval $(call DeclareCompileJavaRecipe,$m)))
 200 
 201 ALL_TARGETS += $(JAVA_TARGETS)
 202 
 203 ################################################################################
 204 # Targets for running rmic.
 205 $(eval $(call DeclareRecipesForPhase, RMIC, \
 206     TARGET_SUFFIX := rmic, \
 207     FILE_PREFIX := Rmic, \
 208     MAKE_SUBDIR := rmic, \
 209     CHECK_MODULES := $(ALL_MODULES)))
 210 
 211 ALL_TARGETS += $(RMIC_TARGETS)
 212 
 213 ################################################################################
 214 # Targets for compiling native libraries
 215 $(eval $(call DeclareRecipesForPhase, LIBS, \
 216     TARGET_SUFFIX := libs, \
 217     FILE_PREFIX := Lib, \
 218     MAKE_SUBDIR := lib, \
 219     CHECK_MODULES := $(ALL_MODULES), \
 220     USE_WRAPPER := true))
 221 
 222 ALL_TARGETS += $(LIBS_TARGETS)
 223 
 224 ################################################################################
 225 # Targets for compiling native executables
 226 $(eval $(call DeclareRecipesForPhase, LAUNCHER, \
 227     TARGET_SUFFIX := launchers, \
 228     FILE_PREFIX := Launcher, \
 229     MAKE_SUBDIR := launcher, \
 230     CHECK_MODULES := $(ALL_MODULES), \
 231     USE_WRAPPER := true))
 232 
 233 ALL_TARGETS += $(LAUNCHER_TARGETS)
 234 
 235 ################################################################################
 236 # Build hotspot target
 237 
 238 HOTSPOT_VARIANT_TARGETS := $(addprefix hotspot-, $(JVM_VARIANTS))
 239 HOTSPOT_VARIANT_GENSRC_TARGETS := $(addsuffix -gensrc, $(HOTSPOT_VARIANT_TARGETS))
 240 HOTSPOT_VARIANT_LIBS_TARGETS := $(addsuffix -libs, $(HOTSPOT_VARIANT_TARGETS))
 241 
 242 define DeclareHotspotGensrcRecipe
 243   hotspot-$1-gensrc:
 244         $$(call LogInfo, Building JVM variant '$1' with features '$(JVM_FEATURES_$1)')
 245         +($(CD) $(TOPDIR)/make/hotspot && $(MAKE) $(MAKE_ARGS) -f gensrc/GenerateSources.gmk \
 246             JVM_VARIANT=$1)
 247 endef
 248 
 249 $(foreach v, $(JVM_VARIANTS), $(eval $(call DeclareHotspotGensrcRecipe,$v)))
 250 
 251 define DeclareHotspotLibsRecipe
 252   hotspot-$1-libs:
 253         +($(CD) $(TOPDIR)/make/hotspot && $(MAKE) $(MAKE_ARGS) -f lib/CompileLibraries.gmk \
 254             JVM_VARIANT=$1)
 255 endef
 256 
 257 $(foreach v, $(JVM_VARIANTS), $(eval $(call DeclareHotspotLibsRecipe,$v)))
 258 
 259 hotspot-ide-project:
 260         +($(CD) $(TOPDIR)/make/hotspot && $(MAKE) $(MAKE_ARGS) -f ide/CreateVSProject.gmk)
 261 
 262 ALL_TARGETS += $(HOTSPOT_VARIANT_TARGETS) $(HOTSPOT_VARIANT_GENSRC_TARGETS) \
 263     $(HOTSPOT_VARIANT_LIBS_TARGETS) hotspot-ide-project
 264 
 265 ################################################################################
 266 # Generate libs and launcher targets for creating compile_commands.json fragments
 267 define DeclareCompileCommandsRecipe
 268   $1-compile-commands:
 269         $$(call LogInfo, Generating compile_commands.json fragments for $1)
 270         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Main.gmk $1-only \
 271             GENERATE_COMPILE_COMMANDS_ONLY=true)
 272 
 273   COMPILE_COMMANDS_TARGETS_$2 += $1-compile-commands
 274 endef
 275 
 276 $(foreach t, $(HOTSPOT_VARIANT_LIBS_TARGETS), \
 277   $(eval $(call DeclareCompileCommandsRecipe,$t,HOTSPOT)) \
 278 )
 279 
 280 $(foreach t, $(LIBS_TARGETS) $(LAUNCHER_TARGETS), \
 281   $(eval $(call DeclareCompileCommandsRecipe,$t,JDK)) \
 282 )
 283 
 284 compile-commands compile-commands-hotspot:
 285         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileCommands.gmk)
 286 
 287 ALL_TARGETS += $(COMPILE_COMMANDS_TARGETS_HOTSPOT) $(COMPILE_COMMANDS_TARGETS_JDK)
 288 ALL_TARGETS += compile-commands compile-commands-hotspot
 289 
 290 ################################################################################
 291 # Build demos targets
 292 
 293 demos-jdk:
 294         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileDemos.gmk)
 295 
 296 test-image-demos-jdk:
 297         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileDemos.gmk images)
 298 
 299 ALL_TARGETS += demos-jdk test-image-demos-jdk
 300 
 301 ################################################################################
 302 # Jigsaw specific data and analysis targets.
 303 
 304 generate-summary:
 305         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f GenerateModuleSummary.gmk)
 306 
 307 ALL_TARGETS += generate-summary
 308 
 309 ################################################################################
 310 # Jmod targets
 311 
 312 JMOD_MODULES := $(ALL_MODULES)
 313 JMOD_TARGETS := $(addsuffix -jmod, $(JMOD_MODULES))
 314 
 315 define DeclareJmodRecipe
 316   $1-jmod:
 317         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CreateJmods.gmk \
 318             MODULE=$1)
 319 endef
 320 
 321 $(foreach m, $(JMOD_MODULES), $(eval $(call DeclareJmodRecipe,$m)))
 322 
 323 ALL_TARGETS += $(JMOD_TARGETS)
 324 
 325 ################################################################################
 326 # Images targets
 327 
 328 store-source-revision:
 329         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f SourceRevision.gmk store-source-revision)
 330 
 331 create-source-revision-tracker:
 332         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f SourceRevision.gmk create-source-revision-tracker)
 333 
 334 BOOTCYCLE_TARGET := product-images
 335 bootcycle-images:
 336         ifneq ($(COMPILE_TYPE), cross)
 337           $(call LogWarn, Boot cycle build step 2: Building a new JDK image using previously built image)
 338           $(call MakeDir, $(OUTPUTDIR)/bootcycle-build)
 339           +$(MAKE) $(MAKE_ARGS) -f $(TOPDIR)/make/Init.gmk PARALLEL_TARGETS=$(BOOTCYCLE_TARGET) \
 340               JOBS= SPEC=$(dir $(SPEC))bootcycle-spec.gmk main
 341         else
 342           $(call LogWarn, Boot cycle build disabled when cross compiling)
 343         endif
 344 
 345 zip-security:
 346         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f ZipSecurity.gmk)
 347 
 348 zip-source:
 349         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f ZipSource.gmk)
 350 
 351 jrtfs-jar:
 352         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f JrtfsJar.gmk)
 353 
 354 jdk-image:
 355         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Images.gmk jdk)
 356 
 357 legacy-jre-image:
 358         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Images.gmk jre)
 359 
 360 symbols-image:
 361         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Images.gmk symbols)
 362 
 363 mac-jdk-bundle:
 364         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f MacBundles.gmk jdk-bundle)
 365 
 366 mac-legacy-jre-bundle:
 367         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f MacBundles.gmk jre-bundle)
 368 
 369 release-file:
 370         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f ReleaseFile.gmk)
 371 
 372 exploded-image-optimize:
 373         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f ExplodedImageOptimize.gmk)
 374 
 375 ifeq ($(JCOV_ENABLED), true)
 376   jcov-image:
 377         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Coverage.gmk jcov-image)
 378 endif
 379 
 380 ALL_TARGETS += store-source-revision create-source-revision-tracker bootcycle-images zip-security \
 381     zip-source jrtfs-jar jdk-image legacy-jre-image \
 382     symbols-image mac-jdk-bundle mac-legacy-jre-bundle \
 383     release-file exploded-image-optimize jcov-image
 384 
 385 ################################################################################
 386 # Docs targets
 387 
 388 # If building full docs, to complete docs-*-api we need both the javadoc and
 389 # modulegraph targets.
 390 docs-jdk-api-javadoc:
 391         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Docs.gmk docs-jdk-api-javadoc)
 392 
 393 docs-jdk-api-modulegraph:
 394         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Docs.gmk docs-jdk-api-modulegraph)
 395 
 396 docs-javase-api-javadoc:
 397         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Docs.gmk docs-javase-api-javadoc)
 398 
 399 docs-javase-api-modulegraph:
 400         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Docs.gmk docs-javase-api-modulegraph)
 401 
 402 docs-reference-api-javadoc:
 403         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Docs.gmk docs-reference-api-javadoc)
 404 
 405 docs-reference-api-modulegraph:
 406         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Docs.gmk docs-reference-api-modulegraph)
 407 
 408 docs-jdk-specs:
 409         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Docs.gmk docs-jdk-specs)
 410 
 411 docs-jdk-index:
 412         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Docs.gmk docs-jdk-index)
 413 
 414 docs-zip:
 415         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Docs.gmk docs-zip)
 416 
 417 update-build-docs:
 418         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f UpdateBuildDocs.gmk)
 419 
 420 update-x11wrappers:
 421         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f UpdateX11Wrappers.gmk)
 422 
 423 ALL_TARGETS += docs-jdk-api-javadoc docs-jdk-api-modulegraph \
 424     docs-javase-api-javadoc docs-javase-api-modulegraph \
 425     docs-reference-api-javadoc docs-reference-api-modulegraph docs-jdk-specs \
 426     docs-jdk-index docs-zip update-build-docs update-x11wrappers
 427 
 428 ################################################################################
 429 # Cross compilation support
 430 
 431 ifeq ($(CREATING_BUILDJDK), true)
 432   # This target is only called by the recursive call below.
 433   create-buildjdk-interim-image-helper: interim-image jdk.jlink-launchers \
 434       java.base-copy jdk.jdeps-launchers
 435 endif
 436 
 437 create-buildjdk-copy:
 438         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CreateBuildJdkCopy.gmk)
 439 
 440 create-buildjdk-interim-image:
 441         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Main.gmk \
 442             $@-helper \
 443             SPEC=$(dir $(SPEC))buildjdk-spec.gmk \
 444             HOTSPOT_SPEC=$(dir $(SPEC))buildjdk-spec.gmk \
 445             CREATING_BUILDJDK=true)
 446 
 447 ALL_TARGETS += create-buildjdk-copy create-buildjdk-interim-image
 448 
 449 ################################################################################
 450 # The interim-image is a small jlinked image that is used to generate artifacts
 451 # at build time for use when linking the real images.
 452 
 453 INTERIM_JMOD_TARGETS := $(addsuffix -interim-jmod, $(INTERIM_IMAGE_MODULES))
 454 
 455 define DeclareInterimJmodRecipe
 456   $1-interim-jmod:
 457         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CreateJmods.gmk \
 458             MODULE=$1 \
 459             JMODS_DIR=$(INTERIM_JMODS_DIR) \
 460             JMODS_SUPPORT_DIR=$(INTERIM_JMODS_DIR)/support \
 461             INTERIM_JMOD=true \
 462         )
 463 endef
 464 
 465 $(foreach m, $(INTERIM_IMAGE_MODULES), $(eval $(call DeclareInterimJmodRecipe,$m)))
 466 
 467 interim-image:
 468         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f InterimImage.gmk)
 469 
 470 ifeq ($(ENABLE_GENERATE_CLASSLIST), true)
 471   generate-link-opt-data:
 472         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f GenerateLinkOptData.gmk)
 473 endif
 474 
 475 ALL_TARGETS += $(INTERIM_JMOD_TARGETS) interim-image generate-link-opt-data
 476 
 477 ################################################################################
 478 # Generate test names for all JTReg test groups
 479 #
 480 
 481 define DeclareRunTestRecipe
 482   test-$1:
 483         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f RunTests.gmk \
 484             TEST="$1")
 485 
 486   exploded-test-$1:
 487         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f RunTests.gmk \
 488             TEST="$1" JDK_IMAGE_DIR=$(JDK_OUTPUTDIR))
 489 endef
 490 
 491 # ALL_NAMED_TESTS is defined in FindTests.gmk
 492 $(foreach t, $(ALL_NAMED_TESTS), $(eval $(call DeclareRunTestRecipe,$t)))
 493 ALL_TEST_TARGETS := $(addprefix test-, $(ALL_NAMED_TESTS))
 494 
 495 # We only support the "exploded-test-gtest" shortcut
 496 ALL_EXPLODED_TESTS := gtest
 497 ALL_EXPLODED_TEST_TARGETS := $(addprefix exploded-test-, $(ALL_EXPLODED_TESTS))
 498 
 499 ALL_TARGETS += $(ALL_TEST_TARGETS) $(ALL_EXPLODED_TEST_TARGETS)
 500 
 501 ################################################################################
 502 # Build tests and microbenchmarks
 503 #
 504 
 505 prepare-test-image:
 506         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f TestImage.gmk prepare-test-image)
 507 
 508 build-test-hotspot-jtreg-native:
 509         +($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNativeHotspot.gmk \
 510             build-test-hotspot-jtreg-native)
 511 
 512 test-image-hotspot-jtreg-native:
 513         +($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNativeHotspot.gmk \
 514             test-image-hotspot-jtreg-native)
 515 
 516 build-test-jdk-jtreg-native:
 517         +($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNativeJdk.gmk \
 518             build-test-jdk-jtreg-native)
 519 
 520 test-image-jdk-jtreg-native:
 521         +($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNativeJdk.gmk \
 522             test-image-jdk-jtreg-native)
 523 
 524 build-test-hotspot-jtreg-graal:
 525         +($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregGraalUnit.gmk \
 526              build-test-hotspot-jtreg-graal)
 527 
 528 test-image-hotspot-jtreg-graal:
 529         +($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregGraalUnit.gmk \
 530              test-image-hotspot-jtreg-graal)
 531 
 532 ifeq ($(BUILD_GTEST), true)
 533   test-image-hotspot-gtest:
 534         +($(CD) $(TOPDIR)/make/hotspot/test && $(MAKE) $(MAKE_ARGS) -f GtestImage.gmk)
 535 endif
 536 
 537 build-test-lib:
 538         +($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f BuildTestLib.gmk)
 539 
 540 ifeq ($(BUILD_FAILURE_HANDLER), true)
 541   # Builds the failure handler jtreg extension
 542   build-test-failure-handler:
 543         +($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) \
 544             -f BuildFailureHandler.gmk build)
 545 
 546   # Copies the failure handler jtreg extension into the test image
 547   test-image-failure-handler:
 548         +($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) \
 549              -f BuildFailureHandler.gmk images)
 550 endif
 551 
 552 build-microbenchmark:
 553         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f test/BuildMicrobenchmark.gmk)
 554 
 555 ALL_TARGETS += prepare-test-image build-test-hotspot-jtreg-native \
 556     test-image-hotspot-jtreg-native build-test-jdk-jtreg-native \
 557     test-image-jdk-jtreg-native build-test-lib build-test-failure-handler \
 558     test-failure-handler test-image-failure-handler test-image-hotspot-gtest \
 559     test-image-hotspot-jtreg-graal build-test-hotspot-jtreg-graal \
 560     build-microbenchmark
 561 
 562 ################################################################################
 563 # Run tests
 564 
 565 test:
 566         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f RunTests.gmk \
 567             TEST="$(TEST)")
 568 
 569 exploded-test:
 570         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f RunTests.gmk \
 571             TEST="$(TEST)" JDK_IMAGE_DIR=$(JDK_OUTPUTDIR))
 572 
 573 jcov-test:
 574         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f RunTests.gmk \
 575             TEST="$(TEST)" TEST_OPTS_JCOV=true)
 576 
 577 ALL_TARGETS += test exploded-test jcov-test
 578 
 579 ################################################################################
 580 # Bundles
 581 
 582 product-bundles:
 583         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk product-bundles)
 584 
 585 legacy-bundles:
 586         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk legacy-bundles)
 587 
 588 test-bundles:
 589         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk test-bundles)
 590 
 591 docs-bundles:
 592         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk docs-bundles)
 593 
 594 ifeq ($(JCOV_ENABLED), true)
 595   jcov-bundles:
 596         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk jcov-bundles)
 597 endif
 598 
 599 ALL_TARGETS += product-bundles legacy-bundles test-bundles docs-bundles jcov-bundles
 600 
 601 ################################################################################
 602 # Install targets
 603 
 604 install:
 605         +($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Install.gmk)
 606 
 607 ALL_TARGETS += install
 608 
 609 ################################################################################
 610 #
 611 # Dependency declarations between targets.
 612 #
 613 # These are declared in two groups. First all dependencies between targets that
 614 # have recipes above as these dependencies may be disabled. Then the aggregator
 615 # targets that do not have recipes of their own, which will never have their
 616 # dependencies disabled.
 617 #
 618 ################################################################################
 619 # Targets with recipes above
 620 
 621 # If running an *-only target, parallel execution and dependencies between
 622 # recipe targets are disabled. This makes it possible to run a select set of
 623 # recipe targets in order. It's the responsibility of the user to make sure
 624 # all prerequisites are fulfilled.
 625 ifneq ($(findstring -only, $(MAKECMDGOALS)), )
 626   .NOTPARALLEL:
 627 else
 628   $(LANGTOOLS_GENSRC_TARGETS): buildtools-langtools
 629 
 630   interim-langtools: $(INTERIM_LANGTOOLS_GENSRC_TARGETS)
 631 
 632   buildtools-jdk: interim-langtools interim-cldrconverter
 633 
 634   buildtools-hotspot: interim-langtools
 635 
 636   buildtools-modules: exploded-image-base
 637 
 638   $(HOTSPOT_GENSRC_TARGETS): interim-langtools buildtools-hotspot
 639 
 640   $(JDK_GENSRC_TARGETS): interim-langtools buildtools-jdk
 641 
 642   $(GENSRC_MODULEINFO_TARGETS): buildtools-jdk
 643 
 644   $(GENDATA_TARGETS): interim-langtools buildtools-jdk
 645 
 646   interim-rmic: interim-langtools
 647 
 648   $(RMIC_TARGETS): interim-langtools interim-rmic
 649 
 650   $(JAVA_TARGETS): interim-langtools
 651 
 652   # Declare dependencies between hotspot-<variant>* targets
 653   $(foreach v, $(JVM_VARIANTS), \
 654       $(eval hotspot-$v-gensrc: java.base-copy) \
 655       $(eval hotspot-$v-libs: hotspot-$v-gensrc java.base-copy) \
 656   )
 657 
 658   hotspot-ide-project: hotspot exploded-image
 659 
 660   generate-exported-symbols: java.base-libs jdk.jdwp.agent-libs
 661 
 662   # If not already set, set the JVM variant target so that the JVM will be built.
 663   JVM_MAIN_LIB_TARGETS ?= hotspot-$(JVM_VARIANT_MAIN)-libs
 664 
 665   # Building one JVM variant is enough to start building the other libs
 666   $(LIBS_TARGETS): $(JVM_MAIN_LIB_TARGETS)
 667 
 668   $(LAUNCHER_TARGETS): java.base-libs
 669 
 670   ifeq ($(STATIC_BUILD), true)
 671     $(LAUNCHER_TARGETS): generate-exported-symbols
 672   endif
 673 
 674   # The demos are currently linking to libjvm and libjava, just like all other
 675   # jdk libs, even though they don't need to. To avoid warnings, make sure they
 676   # aren't built until after libjava and libjvm are available to link to.
 677   demos-jdk: java.base-libs exploded-image-optimize
 678   test-image-demos-jdk: demos-jdk
 679 
 680   # Declare dependency from <module>-java to <module>-gensrc
 681   $(foreach m, $(GENSRC_MODULES), $(eval $m-java: $m-gensrc))
 682 
 683   # Declare dependencies between java modules
 684   $(foreach m, $(JAVA_MODULES), \
 685       $(eval $m-java: $(addsuffix -java, $(filter $(JAVA_MODULES), \
 686       $(call FindDepsForModule,$m)))))
 687 
 688   # Declare dependencies between <module>-rmic to <module>-java
 689   $(foreach m, $(RMIC_MODULES), $(eval $m-rmic: $m-java))
 690 
 691   # Declare dependencies from <module>-lib to <module>-java
 692   # Skip modules that do not have java source.
 693   # When creating a BUILDJDK, the java compilation has already been done by the
 694   # normal build and copied in.
 695   ifneq ($(CREATING_BUILDJDK), true)
 696     $(foreach m, $(filter $(JAVA_MODULES), $(LIBS_MODULES)), $(eval $m-libs: $m-java))
 697   endif
 698 
 699   # Declare dependencies from all other <module>-lib to java.base-lib
 700   $(foreach t, $(filter-out java.base-libs, $(LIBS_TARGETS)), \
 701       $(eval $t: java.base-libs))
 702 
 703   # jdk.accessibility depends on java.desktop
 704   jdk.accessibility-libs: java.desktop-libs
 705 
 706   # This dependency needs to be explicitly declared. jdk.jdi-gensrc generates a
 707   # header file used by jdk.jdwp.agent-libs. The jdk.jdwp.agent-gensrc is a
 708   # virtual target.
 709   jdk.jdwp.agent-libs: jdk.jdwp.agent-gensrc
 710 
 711   # The swing beans need to have java base properly generated to avoid errors
 712   # in javadoc. The X11 wrappers need the java.base include files to have been
 713   # copied and processed.
 714   java.desktop-gensrc-src: java.base-gensrc java.base-copy
 715 
 716   # The annotation processing for jdk.internal.vm.compiler
 717   # and jdk.internal.vm.compiler.management needs classes from the current JDK.
 718   jdk.internal.vm.compiler-gensrc-src: $(addsuffix -java, \
 719       $(call FindTransitiveDepsForModule, jdk.internal.vm.compiler))
 720   jdk.internal.vm.compiler.management-gensrc-src: $(addsuffix -java, \
 721       $(call FindTransitiveDepsForModule, jdk.internal.vm.compiler.management))
 722 
 723   # For these modules, the gensrc step is generating a module-info.java.extra
 724   # file to be processed by the gensrc-moduleinfo target.
 725   jdk.internal.vm.compiler-gensrc-moduleinfo: jdk.internal.vm.compiler-gensrc-src
 726   jdk.internal.vm.compiler.management-gensrc-moduleinfo: jdk.internal.vm.compiler.management-gensrc-src
 727 
 728   jdk.jdeps-gendata: java rmic
 729 
 730   # The ct.sym generation uses all the moduleinfos as input
 731   jdk.compiler-gendata: $(GENSRC_MODULEINFO_TARGETS)
 732 
 733   # Declare dependencies between jmod targets.
 734   # java.base jmod needs jrt-fs.jar and access to the other jmods to be built.
 735   # When creating a BUILDJDK, we don't need to add hashes to java.base, thus
 736   # we don't need to depend on all other jmods
 737   ifneq ($(CREATING_BUILDJDK), true)
 738     java.base-jmod: jrtfs-jar $(filter-out java.base-jmod, $(JMOD_TARGETS))
 739   endif
 740 
 741   # If not already set, set the JVM target so that the JVM will be built.
 742   JVM_MAIN_TARGETS ?= hotspot
 743 
 744   # Building java.base-jmod requires all of VM (ie hotspot) to be built.
 745   java.base-jmod: $(JVM_MAIN_TARGETS)
 746 
 747   # Declare dependencies from <module>-jmod to all other module targets
 748   # When creating a BUILDJDK, the java compilation has already been done by the
 749   # normal build and copied in.
 750   ifneq ($(CREATING_BUILDJDK), true)
 751     $(foreach m, $(JAVA_MODULES), $(eval $m_JMOD_DEPS += $m-java))
 752   endif
 753   $(foreach m, $(GENDATA_MODULES), $(eval $m_JMOD_DEPS += $m-gendata))
 754   $(foreach m, $(RMIC_MODULES), $(eval $m_JMOD_DEPS += $m-rmic))
 755   $(foreach m, $(LIBS_MODULES), $(eval $m_JMOD_DEPS += $m-libs))
 756   $(foreach m, $(LAUNCHER_MODULES), $(eval $m_JMOD_DEPS += $m-launchers))
 757   $(foreach m, $(COPY_MODULES), $(eval $m_JMOD_DEPS += $m-copy))
 758   $(foreach m, $(ALL_MODULES), $(eval $m-jmod: $($(m)_JMOD_DEPS)))
 759   $(foreach m, $(INTERIM_IMAGE_MODULES), $(eval $m-interim-jmod: $($(m)_JMOD_DEPS)))
 760 
 761   # Setup the minimal set of generated native source dependencies for hotspot
 762   $(foreach v, $(JVM_VARIANTS), \
 763     $(eval hotspot-$v-libs-compile-commands: hotspot-$v-gensrc) \
 764     $(foreach m, $(filter java.desktop jdk.hotspot.agent, $(GENSRC_MODULES)), \
 765       $(eval hotspot-$v-libs-compile-commands: $m-gensrc)) \
 766   )
 767 
 768   # For the full JDK compile commands, create all possible generated sources
 769   $(foreach m, $(GENSRC_MODULES), $(eval $m-libs-compile-commands: $m-gensrc))
 770   $(foreach m, $(filter $(JAVA_MODULES), $(LIBS_MODULES)), $(eval $m-libs-compile-commands: $m-java))
 771 
 772   $(COMPILE_COMMANDS_TARGETS_HOTSPOT): clean-compile-commands
 773   $(COMPILE_COMMANDS_TARGETS_JDK): clean-compile-commands
 774   compile-commands-hotspot: $(COMPILE_COMMANDS_TARGETS_HOTSPOT)
 775   compile-commands: $(COMPILE_COMMANDS_TARGETS_HOTSPOT) $(COMPILE_COMMANDS_TARGETS_JDK)
 776 
 777   # Jmods cannot be created until we have the jmod tool ready to run. During
 778   # a normal build we run it from the exploded image, but when cross compiling
 779   # it's run from the buildjdk, which is either created at build time or user
 780   # supplied.
 781   #
 782   # For the exploded image to be runnable, all java modules and
 783   # jdk.jlink-launchers need to be built. We also need to copy jvm.cfg (done
 784   # in java.base-copy) and tzdb.dat (done in java.base-gendata) to the
 785   # appropriate location otherwise jimage, jlink and jmod won't start. This
 786   # also applies when creating the buildjdk.
 787   DEFAULT_JMOD_DEPS += java.base-libs java.base-copy java.base-gendata \
 788       jdk.jlink-launchers
 789   # When cross compiling and buildjdk is to be created, depend on creating the
 790   # buildjdk instead of the default dependencies.
 791   ifeq ($(CREATE_BUILDJDK), true)
 792     # Avoid calling create-buildjdk from within a create-buildjdk call.
 793     ifneq ($(CREATING_BUILDJDK), true)
 794       $(JMOD_TARGETS): create-buildjdk
 795       buildtools-modules: create-buildjdk
 796     else
 797       # While actually creating the buildjdk, the default deps applies.
 798       $(JMOD_TARGETS) $(INTERIM_JMOD_TARGETS): $(DEFAULT_JMOD_DEPS)
 799     endif
 800   else
 801     # The normal non cross compilation case uses the default deps.
 802     # To avoid races with the optimize target, that also needs to happen first.
 803     $(JMOD_TARGETS) $(INTERIM_JMOD_TARGETS): $(DEFAULT_JMOD_DEPS) \
 804         exploded-image-optimize
 805   endif
 806 
 807   # All modules include the main license files from java.base.
 808   $(JMOD_TARGETS): java.base-copy
 809 
 810   zip-security: java.base-java java.security.jgss-java java.security.jgss-libs \
 811       $(filter jdk.crypto%, $(JAVA_TARGETS))
 812 
 813   zip-source: gensrc rmic
 814 
 815   jrtfs-jar: interim-langtools
 816 
 817   build-microbenchmark: interim-langtools exploded-image
 818 
 819   ifeq ($(ENABLE_GENERATE_CLASSLIST), true)
 820     ifeq ($(CREATE_BUILDJDK), true)
 821       # If creating a buildjdk, the interim image needs to be based on that.
 822       generate-link-opt-data: create-buildjdk
 823     else ifeq ($(EXTERNAL_BUILDJDK), false)
 824       # If an external buildjdk has been provided, we skip generating an
 825       # interim-image and just use the external buildjdk for generating
 826       # classlist.
 827       generate-link-opt-data: interim-image
 828     endif
 829     generate-link-opt-data: buildtools-jdk
 830 
 831     # The generated classlist needs to go into java.base-jmod.
 832     java.base-jmod jdk.jlink-jmod jdk-image legacy-jre-image: generate-link-opt-data
 833   endif
 834 
 835   release-file: create-source-revision-tracker
 836 
 837   jdk-image: jmods zip-source demos release-file
 838   legacy-jre-image: jmods release-file
 839   symbols-image: $(LIBS_TARGETS) $(LAUNCHER_TARGETS)
 840 
 841   mac-jdk-bundle: jdk-image
 842   mac-legacy-jre-bundle: legacy-jre-image
 843 
 844   ifeq ($(JCOV_INPUT_JDK), )
 845     jcov-image: jdk-image
 846   endif
 847 
 848   # The optimize target can run as soon as the modules dir has been completely
 849   # populated (java, copy and gendata targets) and the basic libs and launchers
 850   # have been built.
 851   exploded-image-optimize: java copy gendata java.base-libs java.base-launchers \
 852       buildtools-modules
 853 
 854   bootcycle-images: jdk-image
 855 
 856   docs-jdk-api-javadoc: $(GENSRC_TARGETS) rmic
 857 
 858   docs-javase-api-javadoc: $(GENSRC_TARGETS) rmic
 859 
 860   docs-reference-api-javadoc: $(GENSRC_TARGETS) rmic
 861 
 862   docs-jdk-api-modulegraph: exploded-image buildtools-modules
 863 
 864   docs-javase-api-modulegraph: exploded-image buildtools-modules
 865 
 866   docs-reference-api-modulegraph: exploded-image buildtools-modules
 867 
 868   # If not already set, then set the JVM specific docs targets
 869   JVM_DOCS_TARGETS ?= hotspot-$(JVM_VARIANT_MAIN)-gensrc
 870 
 871   # The gensrc steps for hotspot and jdk.jdi create html spec files.
 872   docs-jdk-specs: $(JVM_DOCS_TARGETS) jdk.jdi-gensrc \
 873       docs-jdk-index
 874 
 875   docs-zip: docs-jdk
 876 
 877   # Tests
 878   test: jdk-image test-image
 879 
 880   exploded-test: exploded-image test-image
 881 
 882   jcov-test: jcov-image test-image
 883 
 884   test-make: clean-test-make compile-commands
 885 
 886   test-make-compile-commands: compile-commands
 887 
 888   # Declare dependency for all generated test targets
 889   $(foreach t, $(filter-out test-make%, $(ALL_TEST_TARGETS)), $(eval $t: jdk-image test-image))
 890   $(foreach t, $(ALL_EXPLODED_TEST_TARGETS), $(eval $t: exploded-image test-image))
 891 
 892   create-buildjdk-copy: jdk.jlink-java java.base-gendata \
 893       $(addsuffix -java, $(INTERIM_IMAGE_MODULES))
 894 
 895   create-buildjdk-interim-image: create-buildjdk-copy
 896 
 897   interim-image: $(INTERIM_JMOD_TARGETS)
 898 
 899   build-test-lib: exploded-image-optimize
 900 
 901   build-test-failure-handler: interim-langtools
 902 
 903   test-image-failure-handler: build-test-failure-handler
 904 
 905   build-test-hotspot-jtreg-native: buildtools-jdk \
 906       hotspot-$(JVM_VARIANT_MAIN)-libs
 907 
 908   build-test-jdk-jtreg-native: buildtools-jdk java.base-libs
 909 
 910   build-test-hotspot-jtreg-graal: exploded-image-optimize
 911 
 912   test-image-hotspot-jtreg-native: build-test-hotspot-jtreg-native
 913 
 914   test-image-jdk-jtreg-native: build-test-jdk-jtreg-native
 915 
 916   test-image-hotspot-jtreg-graal: build-test-hotspot-jtreg-graal
 917 
 918   test-image-hotspot-gtest: hotspot
 919 
 920   install: product-images
 921 
 922   product-bundles: product-images
 923 
 924   legacy-bundles: legacy-images
 925 
 926   test-bundles: test-image
 927 
 928   docs-bundles: docs-image
 929 
 930   jcov-bundles: jcov-image
 931 
 932   generate-summary: jmods buildtools-modules
 933 
 934   update-x11wrappers: java.base-copy buildtools-jdk
 935 
 936 endif
 937 
 938 ################################################################################
 939 # Virtual targets without recipes
 940 
 941 # If not already set, set the JVM specific tools targets
 942 JVM_TOOLS_TARGETS ?= buildtools-hotspot
 943 buildtools: buildtools-langtools interim-langtools interim-rmic \
 944     buildtools-jdk $(JVM_TOOLS_TARGETS)
 945 
 946 # Declare dependencies from hotspot-<variant> targets
 947 $(foreach v, $(JVM_VARIANTS), \
 948   $(eval hotspot-$v: hotspot-$v-gensrc hotspot-$v-libs) \
 949 )
 950 hotspot: $(HOTSPOT_VARIANT_TARGETS)
 951 
 952 # Create targets hotspot-libs and hotspot-gensrc.
 953 $(foreach v, $(JVM_VARIANTS), \
 954   $(eval hotspot-libs: hotspot-$v-libs) \
 955   $(eval hotspot-gensrc: hotspot-$v-gensrc) \
 956 )
 957 
 958 gensrc: $(GENSRC_TARGETS)
 959 
 960 gendata: $(GENDATA_TARGETS)
 961 
 962 copy: $(ALL_COPY_TARGETS)
 963 
 964 java: $(JAVA_TARGETS)
 965 
 966 rmic: $(RMIC_TARGETS)
 967 
 968 libs: $(LIBS_TARGETS)
 969 
 970 launchers: $(LAUNCHER_TARGETS)
 971 
 972 jmods: $(JMOD_TARGETS)
 973 
 974 # Explicitly declare dependency for virtual target jdk.jdwp.agent-gensrc which
 975 # is actually handled by jdk.jdi-gensrc
 976 jdk.jdwp.agent-gensrc: jdk.jdi-gensrc
 977 
 978 # Declare dependencies from <module> to all the individual targets specific
 979 # to that module <module>-*, that are needed for the exploded image.
 980 $(foreach m, $(GENSRC_MODULES), $(eval $m: $m-gensrc))
 981 $(foreach m, $(JAVA_MODULES), $(eval $m: $m-java))
 982 $(foreach m, $(GENDATA_MODULES), $(eval $m: $m-gendata))
 983 $(foreach m, $(RMIC_MODULES), $(eval $m: $m-rmic))
 984 $(foreach m, $(LIBS_MODULES), $(eval $m: $m-libs))
 985 $(foreach m, $(LAUNCHER_MODULES), $(eval $m: $m-launchers))
 986 $(foreach m, $(ALL_COPY_MODULES), $(eval $m: $m-copy))
 987 
 988 # Building java.base includes building all of hotspot.
 989 java.base: $(JVM_MAIN_TARGETS)
 990 
 991 demos: demos-jdk
 992 
 993 # The "exploded image" is a locally runnable JDK in $(OUTPUTDIR)/jdk.
 994 exploded-image-base: $(ALL_MODULES)
 995 exploded-image: exploded-image-base release-file
 996 # When cross compiling, no need to optimize the exploded image since it won't
 997 # be runnable on the host platform anyway.
 998 ifneq ($(COMPILE_TYPE), cross)
 999   exploded-image: exploded-image-optimize
1000 endif
1001 
1002 create-buildjdk: create-buildjdk-copy create-buildjdk-interim-image
1003 
1004 docs-jdk-api: docs-jdk-api-javadoc
1005 docs-javase-api: docs-javase-api-javadoc
1006 docs-reference-api: docs-reference-api-javadoc
1007 
1008 # If we're building full docs, we must also generate the module graphs to
1009 # get non-broken api documentation.
1010 ifeq ($(ENABLE_FULL_DOCS), true)
1011   docs-jdk-api: docs-jdk-api-modulegraph
1012   docs-javase-api: docs-javase-api-modulegraph
1013   docs-reference-api: docs-reference-api-modulegraph
1014 endif
1015 
1016 docs-jdk: docs-jdk-api docs-jdk-specs docs-jdk-index
1017 docs-javase: docs-javase-api
1018 docs-reference: docs-reference-api
1019 
1020 # alias for backwards compatibility
1021 docs-javadoc: docs-jdk-api
1022 
1023 mac-bundles: mac-jdk-bundle
1024 
1025 # The $(OUTPUTDIR)/images directory contain the resulting deliverables,
1026 # and in line with this, our targets for creating these are named *-image[s].
1027 
1028 # This target builds the product images, e.g. the JDK image
1029 # (and possibly other, more specific versions)
1030 product-images: jdk-image symbols-image exploded-image
1031 
1032 # This target builds the legacy images, e.g. the legacy JRE image
1033 legacy-images: legacy-jre-image
1034 
1035 # zip-security is actually a bundle, but for now it needs to be considered
1036 # an image until this can be cleaned up properly.
1037 product-images: zip-security
1038 
1039 # The module summary cannot be run when:
1040 # * Cross compiling and building a partial BUILDJDK for the build host
1041 # * An external buildjdk has been supplied since it may not match the
1042 #   module selection of the target jdk
1043 ifneq ($(CREATE_BUILDJDK), true)
1044   ifeq ($(EXTERNAL_BUILDJDK), false)
1045     product-images: generate-summary
1046   endif
1047 endif
1048 
1049 ifeq ($(call isTargetOs, macosx), true)
1050   product-images: mac-jdk-bundle
1051 
1052   legacy-images: mac-legacy-jre-bundle
1053 endif
1054 
1055 # This target builds the documentation image
1056 docs-image: docs-jdk
1057 
1058 # If not already set, set the JVM specific targets to build the test image
1059 JVM_TEST_IMAGE_TARGETS ?= test-image-hotspot-jtreg-native test-image-hotspot-gtest
1060 
1061 ifeq ($(INCLUDE_GRAAL), true)
1062   JVM_TEST_IMAGE_TARGETS += test-image-hotspot-jtreg-graal
1063 endif
1064 
1065 # This target builds the test image
1066 test-image: prepare-test-image \
1067     test-image-jdk-jtreg-native test-image-failure-handler \
1068     test-image-demos-jdk $(JVM_TEST_IMAGE_TARGETS)
1069 
1070 ifneq ($(JMH_CORE_JAR), )
1071   test-image: build-microbenchmark
1072 endif
1073 
1074 ################################################################################
1075 
1076 # all-images builds all our deliverables as images.
1077 all-images: product-images test-image docs-image
1078 
1079 # all-bundles packages all our deliverables as tar.gz bundles.
1080 all-bundles: product-bundles test-bundles docs-bundles
1081 
1082 ALL_TARGETS += buildtools hotspot hotspot-libs hotspot-gensrc gensrc gendata \
1083     copy java rmic libs launchers jmods \
1084     jdk.jdwp.agent-gensrc $(ALL_MODULES) demos \
1085     exploded-image-base exploded-image \
1086     create-buildjdk docs-jdk-api docs-javase-api docs-reference-api docs-jdk \
1087     docs-javase docs-reference docs-javadoc mac-bundles product-images legacy-images \
1088     docs-image test-image all-images \
1089     all-bundles
1090 
1091 ################################################################################
1092 
1093 # Traditional targets typically run by users.
1094 # These can be considered aliases for the targets now named by a more
1095 # "modern" naming scheme.
1096 default: $(DEFAULT_MAKE_TARGET)
1097 jdk: exploded-image
1098 images: product-images
1099 docs: docs-image
1100 bundles: all-bundles
1101 all: all-images
1102 
1103 ALL_TARGETS += default jdk images docs bundles all
1104 
1105 # Aliases used for running tests.
1106 
1107 # Let "run-test" be an alias for "test"
1108 $(foreach t, $(ALL_NAMED_TESTS), $(eval run-test-$t: test-$t))
1109 RUN_TEST_TARGETS := $(addprefix run-test-, $(ALL_NAMED_TESTS))
1110 
1111 run-test: test
1112 exploded-run-test: exploded-test
1113 
1114 # "make check" is a common idiom for running basic testing
1115 check: test-tier1
1116 
1117 # Keep some old names as aliases
1118 test-hotspot-jtreg: test-hotspot_all
1119 test-hotspot-jtreg-native: test-hotspot_native_sanity
1120 test-hotspot-gtest: exploded-test-gtest
1121 test-jdk-jtreg-native: test-jdk_native_sanity
1122 
1123 ALL_TARGETS += $(RUN_TEST_TARGETS) run-test exploded-run-test check \
1124     test-hotspot-jtreg test-hotspot-jtreg-native test-hotspot-gtest \
1125     test-jdk-jtreg-native
1126 
1127 ################################################################################
1128 ################################################################################
1129 #
1130 # Clean targets
1131 #
1132 ################################################################################
1133 # Clean targets are automatically run serially by the Makefile calling this
1134 # file.
1135 
1136 CLEAN_DIRS += hotspot jdk bootcycle-build test buildtools support \
1137     images make-support test-make bundles buildjdk test-results test-support \
1138     support/images
1139 CLEAN_DIR_TARGETS := $(addprefix clean-, $(CLEAN_DIRS))
1140 CLEAN_SUPPORT_DIRS += demos
1141 CLEAN_SUPPORT_DIR_TARGETS := $(addprefix clean-, $(CLEAN_SUPPORT_DIRS))
1142 CLEAN_TESTS += hotspot-jtreg-native jdk-jtreg-native lib
1143 CLEAN_TEST_TARGETS += $(addprefix clean-test-, $(CLEAN_TESTS))
1144 CLEAN_PHASES := gensrc java native include
1145 CLEAN_PHASE_TARGETS := $(addprefix clean-, $(CLEAN_PHASES))
1146 CLEAN_MODULE_TARGETS := $(addprefix clean-, $(ALL_MODULES))
1147 # Construct targets of the form clean-$module-$phase
1148 CLEAN_MODULE_PHASE_TARGETS := $(addprefix clean-, $(foreach m, $(ALL_MODULES), \
1149     $(addprefix $m-, $(CLEAN_PHASES))))
1150 
1151 # Remove everything, except the output from configure.
1152 clean: $(CLEAN_DIR_TARGETS)
1153         ($(CD) $(OUTPUTDIR) && $(RM) -r build*.log* compile_commands.json)
1154         $(ECHO) Cleaned all build artifacts.
1155 
1156 clean-docs:
1157         $(call CleanDocs)
1158 
1159 clean-compile-commands:
1160         $(call CleanMakeSupportDir,compile-commands)
1161 
1162 $(CLEAN_DIR_TARGETS):
1163         $(call CleanDir,$(patsubst clean-%, %, $@))
1164 
1165 $(CLEAN_SUPPORT_DIR_TARGETS):
1166         $(call CleanSupportDir,$(patsubst clean-%, %, $@))
1167 
1168 $(CLEAN_TEST_TARGETS):
1169         $(call CleanTest,$(patsubst clean-test-%, %, $@))
1170 
1171 $(CLEAN_PHASE_TARGETS):
1172         $(call Clean-$(patsubst clean-%,%, $@))
1173 
1174 $(CLEAN_MODULE_TARGETS):
1175         $(call CleanModule,$(patsubst clean-%, %, $@))
1176 
1177 $(CLEAN_MODULE_PHASE_TARGETS):
1178         $(call Clean-$(word 3, $(subst -,$(SPACE),$@)), \
1179             $(word 2, $(subst -,$(SPACE),$@)))
1180 
1181 # When removing the support dir, we must also remove jdk. Building classes has
1182 # the side effect of generating native headers. The headers end up in support
1183 # while classes and touch files end up in jdk.
1184 clean-support: clean-jdk
1185 
1186 clean-test: clean-test-results clean-test-support
1187 
1188 # When cleaning images, also clean the support/images directory.
1189 clean-images: clean-support/images
1190 
1191 # Remove everything, including configure configuration. If the output
1192 # directory was created by configure and now becomes empty, remove it as well.
1193 dist-clean: clean
1194         ($(CD) $(OUTPUTDIR) && \
1195             $(RM) -r *spec.gmk $(CONFIGURESUPPORT_OUTPUTDIR) Makefile compare.sh ide \
1196             configure.log* build.log*)
1197         $(if $(filter $(CONF_NAME),$(notdir $(OUTPUTDIR))), \
1198           if test "x`$(LS) $(OUTPUTDIR)`" != x; then \
1199             $(ECHO) "Warning: Not removing non-empty configuration directory for '$(CONF_NAME)'" ; \
1200           else \
1201             ($(CD) $(TOPDIR) && $(ECHO) "Removing configuration directory for '$(CONF_NAME)'" \
1202                 && $(RM) -r $(OUTPUTDIR)) \
1203           fi \
1204         )
1205         $(ECHO) Cleaned everything, you will have to re-run configure.
1206 
1207 ALL_TARGETS += clean clean-docs clean-compile-commands dist-clean $(CLEAN_DIR_TARGETS) \
1208     $(CLEAN_SUPPORT_DIR_TARGETS) $(CLEAN_TEST_TARGETS) $(CLEAN_PHASE_TARGETS) \
1209     $(CLEAN_MODULE_TARGETS) $(CLEAN_MODULE_PHASE_TARGETS)
1210 
1211 ################################################################################
1212 # Declare *-only targets for each normal target
1213 $(foreach t, $(ALL_TARGETS), $(eval $(t)-only: $(t)))
1214 
1215 ALL_TARGETS += $(addsuffix -only, $(filter-out dist-clean clean%, $(ALL_TARGETS)))
1216 
1217 ################################################################################
1218 
1219 # The following targets are intentionally not added to ALL_TARGETS since they
1220 # are internal only, to support Init.gmk.
1221 
1222 print-targets:
1223           @$(ECHO) $(sort $(ALL_TARGETS))
1224 
1225 print-modules:
1226           @$(ECHO) $(sort $(ALL_MODULES))
1227 
1228 print-tests:
1229           @$(ECHO) $(sort $(ALL_NAMED_TESTS))
1230 
1231 create-main-targets-include:
1232           $(call LogInfo, Generating main target list)
1233           @$(ECHO) ALL_MAIN_TARGETS := $(sort $(ALL_TARGETS)) > \
1234               $(MAKESUPPORT_OUTPUTDIR)/main-targets.gmk
1235 
1236 ################################################################################
1237 # Hook to include the corresponding custom file, if present.
1238 $(eval $(call IncludeCustomExtension, Main-post.gmk))
1239 
1240 .PHONY: $(ALL_TARGETS)
1241 
1242 FRC: # Force target