~ubuntu-branches/ubuntu/warty/dejagnu/warty

« back to all changes in this revision

Viewing changes to doc/html/x992.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:
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>Config File Values</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="UP"
 
14
TITLE="Customizing DejaGnu"
 
15
HREF="c848.html"><LINK
 
16
REL="PREVIOUS"
 
17
TITLE="Remote Host Testing"
 
18
HREF="x953.html"><LINK
 
19
REL="NEXT"
 
20
TITLE="Extending DejaGnu"
 
21
HREF="c1099.html"></HEAD
 
22
><BODY
 
23
CLASS="SECT1"
 
24
BGCOLOR="#FFFFFF"
 
25
TEXT="#000000"
 
26
LINK="#0000FF"
 
27
VLINK="#840084"
 
28
ALINK="#0000FF"
 
29
><DIV
 
30
CLASS="NAVHEADER"
 
31
><TABLE
 
32
SUMMARY="Header navigation table"
 
33
WIDTH="100%"
 
34
BORDER="0"
 
35
CELLPADDING="0"
 
36
CELLSPACING="0"
 
37
><TR
 
38
><TH
 
39
COLSPAN="3"
 
40
ALIGN="center"
 
41
>DejaGnu: The GNU Testing Framework</TH
 
42
></TR
 
43
><TR
 
44
><TD
 
45
WIDTH="10%"
 
46
ALIGN="left"
 
47
VALIGN="bottom"
 
48
><A
 
49
HREF="x953.html"
 
50
ACCESSKEY="P"
 
51
>&#60;&#60;&#60; Previous</A
 
52
></TD
 
53
><TD
 
54
WIDTH="80%"
 
55
ALIGN="center"
 
56
VALIGN="bottom"
 
57
>Customizing DejaGnu</TD
 
58
><TD
 
59
WIDTH="10%"
 
60
ALIGN="right"
 
61
VALIGN="bottom"
 
62
><A
 
63
HREF="c1099.html"
 
64
ACCESSKEY="N"
 
65
>Next &#62;&#62;&#62;</A
 
66
></TD
 
67
></TR
 
68
></TABLE
 
69
><HR
 
70
ALIGN="LEFT"
 
71
WIDTH="100%"></DIV
 
72
><DIV
 
73
CLASS="SECT1"
 
74
><H1
 
75
CLASS="SECT1"
 
76
><A
 
77
NAME="CONFIGFILE"
 
78
></A
 
79
>Config File Values</H1
 
80
><P
 
81
>DejaGnu uses a named array in Tcl to hold all the info for
 
82
      each machine. In the case of a canadian cross, this means host
 
83
      information as well as target information. The named array is
 
84
      called <SPAN
 
85
CLASS="SYMBOL"
 
86
>target_info</SPAN
 
87
>, and it has two indices. The
 
88
      following fields are part of the array.</P
 
89
><DIV
 
90
CLASS="SECT2"
 
91
><H2
 
92
CLASS="SECT2"
 
93
><A
 
94
NAME="OPTIONDEFS"
 
95
></A
 
96
>Command Line Option Variables</H2
 
97
><P
 
98
>In the user editable second section of the <A
 
99
HREF="x992.html#PERSONAL"
 
100
>Personal Config File</A
 
101
> you can not only override the configuration
 
102
        variables captured in the first section, but also specify
 
103
        default values for all on the <B
 
104
CLASS="COMMAND"
 
105
>runtest</B
 
106
>
 
107
        command line options.  Save for <TT
 
108
CLASS="OPTION"
 
109
>--debug</TT
 
110
>,
 
111
        <TT
 
112
CLASS="OPTION"
 
113
>--help</TT
 
114
>, and <TT
 
115
CLASS="OPTION"
 
116
>--version</TT
 
117
>, each
 
118
        command line option has an associated Tcl variable.  Use the
 
119
        Tcl <B
 
120
CLASS="COMMAND"
 
121
>set</B
 
122
> command to specify a new default
 
123
        value (as for the configuration variables).  The following
 
124
        table describes the correspondence between command line
 
125
        options and variables you can set in
 
126
        <TT
 
127
CLASS="FILENAME"
 
128
>site.exp</TT
 
129
>.  <A
 
130
HREF="x428.html#INVOKING"
 
131
>Invoking Runtest</A
 
132
>, for
 
133
        explanations of the command-line options.</P
 
134
><P
 
135
><DIV
 
