make/Makefile

Tue, 03 Aug 2010 08:13:38 -0400

author
bobv
date
Tue, 03 Aug 2010 08:13:38 -0400
changeset 2036
126ea7725993
parent 1907
c18cbe5936b8
child 2047
d2ede61b7a12
permissions
-rw-r--r--

6953477: Increase portability and flexibility of building Hotspot
Summary: A collection of portability improvements including shared code support for PPC, ARM platforms, software floating point, cross compilation support and improvements in error crash detail.
Reviewed-by: phh, never, coleenp, dholmes

     1 #
     2 # Copyright (c) 2005, 2010, 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.
     8 #
     9 # This code is distributed in the hope that it will be useful, but WITHOUT
    10 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    11 # FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    12 # version 2 for more details (a copy is included in the LICENSE file that
    13 # accompanied this code).
    14 #
    15 # You should have received a copy of the GNU General Public License version
    16 # 2 along with this work; if not, write to the Free Software Foundation,
    17 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    18 #
    19 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
    20 # or visit www.oracle.com if you need additional information or have any
    21 # questions.
    22 #  
    23 #
    25 # Top level gnumake file for hotspot builds
    26 #
    27 # Default is to build the both product images and construct an export dir.
    28 #  The default export directory name is `pwd`/export-$(PLATFORM).
    29 #
    30 #   Use: 'gnumake help' for more information.
    31 #
    32 # This makefile uses the default settings for where to find compilers and
    33 #    tools, and obeys the ALT_* variable settings used by the other JDK
    34 #    workspaces.
    35 #
    37 # Expected/optional make variables defined on make command line:
    38 #  LP64=1 or ARCH_DATA_MODEL=64 for 64bit build
    39 #
    40 # Expected/optional make variables or environment variables:
    41 #  ALT_SLASH_JAVA             Location of /java or J:
    42 #  ALT_BOOTDIR                Previous JDK home directory for javac compiler
    43 #  ALT_OUTPUTDIR              Output directory to use for hotspot build
    44 #  ALT_EXPORT_PATH            Directory to export hotspot build to
    45 #  ALT_JDK_IMPORT_PATH        Current JDK build (only for create_jdk rules)
    46 #  ALT_BUILD_WIN_SA           Building SA on Windows is disabled by default.
    47 #                             Set ALT_BUILD_WIN_SA=1 to enable building SA on
    48 #                             Windows.
    49 # Version strings and numbers:
    50 #  JDK_VERSION                Current JDK version (e.g. 1.6.0)
    51 #  PREVIOUS_JDK_VERSION       Previous (bootdir) JDK version (e.g. 1.5.0)
    52 #  FULL_VERSION               Full version string to use (e.g. "1.6.0-ea-b42")
    53 #
    54 # Version strings and numbers especially needed on Windows:
    55 #  COOKED_JDK_UPDATE_VERSION  Just the update release number (e.g. 02)
    56 #  COOKED_BUILD_NUMBER        Just the build number (e.g. 42)
    57 #  JDK_MKTG_VERSION           Marketing JDK version (e.g. 6.0)
    58 #  JDK_MAJOR_VERSION          Major number for version (e.g. 1) always 1?
    59 #  JDK_MINOR_VERSION          Minor number for version (e.g. 6)
    60 #  JDK_MICRO_VERSION          Micro number for version (e.g. 0)
    61 #
    63 # Default is build both product fastdebug and create export area
    65 # Allow to build HotSpot in local directory from sources specified by GAMMADIR.
    66 # After make/defs.make GAMMADIR is defined.
    67 ifdef GAMMADIR
    68   ifndef ALT_OUTPUTDIR
    69     ALT_OUTPUTDIR := $(shell pwd)
    70   endif
    71   include $(GAMMADIR)/make/defs.make
    72 else
    73   include defs.make
    74 endif
    77 ifneq ($(ALT_OUTPUTDIR),)
    78   ALT_OUT=ALT_OUTPUTDIR=$(ALT_OUTPUTDIR)
    79 else
    80   ALT_OUT=
    81 endif
    83 # Typical C1/C2 targets made available with this Makefile
    84 C1_VM_TARGETS=product1 fastdebug1 optimized1 jvmg1
    85 C2_VM_TARGETS=product  fastdebug  optimized  jvmg
    86 KERNEL_VM_TARGETS=productkernel fastdebugkernel optimizedkernel jvmgkernel
    87 ZERO_VM_TARGETS=productzero fastdebugzero optimizedzero jvmgzero
    89 # JDK directory list
    90 JDK_DIRS=bin include jre lib demo
    92 all:           all_product all_fastdebug
    93 ifndef BUILD_CLIENT_ONLY
    94 all_product:   product product1 productkernel docs export_product
    95 all_fastdebug: fastdebug fastdebug1 fastdebugkernel docs export_fastdebug
    96 all_debug:     jvmg jvmg1 jvmgkernel docs export_debug
    97 else
    98 all_product:   product1 docs export_product
    99 all_fastdebug: fastdebug1 docs export_fastdebug
   100 all_debug:     jvmg1 docs export_debug
   101 endif
   102 all_optimized: optimized optimized1 optimizedkernel docs export_optimized
   104 allzero:           all_productzero all_fastdebugzero
   105 all_productzero:   productzero docs export_product
   106 all_fastdebugzero: fastdebugzero docs export_fastdebug
   107 all_debugzero:     jvmgzero docs export_debug
   108 all_optimizedzero: optimizedzero docs export_optimized
   110 # Do everything
   111 world:         all create_jdk
   113 # Build or export docs
   114 docs:
   115 ifeq ($(OSNAME),windows)
   116 	@$(ECHO) "No docs ($(VM_TARGET)) for windows"
   117 else
   118 	$(CD) $(OUTPUTDIR); \
   119 	    $(MAKE) -f $(ABS_OS_MAKEFILE) \
   120 		      $(MAKE_ARGS) docs
   121 endif
   123 # Build variation of hotspot
   124 $(C1_VM_TARGETS):
   125 	$(CD) $(GAMMADIR)/make; \
   126 	$(MAKE) VM_TARGET=$@ generic_build1 $(ALT_OUT)
   128 $(C2_VM_TARGETS):
   129 	$(CD) $(GAMMADIR)/make; \
   130 	$(MAKE) VM_TARGET=$@ generic_build2 $(ALT_OUT)
   132 $(KERNEL_VM_TARGETS):
   133 	$(CD) $(GAMMADIR)/make; \
   134 	$(MAKE) VM_TARGET=$@ generic_buildkernel $(ALT_OUT)
   136 $(ZERO_VM_TARGETS):
   137 	$(CD) $(GAMMADIR)/make; \
   138 	$(MAKE) VM_TARGET=$@ generic_buildzero $(ALT_OUT)
   140 # Build compiler1 (client) rule, different for platforms
   141 generic_build1:
   142 	$(MKDIR) -p $(OUTPUTDIR)
   143 ifeq ($(OSNAME),windows)
   144   ifeq ($(ARCH_DATA_MODEL), 32)
   145 	$(CD) $(OUTPUTDIR); \
   146 	    $(NMAKE) -f $(ABS_OS_MAKEFILE) \
   147 		      Variant=compiler1 \
   148                       WorkSpace=$(ABS_GAMMADIR) \
   149 		      BootStrapDir=$(ABS_BOOTDIR) \
   150                       BuildUser=$(USERNAME) \
   151 		      $(MAKE_ARGS) $(VM_TARGET:%1=%)
   152   else
   153 	@$(ECHO) "No compiler1 ($(VM_TARGET)) for ARCH_DATA_MODEL=$(ARCH_DATA_MODEL)"
   154   endif
   155 else
   156   ifeq ($(ARCH_DATA_MODEL), 32)
   157 	$(CD) $(OUTPUTDIR); \
   158 	    $(MAKE) -f $(ABS_OS_MAKEFILE) \
   159 		      $(MAKE_ARGS) $(VM_TARGET)
   160   else
   161 	@$(ECHO) "No compiler1 ($(VM_TARGET)) for ARCH_DATA_MODEL=$(ARCH_DATA_MODEL)"
   162   endif
   163 endif
   165 # Build compiler2 (server) rule, different for platforms
   166 generic_build2:
   167 	$(MKDIR) -p $(OUTPUTDIR)
   168 ifeq ($(OSNAME),windows)
   169 	$(CD) $(OUTPUTDIR); \
   170 	    $(NMAKE) -f $(ABS_OS_MAKEFILE) \
   171 		      Variant=compiler2 \
   172                       WorkSpace=$(ABS_GAMMADIR) \
   173 		      BootStrapDir=$(ABS_BOOTDIR) \
   174                       BuildUser=$(USERNAME) \
   175 		      $(MAKE_ARGS) $(VM_TARGET)
   176 else
   177 	$(CD) $(OUTPUTDIR); \
   178 	    $(MAKE) -f $(ABS_OS_MAKEFILE) \
   179 		      $(MAKE_ARGS) $(VM_TARGET)
   180 endif
   182 generic_buildkernel:
   183 	$(MKDIR) -p $(OUTPUTDIR)
   184 ifeq ($(OSNAME),windows)
   185   ifeq ($(ARCH_DATA_MODEL), 32)
   186 	$(CD) $(OUTPUTDIR); \
   187 	    $(NMAKE) -f $(ABS_OS_MAKEFILE) \
   188 		      Variant=kernel \
   189                       WorkSpace=$(ABS_GAMMADIR) \
   190 		      BootStrapDir=$(ABS_BOOTDIR) \
   191                       BuildUser=$(USERNAME) \
   192 		      $(MAKE_ARGS) $(VM_TARGET:%kernel=%)
   193   else
   194 	@$(ECHO) "No kernel ($(VM_TARGET)) for ARCH_DATA_MODEL=$(ARCH_DATA_MODEL)"
   195   endif
   196 else
   197 	@$(ECHO) "No kernel ($(VM_TARGET)) for OS_NAME=$(OSNAME)"
   198 endif
   200 generic_buildzero:
   201 	$(MKDIR) -p $(OUTPUTDIR)
   202 	$(CD) $(OUTPUTDIR); \
   203 		$(MAKE) -f $(ABS_OS_MAKEFILE) \
   204 			$(MAKE_ARGS) $(VM_TARGET)
   206 # Export file rule
   207 generic_export: $(EXPORT_LIST)
   208 export_product:
   209 	$(MAKE) VM_SUBDIR=product                            generic_export
   210 export_fastdebug:
   211 	$(MAKE) VM_SUBDIR=fastdebug EXPORT_SUBDIR=/fastdebug generic_export
   212 export_debug:
   213 	$(MAKE) VM_SUBDIR=${VM_DEBUG} EXPORT_SUBDIR=/debug   generic_export
   214 export_optimized:
   215 	$(MAKE) VM_SUBDIR=optimized EXPORT_SUBDIR=/optimized generic_export
   216 export_product_jdk:
   217 	$(MAKE) ALT_EXPORT_PATH=$(JDK_IMAGE_DIR) \
   218 		VM_SUBDIR=product                            generic_export
   219 export_optimized_jdk:
   220 	$(MAKE) ALT_EXPORT_PATH=$(JDK_IMAGE_DIR) \
   221 		VM_SUBDIR=optimized                          generic_export
   222 export_fastdebug_jdk:
   223 	$(MAKE) ALT_EXPORT_PATH=$(JDK_IMAGE_DIR)/fastdebug \
   224 		VM_SUBDIR=fastdebug                          generic_export
   225 export_debug_jdk:
   226 	$(MAKE) ALT_EXPORT_PATH=$(JDK_IMAGE_DIR)/debug \
   227 		VM_SUBDIR=${VM_DEBUG}                        generic_export
   230 # Export file copy rules
   231 XUSAGE=$(HS_SRC_DIR)/share/vm/Xusage.txt
   232 DOCS_DIR=$(OUTPUTDIR)/$(VM_PLATFORM)_docs
   233 C1_BASE_DIR=$(OUTPUTDIR)/$(VM_PLATFORM)_compiler1
   234 C2_BASE_DIR=$(OUTPUTDIR)/$(VM_PLATFORM)_compiler2
   235 KERNEL_BASE_DIR=$(OUTPUTDIR)/$(VM_PLATFORM)_kernel
   236 ZERO_BASE_DIR=$(OUTPUTDIR)/$(VM_PLATFORM)_zero
   237 C1_DIR=$(C1_BASE_DIR)/$(VM_SUBDIR)
   238 C2_DIR=$(C2_BASE_DIR)/$(VM_SUBDIR)
   239 KERNEL_DIR=$(KERNEL_BASE_DIR)/$(VM_SUBDIR)
   240 ZERO_DIR=$(ZERO_BASE_DIR)/$(VM_SUBDIR)
   242 # Misc files and generated files need to come from C1 or C2 area
   243 ifeq ($(ZERO_BUILD), true)
   244   MISC_DIR=$(ZERO_DIR)
   245   GEN_DIR=$(ZERO_BASE_DIR)/generated
   246 else
   247 ifeq ($(ARCH_DATA_MODEL), 32)
   248   MISC_DIR=$(C1_DIR)
   249   GEN_DIR=$(C1_BASE_DIR)/generated
   250 else
   251   MISC_DIR=$(C2_DIR)
   252   GEN_DIR=$(C2_BASE_DIR)/generated
   253 endif
   254 endif
   256 # Bin files (windows)
   257 ifeq ($(OSNAME),windows)
   259 # Get jvm.lib 
   260 $(EXPORT_LIB_DIR)/%.lib:  $(MISC_DIR)/%.lib
   261 	$(install-file)
   263 # Other libraries (like SA)
   264 $(EXPORT_JRE_BIN_DIR)/%.dll: $(MISC_DIR)/%.dll
   265 	$(install-file)
   266 $(EXPORT_JRE_BIN_DIR)/%.pdb: $(MISC_DIR)/%.pdb
   267 	$(install-file)
   268 $(EXPORT_JRE_BIN_DIR)/%.map: $(MISC_DIR)/%.map
   269 	$(install-file)
   271 # Client files always come from C1 area
   272 $(EXPORT_CLIENT_DIR)/%.dll:  $(C1_DIR)/%.dll
   273 	$(install-file)
   274 $(EXPORT_CLIENT_DIR)/%.pdb:  $(C1_DIR)/%.pdb
   275 	$(install-file)
   276 $(EXPORT_CLIENT_DIR)/%.map:  $(C1_DIR)/%.map
   277 	$(install-file)
   279 # Server files always come from C2 area
   280 $(EXPORT_SERVER_DIR)/%.dll:  $(C2_DIR)/%.dll
   281 	$(install-file)
   282 $(EXPORT_SERVER_DIR)/%.pdb:  $(C2_DIR)/%.pdb
   283 	$(install-file)
   284 $(EXPORT_SERVER_DIR)/%.map:  $(C2_DIR)/%.map
   285 	$(install-file)
   287 # Kernel files always come from kernel area
   288 $(EXPORT_KERNEL_DIR)/%.dll:  $(KERNEL_DIR)/%.dll
   289 	$(install-file)
   290 $(EXPORT_KERNEL_DIR)/%.pdb:  $(KERNEL_DIR)/%.pdb
   291 	$(install-file)
   292 $(EXPORT_KERNEL_DIR)/%.map:  $(KERNEL_DIR)/%.map
   293 	$(install-file)
   294 endif
   296 # Shared Library
   297 ifneq ($(OSNAME),windows)
   298   ifeq ($(ZERO_BUILD), true)
   299 $(EXPORT_JRE_LIB_ARCH_DIR)/%.so: $(ZERO_DIR)/%.so
   300 	$(install-file)
   301 $(EXPORT_SERVER_DIR)/%.so:       $(ZERO_DIR)/%.so
   302 	$(install-file)
   303   else
   304 $(EXPORT_JRE_LIB_ARCH_DIR)/%.so: $(C1_DIR)/%.so
   305 	$(install-file)
   306 $(EXPORT_JRE_LIB_ARCH_DIR)/%.so: $(C2_DIR)/%.so
   307 	$(install-file)
   308 $(EXPORT_CLIENT_DIR)/%.so:       $(C1_DIR)/%.so
   309 	$(install-file)
   310 $(EXPORT_CLIENT_DIR)/64/%.so:    $(C1_DIR)/%.so
   311 	$(install-file)
   312 $(EXPORT_SERVER_DIR)/%.so:       $(C2_DIR)/%.so
   313 	$(install-file)
   314 $(EXPORT_SERVER_DIR)/64/%.so:    $(C2_DIR)/%.so
   315 	$(install-file)
   316   endif
   317 endif
   319 # Jar file (sa-jdi.jar)
   320 $(EXPORT_LIB_DIR)/%.jar: $(GEN_DIR)/%.jar
   321 	$(install-file)
   323 # Include files (jvmti.h, jvmticmlr.h, jni.h, $(JDK_INCLUDE_SUBDIR)/jni_md.h, jmm.h)
   324 $(EXPORT_INCLUDE_DIR)/%: $(GEN_DIR)/jvmtifiles/%
   325 	$(install-file)
   327 $(EXPORT_INCLUDE_DIR)/%: $(HS_SRC_DIR)/share/vm/code/%
   328 	$(install-file)
   330 $(EXPORT_INCLUDE_DIR)/%: $(HS_SRC_DIR)/share/vm/prims/%
   331 	$(install-file)
   333 $(EXPORT_INCLUDE_DIR)/$(JDK_INCLUDE_SUBDIR)/jni_md.h:  $(HS_SRC_DIR)/cpu/$(HS_ARCH)/vm/jni_$(HS_ARCH).h
   334 	$(install-file)
   336 $(EXPORT_INCLUDE_DIR)/%: $(HS_SRC_DIR)/share/vm/services/%
   337 	$(install-file)
   339 # Doc files (jvmti.html)
   340 $(EXPORT_DOCS_DIR)/platform/jvmti/%: $(DOCS_DIR)/%
   341 	$(install-file)
   343 # Xusage file
   344 $(EXPORT_SERVER_DIR)/Xusage.txt $(EXPORT_CLIENT_DIR)/Xusage.txt $(EXPORT_KERNEL_DIR)/Xusage.txt: $(XUSAGE)
   345 	$(prep-target)
   346 	$(RM) $@.temp
   347 	$(SED) 's/\(separated by \)[;:]/\1$(PATH_SEP)/g' $< > $@.temp
   348 	$(MV) $@.temp $@
   350 #
   351 # Clean rules
   352 #
   353 clobber clean: clean_build clean_export clean_jdk
   354 clean_build:
   355 	$(RM) -r $(C1_DIR)
   356 	$(RM) -r $(C2_DIR)
   357 	$(RM) -r $(KERNEL_DIR)
   358 	$(RM) -r $(ZERO_DIR)
   359 clean_export:
   360 	$(RM) -r $(EXPORT_PATH)
   361 clean_jdk:
   362 	$(RM) -r $(JDK_IMAGE_DIR)
   364 #
   365 # Create JDK and place this build into it
   366 #
   367 create_jdk: copy_jdk update_jdk
   369 update_jdk: export_product_jdk export_fastdebug_jdk test_jdk
   371 copy_jdk: $(JDK_IMAGE_DIR)/jre/lib/rt.jar
   373 $(JDK_IMAGE_DIR)/jre/lib/rt.jar:
   374 	$(RM) -r $(JDK_IMAGE_DIR)
   375 	$(MKDIR) -p $(JDK_IMAGE_DIR)
   376 	($(CD) $(JDK_IMPORT_PATH) && \
   377 	 $(TAR) -cf - *) | \
   378 	 ($(CD) $(JDK_IMAGE_DIR) && $(TAR) -xf -)
   380 test_jdk:
   381   ifneq ($(ZERO_BUILD), true)
   382     ifeq ($(ARCH_DATA_MODEL), 32)
   383 	$(JDK_IMAGE_DIR)/bin/java -client -version
   384     endif
   385   endif
   386 	$(JDK_IMAGE_DIR)/bin/java -server -version
   388 copy_product_jdk:
   389 	$(RM) -r $(JDK_IMAGE_DIR)
   390 	$(MKDIR) -p $(JDK_IMAGE_DIR)
   391 	($(CD) $(JDK_IMPORT_PATH) && \
   392 	 $(TAR) -cf - $(JDK_DIRS)) | \
   393 	 ($(CD) $(JDK_IMAGE_DIR) && $(TAR) -xf -)
   395 copy_fastdebug_jdk:
   396 	$(RM) -r $(JDK_IMAGE_DIR)/fastdebug
   397 	$(MKDIR) -p $(JDK_IMAGE_DIR)/fastdebug
   398 	if [ -d $(JDK_IMPORT_PATH)/fastdebug ] ; then \
   399 	  ($(CD) $(JDK_IMPORT_PATH)/fastdebug && \
   400 	   $(TAR) -cf - $(JDK_DIRS)) | \
   401 	   ($(CD) $(JDK_IMAGE_DIR)/fastdebug && $(TAR) -xf -) ; \
   402 	else \
   403 	  ($(CD) $(JDK_IMPORT_PATH) && \
   404 	   $(TAR) -cf - $(JDK_DIRS)) | \
   405 	   ($(CD) $(JDK_IMAGE_DIR)/fastdebug && $(TAR) -xf -) ; \
   406 	fi
   408 copy_debug_jdk:
   409 	$(RM) -r $(JDK_IMAGE_DIR)/debug
   410 	$(MKDIR) -p $(JDK_IMAGE_DIR)/debug
   411 	if [ -d $(JDK_IMPORT_PATH)/debug ] ; then \
   412 	  ($(CD) $(JDK_IMPORT_PATH)/debug && \
   413 	   $(TAR) -cf - $(JDK_DIRS)) | \
   414 	   ($(CD) $(JDK_IMAGE_DIR)/debug && $(TAR) -xf -) ; \
   415 	elif [ -d $(JDK_IMPORT_PATH)/fastdebug ] ; then \
   416 	  ($(CD) $(JDK_IMPORT_PATH)/fastdebug && \
   417 	   $(TAR) -cf - $(JDK_DIRS)) | \
   418 	   ($(CD) $(JDK_IMAGE_DIR)/debug && $(TAR) -xf -) ; \
   419 	else \
   420 	  ($(CD) $(JDK_IMPORT_PATH) && \
   421 	   $(TAR) -cf - $(JDK_DIRS)) | \
   422 	   ($(CD) $(JDK_IMAGE_DIR)/debug && $(TAR) -xf -) ; \
   423 	fi
   425 #
   426 # Check target
   427 #
   428 check: variable_check
   430 #
   431 # Help target
   432 #
   433 help: intro_help target_help variable_help notes_help examples_help
   435 # Intro help message
   436 intro_help:
   437 	@$(ECHO) \
   438 "Makefile for the Hotspot workspace." 
   439 	@$(ECHO) \
   440 "Default behavior is to build and create an export area for the j2se builds."
   442 # Target help
   443 target_help:
   444 	@$(ECHO) "help:             This help message"
   445 	@$(ECHO) "all:              Same as: all_product all_fastdebug"
   446 	@$(ECHO) "world:            Same as: all create_jdk"
   447 	@$(ECHO) "all_product:      Same as: product product1 export_product"
   448 	@$(ECHO) "all_fastdebug:    Same as: fastdebug fastdebug1 export_fastdebug"
   449 	@$(ECHO) "all_debug:        Same as: jvmg jvmg1 export_debug"
   450 	@$(ECHO) "all_optimized:    Same as: optimized optimized1 export_optimized"
   451 	@$(ECHO) "clean:            Clean all areas"
   452 	@$(ECHO) "export_product:   Export product files to EXPORT_PATH"
   453 	@$(ECHO) "export_fastdebug: Export fastdebug files to EXPORT_PATH"
   454 	@$(ECHO) "export_debug:     Export debug files to EXPORT_PATH"
   455 	@$(ECHO) "export_optimized: Export optimized files to EXPORT_PATH"
   456 	@$(ECHO) "create_jdk:       Create JDK image, export all files into it"
   457 	@$(ECHO) "update_jdk:       Update JDK image with fresh exported files"
   458 	@$(ECHO) " "
   459 	@$(ECHO) "Others targets are:"
   460 	@$(ECHO) "   $(C1_VM_TARGETS)"
   461 	@$(ECHO) "   $(C2_VM_TARGETS)"
   462 	@$(ECHO) "   $(KERNEL_VM_TARGETS)"
   464 # Variable help (only common ones used by this workspace)
   465 variable_help: variable_help_intro variable_list variable_help_end
   466 variable_help_intro:
   467 	@$(ECHO) "--- Common Variables ---"
   468 variable_help_end:
   469 	@$(ECHO) " "
   470 	@$(ECHO) "--- Make Arguments ---"
   471 	@$(ECHO) "MAKE_ARGS=$(MAKE_ARGS)"
   473 # One line descriptions for the variables
   474 SLASH_JAVA.desc            = Root of all build tools, e.g. /java or J:
   475 OUTPUTDIR.desc             = Output directory, default is build/<osname>
   476 BOOTDIR.desc               = JDK used to compile agent java source and test with
   477 JDK_IMPORT_PATH.desc       = Promoted JDK to copy for 'create_jdk'
   478 EXPORT_PATH.desc           = Directory to place files to export for JDK build
   480 # Make variables to print out (description and value)
   481 VARIABLE_PRINTVAL_LIST +=       \
   482     SLASH_JAVA                  \
   483     OUTPUTDIR                   \
   484     BOOTDIR                     \
   485     JDK_IMPORT_PATH             \
   486     EXPORT_PATH
   488 # Make variables that should refer to directories that exist
   489 VARIABLE_CHECKDIR_LIST +=       \
   490     SLASH_JAVA                  \
   491     BOOTDIR                     \
   492     JDK_IMPORT_PATH
   494 # For pattern rules below, so all are treated the same
   495 DO_PRINTVAL_LIST=$(VARIABLE_PRINTVAL_LIST:%=%.printval)
   496 DO_CHECKDIR_LIST=$(VARIABLE_CHECKDIR_LIST:%=%.checkdir)
   498 # Complete variable check
   499 variable_check: $(DO_CHECKDIR_LIST)
   500 variable_list: $(DO_PRINTVAL_LIST) variable_check
   502 # Pattern rule for printing out a variable
   503 %.printval:
   504 	@$(ECHO) "  ALT_$* - $($*.desc)"
   505 	@$(ECHO) "        $*=$($*)"
   507 # Pattern rule for checking to see if a variable with a directory exists
   508 %.checkdir:
   509 	@if [ ! -d $($*) ] ; then \
   510 	    $(ECHO) "WARNING: $* does not exist, try $(MAKE) sanity"; \
   511 	fi
   513 # Pattern rule for checking to see if a variable with a file exists
   514 %.checkfil:
   515 	@if [ ! -f $($*) ] ; then \
   516 	    $(ECHO) "WARNING: $* does not exist, try $(MAKE) sanity"; \
   517 	fi
   519 # Misc notes on help
   520 notes_help:
   521 	@$(ECHO) \
   522 "--- Notes --- "
   523 	@$(ECHO) \
   524 "- JDK_IMPORT_PATH must refer to a compatible build, not all past promoted"
   525 	@$(ECHO) \
   526 "        builds or previous release JDK builds will work."
   527 	@$(ECHO) \
   528 "- The fastest builds have been when the workspace and the BOOTDIR are on"
   529 	@$(ECHO) \
   530 "        local disk."
   532 examples_help:
   533 	@$(ECHO) \
   534 "--- Examples --- "
   535 	@$(ECHO) \
   536 "  $(MAKE) all"
   537 	@$(ECHO) \
   538 "  $(MAKE) world"
   539 	@$(ECHO) \
   540 "  $(MAKE) ALT_BOOTDIR=/opt/java/jdk$(PREVIOUS_JDK_VERSION)" 
   541 	@$(ECHO) \
   542 "  $(MAKE) ALT_JDK_IMPORT_PATH=/opt/java/jdk$(JDK_VERSION)"
   544 # JPRT rule to build this workspace
   545 include $(GAMMADIR)/make/jprt.gmk
   547 .PHONY: all world clobber clean help $(C1_VM_TARGETS) $(C2_VM_TARGETS) \
   548         $(KERNEL_VM_TARGETS) \
   549 	generic_build1 generic_build2 generic_buildkernel generic_export \
   550 	export_product export_fastdebug export_debug export_optimized \
   551 	export_jdk_product export_jdk_fastdebug export_jdk_debug \
   552 	create_jdk copy_jdk update_jdk test_jdk \
   553 	copy_product_jdk copy_fastdebug_jdk copy_debug_jdk

mercurial