1 # Makefile for regression testing the GNU debugger.
2 # Copyright 1992-2022 Free Software Foundation, Inc.
4 # This file is part of GDB.
6 # This program is free software; you can redistribute it and/or modify
7 # it under the terms of the GNU General Public License as published by
8 # the Free Software Foundation; either version 3 of the License, or
9 # (at your option) any later version.
11 # This program is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 # GNU General Public License for more details.
16 # You should have received a copy of the GNU General Public License
17 # along with this program. If not, see <http://www.gnu.org/licenses/>.
22 exec_prefix = @
exec_prefix@
23 abs_builddir
= @abs_builddir@
24 abs_srcdir
= @abs_srcdir@
26 target_alias
= @target_noncanonical@
27 program_transform_name
= @program_transform_name@
28 build_canonical
= @build@
29 host_canonical
= @host@
30 target_canonical
= @target@
31 enable_libctf
= @enable_libctf@
36 RPATH_ENVVAR
= @RPATH_ENVVAR@
40 EXPECT
= `if [ "$${READ1}" != "" ] ; then \
41 echo $${rootme}/expect-read1; \
42 elif [ "$${READMORE}" != "" ] ; then \
43 echo $${rootme}/expect-readmore; \
44 elif [ -f $${rootme}/../../expect/expect ] ; then \
45 echo $${rootme}/../../expect/expect ; \
50 RUNTEST
= $(RUNTEST_FOR_TARGET
)
59 # Default number of iterations that we will use to run the testsuite
60 # if the user does not specify the RACY_ITER environment variable
61 # (e.g., when the user calls the make rule directly from the command
65 RUNTEST_FOR_TARGET
= `\
66 if [ -f $${srcdir}/../../dejagnu/runtest ]; then \
67 echo $${srcdir}/../../dejagnu/runtest; \
69 if [ "$(host_canonical)" = "$(target_canonical)" ]; then \
72 t='$(program_transform_name)'; echo runtest | sed -e $$t; \
76 #### host, target, and site specific Makefile frags come in here.
78 # The use of $$(x_FOR_TARGET) reduces the command line length by not
79 # duplicating the lengthy definition.
81 TARGET_FLAGS_TO_PASS
= \
83 "exec_prefix=$(exec_prefix)" \
84 "against=$(against)" \
85 'CC=$$(CC_FOR_TARGET)' \
86 "CC_FOR_TARGET=$(CC_FOR_TARGET)" \
87 "CFLAGS=$(TESTSUITE_CFLAGS)" \
88 'CXX=$$(CXX_FOR_TARGET)' \
89 "CXX_FOR_TARGET=$(CXX_FOR_TARGET)" \
90 "CXXFLAGS=$(CXXFLAGS)" \
91 "MAKEINFO=$(MAKEINFO)" \
92 "INSTALL=$(INSTALL)" \
93 "INSTALL_PROGRAM=$(INSTALL_PROGRAM)" \
94 "INSTALL_DATA=$(INSTALL_DATA)" \
95 "LDFLAGS=$(LDFLAGS)" \
97 "RUNTEST=$(RUNTEST)" \
98 "RUNTESTFLAGS=$(RUNTESTFLAGS)"
117 # Use absolute `site.exp' path everywhere to suppress VPATH lookups for it.
118 # Bare `site.exp' is used as a target here if user requests it explicitly.
119 # $(RUNTEST) is looking up `site.exp' only in the current directory.
121 $(abs_builddir
)/site.exp site.exp
: Makefile
125 mv site.exp site.bak
; \
126 echo
"## these variables are automatically generated by make ##" > .
/tmp0
; \
127 echo
"# Do not edit here. If you wish to override these values" >> .
/tmp0
; \
128 echo
"# add them to the last section" >> .
/tmp0
; \
129 echo
"set host_triplet ${host_canonical}" >> .
/tmp0
; \
130 echo
"set target_alias $(target_alias)" >> .
/tmp0
; \
131 echo
"set target_triplet ${target_canonical}" >> .
/tmp0
; \
132 echo
"set build_triplet ${build_canonical}" >> .
/tmp0
; \
133 echo
"set srcdir ${abs_srcdir}" >> .
/tmp0
; \
134 echo
"set tool gdb" >> .
/tmp0
; \
135 echo
"set enable_libctf ${enable_libctf}" >> .
/tmp0
; \
136 echo
'source $${srcdir}/lib/append_gdb_boards_dir.exp' >> .
/tmp0
; \
137 echo
"## All variables above are generated by configure. Do Not Edit ##" >> .
/tmp0
; \
138 cat .
/tmp0
> site.exp
; \
140 -e
'1,/^## All variables above are.*##/ d' >> site.exp
; \
145 # See whether -j was given to make. Before GNU make 4.2, either it was
146 # given with no arguments, and appears as "j" in the first word, or it was
147 # given an argument and appears as "-j" in a separate word. Starting with
148 # GNU make 4.2, it always appears as "-j"/"-jN" in a separate word.
149 saw_dash_j
= $(or
$(findstring j
,$(firstword $(MAKEFLAGS
))),$(filter -j
%,$(MAKEFLAGS
)))
151 # Try to run the tests in parallel if any -j option is given. If RUNTESTFLAGS
152 # is not empty, then by default the tests will be serialized. This can be
153 # overridden by setting FORCE_PARALLEL to any non-empty value.
154 CHECK_TARGET_TMP
= $(if
$(FORCE_PARALLEL
),check-parallel
,$(if
$(RUNTESTFLAGS
),check-single
,$(if
$(saw_dash_j
),check-parallel
,check-single
)))
155 CHECK_TARGET
= $(if
$(RACY_ITER
),$(addsuffix -racy
,$(CHECK_TARGET_TMP
)),$(CHECK_TARGET_TMP
))
157 # Note that we must resort to a recursive make invocation here,
158 # because GNU make 3.82 has a bug preventing MAKEFLAGS from being used
160 check: all $(abs_builddir
)/site.exp
161 $(MAKE
) $(CHECK_TARGET
)
163 check-read1
: read1.so expect-read1
164 $(MAKE
) READ1
="1" check
166 check-readmore
: readmore.so expect-readmore
167 $(MAKE
) READMORE
="1" check
169 # Check whether we need to print the timestamp for each line of
171 TIMESTAMP
= $(if
$(TS
),|
$(srcdir)/print-ts.py
$(if
$(TS_FORMAT
),$(TS_FORMAT
),),)
173 gdb_debug
= $(if
$(GDB_DEBUG
),GDB_DEBUG
=$(GDB_DEBUG
) ; export GDB_DEBUG
;,)
174 gdbserver_debug
= $(if
$(GDBSERVER_DEBUG
),GDBSERVER_DEBUG
=$(GDBSERVER_DEBUG
) ; export GDBSERVER_DEBUG
;,)
177 # All the hair to invoke dejagnu. A given invocation can just append
180 rootme
=`pwd`; export rootme
; \
181 srcdir=${srcdir} ; export srcdir ; \
182 EXPECT
=${EXPECT} ; export EXPECT
; \
183 EXEEXT
=${EXEEXT} ; export EXEEXT
; $(gdb_debug
) $(gdbserver_debug
) \
184 $(RPATH_ENVVAR
)=$$rootme/..
/..
/expect
:$$rootme/..
/..
/libstdc
++:$$rootme/..
/..
/tk
/unix
:$$rootme/..
/..
/tcl
/unix
:$$rootme/..
/..
/bfd
:$$rootme/..
/..
/opcodes
:$$$(RPATH_ENVVAR
); \
185 export $(RPATH_ENVVAR
); \
186 if
[ -f
$${rootme}/..
/..
/expect
/expect
] ; then \
187 TCL_LIBRARY
=$${srcdir}/..
/..
/tcl
/library
; \
188 export TCL_LIBRARY
; fi
; \
191 # TESTS exists for the user to pass on the command line to easily
192 # say "Only run these tests." With check-single it's not necessary, but
193 # with check-parallel there's no other way to (easily) specify a subset
194 # of tests. For consistency we support it for check-single as well.
195 # To specify all tests in a subdirectory, use TESTS=gdb.subdir/*.exp.
196 # E.g., make check TESTS="gdb.server/*.exp gdb.threads/*.exp".
199 ifeq ($(strip $(TESTS
)),)
200 expanded_tests_or_none
:=
202 expanded_tests
:= $(patsubst $(srcdir)/%,%,$(wildcard $(addprefix $(srcdir)/,$(TESTS
))))
203 expanded_tests_or_none
:= $(or
$(expanded_tests
),no-matching-tests-found
)
206 # Shorthand for running all the tests in a single directory.
208 $(MAKE
) check TESTS
="gdb.$*/*.exp"
211 $(DO_RUNTEST
) $(RUNTESTFLAGS
) $(expanded_tests_or_none
) $(TIMESTAMP
)
214 -rm -rf cache racy_outputs temp
215 mkdir
-p racy_outputs
; \
216 racyiter
="$(RACY_ITER)"; \
217 test "x$$racyiter" = "x" && \
218 racyiter
=$(DEFAULT_RACY_ITER
); \
219 if
test $$racyiter -lt
2 ; then \
220 echo
"RACY_ITER must be at least 2."; \
224 for n in
`seq $$racyiter` ; do \
225 mkdir
-p racy_outputs
/$$n; \
226 $(DO_RUNTEST
) --outdir
=racy_outputs
/$$n $(RUNTESTFLAGS
) \
227 $(expanded_tests_or_none
) $(TIMESTAMP
); \
229 $(srcdir)/analyze-racy-logs.py \
230 `ls racy_outputs/*/gdb.sum` > racy.sum
; \
231 sed
-n
'/=== gdb Summary ===/,$$ p' racy.sum
234 -rm -rf cache outputs temp
235 $(MAKE
) -k do-check-parallel
; \
237 $(SHELL
) $(srcdir)/..
/..
/contrib
/dg-extract-results.sh \
238 `find outputs -name gdb.sum -print` > gdb.sum
; \
239 $(SHELL
) $(srcdir)/..
/..
/contrib
/dg-extract-results.sh
-L \
240 `find outputs -name gdb.log -print` > gdb.log
; \
241 sed
-n
'/=== gdb Summary ===/,$$ p' gdb.sum
; \
245 -rm -rf cache racy_outputs temp
246 racyiter
="$(RACY_ITER)"; \
247 test "x$$racyiter" = "x" && \
248 racyiter
=$(DEFAULT_RACY_ITER
); \
249 if
test $$racyiter -lt
2 ; then \
250 echo
"RACY_ITER must be at least 2."; \
254 for n in
`seq $$racyiter` ; do \
255 $(MAKE
) -k do-check-parallel-racy \
257 $(SHELL
) $(srcdir)/..
/..
/contrib
/dg-extract-results.sh \
258 `find racy_outputs/$$n -name gdb.sum -print` > \
259 racy_outputs
/$$n/gdb.sum
; \
260 $(SHELL
) $(srcdir)/..
/..
/contrib
/dg-extract-results.sh
-L \
261 `find racy_outputs/$$n -name gdb.log -print` > \
262 racy_outputs
/$$n/gdb.log
; \
263 sed
-n
'/=== gdb Summary ===/,$$ p' racy_outputs
/$$n/gdb.sum
; \
265 $(srcdir)/analyze-racy-logs.py \
266 `ls racy_outputs/*/gdb.sum` > racy.sum
; \
267 sed
-n
'/=== gdb Summary ===/,$$ p' racy.sum
269 # Turn a list of .exp files into "check/" targets. Only examine .exp
270 # files appearing in a gdb.* directory -- we don't want to pick up
271 # lib/ by mistake. For example, gdb.linespec/linespec.exp becomes
272 # check/gdb.linespec/linespec.exp. The list is generally sorted
273 # alphabetically, but we take a few tests known to be slow and push
274 # them to the front of the list to try to lessen the overall time
275 # taken by the test suite -- if one of these tests happens to be run
276 # late, it will cause the overall time to increase.
277 ifeq ($(strip $(TESTS
)),)
278 slow_tests
= gdb.base
/break-interp.exp gdb.base
/interp.exp \
279 gdb.base
/multi-forks.exp
280 all_tests
:= $(shell cd
$(srcdir) && find gdb.
* -name
'*.exp' -print)
281 reordered_tests
:= $(slow_tests
) $(filter-out $(slow_tests
),$(all_tests
))
282 TEST_TARGETS
:= $(addprefix $(if
$(RACY_ITER
),check-racy
,check)/,$(reordered_tests
))
284 TEST_TARGETS
:= $(addprefix $(if
$(RACY_ITER
),check-racy
,check)/,$(expanded_tests_or_none
))
287 do-check-parallel
: $(TEST_TARGETS
)
292 @
$(DO_RUNTEST
) GDB_PARALLEL
=yes
--outdir
=outputs
/$* $*.exp
$(RUNTESTFLAGS
) $(TIMESTAMP
)
294 do-check-parallel-racy
: $(TEST_TARGETS
)
298 -mkdir
-p racy_outputs
/$(RACY_OUTPUT_N
)/$*
299 $(DO_RUNTEST
) GDB_PARALLEL
=yes \
300 --outdir
=racy_outputs
/$(RACY_OUTPUT_N
)/$* $*.exp \
301 $(RUNTESTFLAGS
) $(TIMESTAMP
)
303 check/no-matching-tests-found
:
305 @echo
"No matching tests found."
308 # Utility rule invoked by step 2 of the build-perf rule.
310 mkdir
-p gdb.perf
/outputs
/$*
311 $(DO_RUNTEST
) --outdir
=gdb.perf
/outputs
/$* lib
/build-piece.exp WORKER
=$* GDB_PARALLEL
=gdb.perf
$(RUNTESTFLAGS
) GDB_PERFTEST_MODE
=compile GDB_PERFTEST_SUBMODE
=build-pieces
$(TIMESTAMP
)
313 # Utility rule to build tests that support it in parallel.
314 # The build is broken into 3 steps distinguished by GDB_PERFTEST_SUBMODE:
315 # gen-workers, build-pieces, final.
317 # GDB_PERFTEST_MODE appears *after* RUNTESTFLAGS here because we don't want
318 # anything in RUNTESTFLAGS to override it.
320 # We don't delete the outputs directory here as these programs can take
321 # awhile to build, and perftest.exp has support for deciding whether to
322 # recompile them. If you want to remove these directories, make clean.
324 # The point of step 1 is to construct the set of worker tasks for step 2.
325 # All of the information needed by build-piece.exp is contained in the name
326 # of the generated .worker file.
327 build-perf
: $(abs_builddir
)/site.exp
328 rm -rf gdb.perf
/workers
329 mkdir
-p gdb.perf
/workers
330 @
: Step
1: Generate the build .worker files.
331 $(DO_RUNTEST
) --directory
=gdb.perf
--outdir gdb.perf
/workers GDB_PARALLEL
=gdb.perf
$(RUNTESTFLAGS
) GDB_PERFTEST_MODE
=compile GDB_PERFTEST_SUBMODE
=gen-workers
$(TIMESTAMP
)
332 @
: Step
2: Compile the pieces. Here is the build parallelism.
333 $(MAKE
) $$(cd gdb.perf
&& echo workers
/*/*.worker
)
334 @
: Step
3: Do the final link.
335 $(DO_RUNTEST
) --directory
=gdb.perf
--outdir gdb.perf GDB_PARALLEL
=gdb.perf
$(RUNTESTFLAGS
) GDB_PERFTEST_MODE
=compile GDB_PERFTEST_SUBMODE
=final
$(TIMESTAMP
)
337 # The default is to both compile and run the tests.
338 GDB_PERFTEST_MODE
= both
340 check-perf
: all $(abs_builddir
)/site.exp
341 @if
test ! -d gdb.perf
; then mkdir gdb.perf
; fi
342 $(DO_RUNTEST
) --directory
=gdb.perf
--outdir gdb.perf GDB_PERFTEST_MODE
=$(GDB_PERFTEST_MODE
) $(RUNTESTFLAGS
) $(TIMESTAMP
)
347 -rm -f
*~ core
*.o a.out xgdb
*.x
*.grt bigcore.corefile .gdb_history
348 -rm -f core.
* *.tf
*.cl tracecommandsscript copy1.txt zzz-gdbscript
350 -rm -rf outputs temp cache
351 -rm -rf gdb.perf
/workers gdb.perf
/outputs gdb.perf
/temp gdb.perf
/cache
352 -rm -f read1.so expect-read1 readmore.so expect-readmore
354 distclean maintainer-clean
realclean: clean
356 -rm -f Makefile config.status
*-init.exp
357 -rm -fr
*.log summary detail
*.plog
*.sum
*.psum site.
*
359 Makefile
: Makefile.in config.status
$(host_makefile_frag
)
360 $(SHELL
) config.status Makefile
362 lib
/pdtrace
: pdtrace.in config.status
363 $(SHELL
) config.status lib
/pdtrace
365 config.status
: configure
366 $(SHELL
) config.status
--recheck
369 find
$(srcdir) -name
'*.exp' -print | \
371 --regex
='/\(proc\|proc_with_prefix\|gdb_caching_proc\)[ \t]+\([^ \t]+\)/\2/' \
374 # Build the expect wrapper script that preloads the read1.so library.
375 expect-read1 expect-readmore
:
379 echo
"# THIS FILE IS GENERATED -*- buffer-read-only: t -*- \n" >>$@
-tmp
; \
380 echo
"# vi:set ro: */\n\n" >>$@
-tmp
; \
381 echo
"# To regenerate this file, run:\n" >>$@
-tmp
; \
382 echo
"# make clean; make/\n" >>$@
-tmp
; \
383 if
[ $@
= expect-read1
]; then \
384 echo
"export LD_PRELOAD=`pwd`/read1.so" >>$@
-tmp
; \
386 echo
"export LD_PRELOAD=`pwd`/readmore.so" >>$@
-tmp
; \
388 echo
'exec expect "$$@"' >>$@
-tmp
; \
392 # Build the read1.so preload library. This overrides the `read'
393 # function, making it read one byte at a time. Running the testsuite
394 # with this catches racy tests.
395 read1.so
: lib
/read1.c
396 $(ECHO_CC
) $(CC
) -o
$@
${srcdir}/lib
/read1.c
-Wall
-g
-shared
-fPIC
$(CFLAGS
)
398 # Build the readmore.so preload library. This overrides the `read'
399 # function, making it try harder to read more at a time. Running the
400 # testsuite with this catches racy tests.
401 readmore.so
: lib
/read1.c
402 $(ECHO_CC
) $(CC
) -o
$@
${srcdir}/lib
/read1.c
-Wall
-g
-shared
-fPIC \
405 # Build the read1 machinery.
406 .PHONY
: read1 readmore
407 read1
: read1.so expect-read1
408 readmore
: readmore.so expect-readmore
410 # Disable implicit make rules.
411 include $(srcdir)/..
/disable-implicit-rules.mk
412 include $(srcdir)/..
/silent-rules.mk