Makefile revision 910:a667caba1e84 
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
27default:
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.
36TEST_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.
39ifeq ($(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.)
41endif
42
43# Locate this Makefile
44ifeq ($(filter /%,$(lastword $(MAKEFILE_LIST))),)
45  makefile_path:=$(CURDIR)/$(lastword $(MAKEFILE_LIST))
46else
47  makefile_path:=$(lastword $(MAKEFILE_LIST))
48endif
49root_dir:=$(dir $(makefile_path))
50
51# ... and then we can include our helper functions
52include $(root_dir)/make/MakeHelpers.gmk
53
54$(eval $(call ParseLogLevel))
55$(eval $(call ParseConfAndSpec))
56
57# Now determine if we have zero, one or several configurations to build.
58ifeq ($(SPEC),)
59  # Since we got past ParseConfAndSpec, we must be building a global target. Do nothing.
60else
61  ifeq ($(words $(SPEC)),1)
62    # We are building a single configuration. This is the normal case. Execute the Main.gmk file.
63    include $(root_dir)/make/Main.gmk
64  else
65    # We are building multiple configurations.
66    # First, find out the valid targets
67    # Run the makefile with an arbitrary SPEC using -p -q (quiet dry-run and dump rules) to find
68    # available PHONY targets. Use this list as valid targets to pass on to the repeated calls.
69    all_phony_targets=$(filter-out $(global_targets) bundles-only, $(strip $(shell \
70        $(MAKE) -p -q -f make/Main.gmk FRC SPEC=$(firstword $(SPEC)) | \
71        grep ^.PHONY: | head -n 1 | cut -d " " -f 2-)))
72
73    $(all_phony_targets):
74	@$(foreach spec,$(SPEC),($(MAKE) -f NewMakefile.gmk SPEC=$(spec) \
75	    $(VERBOSE) VERBOSE=$(VERBOSE) LOG_LEVEL=$(LOG_LEVEL) $@) &&) true
76
77    .PHONY: $(all_phony_targets)
78
79  endif
80endif
81
82# Include this after a potential spec file has been included so that the bundles target
83# has access to the spec variables.
84include $(root_dir)/make/Jprt.gmk
85
86# Here are "global" targets, i.e. targets that can be executed without specifying a single configuration.
87# If you addd more global targets, please update the variable global_targets in MakeHelpers.
88
89help:
90	$(info )
91	$(info OpenJDK Makefile help)
92	$(info =====================)
93	$(info )
94	$(info Common make targets)
95	$(info .  make [default]         # Compile all product in langtools, hotspot, jaxp, jaxws,)
96	$(info .                         # corba and jdk)
97	$(info .  make all               # Compile everything, all repos and images)
98	$(info .  make images            # Create complete j2sdk and j2re images)
99	$(info .  make docs              # Create javadocs)
100	$(info .  make overlay-images    # Create limited images for sparc 64 bit platforms)
101	$(info .  make profiles          # Create complete j2re compact profile images)
102	$(info .  make bootcycle-images  # Build images twice, second time with newly build JDK)
103	$(info .  make install           # Install the generated images locally)
104	$(info .  make clean             # Remove all files generated by make, but not those)
105	$(info .                         # generated by configure)
106	$(info .  make dist-clean        # Remove all files, including configuration)
107	$(info .  make help              # Give some help on using make)
108	$(info .  make test              # Run tests, default is all tests (see TEST below))
109	$(info )
110	$(info Targets for specific components)
111	$(info (Component is any of langtools, corba, jaxp, jaxws, hotspot, jdk, nashorn, images, overlay-images, docs or test))
112	$(info .  make <component>       # Build <component> and everything it depends on. )
113	$(info .  make <component>-only  # Build <component> only, without dependencies. This)
114	$(info .                         # is faster but can result in incorrect build results!)
115	$(info .  make clean-<component> # Remove files generated by make for <component>)
116	$(info )
117	$(info Useful make variables)
118	$(info .  make CONF=             # Build all configurations (note, assignment is empty))
119	$(info .  make CONF=<substring>  # Build the configuration(s) with a name matching)
120	$(info .                         # <substring>)
121	$(info )
122	$(info .  make LOG=<loglevel>    # Change the log level from warn to <loglevel>)
123	$(info .                         # Available log levels are:)
124	$(info .                         # 'warn' (default), 'info', 'debug' and 'trace')
125	$(info .                         # To see executed command lines, use LOG=debug)
126	$(info )
127	$(info .  make JOBS=<n>          # Run <n> parallel make jobs)
128	$(info .                         # Note that -jN does not work as expected!)
129	$(info )
130	$(info .  make test TEST=<test>  # Only run the given test or tests, e.g.)
131	$(info .                         # make test TEST="jdk_lang jdk_net")
132	$(info )
133
134.PHONY: help
135