Main.gmk revision 2317:9ae47deec185
1#
2# Copyright (c) 2011, 2016, 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
32default:
33
34ifeq ($(wildcard $(SPEC)),)
35  $(error Main.gmk needs SPEC set to a proper spec.gmk)
36endif
37
38# Now load the spec
39include $(SPEC)
40
41include $(SRC_ROOT)/make/MainSupport.gmk
42
43# Load the vital tools for all the makefiles.
44include $(SRC_ROOT)/make/common/MakeBase.gmk
45include $(SRC_ROOT)/make/common/Modules.gmk
46
47# Declare ALL_TARGETS as an immediate variable. This variable is a list of all
48# valid top level targets. It's used to declare them all as PHONY and to
49# generate the -only targets.
50ALL_TARGETS :=
51
52# Hook to include the corresponding custom file, if present.
53$(eval $(call IncludeCustomExtension, , Main.gmk))
54
55# All modules for the current target platform.
56ALL_MODULES := $(call FindAllModules)
57
58################################################################################
59################################################################################
60#
61# Recipes for all targets. Only recipes, dependencies are declared later.
62#
63################################################################################
64
65################################################################################
66# Interim/build tools targets, compiling tools used during the build
67
68# When creating a BUILDJDK, the buildtools and interim targets have already
69# been built and should not be built again.
70ifneq ($(CREATING_BUILDJDK), true)
71  buildtools-langtools:
72	+($(CD) $(LANGTOOLS_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Tools.gmk)
73
74  interim-langtools:
75	+($(CD) $(LANGTOOLS_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileInterim.gmk)
76
77  interim-rmic:
78	+($(CD) $(JDK_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileInterimRmic.gmk)
79
80  interim-cldrconverter:
81	+($(CD) $(JDK_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CopyInterimCLDRConverter.gmk)
82
83  buildtools-jdk:
84	+($(CD) $(JDK_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileTools.gmk)
85
86  buildtools-modules:
87	+($(CD) $(JDK_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileModuleTools.gmk)
88endif
89
90ALL_TARGETS += buildtools-langtools interim-langtools \
91    interim-rmic interim-cldrconverter buildtools-jdk buildtools-modules
92
93################################################################################
94# Special targets for certain modules
95
96unpack-sec:
97	+($(CD) $(JDK_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f UnpackSecurity.gmk)
98
99generate-exported-symbols:
100	+($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f BuildStatic.gmk)
101
102ALL_TARGETS += unpack-sec generate-exported-symbols
103
104################################################################################
105# Gensrc targets, generating source before java compilation can be done
106#
107# When creating a BUILDJDK, the java targets have already been built and copied
108# into the buildjdk so no need to generate sources.
109ifneq ($(CREATING_BUILDJDK), true)
110  $(eval $(call DeclareRecipesForPhase, GENSRC, \
111      TARGET_SUFFIX := gensrc, \
112      FILE_PREFIX := Gensrc, \
113      MAKE_SUBDIR := gensrc, \
114      CHECK_MODULES := $(ALL_MODULES), \
115      MULTIPLE_MAKEFILES := true))
116
117  JDK_GENSRC_TARGETS := $(filter %-gensrc-jdk, $(GENSRC_TARGETS))
118  LANGTOOLS_GENSRC_TARGETS := $(filter %-gensrc-langtools, $(GENSRC_TARGETS))
119  CORBA_GENSRC_TARGETS := $(filter %-gensrc-corba, $(GENSRC_TARGETS))
120  HOTSPOT_GENSRC_TARGETS := $(filter %-gensrc-hotspot, $(GENSRC_TARGETS))
121
122  GENSRC_MODULEINFO_MODULES := $(ALL_MODULES)
123  GENSRC_MODULEINFO_TARGETS := $(addsuffix -gensrc-moduleinfo, \
124      $(GENSRC_MODULEINFO_MODULES))
125
126  GENSRC_MODULES := $(GENSRC_MODULEINFO_MODULES)
127  GENSRC_TARGETS += $(sort $(GENSRC_MODULEINFO_TARGETS) \
128      $(addsuffix -gensrc, $(GENSRC_MODULES)))
129
130  define DeclareModuleInfoRecipe
131    $1-gensrc-moduleinfo:
132	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) \
133	    -f GensrcModuleInfo.gmk MODULE=$1)
134
135    $1-gensrc: $1-gensrc-moduleinfo
136  endef
137
138  $(foreach m, $(GENSRC_MODULEINFO_MODULES), $(eval $(call DeclareModuleInfoRecipe,$m)))
139endif
140
141ALL_TARGETS += $(GENSRC_TARGETS)
142
143################################################################################
144# Generate data targets
145$(eval $(call DeclareRecipesForPhase, GENDATA, \
146    TARGET_SUFFIX := gendata, \
147    FILE_PREFIX := Gendata, \
148    MAKE_SUBDIR := gendata, \
149    CHECK_MODULES := $(ALL_MODULES), \
150    USE_WRAPPER := true))
151
152ALL_TARGETS += $(GENDATA_TARGETS)
153
154################################################################################
155# Copy files targets
156$(eval $(call DeclareRecipesForPhase, COPY, \
157    TARGET_SUFFIX := copy, \
158    FILE_PREFIX := Copy, \
159    MAKE_SUBDIR := copy, \
160    CHECK_MODULES := $(ALL_MODULES), \
161    USE_WRAPPER := true, \
162    MULTIPLE_MAKEFILES := true))
163
164ALL_COPY_MODULES += $(COPY_MODULES)
165ALL_COPY_TARGETS += $(COPY_TARGETS)
166
167IMPORT_COPY_MODULES := $(call FindImportedModules)
168IMPORT_COPY_TARGETS := $(addsuffix -copy, $(IMPORT_COPY_MODULES))
169ALL_COPY_MODULES += $(IMPORT_COPY_MODULES)
170ALL_COPY_TARGETS += $(IMPORT_COPY_TARGETS)
171
172define DeclareImportCopyRecipe
173  $1-copy:
174	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) \
175	    -f CopyImportModules.gmk MODULE=$1)
176endef
177
178$(foreach m, $(IMPORT_COPY_MODULES), $(eval $(call DeclareImportCopyRecipe,$m)))
179
180ALL_TARGETS += $(ALL_COPY_TARGETS)
181
182################################################################################
183# Targets for compiling all java modules. Nashorn is treated separately.
184JAVA_MODULES := $(ALL_MODULES)
185JAVA_TARGETS := $(addsuffix -java, $(JAVA_MODULES))
186
187define DeclareCompileJavaRecipe
188  $1-java:
189	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) \
190	    -f CompileJavaModules.gmk MODULE=$1)
191endef
192
193$(foreach m, $(filter-out jdk.scripting.nashorn, $(JAVA_MODULES)), \
194    $(eval $(call DeclareCompileJavaRecipe,$m)))
195
196# Build nashorn. Needs to be compiled separately from the rest of the modules
197# due to nasgen.
198jdk.scripting.nashorn-java:
199	+($(CD) $(NASHORN_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) \
200	    -f BuildNashorn.gmk compile)
201
202ALL_TARGETS += $(JAVA_TARGETS)
203
204################################################################################
205# Targets for running rmic.
206$(eval $(call DeclareRecipesForPhase, RMIC, \
207    TARGET_SUFFIX := rmic, \
208    FILE_PREFIX := Rmic, \
209    MAKE_SUBDIR := rmic, \
210    CHECK_MODULES := $(ALL_MODULES)))
211
212ALL_TARGETS += $(RMIC_TARGETS)
213
214################################################################################
215# Targets for compiling native libraries
216$(eval $(call DeclareRecipesForPhase, LIBS, \
217    TARGET_SUFFIX := libs, \
218    FILE_PREFIX := Lib, \
219    MAKE_SUBDIR := lib, \
220    CHECK_MODULES := $(ALL_MODULES), \
221    USE_WRAPPER := true))
222
223ALL_TARGETS += $(LIBS_TARGETS)
224
225################################################################################
226# Targets for compiling native executables
227$(eval $(call DeclareRecipesForPhase, LAUNCHER, \
228    TARGET_SUFFIX := launchers, \
229    FILE_PREFIX := Launcher, \
230    MAKE_SUBDIR := launcher, \
231    CHECK_MODULES := $(ALL_MODULES), \
232    USE_WRAPPER := true))
233
234ALL_TARGETS += $(LAUNCHER_TARGETS)
235
236################################################################################
237# Build hotspot target
238
239ifeq ($(BUILD_HOTSPOT),true)
240  hotspot:
241	+($(CD) $(HOTSPOT_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f BuildHotspot.gmk)
242endif
243
244hotspot-ide-project:
245	+($(CD) $(HOTSPOT_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f ide/CreateVSProject.gmk)
246
247ALL_TARGETS += hotspot hotspot-ide-project
248
249################################################################################
250# Build demos and samples targets
251
252demos-jdk:
253	+($(CD) $(JDK_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CompileDemos.gmk)
254
255samples-jdk:
256	+($(CD) $(JDK_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f CopySamples.gmk)
257
258ALL_TARGETS += demos-jdk samples-jdk
259
260################################################################################
261# Jigsaw specific data and analysis targets.
262
263generate-summary:
264	+($(CD) $(JDK_TOPDIR)/make && $(MAKE) -f GenerateModuleSummary.gmk)
265
266ALL_TARGETS += generate-summary
267
268################################################################################
269# Jmod targets
270
271JMOD_MODULES := $(ALL_MODULES)
272JMOD_TARGETS := $(addsuffix -jmod, $(JMOD_MODULES))
273
274define DeclareJmodRecipe
275  $1-jmod:
276	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f CreateJmods.gmk \
277	    MODULE=$1)
278endef
279
280$(foreach m, $(JMOD_MODULES), $(eval $(call DeclareJmodRecipe,$m)))
281
282ALL_TARGETS += $(JMOD_TARGETS)
283
284################################################################################
285# Images targets
286
287# Stores the tips for each repository. This file is be used when constructing
288# the jdk image and can be used to track the exact sources used to build that
289# image.
290source-tips: $(SUPPORT_OUTPUTDIR)/source_tips
291$(SUPPORT_OUTPUTDIR)/source_tips: FRC
292	$(call MakeDir, $(@D))
293	$(call GetSourceTips)
294
295create-hgtip-files:
296	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f CreateHgtipFiles.gmk)
297
298BOOTCYCLE_TARGET := product-images
299bootcycle-images:
300        ifneq ($(COMPILE_TYPE), cross)
301	  $(call LogWarn, Boot cycle build step 2: Building a new JDK image using previously built image)
302	  +$(MAKE) -f $(SRC_ROOT)/make/Init.gmk PARALLEL_TARGETS=$(BOOTCYCLE_TARGET) \
303	      JOBS= SPEC=$(dir $(SPEC))bootcycle-spec.gmk main
304        else
305	  $(call LogWarn, Boot cycle build disabled when cross compiling)
306        endif
307
308zip-security:
309	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f ZipSecurity.gmk)
310
311zip-source:
312	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f ZipSource.gmk)
313
314jrtfs-jar:
315	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f JrtfsJar.gmk)
316
317jdk-image:
318	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Images.gmk jdk)
319
320jre-image:
321	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Images.gmk jre)
322
323symbols-image:
324	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Images.gmk symbols)
325
326profiles:
327	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Images.gmk profiles)
328
329mac-bundles-jdk:
330	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f MacBundles.gmk)
331
332exploded-image-optimize:
333	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f ExplodedImageOptimize.gmk)
334
335ALL_TARGETS += source-tips create-hgtip-files bootcycle-images zip-security \
336    zip-source jrtfs-jar jdk-image jre-image \
337    symbols-image profiles mac-bundles-jdk \
338    exploded-image-optimize
339
340################################################################################
341# Docs targets
342
343docs-javadoc:
344	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Javadoc.gmk docs-javadoc)
345
346docs-copy:
347	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Javadoc.gmk docs-copy)
348
349docs-zip:
350	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Javadoc.gmk docs-zip)
351
352ALL_TARGETS += docs-javadoc docs-copy docs-zip
353
354################################################################################
355# Cross compilation support
356
357ifeq ($(CREATING_BUILDJDK), true)
358  # This target is only called by the recursive call below.
359  create-buildjdk-interim-image-helper: interim-image jdk.jlink-launchers \
360      java.base-copy jdk.jdeps-launchers
361endif
362
363create-buildjdk-copy:
364	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f CreateBuildJdkCopy.gmk)
365
366create-buildjdk-interim-image:
367	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Main.gmk \
368	    $@-helper \
369	    SPEC=$(dir $(SPEC))buildjdk-spec.gmk \
370	    HOTSPOT_SPEC=$(dir $(SPEC))buildjdk-spec.gmk \
371	    CREATING_BUILDJDK=true)
372
373ALL_TARGETS += create-buildjdk-copy create-buildjdk-interim-image
374
375################################################################################
376# The interim-image is a small jlinked image that is used to generate artifacts
377# at build time for use when linking the real images.
378
379INTERIM_JMOD_TARGETS := $(addsuffix -interim-jmod, $(INTERIM_IMAGE_MODULES))
380
381define DeclareInterimJmodRecipe
382  $1-interim-jmod:
383	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f CreateJmods.gmk \
384	    MODULE=$1 \
385	    JMODS_DIR=$(INTERIM_JMODS_DIR) \
386	    JMODS_TEMPDIR=$(INTERIM_JMODS_DIR)/temp \
387	    INTERIM_JMOD=true \
388	)
389endef
390
391$(foreach m, $(INTERIM_IMAGE_MODULES), $(eval $(call DeclareInterimJmodRecipe,$m)))
392
393interim-image:
394	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f InterimImage.gmk)
395
396ifeq ($(ENABLE_GENERATE_CLASSLIST), true)
397  generate-link-opt-data:
398	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f GenerateLinkOptData.gmk)
399endif
400
401ALL_TARGETS += $(INTERIM_JMOD_TARGETS) interim-image generate-link-opt-data
402
403################################################################################
404# Build tests
405#
406
407prepare-test-image:
408	$(MKDIR) -p $(TEST_IMAGE_DIR)
409	$(ECHO) > $(TEST_IMAGE_DIR)/Readme.txt 'JDK test image'
410
411build-test-hotspot-jtreg-native:
412	+($(CD) $(HOTSPOT_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNative.gmk \
413	    build-test-hotspot-jtreg-native)
414
415test-image-hotspot-jtreg-native:
416	+($(CD) $(HOTSPOT_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNative.gmk \
417	    test-image-hotspot-jtreg-native)
418
419build-test-jdk-jtreg-native:
420	+($(CD) $(JDK_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNative.gmk \
421	    build-test-jdk-jtreg-native)
422
423test-image-jdk-jtreg-native:
424	+($(CD) $(JDK_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNative.gmk \
425	    test-image-jdk-jtreg-native)
426
427ifeq ($(BUILD_GTEST), true)
428  test-image-hotspot-gtest:
429	+($(CD) $(HOTSPOT_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f GtestImage.gmk)
430endif
431
432build-test-lib:
433	+($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f BuildTestLib.gmk)
434
435ifeq ($(BUILD_FAILURE_HANDLER), true)
436  # Builds the failure handler jtreg extension
437  build-test-failure-handler:
438	+($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) \
439	    -f BuildFailureHandler.gmk build)
440
441  # Runs the tests for the failure handler jtreg extension
442  test-failure-handler:
443	+($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) \
444	    -f BuildFailureHandler.gmk test)
445
446  # Copies the failure handler jtreg extension into the test image
447  test-image-failure-handler:
448	+($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) \
449	     -f BuildFailureHandler.gmk images)
450endif
451
452ALL_TARGETS += prepare-test-image build-test-hotspot-jtreg-native \
453    test-image-hotspot-jtreg-native build-test-jdk-jtreg-native \
454    test-image-jdk-jtreg-native build-test-lib build-test-failure-handler \
455    test-failure-handler test-image-failure-handler test-image-hotspot-gtest
456
457################################################################################
458# Run tests
459
460# Run tests specified by $(TEST), or the default test set.
461test:
462	$(call RunTests, $(TEST), $(JDK_IMAGE_DIR))
463
464test-hotspot-jtreg:
465	$(call RunTests, "hotspot_all", $(JDK_IMAGE_DIR))
466
467test-hotspot-jtreg-native:
468	$(call RunTests, "hotspot_native_sanity", $(JDK_IMAGE_DIR))
469
470test-hotspot-internal:
471	$(call RunTests, "hotspot_internal", $(JDK_OUTPUTDIR))
472
473test-hotspot-gtest:
474	$(call RunTests, "hotspot_gtest", $(JDK_OUTPUTDIR))
475
476test-jdk-jtreg-native:
477	$(call RunTests, "jdk_native_sanity", $(JDK_IMAGE_DIR))
478
479test-make:
480	($(CD) $(SRC_ROOT)/test/make && $(MAKE) $(MAKE_ARGS) -f TestMake.gmk $(TEST_TARGET))
481
482ALL_TARGETS += test test-hotspot-jtreg test-hotspot-jtreg-native \
483    test-hotspot-internal test-hotspot-gtest test-jdk-jtreg-native test-make
484
485################################################################################
486# Bundles
487
488product-bundles:
489	+($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk product-bundles)
490
491test-bundles:
492	+($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk test-bundles)
493
494docs-bundles:
495	+($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk docs-bundles)
496
497ALL_TARGETS += product-bundles test-bundles docs-bundles
498
499################################################################################
500# Install targets
501
502install:
503	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Install.gmk)
504
505ALL_TARGETS += install
506
507################################################################################
508#
509# Dependency declarations between targets.
510#
511# These are declared in two groups. First all dependencies between targets that
512# have recipes above as these dependencies may be disabled. Then the aggregator
513# targets that do not have recipes of their own, which will never have their
514# dependencies disabled.
515#
516################################################################################
517# Targets with recipes above
518
519# If running an *-only target, parallel execution and dependencies between
520# recipe targets are disabled. This makes it possible to run a select set of
521# recipe targets in order. It's the responsibility of the user to make sure
522# all prerequisites are fulfilled.
523ifneq ($(findstring -only, $(MAKECMDGOALS)), )
524  .NOTPARALLEL:
525else
526  $(LANGTOOLS_GENSRC_TARGETS): buildtools-langtools
527
528  interim-langtools: $(LANGTOOLS_GENSRC_TARGETS)
529
530  buildtools-jdk: interim-langtools interim-cldrconverter
531
532  buildtools-modules: exploded-image-base
533
534  $(CORBA_GENSRC_TARGETS): interim-langtools
535
536  $(HOTSPOT_GENSRC_TARGETS): interim-langtools
537
538  $(JDK_GENSRC_TARGETS): interim-langtools buildtools-jdk
539
540  $(GENSRC_MODULEINFO_TARGETS): buildtools-jdk
541
542  $(GENDATA_TARGETS): interim-langtools buildtools-jdk
543
544  interim-rmic: interim-langtools
545
546  $(RMIC_TARGETS): interim-langtools interim-rmic
547
548  $(JAVA_TARGETS): interim-langtools
549
550  hotspot-ide-project: hotspot exploded-image
551
552  generate-exported-symbols: java.base-libs jdk.jdwp.agent-libs
553
554  $(LIBS_TARGETS): hotspot
555
556  $(LAUNCHER_TARGETS): java.base-libs
557
558  ifeq ($(STATIC_BUILD), true)
559    $(LAUNCHER_TARGETS): generate-exported-symbols
560  endif
561
562  # The demos are currently linking to libjvm and libjava, just like all other
563  # jdk libs, even though they don't need to. To avoid warnings, make sure they
564  # aren't built until after libjava and libjvm are available to link to.
565  demos-jdk: java.base-libs exploded-image-optimize
566
567  # Declare dependency from <module>-java to <module>-gensrc
568  $(foreach m, $(GENSRC_MODULES), $(eval $m-java: $m-gensrc))
569
570  # Declare dependencies between java modules
571  $(foreach m, $(JAVA_MODULES), \
572      $(eval $m-java: $(addsuffix -java, $(filter $(JAVA_MODULES), \
573      $(call FindDepsForModule,$m)))))
574
575  # Declare dependencies between <module>-rmic to <module>-java
576  $(foreach m, $(RMIC_MODULES), $(eval $m-rmic: $m-java))
577
578  # Declare dependencies from <module>-lib to <module>-java
579  # Skip modules that do not have java source.
580  # When creating a BUILDJDK, the java compilation has already been done by the
581  # normal build and copied in.
582  ifneq ($(CREATING_BUILDJDK), true)
583    $(foreach m, $(filter $(JAVA_MODULES), $(LIBS_MODULES)), $(eval $m-libs: $m-java))
584  endif
585
586  # Declare dependencies from all other <module>-lib to java.base-lib
587  $(foreach t, $(filter-out java.base-libs, $(LIBS_TARGETS)), \
588      $(eval $t: java.base-libs))
589
590  # jdk.accessibility depends on java.desktop
591  jdk.accessibility-libs: java.desktop-libs
592
593  # This dependency needs to be explicitly declared. jdk.jdi-gensrc generates a
594  # header file used by jdk.jdwp.agent-libs. The jdk.jdwp.agent-gensrc is a
595  # virtual target.
596  jdk.jdwp.agent-libs: jdk.jdwp.agent-gensrc
597
598  # The swing beans need to have java base properly generated to avoid errors
599  # in javadoc.
600  java.desktop-gensrc-jdk: java.base-gensrc
601
602  # The annotation processing for jdk.vm.ci needs java.base classes from the
603  # current JDK.
604  jdk.vm.ci-gensrc-hotspot: java.base-java
605
606  # Explicitly add dependencies for special targets
607  java.base-java: unpack-sec
608
609  jdk.jdeps-gendata: java rmic
610
611  # Declare dependencies between jmod targets. Only java.base jmod needs access
612  # to the other jmods to be built.
613  # When creating a BUILDJDK, we don't need to add hashes to java.base, thus
614  # we don't need to depend on all other jmods
615  ifneq ($(CREATING_BUILDJDK), true)
616    java.base-jmod: $(filter-out java.base-jmod \
617        $(addsuffix -jmod, $(call FindAllUpgradeableModules)), $(JMOD_TARGETS))
618  endif
619
620  # Declare dependencies from <module>-jmod to all other module targets
621  # When creating a BUILDJDK, the java compilation has already been done by the
622  # normal build and copied in.
623  ifneq ($(CREATING_BUILDJDK), true)
624    $(foreach m, $(JAVA_MODULES), $(eval $m_JMOD_DEPS += $m-java))
625  endif
626  $(foreach m, $(GENDATA_MODULES), $(eval $m_JMOD_DEPS += $m-gendata))
627  $(foreach m, $(RMIC_MODULES), $(eval $m_JMOD_DEPS += $m-rmic))
628  $(foreach m, $(LIBS_MODULES), $(eval $m_JMOD_DEPS += $m-libs))
629  $(foreach m, $(LAUNCHER_MODULES), $(eval $m_JMOD_DEPS += $m-launchers))
630  $(foreach m, $(COPY_MODULES), $(eval $m_JMOD_DEPS += $m-copy))
631  $(foreach m, $(ALL_MODULES), $(eval $m-jmod: $($(m)_JMOD_DEPS)))
632  $(foreach m, $(INTERIM_IMAGE_MODULES), $(eval $m-interim-jmod: $($(m)_JMOD_DEPS)))
633
634  # Jmods cannot be created until we have the jmod tool ready to run. During
635  # a normal build we run it from the exploded image, but when cross compiling
636  # it's run from the buildjdk, which is either created at build time or user
637  # supplied.
638  #
639  # For the exploded image to be runnable, all java modules and
640  # jdk.jlink-launchers need to be built. We also need to copy jvm.cfg (done
641  # in java.base-copy) and tzdb.dat (done in java.base-gendata) to the
642  # appropriate location otherwise jimage, jlink and jmod won't start. This
643  # also applies when creating the buildjdk.
644  DEFAULT_JMOD_DEPS := java.base-libs java.base-copy java.base-gendata \
645      jdk.jlink-launchers
646  # When cross compiling and buildjdk is to be created, depend on creating the
647  # buildjdk instead of the default dependencies.
648  ifeq ($(CREATE_BUILDJDK), true)
649    # Avoid calling create-buildjdk from within a create-buildjdk call.
650    ifneq ($(CREATING_BUILDJDK), true)
651      $(JMOD_TARGETS): create-buildjdk
652      buildtools-modules: create-buildjdk
653    else
654      # While actually creating the buildjdk, the default deps applies.
655      $(JMOD_TARGETS) $(INTERIM_JMOD_TARGETS): $(DEFAULT_JMOD_DEPS)
656    endif
657  else
658    # The normal non cross compilation case uses the default deps.
659    # To avoid races with the optimize target, that also needs to happen first.
660    $(JMOD_TARGETS) $(INTERIM_JMOD_TARGETS): $(DEFAULT_JMOD_DEPS) \
661        exploded-image-optimize
662  endif
663
664  zip-security: java.base-java java.security.jgss-java java.security.jgss-libs \
665      $(filter jdk.crypto%, $(JAVA_TARGETS))
666
667  zip-source: gensrc rmic
668
669  jrtfs-jar: interim-langtools
670
671  ifeq ($(ENABLE_GENERATE_CLASSLIST), true)
672    ifeq ($(CREATE_BUILDJDK), true)
673      # If creating a buildjdk, the interim image needs to be based on that.
674      generate-link-opt-data: create-buildjdk
675    else ifeq ($(EXTERNAL_BUILDJDK), false)
676      # If an external buildjdk has been provided, we skip generating an
677      # interim-image and just use the external buildjdk for generating
678      # classlist.
679      generate-link-opt-data: interim-image
680    endif
681    generate-link-opt-data: buildtools-jdk
682
683    # The generated classlist needs to go into java.base-jmod.
684    java.base-jmod jdk-image jre-image: generate-link-opt-data
685  endif
686
687  jdk-image: jmods zip-source source-tips demos samples jrtfs-jar
688  jre-image: jmods source-tips jrtfs-jar
689
690  profiles: jmods zip-source source-tips jrtfs-jar
691
692  mac-bundles-jdk: jdk-image jre-image
693
694  # The optimize target can run as soon as the modules dir has been completely
695  # populated (java, copy and gendata targets) and the basic libs and launchers
696  # have been built.
697  exploded-image-optimize: java copy gendata java.base-libs java.base-launchers \
698      buildtools-modules
699
700  bootcycle-images: jdk-image
701
702  docs-javadoc: $(GENSRC_TARGETS) rmic
703
704  # The gensrc step for jdk.jdi creates an html file that is used by docs-copy.
705  docs-copy: hotspot jdk.jdi-gensrc
706
707  docs-zip: docs-javadoc docs-copy
708
709  test: jdk-image test-image
710
711  create-buildjdk-copy: jdk.jlink-java java.base-gendata \
712      $(addsuffix -java, $(INTERIM_IMAGE_MODULES))
713
714  create-buildjdk-interim-image: create-buildjdk-copy
715
716  interim-image: $(INTERIM_JMOD_TARGETS)
717
718  test-make: clean-test-make
719
720  build-test-lib: exploded-image-optimize
721
722  build-test-failure-handler: interim-langtools
723
724  test-failure-handler: build-test-failure-handler
725
726  test-image-failure-handler: build-test-failure-handler
727
728  build-test-hotspot-jtreg-native: buildtools-jdk hotspot
729
730  build-test-jdk-jtreg-native: buildtools-jdk
731
732  test-image-hotspot-jtreg-native: build-test-hotspot-jtreg-native
733
734  test-image-jdk-jtreg-native: build-test-jdk-jtreg-native
735
736  test-image-hotspot-gtest: hotspot
737
738  test-hotspot-internal: exploded-image
739
740  test-hotspot-jtreg: jdk-image test-image
741
742  test-hotspot-gtest: exploded-image test-image-hotspot-gtest
743
744  install: product-images
745
746  product-bundles: product-images
747
748  test-bundles: test-image
749
750  docs-bundles: docs-image
751
752  generate-summary: jmods buildtools-modules
753
754endif
755
756################################################################################
757# Virtual targets without recipes
758
759buildtools: buildtools-langtools interim-langtools interim-rmic \
760    buildtools-jdk
761
762gensrc: $(GENSRC_TARGETS)
763
764gendata: $(GENDATA_TARGETS)
765
766copy: $(ALL_COPY_TARGETS)
767
768java: $(JAVA_TARGETS)
769
770rmic: $(RMIC_TARGETS)
771
772libs: $(LIBS_TARGETS)
773
774launchers: $(LAUNCHER_TARGETS)
775
776jmods: $(JMOD_TARGETS)
777
778# Explicitly declare dependency for virtual target jdk.jdwp.agent-gensrc which
779# is actually handled by jdk.jdi-gensrc
780jdk.jdwp.agent-gensrc: jdk.jdi-gensrc
781
782# Declare dependencies from <module> to all the individual targets specific
783# to that module <module>-*, that are needed for the exploded image.
784$(foreach m, $(GENSRC_MODULES), $(eval $m: $m-gensrc))
785$(foreach m, $(JAVA_MODULES), $(eval $m: $m-java))
786$(foreach m, $(GENDATA_MODULES), $(eval $m: $m-gendata))
787$(foreach m, $(RMIC_MODULES), $(eval $m: $m-rmic))
788$(foreach m, $(LIBS_MODULES), $(eval $m: $m-libs))
789$(foreach m, $(LAUNCHER_MODULES), $(eval $m: $m-launchers))
790$(foreach m, $(ALL_COPY_MODULES), $(eval $m: $m-copy))
791demos: demos-jdk
792
793samples: samples-jdk
794
795# The "exploded image" is a locally runnable JDK in $(BUILD_OUTPUT)/jdk.
796exploded-image-base: $(ALL_MODULES)
797exploded-image: exploded-image-base
798# When cross compiling, no need to optimize the exploded image since it won't
799# be runnable on the host platform anyway.
800ifneq ($(COMPILE_TYPE), cross)
801  exploded-image: exploded-image-optimize
802endif
803
804create-buildjdk: create-buildjdk-copy create-buildjdk-interim-image
805
806mac-bundles: mac-bundles-jdk
807
808# The $(BUILD_OUTPUT)/images directory contain the resulting deliverables,
809# and in line with this, our targets for creating these are named *-image[s].
810
811# This target builds the product images, e.g. the JRE and JDK image
812# (and possibly other, more specific versions)
813product-images: jdk-image jre-image symbols-image exploded-image
814
815# zip-security is actually a bundle, but for now it needs to be considered
816# an image until this can be cleaned up properly.
817product-images: zip-security
818
819# The module summary cannot be run when:
820# * Cross compiling and building a partial BUILDJDK for the build host
821# * An external buildjdk has been supplied since it may not match the
822#   module selection of the target jdk
823ifneq ($(CREATE_BUILDJDK), true)
824  ifeq ($(EXTERNAL_BUILDJDK), false)
825    product-images: generate-summary
826  endif
827endif
828
829ifeq ($(OPENJDK_TARGET_OS), macosx)
830  product-images: mac-bundles
831endif
832
833# This target builds the documentation image
834docs-image: docs-javadoc docs-copy
835
836# This target builds the test image
837test-image: prepare-test-image test-image-hotspot-jtreg-native \
838    test-image-jdk-jtreg-native test-image-failure-handler test-image-hotspot-gtest
839
840# all-images builds all our deliverables as images.
841all-images: product-images test-image docs-image
842
843# all-bundles packages all our deliverables as tar.gz bundles.
844all-bundles: product-bundles test-bundles docs-bundles
845
846ALL_TARGETS += buildtools gensrc gendata copy java rmic libs launchers jmods \
847    jdk.jdwp.agent-gensrc $(ALL_MODULES) demos samples \
848    exploded-image-base exploded-image \
849    create-buildjdk mac-bundles product-images docs-image test-image all-images \
850    all-bundles
851
852################################################################################
853
854# Traditional targets typically run by users.
855# These can be considered aliases for the targets now named by a more
856# "modern" naming scheme.
857default: $(DEFAULT_MAKE_TARGET)
858jdk: exploded-image
859images: product-images
860docs: docs-image
861bundles: all-bundles
862all: all-images
863
864ALL_TARGETS += default jdk images docs bundles all
865
866################################################################################
867################################################################################
868#
869# Clean targets
870#
871################################################################################
872# Clean targets are automatically run serially by the Makefile calling this
873# file.
874
875CLEAN_DIRS += hotspot jdk bootcycle-build test buildtools support \
876    images make-support test-make bundles buildjdk
877CLEAN_DIR_TARGETS := $(addprefix clean-, $(CLEAN_DIRS))
878CLEAN_SUPPORT_DIRS += demos
879CLEAN_SUPPORT_DIR_TARGETS := $(addprefix clean-, $(CLEAN_SUPPORT_DIRS))
880CLEAN_TESTS += hotspot-jtreg-native jdk-jtreg-native lib
881CLEAN_TEST_TARGETS += $(addprefix clean-test-, $(CLEAN_TESTS))
882CLEAN_PHASES := gensrc java native include
883CLEAN_PHASE_TARGETS := $(addprefix clean-, $(CLEAN_PHASES))
884CLEAN_MODULE_TARGETS := $(addprefix clean-, $(ALL_MODULES))
885# Construct targets of the form clean-$module-$phase
886CLEAN_MODULE_PHASE_TARGETS := $(addprefix clean-, $(foreach m, $(ALL_MODULES), \
887    $(addprefix $m-, $(CLEAN_PHASES))))
888
889# Remove everything, except the output from configure.
890clean: $(CLEAN_DIR_TARGETS)
891	($(CD) $(OUTPUT_ROOT) && $(RM) -r build*.log*)
892	$(ECHO) Cleaned all build artifacts.
893
894clean-docs:
895	$(call CleanDocs)
896
897$(CLEAN_DIR_TARGETS):
898	$(call CleanDir,$(patsubst clean-%, %, $@))
899
900$(CLEAN_SUPPORT_DIR_TARGETS):
901	$(call CleanSupportDir,$(patsubst clean-%, %, $@))
902
903$(CLEAN_TEST_TARGETS):
904	$(call CleanTest,$(patsubst clean-test-%, %, $@))
905
906$(CLEAN_PHASE_TARGETS):
907	$(call Clean-$(patsubst clean-%,%, $@))
908
909$(CLEAN_MODULE_TARGETS):
910	$(call CleanModule,$(patsubst clean-%, %, $@))
911
912$(CLEAN_MODULE_PHASE_TARGETS):
913	$(call Clean-$(word 3, $(subst -,$(SPACE),$@)), \
914	    $(word 2, $(subst -,$(SPACE),$@)))
915
916# When removing the support dir, we must also remove jdk. Building classes has
917# the side effect of generating native headers. The headers end up in support
918# while classes and touch files end up in jdk.
919clean-support: clean-jdk
920
921# Remove everything, including configure configuration. If the output
922# directory was created by configure and now becomes empty, remove it as well.
923dist-clean: clean
924	($(CD) $(OUTPUT_ROOT) && \
925	    $(RM) -r *spec.gmk $(CONFIGURESUPPORT_OUTPUTDIR) Makefile compare.sh ide)
926	$(if $(filter $(CONF_NAME),$(notdir $(OUTPUT_ROOT))), \
927	  if test "x`$(LS) $(OUTPUT_ROOT)`" != x; then \
928	    $(ECHO) "Warning: Not removing non-empty configuration directory for '$(CONF_NAME)'" ; \
929	  else \
930	    ($(CD) $(SRC_ROOT) && $(ECHO) "Removing configuration directory for '$(CONF_NAME)'" \
931	        && $(RM) -r $(OUTPUT_ROOT)) \
932	  fi \
933	)
934	$(ECHO) Cleaned everything, you will have to re-run configure.
935
936ALL_TARGETS += clean clean-docs dist-clean $(CLEAN_DIR_TARGETS) $(CLEAN_SUPPORT_DIR_TARGETS) \
937    $(CLEAN_TEST_TARGETS) $(CLEAN_PHASE_TARGETS) $(CLEAN_MODULE_TARGETS) \
938    $(CLEAN_MODULE_PHASE_TARGETS)
939
940################################################################################
941# Declare *-only targets for each normal target
942$(foreach t, $(ALL_TARGETS), $(eval $(t)-only: $(t)))
943
944ALL_TARGETS += $(addsuffix -only, $(filter-out dist-clean clean%, $(ALL_TARGETS)))
945
946################################################################################
947
948# Include JPRT targets
949include $(SRC_ROOT)/make/Jprt.gmk
950
951################################################################################
952
953# The following targets are intentionally not added to ALL_TARGETS since they
954# are internal only, to support Init.gmk.
955
956print-targets:
957	  @$(ECHO) $(sort $(ALL_TARGETS))
958
959print-modules:
960	  @$(ECHO) $(sort $(ALL_MODULES))
961
962create-main-targets-include:
963	  $(call LogInfo, Generating main target list)
964	  @$(ECHO) ALL_MAIN_TARGETS := $(sort $(ALL_TARGETS)) > \
965	      $(MAKESUPPORT_OUTPUTDIR)/main-targets.gmk
966
967################################################################################
968
969.PHONY: $(ALL_TARGETS)
970
971FRC: # Force target
972