136
CLASS="TABLE"
 
137
><A
 
138
NAME="AEN1008"
 
139
></A
 
140
><P
 
141
><B
 
142
>Table 1. Tcl Variables For Command Line Options</B
 
143
></P
 
144
><TABLE
 
145
BORDER="1"
 
146
BGCOLOR="#E0E0E0"
 
147
CELLSPACING="0"
 
148
CELLPADDING="4"
 
149
CLASS="CALSTABLE"
 
150
><THEAD
 
151
><TR
 
152
><TH
 
153
ALIGN="LEFT"
 
154
VALIGN="TOP"
 
155
>runtest</TH
 
156
><TH
 
157
ALIGN="LEFT"
 
158
VALIGN="TOP"
 
159
>Tcl</TH
 
160
><TH
 
161
ALIGN="LEFT"
 
162
VALIGN="TOP"
 
163
>option</TH
 
164
><TH
 
165
ALIGN="LEFT"
 
166
VALIGN="TOP"
 
167
>variable</TH
 
168
><TH
 
169
ALIGN="LEFT"
 
170
VALIGN="TOP"
 
171
>description</TH
 
172
></TR
 
173
></THEAD
 
174
><TBODY
 
175
><TR
 
176
><TD
 
177
ALIGN="LEFT"
 
178
VALIGN="TOP"
 
179
>--all</TD
 
180
><TD
 
181
ALIGN="LEFT"
 
182
VALIGN="TOP"
 
183
>all_flag</TD
 
184
><TD
 
185
ALIGN="LEFT"
 
186
VALIGN="TOP"
 
187
>display all test results if set</TD
 
188
></TR
 
189
><TR
 
190
><TD
 
191
ALIGN="LEFT"
 
192
VALIGN="TOP"
 
193
>--baud</TD
 
194
><TD
 
195
ALIGN="LEFT"
 
196
VALIGN="TOP"
 
197
>baud</TD
 
198
><TD
 
199
ALIGN="LEFT"
 
200
VALIGN="TOP"
 
201
>set the default baud rate to something other than
 
202
            9600.</TD
 
203
></TR
 
204
><TR
 
205
><TD
 
206
ALIGN="LEFT"
 
207
VALIGN="TOP"
 
208
>--connect</TD
 
209
><TD
 
210
ALIGN="LEFT"
 
211
VALIGN="TOP"
 
212
>connectmode</TD
 
213
><TD
 
214
ALIGN="LEFT"
 
215
VALIGN="TOP"
 
216
><B
 
217
CLASS="COMMAND"
 
218
>rlogin</B
 
219
>,
 
220
            <B
 
221
CLASS="COMMAND"
 
222
>telnet</B
 
223
>, <B
 
224
CLASS="COMMAND"
 
225
>rsh</B
 
226
>,
 
227
            <B
 
228
CLASS="COMMAND"
 
229
>kermit</B
 
230
>, <B
 
231
CLASS="COMMAND"
 
232
>tip</B
 
233
>, or
 
234
            <B
 
235
CLASS="COMMAND"
 
236
>mondfe</B
 
237
></TD
 
238
></TR
 
239
><TR
 
240
><TD
 
241
ALIGN="LEFT"
 
242
VALIGN="TOP"
 
243
>--outdir</TD
 
244
><TD
 
245
ALIGN="LEFT"
 
246
VALIGN="TOP"
 
247
>outdir</TD
 
248
><TD
 
249
ALIGN="LEFT"
 
250
VALIGN="TOP"
 
251
>directory for <TT
 
252
CLASS="FILENAME"
 
253
>tool.sum</TT
 
254
> and
 
255
            <TT
 
256
CLASS="FILENAME"
 
257
>tool.log.</TT
 
258
></TD
 
259
></TR
 
260
><TR
 
261
><TD
 
262
ALIGN="LEFT"
 
263
VALIGN="TOP"
 
264
>--objdir</TD
 
265
><TD
 
266
ALIGN="LEFT"
 
267
VALIGN="TOP"
 
268
>objdir</TD
 
269
><TD
 
270
ALIGN="LEFT"
 
271
VALIGN="TOP"
 
272
>directory for pre-compiled binaries</TD
 
273
></TR
 
274
><TR
 
275
><TD
 
276
ALIGN="LEFT"
 
277
VALIGN="TOP"
 
278
>--reboot</TD
 
279
><TD
 
280
ALIGN="LEFT"
 
