.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GTESTER"  "" ""
.SH NAME
gtester \- test running utility
.\" This has to be duplicated from above to make it machine-readable by `reuse`:
.\" SPDX-FileCopyrightText: 2008 Matthias Clasen
.\" SPDX-FileCopyrightText: 2011 Collabora, Ltd.
.\" SPDX-FileCopyrightText: 2011 Carlos Garcia Campos
.\" SPDX-FileCopyrightText: 2012 Red Hat, Inc.
.\" SPDX-FileCopyrightText: 2019 Endless Mobile, Inc.
.\" SPDX-License-Identifier: LGPL-2.1-or-later
.
.SH SYNOPSIS
.nf
\fBgtester\fP [\fIOPTION\fP…] \fItest\-program\fP
.fi
.sp
.SH DESCRIPTION
.sp
\fBgtester\fP is a utility to run unit tests that have been written using the GLib
test framework.
.sp
Since GLib 2.62, \fBgtester\-report\fP is deprecated. Use TAP for reporting test
results instead, and feed it to the test harness provided by your build system.
.sp
When called with the \fB\-o\fP option, \fBgtester\fP writes an XML report of the test
results, which can be converted into HTML using the \fBgtester\-report\fP utility.
.SH OPTIONS
.sp
\fB\-h\fP, \fB\-\-help\fP
.INDENT 0.0
.INDENT 3.5
Print help and exit.
.UNINDENT
.UNINDENT
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.INDENT 0.0
.INDENT 3.5
Print version information and exit.
.UNINDENT
.UNINDENT
.sp
\fB\-\-g\-fatal\-warnings\fP
.INDENT 0.0
.INDENT 3.5
Make warnings fatal.
.UNINDENT
.UNINDENT
.sp
\fB\-k\fP, \fB\-\-keep\-going\fP
.INDENT 0.0
.INDENT 3.5
Continue running after tests failed.
.UNINDENT
.UNINDENT
.sp
\fB\-l\fP
.INDENT 0.0
.INDENT 3.5
List paths of available test cases.
.UNINDENT
.UNINDENT
.sp
\fB\-m=<MODE>\fP
.INDENT 0.0
.INDENT 3.5
Run test cases in \fBMODE\fP, which can be one of:
.INDENT 0.0
.IP \(bu 2
\fBperf\fP
.sp
Run performance tests.
.IP \(bu 2
\fBslow\fP, \fBthorough\fP
.sp
Run slow tests, or repeat non\-deterministic tests more often.
.IP \(bu 2
\fBquick\fP
.sp
Do not run slow or performance tests, or do extra repeats of
non\-deterministic tests (default).
.IP \(bu 2
\fBundefined\fP
.sp
Run test cases that deliberately provoke checks or assertion failures, if
implemented (default).
.IP \(bu 2
\fBno\-undefined\fP
.sp
Do not run test cases that deliberately provoke checks or assertion
failures.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fB\-p=<TEST\-PATH>\fP
.INDENT 0.0
.INDENT 3.5
Only run test cases matching \fBTEST\-PATH\fP\&.
.UNINDENT
.UNINDENT
.sp
\fB\-s=<TEST\-PATH>\fP
.INDENT 0.0
.INDENT 3.5
Skip test cases matching \fBTEST\-PATH\fP\&.
.UNINDENT
.UNINDENT
.sp
\fB\-\-seed=<SEED\-STRING>\fP
.INDENT 0.0
.INDENT 3.5
Run all test cases with random number seed \fBSEED\-STRING\fP\&.
.UNINDENT
.UNINDENT
.sp
\fB\-o=<LOG\-FILE>\fP
.INDENT 0.0
.INDENT 3.5
Write the test log to \fBLOG\-FILE\fP\&.
.UNINDENT
.UNINDENT
.sp
\fB\-q\fP, \fB\-\-quiet\fP
.INDENT 0.0
.INDENT 3.5
Suppress per\-test\-binary output.
.UNINDENT
.UNINDENT
.sp
\fB\-\-verbose\fP
.INDENT 0.0
.INDENT 3.5
Report success per testcase.
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fI\%gtester\-report(1)\fP
.\" Generated by docutils manpage writer.
.