xref: /freebsd/share/mk/bsd.test.mk (revision e72055b7feba695a760d45f01f0f8268b1cb4a74)
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.if !empty(TESTS_SUBDIRS)
58SUBDIR+= ${TESTS_SUBDIRS}
59.endif
60
61# it is rare for test cases to have man pages
62.if !defined(MAN)
63MAN=
64.endif
65
66# tell progs.mk we might want to install things
67PROG_VARS+= BINDIR
68PROGS_TARGETS+= install
69
70.if !defined(NOT_FOR_TEST_SUITE)
71.include <suite.test.mk>
72.endif
73
74.if !target(realtest)
75realtest: .PHONY
76	@echo "$@ not defined; skipping"
77.endif
78
79test: .PHONY
80.ORDER: beforetest realtest
81test: beforetest realtest
82
83.if target(aftertest)
84.ORDER: realtest aftertest
85test: aftertest
86.endif
87
88.if !empty(SUBDIR)
89.include <bsd.subdir.mk>
90.endif
91
92.if !empty(PROGS) || !empty(PROGS_CXX) || !empty(SCRIPTS)
93.include <bsd.progs.mk>
94.endif
95.include <bsd.files.mk>
96
97.include <bsd.obj.mk>
98