281
VALIGN="TOP"
 
282
>reboot</TD
 
283
><TD
 
284
ALIGN="LEFT"
 
285
VALIGN="TOP"
 
286
>reboot the target if set to
 
287
            <I
 
288
CLASS="EMPHASIS"
 
289
>"1"</I
 
290
>; do not reboot if set to
 
291
            <I
 
292
CLASS="EMPHASIS"
 
293
>"0"</I
 
294
> (the default).</TD
 
295
></TR
 
296
><TR
 
297
><TD
 
298
ALIGN="LEFT"
 
299
VALIGN="TOP"
 
300
>--srcdir</TD
 
301
><TD
 
302
ALIGN="LEFT"
 
303
VALIGN="TOP"
 
304
>srcdir</TD
 
305
><TD
 
306
ALIGN="LEFT"
 
307
VALIGN="TOP"
 
308
>directory of test subdirectories</TD
 
309
></TR
 
310
><TR
 
311
><TD
 
312
ALIGN="LEFT"
 
313
VALIGN="TOP"
 
314
>--strace</TD
 
315
><TD
 
316
ALIGN="LEFT"
 
317
VALIGN="TOP"
 
318
>tracelevel</TD
 
319
><TD
 
320
ALIGN="LEFT"
 
321
VALIGN="TOP"
 
322
>a number: Tcl trace depth</TD
 
323
></TR
 
324
><TR
 
325
><TD
 
326
ALIGN="LEFT"
 
327
VALIGN="TOP"
 
328
>--tool</TD
 
329
><TD
 
330
ALIGN="LEFT"
 
331
VALIGN="TOP"
 
332
>tool</TD
 
333
><TD
 
334
ALIGN="LEFT"
 
335
VALIGN="TOP"
 
336
>name of tool to test; identifies init, test subdir</TD
 
337
></TR
 
338
><TR
 
339
><TD
 
340
ALIGN="LEFT"
 
341
VALIGN="TOP"
 
342
>--verbose</TD
 
343
><TD
 
344
ALIGN="LEFT"
 
345
VALIGN="TOP"
 
346
>verbose</TD
 
347
><TD
 
348
ALIGN="LEFT"
 
349
VALIGN="TOP"
 
350
>verbosity level.  As option, use multiple times; as
 
351
            variable, set a number, 0 or greater.</TD
 
352
></TR
 
353
><TR
 
354
><TD
 
355
ALIGN="LEFT"
 
356
VALIGN="TOP"
 
357
>--target</TD
 
358
><TD
 
359
ALIGN="LEFT"
 
360
VALIGN="TOP"
 
361
>target_triplet</TD
 
362
><TD
 
363
ALIGN="LEFT"
 
364
VALIGN="TOP"
 
365
>The canonical configuration string for the target.</TD
 
366
></TR
 
367
><TR
 
368
><TD
 
369
ALIGN="LEFT"
 
370
VALIGN="TOP"
 
371
>--host</TD
 
372
><TD
 
373
ALIGN="LEFT"
 
374
VALIGN="TOP"
 
375
>host_triplet</TD
 
376
><TD
 
377
ALIGN="LEFT"
 
378
VALIGN="TOP"
 
379
>The canonical configuration string for the host.</TD
 
380
></TR
 
381
><TR
 
382
><TD
 
383
ALIGN="LEFT"
 
384
VALIGN="TOP"
 
385
>--build</TD
 
386
><TD
 
387
ALIGN="LEFT"
 
388
VALIGN="TOP"
 
389
>build_triplet</TD
 
390
><TD
 
391
ALIGN="LEFT"
 
392
VALIGN="TOP"
 
393
>The canonical configuration string for the build
 
394
            host.</TD
 
395
></TR
 
396
><TR
 
397
><TD
 
398
ALIGN="LEFT"
 
399
VALIGN="TOP"
 
400
>--mail</TD
 
401
><TD
 
402
ALIGN="LEFT"
 
403
VALIGN="TOP"
 
404
>address</TD
 
405
><TD
 
406
ALIGN="LEFT"
 
407
VALIGN="TOP"
 
408
>Email the output log to the specified address.</TD
 
409
></TR
 
410
></TBODY
 
411
></TABLE
 
412
></DIV
 
413
>
 
414
        </P
 
415
></DIV
 
416
><DIV
 
417
CLASS="SECT2"
 
418
><H2
 
419
CLASS="SECT2"
 
