← Back to branch summary

~ubuntu-branches/ubuntu/saucy/dejagnu/saucy

« back to all changes in this revision

Viewing changes to doc/html/c401.html

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Jacobowitz
  • Date: 2004-02-09 15:07:58 UTC
  • Revision ID: james.westby@ubuntu.com-20040209150758-oaj7r5zrop60v8sb
Tags: upstream-1.4.4
Import upstream version 1.4.4

Show diffs side-by-side

added added

removed removed

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