<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><html><head><title>LLVM Testing Infrastructure Guide</title><linkrel="stylesheet"href="llvm.css"type="text/css"></head><body><divclass="doc_title">
LLVM Testing Infrastructure Guide
</div><ol><li><ahref="#overview">Overview</a></li><li><ahref="#requirements">Requirements</a></li><li><ahref="#org">LLVM testing infrastructure organization</a><ul><li><ahref="#dejagnu">DejaGNU tests</a></li><li><ahref="#testsuite">Test suite</a></li></ul></li><li><ahref="#quick">Quick start</a><ul><li><ahref="#quickdejagnu">DejaGNU tests</a></li><li><ahref="#quicktestsuite">Test suite</a></li></ul></li><li><ahref="#dgstructure">DejaGNU structure</a><ul><li><ahref="#dgcustom">Writing new DejaGNU tests</a></li><li><ahref="#FileCheck">The FileCheck utility</a></li><li><ahref="#dgvars">Variables and substitutions</a></li><li><ahref="#dgfeatures">Other features</a></li></ul></li><li><ahref="#testsuitestructure">Test suite structure</a></li><li><ahref="#testsuiterun">Running the test suite</a><ul><li><ahref="#testsuiteexternal">Configuring External Tests</a></li><li><ahref="#testsuitetests">Running different tests</a></li><li><ahref="#testsuiteoutput">Generating test output</a></li><li><ahref="#testsuitecustom">Writing custom tests for llvm-test</a></li></ul></li><li><ahref="#nightly">Running the nightly tester</a></li></ol><divclass="doc_author"><p>Written by John T. Criswell, <ahref="http://llvm.x10sys.com/rspencer">Reid Spencer</a>, and Tanya Lattner</p></div><!--=========================================================================--><divclass="doc_section"><aname="overview">Overview</a></div><!--=========================================================================--><divclass="doc_text"><p>This document is the reference manual for the LLVM testing infrastructure. It documents
the structure of the LLVM testing infrastructure, the tools needed to use it,
and how to add and run tests.</p></div><!--=========================================================================--><divclass="doc_section"><aname="requirements">Requirements</a></div><!--=========================================================================--><divclass="doc_text"><p>In order to use the LLVM testing infrastructure, you will need all of the software
required to build LLVM, plus the following:</p><dl><dt><ahref="http://www.gnu.org/software/dejagnu/">DejaGNU</a