ATF-CHECK(1) | General Commands Manual | ATF-CHECK(1) |
atf-check
—
executes a command and analyzes its results
atf-check |
[-s qual:value]
[-o action:arg ...]
[-e action:arg ...]
[-x ] command |
atf-check
executes a given command and
analyzes its results, including exit code, stdout and stderr.
atf-check
will execute the provided
command and apply checks specified by arguments. By default it will act as
if it was run with -s
exit:0
-o
empty
-e
empty. Multiple checks for
the same output channel are allowed and, if specified, their results will be
combined as a logical and (meaning that the output must match all the
provided checks).
The following options are available:
-s
qual:valueMost of these checkers can be prefixed by the ‘not-’ string, which effectively reverses the check.
-o
action:argMost of these checkers can be prefixed by the ‘not-’ string, which effectively reverses the check.
-e
action:arg-x
atf-check
exits 0 on success, and other
(unspecified) value on failure.
# Exit code 0, nothing on stdout/stderr atf-check 'true' # Typical usage if failure is expected atf-check -s not-exit:0 'false' # Checking stdout/stderr echo foobar >expout atf-check -o file:expout -e inline:"xx\tyy\n" \ 'echo foobar ; printf "xx\tyy\n" >&2' # Checking for a crash atf-check -s signal:sigsegv my_program # Combined checks atf-check -o match:foo -o not-match:bar echo foo baz
May 10, 2023 | NetBSD 10.99 |