xref: /freebsd/share/mk/bsd.test.mk (revision 0e97acdf58fe27b09c4824a474b0344daf997c5f)
1# $FreeBSD$
2#
3# Generic build infrastructure for test programs.
4#
5# This is the only public file that should be included by Makefiles when
6# tests are to be built.  All other *.test.mk files are internal and not
7# to be included directly.
8
9.include <bsd.init.mk>
10
11__<bsd.test.mk>__:
12
13# List of subdirectories containing tests into which to recurse.  This has the
14# same semantics as SUBDIR at build-time.  However, the directories listed here
15# get registered into the run-time test suite definitions so that the test
16# engines know to recurse into these directories.
17#
18# In other words: list here any directories that contain test programs but use
19# SUBDIR for directories that may contain helper binaries and/or data files.
20TESTS_SUBDIRS?=
21
22# If defined, indicates that the tests built by the Makefile are not part of
23# the FreeBSD Test Suite.  The implication of this is that the tests won't be
24# installed under /usr/tests/ and that Kyua won't be able to run them.
25#NOT_FOR_TEST_SUITE=
26
27# List of variables to pass to the tests at run-time via the environment.
28TESTS_ENV?=
29
30# Force all tests in a separate distribution file.
31#
32# We want this to be the case even when the distribution name is already
33# overriden.  For example: we want the tests for programs in the 'games'
34# distribution to end up in the 'tests' distribution; the test programs
35# themselves have all the necessary logic to detect that the games are not
36# installed and thus won't cause false negatives.
37DISTRIBUTION:=	tests
38
39# Ordered list of directories to construct the PATH for the tests.
40TESTS_PATH+= ${DESTDIR}/bin ${DESTDIR}/sbin \
41             ${DESTDIR}/usr/bin ${DESTDIR}/usr/sbin
42TESTS_ENV+= PATH=${TESTS_PATH:tW:C/ +/:/g}
43
44# Ordered list of directories to construct the LD_LIBRARY_PATH for the tests.
45TESTS_LD_LIBRARY_PATH+= ${DESTDIR}/lib ${DESTDIR}/usr/lib
46TESTS_ENV+= LD_LIBRARY_PATH=${TESTS_LD_LIBRARY_PATH:tW:C/ +/:/g}
47
48# List of all tests being built.  The various *.test.mk modules extend this
49# variable as needed.
50_TESTS=
51
52# Pull in the definitions of all supported test interfaces.
53.include <atf.test.mk>
54.include <plain.test.mk>
55.include <tap.test.mk>
56
57.for ts in ${TESTS_SUBDIRS}
58.if empty(SUBDIR:M${ts})
59SUBDIR+= ${ts}
60.endif
61.endfor
62
63# it is rare for test cases to have man pages
64.if !defined(MAN)
65MAN=
66.endif
67
68# tell progs.mk we might want to install things
69PROG_VARS+= BINDIR
70PROGS_TARGETS+= install
71
72.if !defined(NOT_FOR_TEST_SUITE)
73.include <suite.test.mk>
74.endif
75
76.if !target(realtest)
77realtest: .PHONY
78	@echo "$@ not defined; skipping"
79.endif
80
81test: .PHONY
82.ORDER: beforetest realtest
83test: beforetest realtest
84
85.if target(aftertest)
86.ORDER: realtest aftertest
87test: aftertest
88.endif
89
90.if !empty(SUBDIR)
91.include <bsd.subdir.mk>
92.endif
93
94.if !empty(PROGS) || !empty(PROGS_CXX) || !empty(SCRIPTS)
95.include <bsd.progs.mk>
96.endif
97.include <bsd.files.mk>
98
99.include <bsd.obj.mk>
100