10. The QMTest Configuration File

QMTest allows you to set up a per-user configuration file that contains your personal preferences, defaults, and settings.

The configuration file is named $HOME/.qmrc. On Windows, you may have to set the HOME environment variable manually.

The QMTest configuration file is a plain text file, with a format similar to that used in Microsoft Windows .INI files. It is divided into sections by headings in square brackets. Three sections are supported: [common] contains configuration variables common to all the QM tools, while [test] contains configuration variables specific to QMTest. Within each section, configuration variables are set using the syntax variable=value.

Here is a sample QM configuration file:

> cat ~/.qmrc
[common]
browser=/usr/local/bin/mozilla

10.1. Configuration Variables

These configuration variables are used in all QM tools. You should define them in the [common] section of your QM configuration file.

browser (UNIX-like platforms only)

The path to your preferred web browser. If omitted, QM attempts to run mozilla. The QM GUI does not correctly with Netscape 4 due to limitations in the support for JavaScript and DOM in that browser.

command_shell

The shell program to run a single shell command. The value of this property is the path to the shell executable, optionally followed by command-line options to pass to the shell, separated by spaces. The shell command to run is appended to the command.

On GNU/Linux systems, the default is /bin/bash -norc -noprofile -c. On other UNIX-like systems, the default is /bin/sh -c.

click_menus

If this option is not present, or has the value 0, menus in the GUI are activated by moving the mouse over the menu name.

If this option has the value 1, the menus are activated by clicking on the menu name.

remote_shell (UNIX-like platforms only)

The program used for running commands on remote computers. The program must accept the same syntax as the standard rsh command, and should be configured to run the command remotely without any additional interaction (such as requesting a password from the TTY). The default value is /usr/bin/ssh.

script_shell

The shell program to run a shell script. The value of this property is the path to the shell executable, optionally followed by command-line options to pass to the shell, separated by spaces. The filename of the shell command is appended to the command.

On GNU/Linux systems, the default is /bin/bash -norc -noprofile. On other UNIX-like systems, the default is /bin/sh.