Chapter 2. Invoking QMTest

Table of Contents

1. qmtest
2. qmtest create
3. qmtest create-target
4. qmtest create-tdb
5. qmtest gui
6. qmtest extensions
7. qmtest describe
8. qmtest ls
9. qmtest register
10. qmtest run
11. qmtest summarize
12. qmtest report
13. Environment Variables
14. Configuration Variables
15. Return Value

All QMTest functionality is available using the qmtest command.

1. qmtest

1.1. Synopsis

qmtest [ option ...] command [ command-option ...] [ argument ...]

1.2. Options

These options can be used with any QMTest command, and must precede the command name on the command line.

All options are available in a "long form" prefixed with "--" (two hyphens). Some options also may be specified in a "short form" consisting of a single hyphen and a one-letter abbreviation. Short-form options may be combined; for example, -abc is equivalent to -a -b -c.

-D path, --tdb path

Use the test database located in the directory given by path. This flag overrides the value of the environment variable QMTEST_DB_PATH. If neither this flag nor the environment variable is specified, QMTest assumes that the current directory should be used as the database. See Section 4, “Test Database”.

-h, --help

Display help information, listing commands and general options for the qmtest command.

--version

Describe the version of QMTest in use.

Additional options are available for specific commands; these are presented with each command. Options specific to a command must follow the command on the command line. Specify the --help (-h) option after the command for a description of the command and a list of of available options for that command.