The

command displays results from testing multiple tools in a tabular format. The produced table lists, for each tool (and if multiple passes were run, each pass) the number of tests passed, failed, unsupported, unresolved, and untested. Tests that are expected to fail are counted in separate columns from tests expected to pass, but "known" failures and "expected" failures are summarized together. If a test generated warnings or errors, a tag

or

is appended at the end of the relevant line.

Aside from options, the argument list may include tool or file names. The

command prefers to read DejaGnu summary files and will translate names accordingly:

Used as-is.

Rewritten to

with the same stem.

The string

is appended to select a summary file. This processing is done for convenience when using Readline file name completion in a shell, which will complete to the dot.

Taken as a tool name;

is appended.

Emit additional output describing the operation of

itself.

The

command produces its output by reading the summary files produced by DejaGnu and counting "PASS", "FAIL", etc.

If no names are given as arguments, all files matching

in the current directory are read.

$ dejagnu report card __________________________________________________ / PASS FAIL ?PASS ?FAIL UNSUP UNRES UNTEST |-------------------------------------------------- launcher | 52 0 0 0 0 0 0 libdejagnu | 5 0 0 0 0 0 0 runtest | 135 0 0 0 0 0 0 |-------------------------------------------------- | 192 0 0 0 0 0 0 \__________________________________________________

Three tools were tested, with a total of 192 tests, all expected to pass. In this example, all tests did pass, so all other columns are zero. The

and

columns count tests known or expected to fail that either unexpectedly passed or failed as expected. The remaining three columns count the exceptional results for unsupported tests, unresolved tests and stub tests that simply declare themselves untested.

$ dejagnu report-card __________________________________________________ / PASS FAIL ?PASS ?FAIL UNSUP UNRES UNTEST |-------------------------------------------------- launcher | 52 0 0 0 0 0 0 libdejagnu | 5 0 0 0 0 0 0 report-card / awk | 36 0 0 0 0 0 0 report-card / sh | 36 0 0 0 0 0 0 report-card / tcl | 36 0 0 0 0 0 0 runtest | 135 0 0 0 0 0 0 |-------------------------------------------------- awk | 36 0 0 0 0 0 0 sh | 36 0 0 0 0 0 0 tcl | 36 0 0 0 0 0 0 |-------------------------------------------------- | 300 0 0 0 0 0 0 \__________________________________________________

The

tool has been added, with three passes, one for each implementation. (The shell and Tcl implementations were later dropped to reduce future maintenance burden.) As before, all tests passed as expected. The interesting difference from the previous example is the use of DejaGnu's multipass testing feature and the additional per-pass summary lines added. For this example, only the

tool uses multipass testing, so each pass total is simply the count of tests for

instead of a distinct total.

Also note that the command used to invoke

is slightly different here. The

launcher will also accept multiple words joined with dashes into a single argument. This allows individual words in a command name to be separated with either dashes or spaces on the command line interchangeably.

The full documentation for DejaGnu is maintained as a Texinfo manual. If the

program is properly installed at your site, the command

should give you access to the complete manual.