Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

Subsections

• Synopsis
• Description
• Options
• Notes
• Diagnostics
• See also
• Author

testsuite

Maintain the most recent cumulative update to have passed the suite of AIPS++ test programs.

Synopsis

testsuite [-f#]

Description

testsuite maintains a copy of the most recent cumulative update to have passed the suite of AIPS++ test programs. This is the ``dinkum'' update fetched by specifying the -D option to inhale (p).

testsuite is a special-purpose utility used only by aips2mgr on the master host. It operates as follows:

• Since it generally takes longer to compile and verify an update than the interval between successive invokations of exhale (p), testsuite begins by preserving a copy of the VERSION file and the current cumulative update file in $MSTRFTPD. It does this by creating hardlinks to each of these files within $AIPSMSTR/testsuite/, a special directory created for its exclusive use. (exhale does not delete a cumulative update file with multiple links to it.)

• testsuite then does a cumulative inhale, mailing the log to the aips2-inhale exploder.

• When the inhale has finished testsuite invokes gmake runtests, preserving the log in $BINTESTD/runtests.log.

• It then mails the summary, $BINTESTD/runtests.report, to the aips2-workers exploder.

• If the test suite passed, testsuite installs the cumulative update as the new dinkum update by
  • Preserving the hardlink to the cumulative update file as $AIPSMSTR/testsuite/dinkum. This hardlink is never accessed by the code distribution system, its only purpose is to stop exhale from deleting the linked-to file in $MSTRFTPD.
  • Preserving the VERSION file as $MSTRFTPD/DINKUM. This file substitutes for the VERSION file when inhale is invoked with the -D option.

• Finally testsuite prints $BINTESTD/runtests.report and $BINTESTD/runtests.log on stdout.

aips2mgr in Socorro invokes testsuite once a week via a cron job in place of inhale -c. It redirects the output to $AIPSROOT/testsuite.log and also mails it to the aips2-inhale exploder.

Options

-f#

Allow the specified number of failures when deciding whether the test suite passed or not.

Notes

• testsuite is logically a function of aips2adm, the AIPS++ master administrator. However, aips2adm cannot exercise the test programs since it does not maintain a functioning AIPS++ system. Thus the responsibility devolves to aips2mgr on the master host.

  This puts aips2mgr on the master host in a special position. testsuite is unique in the AIPS++ system as being the only utility designed for use by a particular aips2mgr.

• The testsuite executable resides in the bin subdirectory of aips2mgr's home directory in Socorro.

• ``Dinkum'' as in ``fair dinkum'' is an Australian colloquialism meaning true, honest or genuine.

Diagnostics

Status return values
0: success
1: initialization error

See also

AIPS++ variable names (§1.2).
Section §1.4, AIPS++ accounts and groups.
Section §12.2, diagnostic makefile rules.
assay (p), invoke an AIPS++ test program and verify its output.
exhale (p), AIPS++ code export utility.
inhale (p), AIPS++ code import utility.
runtests (p), run the AIPS++ test programs.
sneeze (p), AIPS++ system rebuild utility.

Author

Original: 1996/09/18 by Mark Calabretta, ATNF.