1 #
2 # Copyright (c) 1995, 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
26 #
27 # Common logic to run various tests for a component, to be included by the
28 # component specific test makefiles.
29 #
30
31 # Default values for some properties that can be overridden by components.
32 USE_JTREG_VERSION ?= 4.2
33 JTREG_VM_TYPE ?= -agentvm
34 USE_JTREG_ASSERT ?= true
35 LIMIT_JTREG_VM_MEMORY ?= true
36
37 .DEFAULT : all
38
39 # Empty these to get rid of some default rules
40 .SUFFIXES:
41 .SUFFIXES: .java
42 CO=
43 GET=
44
45 # Utilities used
46 AWK = awk
47 CAT = cat
48 CD = cd
49 CHMOD = chmod
50 CP = cp
51 CUT = cut
52 DIRNAME = dirname
53 ECHO = echo
54 EGREP = egrep
55 EXPAND = expand
56 FIND = find
57 MKDIR = mkdir
58 PWD = pwd
59 RM = rm -f
60 SED = sed
61 SORT = sort
62 TEE = tee
63 UNAME = uname
64 UNIQ = uniq
65 WC = wc
66 ZIPEXE = zip
67
68 # Get OS name from uname (Cygwin inexplicably adds _NT-5.1)
69 UNAME_S := $(shell $(UNAME) -s | $(CUT) -f1 -d_)
70
71 # Commands to run on paths to make mixed paths for java on windows
72 ifeq ($(findstring CYGWIN,$(UNAME_S)), CYGWIN)
73 # Location of developer shared files
74 SLASH_JAVA = J:
75 GETMIXEDPATH = cygpath -m
76 PLATFORM = windows
77 else
78 # Location of developer shared files
79 SLASH_JAVA = /java
80 GETMIXEDPATH = $(ECHO)
81 PLATFORM = unix # we only care about windows or bsd.
82 ifeq ($(UNAME_S), Darwin)
83 PLATFORM = bsd
84 endif
85 ifeq ($(findstring BSD,$(UNAME_S)), BSD)
86 PLATFORM = bsd
87 endif
88 endif
89
90 ifdef ALT_SLASH_JAVA
91 SLASH_JAVA = $(ALT_SLASH_JAVA)
92 endif
93
94 # Root of this test area (important to use full paths in some places)
95 TEST_ROOT := $(shell $(PWD))
96
97 # Root of all test results
98 ifdef TEST_OUTPUT_DIR
99 $(shell $(MKDIR) -p $(TEST_OUTPUT_DIR)/jtreg)
100 ABS_TEST_OUTPUT_DIR := \
101 $(shell $(CD) $(TEST_OUTPUT_DIR)/jtreg && $(PWD))
102 else
103 ifdef ALT_OUTPUTDIR
104 ABS_OUTPUTDIR = $(shell $(CD) $(ALT_OUTPUTDIR) && $(PWD))
105 else
106 ABS_OUTPUTDIR = $(shell $(CD) $(TEST_ROOT)/.. && $(PWD))
107 endif
108
109 ABS_PLATFORM_BUILD_ROOT = $(ABS_OUTPUTDIR)
110 ABS_TEST_OUTPUT_DIR := $(ABS_PLATFORM_BUILD_ROOT)/testoutput/$(UNIQUE_DIR)
111 endif
112
113 # Expect JPRT to set PRODUCT_HOME (the product or jdk in this case to test)
114 ifndef PRODUCT_HOME
115 # Try to use images/jdk if it exists
116 ABS_JDK_IMAGE = $(ABS_PLATFORM_BUILD_ROOT)/images/jdk
117 PRODUCT_HOME := \
118 $(shell \
119 if [ -d $(ABS_JDK_IMAGE) ] ; then \
120 $(ECHO) "$(ABS_JDK_IMAGE)"; \
121 else \
122 $(ECHO) "$(ABS_PLATFORM_BUILD_ROOT)"; \
123 fi)
124 PRODUCT_HOME := $(PRODUCT_HOME)
125 endif
126
127 # Expect JPRT to set JPRT_PRODUCT_ARGS (e.g. -server etc.)
128 # Should be passed into 'java' only.
129 # Could include: -d64 -server -client OR any java option
130 ifdef JPRT_PRODUCT_ARGS
131 JAVA_ARGS = $(JPRT_PRODUCT_ARGS)
132 endif
133
134 # Expect JPRT to set JPRT_PRODUCT_VM_ARGS (e.g. -Xcomp etc.)
135 # Should be passed into anything running the vm (java, javac, javadoc, ...).
136 ifdef JPRT_PRODUCT_VM_ARGS
137 JAVA_VM_ARGS = $(JPRT_PRODUCT_VM_ARGS)
138 endif
139
140 ifneq ($(NATIVE_TEST_PATH), )
141 # jtreg -nativepath <dir>
142 #
143 # Local make tests will be TEST_IMAGE_DIR and JPRT with jprt.use.reg.test.bundle=true
144 # should be JPRT_TESTNATIVE_PATH
145 ifdef TEST_IMAGE_DIR
146 TESTNATIVE_DIR = $(TEST_IMAGE_DIR)
147 else ifdef JPRT_TESTNATIVE_PATH
148 TESTNATIVE_DIR = $(JPRT_TESTNATIVE_PATH)
149 endif
150 ifdef TESTNATIVE_DIR
151 JTREG_NATIVE_PATH = -nativepath:$(shell $(GETMIXEDPATH) "$(TESTNATIVE_DIR)/$(NATIVE_TEST_PATH)")
152 endif
153 endif
154
155 ifeq ($(USE_FAILURE_HANDLER), true)
156 # jtreg failure handler config
157 ifeq ($(FAILURE_HANDLER_DIR), )
158 ifneq ($(TESTNATIVE_DIR), )
159 FAILURE_HANDLER_DIR := $(TESTNATIVE_DIR)/failure_handler
160 endif
161 endif
162 ifneq ($(FAILURE_HANDLER_DIR), )
163 FAILURE_HANDLER_DIR_MIXED := $(shell $(GETMIXEDPATH) "$(FAILURE_HANDLER_DIR)")
164 JTREG_FAILURE_HANDLER_OPTIONS := \
165 -timeoutHandlerDir:$(FAILURE_HANDLER_DIR_MIXED)/jtregFailureHandler.jar \
166 -observerDir:$(FAILURE_HANDLER_DIR_MIXED)/jtregFailureHandler.jar \
167 -timeoutHandler:jdk.test.failurehandler.jtreg.GatherProcessInfoTimeoutHandler \
168 -observer:jdk.test.failurehandler.jtreg.GatherDiagnosticInfoObserver \
169 -timeoutHandlerTimeout:0
170 ifeq ($(PLATFORM), windows)
171 JTREG_FAILURE_HANDLER_OPTIONS += -J-Djava.library.path="$(FAILURE_HANDLER_DIR_MIXED)"
172 endif
173 endif
174 endif
175
176 # Expect JPRT to set JPRT_ARCHIVE_BUNDLE (path to zip bundle for results)
177 ifdef JPRT_ARCHIVE_BUNDLE
178 ARCHIVE_BUNDLE = $(JPRT_ARCHIVE_BUNDLE)
179 else
180 ARCHIVE_BUNDLE = $(ABS_TEST_OUTPUT_DIR)/ARCHIVE_BUNDLE.zip
181 endif
182
183 # How to create the test bundle (pass or fail, we want to create this)
184 # Follow command with ";$(BUNDLE_UP_AND_EXIT)", so it always gets executed.
185 ZIP_UP_RESULTS = ( $(MKDIR) -p `$(DIRNAME) $(ARCHIVE_BUNDLE)` \
186 && $(CD) $(ABS_TEST_OUTPUT_DIR) \
187 && $(CHMOD) -R a+r . \
188 && $(ZIPEXE) -q -r $(ARCHIVE_BUNDLE) . )
189
190 # important results files
191 SUMMARY_TXT = $(shell $(GETMIXEDPATH) "$(ABS_TEST_OUTPUT_DIR)/JTreport/text/summary.txt")
192 STATS_TXT_NAME = Stats.txt
193 STATS_TXT = $(shell $(GETMIXEDPATH) "$(ABS_TEST_OUTPUT_DIR)/$(STATS_TXT_NAME)")
194 RUNLIST = $(shell $(GETMIXEDPATH) "$(ABS_TEST_OUTPUT_DIR)/runlist.txt")
195 PASSLIST = $(shell $(GETMIXEDPATH) "$(ABS_TEST_OUTPUT_DIR)/passlist.txt")
196 FAILLIST = $(shell $(GETMIXEDPATH) "$(ABS_TEST_OUTPUT_DIR)/faillist.txt")
197 EXITCODE = $(shell $(GETMIXEDPATH) "$(ABS_TEST_OUTPUT_DIR)/exitcode.txt")
198
199 TESTEXIT = \
200 if [ ! -s $(EXITCODE) ] ; then \
201 $(ECHO) "ERROR: EXITCODE file not filled in."; \
202 $(ECHO) "1" > $(EXITCODE); \
203 fi ; \
204 testExitCode=`$(CAT) $(EXITCODE)`; \
205 $(ECHO) "EXIT CODE: $${testExitCode}"; \
206 exit $${testExitCode}
207
208 ifeq ($(TREAT_EXIT_CODE_1_AS_0), true)
209 ADJUST_EXIT_CODE := \
210 if [ $${jtregExitCode} = 1 ] ; then \
211 jtregExitCode=0; \
212 fi
213 else
214 # colon is the shell no-op
215 ADJUST_EXIT_CODE := :
216 endif
217
218 BUNDLE_UP_AND_EXIT = \
219 ( \
220 jtregExitCode=$$? && \
221 _summary="$(SUMMARY_TXT)"; \
222 $(ADJUST_EXIT_CODE) ; \
223 $(RM) -f $(STATS_TXT) $(RUNLIST) $(PASSLIST) $(FAILLIST) $(EXITCODE); \
224 $(ECHO) "$${jtregExitCode}" > $(EXITCODE); \
225 if [ -r "$${_summary}" ] ; then \
226 $(ECHO) "Summary: $(UNIQUE_DIR)" > $(STATS_TXT); \
227 $(EXPAND) $${_summary} | $(EGREP) -v ' Not run\.' > $(RUNLIST); \
228 $(EGREP) ' Passed\.' $(RUNLIST) \
229 | $(EGREP) -v ' Error\.' \
230 | $(EGREP) -v ' Failed\.' > $(PASSLIST); \
231 ( $(EGREP) ' Failed\.' $(RUNLIST); \
232 $(EGREP) ' Error\.' $(RUNLIST); \
233 $(EGREP) -v ' Passed\.' $(RUNLIST) ) \
234 | $(SORT) | $(UNIQ) > $(FAILLIST); \
235 if [ $${jtregExitCode} != 0 -o -s $(FAILLIST) ] ; then \
236 $(EXPAND) $(FAILLIST) \
237 | $(CUT) -d' ' -f1 \
238 | $(SED) -e 's@^@FAILED: @' >> $(STATS_TXT); \
239 if [ $${jtregExitCode} = 0 ] ; then \
240 jtregExitCode=1; \
241 fi; \
242 fi; \
243 runc="`$(CAT) $(RUNLIST) | $(WC) -l | $(AWK) '{print $$1;}'`"; \
244 passc="`$(CAT) $(PASSLIST) | $(WC) -l | $(AWK) '{print $$1;}'`"; \
245 failc="`$(CAT) $(FAILLIST) | $(WC) -l | $(AWK) '{print $$1;}'`"; \
246 exclc="FIXME CODETOOLS-7900176"; \
247 $(ECHO) "TEST STATS: name=$(UNIQUE_DIR) run=$${runc} pass=$${passc} fail=$${failc}" \
248 >> $(STATS_TXT); \
249 else \
250 $(ECHO) "Missing file: $${_summary}" >> $(STATS_TXT); \
251 fi; \
252 if [ -f $(STATS_TXT) ] ; then \
253 $(CAT) $(STATS_TXT); \
254 fi; \
255 $(ZIP_UP_RESULTS) ; \
256 $(TESTEXIT) \
257 )
258
259 ################################################################
260
261 # Prep for output
262 # Change execute permissions on shared library files.
263 # Files in repositories should never have execute permissions, but
264 # there are some tests that have pre-built shared libraries, and these
265 # windows dll files must have execute permission. Adding execute
266 # permission may happen automatically on windows when using certain
267 # versions of mercurial but it cannot be guaranteed. And blindly
268 # adding execute permission might be seen as a mercurial 'change', so
269 # we avoid adding execute permission to repository files. But testing
270 # from a plain source tree needs the chmod a+rx. Applying the chmod to
271 # all shared libraries not just dll files. And with CYGWIN and sshd
272 # service, you may need CYGWIN=ntsec for this to work.
273 prep:
274 @$(MKDIR) -p $(ABS_TEST_OUTPUT_DIR)
275 @$(MKDIR) -p `$(DIRNAME) $(ARCHIVE_BUNDLE)`
276 @if [ ! -d $(TEST_ROOT)/../../.hg ] && [ ! -d $(TEST_ROOT)/../../../.hg ]; then \
277 $(FIND) $(TEST_ROOT) \( -name \*.dll -o -name \*.DLL -o -name \*.so \) \
278 -exec $(CHMOD) a+rx {} \; ; \
279 fi
280
281 ifeq ($(CLEAN_BEFORE_PREP), true)
282 prep: clean
283
284 endif
285
286 # Cleanup
287 clean:
288 @$(RM) -r $(ABS_TEST_OUTPUT_DIR)
289 @$(RM) $(ARCHIVE_BUNDLE)
290
291 ################################################################
292
293 # jtreg tests
294
295 # Expect JT_HOME to be set for jtreg tests. (home for jtreg)
296 ifndef JT_HOME
297 JT_HOME = $(SLASH_JAVA)/re/jtreg/$(USE_JTREG_VERSION)/promoted/latest/binaries/jtreg
298 ifdef JPRT_JTREG_HOME
299 JT_HOME = $(JPRT_JTREG_HOME)
300 endif
301 endif
302
303 # Problematic tests to be excluded
304 PROBLEM_LISTS=$(call MixedDirs,$(wildcard ProblemList.txt))
305
306 # Create exclude list for this platform and arch
307 ifdef NO_EXCLUDES
308 JTREG_EXCLUSIONS =
309 else
310 JTREG_EXCLUSIONS = $(PROBLEM_LISTS:%=-exclude:%)
311 endif
312
313 # convert list of directories to dos paths
314 define MixedDirs
315 $(foreach i,$1,$(shell $(GETMIXEDPATH) "${i}"))
316 endef
317
318 # ------------------------------------------------------------------
319
320 # When called from JPRT the TESTDIRS variable is set to the jtreg tests to run
321 ifdef TESTDIRS
322 TEST_SELECTION = $(TESTDIRS)
323 endif
324
325 ifdef CONCURRENCY
326 JTREG_BASIC_OPTIONS += -concurrency:$(CONCURRENCY)
327 endif
328 ifdef EXTRA_JTREG_OPTIONS
329 JTREG_BASIC_OPTIONS += $(EXTRA_JTREG_OPTIONS)
330 endif
331
332 # Default JTREG to run
333 JTREG = $(JT_HOME)/bin/jtreg
334 # run in agentvm/othervm mode
335 JTREG_BASIC_OPTIONS += $(JTREG_VM_TYPE)
336 # Only run automatic tests
337 JTREG_BASIC_OPTIONS += -a
338 # Always turn on assertions
339 ifeq ($(USE_JTREG_ASSERT), true)
340 JTREG_ASSERT_OPTION = -ea -esa
341 endif
342 JTREG_BASIC_OPTIONS += $(JTREG_ASSERT_OPTION)
343 # jtreg verbosity setting
344 # Default is to report details on all failed or error tests, times too
345 JTREG_VERBOSE ?= fail,error,time
346 JTREG_BASIC_OPTIONS += $(if $(JTREG_VERBOSE),-v:$(JTREG_VERBOSE))
347 # Retain all files for failing tests
348 JTREG_BASIC_OPTIONS += -retain:fail,error
349 # Ignore tests are not run and completely silent about it
350 JTREG_IGNORE_OPTION = -ignore:quiet
351 JTREG_BASIC_OPTIONS += $(JTREG_IGNORE_OPTION)
352 # Multiply by 4 the timeout factor
353 JTREG_TIMEOUT_OPTION = -timeoutFactor:4
354 JTREG_BASIC_OPTIONS += $(JTREG_TIMEOUT_OPTION)
355 ifeq ($(LIMIT_JTREG_VM_MEMORY), true)
356 # Set the max memory for jtreg control vm
357 JTREG_MEMORY_OPTION = -J-Xmx512m
358 JTREG_BASIC_OPTIONS += $(JTREG_MEMORY_OPTION)
359 # Set the max memory for jtreg target test vms
360 JTREG_TESTVM_MEMORY_OPTION = -vmoption:-Xmx512m
361 JTREG_TEST_OPTIONS += $(JTREG_TESTVM_MEMORY_OPTION)
362 endif
363 # Make it possible to specify the JIB_DATA_DIR for tests using the
364 # JIB Artifact resolver
365 JTREG_BASIC_OPTIONS += -e:JIB_DATA_DIR
366 # Give tests access to JT_JAVA, see JDK-8141609
367 JTREG_BASIC_OPTIONS += -e:JDK8_HOME=${JT_JAVA}
368 # Give aot tests access to Visual Studio installation
369 ifneq ($(VS120COMNTOOLS), )
370 JTREG_BASIC_OPTIONS += -e:VS120COMNTOOLS=$(shell $(GETMIXEDPATH) "$(VS120COMNTOOLS)")
371 endif
372 # Set other vm and test options
373 JTREG_TEST_OPTIONS += $(JAVA_ARGS:%=-javaoptions:%) $(JAVA_VM_ARGS:%=-vmoption:%)
374 ifneq ($(JIB_JAR), )
375 JTREG_BASIC_OPTIONS += -cpa:$(shell $(GETMIXEDPATH) "$(JIB_JAR)")
376 endif
377 ifeq ($(IGNORE_MARKED_TESTS), true)
378 # Option to tell jtreg to not run tests marked with "ignore"
379 ifeq ($(PLATFORM), windows)
380 JTREG_KEY_OPTION = -k:!ignore
381 else
382 JTREG_KEY_OPTION = -k:\!ignore
383 endif
384 JTREG_BASIC_OPTIONS += $(JTREG_KEY_OPTION)
385 endif
386
387 # Make sure jtreg exists
388 ifeq ($(USE_WINDOWS_EXISTENCE_CHECK), true)
389 jtreg_exists:
390 test -d $(shell $(GETMIXEDPATH) "$(JT_HOME)")
391 test -f $(shell $(GETMIXEDPATH) "$(JTREG)")
392
393 else
394 jtreg_exists: $(JT_HOME)
395 endif
396 PHONY_LIST += jtreg_exists
397
398 # Run jtreg
399 jtreg_tests: prep jtreg_exists $(PRODUCT_HOME)
400 ( \
401 ( JT_HOME=$(shell $(GETMIXEDPATH) "$(JT_HOME)"); \
402 export JT_HOME; \
403 $(shell $(GETMIXEDPATH) "$(JTREG)") \
404 $(JTREG_BASIC_OPTIONS) \
405 -r:$(shell $(GETMIXEDPATH) "$(ABS_TEST_OUTPUT_DIR)/JTreport") \
406 -w:$(shell $(GETMIXEDPATH) "$(ABS_TEST_OUTPUT_DIR)/JTwork") \
407 -jdk:$(shell $(GETMIXEDPATH) "$(PRODUCT_HOME)") \
408 $(JTREG_NATIVE_PATH) \
409 $(JTREG_FAILURE_HANDLER_OPTIONS) \
410 $(JTREG_EXCLUSIONS) \
411 $(JTREG_TEST_OPTIONS) \
412 $(TEST_SELECTION) \
413 ) ; \
414 $(BUNDLE_UP_AND_EXIT) \
415 ) 2>&1 | $(TEE) $(ABS_TEST_OUTPUT_DIR)/output.txt ; $(TESTEXIT)
416
417 PHONY_LIST += jtreg_tests
418
419 # Make it possible to call this with <component>_jtreg_tests
420 %_jtreg_tests: jtreg_tests
421 # Must have a fake recipe here to prevent make from matching any other rule
422
423 ################################################################
424
425 # Phony targets (e.g. these are not filenames)
426 .PHONY: all clean prep $(PHONY_LIST)
427
428 ################################################################