gtester — test running utility


gtester [OPTION...] [testprogram]


gtester is a utility to run unit tests that have been written using the GLib test framework.

Since GLib 2.62, gtester-report is deprecated. Use TAP for reporting test results instead, and feed it to the test harness provided by your build system.

When called with the -o option, gtester writes an XML report of the test results, which can be converted into HTML using the gtester-report utility.


-h, --help

print help and exit

-v, --version

print version information and exit


make warnings fatal

-k, --keep-going

continue running after tests failed


list paths of available test cases


run test cases in MODE, which can be one of:


run performance tests

slow, thorough

run slow tests, or repeat non-deterministic tests more often


do not run slow or performance tests, or do extra repeats of non-deterministic tests (default)


run test cases that deliberately provoke checks or assertion failures, if implemented (default)


do not run test cases that deliberately provoke checks or assertion failures


only run test cases matching TESTPATH


skip test cases matching TESTPATH


run all test cases with random number seed SEEDSTRING


write the test log to LOGFILE

-q, --quiet

suppress per test binary output


report success per testcase

See also