Subscribe to Test Results

<<< These are preliminary notes and may not be accurate. >>>

Tests are run daily and mail is sent when an individual tests fail. A summary of each test run is sent as well.

• Subscribe to failure notifications for an individual test

Checkout and carefully edit: src/gfxtest/gfxtest.cfg

Each line specifies a test to be run and contains:

<testname> <testowners>,... <testarchs>,... <testcommand>;...

      <testname>     a directory in $G/src/
      <testowners>   subscribers for individual tests
      <testarchs>    {linux | WIN32 | OSX | sol | sgi},...
      <testcommand>  Commands to run a test separated by a semicolon.
                     usually:  $G/bin/gfxtest-project <projectname>

Blank lines are permitted. There is no provision for comment lines.

• Subscribe to receive test summaries

Checkout and carefully edit: src/gfxtest/gfxtest-nightly

Modify the first command in the script to add the recipient's mail address.

 EMAILS="you@cs.brown.edu,me@cs.brown.edu"

• Setup tests to be run automatically

A Unix machine can be configured to run the gfxtest/gfxtest-nightly script using crontab. On the machine where you want to run the tests edit the crontab configuration file by typing:

> crontab -e

Add a line to run the run the gfxtest-nightly script at regular intervals. The entry can run the shared copy in the group wide $G snapshot or a copy that is customized for your purposes. The following entry will run the group wide configuration at 3AM.

0 3 * * * /map/gfx0/tools/linux/bin/gfxtest-nightly