ATF-REPORT(1) | General Commands Manual | ATF-REPORT(1) |
atf-report
—
atf-report |
[-o fmt1:path1 [..
-o fmtN:pathN]] |
atf-report |
-h |
atf-report
reads the output of
atf-run
and transforms it to different formats. Some
of these are user-friendly and others are machine-parseable, which opens a
wide range of possibilities to analyze the results of a test suite's
execution. See Output formats below
for more details on which these formats are.
In the first synopsis form, atf-report
reads the output of atf-run
through its standard
input and, if no -o
options are given, prints a
user-friendly report on its standard output using the ‘ticker’
format. If -o
options are provided (more than one
are allowed), they specify the complete list of reports to generate. They
are all generated simultaneously, and for obvious reasons, two reports
cannot be written to the same file. Note that the default output is
suppressed when -o
is provided.
In the second synopsis form, atf-report
will print information about all supported options and their purpose.
The following options are available:
-h
-o
fmt:pathtc, duration, test-program, test-case, result[, reason]
The ‘result’ field for test cases is always one of ‘passed’, ‘skipped’ or ‘failed’. The last two are always followed by a reason.
Test programs are logged with the following syntax:
tp, duration, test-program, result[, reason]
In this case, the ‘result’ can be one of: ‘passed’, which denotes test programs that ran without any failure; ‘failed’, which refers to test programs in which one or more test cases failed; or ‘bogus’, which mentions those test programs that failed to execute by some reason. The reason field is only available in the last case.
The time required to execute each test case and test program is also provided. You should not rely on the order of the entries in the resulting output.
atf-run
through atf-report
without any additional flags. This will use the default output format, which
is suitable to most users:
atf-run | atf-report
In some situations, it may be interesting to get a machine-parseable file aside from the standard report. This can be done as follows:
atf-run | atf-report -o csv:testsuite.csv -o ticker:-
Or if the standard report is not desired, thus achieving completely silent operation: atf-run | atf-report -o csv:testsuite.csv
December 16, 2011 | NetBSD 9.4 |