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