- NetBSD Manual Pages
ATF-TEST-PROGRAM(1) NetBSD General Commands Manual ATF-TEST-PROGRAM(1)
Powered by man-cgi (2021-06-01).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
atf-test-program -- common interface to ATF test programs
atf-test-program [-r resfile] [-s srcdir]
[-v var1=value1 [.. -v varN=valueN]] test_case
Test programs written using the ATF libraries all share a common user
interface, which is what this manual page describes. NOTE: There is no
binary known as atf-test-program; what is described in this manual page
is the command-line interface exposed by the atf-c, atf-c++ and atf-sh
In the first synopsis form, the test program will execute the provided
test case and print its results to the standard output, unless otherwise
stated by the -r flag. Optionally, the test case name can be suffixed by
`:cleanup', in which case the cleanup routine of the test case will be
executed instead of the test case body; see atf-test-case(4). Note that
the test case is executed without isolation, so it can and probably will
create and modify files in the current directory. To execute test cases
in a controller manner, refer to atf-run(1), which is the preferred way
to run test cases. You should only execute test cases by hand for debug-
In the second synopsis form, the test program will list all available
test cases alongside their meta-data properties in a format that is
machine parseable. This list is processed by atf-run(1) to know how to
execute the test cases of a given test program.
The following options are available:
-l Lists available test cases alongside a brief description
for each of them.
-r resfile Specifies the file that will receive the test case
result. If not specified, the test case prints its
results to stdout. If the result of a test case needs to
be parsed by another program, you must use this option to
redirect the result to a file and then read the resulting
file from the other program. Note: do not try to process
the stdout of the test case because your program may
break in the future.
-s srcdir The path to the directory where the test program is
located. This is needed in all cases, except when the
test program is being executed from the current direc-
tory. The test program will use this path to locate any
helper data files or utilities.
-v var=value Sets the configuration variable var to the value value.
NetBSD 9.3 February 6, 2011 NetBSD 9.3