doc/overview/runningtests.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >Running Tests</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
   8 REL="HOME"
   9 TITLE="DejaGnu"
  10 HREF="book1.html"><LINK
  11 REL="PREVIOUS"
  12 TITLE="A POSIX conforming test framework"
  13 HREF="posix.html"><LINK
  14 REL="NEXT"
  15 TITLE="Runtest"
  16 HREF="runtest.html"></HEAD
  17 ><BODY
  18 ><DIV
  19 CLASS="NAVHEADER"
  20 ><TABLE
  21 WIDTH="100%"
  22 BORDER="0"
  23 CELLPADDING="0"
  24 CELLSPACING="0"
  25 ><TR
  26 ><TH
  27 COLSPAN="3"
  28 ALIGN="center"
  29 >DejaGnu: The GNU Testing Framework</TH
  30 ></TR
  31 ><TR
  32 ><TD
  33 WIDTH="10%"
  34 ALIGN="left"
  35 VALIGN="bottom"
  36 ><A
  37 HREF="posix.html"
  38 >Prev</A
  39 ></TD
  40 ><TD
  41 WIDTH="80%"
  42 ALIGN="center"
  43 VALIGN="bottom"
  44 ></TD
  45 ><TD
  46 WIDTH="10%"
  47 ALIGN="right"
  48 VALIGN="bottom"
  49 ><A
  50 HREF="runtest.html"
  51 >Next</A
  52 ></TD
  53 ></TR
  54 ></TABLE
  55 ><HR
  56 ALIGN="LEFT"
  57 WIDTH="100%"></DIV
  58 ><DIV
  59 CLASS="CHAPTER"
  60 ><H1
  61 ><A
  62 NAME="RUNNINGTESTS"
  63 >Chapter 2. Running Tests</A
  64 ></H1
  65 ><DIV
  66 CLASS="TOC"
  67 ><DL
  68 ><DT
  69 ><B
  70 >Table of Contents</B
  71 ></DT
  72 ><DT
  73 ><A
  74 HREF="runningtests.html#MAKECHECK"
  75 >Make check</A
  76 ></DT
  77 ><DT
  78 ><A
  79 HREF="runtest.html"
  80 >Runtest</A
  81 ></DT
  82 ><DT
  83 ><A
  84 HREF="outputfiles.html"
  85 >The files DejaGnu produces.</A
  86 ></DT
  87 ></DL
  88 ></DIV
  89 ><P
  90 >There are two ways to execute a test suite. The most
  91     common way is when there is existing support in the
  92     <TT
  93 CLASS="FILENAME"
  94 >Makefile</TT
  95 >. This support consists of a
  96     <I
  97 CLASS="EMPHASIS"
  98 >check</I
  99 > target. The other way is to execute the
 100     <B
 101 CLASS="COMMAND"
 102 >runtest</B
 103 > program directly. To run
 104     <B
 105 CLASS="COMMAND"
 106 >runtest</B
 107 > directcly from the command line requires
 108     either all the correct options, or the <A
 109 HREF="customizing.html#LOCAL"
 110 ><I
 111 >Local Config File</I
 112 ></A
 113 > must be setup
 114     correctly.</P
 115 ><DIV
 116 CLASS="SECT1"
 117 ><H1
 118 CLASS="SECT1"
 119 ><A
 120 NAME="MAKECHECK"
 121 >Make check</A
 122 ></H1
 123 ><P
 124 >To run tests from an existing collection, first use
 125       <B
 126 CLASS="COMMAND"
 127 >configure</B
 128 > as usual to set up the
 129       build directory. Then try typing:</P
 130 ><TABLE
 131 BORDER="0"
 132 BGCOLOR="#E0E0E0"
 133 WIDTH="100%"
 134 ><TR
 135 ><TD
 136 ><PRE
 137 CLASS="SCREEN"
 138 >      make check
 139       </PRE
 140 ></TD
 141 ></TR
 142 ></TABLE
 143 ><P
 144 >If the <I
 145 CLASS="EMPHASIS"
 146 >check</I
 147 > target exists, it
 148       usually saves you some trouble. For instance, it can set up any
 149       auxiliary programs or other files needed by the tests. The most
 150       common file the check builds is the
 151       <I
 152 CLASS="EMPHASIS"
 153 >site.exp</I
 154 >. The site.exp file contains
 155       various variables that DejaGnu used to dertermine the
 156       configuration of the program being tested. This is mostly for
 157       supporting remote testing.</P
 158 ><P
 159 >The <I
 160 CLASS="EMPHASIS"
 161 >check</I
 162 > target is supported by GNU
 163       <SPAN
 164 CLASS="PRODUCTNAME"
 165 >Automake</SPAN
 166 >. To have DejaGnu support added to your
 167       generated <TT
 168 CLASS="FILENAME"
 169 >Makefile.in</TT
 170 >, just add the keyword
 171       dejagnu to the AUTOMAKE_OPTIONS variable in your
 172       <TT
 173 CLASS="FILENAME"
 174 >Makefile.am</TT
 175 > file.</P
 176 ><P
 177 >Once you have run <I
 178 CLASS="EMPHASIS"
 179 >make check</I
 180 > to build
 181       any auxiliary files, you can invoke the test driver
 182       <B
 183 CLASS="COMMAND"
 184 >runtest</B
 185 > directly to repeat the tests.
 186       You will also have to execute <B
 187 CLASS="COMMAND"
 188 >runtest</B
 189 >
 190       directly for test collections with no
 191       <I
 192 CLASS="EMPHASIS"
 193 >check</I
 194 > target in the
 195       <TT
 196 CLASS="FILENAME"
 197 >Makefile</TT
 198 >.</P
 199 ></DIV
 200 ></DIV
 201 ><DIV
 202 CLASS="NAVFOOTER"
 203 ><HR
 204 ALIGN="LEFT"
 205 WIDTH="100%"><TABLE
 206 WIDTH="100%"
 207 BORDER="0"
 208 CELLPADDING="0"
 209 CELLSPACING="0"
 210 ><TR
 211 ><TD
 212 WIDTH="33%"
 213 ALIGN="left"
 214 VALIGN="top"
 215 ><A
 216 HREF="posix.html"
 217 >Prev</A
 218 ></TD
 219 ><TD
 220 WIDTH="34%"
 221 ALIGN="center"
 222 VALIGN="top"
 223 ><A
 224 HREF="book1.html"
 225 >Home</A
 226 ></TD
 227 ><TD
 228 WIDTH="33%"
 229 ALIGN="right"
 230 VALIGN="top"
 231 ><A
 232 HREF="runtest.html"
 233 >Next</A
 234 ></TD
 235 ></TR
 236 ><TR
 237 ><TD
 238 WIDTH="33%"
 239 ALIGN="left"
 240 VALIGN="top"
 241 >A POSIX conforming test framework</TD
 242 ><TD
 243 WIDTH="34%"
 244 ALIGN="center"
 245 VALIGN="top"
 246 >&nbsp;</TD
 247 ><TD
 248 WIDTH="33%"
 249 ALIGN="right"
 250 VALIGN="top"
 251 >Runtest</TD
 252 ></TR
 253 ></TABLE
 254 ></DIV
 255 ></BODY
 256 ></HTML
 257 >