Modules.gmk revision 2662:577896ffb41a 
1#
2# Copyright (c) 2014, 2017, 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
26ifndef _MODULES_GMK
27_MODULES_GMK := 1
28
29################################################################################
30#
31# BOOT_MODULES are modules defined by the boot loader
32# PLATFORM_MODULES are modules defined by the platform loader
33# JRE_TOOL_MODULES are tools included in JRE and defined by the application loader
34#
35# All other modules not declared below are defined by the application loader
36# and are not included in JRE.
37
38BOOT_MODULES :=
39PLATFORM_MODULES :=
40JRE_TOOL_MODULES :=
41UPGRADEABLE_MODULES :=
42AGGREGATOR_MODULES :=
43DOCS_MODULES :=
44
45# Hook to include the corresponding custom file, if present.
46$(eval $(call IncludeCustomExtension, , common/Modules.gmk))
47
48BOOT_MODULES += \
49    java.base \
50    java.datatransfer \
51    java.desktop \
52    java.instrument \
53    java.logging \
54    java.management \
55    java.management.rmi \
56    java.naming \
57    java.prefs \
58    java.rmi \
59    java.security.sasl \
60    java.xml \
61    jdk.httpserver \
62    jdk.internal.vm.ci \
63    jdk.management \
64    jdk.management.agent \
65    jdk.net \
66    jdk.sctp \
67    jdk.unsupported \
68    #
69
70# to be deprivileged
71BOOT_MODULES += \
72    jdk.naming.rmi \
73    #
74
75UPGRADEABLE_MODULES += \
76    java.activation \
77    java.corba \
78    java.transaction \
79    java.xml.bind \
80    java.xml.ws \
81    java.xml.ws.annotation \
82    jdk.internal.vm.compiler \
83    #
84
85# Modules explicitly declared as not being upgradeable even though they require
86# an upgradeable module.
87NON_UPGRADEABLE_MODULES += \
88    jdk.aot \
89    #
90
91AGGREGATOR_MODULES += \
92    java.se \
93    java.se.ee \
94    #
95
96PLATFORM_MODULES += \
97    $(UPGRADEABLE_MODULES) \
98    $(AGGREGATOR_MODULES)
99    #
100
101PLATFORM_MODULES += \
102    java.compiler \
103    java.scripting \
104    java.security.jgss \
105    java.smartcardio \
106    java.sql \
107    java.sql.rowset \
108    java.xml.crypto \
109    jdk.accessibility \
110    jdk.charsets \
111    jdk.crypto.cryptoki \
112    jdk.crypto.ec \
113    jdk.dynalink \
114    jdk.incubator.httpclient \
115    jdk.jsobject \
116    jdk.localedata \
117    jdk.naming.dns \
118    jdk.scripting.nashorn \
119    jdk.security.auth \
120    jdk.security.jgss \
121    jdk.xml.dom \
122    jdk.zipfs \
123    #
124
125ifeq ($(OPENJDK_TARGET_OS), windows)
126  PLATFORM_MODULES += jdk.crypto.mscapi
127endif
128
129ifeq ($(OPENJDK_TARGET_OS), solaris)
130  PLATFORM_MODULES += jdk.crypto.ucrypto
131endif
132
133JRE_TOOL_MODULES += \
134    jdk.jdwp.agent \
135    jdk.pack \
136    jdk.scripting.nashorn.shell \
137    #
138
139################################################################################
140
141# DOCS_MODULES defines the root modules for javadoc generation.
142# All of their `require transitive` modules directly and indirectly will be included.
143DOCS_MODULES += \
144    java.se.ee \
145    java.smartcardio \
146    jdk.accessibility \
147    jdk.attach \
148    jdk.charsets \
149    jdk.compiler \
150    jdk.crypto.cryptoki \
151    jdk.crypto.ec \
152    jdk.dynalink \
153    jdk.editpad \
154    jdk.hotspot.agent \
155    jdk.httpserver \
156    jdk.incubator.httpclient \
157    jdk.jartool \
158    jdk.javadoc \
159    jdk.jcmd \
160    jdk.jconsole \
161    jdk.jdeps \
162    jdk.jdi \
163    jdk.jdwp.agent \
164    jdk.jlink \
165    jdk.jsobject \
166    jdk.jshell \
167    jdk.jstatd \
168    jdk.localedata \
169    jdk.management \
170    jdk.management.agent \
171    jdk.naming.dns \
172    jdk.naming.rmi \
173    jdk.net \
174    jdk.pack \
175    jdk.policytool \
176    jdk.rmic \
177    jdk.scripting.nashorn \
178    jdk.scripting.nashorn.shell \
179    jdk.sctp \
180    jdk.security.auth \
181    jdk.security.jgss \
182    jdk.xml.bind \
183    jdk.xml.dom \
184    jdk.xml.ws \
185    jdk.zipfs \
186    #
187
188# These modules are included in the interim image which is used to run profiling
189# before building the real images.
190INTERIM_IMAGE_MODULES := java.base java.logging
191
192################################################################################
193# Some platforms don't have the serviceability agent
194
195ifeq ($(INCLUDE_SA), false)
196  MODULES_FILTER += jdk.hotspot.agent
197endif
198
199################################################################################
200# Filter out Graal specific modules if Graal build is disabled
201
202ifeq ($(INCLUDE_GRAAL), false)
203  MODULES_FILTER += jdk.internal.vm.compiler
204endif
205
206################################################################################
207# Filter out aot specific modules if aot is disabled
208
209ifeq ($(ENABLE_AOT), false)
210  MODULES_FILTER += jdk.aot
211endif
212
213################################################################################
214# Module list macros
215
216# Use append so that the custom extension may add to these variables
217
218GENERATED_SRC_DIRS += \
219    $(SUPPORT_OUTPUTDIR)/gensrc \
220    #
221
222TOP_SRC_DIRS += \
223    $(CORBA_TOPDIR)/src \
224    $(HOTSPOT_TOPDIR)/src \
225    $(JDK_TOPDIR)/src \
226    $(LANGTOOLS_TOPDIR)/src \
227    $(JAXP_TOPDIR)/src \
228    $(JAXWS_TOPDIR)/src \
229    $(NASHORN_TOPDIR)/src \
230    #
231
232SRC_SUBDIRS += $(OPENJDK_TARGET_OS)/classes
233ifneq ($(OPENJDK_TARGET_OS), $(OPENJDK_TARGET_OS_TYPE))
234  SRC_SUBDIRS += $(OPENJDK_TARGET_OS_TYPE)/classes
235endif
236SRC_SUBDIRS += share/classes
237
238SPEC_SUBDIRS += share/specs
239
240# Find all module-info.java files for the current build target platform and
241# configuration.
242# Param 1 - Module to find for, set to * for finding all
243FindAllModuleInfos = \
244    $(wildcard \
245        $(foreach sub, $(SRC_SUBDIRS), \
246          $(patsubst %,%/$(strip $1)/$(sub)/module-info.java, $(TOP_SRC_DIRS))) \
247        $(patsubst %,%/$(strip $1)/module-info.java, $(IMPORT_MODULES_SRC)))
248
249# Find module-info.java files in the specific source dir
250# Param 1 - Src dir to find module-info.java files in
251FindModuleInfosForSrcDir = \
252    $(wildcard \
253        $(foreach sub, $(SRC_SUBDIRS), \
254          $(patsubst %,%/*/$(sub)/module-info.java, $(strip $1)) \
255        ) \
256        $(patsubst %,%/*/module-info.java, $(strip $1)) \
257    )
258
259# Extract the module names from the paths of module-info.java files. The
260# position of the module directory differs depending on if this is an imported
261# src dir or not.
262GetModuleNameFromModuleInfo = \
263    $(strip $(foreach mi, $1, \
264      $(if $(filter $(addsuffix %, $(IMPORT_MODULES_SRC)), $(mi)), \
265        $(notdir $(patsubst %/,%, $(dir $(mi)))), \
266        $(notdir $(patsubst %/,%, $(dir $(patsubst %/,%, $(dir $(patsubst %/,%, $(dir $(mi)))))))))))
267
268# Find all modules by looking for module-info.java files and looking at parent
269# directories.
270FindAllModules = \
271    $(sort $(filter-out $(MODULES_FILTER), \
272    $(call GetModuleNameFromModuleInfo, $(MODULE_INFOS))))
273
274# Find all modules in a specific src dir
275# Param 1 - Src dir to find modules in
276FindModulesForSrcDir = \
277    $(sort $(filter-out $(MODULES_FILTER), \
278        $(call GetModuleNameFromModuleInfo, $(call FindModuleInfosForSrcDir, $1)) \
279    ))
280
281FindImportedModules = \
282    $(filter-out $(MODULES_FILTER), \
283    $(if $(IMPORT_MODULES_CLASSES), $(notdir $(wildcard $(IMPORT_MODULES_CLASSES)/*))))
284
285# Find all source dirs for a particular module
286# $1 - Module to find source dirs for
287FindModuleSrcDirs = \
288    $(strip $(wildcard \
289        $(addsuffix /$(strip $1), $(GENERATED_SRC_DIRS) $(IMPORT_MODULES_SRC)) \
290        $(foreach sub, $(SRC_SUBDIRS), $(addsuffix /$(strip $1)/$(sub), $(TOP_SRC_DIRS)))))
291
292# Find all specs dirs for a particular module
293# $1 - Module to find specs dirs for
294FindModuleSpecsDirs = \
295    $(strip $(wildcard \
296        $(foreach sub, $(SPEC_SUBDIRS), $(addsuffix /$(strip $1)/$(sub), $(TOP_SRC_DIRS)))))
297
298# Construct the complete module source path
299GetModuleSrcPath = \
300    $(call PathList, \
301        $(addsuffix /*, $(GENERATED_SRC_DIRS) $(IMPORT_MODULES_SRC)) \
302        $(foreach sub, $(SRC_SUBDIRS), $(addsuffix /*/$(sub), $(TOP_SRC_DIRS))))
303
304################################################################################
305# Extract module dependencies from module-info.java files, both normal
306# dependencies ("requires"), and indirect exports ("requires transitive").
307
308MODULE_DEPS_MAKEFILE := $(MAKESUPPORT_OUTPUTDIR)/module-deps.gmk
309
310MODULE_INFOS := $(call FindAllModuleInfos, *)
311
312$(MODULE_DEPS_MAKEFILE): $(MODULE_INFOS) \
313    $(call DependOnVariable, MODULE_INFOS, $(MAKESUPPORT_OUTPUTDIR)/MODULE_INFOS.vardeps)
314	$(MKDIR) -p $(@D)
315	$(RM) $@
316	$(foreach m, $(MODULE_INFOS), \
317	    ( $(PRINTF) "DEPS_$(call GetModuleNameFromModuleInfo, $m) :=" && \
318	      $(NAWK) -v MODULE=$(call GetModuleNameFromModuleInfo, $m) '\
319	          BEGIN      { if (MODULE != "java.base") printf(" java.base"); } \
320	          /^ *requires/ { sub(/;/, ""); \
321	                          sub(/requires/, ""); \
322	                          sub(/transitive/, ""); \
323	                          sub(/\/\/.*/, ""); \
324	                          sub(/\/\*.*\*\//, ""); \
325	                          gsub(/^ +\*.*/, ""); \
326	                          gsub(/ /, ""); \
327	                          printf(" %s", $$0) } \
328	          END           { printf("\n") }' $m && \
329	      $(PRINTF) "TRANSITIVE_MODULES_$(call GetModuleNameFromModuleInfo, $m) :=" && \
330	      $(NAWK) -v MODULE=$(call GetModuleNameFromModuleInfo, $m) '\
331	          BEGIN      { if (MODULE != "java.base") printf(" java.base"); } \
332	          /^ *requires  *transitive/ { \
333	                          sub(/;/, ""); \
334	                          sub(/requires/, ""); \
335	                          sub(/transitive/, ""); \
336	                          sub(/\/\/.*/, ""); \
337	                          sub(/\/\*.*\*\//, ""); \
338	                          gsub(/^ +\*.*/, ""); \
339	                          gsub(/ /, ""); \
340	                          printf(" %s", $$0) } \
341	          END           { printf("\n") }' $m \
342	    ) >> $@ $(NEWLINE))
343
344-include $(MODULE_DEPS_MAKEFILE)
345
346# Find dependencies ("requires") for a given module.
347# Param 1: Module to find dependencies for.
348FindDepsForModule = \
349  $(DEPS_$(strip $1))
350
351# Find dependencies ("requires") transitively in 3 levels for a given module.
352# Param 1: Module to find dependencies for.
353FindTransitiveDepsForModule = \
354    $(sort $(call FindDepsForModule, $1) \
355        $(foreach m, $(call FindDepsForModule, $1), \
356            $(call FindDepsForModule, $m) \
357            $(foreach n, $(call FindDepsForModule, $m), \
358                 $(call FindDepsForModule, $n))))
359
360# Find dependencies ("requires") transitively in 3 levels for a set of modules.
361# Param 1: List of modules to find dependencies for.
362FindTransitiveDepsForModules = \
363    $(sort $(foreach m, $1, $(call FindTransitiveDepsForModule, $m)))
364
365# Find indirect exported modules ("requires transitive") for a given module .
366# Param 1: Module to find indirect exported modules for.
367FindIndirectExportsForModule = \
368  $(TRANSITIVE_MODULES_$(strip $1))
369
370# Finds indirect exported modules transitively in 3 levels for a given module.
371# Param 1: Module to find indirect exported modules for.
372FindTransitiveIndirectDepsForModule = \
373    $(sort $(call FindIndirectExportsForModule, $1) \
374        $(foreach m, $(call FindIndirectExportsForModule, $1), \
375            $(call FindIndirectExportsForModule, $m) \
376            $(foreach n, $(call FindIndirectExportsForModule, $m), \
377                 $(call FindIndirectExportsForModule, $n))))
378
379# Finds indirect exported modules transitively in 3 levels for a set of modules.
380# Param 1: List of modules to find indirect exported modules for.
381FindTransitiveIndirectDepsForModules = \
382    $(sort $(foreach m, $1, $(call FindTransitiveIndirectDepsForModule, $m)))
383
384# Upgradeable modules are those that are either defined as upgradeable or that
385# require an upradeable module.
386FindAllUpgradeableModules = \
387    $(filter-out $(MODULES_FILTER) $(NON_UPGRADEABLE_MODULES), \
388        $(sort $(UPGRADEABLE_MODULES) $(foreach m, \
389            $(filter-out $(UPGRADEABLE_MODULES), $(call FindAllModules)), \
390          $(if $(filter $(UPGRADEABLE_MODULES), \
391              $(call FindTransitiveDepsForModule, $m)), \
392            $m \
393          ) \
394        )) \
395    )
396
397################################################################################
398
399LEGAL_SUBDIRS += $(OPENJDK_TARGET_OS)/legal
400ifneq ($(OPENJDK_TARGET_OS), $(OPENJDK_TARGET_OS_TYPE))
401  LEGAL_SUBDIRS += $(OPENJDK_TARGET_OS_TYPE)/legal
402endif
403LEGAL_SUBDIRS += share/legal
404
405# Find all legal dirs for a particular module
406# $1 - Module to find legal dirs for
407FindModuleLegalDirs = \
408    $(strip $(wildcard \
409        $(addsuffix /$(strip $1), $(IMPORT_MODULES_LEGAL)) \
410        $(foreach sub, $(LEGAL_SUBDIRS), $(addsuffix /$(strip $1)/$(sub), $(TOP_SRC_DIRS)))))
411
412################################################################################
413
414# Param 1 - Name of module
415define ReadSingleImportMetaData
416    ifneq ($$(wildcard $(IMPORT_MODULES_MAKE)/$$(strip $1)/build.properties), )
417      classloader :=
418      include_in_jre :=
419      include_in_jdk :=
420      include $(IMPORT_MODULES_MAKE)/$$(strip $1)/build.properties
421      ifeq ($$(include_in_jre), true)
422        JRE_MODULES += $1
423      endif
424      ifeq ($$(include_in_jdk), true)
425        JDK_MODULES += $1
426      endif
427      ifeq ($$(classloader), boot)
428        BOOT_MODULES += $1
429      else ifeq ($$(classloader), ext)
430        PLATFORM_MODULES += $1
431      endif
432      ifneq ($$(include_in_docs), false)
433        # defaults to true if unspecified
434        DOCS_MODULES += $1
435      endif
436    else
437      # Default to include in all
438      JRE_MODULES += $1
439      JDK_MODULES += $1
440    endif
441endef
442
443# Reading the imported modules metadata has a cost, so to make it available,
444# a makefile needs to eval-call this macro first. After calling this, the
445# following variables are populated with data from the imported modules:
446# * JRE_MODULES
447# * JDK_MODULES
448# * BOOT_MODULES
449# * PLATFORM_MODULES
450# * JRE_TOOL_MODULES
451define ReadImportMetaData
452    IMPORTED_MODULES := $$(call FindImportedModules)
453    $$(foreach m, $$(IMPORTED_MODULES), \
454      $$(eval $$(call ReadSingleImportMetaData, $$m)))
455endef
456
457################################################################################
458
459endif # _MODULES_GMK
460