#### 2.3.1 Summary log file ¶

DejaGnu always produces a summary (`.sum`) output file. This summary lists the names of all test files run. For each test file, one line of output from each `pass` command (showing status PASS or XPASS) or `fail` command (status FAIL or XFAIL), trailing summary statistics that count passing and failing tests (expected and unexpected), the full pathname of the tool tested, and the version number of the tool. All possible outcomes, and all errors, are always reflected in the summary output file, regardless of whether or not you specify `--all`.

If any of your tests use the procedures `unresolved`, `unsupported`, or `untested`, the summary output also tabulates the corresponding outcomes.

For example, after running `runtest --tool binutils` a summary log file will be written to `binutils.sum`. Normally, DejaGnu writes this file in your current working directory. Use the `--outdir` option to select a different output directory.

Sample summary log

    Test Run By bje on Sat Nov 14 21:04:30 AEDT 2015

                    === gdb tests ===

    Running ./gdb.t00/echo.exp ...
    PASS:   Echo test
    Running ./gdb.all/help.exp ...
    PASS:   help add-symbol-file
    PASS:   help aliases
    PASS:   help breakpoint "bre" abbreviation
    FAIL:   help run "r" abbreviation
    Running ./gdb.t10/crossload.exp ...
    PASS:   m68k-elf (elf-big) explicit format; loaded
    XFAIL:  mips-ecoff (ecoff-bigmips) "ptype v_signed_char" signed C types

                    === gdb Summary ===

    # of expected passes            5
    # of expected failures          1
    # of unexpected failures        1
    /usr/latest/bin/gdb version 4.6.5 -q