src/contrib/atf/atf-sh, branch main

atf, kyua: Implement require.kmods.

2025-05-31T12:27:30+00:00

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

atf: Don't be deterred by weird umasks.

2025-05-24T10:03:39+00:00

If the current umask is weird, ATF goes to great lengths to tell us that
it can't possibly work in these conditions, instead of just dealing with
it.  This makes it unreasonably hard to use ATF to test how our own code
handles unusual umasks.

MFC after:	1 week
Sponsored by:	Klara, Inc.
Reviewed by:	igoro, kevans, ngie
Differential Revision:	https://reviews.freebsd.org/D50267

atf: Switch from std::auto_ptr<> to std::unique_ptr<>

2025-04-16T14:10:35+00:00

This mirrors upstream commit f053ab687f6e27aa264f599ecbfc5ef27ad4e2d3.

Reviewed by:	emaste
Differential Revision:	https://reviews.freebsd.org/D49789

atf-sh: fix comment typo

2023-12-26T23:24:42+00:00

Signed-off-by: Igor Ostapenko 
Reviewed by: imp
Pull Request: https://github.com/freebsd/freebsd-src/pull/895

Import atf 0.22 snapshot 55c21b2c5fb189bbdfccb2b297bfa89236502542

2021-09-10T23:08:42+00:00

The main improvement is the ability to skip a test that is expected to
fail.

Import atf 0.22 snapshot ca73d08c3fc1ecffc1f1c97458c31ab82c12bb01

2021-02-04T15:03:05+00:00

This includes improvements to the atf-sh helper functions that
significantly reduce the number of spawned processes for each test
and therefore speeds up running the testsuite noticeably.

atf-sh(3): document atf_init_test_cases(3) fully

2017-06-30T05:49:12+00:00

The function was missing from the NAME/SYNOPSIS sections. Add a manpage link
to complete the documentation reference.

MFC after:	1 month

Remove *-api(3) manpages removed in ATF 0.21

2017-03-06T22:18:14+00:00

I overlooked the fact that these manpages had been removed upstream
and replaced with their non *-api(3) equivalents. Follow upstream's
lead and remove the unused manpages.

MFC after:	1 week
Sponsored by:	Dell EMC Isilon

Fix issues with atf-check(1) found by igor and refer to atf-check(1)

2017-03-06T21:39:57+00:00

- Fix typo (specifiying -> specifying)
- Add atf-check(1) to SEE ALSO section for completeness. It's mentioned
  above, but by convention the SEE ALSO section should list all relevant
  references to other tools and APIs.

Bump .Dd for the change

MFC after:	1 week
Sponsored by:	Dell EMC Isilon

Fix manlint issues with atf-check(1)

2017-03-06T21:35:33+00:00

- Use `.Bf Em`/`.Ef` instead of prefixing lines with `.Em`. The forms
  are equivalent with traditional roff, but unnecessarily verbose. The
  former form applies the .Em macro to the enclosed block.
- Move EXIT_STATUS section down so the section complies with section
  ordering specified by mdoc(7) and enforced by manlint(1).

Bump .Dd for the change

MFC after:	1 week
Sponsored by:	Dell EMC Isilon