420
><A
 
421
NAME="PERSONAL"
 
422
></A
 
423
>Personal Config File</H2
 
424
><P
 
425
>The personal config file is used to customize
 
426
      <B
 
427
CLASS="COMMAND"
 
428
>runtest's</B
 
429
> behaviour for each person. It's
 
430
      typically used to set the user prefered setting for verbosity,
 
431
      and any experimental Tcl procedures. My personal
 
432
      <TT
 
433
CLASS="FILENAME"
 
434
>~/.dejagnurc</TT
 
435
> file looks like:</P
 
436
><DIV
 
437
CLASS="EXAMPLE"
 
438
><A
 
439
NAME="AEN1090"
 
440
></A
 
441
><P
 
442
><B
 
443
>Example 12. Personal Config File</B
 
444
></P
 
445
><TABLE
 
446
BORDER="0"
 
447
BGCOLOR="#E0E0E0"
 
448
WIDTH="100%"
 
449
><TR
 
450
><TD
 
451
><PRE
 
452
CLASS="PROGRAMLISTING"
 
453
>       set all_flag 1
 
454
        set RLOGIN /usr/ucb/rlogin
 
455
        set RSH /usr/local/sbin/ssh
 
456
        </PRE
 
457
></TD
 
458
></TR
 
459
></TABLE
 
460
></DIV
 
461
><P
 
462
>Here I set <SPAN
 
463
CLASS="SYMBOL"
 
464
>all_flag</SPAN
 
465
> so I see all the test
 
466
      cases that PASS along with the ones that FAIL. I also set
 
467
      <SPAN
 
468
CLASS="SYMBOL"
 
469
>RLOGIN</SPAN
 
470
> to the BSD version. I have
 
471
      <SPAN
 
472
CLASS="PRODUCTNAME"
 
473
>Kerberos</SPAN
 
474
> installed, and when I rlogin
 
475
      to a target board, it usually isn't supported. So I use the non
 
476
      secure version rather than the default that's in my path. I also
 
477
      set <SPAN
 
478
CLASS="SYMBOL"
 
479
>RSH</SPAN
 
480
> to the <SPAN
 
481
CLASS="PRODUCTNAME"
 
482
>SSH</SPAN
 
483
>
 
484
      secure shell, as rsh is mostly used to test unix
 
485
      machines within a local network here.</P
 
486
></DIV
 
487
></DIV
 
488
><DIV
 
489
CLASS="NAVFOOTER"
 
490
><HR
 
491
ALIGN="LEFT"
 
492
WIDTH="100%"><TABLE
 
493
SUMMARY="Footer navigation table"
 
494
WIDTH="100%"
 
495
BORDER="0"
 
496
CELLPADDING="0"
 
497
CELLSPACING="0"
 
498
><TR
 
499
><TD
 
500
WIDTH="33%"
 
501
ALIGN="left"
 
502
VALIGN="top"
 
503
><A
 
504
HREF="x953.html"
 
505
ACCESSKEY="P"
 
506
>&#60;&#60;&#60; Previous</A
 
507
></TD
 
508
><TD
 
509
WIDTH="34%"
 
510
ALIGN="center"
 
511
VALIGN="top"
 
512
><A
 
513
HREF="book1.html"
 
514
ACCESSKEY="H"
 
515
>Home</A
 
516
></TD
 
517
><TD
 
518
WIDTH="33%"
 
519
ALIGN="right"
 
520
VALIGN="top"
 
521
><A
 
522
HREF="c1099.html"
 
523
ACCESSKEY="N"
 
524
>Next &#62;&#62;&#62;</A
 
525
></TD
 
526
></TR
 
527
><TR
 
528
><TD
 
529
WIDTH="33%"
 
530
ALIGN="left"
 
531
VALIGN="top"
 
532
>Remote Host Testing</TD
 
533
><TD
 
534
WIDTH="34%"
 
535
ALIGN="center"
 
536
VALIGN="top"
 
537
><A
 
538
HREF="c848.html"
 
539
ACCESSKEY="U"
 
540
>Up</A
 
541
></TD
 
542
><TD
 
543
WIDTH="33%"
 
544
ALIGN="right"
 
545
VALIGN="top"
 
546
>Extending DejaGnu</TD
 
547
></TR
 
548
></TABLE
 
549
></DIV
 
550
></BODY
 
551
></HTML
 
552
>
 
 
b'\\ No newline at end of file'