opnsense-src/contrib/atf
Dag-Erling Smørgrav 84a5cebd36 atf, kyua: Implement require.kmods.
This adds a metadata variable, require.kmods, and corresponding functions
or methods in C, C++, and shell, which allow a test to specify that it
requires particular kernel modules to run.  If the kernel modules are not
present, the test is skipped.  One might want to consider a kyua option
which makes it attempt to load the modules instead.

Differential Revision:	https://reviews.freebsd.org/D47470

(cherry picked from commit 83a1ee578c9d1ab7013e997289c7cd470c0e6902)
2025-10-07 12:08:43 +02:00
..
atf-c atf, kyua: Implement require.kmods. 2025-10-07 12:08:43 +02:00
atf-c++ atf, kyua: Implement require.kmods. 2025-10-07 12:08:43 +02:00
atf-sh atf, kyua: Implement require.kmods. 2025-10-07 12:08:43 +02:00
doc atf, kyua: Implement require.kmods. 2025-10-07 12:08:43 +02:00
test-programs
.cirrus.yml Import atf 0.22 snapshot ca73d08c3fc1ecffc1f1c97458c31ab82c12bb01 2021-02-04 15:03:05 +00:00
.gitignore Import atf 0.22 snapshot ca73d08c3fc1ecffc1f1c97458c31ab82c12bb01 2021-02-04 15:03:05 +00:00
.travis.yml Import atf 0.22 snapshot ca73d08c3fc1ecffc1f1c97458c31ab82c12bb01 2021-02-04 15:03:05 +00:00
atf-c++.hpp
atf-c.h
AUTHORS
config.h Don't let ATF call basename() and dirname() in a non-standard way. 2016-06-08 20:54:56 +00:00
COPYING
FREEBSD-upgrade
FREEBSD-Xlist
Kyuafile
NEWS Import atf 0.22 snapshot ca73d08c3fc1ecffc1f1c97458c31ab82c12bb01 2021-02-04 15:03:05 +00:00
README
README.md Import atf 0.22 snapshot ca73d08c3fc1ecffc1f1c97458c31ab82c12bb01 2021-02-04 15:03:05 +00:00

Welcome to the ATF project!

ATF, or Automated Testing Framework, is a collection of libraries to write test programs in C, C++ and POSIX shell.

The ATF libraries offer a simple API. The API is orthogonal through the various bindings, allowing developers to quickly learn how to write test programs in different languages.

ATF-based test programs offer a consistent end-user command-line interface to allow both humans and automation to run the tests.

ATF-based test programs rely on an execution engine to be run and this execution engine is not shipped with ATF. Kyua is the engine of choice.

Download

Formal releases for source files are available for download from GitHub:

  • atf 0.20, released on February 7th, 2014.

Installation

You are encouraged to install binary packages for your operating system wherever available:

  • Fedora 20 and above: install the atf package with yum install atf.

  • FreeBSD 10.0 and above: install the atf package with pkg install atf.

  • NetBSD with pkgsrc: install the pkgsrc/devel/atf package.

  • OpenBSD: install the devel/atf package with pkg_add atf.

Should you want to build and install ATF from the source tree provided here, follow the instructions in the INSTALL file.

Support

Please use the atf-discuss mailing list for any support inquiries related to atf-c, atf-c++ or atf-sh.

If you have any questions on Kyua proper, please use the kyua-discuss mailing list instead.