0000: 3c 3f 78 6d 6c 20 76 65 72 73 69 6f 6e 3d 22 31 <?xml version="1
0010: 2e 30 22 20 65 6e 63 6f 64 69 6e 67 3d 22 55 54 .0" encoding="UT
0020: 46 2d 38 22 3f 3e 0a 3c 21 44 4f 43 54 59 50 45 F-8"?>.<!DOCTYPE
0030: 20 68 74 6d 6c 20 50 55 42 4c 49 43 20 22 2d 2f html PUBLIC "-/
0040: 2f 57 33 43 2f 2f 44 54 44 20 58 48 54 4d 4c 20 /W3C//DTD XHTML
0050: 31 2e 30 20 54 72 61 6e 73 69 74 69 6f 6e 61 6c 1.0 Transitional
0060: 2f 2f 45 4e 22 20 22 68 74 74 70 3a 2f 2f 77 77 //EN" "http://ww
0070: 77 2e 77 33 2e 6f 72 67 2f 54 52 2f 78 68 74 6d w.w3.org/TR/xhtm
0080: 6c 31 2f 44 54 44 2f 78 68 74 6d 6c 31 2d 74 72 l1/DTD/xhtml1-tr
0090: 61 6e 73 69 74 69 6f 6e 61 6c 2e 64 74 64 22 3e ansitional.dtd">
00a0: 0a 3c 68 74 6d 6c 20 78 6d 6c 6e 73 3d 22 68 74 .<html xmlns="ht
00b0: 74 70 3a 2f 2f 77 77 77 2e 77 33 2e 6f 72 67 2f tp://www.w3.org/
00c0: 31 39 39 39 2f 78 68 74 6d 6c 22 20 78 6d 6c 3a 1999/xhtml" xml:
00d0: 6c 61 6e 67 3d 22 65 6e 22 20 6c 61 6e 67 3d 22 lang="en" lang="
00e0: 65 6e 22 3e 0a 3c 68 65 61 64 3e 0a 3c 6d 65 74 en">.<head>.<met
00f0: 61 20 68 74 74 70 2d 65 71 75 69 76 3d 22 43 6f a http-equiv="Co
0100: 6e 74 65 6e 74 2d 54 79 70 65 22 20 63 6f 6e 74 ntent-Type" cont
0110: 65 6e 74 3d 22 74 65 78 74 2f 68 74 6d 6c 3b 20 ent="text/html;
0120: 63 68 61 72 73 65 74 3d 55 54 46 2d 38 22 2f 3e charset=UTF-8"/>
0130: 0a 3c 6d 65 74 61 20 6e 61 6d 65 3d 22 67 65 6e .<meta name="gen
0140: 65 72 61 74 6f 72 22 20 63 6f 6e 74 65 6e 74 3d erator" content=
0150: 22 68 74 74 70 3a 2f 2f 77 77 77 2e 6e 6f 6e 67 "http://www.nong
0160: 6e 75 2e 6f 72 67 2f 65 6c 79 78 65 72 2f 22 2f nu.org/elyxer/"/
0170: 3e 0a 3c 6d 65 74 61 20 6e 61 6d 65 3d 22 63 72 >.<meta name="cr
0180: 65 61 74 65 2d 64 61 74 65 22 20 63 6f 6e 74 65 eate-date" conte
0190: 6e 74 3d 22 32 30 31 31 2d 30 39 2d 32 34 22 2f nt="2011-09-24"/
01a0: 3e 0a 3c 6c 69 6e 6b 20 72 65 6c 3d 22 73 74 79 >.<link rel="sty
01b0: 6c 65 73 68 65 65 74 22 20 68 72 65 66 3d 22 68 lesheet" href="h
01c0: 74 74 70 3a 2f 2f 77 77 77 2e 6e 6f 6e 67 6e 75 ttp://www.nongnu
01d0: 2e 6f 72 67 2f 65 6c 79 78 65 72 2f 6c 79 78 2e .org/elyxer/lyx.
01e0: 63 73 73 22 20 74 79 70 65 3d 22 74 65 78 74 2f css" type="text/
01f0: 63 73 73 22 20 6d 65 64 69 61 3d 22 73 63 72 65 css" media="scre
0200: 65 6e 22 2f 3e 0a 3c 74 69 74 6c 65 3e 4d 65 67 en"/>.<title>Meg
0210: 61 74 65 73 74 20 55 73 65 72 20 4d 61 6e 75 61 atest User Manua
0220: 6c 3c 2f 74 69 74 6c 65 3e 0a 3c 2f 68 65 61 64 l</title>.</head
0230: 3e 0a 3c 62 6f 64 79 3e 0a 3c 64 69 76 20 69 64 >.<body>.<div id
0240: 3d 22 67 6c 6f 62 61 6c 57 72 61 70 70 65 72 22 ="globalWrapper"
0250: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
0260: 61 6e 64 61 72 64 22 3e 0a 0a 3c 2f 64 69 76 3e andard">..</div>
0270: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 .<div class="Sta
0280: 6e 64 61 72 64 22 3e 0a 0a 3c 2f 64 69 76 3e 0a ndard">..</div>.
0290: 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e <div class="Stan
02a0: 64 61 72 64 22 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c dard">..</div>.<
02b0: 68 31 20 63 6c 61 73 73 3d 22 74 69 74 6c 65 22 h1 class="title"
02c0: 3e 0a 4d 65 67 61 74 65 73 74 20 55 73 65 72 20 >.Megatest User
02d0: 4d 61 6e 75 61 6c 0a 3c 2f 68 31 3e 0a 3c 68 32 Manual.</h1>.<h2
02e0: 20 63 6c 61 73 73 3d 22 61 75 74 68 6f 72 22 3e class="author">
02f0: 0a 4d 61 74 74 68 65 77 20 57 65 6c 6c 61 6e 64 .Matthew Welland
0300: 0a 3c 2f 68 32 3e 0a 3c 68 32 20 63 6c 61 73 73 .</h2>.<h2 class
0310: 3d 22 44 61 74 65 22 3e 0a 53 65 70 74 2e 20 32 ="Date">.Sept. 2
0320: 30 2c 20 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 0, .</h2>.<div c
0330: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
0340: 0a 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c ..</div>.<div cl
0350: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
0360: 3c 70 3e 3c 62 72 2f 3e 0a 3c 2f 70 3e 0a 32 30 <p><br/>.</p>.20
0370: 31 31 20 4d 61 74 74 68 65 77 20 57 65 6c 6c 61 11 Matthew Wella
0380: 6e 64 2e 20 41 6c 6c 20 72 69 67 68 74 73 20 72 nd. All rights r
0390: 65 73 65 72 76 65 64 2e 20 0a 3c 2f 64 69 76 3e eserved. .</div>
03a0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 .<div class="Sta
03b0: 6e 64 61 72 64 22 3e 0a 4d 65 67 61 74 65 73 74 ndard">.Megatest
03c0: 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 61 72 is free softwar
03d0: 65 20 72 65 6c 65 61 73 65 64 20 75 6e 64 65 72 e released under
03e0: 20 74 68 65 20 47 65 6e 65 72 61 6c 20 50 75 62 the General Pub
03f0: 6c 69 63 20 4c 69 63 65 6e 73 65 20 76 32 2e 30 lic License v2.0
0400: 2e 20 50 6c 65 61 73 65 20 73 65 65 20 74 68 65 . Please see the
0410: 20 66 69 6c 65 20 43 4f 50 59 49 4e 47 20 69 6e file COPYING in
0420: 20 74 68 65 20 73 6f 75 72 63 65 20 64 69 73 74 the source dist
0430: 72 69 62 75 74 69 6f 6e 20 66 6f 72 20 64 65 74 ribution for det
0440: 61 69 6c 73 2e 20 0a 3c 2f 64 69 76 3e 0a 3c 64 ails. .</div>.<d
0450: 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 iv class="Standa
0460: 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d rd">.<div class=
0470: 22 6d 65 64 73 6b 69 70 22 3e 0a 0a 3c 2f 64 69 "medskip">..</di
0480: 76 3e 0a 45 6d 61 69 6c 3a 20 6d 61 74 74 40 6b v>.Email: matt@k
0490: 69 61 74 6f 61 2e 63 6f 6d 2e 20 0a 3c 2f 64 69 iatoa.com. .</di
04a0: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 v>.<div class="S
04b0: 74 61 6e 64 61 72 64 22 3e 0a 57 65 62 3a 20 77 tandard">.Web: w
04c0: 77 77 2e 6b 69 61 74 6f 61 2e 63 6f 6d 2f 66 6f ww.kiatoa.com/fo
04d0: 73 73 69 6c 73 2f 6d 65 67 61 74 65 73 74 0a 3c ssils/megatest.<
04e0: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
04f0: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 ="Standard">.<di
0500: 76 20 63 6c 61 73 73 3d 22 6d 65 64 73 6b 69 70 v class="medskip
0510: 22 3e 0a 0a 3c 2f 64 69 76 3e 0a 54 68 69 73 20 ">..</div>.This
0520: 64 6f 63 75 6d 65 6e 74 20 69 73 20 62 65 6c 69 document is beli
0530: 65 76 65 64 20 74 6f 20 62 65 20 61 63 75 72 61 eved to be acura
0540: 74 65 20 61 74 20 74 68 65 20 74 69 6d 65 20 6f te at the time o
0550: 66 20 77 72 69 74 69 6e 67 20 62 75 74 20 61 73 f writing but as
0560: 20 77 69 74 68 20 61 6e 79 20 6f 70 65 6e 73 6f with any openso
0570: 75 72 63 65 20 70 72 6f 6a 65 63 74 20 74 68 65 urce project the
0580: 20 73 6f 75 72 63 65 20 63 6f 64 65 20 69 74 73 source code its
0590: 65 6c 66 20 69 73 20 74 68 65 20 66 69 6e 61 6c elf is the final
05a0: 20 61 72 62 69 74 65 72 20 6f 66 20 74 68 65 20 arbiter of the
05b0: 73 6f 66 74 77 61 72 65 73 20 62 65 68 61 76 69 softwares behavi
05c0: 6f 75 72 2e 20 49 74 20 69 73 20 74 68 65 20 72 our. It is the r
05d0: 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f 66 esponsibility of
05e0: 20 74 68 65 20 65 6e 64 20 75 73 65 72 20 74 6f the end user to
05f0: 20 76 61 6c 69 64 61 74 65 20 74 68 61 74 20 74 validate that t
0600: 68 65 20 63 6f 64 65 20 77 69 6c 6c 20 70 65 72 he code will per
0610: 66 6f 72 6d 20 61 73 20 74 68 65 79 20 65 78 70 form as they exp
0620: 65 63 74 2e 20 54 68 65 20 61 75 74 68 6f 72 20 ect. The author
0630: 61 73 73 75 6d 65 73 20 6e 6f 20 72 65 73 70 6f assumes no respo
0640: 6e 73 69 62 69 6c 69 74 79 20 66 6f 72 20 61 6e nsibility for an
0650: 79 20 69 6e 61 63 63 75 72 61 63 69 65 73 20 74 y inaccuracies t
0660: 68 61 74 20 74 68 69 73 20 64 6f 63 75 6d 65 6e hat this documen
0670: 74 20 6d 61 79 20 63 6f 6e 74 61 69 6e 2e 20 49 t may contain. I
0680: 6e 20 6e 6f 20 65 76 65 6e 74 20 77 69 6c 6c 20 n no event will
0690: 4d 61 74 74 68 65 77 20 57 65 6c 6c 61 6e 64 20 Matthew Welland
06a0: 62 65 20 6c 69 61 62 6c 65 20 66 6f 72 20 64 69 be liable for di
06b0: 72 65 63 74 2c 20 69 6e 64 69 72 65 63 74 2c 20 rect, indirect,
06c0: 73 70 65 63 69 61 6c 2c 20 65 78 65 6d 70 6c 61 special, exempla
06d0: 72 79 2c 20 69 6e 63 69 64 65 6e 74 61 6c 2c 20 ry, incidental,
06e0: 6f 72 20 63 6f 6e 73 65 71 75 65 6e 74 69 61 6c or consequential
06f0: 20 64 61 6d 61 67 65 73 20 72 65 73 75 6c 74 69 damages resulti
0700: 6e 67 20 66 72 6f 6d 20 61 6e 79 20 64 65 66 65 ng from any defe
0710: 63 74 20 6f 72 20 6f 6d 69 73 73 69 6f 6e 20 69 ct or omission i
0720: 6e 20 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 2c n this document,
0730: 20 65 76 65 6e 20 69 66 20 61 64 76 69 73 65 64 even if advised
0740: 20 6f 66 20 74 68 65 20 70 6f 73 73 69 62 69 6c of the possibil
0750: 69 74 79 20 6f 66 20 73 75 63 68 20 64 61 6d 61 ity of such dama
0760: 67 65 73 2e 20 0a 3c 2f 64 69 76 3e 0a 3c 64 69 ges. .</div>.<di
0770: 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 v class="Standar
0780: 64 22 3e 0a 54 68 69 73 20 64 6f 63 75 6d 65 6e d">.This documen
0790: 74 20 69 73 20 61 20 73 6e 61 70 73 68 6f 74 20 t is a snapshot
07a0: 69 6e 20 74 69 6d 65 20 61 6e 64 20 74 68 65 20 in time and the
07b0: 4d 65 67 61 74 65 73 74 20 73 6f 66 74 77 61 72 Megatest softwar
07c0: 65 20 68 61 73 20 6c 69 6b 65 6c 79 20 62 65 65 e has likely bee
07d0: 6e 20 63 68 61 6e 67 65 64 20 73 69 6e 63 65 20 n changed since
07e0: 70 75 62 6c 69 63 61 74 69 6f 6e 2e 20 54 68 69 publication. Thi
07f0: 73 20 64 6f 63 75 6d 65 6e 74 20 61 6e 64 20 74 s document and t
0800: 68 65 20 70 72 6f 64 75 63 74 20 74 68 61 74 20 he product that
0810: 69 74 20 64 65 73 63 72 69 62 65 73 20 6d 61 79 it describes may
0820: 20 62 65 20 69 6d 70 72 6f 76 65 64 20 61 74 20 be improved at
0830: 61 6e 79 20 74 69 6d 65 2c 20 77 69 74 68 6f 75 any time, withou
0840: 74 20 6e 6f 74 69 63 65 20 6f 72 20 6f 62 6c 69 t notice or obli
0850: 67 61 74 69 6f 6e 2e 20 0a 3c 2f 64 69 76 3e 0a gation. .</div>.
0860: 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e <div class="Stan
0870: 64 61 72 64 22 3e 0a 3c 70 3e 3c 62 72 2f 3e 0a dard">.<p><br/>.
0880: 3c 2f 70 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 31 </p>..</div>.<h1
0890: 20 63 6c 61 73 73 3d 22 53 65 63 74 69 6f 6e 2d class="Section-
08a0: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 ">.<a class="toc
08b0: 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 65 63 74 " name="toc-Sect
08c0: 69 6f 6e 2d 2d 31 22 3e 3c 2f 61 3e 4d 65 67 61 ion--1"></a>Mega
08d0: 74 65 73 74 2f 64 6f 63 75 6d 65 6e 74 20 52 65 test/document Re
08e0: 76 69 73 69 6f 6e 20 48 69 73 74 6f 72 79 0a 3c vision History.<
08f0: 2f 68 31 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d /h1>.<div class=
0900: 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 69 3e 4e "Standard">.<i>N
0910: 6f 74 61 62 6c 65 20 72 65 76 69 73 69 6f 6e 73 otable revisions
0920: 20 6f 66 20 74 68 65 20 73 6f 66 74 77 61 72 65 of the software
0930: 20 61 72 65 20 6f 63 63 61 73 69 6f 6e 61 6c 6c are occasionall
0940: 79 20 64 6f 63 75 6d 65 6e 74 65 64 20 68 65 72 y documented her
0950: 65 3c 2f 69 3e 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 e</i>..</div>.<d
0960: 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 iv class="Standa
0970: 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d rd">.<div class=
0980: 22 63 65 6e 74 65 72 22 3e 0a 3c 74 61 62 6c 65 "center">.<table
0990: 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e >.<tr>.<td align
09a0: 3d 22 63 65 6e 74 65 72 22 20 76 61 6c 69 67 6e ="center" valign
09b0: 3d 22 74 6f 70 22 3e 0a 56 65 72 73 69 6f 6e 0a ="top">.Version.
09c0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
09d0: 22 63 65 6e 74 65 72 22 20 76 61 6c 69 67 6e 3d "center" valign=
09e0: 22 74 6f 70 22 3e 0a 41 75 74 68 6f 72 0a 3c 2f "top">.Author.</
09f0: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6a td>.<td align="j
0a00: 75 73 74 69 66 79 22 20 76 61 6c 69 67 6e 3d 22 ustify" valign="
0a10: 74 6f 70 22 3e 0a 44 65 73 63 72 69 70 74 69 6f top">.Descriptio
0a20: 6e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 n.</td>.<td alig
0a30: 6e 3d 22 63 65 6e 74 65 72 22 20 76 61 6c 69 67 n="center" valig
0a40: 6e 3d 22 74 6f 70 22 3e 0a 44 61 74 65 0a 3c 2f n="top">.Date.</
0a50: 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a td>..</tr>.<tr>.
0a60: 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 <td align="cente
0a70: 72 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e r" valign="top">
0a80: 0a 76 31 2e 32 35 0a 3c 2f 74 64 3e 0a 3c 74 64 .v1.25.</td>.<td
0a90: 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 20 align="center"
0aa0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 6d 61 valign="top">.ma
0ab0: 74 74 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 tt.</td>.<td ali
0ac0: 67 6e 3d 22 6a 75 73 74 69 66 79 22 20 76 61 6c gn="justify" val
0ad0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 63 6f 6e 76 65 ign="top">.conve
0ae0: 72 74 65 64 20 74 6f 20 6e 65 77 20 64 6f 63 75 rted to new docu
0af0: 6d 65 6e 74 20 74 65 6d 70 6c 61 74 65 0a 3c 2f ment template.</
0b00: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 63 td>.<td align="c
0b10: 65 6e 74 65 72 22 20 76 61 6c 69 67 6e 3d 22 74 enter" valign="t
0b20: 6f 70 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d op">.<div class=
0b30: 22 50 6c 61 69 6e 56 69 73 69 62 6c 65 22 3e 0a "PlainVisible">.
0b40: 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 74 64 3e 0a 0a .</div>..</td>..
0b50: 3c 2f 74 72 3e 0a 0a 3c 2f 74 61 62 6c 65 3e 0a </tr>..</table>.
0b60: 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a .</div>..</div>.
0b70: 3c 64 69 76 20 63 6c 61 73 73 3d 22 66 75 6c 6c <div class="full
0b80: 74 6f 63 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 toc">.<div class
0b90: 3d 22 74 6f 63 68 65 61 64 65 72 22 3e 0a 54 61 ="tocheader">.Ta
0ba0: 62 6c 65 20 6f 66 20 43 6f 6e 74 65 6e 74 73 0a ble of Contents.
0bb0: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 </div>.<div clas
0bc0: 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e 0a 3c s="tocindent">.<
0bd0: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e div class="toc">
0be0: 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 .<a class="Link"
0bf0: 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 65 63 74 href="#toc-Sect
0c00: 69 6f 6e 2d 2d 31 22 3e 53 65 63 74 69 6f 6e 3a ion--1">Section:
0c10: e2 80 83 4d 65 67 61 74 65 73 74 2f 64 6f 63 75 Megatest/docu
0c20: 6d 65 6e 74 20 52 65 76 69 73 69 6f 6e 20 48 69 ment Revision Hi
0c30: 73 74 6f 72 79 3c 2f 61 3e 0a 3c 2f 64 69 76 3e story</a>.</div>
0c40: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 .<div class="toc
0c50: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e ">.<a class="Lin
0c60: 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 65 k" href="#toc-Se
0c70: 63 74 69 6f 6e 2d 31 22 3e 53 65 63 74 69 6f 6e ction-1">Section
0c80: 20 31 3a e2 80 83 49 6e 74 72 6f 64 75 63 74 69 1: Introducti
0c90: 6f 6e 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 on</a>.</div>.<d
0ca0: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 69 6e 64 iv class="tocind
0cb0: 65 6e 74 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 ent">.<div class
0cc0: 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 ="toc">.<a class
0cd0: 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 ="Link" href="#t
0ce0: 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 31 2e oc-Subsection-1.
0cf0: 31 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 31 2e 1">Subsection 1.
0d00: 31 3a e2 80 83 4d 65 67 61 74 65 73 74 20 64 65 1: Megatest de
0d10: 73 69 67 6e 20 70 68 69 6c 6f 73 6f 70 68 79 3c sign philosophy<
0d20: 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 /a>.</div>.<div
0d30: 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 class="toc">.<a
0d40: 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 class="Link" hre
0d50: 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 f="#toc-Subsecti
0d60: 6f 6e 2d 31 2e 32 22 3e 53 75 62 73 65 63 74 69 on-1.2">Subsecti
0d70: 6f 6e 20 31 2e 32 3a e2 80 83 4d 65 67 61 74 65 on 1.2: Megate
0d80: 73 74 20 61 72 63 68 69 74 65 63 74 75 72 65 3c st architecture<
0d90: 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f 64 69 76 /a>.</div>.</div
0da0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f >.<div class="to
0db0: 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 c">.<a class="Li
0dc0: 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 nk" href="#toc-S
0dd0: 65 63 74 69 6f 6e 2d 32 22 3e 53 65 63 74 69 6f ection-2">Sectio
0de0: 6e 20 32 3a e2 80 83 49 6e 73 74 61 6c 6c 61 74 n 2: Installat
0df0: 69 6f 6e 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c ion</a>.</div>.<
0e00: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 69 6e div class="tocin
0e10: 64 65 6e 74 22 3e 0a 3c 64 69 76 20 63 6c 61 73 dent">.<div clas
0e20: 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 s="toc">.<a clas
0e30: 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 s="Link" href="#
0e40: 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 32 toc-Subsection-2
0e50: 2e 31 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 32 .1">Subsection 2
0e60: 2e 31 3a e2 80 83 44 65 70 65 6e 64 65 6e 63 69 .1: Dependenci
0e70: 65 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 es</a>.</div>.<d
0e80: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
0e90: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
0ea0: 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 href="#toc-Subse
0eb0: 63 74 69 6f 6e 2d 32 2e 32 22 3e 53 75 62 73 65 ction-2.2">Subse
0ec0: 63 74 69 6f 6e 20 32 2e 32 3a e2 80 83 42 75 69 ction 2.2: Bui
0ed0: 6c 64 20 61 6e 64 20 49 6e 73 74 61 6c 6c 3c 2f ld and Install</
0ee0: 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f 64 69 76 3e a>.</div>.</div>
0ef0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 .<div class="toc
0f00: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e ">.<a class="Lin
0f10: 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 65 k" href="#toc-Se
0f20: 63 74 69 6f 6e 2d 33 22 3e 53 65 63 74 69 6f 6e ction-3">Section
0f30: 20 33 3a e2 80 83 53 65 74 75 70 3c 2f 61 3e 0a 3: Setup</a>.
0f40: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 </div>.<div clas
0f50: 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e 0a 3c s="tocindent">.<
0f60: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e div class="toc">
0f70: 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 .<a class="Link"
0f80: 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 href="#toc-Subs
0f90: 65 63 74 69 6f 6e 2d 33 2e 31 22 3e 53 75 62 73 ection-3.1">Subs
0fa0: 65 63 74 69 6f 6e 20 33 2e 31 3a e2 80 83 43 72 ection 3.1: Cr
0fb0: 65 61 74 65 20 6d 65 67 61 74 65 73 74 2e 63 6f eate megatest.co
0fc0: 6e 66 69 67 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a nfig</a>.</div>.
0fd0: 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 <div class="toc"
0fe0: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b >.<a class="Link
0ff0: 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 " href="#toc-Sub
1000: 73 65 63 74 69 6f 6e 2d 33 2e 32 22 3e 53 75 62 section-3.2">Sub
1010: 73 65 63 74 69 6f 6e 20 33 2e 32 3a e2 80 83 43 section 3.2: C
1020: 72 65 61 74 65 20 72 75 6e 63 6f 6e 66 69 67 73 reate runconfigs
1030: 2e 63 6f 6e 66 69 67 3c 2f 61 3e 0a 3c 2f 64 69 .config</a>.</di
1040: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 v>.<div class="t
1050: 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c oc">.<a class="L
1060: 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d ink" href="#toc-
1070: 53 75 62 73 65 63 74 69 6f 6e 2d 33 2e 33 22 3e Subsection-3.3">
1080: 53 75 62 73 65 63 74 69 6f 6e 20 33 2e 33 3a e2 Subsection 3.3:
1090: 80 83 43 72 65 61 74 65 20 74 68 65 20 74 65 73 Create the tes
10a0: 74 73 20 64 69 72 65 63 74 6f 72 79 20 61 6e 64 ts directory and
10b0: 20 79 6f 75 72 20 66 69 72 73 74 20 74 65 73 74 your first test
10c0: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 </a>.</div>.<div
10d0: 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 class="toc">.<a
10e0: 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 class="Link" hr
10f0: 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 ef="#toc-Subsect
1100: 69 6f 6e 2d 33 2e 34 22 3e 53 75 62 73 65 63 74 ion-3.4">Subsect
1110: 69 6f 6e 20 33 2e 34 3a e2 80 83 43 72 65 61 74 ion 3.4: Creat
1120: 65 20 74 68 65 20 74 65 73 74 63 6f 6e 66 69 67 e the testconfig
1130: 20 66 69 6c 65 20 66 6f 72 20 79 6f 75 72 20 74 file for your t
1140: 65 73 74 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c est</a>.</div>.<
1150: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e div class="toc">
1160: 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 .<a class="Link"
1170: 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 href="#toc-Subs
1180: 65 63 74 69 6f 6e 2d 33 2e 35 22 3e 53 75 62 73 ection-3.5">Subs
1190: 65 63 74 69 6f 6e 20 33 2e 35 3a e2 80 83 43 72 ection 3.5: Cr
11a0: 65 61 74 65 20 79 6f 75 72 20 74 65 73 74 20 72 eate your test r
11b0: 75 6e 6e 69 6e 67 20 73 63 72 69 70 74 2c 20 6d unning script, m
11c0: 61 69 6e 2e 73 68 3c 2f 61 3e 0a 3c 2f 64 69 76 ain.sh</a>.</div
11d0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f >.<div class="to
11e0: 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 c">.<a class="Li
11f0: 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 nk" href="#toc-S
1200: 75 62 73 65 63 74 69 6f 6e 2d 33 2e 36 22 3e 53 ubsection-3.6">S
1210: 75 62 73 65 63 74 69 6f 6e 20 33 2e 36 3a e2 80 ubsection 3.6:
1220: 83 52 75 6e 20 6d 65 67 61 74 65 73 74 20 61 6e Run megatest an
1230: 64 20 77 61 74 63 68 20 79 6f 75 72 20 72 75 6e d watch your run
1240: 20 70 72 6f 67 72 65 73 73 3c 2f 61 3e 0a 3c 2f progress</a>.</
1250: 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 div>.</div>.<div
1260: 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 class="toc">.<a
1270: 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 class="Link" hr
1280: 65 66 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e ef="#toc-Section
1290: 2d 34 22 3e 53 65 63 74 69 6f 6e 20 34 3a e2 80 -4">Section 4:
12a0: 83 48 6f 77 20 74 6f 20 57 72 69 74 65 20 54 65 How to Write Te
12b0: 73 74 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c sts</a>.</div>.<
12c0: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 69 6e div class="tocin
12d0: 64 65 6e 74 22 3e 0a 3c 64 69 76 20 63 6c 61 73 dent">.<div clas
12e0: 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 s="toc">.<a clas
12f0: 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 s="Link" href="#
1300: 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 34 toc-Subsection-4
1310: 2e 31 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 34 .1">Subsection 4
1320: 2e 31 3a e2 80 83 41 20 53 69 6d 70 6c 65 20 54 .1: A Simple T
1330: 65 73 74 20 77 69 74 68 20 6f 6e 65 20 53 74 65 est with one Ste
1340: 70 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 p</a>.</div>.<di
1350: 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c v class="toc">.<
1360: 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 a class="Link" h
1370: 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 ref="#toc-Subsec
1380: 74 69 6f 6e 2d 34 2e 32 22 3e 53 75 62 73 65 63 tion-4.2">Subsec
1390: 74 69 6f 6e 20 34 2e 32 3a e2 80 83 43 72 65 61 tion 4.2: Crea
13a0: 74 65 20 79 6f 75 72 20 74 65 73 74 63 6f 6e 66 te your testconf
13b0: 69 67 20 66 69 6c 65 3c 2f 61 3e 0a 3c 2f 64 69 ig file</a>.</di
13c0: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 v>.<div class="t
13d0: 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c oc">.<a class="L
13e0: 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d ink" href="#toc-
13f0: 53 75 62 73 65 63 74 69 6f 6e 2d 34 2e 33 22 3e Subsection-4.3">
1400: 53 75 62 73 65 63 74 69 6f 6e 20 34 2e 33 3a e2 Subsection 4.3:
1410: 80 83 43 72 65 61 74 65 20 74 68 65 20 6d 61 69 Create the mai
1420: 6e 2e 63 73 68 20 73 63 72 69 70 74 3c 2f 61 3e n.csh script</a>
1430: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
1440: 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 ss="toc">.<a cla
1450: 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 ss="Link" href="
1460: 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d #toc-Subsection-
1470: 34 2e 34 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 4.4">Subsection
1480: 34 2e 34 3a e2 80 83 53 69 6d 70 6c 65 20 54 65 4.4: Simple Te
1490: 73 74 20 77 69 74 68 20 4d 75 6c 74 69 70 6c 65 st with Multiple
14a0: 20 53 74 65 70 73 20 3c 2f 61 3e 0a 3c 2f 64 69 Steps </a>.</di
14b0: 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 v>.</div>.<div c
14c0: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 lass="toc">.<a c
14d0: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 lass="Link" href
14e0: 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 35 ="#toc-Section-5
14f0: 22 3e 53 65 63 74 69 6f 6e 20 35 3a e2 80 83 53 ">Section 5: S
1500: 69 6d 70 6c 65 20 54 65 73 74 20 77 69 74 68 20 imple Test with
1510: 4d 75 6c 74 69 70 6c 65 20 53 74 65 70 73 2c 20 Multiple Steps,
1520: 53 6f 6d 65 20 69 6e 20 50 61 72 61 6c 6c 65 6c Some in Parallel
1530: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 </a>.</div>.<div
1540: 20 63 6c 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e class="tocinden
1550: 74 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 t">.<div class="
1560: 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 toc">.<a class="
1570: 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 Link" href="#toc
1580: 2d 53 75 62 73 65 63 74 69 6f 6e 2d 35 2e 31 22 -Subsection-5.1"
1590: 3e 53 75 62 73 65 63 74 69 6f 6e 20 35 2e 31 3a >Subsection 5.1:
15a0: e2 80 83 54 68 65 20 4d 61 6b 65 66 69 6c 65 3c The Makefile<
15b0: 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 /a>.</div>.<div
15c0: 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 class="toc">.<a
15d0: 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 class="Link" hre
15e0: 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 f="#toc-Subsecti
15f0: 6f 6e 2d 35 2e 32 22 3e 53 75 62 73 65 63 74 69 on-5.2">Subsecti
1600: 6f 6e 20 35 2e 32 3a e2 80 83 54 68 65 20 6d 61 on 5.2: The ma
1610: 69 6e 2e 63 73 68 20 66 69 6c 65 3c 2f 61 3e 0a in.csh file</a>.
1620: 3c 2f 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 </div>.</div>.<d
1630: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
1640: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
1650: 68 72 65 66 3d 22 23 74 6f 63 2d 53 65 63 74 69 href="#toc-Secti
1660: 6f 6e 2d 36 22 3e 53 65 63 74 69 6f 6e 20 36 3a on-6">Section 6:
1670: e2 80 83 53 69 6d 70 6c 65 20 54 65 73 74 20 77 Simple Test w
1680: 69 74 68 20 49 74 65 72 61 74 69 6f 6e 3c 2f 61 ith Iteration</a
1690: 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c >.</div>.<div cl
16a0: 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e ass="tocindent">
16b0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 .<div class="toc
16c0: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e ">.<a class="Lin
16d0: 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 k" href="#toc-Su
16e0: 62 73 65 63 74 69 6f 6e 2d 36 2e 31 22 3e 53 75 bsection-6.1">Su
16f0: 62 73 65 63 74 69 6f 6e 20 36 2e 31 3a e2 80 83 bsection 6.1:
1700: 55 70 64 61 74 65 20 79 6f 75 72 20 74 65 73 74 Update your test
1710: 63 6f 6e 66 69 67 20 66 69 6c 65 20 66 6f 72 20 config file for
1720: 69 74 65 72 61 74 69 6f 6e 3c 2f 61 3e 0a 3c 2f iteration</a>.</
1730: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
1740: 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d "toc">.<a class=
1750: 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f "Link" href="#to
1760: 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 36 2e 32 c-Subsection-6.2
1770: 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 36 2e 32 ">Subsection 6.2
1780: 3a e2 80 83 52 65 77 72 69 74 65 20 79 6f 75 72 : Rewrite your
1790: 20 6d 61 69 6e 2e 63 73 68 20 66 6f 72 20 69 74 main.csh for it
17a0: 65 72 61 74 69 6f 6e 3c 2f 61 3e 0a 3c 2f 64 69 eration</a>.</di
17b0: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 v>.<div class="t
17c0: 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c oc">.<a class="L
17d0: 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d ink" href="#toc-
17e0: 53 75 62 73 65 63 74 69 6f 6e 2d 36 2e 33 22 3e Subsection-6.3">
17f0: 53 75 62 73 65 63 74 69 6f 6e 20 36 2e 33 3a e2 Subsection 6.3:
1800: 80 83 54 65 73 74 73 20 77 69 74 68 20 49 6e 74 Tests with Int
1810: 65 72 2d 74 65 73 74 20 64 65 70 65 6e 64 65 6e er-test dependen
1820: 63 69 65 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a cies</a>.</div>.
1830: 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 <div class="toc"
1840: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b >.<a class="Link
1850: 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 " href="#toc-Sub
1860: 73 65 63 74 69 6f 6e 2d 36 2e 34 22 3e 53 75 62 section-6.4">Sub
1870: 73 65 63 74 69 6f 6e 20 36 2e 34 3a e2 80 83 52 section 6.4: R
1880: 6f 6c 6c 69 6e 67 20 75 70 20 4d 69 73 63 65 6c olling up Miscel
1890: 6c 61 6e 65 6f 75 73 20 44 61 74 61 3c 2f 61 3e laneous Data</a>
18a0: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
18b0: 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 ss="toc">.<a cla
18c0: 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 ss="Link" href="
18d0: 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d #toc-Subsection-
18e0: 36 2e 35 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 6.5">Subsection
18f0: 36 2e 35 3a e2 80 83 52 6f 6c 6c 69 6e 67 20 75 6.5: Rolling u
1900: 70 20 52 75 6e 73 3c 2f 61 3e 0a 3c 2f 64 69 76 p Runs</a>.</div
1910: 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c >.</div>.<div cl
1920: 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c ass="toc">.<a cl
1930: 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d ass="Link" href=
1940: 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 37 22 "#toc-Section-7"
1950: 3e 53 65 63 74 69 6f 6e 20 37 3a e2 80 83 44 61 >Section 7: Da
1960: 73 68 62 6f 61 72 64 3c 2f 61 3e 0a 3c 2f 64 69 shboard</a>.</di
1970: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 v>.<div class="t
1980: 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c oc">.<a class="L
1990: 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d ink" href="#toc-
19a0: 53 65 63 74 69 6f 6e 2d 38 22 3e 53 65 63 74 69 Section-8">Secti
19b0: 6f 6e 20 38 3a e2 80 83 47 65 6e 65 72 61 74 69 on 8: Generati
19c0: 6e 67 20 61 6e 20 4f 70 65 6e 44 6f 63 75 6d 65 ng an OpenDocume
19d0: 6e 74 20 53 70 72 65 61 64 73 68 65 65 74 20 66 nt Spreadsheet f
19e0: 72 6f 6d 20 74 68 65 20 44 61 74 61 62 61 73 65 rom the Database
19f0: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 </a>.</div>.<div
1a00: 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 class="toc">.<a
1a10: 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 class="Link" hr
1a20: 65 66 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e ef="#toc-Section
1a30: 2d 39 22 3e 53 65 63 74 69 6f 6e 20 39 3a e2 80 -9">Section 9:
1a40: 83 52 65 66 65 72 65 6e 63 65 3c 2f 61 3e 0a 3c Reference</a>.<
1a50: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
1a60: 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e 0a 3c 64 ="tocindent">.<d
1a70: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
1a80: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
1a90: 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 href="#toc-Subse
1aa0: 63 74 69 6f 6e 2d 39 2e 31 22 3e 53 75 62 73 65 ction-9.1">Subse
1ab0: 63 74 69 6f 6e 20 39 2e 31 3a e2 80 83 43 6f 6e ction 9.1: Con
1ac0: 66 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 20 figuration file
1ad0: 53 79 6e 74 61 78 3c 2f 61 3e 0a 3c 2f 64 69 76 Syntax</a>.</div
1ae0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f >.<div class="to
1af0: 63 69 6e 64 65 6e 74 22 3e 0a 3c 64 69 76 20 63 cindent">.<div c
1b00: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 lass="toc">.<a c
1b10: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 lass="Link" href
1b20: 3d 22 23 74 6f 63 2d 53 75 62 73 75 62 73 65 63 ="#toc-Subsubsec
1b30: 74 69 6f 6e 2d 39 2e 31 2e 31 22 3e 53 75 62 73 tion-9.1.1">Subs
1b40: 75 62 73 65 63 74 69 6f 6e 20 39 2e 31 2e 31 3a ubsection 9.1.1:
1b50: e2 80 83 53 65 63 74 69 6f 6e 73 3c 2f 61 3e 0a Sections</a>.
1b60: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 </div>.<div clas
1b70: 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 s="toc">.<a clas
1b80: 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 s="Link" href="#
1b90: 74 6f 63 2d 53 75 62 73 75 62 73 65 63 74 69 6f toc-Subsubsectio
1ba0: 6e 2d 39 2e 31 2e 32 22 3e 53 75 62 73 75 62 73 n-9.1.2">Subsubs
1bb0: 65 63 74 69 6f 6e 20 39 2e 31 2e 32 3a e2 80 83 ection 9.1.2:
1bc0: 56 61 72 69 61 62 6c 65 73 3c 2f 61 3e 0a 3c 2f Variables</a>.</
1bd0: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
1be0: 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d "toc">.<a class=
1bf0: 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f "Link" href="#to
1c00: 63 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d c-Subsubsection-
1c10: 39 2e 31 2e 33 22 3e 53 75 62 73 75 62 73 65 63 9.1.3">Subsubsec
1c20: 74 69 6f 6e 20 39 2e 31 2e 33 3a e2 80 83 49 6e tion 9.1.3: In
1c30: 63 6c 75 64 65 73 3c 2f 61 3e 0a 3c 2f 64 69 76 cludes</a>.</div
1c40: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f >.<div class="to
1c50: 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 c">.<a class="Li
1c60: 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 nk" href="#toc-S
1c70: 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 39 2e 31 ubsubsection-9.1
1c80: 2e 34 22 3e 53 75 62 73 75 62 73 65 63 74 69 6f .4">Subsubsectio
1c90: 6e 20 39 2e 31 2e 34 3a e2 80 83 53 65 74 74 69 n 9.1.4: Setti
1ca0: 6e 67 20 61 20 76 61 72 69 61 62 6c 65 20 62 79 ng a variable by
1cb0: 20 72 75 6e 6e 69 6e 67 20 61 20 63 6f 6d 6d 61 running a comma
1cc0: 6e 64 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 nd</a>.</div>.<d
1cd0: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
1ce0: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
1cf0: 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 75 href="#toc-Subsu
1d00: 62 73 65 63 74 69 6f 6e 2d 39 2e 31 2e 35 22 3e bsection-9.1.5">
1d10: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 20 39 2e Subsubsection 9.
1d20: 31 2e 35 3a e2 80 83 4e 6f 74 65 73 3c 2f 61 3e 1.5: Notes</a>
1d30: 0a 3c 2f 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c .</div>.</div>.<
1d40: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e div class="toc">
1d50: 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 .<a class="Link"
1d60: 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 href="#toc-Subs
1d70: 65 63 74 69 6f 6e 2d 39 2e 32 22 3e 53 75 62 73 ection-9.2">Subs
1d80: 65 63 74 69 6f 6e 20 39 2e 32 3a e2 80 83 45 6e ection 9.2: En
1d90: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
1da0: 6c 65 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c les</a>.</div>.<
1db0: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e div class="toc">
1dc0: 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 .<a class="Link"
1dd0: 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 href="#toc-Subs
1de0: 65 63 74 69 6f 6e 2d 39 2e 33 22 3e 53 75 62 73 ection-9.3">Subs
1df0: 65 63 74 69 6f 6e 20 39 2e 33 3a e2 80 83 6d 65 ection 9.3: me
1e00: 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 3c 2f 61 gatest.config</a
1e10: 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c >.</div>.<div cl
1e20: 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c ass="toc">.<a cl
1e30: 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d ass="Link" href=
1e40: 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e "#toc-Subsection
1e50: 2d 39 2e 34 22 3e 53 75 62 73 65 63 74 69 6f 6e -9.4">Subsection
1e60: 20 39 2e 34 3a e2 80 83 72 75 6e 63 6f 6e 66 69 9.4: runconfi
1e70: 67 73 2e 63 6f 6e 66 69 67 20 66 69 6c 65 3c 2f gs.config file</
1e80: 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 a>.</div>.<div c
1e90: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 lass="toc">.<a c
1ea0: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 lass="Link" href
1eb0: 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f ="#toc-Subsectio
1ec0: 6e 2d 39 2e 35 22 3e 53 75 62 73 65 63 74 69 6f n-9.5">Subsectio
1ed0: 6e 20 39 2e 35 3a e2 80 83 57 72 69 74 69 6e 67 n 9.5: Writing
1ee0: 20 74 65 73 74 73 3c 2f 61 3e 0a 3c 2f 64 69 76 tests</a>.</div
1ef0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f >.<div class="to
1f00: 63 69 6e 64 65 6e 74 22 3e 0a 3c 64 69 76 20 63 cindent">.<div c
1f10: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 lass="toc">.<a c
1f20: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 lass="Link" href
1f30: 3d 22 23 74 6f 63 2d 53 75 62 73 75 62 73 65 63 ="#toc-Subsubsec
1f40: 74 69 6f 6e 2d 39 2e 35 2e 31 22 3e 53 75 62 73 tion-9.5.1">Subs
1f50: 75 62 73 65 63 74 69 6f 6e 20 39 2e 35 2e 31 3a ubsection 9.5.1:
1f60: e2 80 83 74 65 73 74 63 6f 6e 66 69 67 20 66 69 testconfig fi
1f70: 6c 65 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 le</a>.</div>.<d
1f80: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
1f90: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
1fa0: 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 75 href="#toc-Subsu
1fb0: 62 73 65 63 74 69 6f 6e 2d 39 2e 35 2e 32 22 3e bsection-9.5.2">
1fc0: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 20 39 2e Subsubsection 9.
1fd0: 35 2e 32 3a e2 80 83 43 6f 6d 6d 61 6e 64 20 6c 5.2: Command l
1fe0: 69 6e 65 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c ine</a>.</div>.<
1ff0: 2f 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 /div>.</div>.<di
2000: 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c v class="toc">.<
2010: 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 a class="Link" h
2020: 72 65 66 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f ref="#toc-Sectio
2030: 6e 2d 41 22 3e 53 65 63 74 69 6f 6e 20 41 3a e2 n-A">Section A:
2040: 80 83 44 61 74 61 3c 2f 61 3e 0a 3c 2f 64 69 76 Data</a>.</div
2050: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f >.<div class="to
2060: 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 c">.<a class="Li
2070: 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 nk" href="#toc-S
2080: 65 63 74 69 6f 6e 2d 42 22 3e 53 65 63 74 69 6f ection-B">Sectio
2090: 6e 20 42 3a e2 80 83 52 65 66 65 72 65 6e 63 65 n B: Reference
20a0: 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f 64 s</a>.</div>.</d
20b0: 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 iv>..</div>.<div
20c0: 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 class="Standard
20d0: 22 3e 0a 3c 70 3e 3c 62 72 2f 3e 0a 3c 2f 70 3e ">.<p><br/>.</p>
20e0: 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 31 20 63 6c 61 ..</div>.<h1 cla
20f0: 73 73 3d 22 53 65 63 74 69 6f 6e 22 3e 0a 3c 61 ss="Section">.<a
2100: 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d class="toc" nam
2110: 65 3d 22 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 31 e="toc-Section-1
2120: 22 3e 31 3c 2f 61 3e e2 80 83 49 6e 74 72 6f 64 ">1</a> Introd
2130: 75 63 74 69 6f 6e 0a 3c 2f 68 31 3e 0a 3c 68 32 uction.</h1>.<h2
2140: 20 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 class="Subsecti
2150: 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 on">.<a class="t
2160: 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 oc" name="toc-Su
2170: 62 73 65 63 74 69 6f 6e 2d 31 2e 31 22 3e 31 2e bsection-1.1">1.
2180: 31 3c 2f 61 3e e2 80 83 4d 65 67 61 74 65 73 74 1</a> Megatest
2190: 20 64 65 73 69 67 6e 20 70 68 69 6c 6f 73 6f 70 design philosop
21a0: 68 79 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c hy.</h2>.<div cl
21b0: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
21c0: 4d 65 67 61 74 65 73 74 20 69 73 20 69 6e 74 65 Megatest is inte
21d0: 6e 64 65 64 20 74 6f 20 70 72 6f 76 69 64 65 20 nded to provide
21e0: 74 68 65 20 6d 69 6e 69 6d 75 6d 20 6e 65 65 64 the minimum need
21f0: 65 64 20 72 65 73 6f 75 72 63 65 73 20 74 6f 20 ed resources to
2200: 6d 61 6b 65 20 77 72 69 74 69 6e 67 20 61 20 73 make writing a s
2210: 75 69 74 65 20 6f 66 20 74 65 73 74 73 20 66 6f uite of tests fo
2220: 72 20 73 6f 66 74 77 61 72 65 2c 20 64 65 73 69 r software, desi
2230: 67 6e 20 65 6e 67 69 6e 65 65 72 69 6e 67 20 6f gn engineering o
2240: 72 20 70 72 6f 63 65 73 73 20 63 6f 6e 74 72 6f r process contro
2250: 6c 20 28 76 69 61 20 6f 77 6c 66 73 20 66 6f 72 l (via owlfs for
2260: 20 65 78 61 6d 70 6c 65 29 20 77 69 74 68 6f 75 example) withou
2270: 74 20 62 65 69 6e 67 20 73 70 65 63 69 61 6c 69 t being speciali
2280: 7a 65 64 20 66 6f 72 20 61 6e 79 20 73 70 65 63 zed for any spec
2290: 69 66 69 63 20 70 72 6f 62 6c 65 6d 20 73 70 61 ific problem spa
22a0: 63 65 2e 20 4d 65 67 61 74 65 73 74 20 69 6e 20 ce. Megatest in
22b0: 6f 66 20 69 74 73 65 6c 66 20 64 6f 65 73 20 6e of itself does n
22c0: 6f 74 20 6b 6e 6f 77 20 77 68 61 74 20 63 6f 6e ot know what con
22d0: 73 74 69 74 75 74 65 73 20 61 20 50 41 53 53 20 stitutes a PASS
22e0: 6f 72 20 46 41 49 4c 20 6f 66 20 61 20 74 65 73 or FAIL of a tes
22f0: 74 2e 20 49 6e 20 6d 6f 73 74 20 63 61 73 65 73 t. In most cases
2300: 20 6d 65 67 61 74 65 73 74 20 69 73 20 62 65 73 megatest is bes
2310: 74 20 75 73 65 64 20 69 6e 20 63 6f 6e 6a 75 6e t used in conjun
2320: 63 74 69 6f 6e 20 77 69 74 68 20 6c 6f 67 70 72 ction with logpr
2330: 6f 20 6f 72 20 61 20 73 69 6d 69 6c 61 72 20 74 o or a similar t
2340: 6f 6f 6c 20 74 6f 20 70 61 72 73 65 2c 20 61 6e ool to parse, an
2350: 61 6c 79 7a 65 20 61 6e 64 20 64 65 63 69 64 65 alyze and decide
2360: 20 6f 6e 20 74 68 65 20 74 65 73 74 20 6f 75 74 on the test out
2370: 63 6f 6d 65 2e 20 41 20 63 61 6c 6c 20 74 6f 20 come. A call to
2380: 6d 65 67 61 74 65 73 74 20 63 61 6e 20 74 68 65 megatest can the
2390: 6e 20 62 65 20 6d 61 64 65 20 74 6f 20 72 65 63 n be made to rec
23a0: 6f 72 64 20 74 68 65 20 72 65 73 75 6c 74 2e 20 ord the result.
23b0: 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 73 .</div>.<h2 clas
23c0: 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a s="Subsection">.
23d0: 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e <a class="toc" n
23e0: 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 ame="toc-Subsect
23f0: 69 6f 6e 2d 31 2e 32 22 3e 31 2e 32 3c 2f 61 3e ion-1.2">1.2</a>
2400: e2 80 83 4d 65 67 61 74 65 73 74 20 61 72 63 68 Megatest arch
2410: 69 74 65 63 74 75 72 65 0a 3c 2f 68 32 3e 0a 3c itecture.</h2>.<
2420: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
2430: 61 72 64 22 3e 0a 41 6c 6c 20 64 61 74 61 20 74 ard">.All data t
2440: 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 74 65 o specify the te
2450: 73 74 73 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 sts and configur
2460: 65 20 74 68 65 20 73 79 73 74 65 6d 20 69 73 20 e the system is
2470: 73 74 6f 72 65 64 20 69 6e 20 70 6c 61 69 6e 20 stored in plain
2480: 74 65 78 74 20 66 69 6c 65 73 2e 20 41 6c 6c 20 text files. All
2490: 73 79 73 74 65 6d 20 73 74 61 74 65 20 69 73 20 system state is
24a0: 73 74 6f 72 65 64 20 69 6e 20 61 6e 20 73 71 6c stored in an sql
24b0: 69 74 65 33 20 64 61 74 61 62 61 73 65 2e 20 54 ite3 database. T
24c0: 65 73 74 73 20 61 72 65 20 6c 61 75 6e 63 68 65 ests are launche
24d0: 64 20 75 73 69 6e 67 20 74 68 65 20 6c 61 75 6e d using the laun
24e0: 63 68 69 6e 67 20 73 79 73 74 65 6d 20 61 76 61 ching system ava
24f0: 69 6c 61 62 6c 65 20 66 6f 72 20 74 68 65 20 64 ilable for the d
2500: 69 73 74 72 69 62 75 74 65 64 20 63 6f 6d 70 75 istributed compu
2510: 74 65 20 70 6c 61 74 66 6f 72 6d 20 69 6e 20 75 te platform in u
2520: 73 65 2e 20 41 20 74 65 6d 70 6c 61 74 65 20 73 se. A template s
2530: 63 72 69 70 74 20 69 73 20 70 72 6f 76 69 64 65 cript is provide
2540: 64 20 77 68 69 63 68 20 63 61 6e 20 6c 61 75 6e d which can laun
2550: 63 68 20 6a 6f 62 73 20 6f 6e 20 6c 6f 63 61 6c ch jobs on local
2560: 20 61 6e 64 20 72 65 6d 6f 74 65 20 4c 69 6e 75 and remote Linu
2570: 78 20 68 6f 73 74 73 2e 20 43 75 72 72 65 6e 74 x hosts. Current
2580: 6c 79 20 6d 65 67 61 74 65 73 74 20 75 73 65 73 ly megatest uses
2590: 20 74 68 65 20 6e 65 74 77 6f 72 6b 20 66 69 6c the network fil
25a0: 65 73 79 73 74 65 6d 20 74 6f 20 e2 80 9c 63 61 esystem to “ca
25b0: 6c 6c 20 68 6f 6d 65 e2 80 9d 20 74 6f 20 79 6f ll home” to yo
25c0: 75 72 20 6d 61 73 74 65 72 20 73 71 6c 69 74 65 ur master sqlite
25d0: 33 20 64 61 74 61 62 61 73 65 2e 0a 3c 2f 64 69 3 database..</di
25e0: 76 3e 0a 3c 68 31 20 63 6c 61 73 73 3d 22 53 65 v>.<h1 class="Se
25f0: 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 ction">.<a class
2600: 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 ="toc" name="toc
2610: 2d 53 65 63 74 69 6f 6e 2d 32 22 3e 32 3c 2f 61 -Section-2">2</a
2620: 3e e2 80 83 49 6e 73 74 61 6c 6c 61 74 69 6f 6e > Installation
2630: 0a 3c 2f 68 31 3e 0a 3c 68 32 20 63 6c 61 73 73 .</h1>.<h2 class
2640: 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c ="Subsection">.<
2650: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
2660: 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 me="toc-Subsecti
2670: 6f 6e 2d 32 2e 31 22 3e 32 2e 31 3c 2f 61 3e e2 on-2.1">2.1</a>
2680: 80 83 44 65 70 65 6e 64 65 6e 63 69 65 73 0a 3c Dependencies.<
2690: 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d /h2>.<div class=
26a0: 22 53 74 61 6e 64 61 72 64 22 3e 0a 43 68 69 63 "Standard">.Chic
26b0: 6b 65 6e 20 73 63 68 65 6d 65 20 61 6e 64 20 61 ken scheme and a
26c0: 20 6e 75 6d 62 65 72 20 6f 66 20 e2 80 9c 65 67 number of “eg
26d0: 67 73 e2 80 9d 20 61 72 65 20 72 65 71 75 69 72 gs” are requir
26e0: 65 64 20 66 6f 72 20 62 75 69 6c 64 69 6e 67 20 ed for building
26f0: 6d 65 67 61 74 65 73 74 2e 20 53 65 65 20 74 68 megatest. See th
2700: 65 20 66 69 6c 65 20 75 74 69 6c 73 2f 69 6e 73 e file utils/ins
2710: 74 61 6c 6c 61 6c 6c 2e 73 68 20 66 6f 72 20 61 tallall.sh for a
2720: 6e 20 61 75 74 6f 6d 61 74 65 64 20 77 61 79 20 n automated way
2730: 74 6f 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 64 to install the d
2740: 65 70 65 6e 64 65 6e 63 69 65 73 20 6f 6e 20 4c ependencies on L
2750: 69 6e 75 78 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 32 inux..</div>.<h2
2760: 20 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 class="Subsecti
2770: 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 on">.<a class="t
2780: 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 oc" name="toc-Su
2790: 62 73 65 63 74 69 6f 6e 2d 32 2e 32 22 3e 32 2e bsection-2.2">2.
27a0: 32 3c 2f 61 3e e2 80 83 42 75 69 6c 64 20 61 6e 2</a> Build an
27b0: 64 20 49 6e 73 74 61 6c 6c 0a 3c 2f 68 32 3e 0a d Install.</h2>.
27c0: 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e <div class="Stan
27d0: 64 61 72 64 22 3e 0a 52 75 6e 20 e2 80 9c 6d 61 dard">.Run “ma
27e0: 6b 65 20 74 65 73 74 e2 80 9d 20 74 6f 20 63 72 ke test” to cr
27f0: 65 61 74 65 20 74 68 65 20 6d 65 67 61 74 65 73 eate the megates
2800: 74 20 65 78 65 63 75 74 61 62 6c 65 2e 20 59 6f t executable. Yo
2810: 75 20 6d 61 79 20 77 69 73 68 20 74 6f 20 63 6f u may wish to co
2820: 70 79 20 74 68 65 20 65 78 65 63 75 74 61 62 6c py the executabl
2830: 65 20 74 6f 20 61 20 63 65 6e 74 72 61 6c 6c 79 e to a centrally
2840: 20 61 63 63 65 73 73 69 62 6c 65 20 6c 6f 63 61 accessible loca
2850: 74 69 6f 6e 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 31 tion..</div>.<h1
2860: 20 63 6c 61 73 73 3d 22 53 65 63 74 69 6f 6e 22 class="Section"
2870: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 >.<a class="toc"
2880: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 65 63 74 69 name="toc-Secti
2890: 6f 6e 2d 33 22 3e 33 3c 2f 61 3e e2 80 83 53 65 on-3">3</a> Se
28a0: 74 75 70 0a 3c 2f 68 31 3e 0a 3c 68 32 20 63 6c tup.</h1>.<h2 cl
28b0: 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 ass="Subsection"
28c0: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 >.<a class="toc"
28d0: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 name="toc-Subse
28e0: 63 74 69 6f 6e 2d 33 2e 31 22 3e 33 2e 31 3c 2f ction-3.1">3.1</
28f0: 61 3e e2 80 83 43 72 65 61 74 65 20 6d 65 67 61 a> Create mega
2900: 74 65 73 74 2e 63 6f 6e 66 69 67 0a 3c 2f 68 32 test.config.</h2
2910: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
2920: 61 6e 64 61 72 64 22 3e 0a 43 72 65 61 74 65 20 andard">.Create
2930: 74 68 65 20 66 69 6c 65 20 6d 65 67 61 74 65 73 the file megates
2940: 74 2e 63 6f 6e 66 69 67 20 75 73 69 6e 67 20 74 t.config using t
2950: 68 65 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 he megatest.conf
2960: 69 67 20 74 65 6d 70 6c 61 74 65 20 66 72 6f 6d ig template from
2970: 20 74 68 65 20 74 65 73 74 73 20 64 69 72 65 63 the tests direc
2980: 74 6f 72 79 2e 20 41 74 20 61 20 6d 69 6e 69 6d tory. At a minim
2990: 75 6d 20 79 6f 75 20 6e 65 65 64 20 74 68 65 20 um you need the
29a0: 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 3c 2f 64 69 76 following:.</div
29b0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
29c0: 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c andard">.<div cl
29d0: 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c ass="listing">.<
29e0: 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 pre class="listi
29f0: 6e 67 22 3e 23 20 46 69 65 6c 64 73 20 61 72 65 ng"># Fields are
2a00: 20 74 68 65 20 6b 65 79 73 20 75 6e 64 65 72 20 the keys under
2a10: 77 68 69 63 68 20 79 6f 75 72 20 74 65 73 74 20 which your test
2a20: 72 75 6e 73 20 61 72 65 20 6f 72 67 61 6e 69 7a runs are organiz
2a30: 65 64 0a 5b 66 69 65 6c 64 73 5d 0a 66 69 65 6c ed.[fields].fiel
2a40: 64 31 20 54 45 58 54 0a 66 69 65 6c 64 32 20 54 d1 TEXT.field2 T
2a50: 45 58 54 0a e2 80 8b 0a 5b 6a 6f 62 74 6f 6f 6c EXT..[jobtool
2a60: 73 5d 0a 23 20 54 68 65 20 6c 61 75 6e 63 68 65 s].# The launche
2a70: 72 20 6c 61 75 6e 63 68 65 73 20 6a 6f 62 73 20 r launches jobs
2a80: 74 6f 20 74 68 65 20 6c 6f 63 61 6c 20 6f 72 20 to the local or
2a90: 72 65 6d 6f 74 65 20 68 6f 73 74 73 2c 0a 23 20 remote hosts,.#
2aa0: 74 68 65 20 6a 6f 62 20 69 73 20 6d 61 6e 61 67 the job is manag
2ab0: 65 64 20 6f 6e 20 74 68 65 20 74 61 72 67 65 74 ed on the target
2ac0: 20 68 6f 73 74 20 62 79 20 6d 65 67 61 74 65 73 host by megates
2ad0: 74 2c 0a 23 20 63 6f 6d 6d 65 6e 74 20 6f 75 74 t,.# comment out
2ae0: 20 6c 61 75 6e 63 68 65 72 20 74 6f 20 72 75 6e launcher to run
2af0: 20 6c 6f 63 61 6c 20 6f 6e 6c 79 2e 20 41 6e 20 local only. An
2b00: 65 78 61 6d 70 6c 65 20 6c 61 75 6e 63 68 65 72 example launcher
2b10: 0a 23 20 22 6e 62 66 61 6b 65 22 20 63 61 6e 20 .# "nbfake" can
2b20: 62 65 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 be found in the
2b30: 75 74 69 6c 73 20 64 69 72 65 63 74 6f 72 79 2e utils directory.
2b40: 20 0a 6c 61 75 6e 63 68 65 72 20 6e 62 66 61 6b .launcher nbfak
2b50: 65 0a e2 80 8b 0a 23 20 54 68 65 20 64 69 73 6b e..# The disk
2b60: 73 20 73 65 63 74 69 6f 6e 20 73 70 65 63 69 66 s section specif
2b70: 69 65 73 20 77 68 65 72 65 20 74 68 65 20 74 65 ies where the te
2b80: 73 74 73 20 77 69 6c 6c 20 62 65 20 72 75 6e 2e sts will be run.
2b90: 20 41 73 20 79 6f 75 0a 23 20 72 75 6e 20 6f 75 As you.# run ou
2ba0: 74 20 6f 66 20 73 70 61 63 65 20 69 6e 20 61 20 t of space in a
2bb0: 70 61 72 74 69 74 69 6f 6e 20 79 6f 75 20 63 61 partition you ca
2bc0: 6e 20 61 64 64 20 61 64 64 69 74 69 6f 6e 61 6c n add additional
2bd0: 20 64 69 73 6b 73 0a 23 20 65 6e 74 72 69 65 73 disks.# entries
2be0: 2e 0a 23 20 46 6f 72 6d 61 74 20 69 73 3a 0a 23 ..# Format is:.#
2bf0: 20 6e 61 6d 65 20 2f 70 61 74 68 2f 74 6f 2f 61 name /path/to/a
2c00: 72 65 61 20 0a 5b 64 69 73 6b 73 5d 0a 64 69 73 rea .[disks].dis
2c10: 6b 31 20 2f 74 6d 70 20 0a 3c 2f 70 72 65 3e 0a k1 /tmp .</pre>.
2c20: 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c </div>..</div>.<
2c30: 68 32 20 63 6c 61 73 73 3d 22 53 75 62 73 65 63 h2 class="Subsec
2c40: 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d tion">.<a class=
2c50: 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d "toc" name="toc-
2c60: 53 75 62 73 65 63 74 69 6f 6e 2d 33 2e 32 22 3e Subsection-3.2">
2c70: 33 2e 32 3c 2f 61 3e e2 80 83 43 72 65 61 74 65 3.2</a> Create
2c80: 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 runconfigs.conf
2c90: 69 67 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c ig.</h2>.<div cl
2ca0: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
2cb0: 54 68 69 73 20 66 69 6c 65 20 69 73 20 75 73 65 This file is use
2cc0: 64 20 74 6f 20 73 65 74 20 65 6e 76 69 72 6f 6e d to set environ
2cd0: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73 20 74 ment variables t
2ce0: 68 61 74 20 61 72 65 20 72 75 6e 20 73 70 65 63 hat are run spec
2cf0: 69 66 69 63 2e 20 59 6f 75 20 63 61 6e 20 73 69 ific. You can si
2d00: 6d 70 6c 79 20 63 72 65 61 74 65 20 61 6e 20 65 mply create an e
2d10: 6d 70 74 79 20 66 69 6c 65 20 74 6f 20 73 74 61 mpty file to sta
2d20: 72 74 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 rt..</div>.<div
2d30: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
2d40: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 >.<div class="li
2d50: 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 sting">.<pre cla
2d60: 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 23 20 72 ss="listing"># r
2d70: 75 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 unconfigs.config
2d80: 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a .</pre>.</div>..
2d90: 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 73 73 </div>.<h2 class
2da0: 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c ="Subsection">.<
2db0: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
2dc0: 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 me="toc-Subsecti
2dd0: 6f 6e 2d 33 2e 33 22 3e 33 2e 33 3c 2f 61 3e e2 on-3.3">3.3</a>
2de0: 80 83 43 72 65 61 74 65 20 74 68 65 20 74 65 73 Create the tes
2df0: 74 73 20 64 69 72 65 63 74 6f 72 79 20 61 6e 64 ts directory and
2e00: 20 79 6f 75 72 20 66 69 72 73 74 20 74 65 73 74 your first test
2e10: 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 .</h2>.<div clas
2e20: 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 s="Standard">.<d
2e30: 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e iv class="listin
2e40: 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 g">.<pre class="
2e50: 6c 69 73 74 69 6e 67 22 3e 2e 2e 2f 74 65 73 74 listing">../test
2e60: 73 0a 20 20 e2 94 9c e2 94 80 e2 94 80 20 6d 65 s. ├── me
2e70: 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 0a 20 20 gatest.config.
2e80: e2 94 9c e2 94 80 e2 94 80 20 72 75 6e 63 6f 6e ├── runcon
2e90: 66 69 67 73 2e 63 6f 6e 66 69 67 0a 20 20 e2 94 figs.config.
2ea0: 94 e2 94 80 e2 94 80 20 74 65 73 74 73 0a 20 20 ── tests.
2eb0: 20 20 20 e2 94 94 e2 94 80 e2 94 80 20 6d 79 74 └── myt
2ec0: 65 73 74 0a 20 20 20 20 20 20 20 20 20 20 20 e2 est.
2ed0: 94 9c e2 94 80 e2 94 80 20 6d 61 69 6e 2e 73 68 ── main.sh
2ee0: 0a 20 20 20 20 20 20 20 20 20 20 20 e2 94 94 e2 . └
2ef0: 94 80 e2 94 80 20 74 65 73 74 63 6f 6e 66 69 67 ─ testconfig
2f00: 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a .</pre>.</div>..
2f10: 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 73 73 </div>.<h2 class
2f20: 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c ="Subsection">.<
2f30: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
2f40: 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 me="toc-Subsecti
2f50: 6f 6e 2d 33 2e 34 22 3e 33 2e 34 3c 2f 61 3e e2 on-3.4">3.4</a>
2f60: 80 83 43 72 65 61 74 65 20 74 68 65 20 74 65 73 Create the tes
2f70: 74 63 6f 6e 66 69 67 20 66 69 6c 65 20 66 6f 72 tconfig file for
2f80: 20 79 6f 75 72 20 74 65 73 74 0a 3c 2f 68 32 3e your test.</h2>
2f90: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 .<div class="Sta
2fa0: 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 ndard">.<div cla
2fb0: 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 ss="listing">.<p
2fc0: 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e re class="listin
2fd0: 67 22 3e 5b 73 65 74 75 70 5d 0a 72 75 6e 73 63 g">[setup].runsc
2fe0: 72 69 70 74 20 6d 61 69 6e 2e 73 68 0a 3c 2f 70 ript main.sh.</p
2ff0: 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 re>.</div>..</di
3000: 76 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 v>.<h2 class="Su
3010: 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c bsection">.<a cl
3020: 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 ass="toc" name="
3030: 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 33 toc-Subsection-3
3040: 2e 35 22 3e 33 2e 35 3c 2f 61 3e e2 80 83 43 72 .5">3.5</a> Cr
3050: 65 61 74 65 20 79 6f 75 72 20 74 65 73 74 20 72 eate your test r
3060: 75 6e 6e 69 6e 67 20 73 63 72 69 70 74 2c 20 6d unning script, m
3070: 61 69 6e 2e 73 68 0a 3c 2f 68 32 3e 0a 3c 64 69 ain.sh.</h2>.<di
3080: 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 v class="Standar
3090: 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 d">.<div class="
30a0: 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 listing">.<pre c
30b0: 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 23 lass="listing">#
30c0: 21 2f 62 69 6e 2f 62 61 73 68 0a e2 80 8b 0a 24 !/bin/bash..$
30d0: 4d 54 5f 4d 45 47 41 54 45 53 54 20 2d 72 75 6e MT_MEGATEST -run
30e0: 73 74 65 70 20 6d 79 73 74 65 70 31 20 22 73 6c step mystep1 "sl
30f0: 65 65 70 20 32 30 3b 65 63 68 6f 20 44 6f 6e 65 eep 20;echo Done
3100: 22 20 2d 6d 20 22 6d 79 73 74 65 70 31 20 69 73 " -m "mystep1 is
3110: 20 64 6f 6e 65 22 0a 24 4d 54 5f 4d 45 47 41 54 done".$MT_MEGAT
3120: 45 53 54 20 2d 74 65 73 74 2d 73 74 61 74 75 73 EST -test-status
3130: 20 3a 73 74 61 74 65 20 43 4f 4d 50 4c 45 54 45 :state COMPLETE
3140: 44 20 3a 73 74 61 74 75 73 20 50 41 53 53 20 2d D :status PASS -
3150: 6d 20 22 54 68 69 73 20 69 73 20 61 20 63 6f 6d m "This is a com
3160: 6d 65 6e 74 22 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 ment".</pre>.</d
3170: 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 iv>..</div>.<h2
3180: 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f class="Subsectio
3190: 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f n">.<a class="to
31a0: 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 c" name="toc-Sub
31b0: 73 65 63 74 69 6f 6e 2d 33 2e 36 22 3e 33 2e 36 section-3.6">3.6
31c0: 3c 2f 61 3e e2 80 83 52 75 6e 20 6d 65 67 61 74 </a> Run megat
31d0: 65 73 74 20 61 6e 64 20 77 61 74 63 68 20 79 6f est and watch yo
31e0: 75 72 20 72 75 6e 20 70 72 6f 67 72 65 73 73 0a ur run progress.
31f0: 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 </h2>.<div class
3200: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 ="Standard">.<di
3210: 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 v class="listing
3220: 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c ">.<pre class="l
3230: 69 73 74 69 6e 67 22 3e 6d 65 67 61 74 65 73 74 isting">megatest
3240: 20 3a 66 69 65 6c 64 31 20 61 62 63 20 3a 66 69 :field1 abc :fi
3250: 65 6c 64 32 20 64 65 66 20 3a 72 75 6e 6e 61 6d eld2 def :runnam
3260: 65 20 32 30 31 31 77 65 65 6b 30 38 2e 34 61 20 e 2011week08.4a
3270: 2d 72 75 6e 61 6c 6c 0a e2 80 8b 0a 77 61 74 63 -runall..watc
3280: 68 20 6d 65 67 61 74 65 73 74 20 2d 6c 69 73 74 h megatest -list
3290: 2d 72 75 6e 73 20 25 0a e2 80 8b 0a 23 20 4f 52 -runs %..# OR
32a0: 20 75 73 65 20 74 68 65 20 64 61 73 68 62 6f 61 use the dashboa
32b0: 72 64 0a e2 80 8b 0a 64 61 73 68 62 6f 61 72 64 rd..dashboard
32c0: 20 26 61 6d 70 3b 0a 3c 2f 70 72 65 3e 0a 3c 2f &.</pre>.</
32d0: 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 31 div>..</div>.<h1
32e0: 20 63 6c 61 73 73 3d 22 53 65 63 74 69 6f 6e 22 class="Section"
32f0: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 >.<a class="toc"
3300: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 65 63 74 69 name="toc-Secti
3310: 6f 6e 2d 34 22 3e 34 3c 2f 61 3e e2 80 83 48 6f on-4">4</a> Ho
3320: 77 20 74 6f 20 57 72 69 74 65 20 54 65 73 74 73 w to Write Tests
3330: 0a 3c 2f 68 31 3e 0a 3c 68 32 20 63 6c 61 73 73 .</h1>.<h2 class
3340: 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c ="Subsection">.<
3350: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
3360: 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 me="toc-Subsecti
3370: 6f 6e 2d 34 2e 31 22 3e 34 2e 31 3c 2f 61 3e e2 on-4.1">4.1</a>
3380: 80 83 41 20 53 69 6d 70 6c 65 20 54 65 73 74 20 A Simple Test
3390: 77 69 74 68 20 6f 6e 65 20 53 74 65 70 0a 3c 2f with one Step.</
33a0: 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 h2>.<div class="
33b0: 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 Standard">.<div
33c0: 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e class="listing">
33d0: 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 .<pre class="lis
33e0: 74 69 6e 67 22 3e 6d 6b 64 69 72 20 73 69 6d 70 ting">mkdir simp
33f0: 6c 65 74 65 73 74 0a 63 64 20 73 69 6d 70 6c 65 letest.cd simple
3400: 74 65 73 74 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 test.</pre>.</di
3410: 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 v>..</div>.<h2 c
3420: 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e lass="Subsection
3430: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 ">.<a class="toc
3440: 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 " name="toc-Subs
3450: 65 63 74 69 6f 6e 2d 34 2e 32 22 3e 34 2e 32 3c ection-4.2">4.2<
3460: 2f 61 3e e2 80 83 43 72 65 61 74 65 20 79 6f 75 /a> Create you
3470: 72 20 74 65 73 74 63 6f 6e 66 69 67 20 66 69 6c r testconfig fil
3480: 65 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 e.</h2>.<div cla
3490: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c ss="Standard">.<
34a0: 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 div class="listi
34b0: 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 3d ng">.<pre class=
34c0: 22 6c 69 73 74 69 6e 67 22 3e 23 20 74 65 73 74 "listing"># test
34d0: 63 6f 6e 66 69 67 0a e2 80 8b 0a 5b 73 65 74 75 config..[setu
34e0: 70 5d 0a 72 75 6e 73 63 72 69 70 74 20 6d 61 69 p].runscript mai
34f0: 6e 2e 63 73 68 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 n.csh.</pre>.</d
3500: 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 iv>..</div>.<h2
3510: 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f class="Subsectio
3520: 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f n">.<a class="to
3530: 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 c" name="toc-Sub
3540: 73 65 63 74 69 6f 6e 2d 34 2e 33 22 3e 34 2e 33 section-4.3">4.3
3550: 3c 2f 61 3e e2 80 83 43 72 65 61 74 65 20 74 68 </a> Create th
3560: 65 20 6d 61 69 6e 2e 63 73 68 20 73 63 72 69 70 e main.csh scrip
3570: 74 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 t.</h2>.<div cla
3580: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 4e ss="Standard">.N
3590: 6f 74 65 3a 20 55 73 69 6e 67 20 63 73 68 20 69 ote: Using csh i
35a0: 73 20 4e 4f 54 20 72 65 63 6f 6d 6d 65 6e 64 65 s NOT recommende
35b0: 64 2e 20 55 73 65 20 62 61 73 68 2c 20 70 65 72 d. Use bash, per
35c0: 6c 2c 20 72 75 62 79 2c 20 7a 73 68 20 6f 72 20 l, ruby, zsh or
35d0: 61 6e 79 74 68 69 6e 67 20 6f 74 68 65 72 20 74 anything other t
35e0: 68 61 6e 20 63 73 68 2e 20 57 65 20 75 73 65 20 han csh. We use
35f0: 63 73 68 20 68 65 72 65 20 62 65 63 61 75 73 65 csh here because
3600: 20 69 74 20 69 73 20 70 6f 70 75 6c 61 72 20 69 it is popular i
3610: 6e 20 74 68 65 20 45 44 41 20 69 6e 64 75 73 74 n the EDA indust
3620: 72 79 20 66 6f 72 20 77 68 69 63 68 20 4d 65 67 ry for which Meg
3630: 61 74 65 73 74 20 77 61 73 20 6f 72 69 67 69 6e atest was origin
3640: 61 6c 6c 79 20 63 72 65 61 74 65 64 2e 20 0a 3c ally created. .<
3650: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
3660: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 ="Standard">.<di
3670: 76 20 63 6c 61 73 73 3d 22 6c 65 66 74 22 3e 0a v class="left">.
3680: 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 <div class="list
3690: 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 ing">.<pre class
36a0: 3d 22 6c 69 73 74 69 6e 67 22 3e 23 21 2f 62 69 ="listing">#!/bi
36b0: 6e 2f 74 63 73 68 20 2d 78 0a e2 80 8b 0a 23 20 n/tcsh -x..#
36c0: 72 75 6e 20 74 68 65 20 63 70 75 31 20 73 69 6d run the cpu1 sim
36d0: 75 6c 61 74 69 6f 6e 2e 0a 23 20 20 20 54 68 65 ulation..# The
36e0: 20 73 74 65 70 20 6e 61 6d 65 20 69 73 20 22 72 step name is "r
36f0: 75 6e 5f 73 69 6d 75 6c 61 74 69 6f 6e 22 0a 23 un_simulation".#
3700: 20 20 20 54 68 65 20 63 6f 6d 6d 61 6e 64 6c 69 The commandli
3710: 6e 65 20 62 65 69 6e 67 20 72 75 6e 20 66 6f 72 ne being run for
3720: 20 74 68 69 73 20 73 74 65 70 20 69 73 20 22 72 this step is "r
3730: 75 6e 73 69 6d 20 63 70 75 31 22 0a 23 20 20 20 unsim cpu1".#
3740: 54 68 65 20 6c 6f 67 70 72 6f 20 66 69 6c 65 20 The logpro file
3750: 74 6f 20 76 61 6c 69 64 61 74 65 20 74 68 65 20 to validate the
3760: 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 65 20 output from the
3770: 72 75 6e 20 69 73 20 22 72 75 6e 73 69 6d 2e 6c run is "runsim.l
3780: 6f 67 70 72 6f 22 0a e2 80 8b 0a 24 4d 54 5f 4d ogpro"..$MT_M
3790: 45 47 41 54 45 53 54 20 2d 72 75 6e 73 74 65 70 EGATEST -runstep
37a0: 20 72 75 6e 5f 73 69 6d 75 6c 61 74 69 6f 6e 20 run_simulation
37b0: 2d 6c 6f 67 70 72 6f 20 72 75 6e 73 69 6d 2e 6c -logpro runsim.l
37c0: 6f 67 70 72 6f 20 22 72 75 6e 73 69 6d 20 63 70 ogpro "runsim cp
37d0: 75 31 22 0a 24 4d 54 5f 4d 45 47 41 54 45 53 54 u1".$MT_MEGATEST
37e0: 20 2d 74 65 73 74 2d 73 74 61 74 75 73 20 3a 73 -test-status :s
37f0: 74 61 74 65 20 43 4f 4d 50 4c 45 54 45 44 20 3a tate COMPLETED :
3800: 73 74 61 74 75 73 20 24 3f 0a 3c 2f 70 72 65 3e status $?.</pre>
3810: 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a .</div>..</div>.
3820: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
3830: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 59 ss="Standard">.Y
3840: 6f 75 20 63 61 6e 20 6e 6f 77 20 72 75 6e 20 6d ou can now run m
3850: 65 67 61 74 65 73 74 20 61 6e 64 20 74 68 65 20 egatest and the
3860: 63 72 65 61 74 65 64 20 74 65 73 74 20 64 69 72 created test dir
3870: 65 63 74 6f 72 79 20 77 69 6c 6c 20 63 6f 6e 74 ectory will cont
3880: 61 69 6e 20 74 68 65 20 6e 65 77 20 66 69 6c 65 ain the new file
3890: 73 20 e2 80 9c 72 75 6e 5f 73 69 6d 75 6c 61 74 s “run_simulat
38a0: 69 6f 6e 2e 68 74 6d 6c e2 80 9d 20 61 6e 64 20 ion.html” and
38b0: e2 80 9c 72 75 6e 5f 73 69 6d 75 6c 61 74 69 6f “run_simulatio
38c0: 6e 2e 6c 6f 67 e2 80 9d 2e 20 49 66 20 79 6f 75 n.log”. If you
38d0: 20 61 72 65 20 75 73 69 6e 67 20 74 68 65 20 64 are using the d
38e0: 61 73 68 62 6f 61 72 64 20 79 6f 75 20 63 61 6e ashboard you can
38f0: 20 63 6c 69 63 6b 20 6f 6e 20 74 68 65 20 72 75 click on the ru
3900: 6e 20 61 6e 64 20 74 68 65 6e 20 70 75 73 68 20 n and then push
3910: 74 68 65 20 e2 80 9c 56 69 65 77 20 6c 6f 67 e2 the “View log
3920: 80 9d 20 62 75 74 74 6f 6e 20 74 6f 20 76 69 65 button to vie
3930: 77 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 20 69 w the log file i
3940: 6e 20 66 69 72 65 66 6f 78 2e 0a 3c 2f 64 69 76 n firefox..</div
3950: 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 >.<h2 class="Sub
3960: 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 section">.<a cla
3970: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
3980: 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 34 2e oc-Subsection-4.
3990: 34 22 3e 34 2e 34 3c 2f 61 3e e2 80 83 53 69 6d 4">4.4</a> Sim
39a0: 70 6c 65 20 54 65 73 74 20 77 69 74 68 20 4d 75 ple Test with Mu
39b0: 6c 74 69 70 6c 65 20 53 74 65 70 73 20 0a 3c 2f ltiple Steps .</
39c0: 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 h2>.<div class="
39d0: 53 74 61 6e 64 61 72 64 22 3e 0a 54 6f 20 72 75 Standard">.To ru
39e0: 6e 20 6d 75 6c 74 69 70 6c 65 20 73 74 65 70 73 n multiple steps
39f0: 20 73 69 6d 70 6c 79 20 61 64 64 20 74 68 65 6d simply add them
3a00: 20 74 6f 20 74 68 65 20 6d 61 69 6e 2e 63 73 68 to the main.csh
3a10: 20 66 69 6c 65 2e 20 48 65 72 65 20 77 65 20 61 file. Here we a
3a20: 64 64 20 61 20 73 74 65 70 20 74 6f 20 74 65 73 dd a step to tes
3a30: 74 20 e2 80 9c 63 70 75 32 e2 80 9d 2e 20 54 68 t “cpu2”. Th
3a40: 65 20 73 65 63 6f 6e 64 20 73 74 65 70 20 74 68 e second step th
3a50: 61 74 20 74 65 73 74 73 20 63 70 75 32 20 77 69 at tests cpu2 wi
3a60: 6c 6c 20 6f 6e 6c 79 20 72 75 6e 20 61 66 74 65 ll only run afte
3a70: 72 20 74 68 65 20 73 74 65 70 20 74 68 61 74 20 r the step that
3a80: 74 65 73 74 65 64 20 e2 80 9c 63 70 75 31 e2 80 tested “cpu1
3a90: 9d 20 63 6f 6d 70 6c 65 74 65 73 2e 0a 3c 2f 64 completes..</d
3aa0: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 iv>.<div class="
3ab0: 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 Standard">.<div
3ac0: 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e class="listing">
3ad0: 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 .<pre class="lis
3ae0: 74 69 6e 67 22 3e 23 21 2f 62 69 6e 2f 74 63 73 ting">#!/bin/tcs
3af0: 68 20 2d 78 0a e2 80 8b 0a 23 20 72 75 6e 20 74 h -x..# run t
3b00: 68 65 20 63 70 75 31 20 73 69 6d 75 6c 61 74 69 he cpu1 simulati
3b10: 6f 6e 2e 0a 23 20 20 20 54 68 65 20 73 74 65 70 on..# The step
3b20: 20 6e 61 6d 65 20 69 73 20 22 72 75 6e 5f 73 69 name is "run_si
3b30: 6d 75 6c 61 74 69 6f 6e 22 0a 23 20 20 20 54 68 mulation".# Th
3b40: 65 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65 20 62 65 e commandline be
3b50: 69 6e 67 20 72 75 6e 20 66 6f 72 20 74 68 69 73 ing run for this
3b60: 20 73 74 65 70 20 69 73 20 22 72 75 6e 73 69 6d step is "runsim
3b70: 20 63 70 75 31 22 0a 23 20 20 20 54 68 65 20 6c cpu1".# The l
3b80: 6f 67 70 72 6f 20 66 69 6c 65 20 74 6f 20 76 61 ogpro file to va
3b90: 6c 69 64 61 74 65 20 74 68 65 20 6f 75 74 70 75 lidate the outpu
3ba0: 74 20 66 72 6f 6d 20 74 68 65 20 72 75 6e 20 69 t from the run i
3bb0: 73 20 22 72 75 6e 73 69 6d 2e 6c 6f 67 70 72 6f s "runsim.logpro
3bc0: 22 0a e2 80 8b 0a 24 4d 54 5f 4d 45 47 41 54 45 "..$MT_MEGATE
3bd0: 53 54 20 2d 72 75 6e 73 74 65 70 20 72 75 6e 5f ST -runstep run_
3be0: 73 69 6d 75 6c 61 74 69 6f 6e 5f 63 70 75 31 20 simulation_cpu1
3bf0: 2d 6c 6f 67 70 72 6f 20 72 75 6e 73 69 6d 2e 6c -logpro runsim.l
3c00: 6f 67 70 72 6f 20 22 72 75 6e 73 69 6d 20 63 70 ogpro "runsim cp
3c10: 75 31 22 20 26 61 6d 70 3b 26 61 6d 70 3b 20 5c u1" && \
3c20: 0a 24 4d 54 5f 4d 45 47 41 54 45 53 54 20 2d 72 .$MT_MEGATEST -r
3c30: 75 6e 73 74 65 70 20 72 75 6e 5f 73 69 6d 75 6c unstep run_simul
3c40: 61 74 69 6f 6e 5f 63 70 75 32 20 2d 6c 6f 67 70 ation_cpu2 -logp
3c50: 72 6f 20 72 75 6e 73 69 6d 2e 6c 6f 67 70 72 6f ro runsim.logpro
3c60: 20 22 72 75 6e 73 69 6d 20 63 70 75 32 22 0a 24 "runsim cpu2".$
3c70: 4d 54 5f 4d 45 47 41 54 45 53 54 20 2d 74 65 73 MT_MEGATEST -tes
3c80: 74 2d 73 74 61 74 75 73 20 3a 73 74 61 74 65 20 t-status :state
3c90: 43 4f 4d 50 4c 45 54 45 44 20 3a 73 74 61 74 75 COMPLETED :statu
3ca0: 73 20 24 3f 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 s $?.</pre>.</di
3cb0: 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 31 20 63 v>..</div>.<h1 c
3cc0: 6c 61 73 73 3d 22 53 65 63 74 69 6f 6e 22 3e 0a lass="Section">.
3cd0: 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e <a class="toc" n
3ce0: 61 6d 65 3d 22 74 6f 63 2d 53 65 63 74 69 6f 6e ame="toc-Section
3cf0: 2d 35 22 3e 35 3c 2f 61 3e e2 80 83 53 69 6d 70 -5">5</a> Simp
3d00: 6c 65 20 54 65 73 74 20 77 69 74 68 20 4d 75 6c le Test with Mul
3d10: 74 69 70 6c 65 20 53 74 65 70 73 2c 20 53 6f 6d tiple Steps, Som
3d20: 65 20 69 6e 20 50 61 72 61 6c 6c 65 6c 0a 3c 2f e in Parallel.</
3d30: 68 31 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 h1>.<h2 class="S
3d40: 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 ubsection">.<a c
3d50: 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d lass="toc" name=
3d60: 22 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d "toc-Subsection-
3d70: 35 2e 31 22 3e 35 2e 31 3c 2f 61 3e e2 80 83 54 5.1">5.1</a> T
3d80: 68 65 20 4d 61 6b 65 66 69 6c 65 0a 3c 2f 68 32 he Makefile.</h2
3d90: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
3da0: 61 6e 64 61 72 64 22 3e 0a 41 20 67 6f 6f 64 20 andard">.A good
3db0: 77 61 79 20 74 6f 20 72 75 6e 20 73 74 65 70 73 way to run steps
3dc0: 20 69 6e 20 70 61 72 61 6c 6c 65 6c 20 77 69 74 in parallel wit
3dd0: 68 69 6e 20 61 20 73 69 6e 67 6c 65 20 74 65 73 hin a single tes
3de0: 74 2c 20 65 73 70 65 63 69 61 6c 6c 79 20 77 68 t, especially wh
3df0: 65 6e 20 74 68 65 72 65 20 61 72 65 20 66 6f 6c en there are fol
3e00: 6c 6f 77 69 6e 67 20 73 74 65 70 73 2c 20 69 73 lowing steps, is
3e10: 20 74 6f 20 75 73 65 20 74 68 65 20 55 6e 69 78 to use the Unix
3e20: 20 4d 61 6b 65 20 75 74 69 6c 69 74 79 2e 20 57 Make utility. W
3e30: 72 69 74 69 6e 67 20 4d 61 6b 65 66 69 6c 65 73 riting Makefiles
3e40: 20 69 73 20 62 65 79 6f 6e 64 20 74 68 65 20 73 is beyond the s
3e50: 63 6f 70 65 20 6f 66 20 74 68 69 73 20 64 6f 63 cope of this doc
3e60: 75 6d 65 6e 74 20 62 75 74 20 68 65 72 65 20 69 ument but here i
3e70: 73 20 61 20 6d 69 6e 69 6d 61 6c 20 65 78 61 6d s a minimal exam
3e80: 70 6c 65 20 74 68 61 74 20 77 69 6c 6c 20 72 75 ple that will ru
3e90: 6e 20 e2 80 9c 72 75 6e 73 69 6d 20 63 70 75 31 n “runsim cpu1
3ea0: e2 80 9d 20 61 6e 64 20 e2 80 9c 72 75 6e 73 69 ” and “runsi
3eb0: 6d 20 63 70 75 32 e2 80 9d 20 69 6e 20 70 61 72 m cpu2” in par
3ec0: 61 6c 6c 65 6c 2e 20 46 6f 72 20 6d 6f 72 65 20 allel. For more
3ed0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 6d information on m
3ee0: 61 6b 65 20 74 72 79 20 e2 80 9c 69 6e 66 6f 20 ake try “info
3ef0: 6d 61 6b 65 e2 80 9d 20 61 74 20 74 68 65 20 4c make” at the L
3f00: 69 6e 75 78 20 63 6f 6d 6d 61 6e 64 20 70 72 6f inux command pro
3f10: 6d 70 74 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 mpt..</div>.<div
3f20: 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 class="Standard
3f30: 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c ">.<div class="l
3f40: 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c isting">.<pre cl
3f50: 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 23 20 ass="listing">#
3f60: 45 78 61 6d 70 6c 65 20 4d 61 6b 65 66 69 6c 65 Example Makefile
3f70: 20 74 6f 20 72 75 6e 20 74 77 6f 20 73 74 65 70 to run two step
3f80: 73 20 69 6e 20 70 61 72 61 6c 6c 65 6c 0a e2 80 s in parallel.
3f90: 8b 0a 52 54 4c 44 49 52 3d 2f 70 61 74 68 2f 74 .RTLDIR=/path/t
3fa0: 6f 2f 72 74 6c 0a 43 50 55 53 20 3d 20 63 70 75 o/rtl.CPUS = cpu
3fb0: 31 20 63 70 75 32 0a e2 80 8b 0a 72 75 6e 5f 73 1 cpu2..run_s
3fc0: 69 6d 75 6c 61 74 69 6f 6e 5f 24 28 43 50 55 53 imulation_$(CPUS
3fd0: 29 2e 68 74 6d 6c 20 3a 20 24 28 52 54 4c 44 49 ).html : $(RTLDI
3fe0: 52 29 2f 24 28 43 50 55 53 29 0a 09 24 28 4d 54 R)/$(CPUS)..$(MT
3ff0: 5f 4d 45 47 41 54 45 53 54 29 20 2d 72 75 6e 73 _MEGATEST) -runs
4000: 74 65 70 20 72 75 6e 5f 73 69 6d 75 6c 61 74 69 tep run_simulati
4010: 6f 6e 5f 24 28 43 50 55 53 29 20 2d 6c 6f 67 70 on_$(CPUS) -logp
4020: 72 6f 20 72 75 6e 73 69 6d 2e 6c 6f 67 70 72 6f ro runsim.logpro
4030: 20 22 72 75 6e 73 69 6d 20 24 28 43 50 55 53 29 "runsim $(CPUS)
4040: 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a .</pre>.</div>..
4050: 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 73 73 </div>.<h2 class
4060: 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c ="Subsection">.<
4070: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
4080: 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 me="toc-Subsecti
4090: 6f 6e 2d 35 2e 32 22 3e 35 2e 32 3c 2f 61 3e e2 on-5.2">5.2</a>
40a0: 80 83 54 68 65 20 6d 61 69 6e 2e 63 73 68 20 66 The main.csh f
40b0: 69 6c 65 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 ile.</h2>.<div c
40c0: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
40d0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 .<div class="lis
40e0: 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 ting">.<pre clas
40f0: 73 3d 22 6c 69 73 74 69 6e 67 22 3e 23 21 2f 62 s="listing">#!/b
4100: 69 6e 2f 74 63 73 68 20 2d 78 0a e2 80 8b 0a 23 in/tcsh -x..#
4110: 20 72 75 6e 20 74 68 65 20 63 70 75 31 20 61 6e run the cpu1 an
4120: 64 20 63 70 75 32 20 73 69 6d 75 6c 61 74 69 6f d cpu2 simulatio
4130: 6e 73 20 69 6e 20 70 61 72 61 6c 6c 65 6c 2e 20 ns in parallel.
4140: 0a 23 20 54 68 65 20 2d 6a 20 70 61 72 61 6d 65 .# The -j parame
4150: 74 65 72 20 74 65 6c 6c 73 20 6d 61 6b 65 20 68 ter tells make h
4160: 6f 77 20 6d 61 6e 79 20 6a 6f 62 73 20 69 74 20 ow many jobs it
4170: 6d 61 79 20 72 75 6e 20 69 6e 20 70 61 72 61 6c may run in paral
4180: 6c 65 6c 0a e2 80 8b 0a 3c 64 69 76 20 63 6c 61 lel..<div cla
4190: 73 73 3d 22 6c 65 66 74 22 3e 0a 6d 61 6b 65 20 ss="left">.make
41a0: 2d 6a 20 32 20 0a 3c 2f 64 69 76 3e 0a 0a 24 4d -j 2 .</div>..$M
41b0: 54 5f 4d 45 47 41 54 45 53 54 20 2d 74 65 73 74 T_MEGATEST -test
41c0: 2d 73 74 61 74 75 73 20 3a 73 74 61 74 65 20 43 -status :state C
41d0: 4f 4d 50 4c 45 54 45 44 20 3a 73 74 61 74 75 73 OMPLETED :status
41e0: 20 24 3f 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 $?.</pre>.</div
41f0: 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 31 20 63 6c >..</div>.<h1 cl
4200: 61 73 73 3d 22 53 65 63 74 69 6f 6e 22 3e 0a 3c ass="Section">.<
4210: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
4220: 6d 65 3d 22 74 6f 63 2d 53 65 63 74 69 6f 6e 2d me="toc-Section-
4230: 36 22 3e 36 3c 2f 61 3e e2 80 83 53 69 6d 70 6c 6">6</a> Simpl
4240: 65 20 54 65 73 74 20 77 69 74 68 20 49 74 65 72 e Test with Iter
4250: 61 74 69 6f 6e 0a 3c 2f 68 31 3e 0a 3c 64 69 76 ation.</h1>.<div
4260: 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 class="Standard
4270: 22 3e 0a 53 69 6e 63 65 20 6e 6f 20 6a 6f 62 73 ">.Since no jobs
4280: 20 72 75 6e 20 61 66 74 65 72 20 74 68 65 20 63 run after the c
4290: 70 75 31 20 61 6e 64 20 63 70 75 32 20 73 69 6d pu1 and cpu2 sim
42a0: 75 6c 61 74 69 6f 6e 73 20 69 6e 20 74 68 69 73 ulations in this
42b0: 20 74 65 73 74 20 69 74 20 69 73 20 70 6f 73 73 test it is poss
42c0: 69 62 6c 65 20 74 6f 20 75 73 65 20 69 74 65 72 ible to use iter
42d0: 61 74 65 64 20 6d 6f 64 65 2e 0a 3c 2f 64 69 76 ated mode..</div
42e0: 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 >.<h2 class="Sub
42f0: 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 section">.<a cla
4300: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
4310: 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 36 2e oc-Subsection-6.
4320: 31 22 3e 36 2e 31 3c 2f 61 3e e2 80 83 55 70 64 1">6.1</a> Upd
4330: 61 74 65 20 79 6f 75 72 20 74 65 73 74 63 6f 6e ate your testcon
4340: 66 69 67 20 66 69 6c 65 20 66 6f 72 20 69 74 65 fig file for ite
4350: 72 61 74 69 6f 6e 0a 3c 2f 68 32 3e 0a 3c 64 69 ration.</h2>.<di
4360: 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 v class="Standar
4370: 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 d">.<div class="
4380: 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 listing">.<pre c
4390: 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 5b lass="listing">[
43a0: 73 65 74 75 70 5d 0a 72 75 6e 73 63 72 69 70 74 setup].runscript
43b0: 20 6d 61 69 6e 2e 63 73 68 0a 3c 64 69 76 20 63 main.csh.<div c
43c0: 6c 61 73 73 3d 22 6c 65 66 74 22 3e 0a 0a 3c 2f lass="left">..</
43d0: 64 69 76 3e 0a 0a 5b 69 74 65 6d 73 5d 0a 43 50 div>..[items].CP
43e0: 55 20 63 70 75 31 20 63 70 75 32 0a 3c 2f 70 72 U cpu1 cpu2.</pr
43f0: 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 e>.</div>..</div
4400: 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 >.<h2 class="Sub
4410: 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 section">.<a cla
4420: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
4430: 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 36 2e oc-Subsection-6.
4440: 32 22 3e 36 2e 32 3c 2f 61 3e e2 80 83 52 65 77 2">6.2</a> Rew
4450: 72 69 74 65 20 79 6f 75 72 20 6d 61 69 6e 2e 63 rite your main.c
4460: 73 68 20 66 6f 72 20 69 74 65 72 61 74 69 6f 6e sh for iteration
4470: 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 .</h2>.<div clas
4480: 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 s="Standard">.<d
4490: 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e iv class="listin
44a0: 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 g">.<pre class="
44b0: 6c 69 73 74 69 6e 67 22 3e 23 21 2f 62 69 6e 2f listing">#!/bin/
44c0: 74 63 73 68 20 2d 78 0a 0a 23 20 72 75 6e 20 74 tcsh -x..# run t
44d0: 68 65 20 63 70 75 20 73 69 6d 75 6c 61 74 69 6f he cpu simulatio
44e0: 6e 20 62 75 74 20 6e 6f 77 20 75 73 65 20 74 68 n but now use th
44f0: 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 e environment va
4500: 72 69 61 62 6c 65 20 24 43 50 55 0a 23 20 74 6f riable $CPU.# to
4510: 20 73 65 6c 65 63 74 20 77 68 61 74 20 63 70 75 select what cpu
4520: 20 74 6f 20 72 75 6e 20 74 68 65 20 73 69 6d 75 to run the simu
4530: 6c 61 74 69 6f 6e 20 61 67 61 69 6e 73 74 0a 0a lation against..
4540: 24 4d 54 5f 4d 45 47 41 54 45 53 54 20 2d 72 75 $MT_MEGATEST -ru
4550: 6e 73 74 65 70 20 72 75 6e 5f 73 69 6d 75 6c 61 nstep run_simula
4560: 74 69 6f 6e 20 2d 6c 6f 67 70 72 6f 20 72 75 6e tion -logpro run
4570: 73 69 6d 2e 6c 6f 67 70 72 6f 20 22 72 75 6e 73 sim.logpro "runs
4580: 69 6d 20 24 43 50 55 22 0a 23 20 41 73 20 6f 66 im $CPU".# As of
4590: 20 76 65 72 73 69 6f 6e 20 31 2e 30 37 20 4d 65 version 1.07 Me
45a0: 67 61 74 65 73 74 20 61 75 74 6f 6d 61 74 69 63 gatest automatic
45b0: 61 6c 6c 79 20 63 6f 6e 76 65 72 74 73 20 61 20 ally converts a
45c0: 73 74 61 74 75 73 20 6f 66 20 22 30 22 0a 23 20 status of "0".#
45d0: 74 6f 20 22 50 41 53 53 22 2c 20 61 6e 79 20 6f to "PASS", any o
45e0: 74 68 65 72 20 6e 75 6d 62 65 72 20 74 6f 20 22 ther number to "
45f0: 46 41 49 4c 22 20 61 6e 64 20 64 69 72 65 63 74 FAIL" and direct
4600: 6c 79 20 75 73 65 73 20 74 68 65 20 76 61 6c 75 ly uses the valu
4610: 65 20 6f 66 0a 23 20 61 20 73 74 72 69 6e 67 20 e of.# a string
4620: 70 61 73 73 65 64 20 69 6e 2e 0a 24 4d 54 5f 4d passed in..$MT_M
4630: 45 47 41 54 45 53 54 20 2d 74 65 73 74 2d 73 74 EGATEST -test-st
4640: 61 74 75 73 20 3a 73 74 61 74 65 20 43 4f 4d 50 atus :state COMP
4650: 4c 45 54 45 44 20 3a 73 74 61 74 75 73 20 24 3f LETED :status $?
4660: 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a .</pre>.</div>..
4670: 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 73 73 </div>.<h2 class
4680: 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c ="Subsection">.<
4690: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
46a0: 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 me="toc-Subsecti
46b0: 6f 6e 2d 36 2e 33 22 3e 36 2e 33 3c 2f 61 3e e2 on-6.3">6.3</a>
46c0: 80 83 54 65 73 74 73 20 77 69 74 68 20 49 6e 74 Tests with Int
46d0: 65 72 2d 74 65 73 74 20 64 65 70 65 6e 64 65 6e er-test dependen
46e0: 63 69 65 73 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 cies.</h2>.<div
46f0: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
4700: 3e 0a 53 6f 6d 65 74 69 6d 65 73 20 61 20 74 65 >.Sometimes a te
4710: 73 74 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 st depends on th
4720: 65 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 61 20 e output from a
4730: 70 72 65 76 69 6f 75 73 20 74 65 73 74 20 6f 72 previous test or
4740: 20 69 74 20 6d 61 79 20 6e 6f 74 20 6d 61 6b 65 it may not make
4750: 20 73 65 6e 73 65 20 74 6f 20 72 75 6e 20 61 20 sense to run a
4760: 74 65 73 74 20 69 73 20 61 6e 6f 74 68 65 72 20 test is another
4770: 74 65 73 74 20 64 6f 65 73 20 6e 6f 74 20 63 6f test does not co
4780: 6d 70 6c 65 74 65 20 77 69 74 68 20 73 74 61 74 mplete with stat
4790: 75 73 20 e2 80 9c 50 41 53 53 e2 80 9d 2e 20 49 us “PASS”. I
47a0: 6e 20 65 69 74 68 65 72 20 6f 66 20 74 68 65 73 n either of thes
47b0: 65 20 73 63 65 6e 61 72 69 6f 73 20 79 6f 75 20 e scenarios you
47c0: 63 61 6e 20 75 73 65 20 74 68 65 20 e2 80 9c 77 can use the “w
47d0: 61 69 74 6f 6e e2 80 9d 20 6b 65 79 77 6f 72 64 aiton” keyword
47e0: 20 69 6e 20 79 6f 75 72 20 74 65 73 74 63 6f 6e in your testcon
47f0: 66 69 67 20 66 69 6c 65 20 74 6f 20 69 6e 64 69 fig file to indi
4800: 63 61 74 65 20 74 68 61 74 20 74 68 69 73 20 74 cate that this t
4810: 65 73 74 20 6d 75 73 74 20 77 61 69 74 20 6f 6e est must wait on
4820: 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 74 65 73 one or more tes
4830: 74 73 20 74 6f 20 63 6f 6d 70 6c 65 74 65 20 62 ts to complete b
4840: 65 66 6f 72 65 20 62 65 69 6e 67 20 6c 61 75 6e efore being laun
4850: 63 68 65 64 2e 20 49 6e 20 74 68 69 73 20 65 78 ched. In this ex
4860: 61 6d 70 6c 65 20 74 68 65 72 65 20 69 73 20 6e ample there is n
4870: 6f 20 70 6f 69 6e 74 20 69 6e 20 72 75 6e 6e 69 o point in runni
4880: 6e 67 20 74 68 65 20 e2 80 9c 73 79 73 74 65 6d ng the “system
4890: e2 80 9d 20 74 65 73 74 20 69 66 20 74 68 65 20 ” test if the
48a0: e2 80 9c 63 70 75 e2 80 9d 20 61 6e 64 20 e2 80 “cpu” and
48b0: 9c 6d 65 6d e2 80 9d 20 74 65 73 74 73 20 65 69 mem” tests ei
48c0: 74 68 65 72 20 64 6f 20 6e 6f 74 20 63 6f 6d 70 ther do not comp
48d0: 6c 65 74 65 20 6f 72 20 63 6f 6d 70 6c 65 74 65 lete or complete
48e0: 20 62 75 74 20 77 69 74 68 20 73 74 61 74 75 73 but with status
48f0: 20 e2 80 9c 46 41 49 4c e2 80 9d 2e 0a 3c 2f 64 “FAIL”..</d
4900: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 iv>.<div class="
4910: 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 Standard">.<div
4920: 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e class="listing">
4930: 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 .<pre class="lis
4940: 74 69 6e 67 22 3e 23 20 74 65 73 74 63 6f 6e 66 ting"># testconf
4950: 69 67 20 66 6f 72 20 74 68 65 20 22 73 79 73 74 ig for the "syst
4960: 65 6d 22 20 74 65 73 74 0a 5b 73 65 74 75 70 5d em" test.[setup]
4970: 0a 72 75 6e 73 63 72 69 70 74 20 6d 61 69 6e 2e .runscript main.
4980: 63 73 68 0a 77 61 69 74 6f 6e 20 63 70 75 20 6d csh.waiton cpu m
4990: 65 6d 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e em.</pre>.</div>
49a0: 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 ..</div>.<h2 cla
49b0: 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e ss="Subsection">
49c0: 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 .<a class="toc"
49d0: 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 name="toc-Subsec
49e0: 74 69 6f 6e 2d 36 2e 34 22 3e 36 2e 34 3c 2f 61 tion-6.4">6.4</a
49f0: 3e e2 80 83 52 6f 6c 6c 69 6e 67 20 75 70 20 4d > Rolling up M
4a00: 69 73 63 65 6c 6c 61 6e 65 6f 75 73 20 44 61 74 iscellaneous Dat
4a10: 61 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 a.</h2>.<div cla
4a20: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 55 ss="Standard">.U
4a30: 73 65 20 74 68 65 20 2d 6c 6f 61 64 2d 74 65 73 se the -load-tes
4a40: 74 2d 64 61 74 61 20 73 77 69 74 63 68 20 74 6f t-data switch to
4a50: 20 72 6f 6c 6c 20 75 70 20 61 72 62 69 74 72 61 roll up arbitra
4a60: 72 79 20 64 61 74 61 20 66 72 6f 6d 20 61 20 74 ry data from a t
4a70: 65 73 74 20 69 6e 74 6f 20 74 68 65 20 74 65 73 est into the tes
4a80: 74 5f 64 61 74 61 20 74 61 62 6c 65 2e 0a 3c 2f t_data table..</
4a90: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
4aa0: 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 "Standard">.<div
4ab0: 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 class="listing"
4ac0: 3e 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 >.<pre class="li
4ad0: 73 74 69 6e 67 22 3e 23 20 46 69 65 6c 64 73 20 sting"># Fields
4ae0: 61 72 65 3a 0a 23 20 63 61 74 65 67 6f 72 79 2c are:.# category,
4af0: 76 61 72 69 61 62 6c 65 2c 76 61 6c 75 65 2c 65 variable,value,e
4b00: 78 70 65 63 74 65 64 2c 74 6f 6c 2c 75 6e 69 74 xpected,tol,unit
4b10: 73 2c 63 6f 6d 6d 65 6e 74 2c 73 74 61 74 75 73 s,comment,status
4b20: 0a e2 80 8b 0a 24 4d 54 5f 4d 45 47 41 54 45 53 ..$MT_MEGATES
4b30: 54 20 2d 6c 6f 61 64 2d 74 65 73 74 2d 64 61 74 T -load-test-dat
4b40: 61 20 26 6c 74 3b 26 6c 74 3b 20 45 4f 46 0a 66 a << EOF.f
4b50: 6f 6f 2c 62 61 72 2c 31 2e 32 2c 31 2e 39 2c 26 oo,bar,1.2,1.9,&
4b60: 67 74 3b 0a 66 6f 6f 2c 72 61 62 2c 31 2e 30 65 gt;.foo,rab,1.0e
4b70: 39 2c 31 30 65 39 2c 31 65 39 0a 66 6f 6f 2c 62 9,10e9,1e9.foo,b
4b80: 6c 61 2c 31 2e 32 2c 31 2e 39 2c 26 6c 74 3b 0a la,1.2,1.9,<.
4b90: 66 6f 6f 2c 62 61 6c 2c 31 2e 32 2c 31 2e 32 2c foo,bal,1.2,1.2,
4ba0: 26 6c 74 3b 2c 2c 43 68 65 63 6b 20 66 6f 72 20 <,,Check for
4bb0: 6f 76 65 72 6c 6f 61 64 0a 66 6f 6f 2c 61 6c 62 overload.foo,alb
4bc0: 2c 31 2e 32 2c 31 2e 32 2c 26 6c 74 3b 3d 2c 41 ,1.2,1.2,<=,A
4bd0: 6d 70 73 2c 54 68 69 73 20 69 73 20 74 68 65 20 mps,This is the
4be0: 68 69 67 68 20 70 6f 77 65 72 20 63 69 72 63 75 high power circu
4bf0: 69 74 20 74 65 73 74 0a 66 6f 6f 2c 61 62 6c 2c it test.foo,abl,
4c00: 31 2e 32 2c 31 2e 33 2c 30 2e 31 0a 66 6f 6f 2c 1.2,1.3,0.1.foo,
4c10: 62 72 61 2c 31 2e 32 2c 70 61 73 73 2c 73 69 6c bra,1.2,pass,sil
4c20: 6c 79 20 73 74 75 66 66 0a 66 61 7a 2c 62 61 72 ly stuff.faz,bar
4c30: 2c 31 30 2c 38 6d 41 2c 2c 2c 22 74 68 69 73 20 ,10,8mA,,,"this
4c40: 69 73 20 61 20 63 6f 6d 6d 65 6e 74 22 0a 45 4f is a comment".EO
4c50: 46 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a F.</pre>.</div>.
4c60: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
4c70: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 4e ss="Standard">.N
4c80: 65 77 20 65 6e 74 72 69 65 73 20 61 72 65 20 6b ew entries are k
4c90: 65 79 65 64 20 6f 6e 20 74 68 65 20 63 61 74 65 eyed on the cate
4ca0: 67 6f 72 79 20 61 6e 64 20 76 61 72 69 61 62 6c gory and variabl
4cb0: 65 2e 20 49 66 20 61 20 6e 65 77 20 72 65 63 6f e. If a new reco
4cc0: 72 64 20 69 73 20 69 6e 73 65 72 74 65 64 20 77 rd is inserted w
4cd0: 69 74 68 20 61 20 63 61 74 65 67 6f 72 79 20 61 ith a category a
4ce0: 6e 64 20 76 61 72 69 61 62 6c 65 20 74 68 61 74 nd variable that
4cf0: 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 62 65 have already be
4d00: 65 6e 20 75 73 65 64 20 74 68 65 20 6e 65 77 20 en used the new
4d10: 72 65 63 6f 72 64 20 77 69 6c 6c 20 72 65 70 6c record will repl
4d20: 61 63 65 20 74 68 65 20 6f 6c 64 20 72 65 63 6f ace the old reco
4d30: 72 64 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 rd..</div>.<div
4d40: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
4d50: 3e 0a 57 68 65 72 65 20 76 61 6c 75 65 2c 20 65 >.Where value, e
4d60: 78 70 65 63 74 65 64 20 61 6e 64 20 74 6f 6c 20 xpected and tol
4d70: 61 72 65 20 73 70 65 63 69 66 69 65 64 20 74 68 are specified th
4d80: 65 20 62 65 68 61 76 69 6f 72 20 69 73 20 61 73 e behavior is as
4d90: 20 66 6f 6c 6c 6f 77 73 2e 0a 3c 2f 64 69 76 3e follows..</div>
4da0: 0a 3c 75 6c 3e 0a 3c 6c 69 3e 0a 49 66 20 76 61 .<ul>.<li>.If va
4db0: 6c 75 65 2c 20 65 78 70 65 63 74 65 64 20 61 6e lue, expected an
4dc0: 64 20 74 6f 6c 20 61 72 65 20 6e 75 6d 62 65 72 d tol are number
4dd0: 73 20 74 68 65 6e 20 73 74 61 74 75 73 20 69 73 s then status is
4de0: 20 63 61 6c 63 75 6c 61 74 65 64 20 61 73 20 50 calculated as P
4df0: 41 53 53 20 69 66 20 28 65 78 70 65 63 74 65 64 ASS if (expected
4e00: 2d 74 6f 6c 29 20 26 6c 74 3b 3d 20 76 61 6c 75 -tol) <= valu
4e10: 65 20 26 6c 74 3b 3d 20 28 65 78 70 65 63 74 65 e <= (expecte
4e20: 64 2b 74 6f 6c 29 0a 3c 2f 6c 69 3e 0a 3c 6c 69 d+tol).</li>.<li
4e30: 3e 0a 49 66 20 76 61 6c 75 65 20 61 6e 64 20 65 >.If value and e
4e40: 78 70 65 63 74 65 64 20 61 72 65 20 6e 75 6d 62 xpected are numb
4e50: 65 72 73 20 61 6e 64 20 74 6f 6c 20 69 73 20 26 ers and tol is &
4e60: 67 74 3b 2c 20 26 6c 74 3b 2c 20 26 67 74 3b 3d gt;, <, >=
4e70: 20 6f 72 20 26 6c 74 3b 3d 20 74 68 65 6e 20 76 or <= then v
4e80: 61 6c 75 65 20 69 73 20 63 6f 6d 70 61 72 65 64 alue is compared
4e90: 20 77 69 74 68 20 65 78 70 65 63 74 65 64 20 75 with expected u
4ea0: 73 69 6e 67 20 74 68 65 20 6f 70 65 72 61 74 6f sing the operato
4eb0: 72 20 67 69 76 65 6e 20 62 79 20 74 6f 6c 0a 3c r given by tol.<
4ec0: 2f 6c 69 3e 0a 3c 6c 69 3e 0a 49 66 20 73 74 61 /li>.<li>.If sta
4ed0: 74 75 73 20 69 73 20 73 70 65 63 69 66 69 65 64 tus is specified
4ee0: 20 69 74 73 20 76 61 6c 75 65 20 6f 76 65 72 72 its value overr
4ef0: 69 64 65 73 20 74 68 65 20 61 62 6f 76 65 20 63 ides the above c
4f00: 61 6c 63 75 6c 61 74 69 6f 6e 73 2e 0a 3c 2f 6c alculations..</l
4f10: 69 3e 0a 0a 3c 2f 75 6c 3e 0a 3c 68 32 20 63 6c i>..</ul>.<h2 cl
4f20: 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 ass="Subsection"
4f30: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 >.<a class="toc"
4f40: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 name="toc-Subse
4f50: 63 74 69 6f 6e 2d 36 2e 35 22 3e 36 2e 35 3c 2f ction-6.5">6.5</
4f60: 61 3e e2 80 83 52 6f 6c 6c 69 6e 67 20 75 70 20 a> Rolling up
4f70: 52 75 6e 73 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 Runs.</h2>.<div
4f80: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
4f90: 3e 0a 54 6f 20 72 6f 6c 6c 20 75 70 20 61 20 6e >.To roll up a n
4fa0: 75 6d 62 65 72 20 6f 66 20 74 65 73 74 73 20 69 umber of tests i
4fb0: 6e 20 61 20 73 65 71 75 65 6e 63 65 20 6f 66 20 n a sequence of
4fc0: 72 75 6e 73 20 74 6f 20 61 20 73 69 6e 67 6c 65 runs to a single
4fd0: 20 72 75 6e 20 75 73 65 20 74 68 65 20 2d 72 6f run use the -ro
4fe0: 6c 6c 75 70 20 63 6f 6d 6d 61 6e 64 2e 20 0a 3c llup command. .<
4ff0: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
5000: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 ="Standard">.<di
5010: 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 v class="listing
5020: 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c ">.<pre class="l
5030: 69 73 74 69 6e 67 22 3e 6d 65 67 61 74 65 73 74 isting">megatest
5040: 20 2d 72 6f 6c 6c 75 70 20 3a 73 79 73 6e 61 6d -rollup :sysnam
5050: 65 20 75 62 75 6e 74 75 20 3a 66 73 6e 61 6d 65 e ubuntu :fsname
5060: 20 6e 66 73 20 3a 64 61 74 61 70 61 74 68 20 6e nfs :datapath n
5070: 6f 6e 65 20 3a 72 75 6e 6e 61 6d 65 20 72 6f 6c one :runname rol
5080: 6c 75 70 5f 77 77 33 38 0a 3c 2f 70 72 65 3e 0a lup_ww38.</pre>.
5090: 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c </div>..</div>.<
50a0: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
50b0: 61 72 64 22 3e 0a 41 6c 6c 20 6b 65 79 73 20 6d ard">.All keys m
50c0: 75 73 74 20 62 65 20 73 70 65 63 69 66 69 65 64 ust be specified
50d0: 20 61 6e 64 20 74 68 65 20 72 75 6e 6e 61 6d 65 and the runname
50e0: 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 is the name of
50f0: 74 68 65 20 72 75 6e 20 74 68 61 74 20 77 69 6c the run that wil
5100: 6c 20 62 65 20 63 72 65 61 74 65 64 2e 20 41 6c l be created. Al
5110: 6c 20 70 61 74 68 73 20 61 72 65 20 6b 65 70 74 l paths are kept
5120: 20 6f 72 69 67 69 6e 61 6c 20 69 6e 73 69 64 65 original inside
5130: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 57 the database. W
5140: 68 65 6e 20 2d 72 65 6d 6f 76 65 2d 72 75 6e 73 hen -remove-runs
5150: 20 69 73 20 75 73 65 64 20 74 6f 20 64 65 6c 65 is used to dele
5160: 74 65 20 72 75 6e 73 20 74 68 65 20 64 61 74 61 te runs the data
5170: 20 69 73 20 6e 6f 74 20 64 65 6c 65 74 65 64 20 is not deleted
5180: 69 66 20 74 68 65 72 65 20 61 72 65 20 72 6f 6c if there are rol
5190: 6c 75 70 73 20 74 68 61 74 20 72 65 66 65 72 20 lups that refer
51a0: 74 6f 20 74 68 65 20 64 61 74 61 2e 20 0a 3c 2f to the data. .</
51b0: 64 69 76 3e 0a 3c 68 31 20 63 6c 61 73 73 3d 22 div>.<h1 class="
51c0: 53 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 Section">.<a cla
51d0: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
51e0: 6f 63 2d 53 65 63 74 69 6f 6e 2d 37 22 3e 37 3c oc-Section-7">7<
51f0: 2f 61 3e e2 80 83 44 61 73 68 62 6f 61 72 64 0a /a> Dashboard.
5200: 3c 2f 68 31 3e 0a 3c 64 69 76 20 63 6c 61 73 73 </h1>.<div class
5210: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 ="Standard">.<di
5220: 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 v class="listing
5230: 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c ">.<pre class="l
5240: 69 73 74 69 6e 67 22 3e 26 67 74 3b 20 64 61 73 isting">> das
5250: 68 62 6f 61 72 64 20 26 61 6d 70 3b 0a 3c 2f 70 hboard &.</p
5260: 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 re>.</div>..</di
5270: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 v>.<div class="S
5280: 74 61 6e 64 61 72 64 22 3e 0a 3c 69 6d 67 20 63 tandard">.<img c
5290: 6c 61 73 73 3d 22 65 6d 62 65 64 64 65 64 22 20 lass="embedded"
52a0: 73 72 63 3d 22 64 61 73 68 62 6f 61 72 64 2e 70 src="dashboard.p
52b0: 6e 67 22 20 61 6c 74 3d 22 66 69 67 75 72 65 20 ng" alt="figure
52c0: 64 61 73 68 62 6f 61 72 64 2e 70 6e 67 22 20 73 dashboard.png" s
52d0: 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 37 33 30 tyle="width: 730
52e0: 70 78 3b 20 6d 61 78 2d 77 69 64 74 68 3a 20 39 px; max-width: 9
52f0: 31 33 70 78 3b 20 68 65 69 67 68 74 3a 20 36 32 13px; height: 62
5300: 36 70 78 3b 20 6d 61 78 2d 68 65 69 67 68 74 3a 6px; max-height:
5310: 20 37 38 33 70 78 3b 20 22 2f 3e 0a 0a 3c 2f 64 783px; "/>..</d
5320: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 iv>.<div class="
5330: 53 74 61 6e 64 61 72 64 22 3e 0a 50 75 73 68 69 Standard">.Pushi
5340: 6e 67 20 6f 6e 65 20 6f 66 20 74 68 65 20 62 75 ng one of the bu
5350: 74 74 6f 6e 73 20 6f 6e 20 74 68 65 20 6d 61 69 ttons on the mai
5360: 6e 20 64 61 73 68 62 6f 61 72 64 20 77 69 6c 6c n dashboard will
5370: 20 62 72 69 6e 67 20 75 70 20 74 68 65 20 74 65 bring up the te
5380: 73 74 20 73 70 65 63 69 66 69 63 20 64 61 73 68 st specific dash
5390: 62 6f 61 72 64 2e 20 56 61 6c 75 65 73 20 61 72 board. Values ar
53a0: 65 20 75 70 64 61 74 65 64 20 69 6e 20 73 65 6d e updated in sem
53b0: 69 2d 72 65 61 6c 20 74 69 6d 65 20 61 73 20 74 i-real time as t
53c0: 68 65 20 74 65 73 74 20 72 75 6e 73 2e 0a 3c 2f he test runs..</
53d0: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
53e0: 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 69 6d 67 "Standard">.<img
53f0: 20 63 6c 61 73 73 3d 22 65 6d 62 65 64 64 65 64 class="embedded
5400: 22 20 73 72 63 3d 22 64 61 73 68 62 6f 61 72 64 " src="dashboard
5410: 2d 74 65 73 74 2e 70 6e 67 22 20 61 6c 74 3d 22 -test.png" alt="
5420: 66 69 67 75 72 65 20 64 61 73 68 62 6f 61 72 64 figure dashboard
5430: 2d 74 65 73 74 2e 70 6e 67 22 20 73 74 79 6c 65 -test.png" style
5440: 3d 22 77 69 64 74 68 3a 20 36 34 33 70 78 3b 20 ="width: 643px;
5450: 6d 61 78 2d 77 69 64 74 68 3a 20 38 30 34 70 78 max-width: 804px
5460: 3b 20 68 65 69 67 68 74 3a 20 35 37 31 70 78 3b ; height: 571px;
5470: 20 6d 61 78 2d 68 65 69 67 68 74 3a 20 37 31 34 max-height: 714
5480: 70 78 3b 20 22 2f 3e 0a 0a 3c 2f 64 69 76 3e 0a px; "/>..</div>.
5490: 3c 68 31 20 63 6c 61 73 73 3d 22 53 65 63 74 69 <h1 class="Secti
54a0: 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 on">.<a class="t
54b0: 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 65 oc" name="toc-Se
54c0: 63 74 69 6f 6e 2d 38 22 3e 38 3c 2f 61 3e e2 80 ction-8">8</a>
54d0: 83 47 65 6e 65 72 61 74 69 6e 67 20 61 6e 20 4f Generating an O
54e0: 70 65 6e 44 6f 63 75 6d 65 6e 74 20 53 70 72 65 penDocument Spre
54f0: 61 64 73 68 65 65 74 20 66 72 6f 6d 20 74 68 65 adsheet from the
5500: 20 44 61 74 61 62 61 73 65 0a 3c 2f 68 31 3e 0a Database.</h1>.
5510: 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e <div class="Stan
5520: 64 61 72 64 22 3e 0a 41 6e 64 20 4f 70 65 6e 44 dard">.And OpenD
5530: 6f 63 75 6d 65 6e 74 20 6d 75 6c 74 69 2d 70 61 ocument multi-pa
5540: 6e 65 64 20 73 70 72 65 61 64 73 68 65 65 74 20 ned spreadsheet
5550: 63 61 6e 20 62 65 20 67 65 6e 65 72 61 74 65 64 can be generated
5560: 20 66 72 6f 6d 20 74 68 65 20 6d 65 67 61 74 65 from the megate
5570: 73 74 2e 64 62 20 66 69 6c 65 20 62 79 20 72 75 st.db file by ru
5580: 6e 6e 69 6e 67 20 2d 65 78 74 72 61 63 74 2d 6f nning -extract-o
5590: 64 73 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 ds.</div>.<div c
55a0: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
55b0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 .<div class="lis
55c0: 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 ting">.<pre clas
55d0: 73 3d 22 6c 69 73 74 69 6e 67 22 3e 6d 65 67 61 s="listing">mega
55e0: 74 65 73 74 20 2d 65 78 74 72 61 63 74 2d 6f 64 test -extract-od
55f0: 73 20 72 65 73 75 6c 74 73 2e 6f 64 73 20 3a 72 s results.ods :r
5600: 75 6e 6e 61 6d 65 20 25 20 0a 3c 2f 70 72 65 3e unname % .</pre>
5610: 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a .</div>..</div>.
5620: 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e <div class="Stan
5630: 64 61 72 64 22 3e 0a 59 6f 75 20 63 61 6e 20 6f dard">.You can o
5640: 70 74 69 6f 6e 61 6c 6c 79 20 73 70 65 63 69 66 ptionally specif
5650: 79 20 74 68 65 20 6b 65 79 73 20 66 6f 72 20 79 y the keys for y
5660: 6f 75 72 20 64 61 74 61 62 61 73 65 20 74 6f 20 our database to
5670: 6c 69 6d 69 74 20 66 75 72 74 68 65 72 20 74 68 limit further th
5680: 65 20 72 75 6e 73 20 74 6f 20 65 78 74 72 61 63 e runs to extrac
5690: 74 20 69 6e 74 6f 20 74 68 65 20 73 70 72 65 61 t into the sprea
56a0: 64 73 68 65 65 74 2e 20 54 68 65 20 66 69 72 73 dsheet. The firs
56b0: 74 20 73 68 65 65 74 20 63 6f 6e 74 61 69 6e 73 t sheet contains
56c0: 20 61 6c 6c 20 74 68 65 20 72 75 6e 20 64 61 74 all the run dat
56d0: 61 20 61 6e 64 20 73 75 62 73 65 71 75 65 6e 74 a and subsequent
56e0: 20 73 68 65 65 74 73 20 63 6f 6e 74 61 69 6e 20 sheets contain
56f0: 64 61 74 61 20 72 6f 6c 6c 65 64 20 75 70 20 66 data rolled up f
5700: 6f 72 20 74 68 65 20 69 6e 64 69 76 69 64 75 61 or the individua
5710: 6c 20 74 65 73 74 73 2e 0a 3c 2f 64 69 76 3e 0a l tests..</div>.
5720: 3c 68 31 20 63 6c 61 73 73 3d 22 53 65 63 74 69 <h1 class="Secti
5730: 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 on">.<a class="t
5740: 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 65 oc" name="toc-Se
5750: 63 74 69 6f 6e 2d 39 22 3e 39 3c 2f 61 3e e2 80 ction-9">9</a>
5760: 83 52 65 66 65 72 65 6e 63 65 0a 3c 2f 68 31 3e Reference.</h1>
5770: 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 73 .<h2 class="Subs
5780: 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 ection">.<a clas
5790: 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f s="toc" name="to
57a0: 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 39 2e 31 c-Subsection-9.1
57b0: 22 3e 39 2e 31 3c 2f 61 3e e2 80 83 43 6f 6e 66 ">9.1</a> Conf
57c0: 69 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 20 53 iguration file S
57d0: 79 6e 74 61 78 0a 3c 2f 68 32 3e 0a 3c 68 33 20 yntax.</h2>.<h3
57e0: 63 6c 61 73 73 3d 22 53 75 62 73 75 62 73 65 63 class="Subsubsec
57f0: 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d tion">.<a class=
5800: 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d "toc" name="toc-
5810: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 39 2e Subsubsection-9.
5820: 31 2e 31 22 3e 39 2e 31 2e 31 3c 2f 61 3e e2 80 1.1">9.1.1</a>
5830: 83 53 65 63 74 69 6f 6e 73 0a 3c 2f 68 33 3e 0a Sections.</h3>.
5840: 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e <div class="Stan
5850: 64 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 dard">.<div clas
5860: 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 s="listing">.<pr
5870: 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 e class="listing
5880: 22 3e 5b 73 65 63 74 69 6f 6e 20 6e 61 6d 65 5d ">[section name]
5890: 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a .</pre>.</div>..
58a0: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 </div>.<div clas
58b0: 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 54 68 s="Standard">.Th
58c0: 69 73 20 63 72 65 61 74 65 73 20 61 20 73 65 63 is creates a sec
58d0: 74 69 6f 6e 20 6e 61 6d 65 64 20 e2 80 9c 73 65 tion named “se
58e0: 63 74 69 6f 6e 20 6e 61 6d 65 e2 80 9d 0a 3c 2f ction name”.</
58f0: 64 69 76 3e 0a 3c 68 33 20 63 6c 61 73 73 3d 22 div>.<h3 class="
5900: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 22 3e 0a Subsubsection">.
5910: 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e <a class="toc" n
5920: 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 75 62 73 ame="toc-Subsubs
5930: 65 63 74 69 6f 6e 2d 39 2e 31 2e 32 22 3e 39 2e ection-9.1.2">9.
5940: 31 2e 32 3c 2f 61 3e e2 80 83 56 61 72 69 61 62 1.2</a> Variab
5950: 6c 65 73 0a 3c 2f 68 33 3e 0a 3c 64 69 76 20 63 les.</h3>.<div c
5960: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
5970: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 .<div class="lis
5980: 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 ting">.<pre clas
5990: 73 3d 22 6c 69 73 74 69 6e 67 22 3e 56 41 52 58 s="listing">VARX
59a0: 20 68 61 73 20 74 68 69 73 20 76 61 6c 75 65 0a has this value.
59b0: 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c </pre>.</div>..<
59c0: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
59d0: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 54 68 65 ="Standard">.The
59e0: 20 76 61 72 69 61 62 6c 65 20 e2 80 9c 56 41 52 variable “VAR
59f0: 58 e2 80 9d 20 77 69 6c 6c 20 68 61 76 65 20 74 X” will have t
5a00: 68 65 20 76 61 6c 75 65 20 e2 80 9c 68 61 73 20 he value “has
5a10: 74 68 69 73 20 76 61 6c 75 65 e2 80 9d 0a 3c 2f this value”.</
5a20: 64 69 76 3e 0a 3c 68 33 20 63 6c 61 73 73 3d 22 div>.<h3 class="
5a30: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 22 3e 0a Subsubsection">.
5a40: 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e <a class="toc" n
5a50: 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 75 62 73 ame="toc-Subsubs
5a60: 65 63 74 69 6f 6e 2d 39 2e 31 2e 33 22 3e 39 2e ection-9.1.3">9.
5a70: 31 2e 33 3c 2f 61 3e e2 80 83 49 6e 63 6c 75 64 1.3</a> Includ
5a80: 65 73 0a 3c 2f 68 33 3e 0a 3c 64 69 76 20 63 6c es.</h3>.<div cl
5a90: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
5aa0: 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 <div class="list
5ab0: 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 ing">.<pre class
5ac0: 3d 22 6c 69 73 74 69 6e 67 22 3e 5b 69 6e 63 6c ="listing">[incl
5ad0: 75 64 65 20 66 69 6c 65 6e 61 6d 65 5d 0a 3c 2f ude filename].</
5ae0: 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 pre>.</div>..</d
5af0: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 iv>.<div class="
5b00: 53 74 61 6e 64 61 72 64 22 3e 0a 54 68 65 20 66 Standard">.The f
5b10: 69 6c 65 20 6e 61 6d 65 64 20 e2 80 9c 66 69 6c ile named “fil
5b20: 65 6e 61 6d 65 e2 80 9d 20 77 69 6c 6c 20 62 65 ename” will be
5b30: 20 69 6e 63 6c 75 64 65 64 20 61 73 20 69 66 20 included as if
5b40: 70 61 72 74 20 6f 66 20 74 68 65 20 63 61 6c 6c part of the call
5b50: 69 6e 67 20 66 69 6c 65 2e 20 4e 4f 54 45 3a 20 ing file. NOTE:
5b60: 54 68 69 73 20 6d 65 61 6e 73 20 6e 6f 20 73 65 This means no se
5b70: 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 6e 61 6d ction can be nam
5b80: 65 64 20 e2 80 9c 69 6e 63 6c 75 64 65 20 e2 80 ed “include
5b90: 9c 20 28 77 69 74 68 20 74 68 65 20 77 68 69 74 (with the whit
5ba0: 65 73 70 61 63 65 29 2e 0a 3c 2f 64 69 76 3e 0a espace)..</div>.
5bb0: 3c 68 33 20 63 6c 61 73 73 3d 22 53 75 62 73 75 <h3 class="Subsu
5bc0: 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c bsection">.<a cl
5bd0: 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 ass="toc" name="
5be0: 74 6f 63 2d 53 75 62 73 75 62 73 65 63 74 69 6f toc-Subsubsectio
5bf0: 6e 2d 39 2e 31 2e 34 22 3e 39 2e 31 2e 34 3c 2f n-9.1.4">9.1.4</
5c00: 61 3e e2 80 83 53 65 74 74 69 6e 67 20 61 20 76 a> Setting a v
5c10: 61 72 69 61 62 6c 65 20 62 79 20 72 75 6e 6e 69 ariable by runni
5c20: 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 0a 3c 2f 68 ng a command.</h
5c30: 33 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 3>.<div class="S
5c40: 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 63 tandard">.<div c
5c50: 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a lass="listing">.
5c60: 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 <pre class="list
5c70: 69 6e 67 22 3e 56 41 52 4e 41 4d 45 20 5b 73 79 ing">VARNAME [sy
5c80: 73 74 65 6d 20 6c 73 20 2f 74 6d 70 5d 0a 3c 2f stem ls /tmp].</
5c90: 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 pre>.</div>..</d
5ca0: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 iv>.<div class="
5cb0: 53 74 61 6e 64 61 72 64 22 3e 0a 54 68 65 20 76 Standard">.The v
5cc0: 61 72 69 61 62 6c 65 20 e2 80 9c 56 41 52 4e 41 ariable “VARNA
5cd0: 4d 45 e2 80 9d 20 77 69 6c 6c 20 67 65 74 20 61 ME” will get a
5ce0: 20 76 61 6c 75 65 20 63 72 65 61 74 65 64 20 62 value created b
5cf0: 79 20 74 68 65 20 55 6e 69 78 20 63 6f 6d 6d 61 y the Unix comma
5d00: 6e 64 20 e2 80 9c 6c 73 20 2f 74 6d 70 e2 80 9d nd “ls /tmp”
5d10: 2e 20 41 6c 6c 20 6c 69 6e 65 73 20 6f 66 20 6f . All lines of o
5d20: 75 74 70 75 74 20 66 72 6f 6d 20 74 68 65 20 63 utput from the c
5d30: 6f 6d 6d 61 6e 64 20 77 69 6c 6c 20 62 65 20 6a ommand will be j
5d40: 6f 69 6e 65 64 20 77 69 74 68 20 61 20 73 70 61 oined with a spa
5d50: 63 65 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 33 20 63 ce..</div>.<h3 c
5d60: 6c 61 73 73 3d 22 53 75 62 73 75 62 73 65 63 74 lass="Subsubsect
5d70: 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 ion">.<a class="
5d80: 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 toc" name="toc-S
5d90: 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 39 2e 31 ubsubsection-9.1
5da0: 2e 35 22 3e 39 2e 31 2e 35 3c 2f 61 3e e2 80 83 .5">9.1.5</a>
5db0: 4e 6f 74 65 73 0a 3c 2f 68 33 3e 0a 3c 75 6c 3e Notes.</h3>.<ul>
5dc0: 0a 3c 6c 69 3e 0a 53 6f 6d 65 20 76 61 72 69 61 .<li>.Some varia
5dd0: 62 6c 65 73 20 61 72 65 20 69 6e 66 65 72 65 64 bles are infered
5de0: 20 61 73 20 6c 69 73 74 73 2e 20 45 61 63 68 20 as lists. Each
5df0: 74 6f 6b 65 6e 20 6f 6e 20 74 68 65 20 6c 69 6e token on the lin
5e00: 65 20 73 65 70 61 72 61 74 65 64 20 62 79 20 77 e separated by w
5e10: 68 69 74 65 73 70 61 63 65 20 77 69 6c 6c 20 62 hitespace will b
5e20: 65 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 20 e member of the
5e30: 6c 69 73 74 2e 0a 3c 2f 6c 69 3e 0a 3c 6c 69 3e list..</li>.<li>
5e40: 0a 43 6f 6d 6d 65 6e 74 73 20 28 6c 69 6e 65 73 .Comments (lines
5e50: 20 73 74 61 72 74 69 6e 67 20 77 69 74 68 20 23 starting with #
5e60: 29 20 61 6e 64 20 62 6c 61 6e 6b 20 6c 69 6e 65 ) and blank line
5e70: 73 20 61 72 65 20 69 67 6e 6f 72 65 64 2e 0a 3c s are ignored..<
5e80: 2f 6c 69 3e 0a 0a 3c 2f 75 6c 3e 0a 3c 68 32 20 /li>..</ul>.<h2
5e90: 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f class="Subsectio
5ea0: 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f n">.<a class="to
5eb0: 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 c" name="toc-Sub
5ec0: 73 65 63 74 69 6f 6e 2d 39 2e 32 22 3e 39 2e 32 section-9.2">9.2
5ed0: 3c 2f 61 3e e2 80 83 45 6e 76 69 72 6f 6e 6d 65 </a> Environme
5ee0: 6e 74 20 76 61 72 69 61 62 6c 65 73 0a 3c 2f 68 nt variables.</h
5ef0: 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 2>.<div class="S
5f00: 74 61 6e 64 61 72 64 22 3e 0a 3c 74 61 62 6c 65 tandard">.<table
5f10: 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e >.<tr>.<td align
5f20: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
5f30: 74 6f 70 22 3e 0a 56 61 72 69 61 62 6c 65 0a 3c top">.Variable.<
5f40: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
5f50: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
5f60: 70 22 3e 0a 50 75 72 70 6f 73 65 0a 3c 2f 74 64 p">.Purpose.</td
5f70: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
5f80: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
5f90: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 4d 54 5f align="top">.MT_
5fa0: 43 4d 44 49 4e 46 4f 0a 3c 2f 74 64 3e 0a 3c 74 CMDINFO.</td>.<t
5fb0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
5fc0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 43 6f 6e align="top">.Con
5fd0: 76 65 79 73 20 74 65 73 74 20 76 61 72 69 61 62 veys test variab
5fe0: 6c 65 73 20 74 6f 20 74 68 65 20 6d 65 67 61 74 les to the megat
5ff0: 65 73 74 20 74 65 73 74 20 72 75 6e 6e 65 72 2e est test runner.
6000: 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 .</td>..</tr>.<t
6010: 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 r>.<td align="le
6020: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
6030: 3e 0a 4d 54 5f 54 45 53 54 5f 52 55 4e 5f 44 49 >.MT_TEST_RUN_DI
6040: 52 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 R.</td>.<td alig
6050: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
6060: 22 74 6f 70 22 3e 0a 44 69 72 65 63 74 6f 72 79 "top">.Directory
6070: 20 61 73 73 69 67 6e 65 64 20 62 79 20 6d 65 67 assigned by meg
6080: 61 74 65 73 74 20 66 6f 72 20 74 68 65 20 74 65 atest for the te
6090: 73 74 20 74 6f 20 72 75 6e 2e 0a 3c 2f 74 64 3e st to run..</td>
60a0: 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 ..</tr>.<tr>.<td
60b0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
60c0: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 4d 54 5f 54 lign="top">.MT_T
60d0: 45 53 54 5f 4e 41 4d 45 0a 3c 2f 74 64 3e 0a 3c EST_NAME.</td>.<
60e0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
60f0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 4e 61 valign="top">.Na
6100: 6d 65 20 6f 66 20 74 68 65 20 74 65 73 74 2c 20 me of the test,
6110: 63 6f 72 72 6f 73 70 6f 6e 64 73 20 74 6f 20 74 corrosponds to t
6120: 68 65 20 64 69 72 65 63 74 6f 72 79 20 6e 61 6d he directory nam
6130: 65 20 75 6e 64 65 72 20 74 65 73 74 73 2e 0a 3c e under tests..<
6140: 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e /td>..</tr>.<tr>
6150: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6160: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
6170: 4d 54 5f 49 54 45 4d 5f 49 4e 46 4f 0a 3c 2f 74 MT_ITEM_INFO.</t
6180: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
6190: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
61a0: 3e 0a 49 74 65 72 61 74 65 64 20 74 65 73 74 73 >.Iterated tests
61b0: 20 77 69 6c 6c 20 73 65 74 20 74 68 69 73 20 74 will set this t
61c0: 6f 20 61 20 73 65 71 75 65 6e 63 65 20 6f 66 20 o a sequence of
61d0: 6b 65 79 2f 76 61 6c 75 65 73 20 28 28 4b 45 59 key/values ((KEY
61e0: 20 76 61 6c 29 20 2e 2e 2e 29 20 0a 3c 2f 74 64 val) ...) .</td
61f0: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
6200: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
6210: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 4d 54 5f align="top">.MT_
6220: 52 55 4e 5f 41 52 45 41 5f 48 4f 4d 45 0a 3c 2f RUN_AREA_HOME.</
6230: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
6240: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
6250: 22 3e 0a 44 69 72 65 63 74 6f 72 79 20 77 68 65 ">.Directory whe
6260: 72 65 20 6d 65 67 61 74 65 73 74 20 77 61 73 20 re megatest was
6270: 6c 61 75 6e 63 68 65 64 20 66 72 6f 6d 20 61 6e launched from an
6280: 64 20 77 68 65 72 65 20 74 68 65 20 74 65 73 74 d where the test
6290: 73 20 63 6f 64 65 20 63 61 6e 20 62 65 20 66 6f s code can be fo
62a0: 75 6e 64 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e und.</td>..</tr>
62b0: 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d .<tr>.<td align=
62c0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
62d0: 6f 70 22 3e 0a 4d 54 5f 52 55 4e 4e 41 4d 45 0a op">.MT_RUNNAME.
62e0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
62f0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
6300: 6f 70 22 3e 0a 4e 61 6d 65 20 6f 66 20 74 68 69 op">.Name of thi
6310: 73 20 72 75 6e 20 61 73 20 73 65 74 20 62 79 20 s run as set by
6320: 74 68 65 20 3a 72 75 6e 6e 61 6d 65 20 70 61 72 the :runname par
6330: 61 6d 65 74 65 72 0a 3c 2f 74 64 3e 0a 0a 3c 2f ameter.</td>..</
6340: 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 tr>.<tr>.<td ali
6350: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
6360: 3d 22 74 6f 70 22 3e 0a 4d 54 5f 4d 45 47 41 54 ="top">.MT_MEGAT
6370: 45 53 54 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c EST.</td>.<td al
6380: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
6390: 6e 3d 22 74 6f 70 22 3e 0a 50 61 74 68 2f 46 69 n="top">.Path/Fi
63a0: 6c 65 6e 61 6d 65 20 74 6f 20 6d 65 67 61 74 65 lename to megate
63b0: 73 74 20 65 78 65 63 75 74 61 62 6c 65 2e 20 46 st executable. F
63c0: 6f 75 6e 64 20 65 69 74 68 65 72 20 66 72 6f 6d ound either from
63d0: 20 63 61 6c 6c 65 64 20 70 61 74 68 20 6f 72 20 called path or
63e0: 62 75 74 20 75 73 69 6e 67 20 74 68 65 20 e2 80 but using the
63f0: 9c 65 78 65 63 74 75 61 62 6c 65 e2 80 9d 20 6b exectuable” k
6400: 65 79 77 6f 72 64 20 69 6e 20 74 68 65 20 5b 73 eyword in the [s
6410: 65 74 75 70 5d 20 73 65 63 74 69 6f 6e 2e 0a 3c etup] section..<
6420: 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e /td>..</tr>.<tr>
6430: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6440: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
6450: 26 6c 74 3b 66 69 65 6c 64 31 26 67 74 3b 20 2e <field1> .
6460: 2e 2e 2e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c ....</td>.<td al
6470: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
6480: 6e 3d 22 74 6f 70 22 3e 0a 54 68 65 20 66 69 65 n="top">.The fie
6490: 6c 64 20 76 61 6c 75 65 73 20 61 73 20 73 65 74 ld values as set
64a0: 20 6f 6e 20 74 68 65 20 6d 65 67 61 74 65 73 74 on the megatest
64b0: 20 2d 72 75 6e 61 6c 6c 20 63 6f 6d 6d 61 6e 64 -runall command
64c0: 20 6c 69 6e 65 20 28 65 2e 67 2e 20 3a 66 69 65 line (e.g. :fie
64d0: 6c 64 31 20 61 62 63 29 0a 3c 2f 74 64 3e 0a 0a ld1 abc).</td>..
64e0: 3c 2f 74 72 3e 0a 0a 3c 2f 74 61 62 6c 65 3e 0a </tr>..</table>.
64f0: 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 73 .</div>.<h2 clas
6500: 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a s="Subsection">.
6510: 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e <a class="toc" n
6520: 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 ame="toc-Subsect
6530: 69 6f 6e 2d 39 2e 33 22 3e 39 2e 33 3c 2f 61 3e ion-9.3">9.3</a>
6540: e2 80 83 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 megatest.conf
6550: 69 67 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c ig.</h2>.<div cl
6560: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
6570: 3c 74 61 62 6c 65 3e 0a 3c 74 72 3e 0a 3c 74 64 <table>.<tr>.<td
6580: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
6590: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73 65 63 74 lign="top">.sect
65a0: 69 6f 6e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c ion.</td>.<td al
65b0: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
65c0: 6e 3d 22 74 6f 70 22 3e 0a 76 61 72 69 61 62 6c n="top">.variabl
65d0: 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 e.</td>.<td alig
65e0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
65f0: 22 74 6f 70 22 3e 0a 76 61 6c 75 65 0a 3c 2f 74 "top">.value.</t
6600: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
6610: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
6620: 3e 0a 72 65 71 75 69 72 65 64 0a 3c 2f 74 64 3e >.required.</td>
6630: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6640: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
6650: 63 6f 6d 6d 65 6e 74 0a 3c 2f 74 64 3e 0a 0a 3c comment.</td>..<
6660: 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c /tr>.<tr>.<td al
6670: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
6680: 6e 3d 22 74 6f 70 22 3e 0a 5b 73 65 74 75 70 5d n="top">.[setup]
6690: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
66a0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
66b0: 74 6f 70 22 3e 0a 6d 61 78 5f 63 6f 6e 63 75 72 top">.max_concur
66c0: 72 65 6e 74 5f 6a 6f 62 73 0a 3c 2f 74 64 3e 0a rent_jobs.</td>.
66d0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
66e0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 69 valign="top">.i
66f0: 66 20 76 61 72 69 61 62 6c 65 20 69 73 20 6e 6f f variable is no
6700: 74 20 64 65 66 69 6e 65 64 20 6e 6f 20 6c 69 6d t defined no lim
6710: 69 74 20 6f 6e 20 6a 6f 62 73 0a 3c 2f 74 64 3e it on jobs.</td>
6720: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6730: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
6740: 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 no.</td>.<td ali
6750: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
6760: 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a ="top">..</td>..
6770: 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 </tr>.<tr>.<td a
6780: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
6790: 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e gn="top">..</td>
67a0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
67b0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
67c0: 65 78 65 63 75 74 61 62 6c 65 0a 3c 2f 74 64 3e executable.</td>
67d0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
67e0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
67f0: 66 75 6c 6c 20 70 61 74 68 20 74 6f 20 6d 65 67 full path to meg
6800: 61 74 65 73 74 20 62 69 6e 61 72 79 0a 3c 2f 74 atest binary.</t
6810: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
6820: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
6830: 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 >.no.</td>.<td a
6840: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
6850: 67 6e 3d 22 74 6f 70 22 3e 0a 55 73 65 20 6f 6e gn="top">.Use on
6860: 6c 79 20 69 66 20 6e 65 63 65 73 73 61 72 79 2c ly if necessary,
6870: 20 6d 65 67 61 74 65 73 74 20 77 69 6c 6c 20 65 megatest will e
6880: 78 74 72 61 63 74 20 74 68 65 20 6c 6f 63 61 74 xtract the locat
6890: 69 6f 6e 20 66 72 6f 6d 20 77 68 65 72 65 20 69 ion from where i
68a0: 74 20 75 73 65 64 20 74 6f 20 6c 61 75 6e 63 68 t used to launch
68b0: 20 61 6e 64 20 61 64 64 20 61 70 70 65 6e 64 20 and add append
68c0: 74 68 61 74 20 74 6f 20 74 68 65 20 50 41 54 48 that to the PATH
68d0: 20 66 6f 72 20 74 65 73 74 20 72 75 6e 73 2e 0a for test runs..
68e0: 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 </td>..</tr>.<tr
68f0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
6900: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
6910: 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 ..</td>.<td alig
6920: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
6930: 22 74 6f 70 22 3e 0a 72 75 6e 73 64 69 72 0a 3c "top">.runsdir.<
6940: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
6950: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
6960: 70 22 3e 0a 66 75 6c 6c 20 70 61 74 68 20 74 6f p">.full path to
6970: 20 77 68 65 72 65 20 74 68 65 20 6c 69 6e 6b 20 where the link
6980: 74 72 65 65 20 74 6f 20 61 6c 6c 20 72 75 6e 73 tree to all runs
6990: 20 77 69 6c 6c 20 62 65 20 63 72 65 61 74 65 64 will be created
69a0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
69b0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
69c0: 74 6f 70 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c top">.no.</td>.<
69d0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
69e0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 42 65 valign="top">.Be
69f0: 63 61 75 73 65 20 79 6f 75 72 20 72 75 6e 73 20 cause your runs
6a00: 6d 61 79 20 62 65 20 73 70 72 65 61 64 20 6f 75 may be spread ou
6a10: 74 20 6f 76 65 72 20 73 65 76 65 72 61 6c 20 64 t over several d
6a20: 69 73 6b 20 70 61 72 74 69 74 69 6f 6e 73 20 61 isk partitions a
6a30: 20 63 65 6e 74 72 61 6c 20 6c 69 6e 6b 20 74 72 central link tr
6a40: 65 65 20 69 73 20 63 72 65 61 74 65 64 20 74 6f ee is created to
6a50: 20 6d 61 6b 65 20 66 69 6e 64 69 6e 67 20 61 6c make finding al
6a60: 6c 20 74 68 65 20 72 75 6e 73 20 65 61 73 79 2e l the runs easy.
6a70: 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 .</td>..</tr>.<t
6a80: 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 r>.<td align="le
6a90: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
6aa0: 3e 0a 5b 66 69 65 6c 64 73 5d 0a 3c 2f 74 64 3e >.[fields].</td>
6ab0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6ac0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
6ad0: 73 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 65 72 string of letter
6ae0: 73 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 75 s, numbers and u
6af0: 6e 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a nderscore.</td>.
6b00: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
6b10: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73 valign="top">.s
6b20: 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 65 72 73 tring of letters
6b30: 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 75 6e , numbers and un
6b40: 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a 3c derscore.</td>.<
6b50: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
6b60: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 61 74 valign="top">.at
6b70: 20 6c 65 61 73 74 20 6f 6e 65 0a 3c 2f 74 64 3e least one.</td>
6b80: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6b90: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
6ba0: 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 .</td>..</tr>.<t
6bb0: 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 r>.<td align="le
6bc0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
6bd0: 3e 0a 5b 6a 6f 62 74 6f 6f 6c 73 5d 0a 3c 2f 74 >.[jobtools].</t
6be0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
6bf0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
6c00: 3e 0a 6c 61 75 6e 63 68 65 72 0a 3c 2f 74 64 3e >.launcher.</td>
6c10: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6c20: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
6c30: 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 75 73 65 command line use
6c40: 64 20 74 6f 20 6c 61 75 6e 63 68 20 6a 6f 62 73 d to launch jobs
6c50: 20 2d 20 74 68 65 20 6a 6f 62 20 63 6f 6d 6d 61 - the job comma
6c60: 6e 64 20 28 6d 65 67 61 74 65 73 74 20 2d 65 78 nd (megatest -ex
6c70: 65 63 75 74 65 29 20 77 69 6c 6c 20 62 65 20 61 ecute) will be a
6c80: 70 70 65 6e 64 65 64 20 74 6f 20 74 68 69 73 0a ppended to this.
6c90: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
6ca0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
6cb0: 6f 70 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 op">.no.</td>.<t
6cc0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
6cd0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f align="top">..</
6ce0: 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a td>..</tr>.<tr>.
6cf0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
6d00: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a valign="top">..
6d10: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
6d20: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
6d30: 6f 70 22 3e 0a 77 6f 72 6b 68 6f 73 74 73 0a 3c op">.workhosts.<
6d40: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
6d50: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
6d60: 70 22 3e 0a 6c 69 73 74 20 6f 66 20 68 6f 73 74 p">.list of host
6d70: 6e 61 6d 65 73 20 74 6f 20 72 75 6e 20 6a 6f 62 names to run job
6d80: 73 20 6f 6e 20 4e 4f 54 20 53 55 50 50 4f 52 54 s on NOT SUPPORT
6d90: 45 44 20 52 49 47 48 54 20 4e 4f 57 0a 3c 2f 74 ED RIGHT NOW.</t
6da0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
6db0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
6dc0: 3e 0a 6e 2f 61 0a 3c 2f 74 64 3e 0a 3c 74 64 20 >.n/a.</td>.<td
6dd0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
6de0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 ign="top">..</td
6df0: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
6e00: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
6e10: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 5b 65 6e align="top">.[en
6e20: 76 2d 6f 76 65 72 72 69 64 65 5d 0a 3c 2f 74 64 v-override].</td
6e30: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
6e40: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
6e50: 0a 73 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 65 .string of lette
6e60: 72 73 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 rs, numbers and
6e70: 75 6e 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 3e underscore.</td>
6e80: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6e90: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
6ea0: 61 6e 79 20 73 74 72 69 6e 67 0a 3c 2f 74 64 3e any string.</td>
6eb0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6ec0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
6ed0: 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 no.</td>.<td ali
6ee0: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
6ef0: 3d 22 74 6f 70 22 3e 0a 54 68 65 73 65 20 61 72 ="top">.These ar
6f00: 65 20 73 65 74 20 6f 6e 20 74 68 65 20 74 65 73 e set on the tes
6f10: 74 20 6c 61 75 6e 63 68 69 6e 67 20 6d 61 63 68 t launching mach
6f20: 69 6e 65 2c 20 6e 6f 74 20 74 68 65 20 74 65 73 ine, not the tes
6f30: 74 20 72 75 6e 6e 69 6e 67 20 6d 61 63 68 69 6e t running machin
6f40: 65 2e 20 54 79 70 69 63 61 6c 20 75 73 61 67 65 e. Typical usage
6f50: 20 69 73 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 74 is to control t
6f60: 68 65 20 68 6f 73 74 20 6f 72 20 72 75 6e 20 71 he host or run q
6f70: 75 65 75 65 20 66 6f 72 20 6c 61 75 6e 63 68 69 ueue for launchi
6f80: 6e 67 20 74 65 73 74 73 2e 20 54 68 65 73 65 20 ng tests. These
6f90: 76 61 6c 75 65 73 20 77 69 6c 6c 20 6e 6f 74 20 values will not
6fa0: 62 65 20 73 65 65 6e 20 62 79 20 74 68 65 20 74 be seen by the t
6fb0: 65 73 74 20 77 68 65 6e 20 69 74 20 72 75 6e 73 est when it runs
6fc0: 2e 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c ..</td>..</tr>.<
6fd0: 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c tr>.<td align="l
6fe0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
6ff0: 22 3e 0a 5b 64 69 73 6b 73 5d 0a 3c 2f 74 64 3e ">.[disks].</td>
7000: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
7010: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
7020: 73 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 65 72 string of letter
7030: 73 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 75 s, numbers and u
7040: 6e 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a nderscore.</td>.
7050: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
7060: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 61 valign="top">.a
7070: 20 76 61 6c 69 64 20 70 61 74 68 20 77 72 69 74 valid path writ
7080: 61 62 6c 65 20 62 79 20 74 68 65 20 74 65 73 74 able by the test
7090: 20 6c 61 75 6e 63 68 69 6e 67 20 70 72 6f 63 65 launching proce
70a0: 73 73 20 61 6e 64 20 62 79 20 74 68 65 20 74 65 ss and by the te
70b0: 73 74 20 70 72 6f 63 65 73 73 0a 3c 2f 74 64 3e st process.</td>
70c0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
70d0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
70e0: 79 65 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c yes.</td>.<td al
70f0: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
7100: 6e 3d 22 74 6f 70 22 3e 0a 54 68 65 20 64 69 73 n="top">.The dis
7110: 6b 20 75 73 61 67 65 20 62 61 6c 61 6e 63 69 6e k usage balancin
7120: 67 20 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 74 g algorithm is t
7130: 6f 20 63 68 6f 6f 73 65 20 74 68 65 20 64 69 73 o choose the dis
7140: 6b 20 77 69 74 68 20 74 68 65 20 6c 65 61 73 74 k with the least
7150: 20 73 70 61 63 65 20 66 6f 72 20 65 61 63 68 20 space for each
7160: 74 65 73 74 20 72 75 6e 2e 20 0a 3c 2f 74 64 3e test run. .</td>
7170: 0a 0a 3c 2f 74 72 3e 0a 0a 3c 2f 74 61 62 6c 65 ..</tr>..</table
7180: 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c >..</div>.<h2 cl
7190: 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 ass="Subsection"
71a0: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 >.<a class="toc"
71b0: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 name="toc-Subse
71c0: 63 74 69 6f 6e 2d 39 2e 34 22 3e 39 2e 34 3c 2f ction-9.4">9.4</
71d0: 61 3e e2 80 83 72 75 6e 63 6f 6e 66 69 67 73 2e a> runconfigs.
71e0: 63 6f 6e 66 69 67 20 66 69 6c 65 0a 3c 2f 68 32 config file.</h2
71f0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
7200: 61 6e 64 61 72 64 22 3e 0a 3c 74 61 62 6c 65 3e andard">.<table>
7210: 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d .<tr>.<td align=
7220: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
7230: 6f 70 22 3e 0a 73 65 63 74 69 6f 6e 0a 3c 2f 74 op">.section.</t
7240: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
7250: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
7260: 3e 0a 76 61 72 69 61 62 6c 65 0a 3c 2f 74 64 3e >.variable.</td>
7270: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
7280: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
7290: 76 61 6c 75 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 value.</td>.<td
72a0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
72b0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 72 65 71 75 69 ign="top">.requi
72c0: 72 65 64 3f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 red?.</td>.<td a
72d0: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
72e0: 67 6e 3d 22 74 6f 70 22 3e 0a 63 6f 6d 6d 65 6e gn="top">.commen
72f0: 74 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c t.</td>..</tr>.<
7300: 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c tr>.<td align="l
7310: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
7320: 22 3e 0a 5b 64 65 66 61 75 6c 74 5d 0a 3c 2f 74 ">.[default].</t
7330: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
7340: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
7350: 3e 0a 73 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 >.string of lett
7360: 65 72 73 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 ers, numbers and
7370: 20 75 6e 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 underscore.</td
7380: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
7390: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
73a0: 0a 61 6e 79 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 .any.</td>.<td a
73b0: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
73c0: 67 6e 3d 22 74 6f 70 22 3e 0a 6e 6f 0a 3c 2f 74 gn="top">.no.</t
73d0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
73e0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
73f0: 3e 0a 76 61 72 69 61 62 6c 65 73 20 73 65 74 20 >.variables set
7400: 69 6e 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20 in this section
7410: 77 69 6c 6c 20 62 65 20 61 76 61 69 6c 61 62 6c will be availabl
7420: 65 20 66 6f 72 20 61 6c 6c 20 72 75 6e 73 2c 20 e for all runs,
7430: 64 65 66 69 6e 69 6e 67 20 74 68 65 20 73 61 6d defining the sam
7440: 65 20 76 61 72 69 61 62 6c 65 20 69 6e 20 61 6e e variable in an
7450: 6f 74 68 65 72 20 73 65 63 74 69 6f 6e 20 77 69 other section wi
7460: 6c 6c 20 6f 76 65 72 72 69 64 65 20 74 68 65 20 ll override the
7470: 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 64 value from the d
7480: 65 66 61 75 6c 74 20 73 65 63 74 69 6f 6e 0a 3c efault section.<
7490: 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e /td>..</tr>.<tr>
74a0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
74b0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
74c0: 5b 66 69 65 6c 64 31 76 61 6c 75 65 2f 66 69 65 [field1value/fie
74d0: 6c 64 32 76 61 6c 75 65 2e 2e 2e 5d 0a 3c 2f 74 ld2value...].</t
74e0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
74f0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
7500: 3e 0a 73 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 >.string of lett
7510: 65 72 73 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 ers, numbers and
7520: 20 75 6e 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 underscore.</td
7530: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
7540: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
7550: 0a 61 6e 79 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 .any.</td>.<td a
7560: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
7570: 67 6e 3d 22 74 6f 70 22 3e 0a 6e 6f 0a 3c 2f 74 gn="top">.no.</t
7580: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
7590: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
75a0: 3e 0a 74 68 65 20 76 61 6c 75 65 73 20 69 6e 20 >.the values in
75b0: 74 68 69 73 20 73 65 63 74 69 6f 6e 20 77 69 6c this section wil
75c0: 6c 20 62 65 20 73 65 74 20 66 6f 72 20 61 6e 79 l be set for any
75d0: 20 72 75 6e 20 77 68 65 72 65 20 66 69 65 6c 64 run where field
75e0: 31 20 69 73 20 66 69 65 6c 64 31 76 61 6c 75 65 1 is field1value
75f0: 2c 20 66 69 65 6c 64 32 20 69 73 20 66 69 65 6c , field2 is fiel
7600: 64 32 76 61 6c 75 65 20 61 6e 64 20 66 69 65 6c d2value and fiel
7610: 64 4e 20 69 73 20 66 69 65 6c 64 4e 76 61 6c 75 dN is fieldNvalu
7620: 65 2e 20 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e e. .</td>..</tr>
7630: 0a 0a 3c 2f 74 61 62 6c 65 3e 0a 0a 3c 2f 64 69 ..</table>..</di
7640: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 v>.<div class="S
7650: 74 61 6e 64 61 72 64 22 3e 0a 45 78 61 6d 70 6c tandard">.Exampl
7660: 65 3a 20 61 20 74 65 73 74 20 73 75 69 74 65 20 e: a test suite
7670: 74 68 61 74 20 63 68 65 63 6b 73 20 74 68 61 74 that checks that
7680: 20 61 20 70 69 65 63 65 20 6f 66 20 73 6f 66 74 a piece of soft
7690: 77 61 72 65 20 77 6f 72 6b 73 20 63 6f 72 72 65 ware works corre
76a0: 63 74 6c 79 20 66 6f 72 20 64 69 66 66 65 72 65 ctly for differe
76b0: 6e 74 20 63 75 73 74 6f 6d 65 72 20 63 6f 6e 66 nt customer conf
76c0: 69 67 75 72 61 74 69 6f 6e 73 20 61 6e 64 20 6c igurations and l
76d0: 6f 63 61 74 69 6f 6e 73 20 65 61 63 68 20 6f 66 ocations each of
76e0: 20 77 68 69 63 68 20 69 73 20 64 6f 6e 65 20 61 which is done a
76f0: 73 20 61 20 73 65 70 61 72 61 74 65 20 72 65 6c s a separate rel
7700: 65 61 73 65 20 72 65 67 72 65 73 73 69 6f 6e 20 ease regression
7710: 72 75 6e 2e 20 54 68 65 20 66 69 65 6c 64 73 2c run. The fields,
7720: 20 43 55 53 54 4f 4d 45 52 20 61 6e 64 20 4c 4f CUSTOMER and LO
7730: 43 41 54 49 4f 4e 20 77 65 72 65 20 63 68 6f 73 CATION were chos
7740: 65 6e 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e en. The followin
7750: 67 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e g runconfigs.con
7760: 66 69 67 20 66 69 6c 65 20 77 6f 75 6c 64 20 73 fig file would s
7770: 65 74 20 73 6f 6d 65 20 76 61 72 69 61 62 6c 65 et some variable
7780: 73 20 73 70 65 63 69 66 69 63 20 74 6f 20 72 75 s specific to ru
7790: 6e 73 20 66 6f 72 20 6d 65 67 61 63 6f 72 70 20 ns for megacorp
77a0: 69 6e 20 49 6e 64 69 61 20 61 6e 64 20 66 65 6d in India and fem
77b0: 74 6f 63 6f 72 70 20 69 6e 20 74 68 65 20 43 6f tocorp in the Co
77c0: 6f 6b 20 49 73 6c 61 6e 64 73 20 61 6e 64 20 4e ok Islands and N
77d0: 65 77 20 5a 65 61 6c 61 6e 64 3a 0a 3c 2f 64 69 ew Zealand:.</di
77e0: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 v>.<div class="S
77f0: 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 63 tandard">.<div c
7800: 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a lass="listing">.
7810: 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 <pre class="list
7820: 69 6e 67 22 3e 23 20 72 75 6e 63 6f 6e 66 69 67 ing"># runconfig
7830: 73 2e 63 6f 6e 66 69 67 0a 5b 64 65 66 61 75 6c s.config.[defaul
7840: 74 5d 0a 45 4e 43 52 59 54 49 4f 4e 20 74 72 75 t].ENCRYTION tru
7850: 65 0a e2 80 8b 0a 5b 6d 65 67 61 63 6f 72 70 2f e..[megacorp/
7860: 69 6e 64 69 61 5d 0a 54 45 53 54 50 41 54 48 20 india].TESTPATH
7870: 2f 6e 66 73 2f 74 65 73 74 69 6e 67 2f 6d 65 67 /nfs/testing/meg
7880: 61 63 6f 72 70 5f 72 75 6e 73 0a e2 80 8b 0a 5b acorp_runs..[
7890: 66 65 6d 74 6f 63 6f 72 70 2f 63 6f 6f 6b 5f 69 femtocorp/cook_i
78a0: 73 6c 61 6e 64 73 5d 0a 45 4e 43 52 59 54 49 4f slands].ENCRYTIO
78b0: 4e 20 66 61 6c 73 65 0a 54 45 53 54 50 41 54 48 N false.TESTPATH
78c0: 20 2f 61 66 73 2f 6b 69 61 74 6f 61 2f 74 65 73 /afs/kiatoa/tes
78d0: 74 69 6e 67 2f 63 6f 6f 6b 5f 69 73 6c 61 6e 64 ting/cook_island
78e0: 73 0a e2 80 8b 0a 5b 66 65 6d 74 6f 63 6f 72 70 s..[femtocorp
78f0: 2f 6e 65 77 5f 7a 65 61 6c 61 6e 64 5d 0a 54 45 /new_zealand].TE
7900: 53 54 50 41 54 48 20 2f 61 66 73 2f 6b 69 61 74 STPATH /afs/kiat
7910: 6f 61 2f 74 65 73 74 69 6e 67 2f 6e 65 77 5f 7a oa/testing/new_z
7920: 65 61 6c 61 6e 64 0a e2 80 8b 0a 5b 6d 65 67 61 ealand..[mega
7930: 63 6f 72 70 2f 6e 65 77 5f 7a 65 61 6c 61 6e 64 corp/new_zealand
7940: 5d 0a 54 45 53 54 50 41 54 48 20 2f 6e 66 73 2f ].TESTPATH /nfs/
7950: 74 65 73 74 69 6e 67 2f 6d 65 67 61 63 6f 72 70 testing/megacorp
7960: 5f 72 75 6e 73 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 _runs.</pre>.</d
7970: 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 iv>..</div>.<div
7980: 20 63 6c 61 73 73 3d 22 50 61 72 61 67 72 61 70 class="Paragrap
7990: 68 2d 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 h-">.<a class="t
79a0: 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 50 61 oc" name="toc-Pa
79b0: 72 61 67 72 61 70 68 2d 2d 31 22 3e 3c 2f 61 3e ragraph--1"></a>
79c0: 52 75 6e 6e 69 6e 67 20 6d 65 67 61 74 65 73 74 Running megatest
79d0: 20 6c 69 6b 65 20 74 68 69 73 3a 0a 3c 2f 64 69 like this:.</di
79e0: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 v>.<div class="C
79f0: 6f 64 65 22 3e 0a 6d 65 67 61 74 65 73 74 20 3a ode">.megatest :
7a00: 43 55 53 54 4f 4d 45 52 20 6d 65 67 61 63 6f 72 CUSTOMER megacor
7a10: 70 20 3a 4c 4f 43 41 54 49 4f 4e 20 6e 65 77 5f p :LOCATION new_
7a20: 7a 65 61 6c 61 6e 64 20 3a 72 75 6e 6e 61 6d 65 zealand :runname
7a30: 20 77 65 65 6b 31 32 5f 32 30 31 31 5f 72 75 6e week12_2011_run
7a40: 31 20 2d 72 75 6e 61 6c 6c 0a 3c 2f 64 69 76 3e 1 -runall.</div>
7a50: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 50 61 72 .<div class="Par
7a60: 61 67 72 61 70 68 2d 22 3e 0a 3c 61 20 63 6c 61 agraph-">.<a cla
7a70: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
7a80: 6f 63 2d 50 61 72 61 67 72 61 70 68 2d 2d 32 22 oc-Paragraph--2"
7a90: 3e 3c 2f 61 3e 57 6f 75 6c 64 20 73 65 74 3a 0a ></a>Would set:.
7aa0: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 </div>.<div clas
7ab0: 73 3d 22 43 6f 64 65 22 3e 0a 45 4e 43 52 59 50 s="Code">.ENCRYP
7ac0: 54 49 4f 4e 20 74 72 75 65 0a 3c 2f 64 69 76 3e TION true.</div>
7ad0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 .<div class="Cod
7ae0: 65 22 3e 0a 54 45 53 54 50 41 54 48 20 2f 6e 66 e">.TESTPATH /nf
7af0: 73 2f 74 65 73 74 69 6e 67 2f 6d 65 67 61 63 6f s/testing/megaco
7b00: 72 70 5f 72 75 6e 73 0a 3c 2f 64 69 76 3e 0a 3c rp_runs.</div>.<
7b10: 68 32 20 63 6c 61 73 73 3d 22 53 75 62 73 65 63 h2 class="Subsec
7b20: 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d tion">.<a class=
7b30: 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d "toc" name="toc-
7b40: 53 75 62 73 65 63 74 69 6f 6e 2d 39 2e 35 22 3e Subsection-9.5">
7b50: 39 2e 35 3c 2f 61 3e e2 80 83 57 72 69 74 69 6e 9.5</a> Writin
7b60: 67 20 74 65 73 74 73 0a 3c 2f 68 32 3e 0a 3c 68 g tests.</h2>.<h
7b70: 33 20 63 6c 61 73 73 3d 22 53 75 62 73 75 62 73 3 class="Subsubs
7b80: 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 ection">.<a clas
7b90: 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f s="toc" name="to
7ba0: 63 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d c-Subsubsection-
7bb0: 39 2e 35 2e 31 22 3e 39 2e 35 2e 31 3c 2f 61 3e 9.5.1">9.5.1</a>
7bc0: e2 80 83 74 65 73 74 63 6f 6e 66 69 67 20 66 69 testconfig fi
7bd0: 6c 65 0a 3c 2f 68 33 3e 0a 3c 64 69 76 20 63 6c le.</h3>.<div cl
7be0: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
7bf0: 3c 74 61 62 6c 65 3e 0a 3c 74 72 3e 0a 3c 74 64 <table>.<tr>.<td
7c00: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
7c10: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73 65 63 74 lign="top">.sect
7c20: 69 6f 6e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c ion.</td>.<td al
7c30: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
7c40: 6e 3d 22 74 6f 70 22 3e 0a 76 61 72 69 61 62 6c n="top">.variabl
7c50: 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 e.</td>.<td alig
7c60: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
7c70: 22 74 6f 70 22 3e 0a 76 61 6c 75 65 0a 3c 2f 74 "top">.value.</t
7c80: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
7c90: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
7ca0: 3e 0a 72 65 71 75 69 72 65 64 3f 0a 3c 2f 74 64 >.required?.</td
7cb0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
7cc0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
7cd0: 0a 63 6f 6d 6d 65 6e 74 73 0a 3c 2f 74 64 3e 0a .comments.</td>.
7ce0: 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 .</tr>.<tr>.<td
7cf0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
7d00: 69 67 6e 3d 22 74 6f 70 22 3e 0a 5b 73 65 74 75 ign="top">.[setu
7d10: 70 5d 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 p].</td>.<td ali
7d20: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
7d30: 3d 22 74 6f 70 22 3e 0a 72 75 6e 73 63 72 69 70 ="top">.runscrip
7d40: 74 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 t.</td>.<td alig
7d50: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
7d60: 22 74 6f 70 22 3e 0a 6e 61 6d 65 20 6f 66 20 73 "top">.name of s
7d70: 63 72 69 70 74 20 74 6f 20 65 78 65 63 75 74 65 cript to execute
7d80: 20 66 6f 72 20 74 68 69 73 20 74 65 73 74 0a 3c for this test.<
7d90: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
7da0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
7db0: 70 22 3e 0a 79 65 73 0a 3c 2f 74 64 3e 0a 3c 74 p">.yes.</td>.<t
7dc0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
7dd0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 54 68 65 align="top">.The
7de0: 20 73 63 72 69 70 74 20 6d 75 73 74 20 62 65 20 script must be
7df0: 65 78 65 63 75 74 61 62 6c 65 20 61 6e 64 20 65 executable and e
7e00: 69 74 68 65 72 20 70 72 6f 76 69 64 65 20 74 68 ither provide th
7e10: 65 20 66 75 6c 6c 20 70 61 74 68 20 6f 72 20 70 e full path or p
7e20: 75 74 20 61 20 63 6f 70 79 20 61 74 20 74 68 65 ut a copy at the
7e30: 20 74 6f 70 20 6f 66 20 79 6f 75 72 20 74 65 73 top of your tes
7e40: 74 20 64 69 72 65 63 74 6f 72 79 0a 3c 2f 74 64 t directory.</td
7e50: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
7e60: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
7e70: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 5b 72 65 align="top">.[re
7e80: 71 75 69 72 65 6d 65 6e 74 73 5d 0a 3c 2f 74 64 quirements].</td
7e90: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
7ea0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
7eb0: 0a 77 61 69 74 6f 6e 0a 3c 2f 74 64 3e 0a 3c 74 .waiton.</td>.<t
7ec0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
7ed0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 6c 69 73 align="top">.lis
7ee0: 74 20 6f 66 20 76 61 6c 69 64 20 74 65 73 74 20 t of valid test
7ef0: 6e 61 6d 65 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 names.</td>.<td
7f00: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
7f10: 69 67 6e 3d 22 74 6f 70 22 3e 0a 6e 6f 0a 3c 2f ign="top">.no.</
7f20: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
7f30: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
7f40: 22 3e 0a 54 68 69 73 20 74 65 73 74 20 77 69 6c ">.This test wil
7f50: 6c 20 6e 6f 74 20 72 75 6e 20 75 6e 74 69 6c 20 l not run until
7f60: 74 68 65 20 6e 61 6d 65 64 20 74 65 73 74 73 20 the named tests
7f70: 61 72 65 20 73 74 61 74 65 20 63 6f 6d 70 6c 65 are state comple
7f80: 74 65 64 20 61 6e 64 20 73 74 61 74 75 73 20 50 ted and status P
7f90: 41 53 53 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e ASS.</td>..</tr>
7fa0: 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d .<tr>.<td align=
7fb0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
7fc0: 6f 70 22 3e 0a 5b 69 74 65 6d 73 5d 0a 3c 2f 74 op">.[items].</t
7fd0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
7fe0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
7ff0: 3e 0a 61 6e 79 20 76 61 6c 69 64 0a 3c 2f 74 64 >.any valid.</td
8000: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
8010: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
8020: 0a 6c 69 73 74 20 6f 66 20 76 61 6c 75 65 73 0a .list of values.
8030: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
8040: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
8050: 6f 70 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 op">.no.</td>.<t
8060: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
8070: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 54 68 65 align="top">.The
8080: 20 74 65 73 74 20 77 69 6c 6c 20 62 65 20 72 65 test will be re
8090: 70 65 61 74 65 64 20 6f 6e 63 65 20 66 6f 72 20 peated once for
80a0: 65 61 63 68 20 69 74 65 6d 20 77 69 74 68 20 74 each item with t
80b0: 68 65 20 76 61 72 69 61 62 6c 65 20 6e 61 6d 65 he variable name
80c0: 20 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c 75 set to the valu
80d0: 65 2e 20 49 66 20 74 68 65 72 65 20 69 73 20 6d e. If there is m
80e0: 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 76 61 72 ore than one var
80f0: 69 61 62 6c 65 20 74 68 65 6e 20 74 68 65 20 74 iable then the t
8100: 65 73 74 20 77 69 6c 6c 20 62 65 20 72 75 6e 20 est will be run
8110: 61 67 61 69 6e 73 74 20 61 6c 6c 20 75 6e 69 71 against all uniq
8120: 75 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 ue combinations
8130: 6f 66 20 74 68 65 20 76 61 6c 75 65 73 0a 3c 2f of the values.</
8140: 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 0a 3c 2f 74 61 td>..</tr>..</ta
8150: 62 6c 65 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 33 ble>..</div>.<h3
8160: 20 63 6c 61 73 73 3d 22 53 75 62 73 75 62 73 65 class="Subsubse
8170: 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 ction">.<a class
8180: 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 ="toc" name="toc
8190: 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 39 -Subsubsection-9
81a0: 2e 35 2e 32 22 3e 39 2e 35 2e 32 3c 2f 61 3e e2 .5.2">9.5.2</a>
81b0: 80 83 43 6f 6d 6d 61 6e 64 20 6c 69 6e 65 0a 3c Command line.<
81c0: 2f 68 33 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d /h3>.<div class=
81d0: 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 74 61 62 "Standard">.<tab
81e0: 6c 65 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 le>.<tr>.<td ali
81f0: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
8200: 3d 22 74 6f 70 22 3e 0a 73 77 69 74 63 68 20 6f ="top">.switch o
8210: 72 20 70 61 72 61 6d 0a 3c 2f 74 64 3e 0a 3c 74 r param.</td>.<t
8220: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
8230: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 70 61 72 align="top">.par
8240: 61 6d 65 74 65 72 0a 3c 2f 74 64 3e 0a 3c 74 64 ameter.</td>.<td
8250: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
8260: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 70 75 72 70 lign="top">.purp
8270: 6f 73 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c ose.</td>.<td al
8280: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
8290: 6e 3d 22 74 6f 70 22 3e 0a 63 6f 6d 6d 65 6e 74 n="top">.comment
82a0: 73 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c s.</td>..</tr>.<
82b0: 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c tr>.<td align="l
82c0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
82d0: 22 3e 0a 2d 68 0a 3c 2f 74 64 3e 0a 3c 74 64 20 ">.-h.</td>.<td
82e0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
82f0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 ign="top">..</td
8300: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
8310: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
8320: 0a 62 72 69 65 66 20 68 65 6c 70 0a 3c 2f 74 64 .brief help.</td
8330: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
8340: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
8350: 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c ..</td>..</tr>.<
8360: 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c tr>.<td align="l
8370: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
8380: 22 3e 0a 2d 72 75 6e 61 6c 6c 0a 3c 2f 74 64 3e ">.-runall.</td>
8390: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
83a0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
83b0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
83c0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
83d0: 74 6f 70 22 3e 0a 72 75 6e 20 61 6c 6c 20 74 65 top">.run all te
83e0: 73 74 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c sts.</td>.<td al
83f0: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
8400: 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a n="top">..</td>.
8410: 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 .</tr>.<tr>.<td
8420: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
8430: 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d 72 75 6e 74 ign="top">.-runt
8440: 65 73 74 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 ests.</td>.<td a
8450: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
8460: 67 6e 3d 22 74 6f 70 22 3e 0a 74 65 73 74 31 2c gn="top">.test1,
8470: 74 65 73 74 32 2c 2e 2e 2e 0a 3c 2f 74 64 3e 0a test2,....</td>.
8480: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
8490: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 72 valign="top">.r
84a0: 75 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 74 un one or more t
84b0: 65 73 74 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 ests.</td>.<td a
84c0: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
84d0: 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e gn="top">..</td>
84e0: 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 ..</tr>.<tr>.<td
84f0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
8500: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d 73 74 65 lign="top">.-ste
8510: 70 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 p.</td>.<td alig
8520: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
8530: 22 74 6f 70 22 3e 0a 73 74 65 70 6e 61 6d 65 0a "top">.stepname.
8540: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
8550: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
8560: 6f 70 22 3e 0a 72 65 63 6f 72 64 20 61 20 73 74 op">.record a st
8570: 65 70 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 ep.</td>.<td ali
8580: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
8590: 3d 22 74 6f 70 22 3e 0a 72 65 71 75 69 72 65 73 ="top">.requires
85a0: 20 3a 73 74 61 74 65 20 61 6e 64 20 3a 73 74 61 :state and :sta
85b0: 74 75 73 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e tus.</td>..</tr>
85c0: 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d .<tr>.<td align=
85d0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
85e0: 6f 70 22 3e 0a 2d 74 65 73 74 2d 73 74 61 74 75 op">.-test-statu
85f0: 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 s.</td>.<td alig
8600: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
8610: 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 "top">..</td>.<t
8620: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
8630: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 72 65 63 align="top">.rec
8640: 6f 72 64 20 74 68 65 20 74 65 73 74 20 73 74 61 ord the test sta
8650: 74 75 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c tus.</td>.<td al
8660: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
8670: 6e 3d 22 74 6f 70 22 3e 0a 72 65 71 75 69 72 65 n="top">.require
8680: 73 20 3a 73 74 61 74 65 20 61 6e 64 20 3a 73 74 s :state and :st
8690: 61 74 75 73 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 atus.</td>..</tr
86a0: 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e >.<tr>.<td align
86b0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
86c0: 74 6f 70 22 3e 0a 2d 73 65 74 6c 6f 67 0a 3c 2f top">.-setlog.</
86d0: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
86e0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
86f0: 22 3e 0a 6c 6f 67 66 69 6c 65 6e 61 6d 65 0a 3c ">.logfilename.<
8700: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
8710: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
8720: 70 22 3e 0a 73 65 74 20 74 68 65 20 6c 6f 67 66 p">.set the logf
8730: 69 6c 65 20 6e 61 6d 65 20 66 6f 72 20 61 20 74 ile name for a t
8740: 65 73 74 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c est.</td>.<td al
8750: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
8760: 6e 3d 22 74 6f 70 22 3e 0a 70 61 74 68 20 69 73 n="top">.path is
8770: 20 61 73 73 75 6d 65 64 20 74 6f 20 62 65 20 72 assumed to be r
8780: 65 6c 61 74 69 76 65 20 74 6f 20 74 68 65 20 74 elative to the t
8790: 65 73 74 20 72 75 6e 20 64 69 72 65 63 74 6f 72 est run director
87a0: 79 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c y.</td>..</tr>.<
87b0: 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c tr>.<td align="l
87c0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
87d0: 22 3e 0a 2d 73 65 74 2d 74 6f 70 6c 6f 67 0a 3c ">.-set-toplog.<
87e0: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
87f0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
8800: 70 22 3e 0a 6c 6f 67 66 69 6c 65 6e 61 6d 65 0a p">.logfilename.
8810: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
8820: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
8830: 6f 70 22 3e 0a 73 65 74 20 74 68 65 20 6c 6f 67 op">.set the log
8840: 66 69 6c 65 20 6e 61 6d 65 20 66 6f 72 20 74 68 file name for th
8850: 65 20 74 6f 70 20 74 65 73 74 20 69 6e 20 61 6e e top test in an
8860: 20 69 74 65 72 61 74 65 64 20 74 65 73 74 20 72 iterated test r
8870: 75 6e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 un.</td>.<td ali
8880: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
8890: 3d 22 74 6f 70 22 3e 0a 65 61 63 68 20 73 75 62 ="top">.each sub
88a0: 20 74 65 73 74 20 63 61 6e 20 68 61 76 65 20 69 test can have i
88b0: 74 73 20 6f 77 6e 20 6c 6f 67 66 69 6c 65 20 73 ts own logfile s
88c0: 65 74 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a et.</td>..</tr>.
88d0: 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 <tr>.<td align="
88e0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
88f0: 70 22 3e 0a 2d 6d 0a 3c 2f 74 64 3e 0a 3c 74 64 p">.-m.</td>.<td
8900: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
8910: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a e2 80 9c 63 lign="top">.“c
8920: 6f 6d 6d 65 6e 74 e2 80 9d 0a 3c 2f 74 64 3e 0a omment”.</td>.
8930: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
8940: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73 valign="top">.s
8950: 65 74 73 20 61 20 63 6f 6d 6d 65 6e 74 20 66 6f ets a comment fo
8960: 72 20 74 68 65 20 73 74 65 70 2c 20 74 65 73 74 r the step, test
8970: 20 6f 72 20 72 75 6e 0a 3c 2f 74 64 3e 0a 3c 74 or run.</td>.<t
8980: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
8990: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f align="top">..</
89a0: 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a td>..</tr>.<tr>.
89b0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
89c0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 3a valign="top">.:
89d0: 72 75 6e 6e 61 6d 65 0a 3c 2f 74 64 3e 0a 3c 74 runname.</td>.<t
89e0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
89f0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 5b 61 2d align="top">.[a-
8a00: 7a 41 2d 5a 30 2d 39 5f 2d 5d 2b 0a 3c 2f 74 64 zA-Z0-9_-]+.</td
8a10: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
8a20: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
8a30: 0a 64 69 72 65 63 74 6f 72 79 20 69 6e 20 77 68 .directory in wh
8a40: 69 63 68 20 74 68 69 73 20 72 75 6e 20 77 69 6c ich this run wil
8a50: 6c 20 62 65 20 73 74 6f 72 65 64 20 69 6e 20 74 l be stored in t
8a60: 68 65 20 74 65 73 74 20 72 75 6e 20 61 72 65 61 he test run area
8a70: 20 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 .</td>.<td alig
8a80: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
8a90: 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a 3c "top">..</td>..<
8aa0: 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c /tr>.<tr>.<td al
8ab0: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
8ac0: 6e 3d 22 74 6f 70 22 3e 0a 3a 73 74 61 74 65 0a n="top">.:state.
8ad0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
8ae0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
8af0: 6f 70 22 3e 0a 61 6e 79 20 76 61 6c 75 65 0a 3c op">.any value.<
8b00: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
8b10: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
8b20: 70 22 3e 0a 53 65 74 20 74 68 65 20 73 74 65 70 p">.Set the step
8b30: 20 6f 72 20 74 65 73 74 20 73 74 61 74 65 2c 20 or test state,
8b40: 74 68 69 73 20 69 73 20 73 74 6f 72 65 64 20 69 this is stored i
8b50: 6e 20 74 68 65 20 73 74 61 74 65 20 66 69 65 6c n the state fiel
8b60: 64 20 69 6e 20 74 68 65 20 73 74 65 70 73 20 6f d in the steps o
8b70: 72 20 74 65 73 74 73 20 74 61 62 6c 65 20 72 65 r tests table re
8b80: 73 70 65 63 74 69 76 65 6c 79 0a 3c 2f 74 64 3e spectively.</td>
8b90: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
8ba0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
8bb0: 46 6f 72 20 74 65 73 74 73 20 4d 65 67 61 74 65 For tests Megate
8bc0: 73 74 20 72 65 63 6f 67 6e 69 73 65 73 20 e2 80 st recognises
8bd0: 9c 49 4e 43 4f 4d 50 4c 45 54 45 e2 80 9d 2c 20 INCOMPLETE”,
8be0: e2 80 9c 43 4f 4d 50 4c 45 54 45 e2 80 9d 0a 3c “COMPLETE”.<
8bf0: 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e /td>..</tr>.<tr>
8c00: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
8c10: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
8c20: 3a 73 74 61 74 75 73 0a 3c 2f 74 64 3e 0a 3c 74 :status.</td>.<t
8c30: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
8c40: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 61 6e 79 align="top">.any
8c50: 20 76 61 6c 75 65 0a 3c 2f 74 64 3e 0a 3c 74 64 value.</td>.<td
8c60: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
8c70: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 53 65 74 20 lign="top">.Set
8c80: 74 68 65 20 73 74 65 70 20 6f 72 20 74 65 73 74 the step or test
8c90: 20 73 74 61 74 75 73 2c 20 74 68 69 73 20 69 73 status, this is
8ca0: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 73 stored in the s
8cb0: 74 61 74 75 73 20 66 69 65 6c 64 20 69 6e 20 74 tatus field in t
8cc0: 68 65 20 73 74 65 70 73 20 6f 72 20 74 65 73 74 he steps or test
8cd0: 73 20 74 61 62 6c 65 20 72 65 73 70 65 63 74 69 s table respecti
8ce0: 76 65 6c 79 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 vely.</td>.<td a
8cf0: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
8d00: 67 6e 3d 22 74 6f 70 22 3e 0a 46 6f 72 20 74 65 gn="top">.For te
8d10: 73 74 73 20 4d 65 67 61 74 65 73 74 20 72 65 63 sts Megatest rec
8d20: 6f 67 6e 69 73 65 73 20 e2 80 9c 50 41 53 53 e2 ognises “PASS
8d30: 80 9d 2c 20 e2 80 9c 46 41 49 4c e2 80 9d 2c 20 , “FAIL”,
8d40: 61 6e 64 20 e2 80 9c 43 48 45 43 4b e2 80 9d 0a and “CHECK”.
8d50: 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 </td>..</tr>.<tr
8d60: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
8d70: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
8d80: 0a 2d 6c 69 73 74 2d 72 75 6e 73 0a 3c 2f 74 64 .-list-runs.</td
8d90: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
8da0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
8db0: 0a 61 6e 79 20 76 61 6c 75 65 2c 20 25 20 69 73 .any value, % is
8dc0: 20 77 69 6c 64 63 61 72 64 0a 3c 2f 74 64 3e 0a wildcard.</td>.
8dd0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
8de0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 52 valign="top">.R
8df0: 65 73 70 65 63 74 73 20 2d 69 74 65 6d 70 61 74 espects -itempat
8e00: 74 20 61 6e 64 20 2d 74 65 73 74 70 61 74 74 20 t and -testpatt
8e10: 66 6f 72 20 66 69 6c 74 65 72 73 0a 3c 2f 74 64 for filters.</td
8e20: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
8e30: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
8e40: 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c ..</td>..</tr>.<
8e50: 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c tr>.<td align="l
8e60: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
8e70: 22 3e 0a 2d 74 65 73 74 70 61 74 74 0a 3c 2f 74 ">.-testpatt.</t
8e80: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
8e90: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
8ea0: 3e 0a 61 6e 79 20 76 61 6c 75 65 2c 20 25 20 69 >.any value, % i
8eb0: 73 20 77 69 6c 64 63 61 72 64 0a 3c 2f 74 64 3e s wildcard.</td>
8ec0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
8ed0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
8ee0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
8ef0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
8f00: 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f top">..</td>..</
8f10: 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 tr>.<tr>.<td ali
8f20: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
8f30: 3d 22 74 6f 70 22 3e 0a 2d 69 74 65 6d 70 61 74 ="top">.-itempat
8f40: 74 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 t.</td>.<td alig
8f50: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
8f60: 22 74 6f 70 22 3e 0a 61 6e 79 20 76 61 6c 75 65 "top">.any value
8f70: 2c 20 25 20 69 73 20 77 69 6c 64 63 61 72 64 0a , % is wildcard.
8f80: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
8f90: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
8fa0: 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 op">..</td>.<td
8fb0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
8fc0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 ign="top">..</td
8fd0: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
8fe0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
8ff0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d 73 68 align="top">.-sh
9000: 6f 77 6b 65 79 73 0a 3c 2f 74 64 3e 0a 3c 74 64 owkeys.</td>.<td
9010: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
9020: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 lign="top">..</t
9030: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
9040: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
9050: 3e 0a 50 72 69 6e 74 20 74 68 65 20 6b 65 79 73 >.Print the keys
9060: 20 62 65 69 6e 67 20 75 73 65 64 20 66 6f 72 20 being used for
9070: 74 68 69 73 20 64 61 74 61 62 61 73 65 0a 3c 2f this database.</
9080: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
9090: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
90a0: 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e ">..</td>..</tr>
90b0: 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d .<tr>.<td align=
90c0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
90d0: 6f 70 22 3e 0a 2d 66 6f 72 63 65 0a 3c 2f 74 64 op">.-force.</td
90e0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
90f0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
9100: 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 ..</td>.<td alig
9110: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
9120: 22 74 6f 70 22 3e 0a 54 65 73 74 20 77 69 6c 6c "top">.Test will
9130: 20 6e 6f 74 20 72 65 2d 72 75 6e 20 69 66 20 69 not re-run if i
9140: 6e 20 74 68 65 20 e2 80 9c 50 41 53 53 e2 80 9d n the “PASS”
9150: 2c 20 e2 80 9c 43 48 45 43 4b e2 80 9d 20 6f 72 , “CHECK” or
9160: 20 e2 80 9c 4b 49 4c 4c 45 44 e2 80 9d 2c 20 75 “KILLED”, u
9170: 73 69 6e 67 20 2d 66 6f 72 63 65 20 77 69 6c 6c sing -force will
9180: 20 66 6f 72 63 65 20 74 68 65 20 72 75 6e 20 74 force the run t
9190: 6f 20 62 65 20 6c 61 75 6e 63 68 65 64 2e 0a 3c o be launched..<
91a0: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
91b0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
91c0: 70 22 3e 0a 57 41 52 4e 49 4e 47 3a 20 54 68 65 p">.WARNING: The
91d0: 20 2d 66 6f 72 63 65 20 73 77 69 74 63 68 20 77 -force switch w
91e0: 69 6c 6c 20 62 79 70 61 73 73 20 61 6e 79 20 e2 ill bypass any
91f0: 80 9c 77 61 69 74 6f 6e e2 80 9d 20 64 65 70 65 waiton” depe
9200: 6e 64 65 6e 63 69 65 73 2e 0a 3c 2f 74 64 3e 0a ndencies..</td>.
9210: 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 .</tr>.<tr>.<td
9220: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
9230: 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d 78 74 65 72 ign="top">.-xter
9240: 6d 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 m.</td>.<td alig
9250: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
9260: 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 "top">..</td>.<t
9270: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
9280: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 4c 61 75 align="top">.Lau
9290: 6e 63 68 20 61 6e 20 78 74 65 72 6d 20 69 6e 73 nch an xterm ins
92a0: 74 65 61 64 20 6f 66 20 72 75 6e 20 74 68 65 20 tead of run the
92b0: 74 65 73 74 2e 20 54 68 65 20 78 74 65 72 6d 20 test. The xterm
92c0: 77 69 6c 6c 20 68 61 76 65 20 74 68 65 20 65 6e will have the en
92d0: 76 69 72 6f 6e 6d 65 6e 74 20 74 68 61 74 20 74 vironment that t
92e0: 68 65 20 74 65 73 74 20 77 6f 75 6c 64 20 73 65 he test would se
92f0: 65 2e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 e..</td>.<td ali
9300: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
9310: 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a ="top">..</td>..
9320: 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 </tr>.<tr>.<td a
9330: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
9340: 67 6e 3d 22 74 6f 70 22 3e 0a 2d 72 65 6d 6f 76 gn="top">.-remov
9350: 65 2d 72 75 6e 73 0a 3c 2f 74 64 3e 0a 3c 74 64 e-runs.</td>.<td
9360: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
9370: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 lign="top">..</t
9380: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
9390: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
93a0: 3e 0a 52 65 6d 6f 76 65 20 61 20 72 75 6e 2c 20 >.Remove a run,
93b0: 74 65 73 74 20 6f 72 20 73 75 62 74 65 73 74 20 test or subtest
93c0: 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 from the databas
93d0: 65 20 61 6e 64 20 74 68 65 20 64 69 73 6b 2e 20 e and the disk.
93e0: 43 61 6e 6e 6f 74 20 62 65 20 75 6e 64 6f 6e 65 Cannot be undone
93f0: 2e 20 52 65 71 75 69 72 65 73 20 2d 74 65 73 74 . Requires -test
9400: 70 61 74 74 2c 20 2d 69 74 65 6d 70 61 74 74 2c patt, -itempatt,
9410: 20 3a 72 75 6e 6e 61 6d 65 20 61 6e 64 20 61 6c :runname and al
9420: 6c 20 6b 65 79 73 20 62 65 20 73 70 65 63 69 66 l keys be specif
9430: 69 65 64 2e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 ied..</td>.<td a
9440: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
9450: 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e gn="top">..</td>
9460: 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 ..</tr>.<tr>.<td
9470: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
9480: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 3c 69 3e 54 lign="top">.<i>T
9490: 65 73 74 20 68 65 6c 70 65 72 73 3c 2f 69 3e 0a est helpers</i>.
94a0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
94b0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
94c0: 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 op">..</td>.<td
94d0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
94e0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 ign="top">..</td
94f0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
9500: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
9510: 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c ..</td>..</tr>.<
9520: 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c tr>.<td align="l
9530: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
9540: 22 3e 0a 2d 72 75 6e 73 74 65 70 0a 3c 2f 74 64 ">.-runstep.</td
9550: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
9560: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
9570: 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 ..</td>.<td alig
9580: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
9590: 22 74 6f 70 22 3e 0a 55 73 65 64 20 69 6e 73 69 "top">.Used insi
95a0: 64 65 20 61 20 74 65 73 74 20 74 6f 20 72 75 6e de a test to run
95b0: 20 61 20 73 74 65 70 2c 20 72 65 63 6f 72 64 20 a step, record
95c0: 74 68 65 20 73 74 61 72 74 20 61 6e 64 20 65 6e the start and en
95d0: 64 20 6f 66 20 74 68 65 20 73 74 65 70 20 61 6e d of the step an
95e0: 64 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 61 6e 61 d optionally ana
95f0: 6c 79 7a 65 20 74 68 65 20 6f 75 74 70 75 74 20 lyze the output
9600: 75 73 69 6e 67 20 6c 6f 67 70 72 6f 2e 0a 3c 2f using logpro..</
9610: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
9620: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
9630: 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e ">..</td>..</tr>
9640: 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d .<tr>.<td align=
9650: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
9660: 6f 70 22 3e 0a 2d 6c 6f 67 70 72 6f 0a 3c 2f 74 op">.-logpro.</t
9670: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
9680: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
9690: 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 >..</td>.<td ali
96a0: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
96b0: 3d 22 74 6f 70 22 3e 0a 49 66 20 75 73 69 6e 67 ="top">.If using
96c0: 20 6c 6f 67 70 72 6f 20 74 6f 20 61 73 73 65 73 logpro to asses
96d0: 20 74 68 65 20 50 41 53 53 2f 46 41 49 4c 20 73 the PASS/FAIL s
96e0: 74 61 74 75 73 20 6f 66 20 74 68 65 20 73 74 65 tatus of the ste
96f0: 70 20 79 6f 75 20 73 70 65 63 69 66 79 20 74 68 p you specify th
9700: 65 20 6c 6f 67 70 72 6f 20 66 69 6c 65 20 77 69 e logpro file wi
9710: 74 68 20 74 68 69 73 20 70 61 72 61 6d 65 74 65 th this paramete
9720: 72 2e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 r..</td>.<td ali
9730: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
9740: 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a ="top">..</td>..
9750: 3c 2f 74 72 3e 0a 0a 3c 2f 74 61 62 6c 65 3e 0a </tr>..</table>.
9760: 0a 3c 2f 64 69 76 3e 0a 3c 68 31 20 63 6c 61 73 .</div>.<h1 clas
9770: 73 3d 22 53 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 s="Section">.<a
9780: 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 class="toc" name
9790: 3d 22 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 41 22 ="toc-Section-A"
97a0: 3e 41 3c 2f 61 3e e2 80 83 44 61 74 61 0a 3c 2f >A</a> Data.</
97b0: 68 31 3e 0a 3c 68 31 20 63 6c 61 73 73 3d 22 53 h1>.<h1 class="S
97c0: 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 ection">.<a clas
97d0: 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f s="toc" name="to
97e0: 63 2d 53 65 63 74 69 6f 6e 2d 42 22 3e 42 3c 2f c-Section-B">B</
97f0: 61 3e e2 80 83 52 65 66 65 72 65 6e 63 65 73 0a a> References.
9800: 3c 2f 68 31 3e 0a 0a 3c 68 72 20 63 6c 61 73 73 </h1>..<hr class
9810: 3d 22 66 6f 6f 74 65 72 22 2f 3e 0a 3c 64 69 76 ="footer"/>.<div
9820: 20 63 6c 61 73 73 3d 22 66 6f 6f 74 65 72 22 20 class="footer"
9830: 69 64 3d 22 67 65 6e 65 72 61 74 65 64 2d 62 79 id="generated-by
9840: 22 3e 0a 44 6f 63 75 6d 65 6e 74 20 67 65 6e 65 ">.Document gene
9850: 72 61 74 65 64 20 62 79 20 3c 61 20 68 72 65 66 rated by <a href
9860: 3d 22 68 74 74 70 3a 2f 2f 65 6c 79 78 65 72 2e ="http://elyxer.
9870: 6e 6f 6e 67 6e 75 2e 6f 72 67 2f 22 3e 65 4c 79 nongnu.org/">eLy
9880: 58 65 72 20 31 2e 30 2e 30 20 28 32 30 31 30 2d Xer 1.0.0 (2010-
9890: 30 37 2d 32 31 29 3c 2f 61 3e 20 6f 6e 20 3c 73 07-21)</a> on <s
98a0: 70 61 6e 20 63 6c 61 73 73 3d 22 63 72 65 61 74 pan class="creat
98b0: 65 2d 64 61 74 65 22 3e 32 30 31 31 2d 30 39 2d e-date">2011-09-
98c0: 32 34 54 31 32 3a 34 31 3a 32 36 2e 37 36 37 39 24T12:41:26.7679
98d0: 37 35 3c 2f 73 70 61 6e 3e 0a 3c 2f 64 69 76 3e 75</span>.</div>
98e0: 0a 3c 2f 64 69 76 3e 0a 3c 2f 62 6f 64 79 3e 0a .</div>.</body>.
98f0: 3c 2f 68 74 6d 6c 3e 0a </html>.