Main.gmk revision 2309:7b791b507f9b
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-image:
380	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f InterimImage.gmk)
381
382ifeq ($(ENABLE_GENERATE_CLASSLIST), true)
383  generate-classlist:
384	+($(CD) $(JDK_TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f GenerateClasslist.gmk)
385endif
386
387ALL_TARGETS += interim-image generate-classlist
388
389################################################################################
390# Build tests
391#
392
393prepare-test-image:
394	$(MKDIR) -p $(TEST_IMAGE_DIR)
395	$(ECHO) > $(TEST_IMAGE_DIR)/Readme.txt 'JDK test image'
396
397build-test-hotspot-jtreg-native:
398	+($(CD) $(HOTSPOT_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNative.gmk \
399	    build-test-hotspot-jtreg-native)
400
401test-image-hotspot-jtreg-native:
402	+($(CD) $(HOTSPOT_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNative.gmk \
403	    test-image-hotspot-jtreg-native)
404
405build-test-jdk-jtreg-native:
406	+($(CD) $(JDK_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNative.gmk \
407	    build-test-jdk-jtreg-native)
408
409test-image-jdk-jtreg-native:
410	+($(CD) $(JDK_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f JtregNative.gmk \
411	    test-image-jdk-jtreg-native)
412
413ifeq ($(BUILD_GTEST), true)
414  test-image-hotspot-gtest:
415	+($(CD) $(HOTSPOT_TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f GtestImage.gmk)
416endif
417
418build-test-lib:
419	+($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f BuildTestLib.gmk)
420
421ifeq ($(BUILD_FAILURE_HANDLER), true)
422  # Builds the failure handler jtreg extension
423  build-test-failure-handler:
424	+($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) \
425	    -f BuildFailureHandler.gmk build)
426
427  # Runs the tests for the failure handler jtreg extension
428  test-failure-handler:
429	+($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) \
430	    -f BuildFailureHandler.gmk test)
431
432  # Copies the failure handler jtreg extension into the test image
433  test-image-failure-handler:
434	+($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) \
435	     -f BuildFailureHandler.gmk images)
436endif
437
438ALL_TARGETS += prepare-test-image build-test-hotspot-jtreg-native \
439    test-image-hotspot-jtreg-native build-test-jdk-jtreg-native \
440    test-image-jdk-jtreg-native build-test-lib build-test-failure-handler \
441    test-failure-handler test-image-failure-handler test-image-hotspot-gtest
442
443################################################################################
444# Run tests
445
446# Run tests specified by $(TEST), or the default test set.
447test:
448	$(call RunTests, $(TEST), $(JDK_IMAGE_DIR))
449
450test-hotspot-jtreg:
451	$(call RunTests, "hotspot_all", $(JDK_IMAGE_DIR))
452
453test-hotspot-jtreg-native:
454	$(call RunTests, "hotspot_native_sanity", $(JDK_IMAGE_DIR))
455
456test-hotspot-internal:
457	$(call RunTests, "hotspot_internal", $(JDK_OUTPUTDIR))
458
459test-hotspot-gtest:
460	$(call RunTests, "hotspot_gtest", $(JDK_OUTPUTDIR))
461
462test-jdk-jtreg-native:
463	$(call RunTests, "jdk_native_sanity", $(JDK_IMAGE_DIR))
464
465test-make:
466	($(CD) $(SRC_ROOT)/test/make && $(MAKE) $(MAKE_ARGS) -f TestMake.gmk $(TEST_TARGET))
467
468ALL_TARGETS += test test-hotspot-jtreg test-hotspot-jtreg-native \
469    test-hotspot-internal test-hotspot-gtest test-jdk-jtreg-native test-make
470
471################################################################################
472# Bundles
473
474product-bundles:
475	+($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk product-bundles)
476
477test-bundles:
478	+($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk test-bundles)
479
480docs-bundles:
481	+($(CD) $(TOPDIR)/make && $(MAKE) $(MAKE_ARGS) -f Bundles.gmk docs-bundles)
482
483ALL_TARGETS += product-bundles test-bundles docs-bundles
484
485################################################################################
486# Install targets
487
488install:
489	+($(CD) $(SRC_ROOT)/make && $(MAKE) $(MAKE_ARGS) -f Install.gmk)
490
491ALL_TARGETS += install
492
493################################################################################
494#
495# Dependency declarations between targets.
496#
497# These are declared in two groups. First all dependencies between targets that
498# have recipes above as these dependencies may be disabled. Then the aggregator
499# targets that do not have recipes of their own, which will never have their
500# dependencies disabled.
501#
502################################################################################
503# Targets with recipes above
504
505# If running an *-only target, parallel execution and dependencies between
506# recipe targets are disabled. This makes it possible to run a select set of
507# recipe targets in order. It's the responsibility of the user to make sure
508# all prerequisites are fulfilled.
509ifneq ($(findstring -only, $(MAKECMDGOALS)), )
510  .NOTPARALLEL:
511else
512  $(LANGTOOLS_GENSRC_TARGETS): buildtools-langtools
513
514  interim-langtools: $(LANGTOOLS_GENSRC_TARGETS)
515
516  buildtools-jdk: interim-langtools interim-cldrconverter
517
518  buildtools-modules: exploded-image-base
519
520  $(CORBA_GENSRC_TARGETS): interim-langtools
521
522  $(HOTSPOT_GENSRC_TARGETS): interim-langtools
523
524  $(JDK_GENSRC_TARGETS): interim-langtools buildtools-jdk
525
526  $(GENSRC_MODULEINFO_TARGETS): buildtools-jdk
527
528  $(GENDATA_TARGETS): interim-langtools buildtools-jdk
529
530  interim-rmic: interim-langtools
531
532  $(RMIC_TARGETS): interim-langtools interim-rmic
533
534  $(JAVA_TARGETS): interim-langtools
535
536  hotspot-ide-project: hotspot exploded-image
537
538  generate-exported-symbols: java.base-libs jdk.jdwp.agent-libs
539
540  $(LIBS_TARGETS): hotspot
541
542  $(LAUNCHER_TARGETS): java.base-libs
543
544  ifeq ($(STATIC_BUILD), true)
545    $(LAUNCHER_TARGETS): generate-exported-symbols
546  endif
547
548  # The demos are currently linking to libjvm and libjava, just like all other
549  # jdk libs, even though they don't need to. To avoid warnings, make sure they
550  # aren't built until after libjava and libjvm are available to link to.
551  demos-jdk: java.base-libs exploded-image-optimize
552
553  # Declare dependency from <module>-java to <module>-gensrc
554  $(foreach m, $(GENSRC_MODULES), $(eval $m-java: $m-gensrc))
555
556  # Declare dependencies between java modules
557  $(foreach m, $(JAVA_MODULES), \
558      $(eval $m-java: $(addsuffix -java, $(filter $(JAVA_MODULES), \
559      $(call FindDepsForModule,$m)))))
560
561  # Declare dependencies between <module>-rmic to <module>-java
562  $(foreach m, $(RMIC_MODULES), $(eval $m-rmic: $m-java))
563
564  # Declare dependencies from <module>-lib to <module>-java
565  # Skip modules that do not have java source.
566  # When creating a BUILDJDK, the java compilation has already been done by the
567  # normal build and copied in.
568  ifneq ($(CREATING_BUILDJDK), true)
569    $(foreach m, $(filter $(JAVA_MODULES), $(LIBS_MODULES)), $(eval $m-libs: $m-java))
570  endif
571
572  # Declare dependencies from all other <module>-lib to java.base-lib
573  $(foreach t, $(filter-out java.base-libs, $(LIBS_TARGETS)), \
574      $(eval $t: java.base-libs))
575
576  # jdk.accessibility depends on java.desktop
577  jdk.accessibility-libs: java.desktop-libs
578
579  # This dependency needs to be explicitly declared. jdk.jdi-gensrc generates a
580  # header file used by jdk.jdwp.agent-libs. The jdk.jdwp.agent-gensrc is a
581  # virtual target.
582  jdk.jdwp.agent-libs: jdk.jdwp.agent-gensrc
583
584  # The swing beans need to have java base properly generated to avoid errors
585  # in javadoc.
586  java.desktop-gensrc-jdk: java.base-gensrc
587
588  # The annotation processing for jdk.vm.ci needs java.base classes from the
589  # current JDK.
590  jdk.vm.ci-gensrc-hotspot: java.base-java
591
592  # Explicitly add dependencies for special targets
593  java.base-java: unpack-sec
594
595  jdk.jdeps-gendata: java rmic
596
597  # Declare dependencies between jmod targets. Only java.base jmod needs access
598  # to the other jmods to be built.
599  # When creating a BUILDJDK, we don't need to add hashes to java.base, thus
600  # we don't need to depend on all other jmods
601  ifneq ($(CREATING_BUILDJDK), true)
602    java.base-jmod: $(filter-out java.base-jmod \
603        $(addsuffix -jmod, $(call FindAllUpgradeableModules)), $(JMOD_TARGETS))
604  endif
605
606  # Declare dependencies from <module>-jmod to all other module targets
607  # When creating a BUILDJDK, the java compilation has already been done by the
608  # normal build and copied in.
609  ifneq ($(CREATING_BUILDJDK), true)
610    $(foreach m, $(JAVA_MODULES), $(eval $m-jmod: $m-java))
611  endif
612  $(foreach m, $(GENDATA_MODULES), $(eval $m-jmod: $m-gendata))
613  $(foreach m, $(RMIC_MODULES), $(eval $m-jmod: $m-rmic))
614  $(foreach m, $(LIBS_MODULES), $(eval $m-jmod: $m-libs))
615  $(foreach m, $(LAUNCHER_MODULES), $(eval $m-jmod: $m-launchers))
616  $(foreach m, $(COPY_MODULES), $(eval $m-jmod: $m-copy))
617
618  # Jmods cannot be created until we have the jmod tool ready to run. During
619  # a normal build we run it from the exploded image, but when cross compiling
620  # it's run from the buildjdk, which is either created at build time or user
621  # supplied.
622  #
623  # For the exploded image to be runnable, all java modules and
624  # jdk.jlink-launchers need to be built. We also need to copy jvm.cfg (done
625  # in java.base-copy) and tzdb.dat (done in java.base-gendata) to the
626  # appropriate location otherwise jimage, jlink and jmod won't start. This
627  # also applies when creating the buildjdk.
628  DEFAULT_JMOD_DEPS := java.base-libs java.base-copy java.base-gendata \
629      jdk.jlink-launchers
630  # When cross compiling and buildjdk is to be created, depend on creating the
631  # buildjdk instead of the default dependencies.
632  ifeq ($(CREATE_BUILDJDK), true)
633    # Avoid calling create-buildjdk from within a create-buildjdk call.
634    ifneq ($(CREATING_BUILDJDK), true)
635      $(JMOD_TARGETS): create-buildjdk
636      buildtools-modules: create-buildjdk
637    else
638      # While actually creating the buildjdk, the default deps applies.
639      $(JMOD_TARGETS): $(DEFAULT_JMOD_DEPS)
640    endif
641  else
642    # The normal non cross compilation case uses the default deps.
643    # To avoid races with the optimize target, that also needs to happen first.
644    $(JMOD_TARGETS): $(DEFAULT_JMOD_DEPS) exploded-image-optimize
645  endif
646
647  zip-security: java.base-java java.security.jgss-java java.security.jgss-libs \
648      $(filter jdk.crypto%, $(JAVA_TARGETS))
649
650  zip-source: gensrc rmic
651
652  jrtfs-jar: interim-langtools
653
654  ifeq ($(ENABLE_GENERATE_CLASSLIST), true)
655    ifeq ($(CREATE_BUILDJDK), true)
656      # If creating a buildjdk, the interim image needs to be based on that.
657      generate-classlist: create-buildjdk
658    else ifeq ($(EXTERNAL_BUILDJDK), false)
659      # If an external buildjdk has been provided, we skip generating an
660      # interim-image and just use the external buildjdk for generating
661      # classlist.
662      generate-classlist: interim-image
663    endif
664    generate-classlist: buildtools-jdk
665
666    jdk-image jre-image: generate-classlist
667  endif
668
669  jdk-image: jmods zip-source source-tips demos samples jrtfs-jar
670  jre-image: jmods source-tips jrtfs-jar
671
672  profiles: jmods zip-source source-tips jrtfs-jar
673
674  mac-bundles-jdk: jdk-image jre-image
675
676  # The optimize target can run as soon as the modules dir has been completely
677  # populated (java, copy and gendata targets) and the basic libs and launchers
678  # have been built.
679  exploded-image-optimize: java copy gendata java.base-libs java.base-launchers \
680      buildtools-modules
681
682  bootcycle-images: jdk-image
683
684  docs-javadoc: $(GENSRC_TARGETS) rmic
685
686  # The gensrc step for jdk.jdi creates an html file that is used by docs-copy.
687  docs-copy: hotspot jdk.jdi-gensrc
688
689  docs-zip: docs-javadoc docs-copy
690
691  test: jdk-image test-image
692
693  create-buildjdk-copy: jdk.jlink-java java.base-gendata \
694      $(addsuffix -java, $(INTERIM_IMAGE_MODULES))
695
696  create-buildjdk-interim-image: create-buildjdk-copy
697
698  interim-image: $(addsuffix -jmod, $(INTERIM_IMAGE_MODULES))
699
700  test-make: clean-test-make
701
702  build-test-lib: exploded-image-optimize
703
704  build-test-failure-handler: interim-langtools
705
706  test-failure-handler: build-test-failure-handler
707
708  test-image-failure-handler: build-test-failure-handler
709
710  build-test-hotspot-jtreg-native: buildtools-jdk hotspot
711
712  build-test-jdk-jtreg-native: buildtools-jdk
713
714  test-image-hotspot-jtreg-native: build-test-hotspot-jtreg-native
715
716  test-image-jdk-jtreg-native: build-test-jdk-jtreg-native
717
718  test-image-hotspot-gtest: hotspot
719
720  test-hotspot-internal: exploded-image
721
722  test-hotspot-jtreg: jdk-image test-image
723
724  test-hotspot-gtest: exploded-image test-image-hotspot-gtest
725
726  install: product-images
727
728  product-bundles: product-images
729
730  test-bundles: test-image
731
732  docs-bundles: docs-image
733
734  generate-summary: jmods buildtools-modules
735
736endif
737
738################################################################################
739# Virtual targets without recipes
740
741buildtools: buildtools-langtools interim-langtools interim-rmic \
742    buildtools-jdk
743
744gensrc: $(GENSRC_TARGETS)
745
746gendata: $(GENDATA_TARGETS)
747
748copy: $(ALL_COPY_TARGETS)
749
750java: $(JAVA_TARGETS)
751
752rmic: $(RMIC_TARGETS)
753
754libs: $(LIBS_TARGETS)
755
756launchers: $(LAUNCHER_TARGETS)
757
758jmods: $(JMOD_TARGETS)
759
760# Explicitly declare dependency for virtual target jdk.jdwp.agent-gensrc which
761# is actually handled by jdk.jdi-gensrc
762jdk.jdwp.agent-gensrc: jdk.jdi-gensrc
763
764# Declare dependencies from <module> to all the individual targets specific
765# to that module <module>-*, that are needed for the exploded image.
766$(foreach m, $(GENSRC_MODULES), $(eval $m: $m-gensrc))
767$(foreach m, $(JAVA_MODULES), $(eval $m: $m-java))
768$(foreach m, $(GENDATA_MODULES), $(eval $m: $m-gendata))
769$(foreach m, $(RMIC_MODULES), $(eval $m: $m-rmic))
770$(foreach m, $(LIBS_MODULES), $(eval $m: $m-libs))
771$(foreach m, $(LAUNCHER_MODULES), $(eval $m: $m-launchers))
772$(foreach m, $(ALL_COPY_MODULES), $(eval $m: $m-copy))
773demos: demos-jdk
774
775samples: samples-jdk
776
777# The "exploded image" is a locally runnable JDK in $(BUILD_OUTPUT)/jdk.
778exploded-image-base: $(ALL_MODULES)
779exploded-image: exploded-image-base
780# When cross compiling, no need to optimize the exploded image since it won't
781# be runnable on the host platform anyway.
782ifneq ($(COMPILE_TYPE), cross)
783  exploded-image: exploded-image-optimize
784endif
785
786create-buildjdk: create-buildjdk-copy create-buildjdk-interim-image
787
788mac-bundles: mac-bundles-jdk
789
790# The $(BUILD_OUTPUT)/images directory contain the resulting deliverables,
791# and in line with this, our targets for creating these are named *-image[s].
792
793# This target builds the product images, e.g. the JRE and JDK image
794# (and possibly other, more specific versions)
795product-images: jdk-image jre-image symbols-image exploded-image
796
797# zip-security is actually a bundle, but for now it needs to be considered
798# an image until this can be cleaned up properly.
799product-images: zip-security
800
801# The module summary cannot be run when:
802# * Cross compiling and building a partial BUILDJDK for the build host
803# * An external buildjdk has been supplied since it may not match the
804#   module selection of the target jdk
805ifneq ($(CREATE_BUILDJDK), true)
806  ifeq ($(EXTERNAL_BUILDJDK), false)
807    product-images: generate-summary
808  endif
809endif
810
811ifeq ($(OPENJDK_TARGET_OS), macosx)
812  product-images: mac-bundles
813endif
814
815# This target builds the documentation image
816docs-image: docs-javadoc docs-copy
817
818# This target builds the test image
819test-image: prepare-test-image test-image-hotspot-jtreg-native \
820    test-image-jdk-jtreg-native test-image-failure-handler test-image-hotspot-gtest
821
822# all-images builds all our deliverables as images.
823all-images: product-images test-image docs-image
824
825# all-bundles packages all our deliverables as tar.gz bundles.
826all-bundles: product-bundles test-bundles docs-bundles
827
828ALL_TARGETS += buildtools gensrc gendata copy java rmic libs launchers jmods \
829    jdk.jdwp.agent-gensrc $(ALL_MODULES) demos samples \
830    exploded-image-base exploded-image \
831    create-buildjdk mac-bundles product-images docs-image test-image all-images \
832    all-bundles
833
834################################################################################
835
836# Traditional targets typically run by users.
837# These can be considered aliases for the targets now named by a more
838# "modern" naming scheme.
839default: $(DEFAULT_MAKE_TARGET)
840jdk: exploded-image
841images: product-images
842docs: docs-image
843bundles: all-bundles
844all: all-images
845
846ALL_TARGETS += default jdk images docs bundles all
847
848################################################################################
849################################################################################
850#
851# Clean targets
852#
853################################################################################
854# Clean targets are automatically run serially by the Makefile calling this
855# file.
856
857CLEAN_DIRS += hotspot jdk bootcycle-build test buildtools support \
858    images make-support test-make bundles buildjdk
859CLEAN_DIR_TARGETS := $(addprefix clean-, $(CLEAN_DIRS))
860CLEAN_SUPPORT_DIRS += demos
861CLEAN_SUPPORT_DIR_TARGETS := $(addprefix clean-, $(CLEAN_SUPPORT_DIRS))
862CLEAN_TESTS += hotspot-jtreg-native jdk-jtreg-native lib
863CLEAN_TEST_TARGETS += $(addprefix clean-test-, $(CLEAN_TESTS))
864CLEAN_PHASES := gensrc java native include
865CLEAN_PHASE_TARGETS := $(addprefix clean-, $(CLEAN_PHASES))
866CLEAN_MODULE_TARGETS := $(addprefix clean-, $(ALL_MODULES))
867# Construct targets of the form clean-$module-$phase
868CLEAN_MODULE_PHASE_TARGETS := $(addprefix clean-, $(foreach m, $(ALL_MODULES), \
869    $(addprefix $m-, $(CLEAN_PHASES))))
870
871# Remove everything, except the output from configure.
872clean: $(CLEAN_DIR_TARGETS)
873	($(CD) $(OUTPUT_ROOT) && $(RM) -r build*.log*)
874	$(ECHO) Cleaned all build artifacts.
875
876clean-docs:
877	$(call CleanDocs)
878
879$(CLEAN_DIR_TARGETS):
880	$(call CleanDir,$(patsubst clean-%, %, $@))
881
882$(CLEAN_SUPPORT_DIR_TARGETS):
883	$(call CleanSupportDir,$(patsubst clean-%, %, $@))
884
885$(CLEAN_TEST_TARGETS):
886	$(call CleanTest,$(patsubst clean-test-%, %, $@))
887
888$(CLEAN_PHASE_TARGETS):
889	$(call Clean-$(patsubst clean-%,%, $@))
890
891$(CLEAN_MODULE_TARGETS):
892	$(call CleanModule,$(patsubst clean-%, %, $@))
893
894$(CLEAN_MODULE_PHASE_TARGETS):
895	$(call Clean-$(word 3, $(subst -,$(SPACE),$@)), \
896	    $(word 2, $(subst -,$(SPACE),$@)))
897
898# When removing the support dir, we must also remove jdk. Building classes has
899# the side effect of generating native headers. The headers end up in support
900# while classes and touch files end up in jdk.
901clean-support: clean-jdk
902
903# Remove everything, including configure configuration. If the output
904# directory was created by configure and now becomes empty, remove it as well.
905dist-clean: clean
906	($(CD) $(OUTPUT_ROOT) && \
907	    $(RM) -r *spec.gmk $(CONFIGURESUPPORT_OUTPUTDIR) Makefile compare.sh ide)
908	$(if $(filter $(CONF_NAME),$(notdir $(OUTPUT_ROOT))), \
909	  if test "x`$(LS) $(OUTPUT_ROOT)`" != x; then \
910	    $(ECHO) "Warning: Not removing non-empty configuration directory for '$(CONF_NAME)'" ; \
911	  else \
912	    ($(CD) $(SRC_ROOT) && $(ECHO) "Removing configuration directory for '$(CONF_NAME)'" \
913	        && $(RM) -r $(OUTPUT_ROOT)) \
914	  fi \
915	)
916	$(ECHO) Cleaned everything, you will have to re-run configure.
917
918ALL_TARGETS += clean clean-docs dist-clean $(CLEAN_DIR_TARGETS) $(CLEAN_SUPPORT_DIR_TARGETS) \
919    $(CLEAN_TEST_TARGETS) $(CLEAN_PHASE_TARGETS) $(CLEAN_MODULE_TARGETS) \
920    $(CLEAN_MODULE_PHASE_TARGETS)
921
922################################################################################
923# Declare *-only targets for each normal target
924$(foreach t, $(ALL_TARGETS), $(eval $(t)-only: $(t)))
925
926ALL_TARGETS += $(addsuffix -only, $(filter-out dist-clean clean%, $(ALL_TARGETS)))
927
928################################################################################
929
930# Include JPRT targets
931include $(SRC_ROOT)/make/Jprt.gmk
932
933################################################################################
934
935# The following targets are intentionally not added to ALL_TARGETS since they
936# are internal only, to support Init.gmk.
937
938print-targets:
939	  @$(ECHO) $(sort $(ALL_TARGETS))
940
941print-modules:
942	  @$(ECHO) $(sort $(ALL_MODULES))
943
944create-main-targets-include:
945	  $(call LogInfo, Generating main target list)
946	  @$(ECHO) ALL_MAIN_TARGETS := $(sort $(ALL_TARGETS)) > \
947	      $(MAKESUPPORT_OUTPUTDIR)/main-targets.gmk
948
949################################################################################
950
951.PHONY: $(ALL_TARGETS)
952
953FRC: # Force target
954