1 # 2 # Copyright (c) 2012, 2013, 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 # This must be the first rule 27 default: 28 29 # Inclusion of this pseudo-target will cause make to execute this file 30 # serially, regardless of -j. Recursively called makefiles will not be 31 # affected, however. This is required for correct dependency management. 32 .NOTPARALLEL: 33 34 # The shell code below will be executed on /usr/ccs/bin/make on Solaris, but not in GNU make. 35 # /usr/ccs/bin/make lacks basically every other flow control mechanism. 36 .TEST_FOR_NON_GNUMAKE:sh=echo You are not using GNU make/gmake, this is a requirement. Check your path. 1>&2 && exit 1 37 38 # Assume we have GNU make, but check version. 39 ifeq ($(strip $(foreach v, 3.81% 3.82% 4.%, $(filter $v, $(MAKE_VERSION)))), ) 40 $(error This version of GNU Make is too low ($(MAKE_VERSION)). Check your path, or upgrade to 3.81 or newer.) 41 endif 42 43 # Locate this Makefile 44 ifeq ($(filter /%,$(lastword $(MAKEFILE_LIST))),) 45 makefile_path:=$(CURDIR)/$(lastword $(MAKEFILE_LIST)) 46 else 47 makefile_path:=$(lastword $(MAKEFILE_LIST)) 48 endif 49 root_dir:=$(patsubst %/,%,$(dir $(makefile_path))) 50 51 ifneq ($(findstring qp,$(MAKEFLAGS)),) 52 # When called with -qp, assume an external part (e.g. bash completion) is trying 53 # to understand our targets. 54 # Duplication of global targets, needed before ParseConfAndSpec in case we have 55 # no configurations. 56 help: 57 # If both CONF and SPEC are unset, look for all available configurations by 58 # setting CONF to the empty string. 59 ifeq ($(SPEC), ) 60 CONF?= 61 endif 62 endif 63 64 # ... and then we can include our helper functions 65 include $(root_dir)/make/MakeHelpers.gmk 66 67 $(eval $(call ParseLogLevel)) 68 $(eval $(call ParseConfAndSpec)) 69 70 # Now determine if we have zero, one or several configurations to build. 71 ifeq ($(SPEC),) 72 # Since we got past ParseConfAndSpec, we must be building a global target. Do nothing. 73 else 74 # In Cygwin, the MAKE variable gets messed up if the make executable is called with 75 # a Windows mixed path (c:/cygwin/bin/make.exe). If that's the case, fix it by removing 76 # the prepended root_dir. 77 ifneq ($(findstring :, $(MAKE)), ) 78 MAKE := $(patsubst $(root_dir)%, %, $(MAKE)) 79 endif 80 81 # We are potentially building multiple configurations. 82 # First, find out the valid targets 83 # Run the makefile with an arbitrary SPEC using -p -q (quiet dry-run and dump rules) to find 84 # available PHONY targets. Use this list as valid targets to pass on to the repeated calls. 85 all_phony_targets := $(sort $(filter-out $(global_targets), $(strip $(shell \ 86 cd $(root_dir)/make && $(MAKE) -f Main.gmk -p -q FRC SPEC=$(firstword $(SPEC)) \ 87 -I $(root_dir)/make/common | grep "^.PHONY:" | head -n 1 | cut -d " " -f 2-)))) 88 89 # Loop through the configurations and call the main-wrapper for each one. The wrapper 90 # target will execute with a single configuration loaded. 91 $(all_phony_targets): 92 @$(if $(TARGET_RUN),,\ 93 $(foreach spec,$(SPEC),\ 94 (cd $(root_dir) && $(MAKE) SPEC=$(spec) MAIN_TARGETS="$(call GetRealTarget)" \ 95 $(VERBOSE) VERBOSE=$(VERBOSE) LOG_LEVEL=$(LOG_LEVEL) main-wrapper) &&) true) 96 @echo > /dev/null 97 $(eval TARGET_RUN=true) 98 99 .PHONY: $(all_phony_targets) 100 101 ifneq ($(MAIN_TARGETS), ) 102 # The wrapper target was called so we now have a single configuration. Load the spec file 103 # and call the real Main.gmk. 104 include $(SPEC) 105 include $(SRC_ROOT)/make/common/MakeBase.gmk 106 107 ### Clean up from previous run 108 # Remove any build.log from a previous run, if they exist 109 ifneq (,$(BUILD_LOG)) 110 ifneq (,$(BUILD_LOG_PREVIOUS)) 111 # Rotate old log 112 $(shell $(RM) $(BUILD_LOG_PREVIOUS) 2> /dev/null) 113 $(shell $(MV) $(BUILD_LOG) $(BUILD_LOG_PREVIOUS) 2> /dev/null) 114 else 115 $(shell $(RM) $(BUILD_LOG) 2> /dev/null) 116 endif 117 $(shell $(RM) $(OUTPUT_ROOT)/build-trace-time.log 2> /dev/null) 118 endif 119 # Remove any javac server logs and port files. This 120 # prevents a new make run to reuse the previous servers. 121 ifneq (,$(SJAVAC_SERVER_DIR)) 122 $(shell $(MKDIR) -p $(SJAVAC_SERVER_DIR) && $(RM) -rf $(SJAVAC_SERVER_DIR)/*) 123 endif 124 125 # Split out the targets requiring sequential execution. Run these targets separately 126 # from the rest so that the rest may still enjoy full parallel execution. 127 SEQUENTIAL_TARGETS := $(filter dist-clean clean% reconfigure, $(MAIN_TARGETS)) 128 PARALLEL_TARGETS := $(filter-out $(SEQUENTIAL_TARGETS), $(MAIN_TARGETS)) 129 130 main-wrapper: 131 ifneq ($(SEQUENTIAL_TARGETS), ) 132 (cd $(SRC_ROOT)/make && $(MAKE) -f Main.gmk SPEC=$(SPEC) -j 1 \ 133 $(VERBOSE) VERBOSE=$(VERBOSE) LOG_LEVEL=$(LOG_LEVEL) $(SEQUENTIAL_TARGETS)) 134 endif 135 ifneq ($(PARALLEL_TARGETS), ) 136 @$(call AtMakeStart) 137 (cd $(SRC_ROOT)/make && $(BUILD_LOG_WRAPPER) $(MAKE) -f Main.gmk SPEC=$(SPEC) -j $(JOBS) \ 138 $(VERBOSE) VERBOSE=$(VERBOSE) LOG_LEVEL=$(LOG_LEVEL) $(PARALLEL_TARGETS) \ 139 $(if $(filter true, $(OUTPUT_SYNC_SUPPORTED)), -O$(OUTPUT_SYNC))) 140 @$(call AtMakeEnd) 141 endif 142 143 .PHONY: main-wrapper 144 145 endif 146 endif 147 148 # Here are "global" targets, i.e. targets that can be executed without specifying a single configuration. 149 # If you add more global targets, please update the variable global_targets in MakeHelpers. 150 151 help: 152 $(info ) 153 $(info OpenJDK Makefile help) 154 $(info =====================) 155 $(info ) 156 $(info Common make targets) 157 $(info . make [default] # Compile all modules in langtools, hotspot, jaxp, jaxws,) 158 $(info . # corba and jdk and create a runnable "exploded" image) 159 $(info . make all # Compile everything, all repos, docs and images) 160 $(info . make images # Create complete jdk and jre images) 161 $(info . make <phase> # Compile the specified phase and everything it depends on) 162 $(info . # (gensrc, java, copy, libs, launchers, gendata, rmic)) 163 $(info . make *-only # Applies to most targets and disables compling the) 164 $(info . # dependencies for the target. This is faster but may) 165 $(info . # result in incorrect build results!) 166 $(info . make docs # Create all docs) 167 $(info . make docs-javadoc # Create just javadocs, depends on less than full docs) 168 $(info . make profiles # Create complete jre compact profile images) 169 $(info . make bootcycle-images # Build images twice, second time with newly built JDK) 170 $(info . make install # Install the generated images locally) 171 $(info . make reconfigure # Rerun configure with the same arguments as last time) 172 $(info . make help # Give some help on using make) 173 $(info . make test # Run tests, default is all tests (see TEST below)) 174 $(info ) 175 $(info Targets for cleaning) 176 $(info . make clean # Remove all files generated by make, but not those) 177 $(info . # generated by configure) 178 $(info . make dist-clean # Remove all files, including configuration) 179 $(info . make clean-<outputdir> # Remove the subdir in the output dir with the name) 180 $(info . make clean-<phase> # Remove all build results related to a certain build) 181 $(info . # phase (gensrc, java, libs, launchers)) 182 $(info . make clean-<module> # Remove all build results related to a certain module) 183 $(info . make clean-<module>-<phase> # Remove all build results related to a certain) 184 $(info . # module and phase) 185 $(info ) 186 $(info Targets for specific modules) 187 $(info . make <module> # Build <module> and everything it depends on. ) 188 $(info . make <module>-<phase> # Compile the specified phase for the specified module) 189 $(info . # and everything it depends on) 190 $(info . # (gensrc, java, copy, libs, launchers, gendata, rmic)) 191 $(info ) 192 $(info Useful make variables) 193 $(info . make CONF= # Build all configurations (note, assignment is empty)) 194 $(info . make CONF=<substring> # Build the configuration(s) with a name matching) 195 $(info . # <substring>) 196 $(info ) 197 $(info . make LOG=<loglevel> # Change the log level from warn to <loglevel>) 198 $(info . # Available log levels are:) 199 $(info . # 'warn' (default), 'info', 'debug' and 'trace') 200 $(info . # To see executed command lines, use LOG=debug) 201 $(info ) 202 $(info . make JOBS=<n> # Run <n> parallel make jobs) 203 $(info . # Note that -jN does not work as expected!) 204 $(info ) 205 $(info . make test TEST=<test> # Only run the given test or tests, e.g.) 206 $(info . # make test TEST="jdk_lang jdk_net") 207 $(info ) 208 209 .PHONY: help