1 #
2 # Copyright (c) 2016, 2022, 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 default: all
27
28 include $(SPEC)
29 include MakeBase.gmk
30 include FindTests.gmk
31
32 # We will always run multiple tests serially
33 .NOTPARALLEL:
34
35 ################################################################################
36 # Parse global control variables
37 ################################################################################
38
39 ifneq ($(TEST_VM_OPTS), )
40 ifneq ($(TEST_OPTS), )
41 TEST_OPTS := $(TEST_OPTS);VM_OPTIONS=$(TEST_VM_OPTS)
42 else
43 TEST_OPTS := VM_OPTIONS=$(TEST_VM_OPTS)
44 endif
45 endif
46
47 $(eval $(call ParseKeywordVariable, TEST_OPTS, \
48 SINGLE_KEYWORDS := JOBS TIMEOUT_FACTOR JCOV JCOV_DIFF_CHANGESET, \
49 STRING_KEYWORDS := VM_OPTIONS JAVA_OPTIONS, \
50 ))
51
52 # Helper function to propagate TEST_OPTS values.
53 #
54 # Note: No spaces are allowed around the arguments.
55 # Arg $1 The variable in TEST_OPTS to propagate
56 # Arg $2 The control variable to propagate it to
57 define SetTestOpt
58 ifneq ($$(TEST_OPTS_$1), )
59 $2_$1 := $$(TEST_OPTS_$1)
60 endif
61 endef
62
63 # Setup _NT_SYMBOL_PATH on Windows, which points to our pdb files.
64 ifeq ($(call isTargetOs, windows), true)
65 ifndef _NT_SYMBOL_PATH
66 SYMBOL_PATH := $(call PathList, $(sort $(patsubst %/, %, $(dir $(wildcard \
67 $(addprefix $(SYMBOLS_IMAGE_DIR)/bin/, *.pdb */*.pdb))))))
68 export _NT_SYMBOL_PATH := $(subst \\,\, $(call FixPath, \
69 $(subst $(DQUOTE),, $(SYMBOL_PATH))))
70 $(call LogDebug, Setting _NT_SYMBOL_PATH to $(_NT_SYMBOL_PATH))
71 endif
72 endif
73
74 ################################################################################
75 # Hook to include the corresponding custom file, if present.
76 $(eval $(call IncludeCustomExtension, RunTests.gmk))
77 ################################################################################
78
79 # This is the JDK that we will test
80 JDK_UNDER_TEST := $(JDK_IMAGE_DIR)
81
82 TEST_RESULTS_DIR := $(OUTPUTDIR)/test-results
83 TEST_SUPPORT_DIR := $(OUTPUTDIR)/test-support
84 TEST_SUMMARY := $(TEST_RESULTS_DIR)/test-summary.txt
85 TEST_LAST_IDS := $(TEST_SUPPORT_DIR)/test-last-ids.txt
86
87 ifeq ($(CUSTOM_ROOT), )
88 JTREG_TOPDIR := $(TOPDIR)
89 else
90 JTREG_TOPDIR := $(CUSTOM_ROOT)
91 endif
92
93 JTREG_FAILURE_HANDLER_DIR := $(TEST_IMAGE_DIR)/failure_handler
94 JTREG_FAILURE_HANDLER := $(JTREG_FAILURE_HANDLER_DIR)/jtregFailureHandler.jar
95
96 JTREG_FAILURE_HANDLER_TIMEOUT ?= 0
97
98 ifneq ($(wildcard $(JTREG_FAILURE_HANDLER)), )
99 JTREG_FAILURE_HANDLER_OPTIONS := \
100 -timeoutHandlerDir:$(JTREG_FAILURE_HANDLER) \
101 -observerDir:$(JTREG_FAILURE_HANDLER) \
102 -timeoutHandler:jdk.test.failurehandler.jtreg.GatherProcessInfoTimeoutHandler \
103 -observer:jdk.test.failurehandler.jtreg.GatherDiagnosticInfoObserver \
104 -timeoutHandlerTimeout:$(JTREG_FAILURE_HANDLER_TIMEOUT)
105 endif
106
107 GTEST_LAUNCHER_DIRS := $(patsubst %/gtestLauncher, %, \
108 $(wildcard $(TEST_IMAGE_DIR)/hotspot/gtest/*/gtestLauncher))
109 GTEST_VARIANTS := $(strip $(patsubst $(TEST_IMAGE_DIR)/hotspot/gtest/%, %, \
110 $(GTEST_LAUNCHER_DIRS)))
111
112 COV_ENVIRONMENT :=
113 JTREG_COV_OPTIONS :=
114
115 ifeq ($(TEST_OPTS_JCOV), true)
116 JCOV_OUTPUT_DIR := $(TEST_RESULTS_DIR)/jcov-output
117 JCOV_GRABBER_LOG := $(JCOV_OUTPUT_DIR)/grabber.log
118 JCOV_RESULT_FILE := $(JCOV_OUTPUT_DIR)/result.xml
119 JCOV_REPORT := $(JCOV_OUTPUT_DIR)/report
120 JCOV_MEM_OPTIONS := -Xms64m -Xmx4g
121
122 # Replace our normal test JDK with the JCov image.
123 JDK_UNDER_TEST := $(JCOV_IMAGE_DIR)
124
125 COV_ENVIRONMENT += JAVA_TOOL_OPTIONS="$(JCOV_MEM_OPTIONS)" \
126 _JAVA_OPTIONS="$(JCOV_MEM_OPTIONS)"
127 JTREG_COV_OPTIONS += -e:JAVA_TOOL_OPTIONS='$(JCOV_MEM_OPTIONS)' \
128 -e:_JAVA_OPTIONS='$(JCOV_MEM_OPTIONS)'
129 endif
130
131 ifeq ($(GCOV_ENABLED), true)
132 GCOV_OUTPUT_DIR := $(TEST_RESULTS_DIR)/gcov-output
133 COV_ENVIRONMENT += GCOV_PREFIX="$(GCOV_OUTPUT_DIR)"
134 JTREG_COV_OPTIONS += -e:GCOV_PREFIX="$(GCOV_OUTPUT_DIR)"
135 endif
136
137 ################################################################################
138 # Setup global test running parameters
139 ################################################################################
140
141 # Each factor variable comes in 3 variants. The first one is reserved for users
142 # to use on command line. The other two are for predefined configurations in JDL
143 # and for machine specific configurations respectively.
144 TEST_JOBS_FACTOR ?= 1
145 TEST_JOBS_FACTOR_JDL ?= 1
146 TEST_JOBS_FACTOR_MACHINE ?= 1
147
148 ifeq ($(TEST_JOBS), 0)
149 CORES_DIVIDER := 2
150 # For some big multi-core machines with low ulimit -u setting we hit the max
151 # threads/process limit. In such a setup the memory/cores-only-guided
152 # TEST_JOBS config is insufficient. From experience a concurrency setting of
153 # 14 works reasonably well for low ulimit values (<= 4096). Thus, use
154 # divider 4096/14. For high ulimit -u values this shouldn't make a difference.
155 ULIMIT_DIVIDER := (4096/14)
156 PROC_ULIMIT := -1
157 ifneq ($(OPENJDK_TARGET_OS), windows)
158 PROC_ULIMIT := $(shell $(ULIMIT) -u)
159 ifeq ($(PROC_ULIMIT), unlimited)
160 PROC_ULIMIT := -1
161 endif
162 endif
163 MEMORY_DIVIDER := 2048
164 TEST_JOBS := $(shell $(AWK) \
165 'BEGIN { \
166 c = $(NUM_CORES) / $(CORES_DIVIDER); \
167 m = $(MEMORY_SIZE) / $(MEMORY_DIVIDER); \
168 u = $(PROC_ULIMIT); \
169 if (u > -1) { \
170 u = u / $(ULIMIT_DIVIDER); \
171 if (u < c) c = u; \
172 } \
173 if (c > m) c = m; \
174 c = c * $(TEST_JOBS_FACTOR); \
175 c = c * $(TEST_JOBS_FACTOR_JDL); \
176 c = c * $(TEST_JOBS_FACTOR_MACHINE); \
177 if (c < 1) c = 1; \
178 printf "%.0f", c; \
179 }')
180 endif
181
182 ################################################################################
183 # Parse control variables
184 ################################################################################
185
186 ifneq ($(TEST_OPTS), )
187 # Inform the user
188 $(info Running tests using TEST_OPTS control variable '$(TEST_OPTS)')
189 endif
190
191 ### Jtreg
192
193 $(eval $(call SetTestOpt,VM_OPTIONS,JTREG))
194 $(eval $(call SetTestOpt,JAVA_OPTIONS,JTREG))
195
196 $(eval $(call SetTestOpt,JOBS,JTREG))
197 $(eval $(call SetTestOpt,TIMEOUT_FACTOR,JTREG))
198 $(eval $(call SetTestOpt,FAILURE_HANDLER_TIMEOUT,JTREG))
199
200 $(eval $(call ParseKeywordVariable, JTREG, \
201 SINGLE_KEYWORDS := JOBS TIMEOUT_FACTOR FAILURE_HANDLER_TIMEOUT \
202 TEST_MODE ASSERT VERBOSE RETAIN MAX_MEM RUN_PROBLEM_LISTS \
203 RETRY_COUNT REPEAT_COUNT MAX_OUTPUT $(CUSTOM_JTREG_SINGLE_KEYWORDS), \
204 STRING_KEYWORDS := OPTIONS JAVA_OPTIONS VM_OPTIONS KEYWORDS \
205 EXTRA_PROBLEM_LISTS LAUNCHER_OPTIONS \
206 $(CUSTOM_JTREG_STRING_KEYWORDS), \
207 ))
208
209 ifneq ($(JTREG), )
210 # Inform the user
211 $(info Running tests using JTREG control variable '$(JTREG)')
212 endif
213
214 ### Gtest
215
216 $(eval $(call SetTestOpt,VM_OPTIONS,GTEST))
217 $(eval $(call SetTestOpt,JAVA_OPTIONS,GTEST))
218
219 $(eval $(call ParseKeywordVariable, GTEST, \
220 SINGLE_KEYWORDS := REPEAT, \
221 STRING_KEYWORDS := OPTIONS VM_OPTIONS JAVA_OPTIONS, \
222 ))
223
224 ifneq ($(GTEST), )
225 # Inform the user
226 $(info Running tests using GTEST control variable '$(GTEST)')
227 endif
228
229 ### Microbenchmarks
230
231 $(eval $(call SetTestOpt,VM_OPTIONS,MICRO))
232 $(eval $(call SetTestOpt,JAVA_OPTIONS,MICRO))
233
234 $(eval $(call ParseKeywordVariable, MICRO, \
235 SINGLE_KEYWORDS := ITER FORK TIME WARMUP_ITER WARMUP_TIME, \
236 STRING_KEYWORDS := OPTIONS JAVA_OPTIONS VM_OPTIONS RESULTS_FORMAT TEST_JDK \
237 BENCHMARKS_JAR, \
238 ))
239
240 ifneq ($(MICRO), )
241 # Inform the user
242 $(info Running tests using MICRO control variable '$(MICRO)')
243 endif
244
245
246 ################################################################################
247 # Component-specific Jtreg settings
248 ################################################################################
249
250 hotspot_JTREG_MAX_MEM := 0
251 hotspot_JTREG_ASSERT := false
252 hotspot_JTREG_NATIVEPATH := $(TEST_IMAGE_DIR)/hotspot/jtreg/native
253 jdk_JTREG_NATIVEPATH := $(TEST_IMAGE_DIR)/jdk/jtreg/native
254 lib-test_JTREG_NATIVEPATH := $(TEST_IMAGE_DIR)/lib-test/jtreg/native
255
256 jdk_JTREG_PROBLEM_LIST += $(TOPDIR)/test/jdk/ProblemList.txt
257 jaxp_JTREG_PROBLEM_LIST += $(TOPDIR)/test/jaxp/ProblemList.txt
258 langtools_JTREG_PROBLEM_LIST += $(TOPDIR)/test/langtools/ProblemList.txt
259 hotspot_JTREG_PROBLEM_LIST += $(TOPDIR)/test/hotspot/jtreg/ProblemList.txt
260 lib-test_JTREG_PROBLEM_LIST += $(TOPDIR)/test/lib-test/ProblemList.txt
261
262 ################################################################################
263 # Parse test selection
264 #
265 # The user has given a test selection in the TEST variable. We must parse it
266 # and determine what that means in terms of actual calls to the test framework.
267 #
268 # The parse functions take as argument a test specification as given by the
269 # user, and returns a fully qualified test descriptor if it was a match, or
270 # nothing if not. A single test specification can result in multiple test
271 # descriptors being returned. A valid test descriptor must always be accepted
272 # and returned identically.
273 ################################################################################
274
275 # Helper function to determine if a test specification is a Gtest test
276 #
277 # It is a Gtest test if it is either "gtest", or "gtest:" followed by an optional
278 # test filter string, and an optional "/<variant>" to select a specific JVM
279 # variant. If no variant is specified, all found variants are tested.
280 define ParseGtestTestSelection
281 $(if $(filter gtest%, $1), \
282 $(if $(filter gtest, $1), \
283 $(addprefix gtest:all/, $(GTEST_VARIANTS)) \
284 , \
285 $(if $(strip $(or $(filter gtest/%, $1) $(filter gtest:/%, $1))), \
286 $(patsubst gtest:/%, gtest:all/%, $(patsubst gtest/%, gtest:/%, $1)) \
287 , \
288 $(if $(filter gtest:%, $1), \
289 $(if $(findstring /, $1), \
290 $1 \
291 , \
292 $(addprefix $1/, $(GTEST_VARIANTS)) \
293 ) \
294 ) \
295 ) \
296 ) \
297 )
298 endef
299
300 # Helper function to determine if a test specification is a microbenchmark test
301 #
302 # It is a microbenchmark test if it is either "micro", or "micro:" followed by
303 # an optional test filter string.
304 define ParseMicroTestSelection
305 $(if $(filter micro%, $1), \
306 $(if $(filter micro, $1), \
307 micro:all \
308 , \
309 $(if $(filter micro:, $1), \
310 micro:all \
311 , \
312 $1 \
313 ) \
314 ) \
315 )
316 endef
317
318 # Helper function that removes the TOPDIR part
319 CleanupJtregPath = \
320 $(strip $(patsubst %/, %, $(subst $(JTREG_TOPDIR)/,, $1)))
321
322 # Take a partial Jtreg root path and return a full, absolute path to that Jtreg
323 # root. Also support having "hotspot" as an alias for "hotspot/jtreg".
324 ExpandJtregRoot = \
325 $(call CleanupJtregPath, $(wildcard \
326 $(if $(filter /%, $1), \
327 $(if $(wildcard $(strip $1)/TEST.ROOT), \
328 $1 \
329 ) \
330 , \
331 $(filter $(addprefix %, $1), $(JTREG_TESTROOTS) $(addsuffix /, $(JTREG_TESTROOTS))) \
332 $(filter $(addprefix %, $(strip $1)/jtreg), $(JTREG_TESTROOTS) $(addsuffix /, $(JTREG_TESTROOTS))) \
333 ) \
334 ))
335
336 # Take a partial Jtreg test path and return a full, absolute path to that Jtreg
337 # test. Also support having "hotspot" as an alias for "hotspot/jtreg".
338 ExpandJtregPath = \
339 $(if $(call ExpandJtregRoot, $1), \
340 $(call ExpandJtregRoot, $1) \
341 , \
342 $(call CleanupJtregPath, $(wildcard \
343 $(if $(filter /%, $1), \
344 $1 \
345 , \
346 $(addsuffix /$(strip $1), $(JTREG_TESTROOTS) $(TEST_BASEDIRS)) \
347 $(addsuffix $(strip $(patsubst hotspot/%, /hotspot/jtreg/%, $1)), $(JTREG_TESTROOTS) $(TEST_BASEDIRS)) \
348 ) \
349 )) \
350 )
351
352 # with test id: dir/Test.java#selection -> Test.java#selection -> .java#selection -> #selection
353 # without: dir/Test.java -> Test.java -> .java -> <<empty string>>
354 TestID = \
355 $(subst .java,,$(suffix $(notdir $1)))
356
357 # The test id starting with a hash (#testid) will be stripped by all
358 # evals in ParseJtregTestSelectionInner and will be reinserted by calling
359 # TestID (if it is present).
360 ParseJtregTestSelection = \
361 $(call IfAppend, $(call ParseJtregTestSelectionInner, $1), $(call TestID, $1))
362
363 # Helper function to determine if a test specification is a Jtreg test
364 #
365 # It is a Jtreg test if it optionally begins with jtreg:, and then is either
366 # an unspecified group name (possibly prefixed by :), or a group in a
367 # specified test root, or a path to a test or test directory,
368 # either absolute or relative to any of the TEST_BASEDIRS or test roots.
369 define ParseJtregTestSelectionInner
370 $(eval TEST_NAME := $(strip $(patsubst jtreg:%, %, $1))) \
371 $(if $(or $(findstring :, $(TEST_NAME)), $(findstring /, $(TEST_NAME))), , \
372 $(eval TEST_NAME := :$(TEST_NAME)) \
373 ) \
374 $(if $(findstring :, $(TEST_NAME)), \
375 $(if $(filter :%, $(TEST_NAME)), \
376 $(eval TEST_GROUP := $(patsubst :%, %, $(TEST_NAME))) \
377 $(eval TEST_ROOTS := $(foreach test_root, $(JTREG_TESTROOTS), \
378 $(call CleanupJtregPath, $(test_root)))) \
379 , \
380 $(eval TEST_PATH := $(word 1, $(subst :, $(SPACE), $(TEST_NAME)))) \
381 $(eval TEST_GROUP := $(word 2, $(subst :, $(SPACE), $(TEST_NAME)))) \
382 $(eval TEST_ROOTS := $(call ExpandJtregRoot, $(TEST_PATH))) \
383 ) \
384 $(foreach test_root, $(TEST_ROOTS), \
385 $(if $(filter /%, $(test_root)), \
386 jtreg:$(test_root):$(TEST_GROUP) \
387 , \
388 $(if $(filter $(TEST_GROUP), $($(JTREG_TOPDIR)/$(test_root)_JTREG_TEST_GROUPS)), \
389 jtreg:$(test_root):$(TEST_GROUP) \
390 ) \
391 ) \
392 ) \
393 , \
394 $(eval TEST_PATHS := $(call ExpandJtregPath, $(TEST_NAME))) \
395 $(foreach test_path, $(TEST_PATHS), \
396 jtreg:$(test_path) \
397 ) \
398 )
399 endef
400
401 # Helper function to determine if a test specification is a special test
402 #
403 # It is a special test if it is "special:" followed by a test name,
404 # if it is "make:" or "make-" followed by a make test, or any of the special
405 # test names as a single word.
406 define ParseSpecialTestSelection
407 $(if $(filter special:%, $1), \
408 $1 \
409 ) \
410 $(if $(filter make%, $1), \
411 $(if $(filter make:%, $1), \
412 special:$(strip $1) \
413 ) \
414 $(if $(filter make-%, $1), \
415 special:$(patsubst make-%,make:%, $1) \
416 ) \
417 $(if $(filter make, $1), \
418 special:make:all \
419 )
420 ) \
421 $(if $(filter failure-handler, $1), \
422 special:$(strip $1) \
423 )
424 endef
425
426 ifeq ($(TEST), )
427 $(info No test selection given in TEST!)
428 $(info Please use e.g. 'make test TEST=tier1' or 'make test-tier1')
429 $(info See doc/testing.[md|html] for help)
430 $(error Cannot continue)
431 endif
432
433 ParseTestSelection = \
434 $(strip $(or \
435 $(call ParseCustomTestSelection, $1) \
436 $(call ParseGtestTestSelection, $1) \
437 $(call ParseMicroTestSelection, $1) \
438 $(call ParseJtregTestSelection, $1) \
439 $(call ParseSpecialTestSelection, $1) \
440 ))
441
442 # Now intelligently convert the test selection given by the user in TEST
443 # into a list of fully qualified test descriptors of the tests to run.
444 TESTS_TO_RUN := $(strip $(foreach test, $(TEST), $(call ParseTestSelection, $(test))))
445 UNKNOWN_TEST := $(strip $(foreach test, $(TEST), $(if $(call ParseTestSelection, $(test)), , $(test))))
446
447 ifneq ($(UNKNOWN_TEST), )
448 $(info Unknown test selection: '$(UNKNOWN_TEST)')
449 $(info See doc/testing.[md|html] for help)
450 $(error Cannot continue)
451 endif
452
453 # Present the result of our parsing to the user
454 $(info Test selection '$(TEST)', will run:)
455 $(foreach test, $(TESTS_TO_RUN), $(info * $(test)))
456
457
458 ################################################################################
459 # Functions for setting up rules for running the selected tests
460 #
461 # The SetupRun*Test functions all have the same interface:
462 #
463 # Parameter 1 is the name of the rule. This is the test id, based on the test
464 # descriptor, and this is also used as variable prefix, and the targets
465 # generated are listed in a variable by that name.
466 #
467 # Remaining parameters are named arguments. Currently this is only:
468 # TEST -- The properly formatted fully qualified test descriptor
469 #
470 # After the rule named by the test id has been executed, the following
471 # variables will be available:
472 # testid_TOTAL - the total number of tests run
473 # testid_PASSED - the number of successful tests
474 # testid_FAILED - the number of failed tests
475 # testid_ERROR - the number of tests was neither successful or failed
476 #
477 ################################################################################
478
479 ### Rules for Gtest
480
481 SetupRunGtestTest = $(NamedParamsMacroTemplate)
482 define SetupRunGtestTestBody
483 $1_TEST_RESULTS_DIR := $$(TEST_RESULTS_DIR)/$1
484 $1_TEST_SUPPORT_DIR := $$(TEST_SUPPORT_DIR)/$1
485 $1_EXITCODE := $$($1_TEST_RESULTS_DIR)/exitcode.txt
486
487 $1_VARIANT := $$(lastword $$(subst /, , $$($1_TEST)))
488 ifeq ($$(filter $$($1_VARIANT), $$(GTEST_VARIANTS)), )
489 $$(error Invalid gtest variant '$$($1_VARIANT)'. Valid variants: $$(GTEST_VARIANTS))
490 endif
491 $1_TEST_NAME := $$(strip $$(patsubst %/$$($1_VARIANT), %, \
492 $$(patsubst gtest:%, %, $$($1_TEST))))
493 ifneq ($$($1_TEST_NAME), all)
494 $1_GTEST_FILTER := --gtest_filter=$$($1_TEST_NAME)*
495 endif
496
497 ifneq ($$(GTEST_REPEAT), )
498 $1_GTEST_REPEAT :=--gtest_repeat=$$(GTEST_REPEAT)
499 endif
500
501 run-test-$1: pre-run-test
502 $$(call LogWarn)
503 $$(call LogWarn, Running test '$$($1_TEST)')
504 $$(call MakeDir, $$($1_TEST_RESULTS_DIR) $$($1_TEST_SUPPORT_DIR))
505 $$(call ExecuteWithLog, $$($1_TEST_SUPPORT_DIR)/gtest, ( \
506 $$(CD) $$($1_TEST_SUPPORT_DIR) && \
507 $$(FIXPATH) $$(TEST_IMAGE_DIR)/hotspot/gtest/$$($1_VARIANT)/gtestLauncher \
508 -jdk $(JDK_UNDER_TEST) $$($1_GTEST_FILTER) \
509 --gtest_output=xml:$$($1_TEST_RESULTS_DIR)/gtest.xml \
510 --gtest_catch_exceptions=0 \
511 $$($1_GTEST_REPEAT) $$(GTEST_OPTIONS) $$(GTEST_VM_OPTIONS) \
512 $$(GTEST_JAVA_OPTIONS) \
513 > >($(TEE) $$($1_TEST_RESULTS_DIR)/gtest.txt) \
514 && $$(ECHO) $$$$? > $$($1_EXITCODE) \
515 || $$(ECHO) $$$$? > $$($1_EXITCODE) \
516 ))
517
518 $1_RESULT_FILE := $$($1_TEST_RESULTS_DIR)/gtest.txt
519
520 parse-test-$1: run-test-$1
521 $$(call LogWarn, Finished running test '$$($1_TEST)')
522 $$(call LogWarn, Test report is stored in $$(strip \
523 $$(subst $$(TOPDIR)/, , $$($1_TEST_RESULTS_DIR))))
524 $$(if $$(wildcard $$($1_RESULT_FILE)), \
525 $$(eval $1_TOTAL := $$(shell $$(AWK) '/==========.* tests? from .* \
526 test (cases?|suites?) ran/ { print $$$$2 }' $$($1_RESULT_FILE))) \
527 $$(if $$($1_TOTAL), , $$(eval $1_TOTAL := 0)) \
528 $$(eval $1_PASSED := $$(shell $$(AWK) '/\[ PASSED \] .* tests?./ \
529 { print $$$$4 }' $$($1_RESULT_FILE))) \
530 $$(if $$($1_PASSED), , $$(eval $1_PASSED := 0)) \
531 $$(eval $1_FAILED := $$(shell $$(AWK) '/\[ FAILED \] .* tests?, \
532 listed below/ { print $$$$4 }' $$($1_RESULT_FILE))) \
533 $$(if $$($1_FAILED), , $$(eval $1_FAILED := 0)) \
534 $$(eval $1_ERROR := $$(shell \
535 $$(EXPR) $$($1_TOTAL) - $$($1_PASSED) - $$($1_FAILED))) \
536 , \
537 $$(eval $1_PASSED := 0) \
538 $$(eval $1_FAILED := 0) \
539 $$(eval $1_ERROR := 1) \
540 $$(eval $1_TOTAL := 1) \
541 )
542
543 $1: run-test-$1 parse-test-$1
544
545 TARGETS += $1 run-test-$1 parse-test-$1
546 TEST_TARGETS += parse-test-$1
547
548 endef
549
550 ################################################################################
551
552 ### Rules for Microbenchmarks
553
554 # Helper function for SetupRunMicroTest. Set a MICRO_* variable from, in order:
555 # 1) Specified by user on command line
556 # 2) Generic default
557 #
558 # Note: No spaces are allowed around the arguments.
559 # Arg $1 The test ID (i.e. $1 in SetupRunMicroTest)
560 # Arg $2 Base variable, e.g. MICRO_TEST_JDK
561 # Arg $3 The default value (optional)
562 define SetMicroValue
563 ifneq ($$($2), )
564 $1_$2 := $$($2)
565 else
566 ifneq ($3, )
567 $1_$2 := $3
568 endif
569 endif
570 endef
571
572 SetupRunMicroTest = $(NamedParamsMacroTemplate)
573 define SetupRunMicroTestBody
574 $1_TEST_RESULTS_DIR := $$(TEST_RESULTS_DIR)/$1
575 $1_TEST_SUPPORT_DIR := $$(TEST_SUPPORT_DIR)/$1
576 $1_EXITCODE := $$($1_TEST_RESULTS_DIR)/exitcode.txt
577
578 $1_TEST_NAME := $$(strip $$(patsubst micro:%, %, $$($1_TEST)))
579
580 $$(eval $$(call SetMicroValue,$1,MICRO_BENCHMARKS_JAR,$$(TEST_IMAGE_DIR)/micro/benchmarks.jar))
581 $$(eval $$(call SetMicroValue,$1,MICRO_TEST_JDK,$$(JDK_UNDER_TEST)))
582 $$(eval $$(call SetMicroValue,$1,MICRO_JAVA_OPTIONS))
583
584 # Current tests needs to open java.io
585 $1_MICRO_JAVA_OPTIONS += --add-opens=java.base/java.io=ALL-UNNAMED
586
587 # Save output as JSON or CSV file
588 ifneq ($$(MICRO_RESULTS_FORMAT), )
589 $1_MICRO_BASIC_OPTIONS += -rf $$(MICRO_RESULTS_FORMAT)
590 $1_MICRO_BASIC_OPTIONS += -rff $$($1_TEST_RESULTS_DIR)/jmh-result.$(MICRO_RESULTS_FORMAT)
591 endif
592
593 # Set library path for native dependencies
594 $1_JMH_JVM_ARGS := -Djava.library.path=$$(TEST_IMAGE_DIR)/micro/native
595
596 ifneq ($$(MICRO_VM_OPTIONS)$$(MICRO_JAVA_OPTIONS), )
597 $1_JMH_JVM_ARGS += $$(MICRO_VM_OPTIONS) $$(MICRO_JAVA_OPTIONS)
598 endif
599
600 $1_MICRO_VM_OPTIONS := -jvmArgs $(call ShellQuote,$$($1_JMH_JVM_ARGS))
601
602 ifneq ($$(MICRO_ITER), )
603 $1_MICRO_ITER := -i $$(MICRO_ITER)
604 endif
605 ifneq ($$(MICRO_FORK), )
606 $1_MICRO_FORK := -f $$(MICRO_FORK)
607 endif
608 ifneq ($$(MICRO_TIME), )
609 $1_MICRO_TIME := -r $$(MICRO_TIME)
610 endif
611 ifneq ($$(MICRO_WARMUP_ITER), )
612 $1_MICRO_WARMUP_ITER := -wi $$(MICRO_WARMUP_ITER)
613 endif
614 ifneq ($$(MICRO_WARMUP_TIME), )
615 $1_MICRO_WARMUP_TIME := -w $$(MICRO_WARMUP_TIME)
616 endif
617
618 run-test-$1: pre-run-test
619 $$(call LogWarn)
620 $$(call LogWarn, Running test '$$($1_TEST)')
621 $$(call MakeDir, $$($1_TEST_RESULTS_DIR) $$($1_TEST_SUPPORT_DIR))
622 $$(call ExecuteWithLog, $$($1_TEST_SUPPORT_DIR)/micro, ( \
623 $$(FIXPATH) $$($1_MICRO_TEST_JDK)/bin/java $$($1_MICRO_JAVA_OPTIONS) \
624 -jar $$($1_MICRO_BENCHMARKS_JAR) \
625 $$($1_MICRO_ITER) $$($1_MICRO_FORK) $$($1_MICRO_TIME) \
626 $$($1_MICRO_WARMUP_ITER) $$($1_MICRO_WARMUP_TIME) \
627 $$($1_MICRO_VM_OPTIONS) $$($1_MICRO_BASIC_OPTIONS) $$(MICRO_OPTIONS) \
628 $$($1_TEST_NAME) \
629 > >($(TEE) $$($1_TEST_RESULTS_DIR)/micro.txt) \
630 && $$(ECHO) $$$$? > $$($1_EXITCODE) \
631 || $$(ECHO) $$$$? > $$($1_EXITCODE) \
632 ))
633
634 $1_RESULT_FILE := $$($1_TEST_RESULTS_DIR)/micro.txt
635
636 parse-test-$1: run-test-$1
637 $$(call LogWarn, Finished running test '$$($1_TEST)')
638 $$(call LogWarn, Test report is stored in $$(strip \
639 $$(subst $$(TOPDIR)/, , $$($1_TEST_RESULTS_DIR))))
640 $$(if $$(wildcard $$($1_EXITCODE)), \
641 $$(eval $1_EXIT_CODE := $$(shell $$(CAT) $$($1_EXITCODE))) \
642 $$(if $$(filter 0, $$($1_EXIT_CODE)), \
643 $$(eval $1_PASSED := 1) \
644 $$(eval $1_ERROR := 0) \
645 , \
646 $$(eval $1_PASSED := 0) \
647 $$(eval $1_ERROR := 1) \
648 ) \
649 $$(eval $1_FAILED := 0) \
650 $$(eval $1_TOTAL := $$(shell \
651 $$(EXPR) $$($1_PASSED) + $$($1_ERROR))) \
652 , \
653 $$(eval $1_PASSED := 0) \
654 $$(eval $1_FAILED := 0) \
655 $$(eval $1_ERROR := 1) \
656 $$(eval $1_TOTAL := 1) \
657 )
658
659 $1: run-test-$1 parse-test-$1
660
661 TARGETS += $1 run-test-$1 parse-test-$1
662 TEST_TARGETS += parse-test-$1
663
664 endef
665
666 ################################################################################
667
668 ### Rules for Jtreg
669
670 # Helper function for SetupRunJtregTest. Set a JTREG_* variable from, in order:
671 # 1) Specified by user on command line
672 # 2) Component-specific default
673 # 3) Generic default
674 #
675 # Note: No spaces are allowed around the arguments.
676 # Arg $1 The test ID (i.e. $1 in SetupRunJtregTest)
677 # Arg $2 Base variable, e.g. JTREG_JOBS
678 # Arg $3 The default value (optional)
679 define SetJtregValue
680 ifneq ($$($2), )
681 $1_$2 := $$($2)
682 else
683 ifneq ($$($$($1_COMPONENT)_$2), )
684 $1_$2 := $$($$($1_COMPONENT)_$2)
685 else
686 ifneq ($3, )
687 $1_$2 := $3
688 endif
689 endif
690 endif
691 endef
692
693 SetupRunJtregTest = $(NamedParamsMacroTemplate)
694 define SetupRunJtregTestBody
695 $1_TEST_RESULTS_DIR := $$(TEST_RESULTS_DIR)/$1
696 $1_TEST_SUPPORT_DIR := $$(TEST_SUPPORT_DIR)/$1
697 $1_EXITCODE := $$($1_TEST_RESULTS_DIR)/exitcode.txt
698
699 $1_TEST_NAME := $$(strip $$(patsubst jtreg:%, %, $$($1_TEST)))
700
701 $1_TEST_ROOT := \
702 $$(strip $$(foreach root, $$(JTREG_TESTROOTS), \
703 $$(if $$(filter $$(root)%, $$(JTREG_TOPDIR)/$$($1_TEST_NAME)), $$(root)) \
704 ))
705 $1_COMPONENT := $$(lastword $$(subst /, $$(SPACE), $$($1_TEST_ROOT)))
706 # This will work only as long as just hotspot has the additional "jtreg" directory
707 ifeq ($$($1_COMPONENT), jtreg)
708 $1_COMPONENT := hotspot
709 endif
710
711 ifeq ($$(JT_HOME), )
712 $$(info Error: jtreg framework is not found.)
713 $$(info Please run configure using --with-jtreg.)
714 $$(error Cannot continue)
715 endif
716
717 # Unfortunately, we need different defaults for some JTREG values,
718 # depending on what component we're running.
719
720 # Convert JTREG_foo into $1_JTREG_foo with a suitable value.
721 $$(eval $$(call SetJtregValue,$1,JTREG_TEST_MODE,agentvm))
722 $$(eval $$(call SetJtregValue,$1,JTREG_ASSERT,true))
723 $$(eval $$(call SetJtregValue,$1,JTREG_MAX_MEM,768m))
724 $$(eval $$(call SetJtregValue,$1,JTREG_NATIVEPATH))
725 $$(eval $$(call SetJtregValue,$1,JTREG_BASIC_OPTIONS))
726 $$(eval $$(call SetJtregValue,$1,JTREG_PROBLEM_LIST))
727
728 # Only the problem list for the current test root should be used.
729 $1_JTREG_PROBLEM_LIST := $$(filter $$($1_TEST_ROOT)%, $$($1_JTREG_PROBLEM_LIST))
730
731 ifneq ($(TEST_JOBS), 0)
732 $$(eval $$(call SetJtregValue,$1,JTREG_JOBS,$$(TEST_JOBS)))
733 else
734 $$(eval $$(call SetJtregValue,$1,JTREG_JOBS,$$(JOBS)))
735 endif
736
737 # Make sure MaxRAMPercentage is high enough to not cause OOM or swapping since
738 # we may end up with a lot of JVM's
739 $1_JTREG_MAX_RAM_PERCENTAGE := $$(shell $(AWK) 'BEGIN { print 25 / $$($1_JTREG_JOBS); }')
740
741 JTREG_TIMEOUT_FACTOR ?= 4
742
743 JTREG_VERBOSE ?= fail,error,summary
744 JTREG_RETAIN ?= fail,error
745 JTREG_RUN_PROBLEM_LISTS ?= false
746 JTREG_RETRY_COUNT ?= 0
747 JTREG_REPEAT_COUNT ?= 0
748
749 ifneq ($$(JTREG_RETRY_COUNT), 0)
750 ifneq ($$(JTREG_REPEAT_COUNT), 0)
751 $$(info Error: Cannot use both JTREG_RETRY_COUNT and JTREG_REPEAT_COUNT together.)
752 $$(info Please choose one or the other.)
753 $$(error Cannot continue)
754 endif
755 endif
756
757 ifneq ($$(JTREG_LAUNCHER_OPTIONS), )
758 $1_JTREG_LAUNCHER_OPTIONS += $$(JTREG_LAUNCHER_OPTIONS)
759 endif
760
761 ifneq ($$(JTREG_MAX_OUTPUT), )
762 $1_JTREG_LAUNCHER_OPTIONS += -Djavatest.maxOutputSize=$$(JTREG_MAX_OUTPUT)
763 endif
764
765 ifneq ($$($1_JTREG_MAX_MEM), 0)
766 $1_JTREG_BASIC_OPTIONS += -vmoption:-Xmx$$($1_JTREG_MAX_MEM)
767 $1_JTREG_LAUNCHER_OPTIONS += -Xmx$$($1_JTREG_MAX_MEM)
768 endif
769
770 # Make sure the tmp dir is normalized as some tests will react badly otherwise
771 $1_TEST_TMP_DIR := $$(abspath $$($1_TEST_SUPPORT_DIR)/tmp)
772
773 $1_JTREG_BASIC_OPTIONS += -$$($1_JTREG_TEST_MODE) \
774 -verbose:$$(JTREG_VERBOSE) -retain:$$(JTREG_RETAIN) \
775 -concurrency:$$($1_JTREG_JOBS) -timeoutFactor:$$(JTREG_TIMEOUT_FACTOR) \
776 -vmoption:-XX:MaxRAMPercentage=$$($1_JTREG_MAX_RAM_PERCENTAGE) \
777 -vmoption:-Djava.io.tmpdir="$$($1_TEST_TMP_DIR)"
778
779 $1_JTREG_BASIC_OPTIONS += -automatic -ignore:quiet
780
781 # Make it possible to specify the JIB_DATA_DIR for tests using the
782 # JIB Artifact resolver
783 $1_JTREG_BASIC_OPTIONS += -e:JIB_DATA_DIR
784 # If running on Windows, propagate the _NT_SYMBOL_PATH to enable
785 # symbol lookup in hserr files
786 ifeq ($$(call isTargetOs, windows), true)
787 $1_JTREG_BASIC_OPTIONS += -e:_NT_SYMBOL_PATH
788 else ifeq ($$(call isTargetOs, linux), true)
789 $1_JTREG_BASIC_OPTIONS += -e:_JVM_DWARF_PATH=$$(SYMBOLS_IMAGE_DIR)
790 endif
791
792 $1_JTREG_BASIC_OPTIONS += \
793 $$(addprefix -javaoption:, $$(JTREG_JAVA_OPTIONS)) \
794 $$(addprefix -vmoption:, $$(JTREG_VM_OPTIONS)) \
795 #
796
797 ifeq ($$($1_JTREG_ASSERT), true)
798 $1_JTREG_BASIC_OPTIONS += -ea -esa
799 endif
800
801 ifneq ($$($1_JTREG_NATIVEPATH), )
802 $1_JTREG_BASIC_OPTIONS += -nativepath:$$($1_JTREG_NATIVEPATH)
803 endif
804
805 ifeq ($$(JTREG_RUN_PROBLEM_LISTS), true)
806 JTREG_PROBLEM_LIST_PREFIX := -match:
807 else
808 JTREG_PROBLEM_LIST_PREFIX := -exclude:
809 endif
810
811 ifneq ($$($1_JTREG_PROBLEM_LIST), )
812 $1_JTREG_BASIC_OPTIONS += $$(addprefix $$(JTREG_PROBLEM_LIST_PREFIX), $$($1_JTREG_PROBLEM_LIST))
813 endif
814
815 ifneq ($$(JTREG_EXTRA_PROBLEM_LISTS), )
816 # Accept both absolute paths as well as relative to the current test root.
817 $1_JTREG_BASIC_OPTIONS += $$(addprefix $$(JTREG_PROBLEM_LIST_PREFIX), $$(wildcard \
818 $$(JTREG_EXTRA_PROBLEM_LISTS) \
819 $$(addprefix $$($1_TEST_ROOT)/, $$(JTREG_EXTRA_PROBLEM_LISTS)) \
820 ))
821 endif
822
823 ifneq ($$(JIB_HOME), )
824 $1_JTREG_BASIC_OPTIONS += -e:JIB_HOME=$$(JIB_HOME)
825 endif
826
827 $1_JTREG_BASIC_OPTIONS += -e:TEST_IMAGE_DIR=$(TEST_IMAGE_DIR)
828
829 ifneq ($$(JTREG_FAILURE_HANDLER_OPTIONS), )
830 $1_JTREG_LAUNCHER_OPTIONS += -Djava.library.path="$(JTREG_FAILURE_HANDLER_DIR)"
831 endif
832
833 ifneq ($$(JTREG_KEYWORDS), )
834 # The keywords string may contain problematic characters and may be quoted
835 # already when it arrives here. Remove any existing quotes and replace them
836 # with one set of single quotes.
837 $1_JTREG_KEYWORDS := \
838 $$(strip $$(subst $$(SQUOTE),,$$(subst $$(DQUOTE),,$$(JTREG_KEYWORDS))))
839 ifneq ($$($1_JTREG_KEYWORDS), )
840 $1_JTREG_BASIC_OPTIONS += -k:'$$($1_JTREG_KEYWORDS)'
841 endif
842 endif
843
844 $$(eval $$(call SetupRunJtregTestCustom, $1))
845
846 clean-workdir-$1:
847 $$(RM) -r $$($1_TEST_SUPPORT_DIR)
848
849 $1_COMMAND_LINE := \
850 $$(JAVA) $$($1_JTREG_LAUNCHER_OPTIONS) \
851 -Dprogram=jtreg -jar $$(JT_HOME)/lib/jtreg.jar \
852 $$($1_JTREG_BASIC_OPTIONS) \
853 -testjdk:$$(JDK_UNDER_TEST) \
854 -dir:$$(JTREG_TOPDIR) \
855 -reportDir:$$($1_TEST_RESULTS_DIR) \
856 -workDir:$$($1_TEST_SUPPORT_DIR) \
857 $$$${JTREG_STATUS} \
858 $$(JTREG_OPTIONS) \
859 $$(JTREG_FAILURE_HANDLER_OPTIONS) \
860 $$(JTREG_COV_OPTIONS) \
861 $$($1_TEST_NAME) \
862 && $$(ECHO) $$$$? > $$($1_EXITCODE) \
863 || $$(ECHO) $$$$? > $$($1_EXITCODE)
864
865
866 ifneq ($$(JTREG_RETRY_COUNT), 0)
867 $1_COMMAND_LINE := \
868 for i in {0..$$(JTREG_RETRY_COUNT)}; do \
869 if [ "$$$$i" != 0 ]; then \
870 $$(PRINTF) "\nRetrying Jtreg run. Attempt: $$$$i\n"; \
871 fi; \
872 $$($1_COMMAND_LINE); \
873 if [ "`$$(CAT) $$($1_EXITCODE)`" = "0" ]; then \
874 break; \
875 fi; \
876 export JTREG_STATUS="-status:error,fail"; \
877 done
878 endif
879
880 ifneq ($$(JTREG_REPEAT_COUNT), 0)
881 $1_COMMAND_LINE := \
882 for i in {1..$$(JTREG_REPEAT_COUNT)}; do \
883 $$(PRINTF) "\nRepeating Jtreg run: $$$$i out of $$(JTREG_REPEAT_COUNT)\n"; \
884 $$($1_COMMAND_LINE); \
885 if [ "`$$(CAT) $$($1_EXITCODE)`" != "0" ]; then \
886 $$(PRINTF) "\nFailures detected, no more repeats.\n"; \
887 break; \
888 fi; \
889 done
890 endif
891
892 run-test-$1: pre-run-test clean-workdir-$1
893 $$(call LogWarn)
894 $$(call LogWarn, Running test '$$($1_TEST)')
895 $$(call MakeDir, $$($1_TEST_RESULTS_DIR) $$($1_TEST_SUPPORT_DIR) \
896 $$($1_TEST_TMP_DIR))
897 $$(call ExecuteWithLog, $$($1_TEST_SUPPORT_DIR)/jtreg, ( \
898 $$(COV_ENVIRONMENT) $$($1_COMMAND_LINE) \
899 ))
900
901 $1_RESULT_FILE := $$($1_TEST_RESULTS_DIR)/text/stats.txt
902
903 parse-test-$1: run-test-$1
904 $$(call LogWarn, Finished running test '$$($1_TEST)')
905 $$(call LogWarn, Test report is stored in $$(strip \
906 $$(subst $$(TOPDIR)/, , $$($1_TEST_RESULTS_DIR))))
907 $$(if $$(wildcard $$($1_RESULT_FILE)), \
908 $$(eval $1_PASSED := $$(shell $$(AWK) '{ gsub(/[,;]/, ""); \
909 for (i=1; i<=NF; i++) { if ($$$$i == "passed:") \
910 print $$$$(i+1) } }' $$($1_RESULT_FILE))) \
911 $$(if $$($1_PASSED), , $$(eval $1_PASSED := 0)) \
912 $$(eval $1_FAILED := $$(shell $$(AWK) '{gsub(/[,;]/, ""); \
913 for (i=1; i<=NF; i++) { if ($$$$i == "failed:") \
914 print $$$$(i+1) } }' $$($1_RESULT_FILE))) \
915 $$(if $$($1_FAILED), , $$(eval $1_FAILED := 0)) \
916 $$(eval $1_ERROR := $$(shell $$(AWK) '{gsub(/[,;]/, ""); \
917 for (i=1; i<=NF; i++) { if ($$$$i == "error:") \
918 print $$$$(i+1) } }' $$($1_RESULT_FILE))) \
919 $$(if $$($1_ERROR), , $$(eval $1_ERROR := 0)) \
920 $$(eval $1_TOTAL := $$(shell \
921 $$(EXPR) $$($1_PASSED) + $$($1_FAILED) + $$($1_ERROR))) \
922 , \
923 $$(eval $1_PASSED := 0) \
924 $$(eval $1_FAILED := 0) \
925 $$(eval $1_ERROR := 1) \
926 $$(eval $1_TOTAL := 1) \
927 )
928
929 $1: run-test-$1 parse-test-$1 clean-workdir-$1
930
931 TARGETS += $1 run-test-$1 parse-test-$1 clean-workdir-$1
932 TEST_TARGETS += parse-test-$1
933
934 endef
935
936 ################################################################################
937
938 ### Rules for special tests
939
940 SetupRunSpecialTest = $(NamedParamsMacroTemplate)
941 define SetupRunSpecialTestBody
942 $1_TEST_RESULTS_DIR := $$(TEST_RESULTS_DIR)/$1
943 $1_TEST_SUPPORT_DIR := $$(TEST_SUPPORT_DIR)/$1
944 $1_EXITCODE := $$($1_TEST_RESULTS_DIR)/exitcode.txt
945
946 $1_FULL_TEST_NAME := $$(strip $$(patsubst special:%, %, $$($1_TEST)))
947 ifneq ($$(findstring :, $$($1_FULL_TEST_NAME)), )
948 $1_TEST_NAME := $$(firstword $$(subst :, ,$$($1_FULL_TEST_NAME)))
949 $1_TEST_ARGS := $$(strip $$(patsubst special:$$($1_TEST_NAME):%, %, $$($1_TEST)))
950 else
951 $1_TEST_NAME := $$($1_FULL_TEST_NAME)
952 $1_TEST_ARGS :=
953 endif
954
955 ifeq ($$($1_TEST_NAME), failure-handler)
956 ifeq ($(BUILD_FAILURE_HANDLER), true)
957 $1_TEST_COMMAND_LINE := \
958 ($(CD) $(TOPDIR)/make/test && $(MAKE) $(MAKE_ARGS) -f \
959 BuildFailureHandler.gmk test)
960 else
961 $$(error Cannot test failure handler if it is not built)
962 endif
963 else ifeq ($$($1_TEST_NAME), make)
964 $1_TEST_COMMAND_LINE := \
965 ($(CD) $(TOPDIR)/test/make && $(MAKE) $(MAKE_ARGS) -f \
966 TestMake.gmk $$($1_TEST_ARGS) TEST_SUPPORT_DIR="$$($1_TEST_SUPPORT_DIR)")
967 else
968 $$(error Invalid special test specification: $$($1_TEST_NAME))
969 endif
970
971 run-test-$1: pre-run-test
972 $$(call LogWarn)
973 $$(call LogWarn, Running test '$$($1_TEST)')
974 $$(call MakeDir, $$($1_TEST_RESULTS_DIR) $$($1_TEST_SUPPORT_DIR))
975 $$(call ExecuteWithLog, $$($1_TEST_SUPPORT_DIR)/test-execution, ( \
976 $$($1_TEST_COMMAND_LINE) \
977 > >($(TEE) $$($1_TEST_RESULTS_DIR)/test-output.txt) \
978 && $$(ECHO) $$$$? > $$($1_EXITCODE) \
979 || $$(ECHO) $$$$? > $$($1_EXITCODE) \
980 ))
981
982 $1_RESULT_FILE := $$($1_TEST_RESULTS_DIR)/gtest.txt
983
984 # We can not parse the various "special" tests.
985 parse-test-$1: run-test-$1
986 $$(call LogWarn, Finished running test '$$($1_TEST)')
987 $$(call LogWarn, Test report is stored in $$(strip \
988 $$(subst $$(TOPDIR)/, , $$($1_TEST_RESULTS_DIR))))
989 $$(call LogWarn, Warning: Special test results are not properly parsed!)
990 $$(eval $1_PASSED := $$(shell \
991 if [ `$(CAT) $$($1_EXITCODE)` = "0" ]; then $(ECHO) 1; else $(ECHO) 0; fi \
992 ))
993 $$(eval $1_FAILED := $$(shell \
994 if [ `$(CAT) $$($1_EXITCODE)` = "0" ]; then $(ECHO) 0; else $(ECHO) 1; fi \
995 ))
996 $$(eval $1_ERROR := 0)
997 $$(eval $1_TOTAL := 1)
998
999 $1: run-test-$1 parse-test-$1
1000
1001 TARGETS += $1 run-test-$1 parse-test-$1
1002 TEST_TARGETS += parse-test-$1
1003
1004 endef
1005
1006 ################################################################################
1007 # Setup and execute make rules for all selected tests
1008 ################################################################################
1009
1010 # Helper function to determine which handler to use for the given test
1011 UseGtestTestHandler = \
1012 $(if $(filter gtest:%, $1), true)
1013
1014 UseMicroTestHandler = \
1015 $(if $(filter micro:%, $1), true)
1016
1017 UseJtregTestHandler = \
1018 $(if $(filter jtreg:%, $1), true)
1019
1020 UseSpecialTestHandler = \
1021 $(if $(filter special:%, $1), true)
1022
1023 # Now process each test to run and setup a proper make rule
1024 $(foreach test, $(TESTS_TO_RUN), \
1025 $(eval TEST_ID := $(shell $(ECHO) $(strip $(test)) | \
1026 $(TR) -cs '[a-z][A-Z][0-9]\n' '[_*1000]')) \
1027 $(eval ALL_TEST_IDS += $(TEST_ID)) \
1028 $(if $(call UseCustomTestHandler, $(test)), \
1029 $(eval $(call SetupRunCustomTest, $(TEST_ID), \
1030 TEST := $(test), \
1031 )) \
1032 ) \
1033 $(if $(call UseGtestTestHandler, $(test)), \
1034 $(eval $(call SetupRunGtestTest, $(TEST_ID), \
1035 TEST := $(test), \
1036 )) \
1037 ) \
1038 $(if $(call UseMicroTestHandler, $(test)), \
1039 $(eval $(call SetupRunMicroTest, $(TEST_ID), \
1040 TEST := $(test), \
1041 )) \
1042 ) \
1043 $(if $(call UseJtregTestHandler, $(test)), \
1044 $(eval $(call SetupRunJtregTest, $(TEST_ID), \
1045 TEST := $(test), \
1046 )) \
1047 ) \
1048 $(if $(call UseSpecialTestHandler, $(test)), \
1049 $(eval $(call SetupRunSpecialTest, $(TEST_ID), \
1050 TEST := $(test), \
1051 )) \
1052 ) \
1053 )
1054
1055 # Sort also removes duplicates, so if there is any we'll get fewer words.
1056 ifneq ($(words $(ALL_TEST_IDS)), $(words $(sort $(ALL_TEST_IDS))))
1057 $(error Duplicate test specification)
1058 endif
1059
1060
1061 ################################################################################
1062 # The main target for RunTests.gmk
1063 ################################################################################
1064
1065 #
1066 # Provide hooks for adding functionality before and after all tests are run.
1067 #
1068
1069 $(call LogInfo, RunTest setup starting)
1070
1071 # This target depends on all actual test having been run (TEST_TARGETS has beeen
1072 # populated by the SetupRun*Test functions). If you need to provide a teardown
1073 # hook, you must let it depend on this target.
1074 run-all-tests: $(TEST_TARGETS)
1075 $(call LogInfo, RunTest teardown starting)
1076
1077 # This is an abstract target that will be run before any actual tests. Add your
1078 # target as a dependency to thisif you need "setup" type functionality executed
1079 # before all tests.
1080 pre-run-test:
1081 $(call LogInfo, RunTest setup done)
1082
1083 # This is an abstract target that will be run after all actual tests, but before
1084 # the test summary. If you need "teardown" type functionality, add your target
1085 # as a dependency on this, and let the teardown target depend on run-all-tests.
1086 post-run-test: run-all-tests
1087 $(call LogInfo, RunTest teardown done)
1088
1089 #
1090 # Create and print a table of the result of all tests run
1091 #
1092 TEST_FAILURE := false
1093
1094 run-test-report: post-run-test
1095 $(RM) $(TEST_SUMMARY).old 2> /dev/null
1096 $(MV) $(TEST_SUMMARY) $(TEST_SUMMARY).old 2> /dev/null || true
1097 $(RM) $(TEST_LAST_IDS).old 2> /dev/null
1098 $(MV) $(TEST_LAST_IDS) $(TEST_LAST_IDS).old 2> /dev/null || true
1099 $(ECHO) >> $(TEST_SUMMARY) ==============================
1100 $(ECHO) >> $(TEST_SUMMARY) Test summary
1101 $(ECHO) >> $(TEST_SUMMARY) ==============================
1102 $(PRINTF) >> $(TEST_SUMMARY) "%2s %-49s %5s %5s %5s %5s %2s\n" " " \
1103 TEST TOTAL PASS FAIL ERROR " "
1104 $(foreach test, $(TESTS_TO_RUN), \
1105 $(eval TEST_ID := $(shell $(ECHO) $(strip $(test)) | \
1106 $(TR) -cs '[a-z][A-Z][0-9]\n' '[_*1000]')) \
1107 $(ECHO) >> $(TEST_LAST_IDS) $(TEST_ID) $(NEWLINE) \
1108 $(eval NAME_PATTERN := $(shell $(ECHO) $(test) | $(TR) -c '\n' '[_*1000]')) \
1109 $(if $(filter __________________________________________________%, $(NAME_PATTERN)), \
1110 $(eval TEST_NAME := ) \
1111 $(PRINTF) >> $(TEST_SUMMARY) "%2s %-49s\n" " " "$(test)" $(NEWLINE) \
1112 , \
1113 $(eval TEST_NAME := $(test)) \
1114 ) \
1115 $(if $(filter $($(TEST_ID)_PASSED), $($(TEST_ID)_TOTAL)), \
1116 $(PRINTF) >> $(TEST_SUMMARY) "%2s %-49s %5d %5d %5d %5d %2s\n" \
1117 " " "$(TEST_NAME)" $($(TEST_ID)_TOTAL) $($(TEST_ID)_PASSED) \
1118 $($(TEST_ID)_FAILED) $($(TEST_ID)_ERROR) " " $(NEWLINE) \
1119 , \
1120 $(PRINTF) >> $(TEST_SUMMARY) "%2s %-49s %5d %5d %5d %5d %2s\n" \
1121 ">>" "$(TEST_NAME)" $($(TEST_ID)_TOTAL) $($(TEST_ID)_PASSED) \
1122 $($(TEST_ID)_FAILED) $($(TEST_ID)_ERROR) "<<" $(NEWLINE) \
1123 $(eval TEST_FAILURE := true) \
1124 ) \
1125 )
1126 $(ECHO) >> $(TEST_SUMMARY) ==============================
1127 $(if $(filter true, $(TEST_FAILURE)), \
1128 $(ECHO) >> $(TEST_SUMMARY) TEST FAILURE $(NEWLINE) \
1129 $(MKDIR) -p $(MAKESUPPORT_OUTPUTDIR) $(NEWLINE) \
1130 $(TOUCH) $(MAKESUPPORT_OUTPUTDIR)/exit-with-error \
1131 , \
1132 $(ECHO) >> $(TEST_SUMMARY) TEST SUCCESS \
1133 )
1134 $(ECHO)
1135 $(CAT) $(TEST_SUMMARY)
1136 $(ECHO)
1137
1138 # The main run-test target
1139 run-test: run-test-report
1140
1141 TARGETS += run-all-tests pre-run-test post-run-test run-test-report run-test
1142
1143 ################################################################################
1144 # Setup JCov
1145 ################################################################################
1146
1147 ifeq ($(TEST_OPTS_JCOV), true)
1148
1149 jcov-do-start-grabber:
1150 $(call MakeDir, $(JCOV_OUTPUT_DIR))
1151 if $(JAVA) -jar $(JCOV_HOME)/lib/jcov.jar GrabberManager -status 1>/dev/null 2>&1 ; then \
1152 $(JAVA) -jar $(JCOV_HOME)/lib/jcov.jar GrabberManager -stop -stoptimeout 3600 ; \
1153 fi
1154 $(JAVA) -Xmx4g -jar $(JCOV_HOME)/lib/jcov.jar Grabber -v -t \
1155 $(JCOV_IMAGE_DIR)/template.xml -o $(JCOV_RESULT_FILE) \
1156 1>$(JCOV_GRABBER_LOG) 2>&1 &
1157
1158 jcov-start-grabber: jcov-do-start-grabber
1159 $(call LogWarn, Starting JCov Grabber...)
1160 $(JAVA) -jar $(JCOV_HOME)/lib/jcov.jar GrabberManager -t 600 -wait
1161
1162 jcov-stop-grabber:
1163 $(call LogWarn, Stopping JCov Grabber...)
1164 $(JAVA) -jar $(JCOV_HOME)/lib/jcov.jar GrabberManager -stop -stoptimeout 3600
1165
1166 JCOV_REPORT_TITLE := JDK code coverage report<br/>
1167 ifneq ($(JCOV_FILTERS), )
1168 JCOV_REPORT_TITLE += Code filters: $(JCOV_FILTERS)<br>
1169 endif
1170 JCOV_REPORT_TITLE += Tests: $(TEST)
1171
1172 jcov-gen-report: jcov-stop-grabber
1173 $(call LogWarn, Generating JCov report ...)
1174 $(JAVA) -Xmx4g -jar $(JCOV_HOME)/lib/jcov.jar RepGen -sourcepath \
1175 `$(ECHO) $(TOPDIR)/src/*/share/classes/ | $(TR) ' ' ':'` -fmt html \
1176 $(JCOV_FILTERS) \
1177 -mainReportTitle "$(JCOV_REPORT_TITLE)" \
1178 -o $(JCOV_REPORT) $(JCOV_RESULT_FILE)
1179
1180 TARGETS += jcov-do-start-grabber jcov-start-grabber jcov-stop-grabber \
1181 jcov-gen-report
1182
1183 ifneq ($(TEST_OPTS_JCOV_DIFF_CHANGESET), )
1184
1185 JCOV_SOURCE_DIFF := $(JCOV_OUTPUT_DIR)/source_diff
1186 JCOV_DIFF_COVERAGE_REPORT := $(JCOV_OUTPUT_DIR)/diff_coverage_report
1187
1188 ifneq ($(and $(HG), $(wildcard $(TOPDIR)/.hg)), )
1189 DIFF_COMMAND := $(HG) -R $(TOPDIR) diff -r $(TEST_OPTS_JCOV_DIFF_CHANGESET) > $(JCOV_SOURCE_DIFF)
1190 else ifneq ($(and $(GIT), $(wildcard $(TOPDIR)/.git)), )
1191 DIFF_COMMAND := $(GIT) -C $(TOPDIR) diff $(TEST_OPTS_JCOV_DIFF_CHANGESET) > $(JCOV_SOURCE_DIFF)
1192 else
1193 $(info Error: Must be either hg or git source tree for diff coverage.)
1194 $(error Neither hg nor git source tree.)
1195 endif
1196
1197 jcov-gen-diffcoverage: jcov-stop-grabber
1198 $(call LogWarn, Generating diff coverage with changeset $(TEST_OPTS_JCOV_DIFF_CHANGESET) ... )
1199 $(DIFF_COMMAND)
1200 $(JAVA) -Xmx4g -jar $(JCOV_HOME)/lib/jcov.jar \
1201 DiffCoverage -replaceDiff "src/.*/classes/:" -all \
1202 $(JCOV_RESULT_FILE) $(JCOV_SOURCE_DIFF) > \
1203 $(JCOV_DIFF_COVERAGE_REPORT)
1204
1205 TARGETS += jcov-gen-diffcoverage
1206
1207 endif
1208
1209 # Hook this into the framework at appropriate places
1210 pre-run-test: jcov-start-grabber
1211
1212 post-run-test: jcov-gen-report
1213
1214 ifneq ($(TEST_OPTS_JCOV_DIFF_CHANGESET), )
1215
1216 post-run-test: jcov-gen-diffcoverage
1217
1218 endif
1219
1220 jcov-stop-grabber: run-all-tests
1221
1222 endif
1223
1224 ################################################################################
1225
1226 all: run-test
1227
1228 .PHONY: default all $(TARGETS)