7.2.6 Commands for use in dg-final

The GCC testsuite defines the following directives to be used within dg-final.

7.2.6.1 Scan a particular file

scan-file filename regexp [{ target/xfail selector }]

Passes if regexp matches text in filename.

scan-file-not filename regexp [{ target/xfail selector }]

Passes if regexp does not match text in filename.

scan-module module regexp [{ target/xfail selector }]

Passes if regexp matches in Fortran module module.

7.2.6.2 Scan the assembly output

scan-assembler regex [{ target/xfail selector }]

Passes if regex matches text in the test's assembler output.

scan-assembler-not regex [{ target/xfail selector }]

Passes if regex does not match text in the test's assembler output.

scan-assembler-times regex num [{ target/xfail selector }]

Passes if regex is matched exactly num times in the test's assembler output.

scan-assembler-dem regex [{ target/xfail selector }]

Passes if regex matches text in the test's demangled assembler output.

scan-assembler-dem-not regex [{ target/xfail selector }]

Passes if regex does not match text in the test's demangled assembler output.

scan-hidden symbol [{ target/xfail selector }]

Passes if symbol is defined as a hidden symbol in the test's assembly output.

scan-not-hidden symbol [{ target/xfail selector }]

Passes if symbol is not defined as a hidden symbol in the test's assembly output.

7.2.6.3 Scan optimization dump files

These commands are available for kind of tree, rtl, and ipa.

scan-kind-dump regex suffix [{ target/xfail selector }]

Passes if regex matches text in the dump file with suffix suffix.

scan-kind-dump-not regex suffix [{ target/xfail selector }]

Passes if regex does not match text in the dump file with suffix suffix.

scan-kind-dump-times regex num suffix [{ target/xfail selector }]

Passes if regex is found exactly num times in the dump file with suffix suffix.

scan-kind-dump-dem regex suffix [{ target/xfail selector }]

Passes if regex matches demangled text in the dump file with suffix suffix.

scan-kind-dump-dem-not regex suffix [{ target/xfail selector }]

Passes if regex does not match demangled text in the dump file with suffix suffix.

7.2.6.4 Verify that an output files exists or not

output-exists [{ target/xfail selector }]

Passes if compiler output file exists.

output-exists-not [{ target/xfail selector }]

Passes if compiler output file does not exist.

7.2.6.5 Check for LTO tests

scan-symbol regexp [{ target/xfail selector }]

Passes if the pattern is present in the final executable.

7.2.6.6 Checks for gcov tests

run-gcov sourcefile

Check line counts in gcov tests.

run-gcov [branches] [calls] { opts sourcefile }

Check branch and/or call counts, in addition to line counts, in gcov tests.

7.2.6.7 Clean up generated test files

cleanup-coverage-files

Removes coverage data files generated for this test.

cleanup-ipa-dump suffix

Removes IPA dump files generated for this test.

cleanup-modules

Removes Fortran module files generated for this test.

cleanup-profile-file

Removes profiling files generated for this test.

cleanup-repo-files

Removes files generated for this test for -frepo.

cleanup-rtl-dump suffix

Removes RTL dump files generated for this test.

cleanup-saved-temps

Removes files for the current test which were kept for -save-temps.

cleanup-tree-dump suffix

Removes tree dump files matching suffix which were generated for this test.