1# $FreeBSD: stable/10/share/mk/suite.test.mk 313792 2017-02-16 05:22:08Z ngie $
2#
3# You must include bsd.test.mk instead of this file from your Makefile.
4#
5# Internal glue for the build of /usr/tests/.
6
7.if !target(__<bsd.test.mk>__)
8.error suite.test.mk cannot be included directly.
9.endif
10
11# Name of the test suite these tests belong to.  Should rarely be changed for
12# Makefiles built into the FreeBSD src tree.
13TESTSUITE?= FreeBSD
14
15# Knob to control the handling of the Kyuafile for this Makefile.
16#
17# If 'yes', a Kyuafile exists in the source tree and is installed into
18# TESTSDIR.
19#
20# If 'auto', a Kyuafile is automatically generated based on the list of test
21# programs built by the Makefile and is installed into TESTSDIR.  This is the
22# default and is sufficient in the majority of the cases.
23#
24# If 'no', no Kyuafile is installed.
25KYUAFILE?= auto
26
27# Per-test program interface definition.
28#
29# The name provided here must match one of the interface names supported by
30# Kyua as this is later encoded in the Kyuafile test program definitions.
31#TEST_INTERFACE.<test-program>= interface-name
32
33# Metadata properties applicable to all test programs.
34#
35# All the variables for a test program defined in the Makefile are appended
36# to the test program's definition in the Kyuafile.  This feature can be
37# used to avoid having to explicitly supply a Kyuafile in the source
38# directory, allowing the caller Makefile to rely on the KYUAFILE=auto
39# behavior defined here.
40#TEST_METADATA+= key="value"
41
42# Per-test program metadata properties as a list of key/value pairs.
43#
44# These per-test program settings _extend_ the values provided in the
45# unqualified TEST_METADATA variable.
46#TEST_METADATA.<test-program>+= key="value"
47
48.if ${KYUAFILE:tl} != "no"
49FILES+=	Kyuafile
50FILESDIR_Kyuafile= ${TESTSDIR}
51.endif
52
53.for _T in ${_TESTS}
54_TEST_METADATA.${_T}= ${TEST_METADATA} ${TEST_METADATA.${_T}}
55.endfor
56
57.if ${KYUAFILE:tl} == "auto"
58CLEANFILES+= Kyuafile Kyuafile.tmp
59Kyuafile: Makefile
60	@{ \
61	    echo '-- Automatically generated by bsd.test.mk.'; \
62	    echo; \
63	    echo 'syntax(2)'; \
64	    echo; \
65	    echo 'test_suite("${TESTSUITE}")'; \
66            echo; \
67	} > ${.TARGET}.tmp
68.for _T in ${_TESTS}
69.if defined(.PARSEDIR)
70	@echo '${TEST_INTERFACE.${_T}}_test_program{name="${_T}"${_TEST_METADATA.${_T}:C/$/,/:tW:C/^/, /W:C/,$//W}}' \
71	    >>${.TARGET}.tmp
72.else
73	@echo '${TEST_INTERFACE.${_T}}_test_program{name="${_T}"${_TEST_METADATA.${_T}:C/^/, /:Q:S/\\ ,/,/g:S,\\,,g}}' \
74	    >>${.TARGET}.tmp
75.endif
76.endfor
77.for _T in ${TESTS_SUBDIRS:N.WAIT}
78	@echo "include(\"${_T}/${.TARGET}\")" >>${.TARGET}.tmp
79.endfor
80	@mv ${.TARGET}.tmp ${.TARGET}
81.endif
82
83CHECKDIR?=	${DESTDIR}${TESTSDIR}
84
85KYUA= ${LOCALBASE}/bin/kyua
86
87# Definition of the "make check" target and supporting variables.
88#
89# This target, by necessity, can only work for native builds (i.e. a FreeBSD
90# host building a release for the same system).  The target runs Kyua, which is
91# not in the toolchain, and the tests execute code built for the target host.
92#
93# Due to the dependencies of the binaries built by the source tree and how they
94# are used by tests, it is highly possible for a execution of "make test" to
95# report bogus results unless the new binaries are put in place.
96
97realcheck: .PHONY
98	@if [ ! -x ${KYUA} ]; then \
99		echo; \
100		echo "kyua binary not installed at expected location (${.TARGET})"; \
101		echo; \
102		echo "Please install via pkg install, or specify the path to the kyua"; \
103		echo "package via the \$${LOCALBASE} variable, e.g. "; \
104		echo "LOCALBASE=\"${LOCALBASE}\""; \
105		false; \
106	fi
107	@${KYUA} test -k ${CHECKDIR}/Kyuafile
108