xref: /freebsd/share/mk/bsd.test.mk (revision 1f4bcc459a76b7aa664f3fd557684cd0ba6da352)
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# Third-party software (kyua, etc) prefix.
14LOCALBASE?=	/usr/local
15
16# Tests install directory
17TESTSDIR?=	${TESTSBASE}/${RELDIR:H}
18PACKAGE=	tests
19
20# List of subdirectories containing tests into which to recurse.  This has the
21# same semantics as SUBDIR at build-time.  However, the directories listed here
22# get registered into the run-time test suite definitions so that the test
23# engines know to recurse into these directories.
24#
25# In other words: list here any directories that contain test programs but use
26# SUBDIR for directories that may contain helper binaries and/or data files.
27TESTS_SUBDIRS?=
28
29# If defined, indicates that the tests built by the Makefile are not part of
30# the FreeBSD Test Suite.  The implication of this is that the tests won't be
31# installed under /usr/tests/ and that Kyua won't be able to run them.
32#NOT_FOR_TEST_SUITE=
33
34# List of variables to pass to the tests at run-time via the environment.
35TESTS_ENV?=
36
37# Force all tests in a separate distribution file.
38#
39# We want this to be the case even when the distribution name is already
40# overriden.  For example: we want the tests for programs in the 'games'
41# distribution to end up in the 'tests' distribution; the test programs
42# themselves have all the necessary logic to detect that the games are not
43# installed and thus won't cause false negatives.
44DISTRIBUTION:=	tests
45
46# Ordered list of directories to construct the PATH for the tests.
47TESTS_PATH+= ${DESTDIR}/bin ${DESTDIR}/sbin \
48             ${DESTDIR}/usr/bin ${DESTDIR}/usr/sbin
49TESTS_ENV+= PATH=${TESTS_PATH:tW:C/ +/:/g}
50
51# Ordered list of directories to construct the LD_LIBRARY_PATH for the tests.
52TESTS_LD_LIBRARY_PATH+= ${DESTDIR}/lib ${DESTDIR}/usr/lib
53TESTS_ENV+= LD_LIBRARY_PATH=${TESTS_LD_LIBRARY_PATH:tW:C/ +/:/g}
54
55# List of all tests being built.  The various *.test.mk modules extend this
56# variable as needed.
57_TESTS=
58
59# Pull in the definitions of all supported test interfaces.
60.include <atf.test.mk>
61.include <plain.test.mk>
62.include <tap.test.mk>
63
64.for ts in ${TESTS_SUBDIRS}
65.if empty(SUBDIR:M${ts})
66SUBDIR+= ${ts}
67.endif
68.endfor
69
70# it is rare for test cases to have man pages
71.if !defined(MAN)
72MAN=
73.endif
74
75# tell progs.mk we might want to install things
76PROG_VARS+= BINDIR
77PROGS_TARGETS+= install
78
79.if !defined(NOT_FOR_TEST_SUITE)
80.include <suite.test.mk>
81.endif
82
83.if !target(realtest)
84realtest: .PHONY
85	@echo "$@ not defined; skipping"
86.endif
87
88test: .PHONY
89.ORDER: beforetest realtest
90test: beforetest realtest
91
92.if target(aftertest)
93.ORDER: realtest aftertest
94test: aftertest
95.endif
96
97.ifdef PROG
98# we came here via bsd.progs.mk below
99# parent will do staging.
100MK_STAGING= no
101.endif
102
103.if !empty(PROGS) || !empty(PROGS_CXX) || !empty(SCRIPTS)
104.include <bsd.progs.mk>
105.endif
106.include <bsd.files.mk>
107
108.if !defined(PROG) && ${MK_STAGING} != "no"
109.if !defined(_SKIP_BUILD)
110# this will handle staging if needed
111_SKIP_STAGING= no
112# but we don't want it to build anything
113_SKIP_BUILD=
114.endif
115.if !empty(PROGS)
116stage_files.prog: ${PROGS}
117.endif
118.include <bsd.prog.mk>
119.endif
120
121.if !target(objwarn)
122.include <bsd.obj.mk>
123.endif
124