~ubuntu-branches/ubuntu/trusty/dejagnu/trusty-updates

« back to all changes in this revision

Viewing changes to doc/html/x992.html

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Jacobowitz
  • Date: 2006-12-11 09:06:59 UTC
  • mfrom: (2.1.6 edgy)
  • Revision ID: james.westby@ubuntu.com-20061211090659-w586kgi3giz84053
Tags: 1.4.4.cvs20060709-3
* Acknowledge previous NMUs.
* Fix permissions on /usr/share/dejagnu when building without fakeroot
  (Closes: #392589, #379809).

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'