Makefile revision 338:14b8e7eee105 
1#
2# Copyright (c) 1995, 2011, 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
26BUILD_PARENT_DIRECTORY=.
27
28# Basename of any originally supplied ALT_OUTPUTDIR directory
29ifndef ORIG_OUTPUTDIR_BASENAME
30  ifdef ALT_OUTPUTDIR
31    ORIG_OUTPUTDIR_BASENAME := $(shell basename $(ALT_OUTPUTDIR))
32  else
33    ORIG_OUTPUTDIR_BASENAME  = $(PLATFORM)-$(ARCH)
34  endif
35endif
36export ORIG_OUTPUTDIR_BASENAME
37
38# The three possible directories created for output (3 build flavors)
39OUTPUTDIR_BASENAME-          = $(ORIG_OUTPUTDIR_BASENAME)
40OUTPUTDIR_BASENAME-debug     = $(ORIG_OUTPUTDIR_BASENAME)-debug
41OUTPUTDIR_BASENAME-fastdebug = $(ORIG_OUTPUTDIR_BASENAME)-fastdebug
42
43# Relative path to a debug output area
44REL_JDK_OUTPUTDIR = ../$(OUTPUTDIR_BASENAME-$(DEBUG_NAME))
45
46# The created jdk image directory
47JDK_IMAGE_DIRNAME = j2sdk-image
48JDK_IMAGE_DIR     = $(OUTPUTDIR)/$(JDK_IMAGE_DIRNAME)
49ABS_JDK_IMAGE_DIR = $(ABS_OUTPUTDIR)/$(JDK_IMAGE_DIRNAME)
50
51# Relative path from an output directory to the image directory
52REL_JDK_IMAGE_DIR = ../$(OUTPUTDIR_BASENAME-$(DEBUG_NAME))/$(JDK_IMAGE_DIRNAME)
53REL_JDK_DEBUG_IMAGE_DIR = ../$(OUTPUTDIR_BASENAME-debug)/$(JDK_IMAGE_DIRNAME)
54REL_JDK_FASTDEBUG_IMAGE_DIR = ../$(OUTPUTDIR_BASENAME-fastdebug)/$(JDK_IMAGE_DIRNAME)
55
56ifndef TOPDIR
57  TOPDIR:=.
58endif
59
60ifndef JDK_TOPDIR
61  JDK_TOPDIR=$(TOPDIR)/jdk
62endif
63ifndef JDK_MAKE_SHARED_DIR
64  JDK_MAKE_SHARED_DIR=$(JDK_TOPDIR)/make/common/shared
65endif
66
67default: all
68
69include $(JDK_MAKE_SHARED_DIR)/Defs-control.gmk
70include ./make/Defs-internal.gmk
71include ./make/sanity-rules.gmk
72include ./make/hotspot-rules.gmk
73include ./make/langtools-rules.gmk
74include ./make/corba-rules.gmk
75include ./make/jaxp-rules.gmk
76include ./make/jaxws-rules.gmk
77include ./make/jdk-rules.gmk
78include ./make/install-rules.gmk
79include ./make/sponsors-rules.gmk
80include ./make/deploy-rules.gmk
81
82all:: sanity
83
84ifeq ($(SKIP_FASTDEBUG_BUILD), false)
85  all:: fastdebug_build
86endif
87
88ifeq ($(SKIP_DEBUG_BUILD), false)
89  all:: debug_build
90endif
91
92all:: all_product_build 
93
94all_product_build::
95
96# Everything for a full product build
97ifeq ($(SKIP_PRODUCT_BUILD), false)
98
99  all_product_build:: product_build
100
101  ifeq ($(BUILD_INSTALL), true)
102    all_product_build:: $(INSTALL)
103    clobber:: install-clobber
104  endif
105
106  ifeq ($(BUILD_SPONSORS), true)
107    all_product_build:: $(SPONSORS)
108    clobber:: sponsors-clobber
109  endif
110
111  ifneq ($(SKIP_COMPARE_IMAGES), true)
112    all_product_build:: compare-image
113  endif
114
115endif
116
117define StartTimer
118	$(MKDIR) -p $(BUILDTIMESDIR)
119	$(RM) $(BUILDTIMESDIR)/build_time_*
120	$(call RecordStartTime,TOTAL)
121endef
122
123define StopTimer
124	$(if $(REPORT_BUILD_TIMES),$(call RecordEndTime,TOTAL) && $(call ReportBuildTimes,$1),)
125endef
126
127# Generic build of basic repo series
128generic_build_repo_series:: $(SOURCE_TIPS)
129	$(MKDIR) -p $(JDK_IMAGE_DIR)
130	@$(call StartTimer)
131
132ifeq ($(BUILD_LANGTOOLS), true)
133  generic_build_repo_series:: langtools
134  clobber:: langtools-clobber
135endif
136
137ifeq ($(BUILD_CORBA), true)
138  generic_build_repo_series:: corba
139  clobber:: corba-clobber
140endif
141
142ifeq ($(BUILD_JAXP), true)
143  generic_build_repo_series:: jaxp
144  clobber:: jaxp-clobber
145endif
146
147ifeq ($(BUILD_JAXWS), true)
148  generic_build_repo_series:: jaxws
149  clobber:: jaxws-clobber
150endif
151
152ifeq ($(BUILD_HOTSPOT), true)
153  generic_build_repo_series:: $(HOTSPOT) 
154  clobber:: hotspot-clobber
155endif
156
157ifeq ($(BUILD_JDK), true)
158  generic_build_repo_series:: $(JDK_JAVA_EXE)
159  clobber:: jdk-clobber
160endif
161
162ifeq ($(BUILD_DEPLOY), true)
163  generic_build_repo_series:: $(DEPLOY)
164  clobber:: deploy-clobber
165endif
166
167generic_build_repo_series::
168	@$(call StopTimer,$(if $(DEBUG_NAME),$(DEBUG_NAME)_build,all_product_build))
169
170# The debug build, fastdebug or debug. Needs special handling.
171#  Note that debug builds do NOT do INSTALL steps, but must be done
172#  after the product build and before the INSTALL step of the product build.
173#
174#   DEBUG_NAME is fastdebug or debug
175#   ALT_OUTPUTDIR is changed to have -debug or -fastdebug suffix
176#   The resulting image directory (j2sdk-image) is used by the install makefiles
177#     to create a debug install bundle jdk-*-debug-** bundle (tar or zip) 
178#     which will install in the debug or fastdebug subdirectory of the
179#     normal product install area.
180#     The install process needs to know what the DEBUG_NAME is, so
181#     look for INSTALL_DEBUG_NAME in the install rules.
182#
183#   NOTE: On windows, do not use $(ABS_BOOTDIR_OUTPUTDIR)-$(DEBUG_NAME).
184#         Due to the use of short paths in $(ABS_OUTPUTDIR), this may 
185#         not be the same location.
186#
187
188# Location of fresh bootdir output
189ABS_BOOTDIR_OUTPUTDIR=$(ABS_OUTPUTDIR)/bootjdk
190FRESH_BOOTDIR=$(ABS_BOOTDIR_OUTPUTDIR)/$(JDK_IMAGE_DIRNAME)
191FRESH_DEBUG_BOOTDIR=$(ABS_BOOTDIR_OUTPUTDIR)/$(REL_JDK_IMAGE_DIR)
192  
193create_fresh_product_bootdir: FRC
194	$(MAKE) ALT_OUTPUTDIR=$(ABS_BOOTDIR_OUTPUTDIR) \
195		GENERATE_DOCS=false \
196		BOOT_CYCLE_SETTINGS= \
197		build_product_image
198
199create_fresh_debug_bootdir: FRC
200	$(MAKE) ALT_OUTPUTDIR=$(ABS_BOOTDIR_OUTPUTDIR) \
201		GENERATE_DOCS=false \
202		BOOT_CYCLE_DEBUG_SETTINGS= \
203		build_debug_image
204
205create_fresh_fastdebug_bootdir: FRC
206	$(MAKE) ALT_OUTPUTDIR=$(ABS_BOOTDIR_OUTPUTDIR) \
207		GENERATE_DOCS=false \
208		BOOT_CYCLE_DEBUG_SETTINGS= \
209		build_fastdebug_image
210
211# Create boot image?
212ifeq ($(SKIP_BOOT_CYCLE),false)
213  ifneq ($(PLATFORM)$(ARCH_DATA_MODEL),solaris64)
214    DO_BOOT_CYCLE=true
215  endif
216endif
217
218
219
220ifeq ($(DO_BOOT_CYCLE),true)
221  
222  # Create the bootdir to use in the build
223  product_build:: create_fresh_product_bootdir
224  debug_build:: create_fresh_debug_bootdir
225  fastdebug_build:: create_fresh_fastdebug_bootdir
226
227  # Define variables to be used now for the boot jdk
228  BOOT_CYCLE_SETTINGS= \
229     ALT_BOOTDIR=$(FRESH_BOOTDIR) \
230     ALT_JDK_IMPORT_PATH=$(FRESH_BOOTDIR)
231  BOOT_CYCLE_DEBUG_SETTINGS= \
232     ALT_BOOTDIR=$(FRESH_DEBUG_BOOTDIR) \
233     ALT_JDK_IMPORT_PATH=$(FRESH_DEBUG_BOOTDIR)
234
235else
236
237  # Use the supplied ALT_BOOTDIR as the boot
238  BOOT_CYCLE_SETTINGS=
239  BOOT_CYCLE_DEBUG_SETTINGS=
240
241endif
242
243build_product_image:
244	$(MAKE) \
245	        SKIP_FASTDEBUG_BUILD=true \
246	        SKIP_DEBUG_BUILD=true \
247	        $(BOOT_CYCLE_SETTINGS) \
248	        generic_build_repo_series
249
250#   NOTE: On windows, do not use $(ABS_OUTPUTDIR)-$(DEBUG_NAME).
251#         Due to the use of short paths in $(ABS_OUTPUTDIR), this may 
252#         not be the same location.
253
254generic_debug_build:
255	$(MAKE) \
256		ALT_OUTPUTDIR=$(ABS_OUTPUTDIR)/$(REL_JDK_OUTPUTDIR) \
257	        DEBUG_NAME=$(DEBUG_NAME) \
258		GENERATE_DOCS=false \
259	        $(BOOT_CYCLE_DEBUG_SETTINGS) \
260		generic_build_repo_series
261
262build_debug_image:
263	$(MAKE) DEBUG_NAME=debug generic_debug_build
264
265build_fastdebug_image:
266	$(MAKE) DEBUG_NAME=fastdebug generic_debug_build
267
268# Build final image
269product_build:: build_product_image
270debug_build:: build_debug_image
271fastdebug_build:: build_fastdebug_image
272
273# The source tips are stored with the relative path to the repo.
274#   This file will be used when constructing the jdk image.
275source_tips: $(SOURCE_TIPS)
276	$(CAT) $<
277$(SOURCE_TIPS): FRC
278	@$(prep-target)
279	@$(call GetSourceTips)
280
281clobber:: REPORT_BUILD_TIMES=
282clobber:: 
283	$(RM) -r $(OUTPUTDIR)/*
284	-($(RMDIR) -p $(OUTPUTDIR) > $(DEV_NULL) 2>&1; $(TRUE))
285
286clean: clobber
287
288#
289# Dev builds
290#
291
292dev : dev-build
293
294dev-build:
295	$(MAKE) DEV_ONLY=true all
296dev-sanity:
297	$(MAKE) DEV_ONLY=true sanity
298dev-clobber:
299	$(MAKE) DEV_ONLY=true clobber
300
301#
302# Quick jdk verification build
303#
304jdk_only:
305	$(MAKE) SKIP_FASTDEBUG_BUILD=true BUILD_HOTSPOT=false all
306
307
308#
309# Quick jdk verification fastdebug build
310#
311jdk_fastdebug_only:
312	$(MAKE) DEBUG_NAME=fastdebug BUILD_HOTSPOT=false BUILD_DEPLOY=false \
313	    BUILD_INSTALL=false BUILD_SPONSORS=false generic_debug_build
314
315#
316# Quick deploy verification fastdebug build
317#
318deploy_fastdebug_only:
319	$(MAKE) \
320	    DEBUG_NAME=fastdebug \
321	    BUILD_HOTSPOT=false \
322	    BUILD_JDK=false \
323	    BUILD_LANGTOOLS=false \
324	    BUILD_CORBA=false \
325	    BUILD_JAXP=false \
326	    BUILD_JAXWS=false \
327	    BUILD_INSTALL=false \
328	    BUILD_SPONSORS=false \
329	    generic_debug_build
330
331#
332# Product build (skip debug builds)
333#
334product_only:
335	$(MAKE) SKIP_FASTDEBUG_BUILD=true all
336
337#
338# Check target
339#
340
341check: variable_check
342
343#
344# Help target
345#
346help: intro_help target_help variable_help notes_help examples_help
347
348# Intro help message
349intro_help:
350	@$(ECHO) "\
351Makefile for the JDK builds (all the JDK). \n\
352"
353
354# Target help
355target_help:
356	@$(ECHO) "\
357--- Common Targets ---  \n\
358all               -- build the core JDK (default target) \n\
359help              -- Print out help information \n\
360check             -- Check make variable values for correctness \n\
361sanity            -- Perform detailed sanity checks on system and settings \n\
362fastdebug_build   -- build the core JDK in 'fastdebug' mode (-g -O) \n\
363debug_build       -- build the core JDK in 'debug' mode (-g) \n\
364clean             -- remove all built and imported files \n\
365clobber           -- same as clean \n\
366"
367
368# Variable help (only common ones used by this Makefile)
369variable_help: variable_help_intro variable_list variable_help_end
370variable_help_intro:
371	@$(ECHO) "--- Common Variables ---"
372variable_help_end:
373	@$(ECHO) " "
374
375# One line descriptions for the variables
376OUTPUTDIR.desc             = Output directory
377PARALLEL_COMPILE_JOBS.desc = Solaris/Linux parallel compile run count
378SLASH_JAVA.desc            = Root of all build tools, e.g. /java or J:
379BOOTDIR.desc               = JDK used to boot the build
380JDK_IMPORT_PATH.desc       = JDK used to import components of the build
381COMPILER_PATH.desc         = Compiler install directory
382CACERTS_FILE.desc          = Location of certificates file
383DEVTOOLS_PATH.desc         = Directory containing zip and gnumake
384CUPS_HEADERS_PATH.desc     = Include directory location for CUPS header files
385DXSDK_PATH.desc            = Root directory of DirectX SDK
386
387# Make variables to print out (description and value)
388VARIABLE_PRINTVAL_LIST +=       \
389    OUTPUTDIR                   \
390    PARALLEL_COMPILE_JOBS       \
391    SLASH_JAVA                  \
392    BOOTDIR                     \
393    JDK_IMPORT_PATH             \
394    COMPILER_PATH               \
395    CACERTS_FILE                \
396    DEVTOOLS_PATH
397
398# Make variables that should refer to directories that exist
399VARIABLE_CHECKDIR_LIST +=       \
400    SLASH_JAVA                  \
401    BOOTDIR                     \
402    JDK_IMPORT_PATH             \
403    COMPILER_PATH               \
404    DEVTOOLS_PATH 
405
406# Make variables that should refer to files that exist
407VARIABLE_CHECKFIL_LIST +=       \
408    CACERTS_FILE
409
410# Some are windows specific
411ifeq ($(PLATFORM), windows)
412
413VARIABLE_PRINTVAL_LIST +=       \
414    DXSDK_PATH
415
416VARIABLE_CHECKDIR_LIST +=       \
417    DXSDK_PATH
418
419endif
420
421# For pattern rules below, so all are treated the same
422DO_PRINTVAL_LIST=$(VARIABLE_PRINTVAL_LIST:%=%.printval)
423DO_CHECKDIR_LIST=$(VARIABLE_CHECKDIR_LIST:%=%.checkdir)
424DO_CHECKFIL_LIST=$(VARIABLE_CHECKFIL_LIST:%=%.checkfil)
425
426# Complete variable check
427variable_check: $(DO_CHECKDIR_LIST) $(DO_CHECKFIL_LIST)
428variable_list: $(DO_PRINTVAL_LIST) variable_check
429
430# Pattern rule for printing out a variable
431%.printval:
432	@$(ECHO) "  ALT_$* - $($*.desc)"
433	@$(ECHO) "  \t $*=$($*)"
434
435# Pattern rule for checking to see if a variable with a directory exists
436%.checkdir:
437	@if [ ! -d $($*) ] ; then \
438	    $(ECHO) "WARNING: $* does not exist, try $(MAKE) sanity"; \
439	fi
440
441# Pattern rule for checking to see if a variable with a file exists
442%.checkfil:
443	@if [ ! -f $($*) ] ; then \
444	    $(ECHO) "WARNING: $* does not exist, try $(MAKE) sanity"; \
445	fi
446
447# Misc notes on help
448notes_help:
449	@$(ECHO) "\
450--- Notes --- \n\
451- All builds use same output directory unless overridden with \n\
452 \t ALT_OUTPUTDIR=<dir>, changing from product to fastdebug you may want \n\
453 \t to use the clean target first. \n\
454- JDK_IMPORT_PATH must refer to a compatible build, not all past promoted \n\
455 \t builds or previous release JDK builds will work. \n\
456- The fastest builds have been when the sources and the BOOTDIR are on \n\
457 \t local disk. \n\
458"
459
460examples_help:
461	@$(ECHO) "\
462--- Examples --- \n\
463  $(MAKE) fastdebug_build \n\
464  $(MAKE) ALT_OUTPUTDIR=/tmp/foobar all \n\
465  $(MAKE) ALT_OUTPUTDIR=/tmp/foobar fastdebug_build \n\
466  $(MAKE) ALT_OUTPUTDIR=/tmp/foobar all \n\
467  $(MAKE) ALT_BOOTDIR=/opt/java/jdk1.5.0 \n\
468  $(MAKE) ALT_JDK_IMPORT_PATH=/opt/java/jdk1.6.0 \n\
469"
470
471################################################################
472# Source bundling
473################################################################
474ifeq ($(BUNDLE_RULES_AVAILABLE), true)
475  include $(BUNDLE_RULES)
476endif
477
478################################################################
479# rule to test
480################################################################
481
482.NOTPARALLEL: test_run
483
484test:
485	$(MAKE) test_run
486
487test_run: test_clean test_start test_summary
488
489test_start:
490	@$(ECHO) "Tests started at `$(DATE)`"
491
492test_clean:
493	$(RM) $(OUTPUTDIR)/test_failures.txt $(OUTPUTDIR)/test_log.txt
494
495test_summary: $(OUTPUTDIR)/test_failures.txt
496	@$(ECHO) "#################################################"
497	@$(ECHO) "Tests completed at `$(DATE)`"
498	@( $(EGREP) '^TEST STATS:' $(OUTPUTDIR)/test_log.txt \
499          || $(ECHO) "No TEST STATS seen in log" )
500	@$(ECHO) "For complete details see: $(OUTPUTDIR)/test_log.txt"
501	@$(ECHO) "#################################################"
502	@if [ -s $< ] ; then                                           \
503          $(ECHO) "ERROR: Test failure count: `$(CAT) $< | $(WC) -l`"; \
504          $(CAT) $<;                                                   \
505          exit 1;                                                      \
506        else                                                           \
507          $(ECHO) "Success! No failures detected";                     \
508        fi
509
510# Get failure list from log
511$(OUTPUTDIR)/test_failures.txt: $(OUTPUTDIR)/test_log.txt
512	@$(RM) $@
513	@( $(EGREP) '^FAILED:' $< || $(ECHO) "" ) | $(NAWK) 'length>0' > $@
514
515# Get log file of all tests run
516JDK_TO_TEST := $(shell 							\
517  if [ -d "$(ABS_JDK_IMAGE_DIR)" ] ; then 				\
518    $(ECHO) "$(ABS_JDK_IMAGE_DIR)"; 					\
519  elif [ -d "$(ABS_OUTPUTDIR)/bin" ] ; then 				\
520    $(ECHO) "$(ABS_OUTPUTDIR)"; 					\
521  elif [ "$(PRODUCT_HOME)" != "" -a -d "$(PRODUCT_HOME)/bin" ] ; then 	\
522    $(ECHO) "$(PRODUCT_HOME)"; 						\
523  fi 									\
524)
525TEST_TARGETS=all
526$(OUTPUTDIR)/test_log.txt:
527	$(RM) $@
528	( $(CD) test &&                                                     \
529          $(MAKE) NO_STOPPING=- PRODUCT_HOME=$(JDK_TO_TEST) $(TEST_TARGETS) \
530        ) | tee $@
531
532################################################################
533# JPRT rule to build
534################################################################
535
536include ./make/jprt.gmk
537
538################################################################
539#  PHONY
540################################################################
541
542.PHONY: all  test test_run test_start test_summary test_clean \
543	generic_build_repo_series \
544	what clobber insane \
545        dev dev-build dev-sanity dev-clobber \
546        product_build \
547        fastdebug_build \
548        debug_build  \
549        build_product_image  \
550        build_debug_image  \
551        build_fastdebug_image \
552        create_fresh_product_bootdir \
553        create_fresh_debug_bootdir \
554        create_fresh_fastdebug_bootdir \
555        generic_debug_build
556
557# Force target
558FRC:
559
560