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 31 32 2d 31 35 22 2f nt="2011-12-15"/
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 65 6c 79 78 65 72 2e 6e 6f 6e ttp://elyxer.non
01d0: 67 6e 75 2e 6f 72 67 2f 6c 79 78 2e 63 73 73 22 gnu.org/lyx.css"
01e0: 20 74 79 70 65 3d 22 74 65 78 74 2f 63 73 73 22 type="text/css"
01f0: 20 6d 65 64 69 61 3d 22 61 6c 6c 22 2f 3e 0a 3c media="all"/>.<
0200: 74 69 74 6c 65 3e 4d 65 67 61 74 65 73 74 20 55 title>Megatest U
0210: 73 65 72 20 4d 61 6e 75 61 6c 3c 2f 74 69 74 6c ser Manual</titl
0220: 65 3e 0a 3c 2f 68 65 61 64 3e 0a 3c 62 6f 64 79 e>.</head>.<body
0230: 3e 0a 3c 64 69 76 20 69 64 3d 22 67 6c 6f 62 61 >.<div id="globa
0240: 6c 57 72 61 70 70 65 72 22 3e 0a 3c 64 69 76 20 lWrapper">.<div
0250: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
0260: 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 >..</div>.<div c
0270: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
0280: 0a 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c ..</div>.<div cl
0290: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
02a0: 0a 3c 2f 64 69 76 3e 0a 3c 68 31 20 63 6c 61 73 .</div>.<h1 clas
02b0: 73 3d 22 74 69 74 6c 65 22 3e 0a 4d 65 67 61 74 s="title">.Megat
02c0: 65 73 74 20 55 73 65 72 20 4d 61 6e 75 61 6c 0a est User Manual.
02d0: 3c 2f 68 31 3e 0a 3c 68 32 20 63 6c 61 73 73 3d </h1>.<h2 class=
02e0: 22 61 75 74 68 6f 72 22 3e 0a 4d 61 74 74 68 65 "author">.Matthe
02f0: 77 20 57 65 6c 6c 61 6e 64 0a 3c 2f 68 32 3e 0a w Welland.</h2>.
0300: 3c 68 32 20 63 6c 61 73 73 3d 22 44 61 74 65 22 <h2 class="Date"
0310: 3e 0a 53 65 70 74 2e 20 32 30 2c 20 0a 3c 2f 68 >.Sept. 20, .</h
0320: 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 2>.<div class="S
0330: 74 61 6e 64 61 72 64 22 3e 0a 3c 73 70 61 6e 20 tandard">.<span
0340: 63 6c 61 73 73 3d 22 75 6e 6b 6e 6f 77 6e 22 3e class="unknown">
0350: 5c 74 68 69 73 70 61 67 65 73 74 79 6c 65 3c 2f \thispagestyle</
0360: 73 70 61 6e 3e 65 6d 70 74 79 0a 3c 2f 64 69 76 span>empty.</div
0370: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
0380: 61 6e 64 61 72 64 22 3e 0a 3c 70 3e 3c 62 72 2f andard">.<p><br/
0390: 3e 0a 3c 2f 70 3e 0a c2 a9 32 30 31 31 20 4d 61 >.</p>.©2011 Ma
03a0: 74 74 68 65 77 20 57 65 6c 6c 61 6e 64 2e 20 41 tthew Welland. A
03b0: 6c 6c 20 72 69 67 68 74 73 20 72 65 73 65 72 76 ll rights reserv
03c0: 65 64 2e 20 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 ed. .</div>.<div
03d0: 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 class="Standard
03e0: 22 3e 0a 4d 65 67 61 74 65 73 74 20 69 73 20 66 ">.Megatest is f
03f0: 72 65 65 20 73 6f 66 74 77 61 72 65 20 72 65 6c ree software rel
0400: 65 61 73 65 64 20 75 6e 64 65 72 20 74 68 65 20 eased under the
0410: 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c General Public L
0420: 69 63 65 6e 73 65 20 76 32 2e 30 2e 20 50 6c 65 icense v2.0. Ple
0430: 61 73 65 20 73 65 65 20 74 68 65 20 66 69 6c 65 ase see the file
0440: 20 43 4f 50 59 49 4e 47 20 69 6e 20 74 68 65 20 COPYING in the
0450: 73 6f 75 72 63 65 20 64 69 73 74 72 69 62 75 74 source distribut
0460: 69 6f 6e 20 66 6f 72 20 64 65 74 61 69 6c 73 2e ion for details.
0470: 20 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c .</div>.<div cl
0480: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
0490: 3c 64 69 76 20 63 6c 61 73 73 3d 22 6d 65 64 73 <div class="meds
04a0: 6b 69 70 22 3e 20 3c 2f 64 69 76 3e 45 6d 61 69 kip"> </div>Emai
04b0: 6c 3a 20 6d 61 74 74 40 6b 69 61 74 6f 61 2e 63 l: matt@kiatoa.c
04c0: 6f 6d 2e 20 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 om. .</div>.<div
04d0: 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 class="Standard
04e0: 22 3e 0a 57 65 62 3a 20 77 77 77 2e 6b 69 61 74 ">.Web: www.kiat
04f0: 6f 61 2e 63 6f 6d 2f 66 6f 73 73 69 6c 73 2f 6d oa.com/fossils/m
0500: 65 67 61 74 65 73 74 0a 3c 2f 64 69 76 3e 0a 3c egatest.</div>.<
0510: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
0520: 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 ard">.<div class
0530: 3d 22 6d 65 64 73 6b 69 70 22 3e 20 3c 2f 64 69 ="medskip"> </di
0540: 76 3e 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 v>This document
0550: 69 73 20 62 65 6c 69 65 76 65 64 20 74 6f 20 62 is believed to b
0560: 65 20 61 63 75 72 61 74 65 20 61 74 20 74 68 65 e acurate at the
0570: 20 74 69 6d 65 20 6f 66 20 77 72 69 74 69 6e 67 time of writing
0580: 20 62 75 74 20 61 73 20 77 69 74 68 20 61 6e 79 but as with any
0590: 20 6f 70 65 6e 73 6f 75 72 63 65 20 70 72 6f 6a opensource proj
05a0: 65 63 74 20 74 68 65 20 73 6f 75 72 63 65 20 63 ect the source c
05b0: 6f 64 65 20 69 74 73 65 6c 66 20 69 73 20 74 68 ode itself is th
05c0: 65 20 72 65 66 65 72 65 6e 63 65 2e 20 49 74 20 e reference. It
05d0: 69 73 20 74 68 65 20 72 65 73 70 6f 6e 73 69 62 is the responsib
05e0: 69 6c 69 74 79 20 6f 66 20 74 68 65 20 65 6e 64 ility of the end
05f0: 20 75 73 65 72 20 74 6f 20 76 61 6c 69 64 61 74 user to validat
0600: 65 20 74 68 61 74 20 74 68 65 20 63 6f 64 65 20 e that the code
0610: 77 69 6c 6c 20 70 65 72 66 6f 72 6d 20 61 73 20 will perform as
0620: 74 68 65 79 20 65 78 70 65 63 74 2e 20 54 68 65 they expect. The
0630: 20 61 75 74 68 6f 72 20 61 73 73 75 6d 65 73 20 author assumes
0640: 6e 6f 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 no responsibilit
0650: 79 20 66 6f 72 20 61 6e 79 20 69 6e 61 63 63 75 y for any inaccu
0660: 72 61 63 69 65 73 20 74 68 61 74 20 74 68 69 73 racies that this
0670: 20 64 6f 63 75 6d 65 6e 74 20 6d 61 79 20 63 6f document may co
0680: 6e 74 61 69 6e 2e 20 49 6e 20 6e 6f 20 65 76 65 ntain. In no eve
0690: 6e 74 20 77 69 6c 6c 20 4d 61 74 74 68 65 77 20 nt will Matthew
06a0: 57 65 6c 6c 61 6e 64 20 62 65 20 6c 69 61 62 6c Welland be liabl
06b0: 65 20 66 6f 72 20 64 69 72 65 63 74 2c 20 69 6e e for direct, in
06c0: 64 69 72 65 63 74 2c 20 73 70 65 63 69 61 6c 2c direct, special,
06d0: 20 65 78 65 6d 70 6c 61 72 79 2c 20 69 6e 63 69 exemplary, inci
06e0: 64 65 6e 74 61 6c 2c 20 6f 72 20 63 6f 6e 73 65 dental, or conse
06f0: 71 75 65 6e 74 69 61 6c 20 64 61 6d 61 67 65 73 quential damages
0700: 20 72 65 73 75 6c 74 69 6e 67 20 66 72 6f 6d 20 resulting from
0710: 61 6e 79 20 64 65 66 65 63 74 20 6f 72 20 6f 6d any defect or om
0720: 69 73 73 69 6f 6e 20 69 6e 20 74 68 69 73 20 64 ission in this d
0730: 6f 63 75 6d 65 6e 74 2c 20 65 76 65 6e 20 69 66 ocument, even if
0740: 20 61 64 76 69 73 65 64 20 6f 66 20 74 68 65 20 advised of the
0750: 70 6f 73 73 69 62 69 6c 69 74 79 20 6f 66 20 73 possibility of s
0760: 75 63 68 20 64 61 6d 61 67 65 73 2e 20 0a 3c 2f uch damages. .</
0770: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
0780: 22 53 74 61 6e 64 61 72 64 22 3e 0a 54 68 69 73 "Standard">.This
0790: 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 61 20 73 document is a s
07a0: 6e 61 70 73 68 6f 74 20 69 6e 20 74 69 6d 65 20 napshot in time
07b0: 61 6e 64 20 4d 65 67 61 74 65 73 74 20 73 6f 66 and Megatest sof
07c0: 74 77 61 72 65 20 68 61 73 20 6c 69 6b 65 6c 79 tware has likely
07d0: 20 63 68 61 6e 67 65 64 20 73 69 6e 63 65 20 70 changed since p
07e0: 75 62 6c 69 63 61 74 69 6f 6e 2e 20 54 68 69 73 ublication. This
07f0: 20 64 6f 63 75 6d 65 6e 74 20 61 6e 64 20 4d 65 document and Me
0800: 67 61 74 65 73 74 20 6d 61 79 20 62 65 20 69 6d gatest may be im
0810: 70 72 6f 76 65 64 20 61 74 20 61 6e 79 20 74 69 proved at any ti
0820: 6d 65 2c 20 77 69 74 68 6f 75 74 20 6e 6f 74 69 me, without noti
0830: 63 65 20 6f 72 20 6f 62 6c 69 67 61 74 69 6f 6e ce or obligation
0840: 2e 20 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 . .</div>.<div c
0850: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
0860: 0a 3c 70 3e 3c 62 72 2f 3e 0a 3c 2f 70 3e 0a 0a .<p><br/>.</p>..
0870: 3c 2f 64 69 76 3e 0a 3c 68 31 20 63 6c 61 73 73 </div>.<h1 class
0880: 3d 22 53 65 63 74 69 6f 6e 2d 22 3e 0a 3c 61 20 ="Section-">.<a
0890: 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 class="toc" name
08a0: 3d 22 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 2d 31 ="toc-Section--1
08b0: 22 3e 3c 2f 61 3e 4d 65 67 61 74 65 73 74 2f 64 "></a>Megatest/d
08c0: 6f 63 75 6d 65 6e 74 20 52 65 76 69 73 69 6f 6e ocument Revision
08d0: 20 48 69 73 74 6f 72 79 0a 3c 2f 68 31 3e 0a 3c History.</h1>.<
08e0: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
08f0: 61 72 64 22 3e 0a 3c 69 3e 4e 6f 74 61 62 6c 65 ard">.<i>Notable
0900: 20 72 65 76 69 73 69 6f 6e 73 20 6f 66 20 74 68 revisions of th
0910: 65 20 73 6f 66 74 77 61 72 65 20 61 72 65 20 6f e software are o
0920: 63 63 61 73 69 6f 6e 61 6c 6c 79 20 64 6f 63 75 ccasionally docu
0930: 6d 65 6e 74 65 64 20 68 65 72 65 3c 2f 69 3e 2e mented here</i>.
0940: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
0950: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c ss="Standard">.<
0960: 64 69 76 20 63 6c 61 73 73 3d 22 63 65 6e 74 65 div class="cente
0970: 72 22 3e 0a 3c 74 61 62 6c 65 3e 0a 3c 74 72 3e r">.<table>.<tr>
0980: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 .<td align="cent
0990: 65 72 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 er" valign="top"
09a0: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 30 style="width: 0
09b0: 2e 35 69 6e 3b 22 3e 0a 56 65 72 73 69 6f 6e 0a .5in;">.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 20 73 74 79 6c 65 3d 22 77 69 64 "top" style="wid
09f0: 74 68 3a 20 30 2e 35 69 6e 3b 22 3e 0a 41 75 74 th: 0.5in;">.Aut
0a00: 68 6f 72 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c hor.</td>.<td al
0a10: 69 67 6e 3d 22 6a 75 73 74 69 66 79 22 20 76 61 ign="justify" va
0a20: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
0a30: 3d 22 77 69 64 74 68 3a 20 33 69 6e 3b 22 3e 0a ="width: 3in;">.
0a40: 44 65 73 63 72 69 70 74 69 6f 6e 0a 3c 2f 74 64 Description.</td
0a50: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e >.<td align="cen
0a60: 74 65 72 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 ter" valign="top
0a70: 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 " style="width:
0a80: 31 69 6e 3b 22 3e 0a 44 61 74 65 0a 3c 2f 74 64 1in;">.Date.</td
0a90: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
0aa0: 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 d align="center"
0ab0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 valign="top" st
0ac0: 79 6c 65 3d 22 77 69 64 74 68 3a 20 30 2e 35 69 yle="width: 0.5i
0ad0: 6e 3b 22 3e 0a 76 31 2e 32 35 0a 3c 2f 74 64 3e n;">.v1.25.</td>
0ae0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e 74 .<td align="cent
0af0: 65 72 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 er" valign="top"
0b00: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 30 style="width: 0
0b10: 2e 35 69 6e 3b 22 3e 0a 6d 61 74 74 0a 3c 2f 74 .5in;">.matt.</t
0b20: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6a 75 d>.<td align="ju
0b30: 73 74 69 66 79 22 20 76 61 6c 69 67 6e 3d 22 74 stify" valign="t
0b40: 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 op" style="width
0b50: 3a 20 33 69 6e 3b 22 3e 0a 63 6f 6e 76 65 72 74 : 3in;">.convert
0b60: 65 64 20 74 6f 20 6e 65 77 20 64 6f 63 75 6d 65 ed to new docume
0b70: 6e 74 20 74 65 6d 70 6c 61 74 65 0a 3c 2f 74 64 nt template.</td
0b80: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 63 65 6e >.<td align="cen
0b90: 74 65 72 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 ter" valign="top
0ba0: 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 " style="width:
0bb0: 31 69 6e 3b 22 3e 0a 3c 73 70 61 6e 20 63 6c 61 1in;">.<span cla
0bc0: 73 73 3d 22 75 6e 6b 6e 6f 77 6e 22 3e 5c 74 68 ss="unknown">\th
0bd0: 65 64 61 74 65 3c 2f 73 70 61 6e 3e 0a 3c 2f 74 edate</span>.</t
0be0: 64 3e 0a 0a 3c 2f 74 72 3e 0a 0a 3c 2f 74 61 62 d>..</tr>..</tab
0bf0: 6c 65 3e 0a 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 le>..</div>..</d
0c00: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 iv>.<div class="
0c10: 53 74 61 6e 64 61 72 64 22 3e 0a 3c 70 3e 3c 62 Standard">.<p><b
0c20: 72 2f 3e 0a 3c 2f 70 3e 0a 3c 64 69 76 20 63 6c r/>.</p>.<div cl
0c30: 61 73 73 3d 22 66 75 6c 6c 74 6f 63 22 3e 0a 3c ass="fulltoc">.<
0c40: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 68 65 div class="toche
0c50: 61 64 65 72 22 3e 0a 54 61 62 6c 65 20 6f 66 20 ader">.Table of
0c60: 43 6f 6e 74 65 6e 74 73 0a 3c 2f 64 69 76 3e 0a Contents.</div>.
0c70: 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 69 <div class="toci
0c80: 6e 64 65 6e 74 22 3e 0a 3c 64 69 76 20 63 6c 61 ndent">.<div cla
0c90: 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 ss="toc">.<a cla
0ca0: 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 ss="Link" href="
0cb0: 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 2d 31 22 #toc-Section--1"
0cc0: 3e 53 65 63 74 69 6f 6e 3a e2 80 83 4d 65 67 61 >Section: Mega
0cd0: 74 65 73 74 2f 64 6f 63 75 6d 65 6e 74 20 52 65 test/document Re
0ce0: 76 69 73 69 6f 6e 20 48 69 73 74 6f 72 79 3c 2f vision History</
0cf0: 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 a>.</div>.<div c
0d00: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 lass="toc">.<a c
0d10: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 lass="Link" href
0d20: 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 31 ="#toc-Section-1
0d30: 22 3e 53 65 63 74 69 6f 6e 20 31 3a e2 80 83 49 ">Section 1: I
0d40: 6e 74 72 6f 64 75 63 74 69 6f 6e 3c 2f 61 3e 0a ntroduction</a>.
0d50: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 </div>.<div clas
0d60: 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e 0a 3c s="tocindent">.<
0d70: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e div class="toc">
0d80: 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 .<a class="Link"
0d90: 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 href="#toc-Subs
0da0: 65 63 74 69 6f 6e 2d 31 2e 31 22 3e 53 75 62 73 ection-1.1">Subs
0db0: 65 63 74 69 6f 6e 20 31 2e 31 3a e2 80 83 4d 65 ection 1.1: Me
0dc0: 67 61 74 65 73 74 20 64 65 73 69 67 6e 20 70 68 gatest design ph
0dd0: 69 6c 6f 73 6f 70 68 79 3c 2f 61 3e 0a 3c 2f 64 ilosophy</a>.</d
0de0: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 iv>.<div class="
0df0: 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 toc">.<a class="
0e00: 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 Link" href="#toc
0e10: 2d 53 75 62 73 65 63 74 69 6f 6e 2d 31 2e 32 22 -Subsection-1.2"
0e20: 3e 53 75 62 73 65 63 74 69 6f 6e 20 31 2e 32 3a >Subsection 1.2:
0e30: e2 80 83 4d 65 67 61 74 65 73 74 20 61 72 63 68 Megatest arch
0e40: 69 74 65 63 74 75 72 65 3c 2f 61 3e 0a 3c 2f 64 itecture</a>.</d
0e50: 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 iv>.</div>.<div
0e60: 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 class="toc">.<a
0e70: 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 class="Link" hre
0e80: 66 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d f="#toc-Section-
0e90: 32 22 3e 53 65 63 74 69 6f 6e 20 32 3a e2 80 83 2">Section 2:
0ea0: 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 3c 2f 61 3e Installation</a>
0eb0: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
0ec0: 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e 0a ss="tocindent">.
0ed0: 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 <div class="toc"
0ee0: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b >.<a class="Link
0ef0: 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 " href="#toc-Sub
0f00: 73 65 63 74 69 6f 6e 2d 32 2e 31 22 3e 53 75 62 section-2.1">Sub
0f10: 73 65 63 74 69 6f 6e 20 32 2e 31 3a e2 80 83 44 section 2.1: D
0f20: 65 70 65 6e 64 65 6e 63 69 65 73 3c 2f 61 3e 0a ependencies</a>.
0f30: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 </div>.<div clas
0f40: 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 s="toc">.<a clas
0f50: 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 s="Link" href="#
0f60: 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 32 toc-Subsection-2
0f70: 2e 32 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 32 .2">Subsection 2
0f80: 2e 32 3a e2 80 83 42 75 69 6c 64 20 61 6e 64 20 .2: Build and
0f90: 49 6e 73 74 61 6c 6c 3c 2f 61 3e 0a 3c 2f 64 69 Install</a>.</di
0fa0: 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 v>.</div>.<div c
0fb0: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 lass="toc">.<a c
0fc0: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 lass="Link" href
0fd0: 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 33 ="#toc-Section-3
0fe0: 22 3e 53 65 63 74 69 6f 6e 20 33 3a e2 80 83 53 ">Section 3: S
0ff0: 65 74 75 70 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a etup</a>.</div>.
1000: 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 69 <div class="toci
1010: 6e 64 65 6e 74 22 3e 0a 3c 64 69 76 20 63 6c 61 ndent">.<div cla
1020: 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 ss="toc">.<a cla
1030: 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 ss="Link" href="
1040: 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d #toc-Subsection-
1050: 33 2e 31 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 3.1">Subsection
1060: 33 2e 31 3a e2 80 83 43 72 65 61 74 65 20 6d 65 3.1: Create me
1070: 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 3c 2f 61 gatest.config</a
1080: 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c >.</div>.<div cl
1090: 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c ass="toc">.<a cl
10a0: 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d ass="Link" href=
10b0: 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e "#toc-Subsection
10c0: 2d 33 2e 32 22 3e 53 75 62 73 65 63 74 69 6f 6e -3.2">Subsection
10d0: 20 33 2e 32 3a e2 80 83 43 72 65 61 74 65 20 72 3.2: Create r
10e0: 75 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 unconfigs.config
10f0: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 </a>.</div>.<div
1100: 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 class="toc">.<a
1110: 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 class="Link" hr
1120: 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 ef="#toc-Subsect
1130: 69 6f 6e 2d 33 2e 33 22 3e 53 75 62 73 65 63 74 ion-3.3">Subsect
1140: 69 6f 6e 20 33 2e 33 3a e2 80 83 43 72 65 61 74 ion 3.3: Creat
1150: 65 20 74 68 65 20 74 65 73 74 73 20 64 69 72 65 e the tests dire
1160: 63 74 6f 72 79 20 61 6e 64 20 79 6f 75 72 20 66 ctory and your f
1170: 69 72 73 74 20 74 65 73 74 3c 2f 61 3e 0a 3c 2f irst test</a>.</
1180: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
1190: 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d "toc">.<a class=
11a0: 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f "Link" href="#to
11b0: 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 33 2e 34 c-Subsection-3.4
11c0: 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 33 2e 34 ">Subsection 3.4
11d0: 3a e2 80 83 43 72 65 61 74 65 20 74 68 65 20 74 : Create the t
11e0: 65 73 74 63 6f 6e 66 69 67 20 66 69 6c 65 20 66 estconfig file f
11f0: 6f 72 20 79 6f 75 72 20 74 65 73 74 3c 2f 61 3e or your test</a>
1200: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
1210: 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 ss="toc">.<a cla
1220: 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 ss="Link" href="
1230: 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d #toc-Subsection-
1240: 33 2e 35 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 3.5">Subsection
1250: 33 2e 35 3a e2 80 83 43 72 65 61 74 65 20 79 6f 3.5: Create yo
1260: 75 72 20 74 65 73 74 20 72 75 6e 6e 69 6e 67 20 ur test running
1270: 73 63 72 69 70 74 2c 20 6d 61 69 6e 2e 73 68 3c script, main.sh<
1280: 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 /a>.</div>.<div
1290: 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 class="toc">.<a
12a0: 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 class="Link" hre
12b0: 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 f="#toc-Subsecti
12c0: 6f 6e 2d 33 2e 36 22 3e 53 75 62 73 65 63 74 69 on-3.6">Subsecti
12d0: 6f 6e 20 33 2e 36 3a e2 80 83 52 75 6e 20 6d 65 on 3.6: Run me
12e0: 67 61 74 65 73 74 20 61 6e 64 20 77 61 74 63 68 gatest and watch
12f0: 20 79 6f 75 72 20 72 75 6e 20 70 72 6f 67 72 65 your run progre
1300: 73 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f ss</a>.</div>.</
1310: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
1320: 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d "toc">.<a class=
1330: 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f "Link" href="#to
1340: 63 2d 53 65 63 74 69 6f 6e 2d 34 22 3e 53 65 63 c-Section-4">Sec
1350: 74 69 6f 6e 20 34 3a e2 80 83 43 68 6f 6f 73 65 tion 4: Choose
1360: 20 46 6c 6f 77 20 6f 72 20 55 6e 73 74 72 75 63 Flow or Unstruc
1370: 74 75 72 65 64 20 52 75 6e 3f 3c 2f 61 3e 0a 3c tured Run?</a>.<
1380: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
1390: 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 ="toc">.<a class
13a0: 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 ="Link" href="#t
13b0: 6f 63 2d 53 65 63 74 69 6f 6e 2d 35 22 3e 53 65 oc-Section-5">Se
13c0: 63 74 69 6f 6e 20 35 3a e2 80 83 48 6f 77 20 74 ction 5: How t
13d0: 6f 20 57 72 69 74 65 20 54 65 73 74 73 3c 2f 61 o Write Tests</a
13e0: 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c >.</div>.<div cl
13f0: 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e ass="tocindent">
1400: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 .<div class="toc
1410: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e ">.<a class="Lin
1420: 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 k" href="#toc-Su
1430: 62 73 65 63 74 69 6f 6e 2d 35 2e 31 22 3e 53 75 bsection-5.1">Su
1440: 62 73 65 63 74 69 6f 6e 20 35 2e 31 3a e2 80 83 bsection 5.1:
1450: 41 20 53 69 6d 70 6c 65 20 54 65 73 74 20 77 69 A Simple Test wi
1460: 74 68 20 6f 6e 65 20 53 74 65 70 3c 2f 61 3e 0a th one Step</a>.
1470: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 </div>.<div clas
1480: 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 s="toc">.<a clas
1490: 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 s="Link" href="#
14a0: 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 35 toc-Subsection-5
14b0: 2e 32 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 35 .2">Subsection 5
14c0: 2e 32 3a e2 80 83 43 72 65 61 74 65 20 79 6f 75 .2: Create you
14d0: 72 20 74 65 73 74 63 6f 6e 66 69 67 20 66 69 6c r testconfig fil
14e0: 65 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 e</a>.</div>.<di
14f0: 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c v class="toc">.<
1500: 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 a class="Link" h
1510: 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 ref="#toc-Subsec
1520: 74 69 6f 6e 2d 35 2e 33 22 3e 53 75 62 73 65 63 tion-5.3">Subsec
1530: 74 69 6f 6e 20 35 2e 33 3a e2 80 83 43 72 65 61 tion 5.3: Crea
1540: 74 65 20 74 68 65 20 6d 61 69 6e 2e 63 73 68 20 te the main.csh
1550: 73 63 72 69 70 74 3c 2f 61 3e 0a 3c 2f 64 69 76 script</a>.</div
1560: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f >.<div class="to
1570: 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 c">.<a class="Li
1580: 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 nk" href="#toc-S
1590: 75 62 73 65 63 74 69 6f 6e 2d 35 2e 34 22 3e 53 ubsection-5.4">S
15a0: 75 62 73 65 63 74 69 6f 6e 20 35 2e 34 3a e2 80 ubsection 5.4:
15b0: 83 53 69 6d 70 6c 65 20 54 65 73 74 20 77 69 74 Simple Test wit
15c0: 68 20 4d 75 6c 74 69 70 6c 65 20 53 74 65 70 73 h Multiple Steps
15d0: 20 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f 64 </a>.</div>.</d
15e0: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 iv>.<div class="
15f0: 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 toc">.<a class="
1600: 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 Link" href="#toc
1610: 2d 53 65 63 74 69 6f 6e 2d 36 22 3e 53 65 63 74 -Section-6">Sect
1620: 69 6f 6e 20 36 3a e2 80 83 53 69 6d 70 6c 65 20 ion 6: Simple
1630: 54 65 73 74 20 77 69 74 68 20 4d 75 6c 74 69 70 Test with Multip
1640: 6c 65 20 53 74 65 70 73 2c 20 53 6f 6d 65 20 69 le Steps, Some i
1650: 6e 20 50 61 72 61 6c 6c 65 6c 3c 2f 61 3e 0a 3c n Parallel</a>.<
1660: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
1670: 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e 0a 3c 64 ="tocindent">.<d
1680: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
1690: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
16a0: 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 href="#toc-Subse
16b0: 63 74 69 6f 6e 2d 36 2e 31 22 3e 53 75 62 73 65 ction-6.1">Subse
16c0: 63 74 69 6f 6e 20 36 2e 31 3a e2 80 83 54 68 65 ction 6.1: The
16d0: 20 4d 61 6b 65 66 69 6c 65 3c 2f 61 3e 0a 3c 2f Makefile</a>.</
16e0: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
16f0: 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d "toc">.<a class=
1700: 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f "Link" href="#to
1710: 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 36 2e 32 c-Subsection-6.2
1720: 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 36 2e 32 ">Subsection 6.2
1730: 3a e2 80 83 54 68 65 20 6d 61 69 6e 2e 63 73 68 : The main.csh
1740: 20 66 69 6c 65 3c 2f 61 3e 0a 3c 2f 64 69 76 3e file</a>.</div>
1750: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
1760: 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 ss="toc">.<a cla
1770: 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 ss="Link" href="
1780: 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 37 22 3e #toc-Section-7">
1790: 53 65 63 74 69 6f 6e 20 37 3a e2 80 83 53 69 6d Section 7: Sim
17a0: 70 6c 65 20 54 65 73 74 20 77 69 74 68 20 49 74 ple Test with It
17b0: 65 72 61 74 69 6f 6e 3c 2f 61 3e 0a 3c 2f 64 69 eration</a>.</di
17c0: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 v>.<div class="t
17d0: 6f 63 69 6e 64 65 6e 74 22 3e 0a 3c 64 69 76 20 ocindent">.<div
17e0: 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 class="toc">.<a
17f0: 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 class="Link" hre
1800: 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 f="#toc-Subsecti
1810: 6f 6e 2d 37 2e 31 22 3e 53 75 62 73 65 63 74 69 on-7.1">Subsecti
1820: 6f 6e 20 37 2e 31 3a e2 80 83 55 70 64 61 74 65 on 7.1: Update
1830: 20 79 6f 75 72 20 74 65 73 74 63 6f 6e 66 69 67 your testconfig
1840: 20 66 69 6c 65 20 66 6f 72 20 69 74 65 72 61 74 file for iterat
1850: 69 6f 6e 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c ion</a>.</div>.<
1860: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e div class="toc">
1870: 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 .<a class="Link"
1880: 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 href="#toc-Subs
1890: 65 63 74 69 6f 6e 2d 37 2e 32 22 3e 53 75 62 73 ection-7.2">Subs
18a0: 65 63 74 69 6f 6e 20 37 2e 32 3a e2 80 83 52 65 ection 7.2: Re
18b0: 77 72 69 74 65 20 79 6f 75 72 20 6d 61 69 6e 2e write your main.
18c0: 63 73 68 20 66 6f 72 20 69 74 65 72 61 74 69 6f csh for iteratio
18d0: 6e 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 n</a>.</div>.<di
18e0: 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c v class="toc">.<
18f0: 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 a class="Link" h
1900: 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 ref="#toc-Subsec
1910: 74 69 6f 6e 2d 37 2e 33 22 3e 53 75 62 73 65 63 tion-7.3">Subsec
1920: 74 69 6f 6e 20 37 2e 33 3a e2 80 83 54 65 73 74 tion 7.3: Test
1930: 73 20 77 69 74 68 20 49 6e 74 65 72 2d 74 65 73 s with Inter-tes
1940: 74 20 64 65 70 65 6e 64 65 6e 63 69 65 73 3c 2f t dependencies</
1950: 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 a>.</div>.<div c
1960: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 lass="toc">.<a c
1970: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 lass="Link" href
1980: 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f ="#toc-Subsectio
1990: 6e 2d 37 2e 34 22 3e 53 75 62 73 65 63 74 69 6f n-7.4">Subsectio
19a0: 6e 20 37 2e 34 3a e2 80 83 52 6f 6c 6c 69 6e 67 n 7.4: Rolling
19b0: 20 75 70 20 4d 69 73 63 65 6c 6c 61 6e 65 6f 75 up Miscellaneou
19c0: 73 20 44 61 74 61 3c 2f 61 3e 0a 3c 2f 64 69 76 s Data</a>.</div
19d0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f >.<div class="to
19e0: 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 c">.<a class="Li
19f0: 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 nk" href="#toc-S
1a00: 75 62 73 65 63 74 69 6f 6e 2d 37 2e 35 22 3e 53 ubsection-7.5">S
1a10: 75 62 73 65 63 74 69 6f 6e 20 37 2e 35 3a e2 80 ubsection 7.5:
1a20: 83 52 6f 6c 6c 69 6e 67 20 75 70 20 52 75 6e 73 Rolling up Runs
1a30: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f 64 69 </a>.</div>.</di
1a40: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 v>.<div class="t
1a50: 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c oc">.<a class="L
1a60: 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d ink" href="#toc-
1a70: 53 65 63 74 69 6f 6e 2d 38 22 3e 53 65 63 74 69 Section-8">Secti
1a80: 6f 6e 20 38 3a e2 80 83 44 61 73 68 62 6f 61 72 on 8: Dashboar
1a90: 64 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 d</a>.</div>.<di
1aa0: 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c v class="toc">.<
1ab0: 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 a class="Link" h
1ac0: 72 65 66 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f ref="#toc-Sectio
1ad0: 6e 2d 39 22 3e 53 65 63 74 69 6f 6e 20 39 3a e2 n-9">Section 9:
1ae0: 80 83 47 65 6e 65 72 61 74 69 6e 67 20 61 6e 20 Generating an
1af0: 4f 70 65 6e 44 6f 63 75 6d 65 6e 74 20 53 70 72 OpenDocument Spr
1b00: 65 61 64 73 68 65 65 74 20 66 72 6f 6d 20 74 68 eadsheet from th
1b10: 65 20 44 61 74 61 62 61 73 65 3c 2f 61 3e 0a 3c e Database</a>.<
1b20: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
1b30: 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 ="toc">.<a class
1b40: 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 ="Link" href="#t
1b50: 6f 63 2d 53 65 63 74 69 6f 6e 2d 31 30 22 3e 53 oc-Section-10">S
1b60: 65 63 74 69 6f 6e 20 31 30 3a e2 80 83 46 6c 6f ection 10: Flo
1b70: 77 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 ws</a>.</div>.<d
1b80: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
1b90: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
1ba0: 68 72 65 66 3d 22 23 74 6f 63 2d 53 65 63 74 69 href="#toc-Secti
1bb0: 6f 6e 2d 31 31 22 3e 53 65 63 74 69 6f 6e 20 31 on-11">Section 1
1bc0: 31 3a e2 80 83 46 6c 6f 77 20 53 70 65 63 69 66 1: Flow Specif
1bd0: 69 63 61 74 69 6f 6e 20 61 6e 64 20 52 75 6e 6e ication and Runn
1be0: 69 6e 67 20 28 4e 6f 74 20 72 65 6c 65 61 73 65 ing (Not release
1bf0: 64 20 79 65 74 29 3c 2f 61 3e 0a 3c 2f 64 69 76 d yet)</a>.</div
1c00: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f >.<div class="to
1c10: 63 69 6e 64 65 6e 74 22 3e 0a 3c 64 69 76 20 63 cindent">.<div c
1c20: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 lass="toc">.<a c
1c30: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 lass="Link" href
1c40: 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f ="#toc-Subsectio
1c50: 6e 2d 31 31 2e 31 22 3e 53 75 62 73 65 63 74 69 n-11.1">Subsecti
1c60: 6f 6e 20 31 31 2e 31 3a e2 80 83 57 72 69 74 65 on 11.1: Write
1c70: 20 79 6f 75 72 20 66 6c 6f 77 20 66 69 6c 65 3c your flow file<
1c80: 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 /a>.</div>.<div
1c90: 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 class="toc">.<a
1ca0: 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 class="Link" hre
1cb0: 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 f="#toc-Subsecti
1cc0: 6f 6e 2d 31 31 2e 32 22 3e 53 75 62 73 65 63 74 on-11.2">Subsect
1cd0: 69 6f 6e 20 31 31 2e 32 3a e2 80 83 52 75 6e 20 ion 11.2: Run
1ce0: 74 68 65 20 66 6c 6f 77 3c 2f 61 3e 0a 3c 2f 64 the flow</a>.</d
1cf0: 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 iv>.</div>.<div
1d00: 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 class="toc">.<a
1d10: 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 class="Link" hre
1d20: 66 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d f="#toc-Section-
1d30: 31 32 22 3e 53 65 63 74 69 6f 6e 20 31 32 3a e2 12">Section 12:
1d40: 80 83 4d 6f 6e 69 74 6f 72 20 62 61 73 65 64 20 Monitor based
1d50: 72 75 6e 6e 69 6e 67 3c 2f 61 3e 0a 3c 2f 64 69 running</a>.</di
1d60: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 v>.<div class="t
1d70: 6f 63 69 6e 64 65 6e 74 22 3e 0a 3c 64 69 76 20 ocindent">.<div
1d80: 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 class="toc">.<a
1d90: 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 class="Link" hre
1da0: 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 f="#toc-Subsecti
1db0: 6f 6e 2d 31 32 2e 31 22 3e 53 75 62 73 65 63 74 on-12.1">Subsect
1dc0: 69 6f 6e 20 31 32 2e 31 3a e2 80 83 4d 6f 6e 69 ion 12.1: Moni
1dd0: 74 6f 72 20 6c 6f 67 69 63 3c 2f 61 3e 0a 3c 2f tor logic</a>.</
1de0: 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 div>.</div>.<div
1df0: 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 class="toc">.<a
1e00: 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 class="Link" hr
1e10: 65 66 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e ef="#toc-Section
1e20: 2d 31 33 22 3e 53 65 63 74 69 6f 6e 20 31 33 3a -13">Section 13:
1e30: e2 80 83 52 65 66 65 72 65 6e 63 65 3c 2f 61 3e Reference</a>
1e40: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
1e50: 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e 0a ss="tocindent">.
1e60: 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 <div class="toc"
1e70: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b >.<a class="Link
1e80: 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 " href="#toc-Sub
1e90: 73 65 63 74 69 6f 6e 2d 31 33 2e 31 22 3e 53 75 section-13.1">Su
1ea0: 62 73 65 63 74 69 6f 6e 20 31 33 2e 31 3a e2 80 bsection 13.1:
1eb0: 83 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 66 Configuration f
1ec0: 69 6c 65 20 53 79 6e 74 61 78 3c 2f 61 3e 0a 3c ile Syntax</a>.<
1ed0: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
1ee0: 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e 0a 3c 64 ="tocindent">.<d
1ef0: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
1f00: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
1f10: 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 75 href="#toc-Subsu
1f20: 62 73 65 63 74 69 6f 6e 2d 31 33 2e 31 2e 31 22 bsection-13.1.1"
1f30: 3e 53 75 62 73 75 62 73 65 63 74 69 6f 6e 20 31 >Subsubsection 1
1f40: 33 2e 31 2e 31 3a e2 80 83 53 65 63 74 69 6f 6e 3.1.1: Section
1f50: 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 s</a>.</div>.<di
1f60: 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c v class="toc">.<
1f70: 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 a class="Link" h
1f80: 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 75 62 ref="#toc-Subsub
1f90: 73 65 63 74 69 6f 6e 2d 31 33 2e 31 2e 32 22 3e section-13.1.2">
1fa0: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 20 31 33 Subsubsection 13
1fb0: 2e 31 2e 32 3a e2 80 83 56 61 72 69 61 62 6c 65 .1.2: Variable
1fc0: 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 s</a>.</div>.<di
1fd0: 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c v class="toc">.<
1fe0: 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 a class="Link" h
1ff0: 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 75 62 ref="#toc-Subsub
2000: 73 65 63 74 69 6f 6e 2d 31 33 2e 31 2e 33 22 3e section-13.1.3">
2010: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 20 31 33 Subsubsection 13
2020: 2e 31 2e 33 3a e2 80 83 49 6e 63 6c 75 64 65 73 .1.3: Includes
2030: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 </a>.</div>.<div
2040: 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 class="toc">.<a
2050: 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 class="Link" hr
2060: 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 75 62 73 ef="#toc-Subsubs
2070: 65 63 74 69 6f 6e 2d 31 33 2e 31 2e 34 22 3e 53 ection-13.1.4">S
2080: 75 62 73 75 62 73 65 63 74 69 6f 6e 20 31 33 2e ubsubsection 13.
2090: 31 2e 34 3a e2 80 83 53 65 74 74 69 6e 67 20 61 1.4: Setting a
20a0: 20 76 61 72 69 61 62 6c 65 20 62 79 20 72 75 6e variable by run
20b0: 6e 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 3c 2f ning a command</
20c0: 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 a>.</div>.<div c
20d0: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 lass="toc">.<a c
20e0: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 lass="Link" href
20f0: 3d 22 23 74 6f 63 2d 53 75 62 73 75 62 73 65 63 ="#toc-Subsubsec
2100: 74 69 6f 6e 2d 31 33 2e 31 2e 35 22 3e 53 75 62 tion-13.1.5">Sub
2110: 73 75 62 73 65 63 74 69 6f 6e 20 31 33 2e 31 2e subsection 13.1.
2120: 35 3a e2 80 83 4e 6f 74 65 73 3c 2f 61 3e 0a 3c 5: Notes</a>.<
2130: 2f 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 /div>.</div>.<di
2140: 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c v class="toc">.<
2150: 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 a class="Link" h
2160: 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 ref="#toc-Subsec
2170: 74 69 6f 6e 2d 31 33 2e 32 22 3e 53 75 62 73 65 tion-13.2">Subse
2180: 63 74 69 6f 6e 20 31 33 2e 32 3a e2 80 83 45 6e ction 13.2: En
2190: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
21a0: 6c 65 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c les</a>.</div>.<
21b0: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e div class="toc">
21c0: 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 .<a class="Link"
21d0: 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 href="#toc-Subs
21e0: 65 63 74 69 6f 6e 2d 31 33 2e 33 22 3e 53 75 62 ection-13.3">Sub
21f0: 73 65 63 74 69 6f 6e 20 31 33 2e 33 3a e2 80 83 section 13.3:
2200: 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 3c megatest.config<
2210: 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 /a>.</div>.<div
2220: 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 class="toc">.<a
2230: 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 class="Link" hre
2240: 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 f="#toc-Subsecti
2250: 6f 6e 2d 31 33 2e 34 22 3e 53 75 62 73 65 63 74 on-13.4">Subsect
2260: 69 6f 6e 20 31 33 2e 34 3a e2 80 83 72 75 6e 63 ion 13.4: runc
2270: 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 20 66 69 onfigs.config fi
2280: 6c 65 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 le</a>.</div>.<d
2290: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
22a0: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
22b0: 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65 href="#toc-Subse
22c0: 63 74 69 6f 6e 2d 31 33 2e 35 22 3e 53 75 62 73 ction-13.5">Subs
22d0: 65 63 74 69 6f 6e 20 31 33 2e 35 3a e2 80 83 57 ection 13.5: W
22e0: 72 69 74 69 6e 67 20 74 65 73 74 73 3c 2f 61 3e riting tests</a>
22f0: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
2300: 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e 0a ss="tocindent">.
2310: 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 <div class="toc"
2320: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b >.<a class="Link
2330: 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 " href="#toc-Sub
2340: 73 75 62 73 65 63 74 69 6f 6e 2d 31 33 2e 35 2e subsection-13.5.
2350: 31 22 3e 53 75 62 73 75 62 73 65 63 74 69 6f 6e 1">Subsubsection
2360: 20 31 33 2e 35 2e 31 3a e2 80 83 74 65 73 74 63 13.5.1: testc
2370: 6f 6e 66 69 67 20 66 69 6c 65 3c 2f 61 3e 0a 3c onfig file</a>.<
2380: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
2390: 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 ="toc">.<a class
23a0: 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 ="Link" href="#t
23b0: 6f 63 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e oc-Subsubsection
23c0: 2d 31 33 2e 35 2e 32 22 3e 53 75 62 73 75 62 73 -13.5.2">Subsubs
23d0: 65 63 74 69 6f 6e 20 31 33 2e 35 2e 32 3a e2 80 ection 13.5.2:
23e0: 83 43 6f 6d 6d 61 6e 64 20 6c 69 6e 65 3c 2f 61 Command line</a
23f0: 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a >.</div>.</div>.
2400: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 </div>.<div clas
2410: 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 s="toc">.<a clas
2420: 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 s="Link" href="#
2430: 74 6f 63 2d 41 70 70 65 6e 64 69 78 2d 41 22 3e toc-Appendix-A">
2440: 41 70 70 65 6e 64 69 78 20 41 3a e2 80 83 44 61 Appendix A: Da
2450: 74 61 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 ta</a>.</div>.<d
2460: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a iv class="toc">.
2470: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 <a class="Link"
2480: 68 72 65 66 3d 22 23 74 6f 63 2d 41 70 70 65 6e href="#toc-Appen
2490: 64 69 78 2d 42 22 3e 41 70 70 65 6e 64 69 78 20 dix-B">Appendix
24a0: 42 3a e2 80 83 52 65 66 65 72 65 6e 63 65 73 3c B: References<
24b0: 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f 64 69 76 /a>.</div>.</div
24c0: 3e 0a 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 >..</div>..</div
24d0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
24e0: 61 6e 64 61 72 64 22 3e 0a 3c 70 3e 3c 62 72 2f andard">.<p><br/
24f0: 3e 0a 3c 2f 70 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c >.</p>..</div>.<
2500: 68 31 20 63 6c 61 73 73 3d 22 53 65 63 74 69 6f h1 class="Sectio
2510: 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f n">.<a class="to
2520: 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 65 63 c" name="toc-Sec
2530: 74 69 6f 6e 2d 31 22 3e 31 3c 2f 61 3e e2 80 83 tion-1">1</a>
2540: 49 6e 74 72 6f 64 75 63 74 69 6f 6e 0a 3c 2f 68 Introduction.</h
2550: 31 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 1>.<h2 class="Su
2560: 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c bsection">.<a cl
2570: 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 ass="toc" name="
2580: 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 31 toc-Subsection-1
2590: 2e 31 22 3e 31 2e 31 3c 2f 61 3e e2 80 83 4d 65 .1">1.1</a> Me
25a0: 67 61 74 65 73 74 20 64 65 73 69 67 6e 20 70 68 gatest design ph
25b0: 69 6c 6f 73 6f 70 68 79 0a 3c 2f 68 32 3e 0a 3c ilosophy.</h2>.<
25c0: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
25d0: 61 72 64 22 3e 0a 4d 65 67 61 74 65 73 74 20 69 ard">.Megatest i
25e0: 73 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 70 72 s intended to pr
25f0: 6f 76 69 64 65 20 74 68 65 20 6d 69 6e 69 6d 75 ovide the minimu
2600: 6d 20 6e 65 65 64 65 64 20 72 65 73 6f 75 72 63 m needed resourc
2610: 65 73 20 74 6f 20 6d 61 6b 65 20 77 72 69 74 69 es to make writi
2620: 6e 67 20 61 20 73 75 69 74 65 20 6f 66 20 74 65 ng a suite of te
2630: 73 74 73 20 61 6e 64 20 69 6d 70 6c 65 6d 65 6e sts and implemen
2640: 74 69 6e 67 20 63 6f 6e 74 69 6e 75 6f 75 73 20 ting continuous
2650: 62 75 69 6c 64 20 66 6f 72 20 73 6f 66 74 77 61 build for softwa
2660: 72 65 2c 20 64 65 73 69 67 6e 20 65 6e 67 69 6e re, design engin
2670: 65 65 72 69 6e 67 20 6f 72 20 70 72 6f 63 65 73 eering or proces
2680: 73 20 63 6f 6e 74 72 6f 6c 20 28 76 69 61 20 6f s control (via o
2690: 77 6c 66 73 20 66 6f 72 20 65 78 61 6d 70 6c 65 wlfs for example
26a0: 29 20 77 69 74 68 6f 75 74 20 62 65 69 6e 67 20 ) without being
26b0: 73 70 65 63 69 61 6c 69 7a 65 64 20 66 6f 72 20 specialized for
26c0: 61 6e 79 20 73 70 65 63 69 66 69 63 20 70 72 6f any specific pro
26d0: 62 6c 65 6d 20 73 70 61 63 65 2e 20 4d 65 67 61 blem space. Mega
26e0: 74 65 73 74 20 69 6e 20 6f 66 20 69 74 73 65 6c test in of itsel
26f0: 66 20 64 6f 65 73 20 6e 6f 74 20 6b 6e 6f 77 20 f does not know
2700: 77 68 61 74 20 63 6f 6e 73 74 69 74 75 74 65 73 what constitutes
2710: 20 61 20 50 41 53 53 20 6f 72 20 46 41 49 4c 20 a PASS or FAIL
2720: 6f 66 20 61 20 74 65 73 74 2e 20 49 6e 20 6d 6f of a test. In mo
2730: 73 74 20 63 61 73 65 73 20 6d 65 67 61 74 65 73 st cases megates
2740: 74 20 69 73 20 62 65 73 74 20 75 73 65 64 20 69 t is best used i
2750: 6e 20 63 6f 6e 6a 75 6e 63 74 69 6f 6e 20 77 69 n conjunction wi
2760: 74 68 20 6c 6f 67 70 72 6f 20 6f 72 20 61 20 73 th logpro or a s
2770: 69 6d 69 6c 61 72 20 74 6f 6f 6c 20 74 6f 20 70 imilar tool to p
2780: 61 72 73 65 2c 20 61 6e 61 6c 79 7a 65 20 61 6e arse, analyze an
2790: 64 20 64 65 63 69 64 65 20 6f 6e 20 74 68 65 20 d decide on the
27a0: 74 65 73 74 20 6f 75 74 63 6f 6d 65 2e 0a 3c 2f test outcome..</
27b0: 64 69 76 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 div>.<h2 class="
27c0: 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 Subsection">.<a
27d0: 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 class="toc" name
27e0: 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e ="toc-Subsection
27f0: 2d 31 2e 32 22 3e 31 2e 32 3c 2f 61 3e e2 80 83 -1.2">1.2</a>
2800: 4d 65 67 61 74 65 73 74 20 61 72 63 68 69 74 65 Megatest archite
2810: 63 74 75 72 65 0a 3c 2f 68 32 3e 0a 3c 64 69 76 cture.</h2>.<div
2820: 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 class="Standard
2830: 22 3e 0a 41 6c 6c 20 64 61 74 61 20 74 6f 20 73 ">.All data to s
2840: 70 65 63 69 66 79 20 74 68 65 20 74 65 73 74 73 pecify the tests
2850: 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 65 20 74 and configure t
2860: 68 65 20 73 79 73 74 65 6d 20 69 73 20 73 74 6f he system is sto
2870: 72 65 64 20 69 6e 20 70 6c 61 69 6e 20 74 65 78 red in plain tex
2880: 74 20 66 69 6c 65 73 2e 20 41 6c 6c 20 73 79 73 t files. All sys
2890: 74 65 6d 20 73 74 61 74 65 20 69 73 20 73 74 6f tem state is sto
28a0: 72 65 64 20 69 6e 20 61 6e 20 73 71 6c 69 74 65 red in an sqlite
28b0: 33 20 64 61 74 61 62 61 73 65 2e 20 54 65 73 74 3 database. Test
28c0: 73 20 61 72 65 20 6c 61 75 6e 63 68 65 64 20 75 s are launched u
28d0: 73 69 6e 67 20 74 68 65 20 6c 61 75 6e 63 68 69 sing the launchi
28e0: 6e 67 20 73 79 73 74 65 6d 20 61 76 61 69 6c 61 ng system availa
28f0: 62 6c 65 20 66 6f 72 20 74 68 65 20 64 69 73 74 ble for the dist
2900: 72 69 62 75 74 65 64 20 63 6f 6d 70 75 74 65 20 ributed compute
2910: 70 6c 61 74 66 6f 72 6d 20 69 6e 20 75 73 65 2e platform in use.
2920: 20 41 20 74 65 6d 70 6c 61 74 65 20 73 63 72 69 A template scri
2930: 70 74 20 69 73 20 70 72 6f 76 69 64 65 64 20 77 pt is provided w
2940: 68 69 63 68 20 63 61 6e 20 6c 61 75 6e 63 68 20 hich can launch
2950: 6a 6f 62 73 20 6f 6e 20 6c 6f 63 61 6c 20 61 6e jobs on local an
2960: 64 20 72 65 6d 6f 74 65 20 4c 69 6e 75 78 20 68 d remote Linux h
2970: 6f 73 74 73 2e 20 43 75 72 72 65 6e 74 6c 79 20 osts. Currently
2980: 6d 65 67 61 74 65 73 74 20 75 73 65 73 20 74 68 megatest uses th
2990: 65 20 6e 65 74 77 6f 72 6b 20 66 69 6c 65 73 79 e network filesy
29a0: 73 74 65 6d 20 74 6f 20 26 6c 64 71 75 6f 3b 63 stem to “c
29b0: 61 6c 6c 20 68 6f 6d 65 26 72 64 71 75 6f 3b 20 all home”
29c0: 74 6f 20 79 6f 75 72 20 6d 61 73 74 65 72 20 73 to your master s
29d0: 71 6c 69 74 65 33 20 64 61 74 61 62 61 73 65 2e qlite3 database.
29e0: 0a 3c 2f 64 69 76 3e 0a 3c 68 31 20 63 6c 61 73 .</div>.<h1 clas
29f0: 73 3d 22 53 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 s="Section">.<a
2a00: 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 class="toc" name
2a10: 3d 22 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 32 22 ="toc-Section-2"
2a20: 3e 32 3c 2f 61 3e e2 80 83 49 6e 73 74 61 6c 6c >2</a> Install
2a30: 61 74 69 6f 6e 0a 3c 2f 68 31 3e 0a 3c 68 32 20 ation.</h1>.<h2
2a40: 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f class="Subsectio
2a50: 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f n">.<a class="to
2a60: 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 c" name="toc-Sub
2a70: 73 65 63 74 69 6f 6e 2d 32 2e 31 22 3e 32 2e 31 section-2.1">2.1
2a80: 3c 2f 61 3e e2 80 83 44 65 70 65 6e 64 65 6e 63 </a> Dependenc
2a90: 69 65 73 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 ies.</h2>.<div c
2aa0: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
2ab0: 0a 43 68 69 63 6b 65 6e 20 73 63 68 65 6d 65 20 .Chicken scheme
2ac0: 61 6e 64 20 61 20 6e 75 6d 62 65 72 20 6f 66 20 and a number of
2ad0: 26 6c 64 71 75 6f 3b 65 67 67 73 26 72 64 71 75 “eggs&rdqu
2ae0: 6f 3b 20 61 72 65 20 72 65 71 75 69 72 65 64 20 o; are required
2af0: 66 6f 72 20 62 75 69 6c 64 69 6e 67 20 6d 65 67 for building meg
2b00: 61 74 65 73 74 2e 20 53 65 65 20 74 68 65 20 66 atest. See the f
2b10: 69 6c 65 20 75 74 69 6c 73 2f 69 6e 73 74 61 6c ile utils/instal
2b20: 6c 61 6c 6c 2e 73 68 20 66 6f 72 20 61 6e 20 61 lall.sh for an a
2b30: 75 74 6f 6d 61 74 65 64 20 77 61 79 20 74 6f 20 utomated way to
2b40: 69 6e 73 74 61 6c 6c 20 74 68 65 20 64 65 70 65 install the depe
2b50: 6e 64 65 6e 63 69 65 73 20 6f 6e 20 4c 69 6e 75 ndencies on Linu
2b60: 78 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c x..</div>.<h2 cl
2b70: 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 ass="Subsection"
2b80: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 >.<a class="toc"
2b90: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 name="toc-Subse
2ba0: 63 74 69 6f 6e 2d 32 2e 32 22 3e 32 2e 32 3c 2f ction-2.2">2.2</
2bb0: 61 3e e2 80 83 42 75 69 6c 64 20 61 6e 64 20 49 a> Build and I
2bc0: 6e 73 74 61 6c 6c 0a 3c 2f 68 32 3e 0a 3c 64 69 nstall.</h2>.<di
2bd0: 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 v class="Standar
2be0: 64 22 3e 0a 52 75 6e 20 e2 80 9c 6d 61 6b 65 20 d">.Run “make
2bf0: 74 65 73 74 e2 80 9d 20 74 6f 20 63 72 65 61 74 test” to creat
2c00: 65 20 74 68 65 20 6d 65 67 61 74 65 73 74 20 65 e the megatest e
2c10: 78 65 63 75 74 61 62 6c 65 2e 20 59 6f 75 20 6d xecutable. You m
2c20: 61 79 20 77 69 73 68 20 74 6f 20 63 6f 70 79 20 ay wish to copy
2c30: 74 68 65 20 65 78 65 63 75 74 61 62 6c 65 20 74 the executable t
2c40: 6f 20 61 20 63 65 6e 74 72 61 6c 6c 79 20 61 63 o a centrally ac
2c50: 63 65 73 73 69 62 6c 65 20 6c 6f 63 61 74 69 6f cessible locatio
2c60: 6e 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 31 20 63 6c n..</div>.<h1 cl
2c70: 61 73 73 3d 22 53 65 63 74 69 6f 6e 22 3e 0a 3c ass="Section">.<
2c80: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
2c90: 6d 65 3d 22 74 6f 63 2d 53 65 63 74 69 6f 6e 2d me="toc-Section-
2ca0: 33 22 3e 33 3c 2f 61 3e e2 80 83 53 65 74 75 70 3">3</a> Setup
2cb0: 0a 3c 2f 68 31 3e 0a 3c 68 32 20 63 6c 61 73 73 .</h1>.<h2 class
2cc0: 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c ="Subsection">.<
2cd0: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
2ce0: 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 me="toc-Subsecti
2cf0: 6f 6e 2d 33 2e 31 22 3e 33 2e 31 3c 2f 61 3e e2 on-3.1">3.1</a>
2d00: 80 83 43 72 65 61 74 65 20 6d 65 67 61 74 65 73 Create megates
2d10: 74 2e 63 6f 6e 66 69 67 0a 3c 2f 68 32 3e 0a 3c t.config.</h2>.<
2d20: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
2d30: 61 72 64 22 3e 0a 43 72 65 61 74 65 20 74 68 65 ard">.Create the
2d40: 20 66 69 6c 65 20 6d 65 67 61 74 65 73 74 2e 63 file megatest.c
2d50: 6f 6e 66 69 67 20 75 73 69 6e 67 20 74 68 65 20 onfig using the
2d60: 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 20 megatest.config
2d70: 74 65 6d 70 6c 61 74 65 20 66 72 6f 6d 20 74 68 template from th
2d80: 65 20 74 65 73 74 73 20 64 69 72 65 63 74 6f 72 e tests director
2d90: 79 2e 20 41 74 20 61 20 6d 69 6e 69 6d 75 6d 20 y. At a minimum
2da0: 79 6f 75 20 6e 65 65 64 20 74 68 65 20 66 6f 6c you need the fol
2db0: 6c 6f 77 69 6e 67 3a 0a 3c 2f 64 69 76 3e 0a 3c lowing:.</div>.<
2dc0: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
2dd0: 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 ard">.<div class
2de0: 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 ="listing">.<pre
2df0: 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 class="listing"
2e00: 3e 23 20 46 69 65 6c 64 73 20 61 72 65 20 74 68 ># Fields are th
2e10: 65 20 6b 65 79 73 20 75 6e 64 65 72 20 77 68 69 e keys under whi
2e20: 63 68 20 79 6f 75 72 20 74 65 73 74 20 72 75 6e ch your test run
2e30: 73 20 61 72 65 20 6f 72 67 61 6e 69 7a 65 64 0a s are organized.
2e40: 5b 66 69 65 6c 64 73 5d 0a 66 69 65 6c 64 31 20 [fields].field1
2e50: 54 45 58 54 0a 66 69 65 6c 64 32 20 54 45 58 54 TEXT.field2 TEXT
2e60: 0a e2 80 8b 0a 5b 6a 6f 62 74 6f 6f 6c 73 5d 0a ..[jobtools].
2e70: 23 20 54 68 65 20 6c 61 75 6e 63 68 65 72 20 6c # The launcher l
2e80: 61 75 6e 63 68 65 73 20 6a 6f 62 73 20 74 6f 20 aunches jobs to
2e90: 74 68 65 20 6c 6f 63 61 6c 20 6f 72 20 72 65 6d the local or rem
2ea0: 6f 74 65 20 68 6f 73 74 73 2c 0a 23 20 74 68 65 ote hosts,.# the
2eb0: 20 6a 6f 62 20 69 73 20 6d 61 6e 61 67 65 64 20 job is managed
2ec0: 6f 6e 20 74 68 65 20 74 61 72 67 65 74 20 68 6f on the target ho
2ed0: 73 74 20 62 79 20 6d 65 67 61 74 65 73 74 2c 0a st by megatest,.
2ee0: 23 20 63 6f 6d 6d 65 6e 74 20 6f 75 74 20 6c 61 # comment out la
2ef0: 75 6e 63 68 65 72 20 74 6f 20 72 75 6e 20 6c 6f uncher to run lo
2f00: 63 61 6c 20 6f 6e 6c 79 2e 20 41 6e 20 65 78 61 cal only. An exa
2f10: 6d 70 6c 65 20 6c 61 75 6e 63 68 65 72 0a 23 20 mple launcher.#
2f20: 22 6e 62 66 61 6b 65 22 20 63 61 6e 20 62 65 20 "nbfake" can be
2f30: 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 75 74 69 found in the uti
2f40: 6c 73 20 64 69 72 65 63 74 6f 72 79 2e 20 0a 6c ls directory. .l
2f50: 61 75 6e 63 68 65 72 20 6e 62 66 61 6b 65 0a e2 auncher nbfake.
2f60: 80 8b 0a 23 20 54 68 65 20 64 69 73 6b 73 20 73 .# The disks s
2f70: 65 63 74 69 6f 6e 20 73 70 65 63 69 66 69 65 73 ection specifies
2f80: 20 77 68 65 72 65 20 74 68 65 20 74 65 73 74 73 where the tests
2f90: 20 77 69 6c 6c 20 62 65 20 72 75 6e 2e 20 41 73 will be run. As
2fa0: 20 79 6f 75 0a 23 20 72 75 6e 20 6f 75 74 20 6f you.# run out o
2fb0: 66 20 73 70 61 63 65 20 69 6e 20 61 20 70 61 72 f space in a par
2fc0: 74 69 74 69 6f 6e 20 79 6f 75 20 63 61 6e 20 61 tition you can a
2fd0: 64 64 20 61 64 64 69 74 69 6f 6e 61 6c 20 64 69 dd additional di
2fe0: 73 6b 73 0a 23 20 65 6e 74 72 69 65 73 2e 0a 23 sks.# entries..#
2ff0: 20 46 6f 72 6d 61 74 20 69 73 3a 0a 23 20 6e 61 Format is:.# na
3000: 6d 65 20 2f 70 61 74 68 2f 74 6f 2f 61 72 65 61 me /path/to/area
3010: 20 0a 5b 64 69 73 6b 73 5d 0a 64 69 73 6b 31 20 .[disks].disk1
3020: 2f 74 6d 70 20 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 /tmp .</pre>.</d
3030: 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 iv>..</div>.<h2
3040: 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f class="Subsectio
3050: 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f n">.<a class="to
3060: 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 c" name="toc-Sub
3070: 73 65 63 74 69 6f 6e 2d 33 2e 32 22 3e 33 2e 32 section-3.2">3.2
3080: 3c 2f 61 3e e2 80 83 43 72 65 61 74 65 20 72 75 </a> Create ru
3090: 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 0a nconfigs.config.
30a0: 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 </h2>.<div class
30b0: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 54 68 69 ="Standard">.Thi
30c0: 73 20 66 69 6c 65 20 69 73 20 75 73 65 64 20 74 s file is used t
30d0: 6f 20 73 65 74 20 65 6e 76 69 72 6f 6e 6d 65 6e o set environmen
30e0: 74 20 76 61 72 69 61 62 6c 65 73 20 74 68 61 74 t variables that
30f0: 20 61 72 65 20 72 75 6e 20 73 70 65 63 69 66 69 are run specifi
3100: 63 2e 20 59 6f 75 20 63 61 6e 20 73 69 6d 70 6c c. You can simpl
3110: 79 20 63 72 65 61 74 65 20 61 6e 20 65 6d 70 74 y create an empt
3120: 79 20 66 69 6c 65 20 74 6f 20 73 74 61 72 74 2e y file to start.
3130: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
3140: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c ss="Standard">.<
3150: 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 div class="listi
3160: 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 3d ng">.<pre class=
3170: 22 6c 69 73 74 69 6e 67 22 3e 23 20 72 75 6e 63 "listing"># runc
3180: 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 0a 3c 2f onfigs.config.</
3190: 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 pre>.</div>..</d
31a0: 69 76 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 iv>.<h2 class="S
31b0: 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 ubsection">.<a c
31c0: 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d lass="toc" name=
31d0: 22 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d "toc-Subsection-
31e0: 33 2e 33 22 3e 33 2e 33 3c 2f 61 3e e2 80 83 43 3.3">3.3</a> C
31f0: 72 65 61 74 65 20 74 68 65 20 74 65 73 74 73 20 reate the tests
3200: 64 69 72 65 63 74 6f 72 79 20 61 6e 64 20 79 6f directory and yo
3210: 75 72 20 66 69 72 73 74 20 74 65 73 74 0a 3c 2f ur first test.</
3220: 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 h2>.<div class="
3230: 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 Standard">.<div
3240: 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e class="listing">
3250: 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 .<pre class="lis
3260: 74 69 6e 67 22 3e 2e 2e 2f 74 65 73 74 73 0a 20 ting">../tests.
3270: 20 e2 94 9c e2 94 80 e2 94 80 20 6d 65 67 61 74 ├── megat
3280: 65 73 74 2e 63 6f 6e 66 69 67 0a 20 20 e2 94 9c est.config. ├
3290: e2 94 80 e2 94 80 20 72 75 6e 63 6f 6e 66 69 67 ── runconfig
32a0: 73 2e 63 6f 6e 66 69 67 0a 20 20 e2 94 94 e2 94 s.config. └
32b0: 80 e2 94 80 20 74 65 73 74 73 0a 20 20 20 20 20 ─ tests.
32c0: e2 94 94 e2 94 80 e2 94 80 20 6d 79 74 65 73 74 └── mytest
32d0: 0a 20 20 20 20 20 20 20 20 20 20 20 e2 94 9c e2 . ├
32e0: 94 80 e2 94 80 20 6d 61 69 6e 2e 73 68 0a 20 20 ─ main.sh.
32f0: 20 20 20 20 20 20 20 20 20 e2 94 94 e2 94 80 e2 └─
3300: 94 80 20 74 65 73 74 63 6f 6e 66 69 67 0a 3c 2f testconfig.</
3310: 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 pre>.</div>..</d
3320: 69 76 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 iv>.<h2 class="S
3330: 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 ubsection">.<a c
3340: 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d lass="toc" name=
3350: 22 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d "toc-Subsection-
3360: 33 2e 34 22 3e 33 2e 34 3c 2f 61 3e e2 80 83 43 3.4">3.4</a> C
3370: 72 65 61 74 65 20 74 68 65 20 74 65 73 74 63 6f reate the testco
3380: 6e 66 69 67 20 66 69 6c 65 20 66 6f 72 20 79 6f nfig file for yo
3390: 75 72 20 74 65 73 74 0a 3c 2f 68 32 3e 0a 3c 64 ur test.</h2>.<d
33a0: 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 iv class="Standa
33b0: 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d rd">.<div class=
33c0: 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 "listing">.<pre
33d0: 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e class="listing">
33e0: 5b 73 65 74 75 70 5d 0a 72 75 6e 73 63 72 69 70 [setup].runscrip
33f0: 74 20 6d 61 69 6e 2e 73 68 0a 3c 2f 70 72 65 3e t main.sh.</pre>
3400: 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a .</div>..</div>.
3410: 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 73 65 <h2 class="Subse
3420: 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 ction">.<a class
3430: 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 ="toc" name="toc
3440: 2d 53 75 62 73 65 63 74 69 6f 6e 2d 33 2e 35 22 -Subsection-3.5"
3450: 3e 33 2e 35 3c 2f 61 3e e2 80 83 43 72 65 61 74 >3.5</a> Creat
3460: 65 20 79 6f 75 72 20 74 65 73 74 20 72 75 6e 6e e your test runn
3470: 69 6e 67 20 73 63 72 69 70 74 2c 20 6d 61 69 6e ing script, main
3480: 2e 73 68 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 .sh.</h2>.<div c
3490: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
34a0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 .<div class="lis
34b0: 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 ting">.<pre clas
34c0: 73 3d 22 6c 69 73 74 69 6e 67 22 3e 23 21 2f 62 s="listing">#!/b
34d0: 69 6e 2f 62 61 73 68 0a e2 80 8b 0a 24 4d 54 5f in/bash..$MT_
34e0: 4d 45 47 41 54 45 53 54 20 2d 72 75 6e 73 74 65 MEGATEST -runste
34f0: 70 20 6d 79 73 74 65 70 31 20 22 73 6c 65 65 70 p mystep1 "sleep
3500: 20 32 30 3b 65 63 68 6f 20 44 6f 6e 65 22 20 2d 20;echo Done" -
3510: 6d 20 22 6d 79 73 74 65 70 31 20 69 73 20 64 6f m "mystep1 is do
3520: 6e 65 22 0a 24 4d 54 5f 4d 45 47 41 54 45 53 54 ne".$MT_MEGATEST
3530: 20 2d 74 65 73 74 2d 73 74 61 74 75 73 20 3a 73 -test-status :s
3540: 74 61 74 65 20 43 4f 4d 50 4c 45 54 45 44 20 3a tate COMPLETED :
3550: 73 74 61 74 75 73 20 50 41 53 53 20 2d 6d 20 22 status PASS -m "
3560: 54 68 69 73 20 69 73 20 61 20 63 6f 6d 6d 65 6e This is a commen
3570: 74 22 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e t".</pre>.</div>
3580: 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 ..</div>.<h2 cla
3590: 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e ss="Subsection">
35a0: 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 .<a class="toc"
35b0: 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 name="toc-Subsec
35c0: 74 69 6f 6e 2d 33 2e 36 22 3e 33 2e 36 3c 2f 61 tion-3.6">3.6</a
35d0: 3e e2 80 83 52 75 6e 20 6d 65 67 61 74 65 73 74 > Run megatest
35e0: 20 61 6e 64 20 77 61 74 63 68 20 79 6f 75 72 20 and watch your
35f0: 72 75 6e 20 70 72 6f 67 72 65 73 73 0a 3c 2f 68 run progress.</h
3600: 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 2>.<div class="S
3610: 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 63 tandard">.<div c
3620: 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a lass="listing">.
3630: 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 <pre class="list
3640: 69 6e 67 22 3e 6d 65 67 61 74 65 73 74 20 3a 66 ing">megatest :f
3650: 69 65 6c 64 31 20 61 62 63 20 3a 66 69 65 6c 64 ield1 abc :field
3660: 32 20 64 65 66 20 3a 72 75 6e 6e 61 6d 65 20 32 2 def :runname 2
3670: 30 31 31 77 65 65 6b 30 38 2e 34 61 20 2d 72 75 011week08.4a -ru
3680: 6e 61 6c 6c 0a e2 80 8b 0a 77 61 74 63 68 20 6d nall..watch m
3690: 65 67 61 74 65 73 74 20 2d 6c 69 73 74 2d 72 75 egatest -list-ru
36a0: 6e 73 20 25 0a e2 80 8b 0a 23 20 4f 52 20 75 73 ns %..# OR us
36b0: 65 20 74 68 65 20 64 61 73 68 62 6f 61 72 64 0a e the dashboard.
36c0: e2 80 8b 0a 64 61 73 68 62 6f 61 72 64 20 26 61 .dashboard &a
36d0: 6d 70 3b 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 mp;.</pre>.</div
36e0: 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 31 20 63 6c >..</div>.<h1 cl
36f0: 61 73 73 3d 22 53 65 63 74 69 6f 6e 22 3e 0a 3c ass="Section">.<
3700: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 a class="toc" na
3710: 6d 65 3d 22 74 6f 63 2d 53 65 63 74 69 6f 6e 2d me="toc-Section-
3720: 34 22 3e 34 3c 2f 61 3e e2 80 83 43 68 6f 6f 73 4">4</a> Choos
3730: 65 20 46 6c 6f 77 20 6f 72 20 55 6e 73 74 72 75 e Flow or Unstru
3740: 63 74 75 72 65 64 20 52 75 6e 3f 0a 3c 2f 68 31 ctured Run?.</h1
3750: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
3760: 61 6e 64 61 72 64 22 3e 0a 41 20 66 6c 6f 77 20 andard">.A flow
3770: 69 73 20 61 20 73 74 72 75 63 74 75 72 65 64 20 is a structured
3780: 61 6e 64 20 73 70 65 63 69 66 69 63 61 6c 6c 79 and specifically
3790: 20 73 65 71 75 65 6e 63 65 64 20 73 65 74 20 6f sequenced set o
37a0: 66 20 74 65 73 74 73 2e 20 53 65 65 20 74 68 65 f tests. See the
37b0: 20 46 6c 6f 77 73 20 63 68 61 70 74 65 72 20 74 Flows chapter t
37c0: 6f 20 75 6e 64 65 72 73 74 61 6e 64 20 74 68 65 o understand the
37d0: 20 64 69 66 66 65 72 65 6e 63 65 2e 0a 3c 2f 64 difference..</d
37e0: 69 76 3e 0a 3c 68 31 20 63 6c 61 73 73 3d 22 53 iv>.<h1 class="S
37f0: 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 ection">.<a clas
3800: 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f s="toc" name="to
3810: 63 2d 53 65 63 74 69 6f 6e 2d 35 22 3e 35 3c 2f c-Section-5">5</
3820: 61 3e e2 80 83 48 6f 77 20 74 6f 20 57 72 69 74 a> How to Writ
3830: 65 20 54 65 73 74 73 0a 3c 2f 68 31 3e 0a 3c 68 e Tests.</h1>.<h
3840: 32 20 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 2 class="Subsect
3850: 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 ion">.<a class="
3860: 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 toc" name="toc-S
3870: 75 62 73 65 63 74 69 6f 6e 2d 35 2e 31 22 3e 35 ubsection-5.1">5
3880: 2e 31 3c 2f 61 3e e2 80 83 41 20 53 69 6d 70 6c .1</a> A Simpl
3890: 65 20 54 65 73 74 20 77 69 74 68 20 6f 6e 65 20 e Test with one
38a0: 53 74 65 70 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 Step.</h2>.<div
38b0: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
38c0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 >.<div class="li
38d0: 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 sting">.<pre cla
38e0: 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 6d 6b 64 ss="listing">mkd
38f0: 69 72 20 73 69 6d 70 6c 65 74 65 73 74 0a 63 64 ir simpletest.cd
3900: 20 73 69 6d 70 6c 65 74 65 73 74 0a 3c 2f 70 72 simpletest.</pr
3910: 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 e>.</div>..</div
3920: 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 >.<h2 class="Sub
3930: 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 section">.<a cla
3940: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
3950: 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 35 2e oc-Subsection-5.
3960: 32 22 3e 35 2e 32 3c 2f 61 3e e2 80 83 43 72 65 2">5.2</a> Cre
3970: 61 74 65 20 79 6f 75 72 20 74 65 73 74 63 6f 6e ate your testcon
3980: 66 69 67 20 66 69 6c 65 0a 3c 2f 68 32 3e 0a 3c fig file.</h2>.<
3990: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
39a0: 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 ard">.<div class
39b0: 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 ="listing">.<pre
39c0: 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 class="listing"
39d0: 3e 23 20 74 65 73 74 63 6f 6e 66 69 67 0a e2 80 ># testconfig.
39e0: 8b 0a 5b 73 65 74 75 70 5d 0a 72 75 6e 73 63 72 .[setup].runscr
39f0: 69 70 74 20 6d 61 69 6e 2e 63 73 68 0a 3c 2f 70 ipt main.csh.</p
3a00: 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 re>.</div>..</di
3a10: 76 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 v>.<h2 class="Su
3a20: 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c bsection">.<a cl
3a30: 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 ass="toc" name="
3a40: 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 35 toc-Subsection-5
3a50: 2e 33 22 3e 35 2e 33 3c 2f 61 3e e2 80 83 43 72 .3">5.3</a> Cr
3a60: 65 61 74 65 20 74 68 65 20 6d 61 69 6e 2e 63 73 eate the main.cs
3a70: 68 20 73 63 72 69 70 74 0a 3c 2f 68 32 3e 0a 3c h script.</h2>.<
3a80: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
3a90: 61 72 64 22 3e 0a 4e 6f 74 65 3a 20 55 73 69 6e ard">.Note: Usin
3aa0: 67 20 63 73 68 20 69 73 20 4e 4f 54 20 72 65 63 g csh is NOT rec
3ab0: 6f 6d 6d 65 6e 64 65 64 2e 20 55 73 65 20 62 61 ommended. Use ba
3ac0: 73 68 2c 20 70 65 72 6c 2c 20 72 75 62 79 2c 20 sh, perl, ruby,
3ad0: 7a 73 68 20 6f 72 20 61 6e 79 74 68 69 6e 67 20 zsh or anything
3ae0: 6f 74 68 65 72 20 74 68 61 6e 20 63 73 68 2e 20 other than csh.
3af0: 57 65 20 75 73 65 20 63 73 68 20 68 65 72 65 20 We use csh here
3b00: 62 65 63 61 75 73 65 20 69 74 20 69 73 20 70 6f because it is po
3b10: 70 75 6c 61 72 20 69 6e 20 74 68 65 20 45 44 41 pular in the EDA
3b20: 20 69 6e 64 75 73 74 72 79 20 66 6f 72 20 77 68 industry for wh
3b30: 69 63 68 20 4d 65 67 61 74 65 73 74 20 77 61 73 ich Megatest was
3b40: 20 6f 72 69 67 69 6e 61 6c 6c 79 20 63 72 65 61 originally crea
3b50: 74 65 64 2e 20 0a 3c 2f 64 69 76 3e 0a 3c 64 69 ted. .</div>.<di
3b60: 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 v class="Standar
3b70: 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 d">.<div class="
3b80: 6c 65 66 74 22 3e 0a 3c 64 69 76 20 63 6c 61 73 left">.<div clas
3b90: 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 s="listing">.<pr
3ba0: 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 e class="listing
3bb0: 22 3e 23 21 2f 62 69 6e 2f 74 63 73 68 20 2d 78 ">#!/bin/tcsh -x
3bc0: 0a e2 80 8b 0a 23 20 72 75 6e 20 74 68 65 20 63 ..# run the c
3bd0: 70 75 31 20 73 69 6d 75 6c 61 74 69 6f 6e 2e 0a pu1 simulation..
3be0: 23 20 20 20 54 68 65 20 73 74 65 70 20 6e 61 6d # The step nam
3bf0: 65 20 69 73 20 22 72 75 6e 5f 73 69 6d 75 6c 61 e is "run_simula
3c00: 74 69 6f 6e 22 0a 23 20 20 20 54 68 65 20 63 6f tion".# The co
3c10: 6d 6d 61 6e 64 6c 69 6e 65 20 62 65 69 6e 67 20 mmandline being
3c20: 72 75 6e 20 66 6f 72 20 74 68 69 73 20 73 74 65 run for this ste
3c30: 70 20 69 73 20 22 72 75 6e 73 69 6d 20 63 70 75 p is "runsim cpu
3c40: 31 22 0a 23 20 20 20 54 68 65 20 6c 6f 67 70 72 1".# The logpr
3c50: 6f 20 66 69 6c 65 20 74 6f 20 76 61 6c 69 64 61 o file to valida
3c60: 74 65 20 74 68 65 20 6f 75 74 70 75 74 20 66 72 te the output fr
3c70: 6f 6d 20 74 68 65 20 72 75 6e 20 69 73 20 22 72 om the run is "r
3c80: 75 6e 73 69 6d 2e 6c 6f 67 70 72 6f 22 0a e2 80 unsim.logpro".
3c90: 8b 0a 24 4d 54 5f 4d 45 47 41 54 45 53 54 20 2d .$MT_MEGATEST -
3ca0: 72 75 6e 73 74 65 70 20 72 75 6e 5f 73 69 6d 75 runstep run_simu
3cb0: 6c 61 74 69 6f 6e 20 2d 6c 6f 67 70 72 6f 20 72 lation -logpro r
3cc0: 75 6e 73 69 6d 2e 6c 6f 67 70 72 6f 20 22 72 75 unsim.logpro "ru
3cd0: 6e 73 69 6d 20 63 70 75 31 22 0a 24 4d 54 5f 4d nsim cpu1".$MT_M
3ce0: 45 47 41 54 45 53 54 20 2d 74 65 73 74 2d 73 74 EGATEST -test-st
3cf0: 61 74 75 73 20 3a 73 74 61 74 65 20 43 4f 4d 50 atus :state COMP
3d00: 4c 45 54 45 44 20 3a 73 74 61 74 75 73 20 24 3f LETED :status $?
3d10: 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a .</pre>.</div>..
3d20: 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c </div>..</div>.<
3d30: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
3d40: 61 72 64 22 3e 0a 59 6f 75 20 63 61 6e 20 6e 6f ard">.You can no
3d50: 77 20 72 75 6e 20 6d 65 67 61 74 65 73 74 20 61 w run megatest a
3d60: 6e 64 20 74 68 65 20 63 72 65 61 74 65 64 20 74 nd the created t
3d70: 65 73 74 20 64 69 72 65 63 74 6f 72 79 20 77 69 est directory wi
3d80: 6c 6c 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 6e ll contain the n
3d90: 65 77 20 66 69 6c 65 73 20 e2 80 9c 72 75 6e 5f ew files “run_
3da0: 73 69 6d 75 6c 61 74 69 6f 6e 2e 68 74 6d 6c e2 simulation.html
3db0: 80 9d 20 61 6e 64 20 e2 80 9c 72 75 6e 5f 73 69 and “run_si
3dc0: 6d 75 6c 61 74 69 6f 6e 2e 6c 6f 67 e2 80 9d 2e mulation.log”.
3dd0: 20 49 66 20 79 6f 75 20 61 72 65 20 75 73 69 6e If you are usin
3de0: 67 20 74 68 65 20 64 61 73 68 62 6f 61 72 64 20 g the dashboard
3df0: 79 6f 75 20 63 61 6e 20 63 6c 69 63 6b 20 6f 6e you can click on
3e00: 20 74 68 65 20 72 75 6e 20 61 6e 64 20 74 68 65 the run and the
3e10: 6e 20 70 75 73 68 20 74 68 65 20 e2 80 9c 56 69 n push the “Vi
3e20: 65 77 20 6c 6f 67 e2 80 9d 20 62 75 74 74 6f 6e ew log” button
3e30: 20 74 6f 20 76 69 65 77 20 74 68 65 20 6c 6f 67 to view the log
3e40: 20 66 69 6c 65 20 69 6e 20 66 69 72 65 66 6f 78 file in firefox
3e50: 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 ..</div>.<h2 cla
3e60: 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e ss="Subsection">
3e70: 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 .<a class="toc"
3e80: 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 name="toc-Subsec
3e90: 74 69 6f 6e 2d 35 2e 34 22 3e 35 2e 34 3c 2f 61 tion-5.4">5.4</a
3ea0: 3e e2 80 83 53 69 6d 70 6c 65 20 54 65 73 74 20 > Simple Test
3eb0: 77 69 74 68 20 4d 75 6c 74 69 70 6c 65 20 53 74 with Multiple St
3ec0: 65 70 73 20 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 eps .</h2>.<div
3ed0: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
3ee0: 3e 0a 54 6f 20 72 75 6e 20 6d 75 6c 74 69 70 6c >.To run multipl
3ef0: 65 20 73 74 65 70 73 20 73 69 6d 70 6c 79 20 61 e steps simply a
3f00: 64 64 20 74 68 65 6d 20 74 6f 20 74 68 65 20 6d dd them to the m
3f10: 61 69 6e 2e 63 73 68 20 66 69 6c 65 2e 20 48 65 ain.csh file. He
3f20: 72 65 20 77 65 20 61 64 64 20 61 20 73 74 65 70 re we add a step
3f30: 20 74 6f 20 74 65 73 74 20 e2 80 9c 63 70 75 32 to test “cpu2
3f40: e2 80 9d 2e 20 54 68 65 20 73 65 63 6f 6e 64 20 ”. The second
3f50: 73 74 65 70 20 74 68 61 74 20 74 65 73 74 73 20 step that tests
3f60: 63 70 75 32 20 77 69 6c 6c 20 6f 6e 6c 79 20 72 cpu2 will only r
3f70: 75 6e 20 61 66 74 65 72 20 74 68 65 20 73 74 65 un after the ste
3f80: 70 20 74 68 61 74 20 74 65 73 74 65 64 20 e2 80 p that tested
3f90: 9c 63 70 75 31 e2 80 9d 20 63 6f 6d 70 6c 65 74 cpu1” complet
3fa0: 65 73 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 es..</div>.<div
3fb0: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
3fc0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 >.<div class="li
3fd0: 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 sting">.<pre cla
3fe0: 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 23 21 2f ss="listing">#!/
3ff0: 62 69 6e 2f 74 63 73 68 20 2d 78 0a e2 80 8b 0a bin/tcsh -x..
4000: 23 20 72 75 6e 20 74 68 65 20 63 70 75 31 20 73 # run the cpu1 s
4010: 69 6d 75 6c 61 74 69 6f 6e 2e 0a 23 20 20 20 54 imulation..# T
4020: 68 65 20 73 74 65 70 20 6e 61 6d 65 20 69 73 20 he step name is
4030: 22 72 75 6e 5f 73 69 6d 75 6c 61 74 69 6f 6e 22 "run_simulation"
4040: 0a 23 20 20 20 54 68 65 20 63 6f 6d 6d 61 6e 64 .# The command
4050: 6c 69 6e 65 20 62 65 69 6e 67 20 72 75 6e 20 66 line being run f
4060: 6f 72 20 74 68 69 73 20 73 74 65 70 20 69 73 20 or this step is
4070: 22 72 75 6e 73 69 6d 20 63 70 75 31 22 0a 23 20 "runsim cpu1".#
4080: 20 20 54 68 65 20 6c 6f 67 70 72 6f 20 66 69 6c The logpro fil
4090: 65 20 74 6f 20 76 61 6c 69 64 61 74 65 20 74 68 e to validate th
40a0: 65 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 e output from th
40b0: 65 20 72 75 6e 20 69 73 20 22 72 75 6e 73 69 6d e run is "runsim
40c0: 2e 6c 6f 67 70 72 6f 22 0a e2 80 8b 0a 24 4d 54 .logpro"..$MT
40d0: 5f 4d 45 47 41 54 45 53 54 20 2d 72 75 6e 73 74 _MEGATEST -runst
40e0: 65 70 20 72 75 6e 5f 73 69 6d 75 6c 61 74 69 6f ep run_simulatio
40f0: 6e 5f 63 70 75 31 20 2d 6c 6f 67 70 72 6f 20 72 n_cpu1 -logpro r
4100: 75 6e 73 69 6d 2e 6c 6f 67 70 72 6f 20 22 72 75 unsim.logpro "ru
4110: 6e 73 69 6d 20 63 70 75 31 22 20 26 61 6d 70 3b nsim cpu1" &
4120: 26 61 6d 70 3b 20 5c 0a 24 4d 54 5f 4d 45 47 41 & \.$MT_MEGA
4130: 54 45 53 54 20 2d 72 75 6e 73 74 65 70 20 72 75 TEST -runstep ru
4140: 6e 5f 73 69 6d 75 6c 61 74 69 6f 6e 5f 63 70 75 n_simulation_cpu
4150: 32 20 2d 6c 6f 67 70 72 6f 20 72 75 6e 73 69 6d 2 -logpro runsim
4160: 2e 6c 6f 67 70 72 6f 20 22 72 75 6e 73 69 6d 20 .logpro "runsim
4170: 63 70 75 32 22 0a 24 4d 54 5f 4d 45 47 41 54 45 cpu2".$MT_MEGATE
4180: 53 54 20 2d 74 65 73 74 2d 73 74 61 74 75 73 20 ST -test-status
4190: 3a 73 74 61 74 65 20 43 4f 4d 50 4c 45 54 45 44 :state COMPLETED
41a0: 20 3a 73 74 61 74 75 73 20 24 3f 0a 3c 2f 70 72 :status $?.</pr
41b0: 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 e>.</div>..</div
41c0: 3e 0a 3c 68 31 20 63 6c 61 73 73 3d 22 53 65 63 >.<h1 class="Sec
41d0: 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d tion">.<a class=
41e0: 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d "toc" name="toc-
41f0: 53 65 63 74 69 6f 6e 2d 36 22 3e 36 3c 2f 61 3e Section-6">6</a>
4200: e2 80 83 53 69 6d 70 6c 65 20 54 65 73 74 20 77 Simple Test w
4210: 69 74 68 20 4d 75 6c 74 69 70 6c 65 20 53 74 65 ith Multiple Ste
4220: 70 73 2c 20 53 6f 6d 65 20 69 6e 20 50 61 72 61 ps, Some in Para
4230: 6c 6c 65 6c 0a 3c 2f 68 31 3e 0a 3c 68 32 20 63 llel.</h1>.<h2 c
4240: 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e lass="Subsection
4250: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 ">.<a class="toc
4260: 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 " name="toc-Subs
4270: 65 63 74 69 6f 6e 2d 36 2e 31 22 3e 36 2e 31 3c ection-6.1">6.1<
4280: 2f 61 3e e2 80 83 54 68 65 20 4d 61 6b 65 66 69 /a> The Makefi
4290: 6c 65 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c le.</h2>.<div cl
42a0: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
42b0: 41 20 67 6f 6f 64 20 77 61 79 20 74 6f 20 72 75 A good way to ru
42c0: 6e 20 73 74 65 70 73 20 69 6e 20 70 61 72 61 6c n steps in paral
42d0: 6c 65 6c 20 77 69 74 68 69 6e 20 61 20 73 69 6e lel within a sin
42e0: 67 6c 65 20 74 65 73 74 2c 20 65 73 70 65 63 69 gle test, especi
42f0: 61 6c 6c 79 20 77 68 65 6e 20 74 68 65 72 65 20 ally when there
4300: 61 72 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 are following st
4310: 65 70 73 2c 20 69 73 20 74 6f 20 75 73 65 20 74 eps, is to use t
4320: 68 65 20 55 6e 69 78 20 4d 61 6b 65 20 75 74 69 he Unix Make uti
4330: 6c 69 74 79 2e 20 57 72 69 74 69 6e 67 20 4d 61 lity. Writing Ma
4340: 6b 65 66 69 6c 65 73 20 69 73 20 62 65 79 6f 6e kefiles is beyon
4350: 64 20 74 68 65 20 73 63 6f 70 65 20 6f 66 20 74 d the scope of t
4360: 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 62 75 74 his document but
4370: 20 68 65 72 65 20 69 73 20 61 20 6d 69 6e 69 6d here is a minim
4380: 61 6c 20 65 78 61 6d 70 6c 65 20 74 68 61 74 20 al example that
4390: 77 69 6c 6c 20 72 75 6e 20 e2 80 9c 72 75 6e 73 will run “runs
43a0: 69 6d 20 63 70 75 31 e2 80 9d 20 61 6e 64 20 e2 im cpu1” and
43b0: 80 9c 72 75 6e 73 69 6d 20 63 70 75 32 e2 80 9d runsim cpu2”
43c0: 20 69 6e 20 70 61 72 61 6c 6c 65 6c 2e 20 46 6f in parallel. Fo
43d0: 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 r more informati
43e0: 6f 6e 20 6f 6e 20 6d 61 6b 65 20 74 72 79 20 e2 on on make try
43f0: 80 9c 69 6e 66 6f 20 6d 61 6b 65 e2 80 9d 20 61 info make” a
4400: 74 20 74 68 65 20 4c 69 6e 75 78 20 63 6f 6d 6d t the Linux comm
4410: 61 6e 64 20 70 72 6f 6d 70 74 2e 0a 3c 2f 64 69 and prompt..</di
4420: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 v>.<div class="S
4430: 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 63 tandard">.<div c
4440: 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a lass="listing">.
4450: 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 <pre class="list
4460: 69 6e 67 22 3e 23 20 45 78 61 6d 70 6c 65 20 4d ing"># Example M
4470: 61 6b 65 66 69 6c 65 20 74 6f 20 72 75 6e 20 74 akefile to run t
4480: 77 6f 20 73 74 65 70 73 20 69 6e 20 70 61 72 61 wo steps in para
4490: 6c 6c 65 6c 0a e2 80 8b 0a 52 54 4c 44 49 52 3d llel..RTLDIR=
44a0: 2f 70 61 74 68 2f 74 6f 2f 72 74 6c 0a 43 50 55 /path/to/rtl.CPU
44b0: 53 20 3d 20 63 70 75 31 20 63 70 75 32 0a e2 80 S = cpu1 cpu2.
44c0: 8b 0a 72 75 6e 5f 73 69 6d 75 6c 61 74 69 6f 6e .run_simulation
44d0: 5f 24 28 43 50 55 53 29 2e 68 74 6d 6c 20 3a 20 _$(CPUS).html :
44e0: 24 28 52 54 4c 44 49 52 29 2f 24 28 43 50 55 53 $(RTLDIR)/$(CPUS
44f0: 29 0a 09 24 28 4d 54 5f 4d 45 47 41 54 45 53 54 )..$(MT_MEGATEST
4500: 29 20 2d 72 75 6e 73 74 65 70 20 72 75 6e 5f 73 ) -runstep run_s
4510: 69 6d 75 6c 61 74 69 6f 6e 5f 24 28 43 50 55 53 imulation_$(CPUS
4520: 29 20 2d 6c 6f 67 70 72 6f 20 72 75 6e 73 69 6d ) -logpro runsim
4530: 2e 6c 6f 67 70 72 6f 20 22 72 75 6e 73 69 6d 20 .logpro "runsim
4540: 24 28 43 50 55 53 29 0a 3c 2f 70 72 65 3e 0a 3c $(CPUS).</pre>.<
4550: 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 /div>..</div>.<h
4560: 32 20 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 2 class="Subsect
4570: 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 ion">.<a class="
4580: 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 toc" name="toc-S
4590: 75 62 73 65 63 74 69 6f 6e 2d 36 2e 32 22 3e 36 ubsection-6.2">6
45a0: 2e 32 3c 2f 61 3e e2 80 83 54 68 65 20 6d 61 69 .2</a> The mai
45b0: 6e 2e 63 73 68 20 66 69 6c 65 0a 3c 2f 68 32 3e n.csh file.</h2>
45c0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 .<div class="Sta
45d0: 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 ndard">.<div cla
45e0: 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 ss="listing">.<p
45f0: 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e re class="listin
4600: 67 22 3e 23 21 2f 62 69 6e 2f 74 63 73 68 20 2d g">#!/bin/tcsh -
4610: 78 0a e2 80 8b 0a 23 20 72 75 6e 20 74 68 65 20 x..# run the
4620: 63 70 75 31 20 61 6e 64 20 63 70 75 32 20 73 69 cpu1 and cpu2 si
4630: 6d 75 6c 61 74 69 6f 6e 73 20 69 6e 20 70 61 72 mulations in par
4640: 61 6c 6c 65 6c 2e 20 0a 23 20 54 68 65 20 2d 6a allel. .# The -j
4650: 20 70 61 72 61 6d 65 74 65 72 20 74 65 6c 6c 73 parameter tells
4660: 20 6d 61 6b 65 20 68 6f 77 20 6d 61 6e 79 20 6a make how many j
4670: 6f 62 73 20 69 74 20 6d 61 79 20 72 75 6e 20 69 obs it may run i
4680: 6e 20 70 61 72 61 6c 6c 65 6c 0a e2 80 8b 0a 3c n parallel..<
4690: 64 69 76 20 63 6c 61 73 73 3d 22 6c 65 66 74 22 div class="left"
46a0: 3e 0a 6d 61 6b 65 20 2d 6a 20 32 20 0a 3c 2f 64 >.make -j 2 .</d
46b0: 69 76 3e 0a 0a 24 4d 54 5f 4d 45 47 41 54 45 53 iv>..$MT_MEGATES
46c0: 54 20 2d 74 65 73 74 2d 73 74 61 74 75 73 20 3a T -test-status :
46d0: 73 74 61 74 65 20 43 4f 4d 50 4c 45 54 45 44 20 state COMPLETED
46e0: 3a 73 74 61 74 75 73 20 24 3f 0a 3c 2f 70 72 65 :status $?.</pre
46f0: 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e >.</div>..</div>
4700: 0a 3c 68 31 20 63 6c 61 73 73 3d 22 53 65 63 74 .<h1 class="Sect
4710: 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 ion">.<a class="
4720: 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 toc" name="toc-S
4730: 65 63 74 69 6f 6e 2d 37 22 3e 37 3c 2f 61 3e e2 ection-7">7</a>
4740: 80 83 53 69 6d 70 6c 65 20 54 65 73 74 20 77 69 Simple Test wi
4750: 74 68 20 49 74 65 72 61 74 69 6f 6e 0a 3c 2f 68 th Iteration.</h
4760: 31 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 1>.<div class="S
4770: 74 61 6e 64 61 72 64 22 3e 0a 53 69 6e 63 65 20 tandard">.Since
4780: 6e 6f 20 6a 6f 62 73 20 72 75 6e 20 61 66 74 65 no jobs run afte
4790: 72 20 74 68 65 20 63 70 75 31 20 61 6e 64 20 63 r the cpu1 and c
47a0: 70 75 32 20 73 69 6d 75 6c 61 74 69 6f 6e 73 20 pu2 simulations
47b0: 69 6e 20 74 68 69 73 20 74 65 73 74 20 69 74 20 in this test it
47c0: 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 75 is possible to u
47d0: 73 65 20 69 74 65 72 61 74 65 64 20 6d 6f 64 65 se iterated mode
47e0: 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 ..</div>.<h2 cla
47f0: 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e ss="Subsection">
4800: 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 .<a class="toc"
4810: 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 name="toc-Subsec
4820: 74 69 6f 6e 2d 37 2e 31 22 3e 37 2e 31 3c 2f 61 tion-7.1">7.1</a
4830: 3e e2 80 83 55 70 64 61 74 65 20 79 6f 75 72 20 > Update your
4840: 74 65 73 74 63 6f 6e 66 69 67 20 66 69 6c 65 20 testconfig file
4850: 66 6f 72 20 69 74 65 72 61 74 69 6f 6e 0a 3c 2f for iteration.</
4860: 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 h2>.<div class="
4870: 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 Standard">.<div
4880: 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e class="listing">
4890: 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 .<pre class="lis
48a0: 74 69 6e 67 22 3e 5b 73 65 74 75 70 5d 0a 72 75 ting">[setup].ru
48b0: 6e 73 63 72 69 70 74 20 6d 61 69 6e 2e 63 73 68 nscript main.csh
48c0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 65 66 .<div class="lef
48d0: 74 22 3e 0a 0a 3c 2f 64 69 76 3e 0a 0a 5b 69 74 t">..</div>..[it
48e0: 65 6d 73 5d 0a 43 50 55 20 63 70 75 31 20 63 70 ems].CPU cpu1 cp
48f0: 75 32 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e u2.</pre>.</div>
4900: 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 ..</div>.<h2 cla
4910: 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e ss="Subsection">
4920: 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 .<a class="toc"
4930: 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 name="toc-Subsec
4940: 74 69 6f 6e 2d 37 2e 32 22 3e 37 2e 32 3c 2f 61 tion-7.2">7.2</a
4950: 3e e2 80 83 52 65 77 72 69 74 65 20 79 6f 75 72 > Rewrite your
4960: 20 6d 61 69 6e 2e 63 73 68 20 66 6f 72 20 69 74 main.csh for it
4970: 65 72 61 74 69 6f 6e 0a 3c 2f 68 32 3e 0a 3c 64 eration.</h2>.<d
4980: 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 iv class="Standa
4990: 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d rd">.<div class=
49a0: 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 "listing">.<pre
49b0: 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e class="listing">
49c0: 23 21 2f 62 69 6e 2f 74 63 73 68 20 2d 78 0a 0a #!/bin/tcsh -x..
49d0: 23 20 72 75 6e 20 74 68 65 20 63 70 75 20 73 69 # run the cpu si
49e0: 6d 75 6c 61 74 69 6f 6e 20 62 75 74 20 6e 6f 77 mulation but now
49f0: 20 75 73 65 20 74 68 65 20 65 6e 76 69 72 6f 6e use the environ
4a00: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 24 43 ment variable $C
4a10: 50 55 0a 23 20 74 6f 20 73 65 6c 65 63 74 20 77 PU.# to select w
4a20: 68 61 74 20 63 70 75 20 74 6f 20 72 75 6e 20 74 hat cpu to run t
4a30: 68 65 20 73 69 6d 75 6c 61 74 69 6f 6e 20 61 67 he simulation ag
4a40: 61 69 6e 73 74 0a 0a 24 4d 54 5f 4d 45 47 41 54 ainst..$MT_MEGAT
4a50: 45 53 54 20 2d 72 75 6e 73 74 65 70 20 72 75 6e EST -runstep run
4a60: 5f 73 69 6d 75 6c 61 74 69 6f 6e 20 2d 6c 6f 67 _simulation -log
4a70: 70 72 6f 20 72 75 6e 73 69 6d 2e 6c 6f 67 70 72 pro runsim.logpr
4a80: 6f 20 22 72 75 6e 73 69 6d 20 24 43 50 55 22 0a o "runsim $CPU".
4a90: 23 20 41 73 20 6f 66 20 76 65 72 73 69 6f 6e 20 # As of version
4aa0: 31 2e 30 37 20 4d 65 67 61 74 65 73 74 20 61 75 1.07 Megatest au
4ab0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 6f 6e 76 tomatically conv
4ac0: 65 72 74 73 20 61 20 73 74 61 74 75 73 20 6f 66 erts a status of
4ad0: 20 22 30 22 0a 23 20 74 6f 20 22 50 41 53 53 22 "0".# to "PASS"
4ae0: 2c 20 61 6e 79 20 6f 74 68 65 72 20 6e 75 6d 62 , any other numb
4af0: 65 72 20 74 6f 20 22 46 41 49 4c 22 20 61 6e 64 er to "FAIL" and
4b00: 20 64 69 72 65 63 74 6c 79 20 75 73 65 73 20 74 directly uses t
4b10: 68 65 20 76 61 6c 75 65 20 6f 66 0a 23 20 61 20 he value of.# a
4b20: 73 74 72 69 6e 67 20 70 61 73 73 65 64 20 69 6e string passed in
4b30: 2e 0a 24 4d 54 5f 4d 45 47 41 54 45 53 54 20 2d ..$MT_MEGATEST -
4b40: 74 65 73 74 2d 73 74 61 74 75 73 20 3a 73 74 61 test-status :sta
4b50: 74 65 20 43 4f 4d 50 4c 45 54 45 44 20 3a 73 74 te COMPLETED :st
4b60: 61 74 75 73 20 24 3f 0a 3c 2f 70 72 65 3e 0a 3c atus $?.</pre>.<
4b70: 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 /div>..</div>.<h
4b80: 32 20 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 2 class="Subsect
4b90: 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 ion">.<a class="
4ba0: 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 toc" name="toc-S
4bb0: 75 62 73 65 63 74 69 6f 6e 2d 37 2e 33 22 3e 37 ubsection-7.3">7
4bc0: 2e 33 3c 2f 61 3e e2 80 83 54 65 73 74 73 20 77 .3</a> Tests w
4bd0: 69 74 68 20 49 6e 74 65 72 2d 74 65 73 74 20 64 ith Inter-test d
4be0: 65 70 65 6e 64 65 6e 63 69 65 73 0a 3c 2f 68 32 ependencies.</h2
4bf0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
4c00: 61 6e 64 61 72 64 22 3e 0a 53 6f 6d 65 74 69 6d andard">.Sometim
4c10: 65 73 20 61 20 74 65 73 74 20 64 65 70 65 6e 64 es a test depend
4c20: 73 20 6f 6e 20 74 68 65 20 6f 75 74 70 75 74 20 s on the output
4c30: 66 72 6f 6d 20 61 20 70 72 65 76 69 6f 75 73 20 from a previous
4c40: 74 65 73 74 20 6f 72 20 69 74 20 6d 61 79 20 6e test or it may n
4c50: 6f 74 20 6d 61 6b 65 20 73 65 6e 73 65 20 74 6f ot make sense to
4c60: 20 72 75 6e 20 61 20 74 65 73 74 20 69 73 20 61 run a test is a
4c70: 6e 6f 74 68 65 72 20 74 65 73 74 20 64 6f 65 73 nother test does
4c80: 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 20 77 69 not complete wi
4c90: 74 68 20 73 74 61 74 75 73 20 e2 80 9c 50 41 53 th status “PAS
4ca0: 53 e2 80 9d 2e 20 49 6e 20 65 69 74 68 65 72 20 S”. In either
4cb0: 6f 66 20 74 68 65 73 65 20 73 63 65 6e 61 72 69 of these scenari
4cc0: 6f 73 20 79 6f 75 20 63 61 6e 20 75 73 65 20 74 os you can use t
4cd0: 68 65 20 e2 80 9c 77 61 69 74 6f 6e e2 80 9d 20 he “waiton”
4ce0: 6b 65 79 77 6f 72 64 20 69 6e 20 79 6f 75 72 20 keyword in your
4cf0: 74 65 73 74 63 6f 6e 66 69 67 20 66 69 6c 65 20 testconfig file
4d00: 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 to indicate that
4d10: 20 74 68 69 73 20 74 65 73 74 20 6d 75 73 74 20 this test must
4d20: 77 61 69 74 20 6f 6e 20 6f 6e 65 20 6f 72 20 6d wait on one or m
4d30: 6f 72 65 20 74 65 73 74 73 20 74 6f 20 63 6f 6d ore tests to com
4d40: 70 6c 65 74 65 20 62 65 66 6f 72 65 20 62 65 69 plete before bei
4d50: 6e 67 20 6c 61 75 6e 63 68 65 64 2e 20 49 6e 20 ng launched. In
4d60: 74 68 69 73 20 65 78 61 6d 70 6c 65 20 74 68 65 this example the
4d70: 72 65 20 69 73 20 6e 6f 20 70 6f 69 6e 74 20 69 re is no point i
4d80: 6e 20 72 75 6e 6e 69 6e 67 20 74 68 65 20 e2 80 n running the
4d90: 9c 73 79 73 74 65 6d e2 80 9d 20 74 65 73 74 20 system” test
4da0: 69 66 20 74 68 65 20 e2 80 9c 63 70 75 e2 80 9d if the “cpu”
4db0: 20 61 6e 64 20 e2 80 9c 6d 65 6d e2 80 9d 20 74 and “mem” t
4dc0: 65 73 74 73 20 65 69 74 68 65 72 20 64 6f 20 6e ests either do n
4dd0: 6f 74 20 63 6f 6d 70 6c 65 74 65 20 6f 72 20 63 ot complete or c
4de0: 6f 6d 70 6c 65 74 65 20 62 75 74 20 77 69 74 68 omplete but with
4df0: 20 73 74 61 74 75 73 20 e2 80 9c 46 41 49 4c e2 status “FAIL
4e00: 80 9d 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 ..</div>.<div
4e10: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
4e20: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 >.<div class="li
4e30: 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 sting">.<pre cla
4e40: 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 23 20 74 ss="listing"># t
4e50: 65 73 74 63 6f 6e 66 69 67 20 66 6f 72 20 74 68 estconfig for th
4e60: 65 20 22 73 79 73 74 65 6d 22 20 74 65 73 74 0a e "system" test.
4e70: 5b 73 65 74 75 70 5d 0a 72 75 6e 73 63 72 69 70 [setup].runscrip
4e80: 74 20 6d 61 69 6e 2e 63 73 68 0a 77 61 69 74 6f t main.csh.waito
4e90: 6e 20 63 70 75 20 6d 65 6d 0a 3c 2f 70 72 65 3e n cpu mem.</pre>
4ea0: 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a .</div>..</div>.
4eb0: 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 73 65 <h2 class="Subse
4ec0: 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 ction">.<a class
4ed0: 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 ="toc" name="toc
4ee0: 2d 53 75 62 73 65 63 74 69 6f 6e 2d 37 2e 34 22 -Subsection-7.4"
4ef0: 3e 37 2e 34 3c 2f 61 3e e2 80 83 52 6f 6c 6c 69 >7.4</a> Rolli
4f00: 6e 67 20 75 70 20 4d 69 73 63 65 6c 6c 61 6e 65 ng up Miscellane
4f10: 6f 75 73 20 44 61 74 61 0a 3c 2f 68 32 3e 0a 3c ous Data.</h2>.<
4f20: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
4f30: 61 72 64 22 3e 0a 55 73 65 20 74 68 65 20 2d 6c ard">.Use the -l
4f40: 6f 61 64 2d 74 65 73 74 2d 64 61 74 61 20 73 77 oad-test-data sw
4f50: 69 74 63 68 20 74 6f 20 72 6f 6c 6c 20 75 70 20 itch to roll up
4f60: 61 72 62 69 74 72 61 72 79 20 64 61 74 61 20 66 arbitrary data f
4f70: 72 6f 6d 20 61 20 74 65 73 74 20 69 6e 74 6f 20 rom a test into
4f80: 74 68 65 20 74 65 73 74 5f 64 61 74 61 20 74 61 the test_data ta
4f90: 62 6c 65 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 ble..</div>.<div
4fa0: 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 class="Standard
4fb0: 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c ">.<div class="l
4fc0: 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c isting">.<pre cl
4fd0: 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 23 20 ass="listing">#
4fe0: 46 69 65 6c 64 73 20 61 72 65 3a 0a 23 20 63 61 Fields are:.# ca
4ff0: 74 65 67 6f 72 79 2c 76 61 72 69 61 62 6c 65 2c tegory,variable,
5000: 76 61 6c 75 65 2c 65 78 70 65 63 74 65 64 2c 74 value,expected,t
5010: 6f 6c 2c 75 6e 69 74 73 2c 63 6f 6d 6d 65 6e 74 ol,units,comment
5020: 2c 73 74 61 74 75 73 0a e2 80 8b 0a 24 4d 54 5f ,status..$MT_
5030: 4d 45 47 41 54 45 53 54 20 2d 6c 6f 61 64 2d 74 MEGATEST -load-t
5040: 65 73 74 2d 64 61 74 61 20 26 6c 74 3b 26 6c 74 est-data <<
5050: 3b 20 45 4f 46 0a 66 6f 6f 2c 62 61 72 2c 31 2e ; EOF.foo,bar,1.
5060: 32 2c 31 2e 39 2c 26 67 74 3b 0a 66 6f 6f 2c 72 2,1.9,>.foo,r
5070: 61 62 2c 31 2e 30 65 39 2c 31 30 65 39 2c 31 65 ab,1.0e9,10e9,1e
5080: 39 0a 66 6f 6f 2c 62 6c 61 2c 31 2e 32 2c 31 2e 9.foo,bla,1.2,1.
5090: 39 2c 26 6c 74 3b 0a 66 6f 6f 2c 62 61 6c 2c 31 9,<.foo,bal,1
50a0: 2e 32 2c 31 2e 32 2c 26 6c 74 3b 2c 2c 43 68 65 .2,1.2,<,,Che
50b0: 63 6b 20 66 6f 72 20 6f 76 65 72 6c 6f 61 64 0a ck for overload.
50c0: 66 6f 6f 2c 61 6c 62 2c 31 2e 32 2c 31 2e 32 2c foo,alb,1.2,1.2,
50d0: 26 6c 74 3b 3d 2c 41 6d 70 73 2c 54 68 69 73 20 <=,Amps,This
50e0: 69 73 20 74 68 65 20 68 69 67 68 20 70 6f 77 65 is the high powe
50f0: 72 20 63 69 72 63 75 69 74 20 74 65 73 74 0a 66 r circuit test.f
5100: 6f 6f 2c 61 62 6c 2c 31 2e 32 2c 31 2e 33 2c 30 oo,abl,1.2,1.3,0
5110: 2e 31 0a 66 6f 6f 2c 62 72 61 2c 31 2e 32 2c 70 .1.foo,bra,1.2,p
5120: 61 73 73 2c 73 69 6c 6c 79 20 73 74 75 66 66 0a ass,silly stuff.
5130: 66 61 7a 2c 62 61 72 2c 31 30 2c 38 6d 41 2c 2c faz,bar,10,8mA,,
5140: 2c 22 74 68 69 73 20 69 73 20 61 20 63 6f 6d 6d ,"this is a comm
5150: 65 6e 74 22 0a 45 4f 46 0a 3c 2f 70 72 65 3e 0a ent".EOF.</pre>.
5160: 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c </div>..</div>.<
5170: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
5180: 61 72 64 22 3e 0a 4e 65 77 20 65 6e 74 72 69 65 ard">.New entrie
5190: 73 20 61 72 65 20 6b 65 79 65 64 20 6f 6e 20 74 s are keyed on t
51a0: 68 65 20 63 61 74 65 67 6f 72 79 20 61 6e 64 20 he category and
51b0: 76 61 72 69 61 62 6c 65 2e 20 49 66 20 61 20 6e variable. If a n
51c0: 65 77 20 72 65 63 6f 72 64 20 69 73 20 69 6e 73 ew record is ins
51d0: 65 72 74 65 64 20 77 69 74 68 20 61 20 63 61 74 erted with a cat
51e0: 65 67 6f 72 79 20 61 6e 64 20 76 61 72 69 61 62 egory and variab
51f0: 6c 65 20 74 68 61 74 20 68 61 76 65 20 61 6c 72 le that have alr
5200: 65 61 64 79 20 62 65 65 6e 20 75 73 65 64 20 74 eady been used t
5210: 68 65 20 6e 65 77 20 72 65 63 6f 72 64 20 77 69 he new record wi
5220: 6c 6c 20 72 65 70 6c 61 63 65 20 74 68 65 20 6f ll replace the o
5230: 6c 64 20 72 65 63 6f 72 64 2e 0a 3c 2f 64 69 76 ld record..</div
5240: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
5250: 61 6e 64 61 72 64 22 3e 0a 57 68 65 72 65 20 76 andard">.Where v
5260: 61 6c 75 65 2c 20 65 78 70 65 63 74 65 64 20 61 alue, expected a
5270: 6e 64 20 74 6f 6c 20 61 72 65 20 73 70 65 63 69 nd tol are speci
5280: 66 69 65 64 20 74 68 65 20 62 65 68 61 76 69 6f fied the behavio
5290: 72 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 2e r is as follows.
52a0: 0a 3c 2f 64 69 76 3e 0a 3c 75 6c 3e 0a 3c 6c 69 .</div>.<ul>.<li
52b0: 3e 0a 49 66 20 76 61 6c 75 65 2c 20 65 78 70 65 >.If value, expe
52c0: 63 74 65 64 20 61 6e 64 20 74 6f 6c 20 61 72 65 cted and tol are
52d0: 20 6e 75 6d 62 65 72 73 20 74 68 65 6e 20 73 74 numbers then st
52e0: 61 74 75 73 20 69 73 20 63 61 6c 63 75 6c 61 74 atus is calculat
52f0: 65 64 20 61 73 20 50 41 53 53 20 69 66 20 28 65 ed as PASS if (e
5300: 78 70 65 63 74 65 64 2d 74 6f 6c 29 20 26 6c 74 xpected-tol) <
5310: 3b 3d 20 76 61 6c 75 65 20 26 6c 74 3b 3d 20 28 ;= value <= (
5320: 65 78 70 65 63 74 65 64 2b 74 6f 6c 29 0a 3c 2f expected+tol).</
5330: 6c 69 3e 0a 3c 6c 69 3e 0a 49 66 20 76 61 6c 75 li>.<li>.If valu
5340: 65 20 61 6e 64 20 65 78 70 65 63 74 65 64 20 61 e and expected a
5350: 72 65 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 74 re numbers and t
5360: 6f 6c 20 69 73 20 26 67 74 3b 2c 20 26 6c 74 3b ol is >, <
5370: 2c 20 26 67 74 3b 3d 20 6f 72 20 26 6c 74 3b 3d , >= or <=
5380: 20 74 68 65 6e 20 76 61 6c 75 65 20 69 73 20 63 then value is c
5390: 6f 6d 70 61 72 65 64 20 77 69 74 68 20 65 78 70 ompared with exp
53a0: 65 63 74 65 64 20 75 73 69 6e 67 20 74 68 65 20 ected using the
53b0: 6f 70 65 72 61 74 6f 72 20 67 69 76 65 6e 20 62 operator given b
53c0: 79 20 74 6f 6c 0a 3c 2f 6c 69 3e 0a 3c 6c 69 3e y tol.</li>.<li>
53d0: 0a 49 66 20 73 74 61 74 75 73 20 69 73 20 73 70 .If status is sp
53e0: 65 63 69 66 69 65 64 20 69 74 73 20 76 61 6c 75 ecified its valu
53f0: 65 20 6f 76 65 72 72 69 64 65 73 20 74 68 65 20 e overrides the
5400: 61 62 6f 76 65 20 63 61 6c 63 75 6c 61 74 69 6f above calculatio
5410: 6e 73 2e 0a 3c 2f 6c 69 3e 0a 0a 3c 2f 75 6c 3e ns..</li>..</ul>
5420: 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 73 .<h2 class="Subs
5430: 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 ection">.<a clas
5440: 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f s="toc" name="to
5450: 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 37 2e 35 c-Subsection-7.5
5460: 22 3e 37 2e 35 3c 2f 61 3e e2 80 83 52 6f 6c 6c ">7.5</a> Roll
5470: 69 6e 67 20 75 70 20 52 75 6e 73 0a 3c 2f 68 32 ing up Runs.</h2
5480: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 >.<div class="St
5490: 61 6e 64 61 72 64 22 3e 0a 54 6f 20 72 6f 6c 6c andard">.To roll
54a0: 20 75 70 20 61 20 6e 75 6d 62 65 72 20 6f 66 20 up a number of
54b0: 74 65 73 74 73 20 69 6e 20 61 20 73 65 71 75 65 tests in a seque
54c0: 6e 63 65 20 6f 66 20 72 75 6e 73 20 74 6f 20 61 nce of runs to a
54d0: 20 73 69 6e 67 6c 65 20 72 75 6e 20 75 73 65 20 single run use
54e0: 74 68 65 20 2d 72 6f 6c 6c 75 70 20 63 6f 6d 6d the -rollup comm
54f0: 61 6e 64 2e 20 0a 3c 2f 64 69 76 3e 0a 3c 64 69 and. .</div>.<di
5500: 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 v class="Standar
5510: 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 d">.<div class="
5520: 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 listing">.<pre c
5530: 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 6d lass="listing">m
5540: 65 67 61 74 65 73 74 20 2d 72 6f 6c 6c 75 70 20 egatest -rollup
5550: 3a 73 79 73 6e 61 6d 65 20 75 62 75 6e 74 75 20 :sysname ubuntu
5560: 3a 66 73 6e 61 6d 65 20 6e 66 73 20 3a 64 61 74 :fsname nfs :dat
5570: 61 70 61 74 68 20 6e 6f 6e 65 20 3a 72 75 6e 6e apath none :runn
5580: 61 6d 65 20 72 6f 6c 6c 75 70 5f 77 77 33 38 0a ame rollup_ww38.
5590: 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c </pre>.</div>..<
55a0: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
55b0: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 41 6c 6c ="Standard">.All
55c0: 20 6b 65 79 73 20 6d 75 73 74 20 62 65 20 73 70 keys must be sp
55d0: 65 63 69 66 69 65 64 20 61 6e 64 20 74 68 65 20 ecified and the
55e0: 72 75 6e 6e 61 6d 65 20 69 73 20 74 68 65 20 6e runname is the n
55f0: 61 6d 65 20 6f 66 20 74 68 65 20 72 75 6e 20 74 ame of the run t
5600: 68 61 74 20 77 69 6c 6c 20 62 65 20 63 72 65 61 hat will be crea
5610: 74 65 64 2e 20 41 6c 6c 20 70 61 74 68 73 20 61 ted. All paths a
5620: 72 65 20 6b 65 70 74 20 6f 72 69 67 69 6e 61 6c re kept original
5630: 20 69 6e 73 69 64 65 20 74 68 65 20 64 61 74 61 inside the data
5640: 62 61 73 65 2e 20 57 68 65 6e 20 2d 72 65 6d 6f base. When -remo
5650: 76 65 2d 72 75 6e 73 20 69 73 20 75 73 65 64 20 ve-runs is used
5660: 74 6f 20 64 65 6c 65 74 65 20 72 75 6e 73 20 74 to delete runs t
5670: 68 65 20 64 61 74 61 20 69 73 20 6e 6f 74 20 64 he data is not d
5680: 65 6c 65 74 65 64 20 69 66 20 74 68 65 72 65 20 eleted if there
5690: 61 72 65 20 72 6f 6c 6c 75 70 73 20 74 68 61 74 are rollups that
56a0: 20 72 65 66 65 72 20 74 6f 20 74 68 65 20 64 61 refer to the da
56b0: 74 61 2e 20 0a 3c 2f 64 69 76 3e 0a 3c 68 31 20 ta. .</div>.<h1
56c0: 63 6c 61 73 73 3d 22 53 65 63 74 69 6f 6e 22 3e class="Section">
56d0: 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 .<a class="toc"
56e0: 6e 61 6d 65 3d 22 74 6f 63 2d 53 65 63 74 69 6f name="toc-Sectio
56f0: 6e 2d 38 22 3e 38 3c 2f 61 3e e2 80 83 44 61 73 n-8">8</a> Das
5700: 68 62 6f 61 72 64 0a 3c 2f 68 31 3e 0a 3c 64 69 hboard.</h1>.<di
5710: 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 v class="Standar
5720: 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 d">.<div class="
5730: 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 listing">.<pre c
5740: 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 26 lass="listing">&
5750: 67 74 3b 20 64 61 73 68 62 6f 61 72 64 20 26 61 gt; dashboard &a
5760: 6d 70 3b 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 mp;.</pre>.</div
5770: 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 >..</div>.<div c
5780: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
5790: 0a 3c 69 6d 67 20 63 6c 61 73 73 3d 22 65 6d 62 .<img class="emb
57a0: 65 64 64 65 64 22 20 73 72 63 3d 22 64 61 73 68 edded" src="dash
57b0: 62 6f 61 72 64 2e 70 6e 67 22 20 61 6c 74 3d 22 board.png" alt="
57c0: 66 69 67 75 72 65 20 64 61 73 68 62 6f 61 72 64 figure dashboard
57d0: 2e 70 6e 67 22 20 73 74 79 6c 65 3d 22 77 69 64 .png" style="wid
57e0: 74 68 3a 20 37 33 30 70 78 3b 20 6d 61 78 2d 77 th: 730px; max-w
57f0: 69 64 74 68 3a 20 39 31 33 70 78 3b 20 68 65 69 idth: 913px; hei
5800: 67 68 74 3a 20 36 32 36 70 78 3b 20 6d 61 78 2d ght: 626px; max-
5810: 68 65 69 67 68 74 3a 20 37 38 33 70 78 3b 22 2f height: 783px;"/
5820: 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 >..</div>.<div c
5830: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
5840: 0a 50 75 73 68 69 6e 67 20 6f 6e 65 20 6f 66 20 .Pushing one of
5850: 74 68 65 20 62 75 74 74 6f 6e 73 20 6f 6e 20 74 the buttons on t
5860: 68 65 20 6d 61 69 6e 20 64 61 73 68 62 6f 61 72 he main dashboar
5870: 64 20 77 69 6c 6c 20 62 72 69 6e 67 20 75 70 20 d will bring up
5880: 74 68 65 20 74 65 73 74 20 73 70 65 63 69 66 69 the test specifi
5890: 63 20 64 61 73 68 62 6f 61 72 64 2e 20 56 61 6c c dashboard. Val
58a0: 75 65 73 20 61 72 65 20 75 70 64 61 74 65 64 20 ues are updated
58b0: 69 6e 20 73 65 6d 69 2d 72 65 61 6c 20 74 69 6d in semi-real tim
58c0: 65 20 61 73 20 74 68 65 20 74 65 73 74 20 72 75 e as the test ru
58d0: 6e 73 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 ns..</div>.<div
58e0: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
58f0: 3e 0a 3c 69 6d 67 20 63 6c 61 73 73 3d 22 65 6d >.<img class="em
5900: 62 65 64 64 65 64 22 20 73 72 63 3d 22 64 61 73 bedded" src="das
5910: 68 62 6f 61 72 64 2d 74 65 73 74 2e 70 6e 67 22 hboard-test.png"
5920: 20 61 6c 74 3d 22 66 69 67 75 72 65 20 64 61 73 alt="figure das
5930: 68 62 6f 61 72 64 2d 74 65 73 74 2e 70 6e 67 22 hboard-test.png"
5940: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 36 style="width: 6
5950: 34 33 70 78 3b 20 6d 61 78 2d 77 69 64 74 68 3a 43px; max-width:
5960: 20 38 30 34 70 78 3b 20 68 65 69 67 68 74 3a 20 804px; height:
5970: 35 37 31 70 78 3b 20 6d 61 78 2d 68 65 69 67 68 571px; max-heigh
5980: 74 3a 20 37 31 34 70 78 3b 22 2f 3e 0a 0a 3c 2f t: 714px;"/>..</
5990: 64 69 76 3e 0a 3c 68 31 20 63 6c 61 73 73 3d 22 div>.<h1 class="
59a0: 53 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 Section">.<a cla
59b0: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
59c0: 6f 63 2d 53 65 63 74 69 6f 6e 2d 39 22 3e 39 3c oc-Section-9">9<
59d0: 2f 61 3e e2 80 83 47 65 6e 65 72 61 74 69 6e 67 /a> Generating
59e0: 20 61 6e 20 4f 70 65 6e 44 6f 63 75 6d 65 6e 74 an OpenDocument
59f0: 20 53 70 72 65 61 64 73 68 65 65 74 20 66 72 6f Spreadsheet fro
5a00: 6d 20 74 68 65 20 44 61 74 61 62 61 73 65 0a 3c m the Database.<
5a10: 2f 68 31 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d /h1>.<div class=
5a20: 22 53 74 61 6e 64 61 72 64 22 3e 0a 41 6e 64 20 "Standard">.And
5a30: 4f 70 65 6e 44 6f 63 75 6d 65 6e 74 20 6d 75 6c OpenDocument mul
5a40: 74 69 2d 70 61 6e 65 64 20 73 70 72 65 61 64 73 ti-paned spreads
5a50: 68 65 65 74 20 63 61 6e 20 62 65 20 67 65 6e 65 heet can be gene
5a60: 72 61 74 65 64 20 66 72 6f 6d 20 74 68 65 20 6d rated from the m
5a70: 65 67 61 74 65 73 74 2e 64 62 20 66 69 6c 65 20 egatest.db file
5a80: 62 79 20 72 75 6e 6e 69 6e 67 20 2d 65 78 74 72 by running -extr
5a90: 61 63 74 2d 6f 64 73 0a 3c 2f 64 69 76 3e 0a 3c act-ods.</div>.<
5aa0: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
5ab0: 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 ard">.<div class
5ac0: 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 ="listing">.<pre
5ad0: 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 class="listing"
5ae0: 3e 6d 65 67 61 74 65 73 74 20 2d 65 78 74 72 61 >megatest -extra
5af0: 63 74 2d 6f 64 73 20 72 65 73 75 6c 74 73 2e 6f ct-ods results.o
5b00: 64 73 20 3a 72 75 6e 6e 61 6d 65 20 25 20 0a 3c ds :runname % .<
5b10: 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f /pre>.</div>..</
5b20: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
5b30: 22 53 74 61 6e 64 61 72 64 22 3e 0a 59 6f 75 20 "Standard">.You
5b40: 63 61 6e 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 73 can optionally s
5b50: 70 65 63 69 66 79 20 74 68 65 20 6b 65 79 73 20 pecify the keys
5b60: 66 6f 72 20 79 6f 75 72 20 64 61 74 61 62 61 73 for your databas
5b70: 65 20 74 6f 20 6c 69 6d 69 74 20 66 75 72 74 68 e to limit furth
5b80: 65 72 20 74 68 65 20 72 75 6e 73 20 74 6f 20 65 er the runs to e
5b90: 78 74 72 61 63 74 20 69 6e 74 6f 20 74 68 65 20 xtract into the
5ba0: 73 70 72 65 61 64 73 68 65 65 74 2e 20 54 68 65 spreadsheet. The
5bb0: 20 66 69 72 73 74 20 73 68 65 65 74 20 63 6f 6e first sheet con
5bc0: 74 61 69 6e 73 20 61 6c 6c 20 74 68 65 20 72 75 tains all the ru
5bd0: 6e 20 64 61 74 61 20 61 6e 64 20 73 75 62 73 65 n data and subse
5be0: 71 75 65 6e 74 20 73 68 65 65 74 73 20 63 6f 6e quent sheets con
5bf0: 74 61 69 6e 20 64 61 74 61 20 72 6f 6c 6c 65 64 tain data rolled
5c00: 20 75 70 20 66 6f 72 20 74 68 65 20 69 6e 64 69 up for the indi
5c10: 76 69 64 75 61 6c 20 74 65 73 74 73 2e 0a 3c 2f vidual tests..</
5c20: 64 69 76 3e 0a 3c 68 31 20 63 6c 61 73 73 3d 22 div>.<h1 class="
5c30: 53 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 Section">.<a cla
5c40: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
5c50: 6f 63 2d 53 65 63 74 69 6f 6e 2d 31 30 22 3e 31 oc-Section-10">1
5c60: 30 3c 2f 61 3e e2 80 83 46 6c 6f 77 73 0a 3c 2f 0</a> Flows.</
5c70: 68 31 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 h1>.<div class="
5c80: 53 74 61 6e 64 61 72 64 22 3e 0a 41 20 66 6c 6f Standard">.A flo
5c90: 77 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 w specifies the
5ca0: 74 65 73 74 73 20 74 6f 20 72 75 6e 2c 20 74 68 tests to run, th
5cb0: 65 20 6f 72 64 65 72 20 61 6e 64 20 64 65 70 65 e order and depe
5cc0: 6e 64 65 6e 63 69 65 73 20 61 6e 64 20 69 73 20 ndencies and is
5cd0: 6d 61 6e 61 67 65 64 20 62 79 20 61 20 72 75 6e managed by a run
5ce0: 6e 69 6e 67 20 6d 65 67 61 74 65 73 74 20 70 72 ning megatest pr
5cf0: 6f 63 65 73 73 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 ocess..</div>.<h
5d00: 31 20 63 6c 61 73 73 3d 22 53 65 63 74 69 6f 6e 1 class="Section
5d10: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 ">.<a class="toc
5d20: 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 65 63 74 " name="toc-Sect
5d30: 69 6f 6e 2d 31 31 22 3e 31 31 3c 2f 61 3e e2 80 ion-11">11</a>
5d40: 83 46 6c 6f 77 20 53 70 65 63 69 66 69 63 61 74 Flow Specificat
5d50: 69 6f 6e 20 61 6e 64 20 52 75 6e 6e 69 6e 67 20 ion and Running
5d60: 28 4e 6f 74 20 72 65 6c 65 61 73 65 64 20 79 65 (Not released ye
5d70: 74 29 0a 3c 2f 68 31 3e 0a 3c 68 32 20 63 6c 61 t).</h1>.<h2 cla
5d80: 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e ss="Subsection">
5d90: 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 .<a class="toc"
5da0: 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 name="toc-Subsec
5db0: 74 69 6f 6e 2d 31 31 2e 31 22 3e 31 31 2e 31 3c tion-11.1">11.1<
5dc0: 2f 61 3e e2 80 83 57 72 69 74 65 20 79 6f 75 72 /a> Write your
5dd0: 20 66 6c 6f 77 20 66 69 6c 65 0a 3c 2f 68 32 3e flow file.</h2>
5de0: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 .<div class="Sta
5df0: 6e 64 61 72 64 22 3e 0a 66 6c 6f 77 73 2f 26 6c ndard">.flows/&l
5e00: 74 3b 66 6c 6f 77 6e 61 6d 65 26 67 74 3b 2e 63 t;flowname>.c
5e10: 6f 6e 66 69 67 0a 3c 2f 64 69 76 3e 0a 3c 64 69 onfig.</div>.<di
5e20: 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 v class="Standar
5e30: 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 d">.<div class="
5e40: 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 listing">.<pre c
5e50: 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 23 lass="listing">#
5e60: 20 46 6c 6f 77 3a 20 26 6c 74 3b 66 6c 6f 77 6e Flow: <flown
5e70: 61 6d 65 26 67 74 3b 0a 5b 66 6c 6f 77 63 6f 6e ame>.[flowcon
5e80: 66 69 67 5d 0a 23 20 74 75 72 6e 20 6f 6e 20 69 fig].# turn on i
5e90: 74 65 6d 20 6c 65 76 65 6c 20 64 65 70 65 6e 64 tem level depend
5ea0: 65 6e 63 69 65 73 0a 69 74 65 6d 64 65 70 73 20 encies.itemdeps
5eb0: 6f 6e 0a e2 80 8b 0a 5b 66 6c 6f 77 73 74 65 70 on..[flowstep
5ec0: 73 5d 0a 23 20 26 6c 74 3b 74 65 73 74 6e 61 6d s].# <testnam
5ed0: 65 26 67 74 3b 5b 2c 26 6c 74 3b 70 72 65 64 65 e>[,<prede
5ee0: 63 65 73 73 6f 72 26 67 74 3b 5d 0a e2 80 8b 0a cessor>]..
5ef0: 23 20 52 75 6e 20 74 68 65 20 74 65 73 74 20 22 # Run the test "
5f00: 63 6f 70 79 64 61 74 61 22 0a 63 6f 70 79 64 61 copydata".copyda
5f10: 74 61 0a e2 80 8b 0a 23 20 52 75 6e 20 74 68 65 ta..# Run the
5f20: 20 74 65 73 74 20 22 73 65 74 75 70 22 20 61 66 test "setup" af
5f30: 74 65 72 20 63 6f 70 79 64 61 74 61 20 63 6f 6d ter copydata com
5f40: 70 6c 65 74 65 73 20 77 69 74 68 20 50 41 53 53 pletes with PASS
5f50: 2c 20 57 41 52 4e 20 6f 72 20 57 41 49 56 45 0a , WARN or WAIVE.
5f60: 73 65 74 75 70 2c 63 6f 70 79 64 61 74 61 0a e2 setup,copydata.
5f70: 80 8b 0a 23 20 6f 6e 63 65 20 74 68 65 20 74 65 .# once the te
5f80: 73 74 20 22 73 65 74 75 70 22 20 63 6f 6d 70 6c st "setup" compl
5f90: 65 74 65 73 20 73 75 63 63 65 73 73 66 75 6c 6c etes successfull
5fa0: 79 20 72 75 6e 20 73 69 6d 31 2c 20 73 69 6d 32 y run sim1, sim2
5fb0: 20 61 6e 64 20 73 69 6d 33 0a 73 69 6d 31 2c 73 and sim3.sim1,s
5fc0: 65 74 75 70 0a 73 69 6d 32 2c 73 65 74 75 70 0a etup.sim2,setup.
5fd0: 73 69 6d 33 2c 73 65 74 75 70 0a 3c 2f 70 72 65 sim3,setup.</pre
5fe0: 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e >.</div>..</div>
5ff0: 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 73 .<h2 class="Subs
6000: 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 ection">.<a clas
6010: 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f s="toc" name="to
6020: 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 31 31 2e c-Subsection-11.
6030: 32 22 3e 31 31 2e 32 3c 2f 61 3e e2 80 83 52 75 2">11.2</a> Ru
6040: 6e 20 74 68 65 20 66 6c 6f 77 0a 3c 2f 68 32 3e n the flow.</h2>
6050: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 .<div class="Sta
6060: 6e 64 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 ndard">.<div cla
6070: 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 ss="listing">.<p
6080: 72 65 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e re class="listin
6090: 67 22 3e 6d 65 67 61 74 65 73 74 20 2d 72 75 6e g">megatest -run
60a0: 66 6c 6f 77 20 26 6c 74 3b 66 6c 6f 77 6e 61 6d flow <flownam
60b0: 65 26 67 74 3b 20 3a 46 49 45 4c 44 31 20 76 61 e> :FIELD1 va
60c0: 6c 31 20 3a 46 49 45 4c 44 32 20 76 61 6c 32 20 l1 :FIELD2 val2
60d0: 3a 72 75 6e 6e 61 6d 65 20 77 6b 33 32 2e 34 0a :runname wk32.4.
60e0: 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c </pre>.</div>..<
60f0: 2f 64 69 76 3e 0a 3c 68 31 20 63 6c 61 73 73 3d /div>.<h1 class=
6100: 22 53 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c "Section">.<a cl
6110: 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 ass="toc" name="
6120: 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 31 32 22 3e toc-Section-12">
6130: 31 32 3c 2f 61 3e e2 80 83 4d 6f 6e 69 74 6f 72 12</a> Monitor
6140: 20 62 61 73 65 64 20 72 75 6e 6e 69 6e 67 0a 3c based running.<
6150: 2f 68 31 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 /h1>.<h2 class="
6160: 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 Subsection">.<a
6170: 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 class="toc" name
6180: 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e ="toc-Subsection
6190: 2d 31 32 2e 31 22 3e 31 32 2e 31 3c 2f 61 3e e2 -12.1">12.1</a>
61a0: 80 83 4d 6f 6e 69 74 6f 72 20 6c 6f 67 69 63 0a Monitor logic.
61b0: 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 </h2>.<div class
61c0: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 4e 6f 74 ="Standard">.Not
61d0: 65 3a 20 54 68 65 20 6d 6f 6e 69 74 6f 72 20 69 e: The monitor i
61e0: 73 20 75 73 61 62 6c 65 20 62 75 74 20 69 6e 63 s usable but inc
61f0: 6f 6d 70 6c 65 74 65 20 61 73 20 6f 66 20 4d 65 omplete as of Me
6200: 67 61 74 65 73 74 20 76 31 2e 33 31 2e 20 43 6c gatest v1.31. Cl
6210: 69 63 6b 20 6f 6e 20 74 68 65 20 26 6c 64 71 75 ick on the &ldqu
6220: 6f 3b 4d 6f 6e 69 74 6f 72 26 72 64 71 75 6f 3b o;Monitor”
6230: 20 62 75 74 74 6f 6e 20 6f 6e 20 74 68 65 20 64 button on the d
6240: 61 73 68 62 6f 61 72 64 20 74 6f 20 73 74 61 72 ashboard to star
6250: 74 20 74 68 65 20 6d 6f 6e 69 74 6f 72 20 61 6e t the monitor an
6260: 64 20 67 69 76 65 20 69 74 20 61 20 74 72 79 2e d give it a try.
6270: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
6280: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c ss="Standard">.<
6290: 69 6d 67 20 63 6c 61 73 73 3d 22 65 6d 62 65 64 img class="embed
62a0: 64 65 64 22 20 73 72 63 3d 22 6d 6f 6e 69 74 6f ded" src="monito
62b0: 72 2d 73 74 61 74 65 2d 64 69 61 67 72 61 6d 2e r-state-diagram.
62c0: 70 6e 67 22 20 61 6c 74 3d 22 66 69 67 75 72 65 png" alt="figure
62d0: 20 6d 6f 6e 69 74 6f 72 2d 73 74 61 74 65 2d 64 monitor-state-d
62e0: 69 61 67 72 61 6d 2e 70 6e 67 22 20 73 74 79 6c iagram.png" styl
62f0: 65 3d 22 6d 61 78 2d 77 69 64 74 68 3a 20 33 38 e="max-width: 38
6300: 33 70 78 3b 20 6d 61 78 2d 68 65 69 67 68 74 3a 3px; max-height:
6310: 20 33 33 35 70 78 3b 22 2f 3e 0a 0a 3c 2f 64 69 335px;"/>..</di
6320: 76 3e 0a 3c 68 31 20 63 6c 61 73 73 3d 22 53 65 v>.<h1 class="Se
6330: 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 ction">.<a class
6340: 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 ="toc" name="toc
6350: 2d 53 65 63 74 69 6f 6e 2d 31 33 22 3e 31 33 3c -Section-13">13<
6360: 2f 61 3e e2 80 83 52 65 66 65 72 65 6e 63 65 0a /a> Reference.
6370: 3c 2f 68 31 3e 0a 3c 68 32 20 63 6c 61 73 73 3d </h1>.<h2 class=
6380: 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 "Subsection">.<a
6390: 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d class="toc" nam
63a0: 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69 6f e="toc-Subsectio
63b0: 6e 2d 31 33 2e 31 22 3e 31 33 2e 31 3c 2f 61 3e n-13.1">13.1</a>
63c0: e2 80 83 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e Configuration
63d0: 20 66 69 6c 65 20 53 79 6e 74 61 78 0a 3c 2f 68 file Syntax.</h
63e0: 32 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 53 2>.<div class="S
63f0: 74 61 6e 64 61 72 64 22 3e 0a 4e 6f 74 65 3a 20 tandard">.Note:
6400: 77 68 69 74 65 73 70 61 63 65 20 69 73 20 70 72 whitespace is pr
6410: 65 73 65 72 76 65 64 20 69 6e 63 6c 75 64 69 6e eserved includin
6420: 67 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 g at the end of
6430: 6c 69 6e 65 2e 20 45 6e 73 75 72 65 20 79 6f 75 line. Ensure you
6440: 72 20 65 6e 74 72 69 65 73 20 6f 6e 6c 79 20 68 r entries only h
6450: 61 76 65 20 77 68 69 74 65 73 70 61 63 65 20 61 ave whitespace a
6460: 74 20 74 68 65 20 65 6e 64 20 6f 66 20 6c 69 6e t the end of lin
6470: 65 20 77 68 65 6e 20 6e 65 65 64 65 64 20 74 6f e when needed to
6480: 20 61 76 6f 69 64 20 70 72 6f 62 6c 65 6d 73 2e avoid problems.
6490: 0a 3c 2f 64 69 76 3e 0a 3c 68 33 20 63 6c 61 73 .</div>.<h3 clas
64a0: 73 3d 22 53 75 62 73 75 62 73 65 63 74 69 6f 6e s="Subsubsection
64b0: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 ">.<a class="toc
64c0: 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 " name="toc-Subs
64d0: 75 62 73 65 63 74 69 6f 6e 2d 31 33 2e 31 2e 31 ubsection-13.1.1
64e0: 22 3e 31 33 2e 31 2e 31 3c 2f 61 3e e2 80 83 53 ">13.1.1</a> S
64f0: 65 63 74 69 6f 6e 73 0a 3c 2f 68 33 3e 0a 3c 64 ections.</h3>.<d
6500: 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 iv class="Standa
6510: 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d rd">.<div class=
6520: 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 "listing">.<pre
6530: 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e class="listing">
6540: 5b 73 65 63 74 69 6f 6e 20 6e 61 6d 65 5d 0a 3c [section name].<
6550: 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 2f /pre>.</div>..</
6560: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d div>.<div class=
6570: 22 53 74 61 6e 64 61 72 64 22 3e 0a 54 68 69 73 "Standard">.This
6580: 20 63 72 65 61 74 65 73 20 61 20 73 65 63 74 69 creates a secti
6590: 6f 6e 20 6e 61 6d 65 64 20 e2 80 9c 73 65 63 74 on named “sect
65a0: 69 6f 6e 20 6e 61 6d 65 e2 80 9d 0a 3c 2f 64 69 ion name”.</di
65b0: 76 3e 0a 3c 68 33 20 63 6c 61 73 73 3d 22 53 75 v>.<h3 class="Su
65c0: 62 73 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 bsubsection">.<a
65d0: 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d class="toc" nam
65e0: 65 3d 22 74 6f 63 2d 53 75 62 73 75 62 73 65 63 e="toc-Subsubsec
65f0: 74 69 6f 6e 2d 31 33 2e 31 2e 32 22 3e 31 33 2e tion-13.1.2">13.
6600: 31 2e 32 3c 2f 61 3e e2 80 83 56 61 72 69 61 62 1.2</a> Variab
6610: 6c 65 73 0a 3c 2f 68 33 3e 0a 3c 64 69 76 20 63 les.</h3>.<div c
6620: 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e lass="Standard">
6630: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 .<div class="lis
6640: 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 ting">.<pre clas
6650: 73 3d 22 6c 69 73 74 69 6e 67 22 3e 56 41 52 58 s="listing">VARX
6660: 20 68 61 73 20 74 68 69 73 20 76 61 6c 75 65 0a has this value.
6670: 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c </pre>.</div>..<
6680: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
6690: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 54 68 65 ="Standard">.The
66a0: 20 76 61 72 69 61 62 6c 65 20 e2 80 9c 56 41 52 variable “VAR
66b0: 58 e2 80 9d 20 77 69 6c 6c 20 68 61 76 65 20 74 X” will have t
66c0: 68 65 20 76 61 6c 75 65 20 e2 80 9c 68 61 73 20 he value “has
66d0: 74 68 69 73 20 76 61 6c 75 65 e2 80 9d 0a 3c 2f this value”.</
66e0: 64 69 76 3e 0a 3c 68 33 20 63 6c 61 73 73 3d 22 div>.<h3 class="
66f0: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 22 3e 0a Subsubsection">.
6700: 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e <a class="toc" n
6710: 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 75 62 73 ame="toc-Subsubs
6720: 65 63 74 69 6f 6e 2d 31 33 2e 31 2e 33 22 3e 31 ection-13.1.3">1
6730: 33 2e 31 2e 33 3c 2f 61 3e e2 80 83 49 6e 63 6c 3.1.3</a> Incl
6740: 75 64 65 73 0a 3c 2f 68 33 3e 0a 3c 64 69 76 20 udes.</h3>.<div
6750: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
6760: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 6c 69 >.<div class="li
6770: 73 74 69 6e 67 22 3e 0a 3c 70 72 65 20 63 6c 61 sting">.<pre cla
6780: 73 73 3d 22 6c 69 73 74 69 6e 67 22 3e 5b 69 6e ss="listing">[in
6790: 63 6c 75 64 65 20 66 69 6c 65 6e 61 6d 65 5d 0a clude filename].
67a0: 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c </pre>.</div>..<
67b0: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 /div>.<div class
67c0: 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 54 68 65 ="Standard">.The
67d0: 20 66 69 6c 65 20 6e 61 6d 65 64 20 e2 80 9c 66 file named “f
67e0: 69 6c 65 6e 61 6d 65 e2 80 9d 20 77 69 6c 6c 20 ilename” will
67f0: 62 65 20 69 6e 63 6c 75 64 65 64 20 61 73 20 69 be included as i
6800: 66 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 61 f part of the ca
6810: 6c 6c 69 6e 67 20 66 69 6c 65 2e 20 4e 4f 54 45 lling file. NOTE
6820: 3a 20 54 68 69 73 20 6d 65 61 6e 73 20 6e 6f 20 : This means no
6830: 73 65 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 6e section can be n
6840: 61 6d 65 64 20 e2 80 9c 69 6e 63 6c 75 64 65 20 amed “include
6850: e2 80 9c 20 28 77 69 74 68 20 74 68 65 20 77 68 “ (with the wh
6860: 69 74 65 73 70 61 63 65 29 2e 0a 3c 2f 64 69 76 itespace)..</div
6870: 3e 0a 3c 68 33 20 63 6c 61 73 73 3d 22 53 75 62 >.<h3 class="Sub
6880: 73 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 subsection">.<a
6890: 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 class="toc" name
68a0: 3d 22 74 6f 63 2d 53 75 62 73 75 62 73 65 63 74 ="toc-Subsubsect
68b0: 69 6f 6e 2d 31 33 2e 31 2e 34 22 3e 31 33 2e 31 ion-13.1.4">13.1
68c0: 2e 34 3c 2f 61 3e e2 80 83 53 65 74 74 69 6e 67 .4</a> Setting
68d0: 20 61 20 76 61 72 69 61 62 6c 65 20 62 79 20 72 a variable by r
68e0: 75 6e 6e 69 6e 67 20 61 20 63 6f 6d 6d 61 6e 64 unning a command
68f0: 0a 3c 2f 68 33 3e 0a 3c 64 69 76 20 63 6c 61 73 .</h3>.<div clas
6900: 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c 64 s="Standard">.<d
6910: 69 76 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e iv class="listin
6920: 67 22 3e 0a 3c 70 72 65 20 63 6c 61 73 73 3d 22 g">.<pre class="
6930: 6c 69 73 74 69 6e 67 22 3e 56 41 52 4e 41 4d 45 listing">VARNAME
6940: 20 5b 73 79 73 74 65 6d 20 6c 73 20 2f 74 6d 70 [system ls /tmp
6950: 5d 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a ].</pre>.</div>.
6960: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
6970: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 54 ss="Standard">.T
6980: 68 65 20 76 61 72 69 61 62 6c 65 20 e2 80 9c 56 he variable “V
6990: 41 52 4e 41 4d 45 e2 80 9d 20 77 69 6c 6c 20 67 ARNAME” will g
69a0: 65 74 20 61 20 76 61 6c 75 65 20 63 72 65 61 74 et a value creat
69b0: 65 64 20 62 79 20 74 68 65 20 55 6e 69 78 20 63 ed by the Unix c
69c0: 6f 6d 6d 61 6e 64 20 e2 80 9c 6c 73 20 2f 74 6d ommand “ls /tm
69d0: 70 e2 80 9d 2e 20 41 6c 6c 20 6c 69 6e 65 73 20 p”. All lines
69e0: 6f 66 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 of output from t
69f0: 68 65 20 63 6f 6d 6d 61 6e 64 20 77 69 6c 6c 20 he command will
6a00: 62 65 20 6a 6f 69 6e 65 64 20 77 69 74 68 20 61 be joined with a
6a10: 20 73 70 61 63 65 2e 0a 3c 2f 64 69 76 3e 0a 3c space..</div>.<
6a20: 68 33 20 63 6c 61 73 73 3d 22 53 75 62 73 75 62 h3 class="Subsub
6a30: 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 section">.<a cla
6a40: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
6a50: 6f 63 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e oc-Subsubsection
6a60: 2d 31 33 2e 31 2e 35 22 3e 31 33 2e 31 2e 35 3c -13.1.5">13.1.5<
6a70: 2f 61 3e e2 80 83 4e 6f 74 65 73 0a 3c 2f 68 33 /a> Notes.</h3
6a80: 3e 0a 3c 75 6c 3e 0a 3c 6c 69 3e 0a 53 6f 6d 65 >.<ul>.<li>.Some
6a90: 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 69 variables are i
6aa0: 6e 66 65 72 65 64 20 61 73 20 6c 69 73 74 73 2e nfered as lists.
6ab0: 20 45 61 63 68 20 74 6f 6b 65 6e 20 6f 6e 20 74 Each token on t
6ac0: 68 65 20 6c 69 6e 65 20 73 65 70 61 72 61 74 65 he line separate
6ad0: 64 20 62 79 20 77 68 69 74 65 73 70 61 63 65 20 d by whitespace
6ae0: 77 69 6c 6c 20 62 65 20 6d 65 6d 62 65 72 20 6f will be member o
6af0: 66 20 74 68 65 20 6c 69 73 74 2e 0a 3c 2f 6c 69 f the list..</li
6b00: 3e 0a 3c 6c 69 3e 0a 43 6f 6d 6d 65 6e 74 73 20 >.<li>.Comments
6b10: 28 6c 69 6e 65 73 20 73 74 61 72 74 69 6e 67 20 (lines starting
6b20: 77 69 74 68 20 23 29 20 61 6e 64 20 62 6c 61 6e with #) and blan
6b30: 6b 20 6c 69 6e 65 73 20 61 72 65 20 69 67 6e 6f k lines are igno
6b40: 72 65 64 2e 0a 3c 2f 6c 69 3e 0a 0a 3c 2f 75 6c red..</li>..</ul
6b50: 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 75 62 >.<h2 class="Sub
6b60: 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 section">.<a cla
6b70: 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 ss="toc" name="t
6b80: 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 31 33 oc-Subsection-13
6b90: 2e 32 22 3e 31 33 2e 32 3c 2f 61 3e e2 80 83 45 .2">13.2</a> E
6ba0: 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 nvironment varia
6bb0: 62 6c 65 73 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 bles.</h2>.<div
6bc0: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
6bd0: 3e 0a 3c 74 61 62 6c 65 3e 0a 3c 74 72 3e 0a 3c >.<table>.<tr>.<
6be0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
6bf0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
6c00: 6c 65 3d 22 77 69 64 74 68 3a 20 31 30 25 3b 22 le="width: 10%;"
6c10: 3e 0a 56 61 72 69 61 62 6c 65 0a 3c 2f 74 64 3e >.Variable.</td>
6c20: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
6c30: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 " valign="top" s
6c40: 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 35 30 25 tyle="width: 50%
6c50: 3b 22 3e 0a 50 75 72 70 6f 73 65 0a 3c 2f 74 64 ;">.Purpose.</td
6c60: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
6c70: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
6c80: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
6c90: 65 3d 22 77 69 64 74 68 3a 20 31 30 25 3b 22 3e e="width: 10%;">
6ca0: 0a 4d 54 5f 43 4d 44 49 4e 46 4f 0a 3c 2f 74 64 .MT_CMDINFO.</td
6cb0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
6cc0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 t" valign="top"
6cd0: 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 35 30 style="width: 50
6ce0: 25 3b 22 3e 0a 43 6f 6e 76 65 79 73 20 74 65 73 %;">.Conveys tes
6cf0: 74 20 76 61 72 69 61 62 6c 65 73 20 74 6f 20 74 t variables to t
6d00: 68 65 20 6d 65 67 61 74 65 73 74 20 74 65 73 74 he megatest test
6d10: 20 72 75 6e 6e 65 72 2e 0a 3c 2f 74 64 3e 0a 0a runner..</td>..
6d20: 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 </tr>.<tr>.<td a
6d30: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
6d40: 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 gn="top" style="
6d50: 77 69 64 74 68 3a 20 31 30 25 3b 22 3e 0a 4d 54 width: 10%;">.MT
6d60: 5f 54 45 53 54 5f 52 55 4e 5f 44 49 52 0a 3c 2f _TEST_RUN_DIR.</
6d70: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
6d80: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
6d90: 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 " style="width:
6da0: 35 30 25 3b 22 3e 0a 44 69 72 65 63 74 6f 72 79 50%;">.Directory
6db0: 20 61 73 73 69 67 6e 65 64 20 62 79 20 6d 65 67 assigned by meg
6dc0: 61 74 65 73 74 20 66 6f 72 20 74 68 65 20 74 65 atest for the te
6dd0: 73 74 20 74 6f 20 72 75 6e 2e 0a 3c 2f 74 64 3e st to run..</td>
6de0: 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 ..</tr>.<tr>.<td
6df0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
6e00: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
6e10: 3d 22 77 69 64 74 68 3a 20 31 30 25 3b 22 3e 0a ="width: 10%;">.
6e20: 4d 54 5f 54 45 53 54 5f 4e 41 4d 45 0a 3c 2f 74 MT_TEST_NAME.</t
6e30: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
6e40: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
6e50: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 35 style="width: 5
6e60: 30 25 3b 22 3e 0a 4e 61 6d 65 20 6f 66 20 74 68 0%;">.Name of th
6e70: 65 20 74 65 73 74 2c 20 63 6f 72 72 6f 73 70 6f e test, corrospo
6e80: 6e 64 73 20 74 6f 20 74 68 65 20 64 69 72 65 63 nds to the direc
6e90: 74 6f 72 79 20 6e 61 6d 65 20 75 6e 64 65 72 20 tory name under
6ea0: 74 65 73 74 73 2e 0a 3c 2f 74 64 3e 0a 0a 3c 2f tests..</td>..</
6eb0: 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 tr>.<tr>.<td ali
6ec0: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
6ed0: 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 ="top" style="wi
6ee0: 64 74 68 3a 20 31 30 25 3b 22 3e 0a 4d 54 5f 49 dth: 10%;">.MT_I
6ef0: 54 45 4d 5f 49 4e 46 4f 0a 3c 2f 74 64 3e 0a 3c TEM_INFO.</td>.<
6f00: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
6f10: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
6f20: 6c 65 3d 22 77 69 64 74 68 3a 20 35 30 25 3b 22 le="width: 50%;"
6f30: 3e 0a 49 74 65 72 61 74 65 64 20 74 65 73 74 73 >.Iterated tests
6f40: 20 77 69 6c 6c 20 73 65 74 20 74 68 69 73 20 74 will set this t
6f50: 6f 20 61 20 73 65 71 75 65 6e 63 65 20 6f 66 20 o a sequence of
6f60: 6b 65 79 2f 76 61 6c 75 65 73 20 28 28 4b 45 59 key/values ((KEY
6f70: 20 76 61 6c 29 20 2e 2e 2e 29 20 0a 3c 2f 74 64 val) ...) .</td
6f80: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
6f90: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
6fa0: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
6fb0: 65 3d 22 77 69 64 74 68 3a 20 31 30 25 3b 22 3e e="width: 10%;">
6fc0: 0a 4d 54 5f 52 55 4e 5f 41 52 45 41 5f 48 4f 4d .MT_RUN_AREA_HOM
6fd0: 45 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 E.</td>.<td alig
6fe0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
6ff0: 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 "top" style="wid
7000: 74 68 3a 20 35 30 25 3b 22 3e 0a 44 69 72 65 63 th: 50%;">.Direc
7010: 74 6f 72 79 20 77 68 65 72 65 20 6d 65 67 61 74 tory where megat
7020: 65 73 74 20 77 61 73 20 6c 61 75 6e 63 68 65 64 est was launched
7030: 20 66 72 6f 6d 20 61 6e 64 20 77 68 65 72 65 20 from and where
7040: 74 68 65 20 74 65 73 74 73 20 63 6f 64 65 20 63 the tests code c
7050: 61 6e 20 62 65 20 66 6f 75 6e 64 0a 3c 2f 74 64 an be found.</td
7060: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
7070: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
7080: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
7090: 65 3d 22 77 69 64 74 68 3a 20 31 30 25 3b 22 3e e="width: 10%;">
70a0: 0a 4d 54 5f 52 55 4e 4e 41 4d 45 0a 3c 2f 74 64 .MT_RUNNAME.</td
70b0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
70c0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 t" valign="top"
70d0: 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 35 30 style="width: 50
70e0: 25 3b 22 3e 0a 4e 61 6d 65 20 6f 66 20 74 68 69 %;">.Name of thi
70f0: 73 20 72 75 6e 20 61 73 20 73 65 74 20 62 79 20 s run as set by
7100: 74 68 65 20 3a 72 75 6e 6e 61 6d 65 20 70 61 72 the :runname par
7110: 61 6d 65 74 65 72 0a 3c 2f 74 64 3e 0a 0a 3c 2f ameter.</td>..</
7120: 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 tr>.<tr>.<td ali
7130: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
7140: 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 ="top" style="wi
7150: 64 74 68 3a 20 31 30 25 3b 22 3e 0a 4d 54 5f 4d dth: 10%;">.MT_M
7160: 45 47 41 54 45 53 54 0a 3c 2f 74 64 3e 0a 3c 74 EGATEST.</td>.<t
7170: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
7180: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
7190: 65 3d 22 77 69 64 74 68 3a 20 35 30 25 3b 22 3e e="width: 50%;">
71a0: 0a 50 61 74 68 2f 46 69 6c 65 6e 61 6d 65 20 74 .Path/Filename t
71b0: 6f 20 6d 65 67 61 74 65 73 74 20 65 78 65 63 75 o megatest execu
71c0: 74 61 62 6c 65 2e 20 46 6f 75 6e 64 20 65 69 74 table. Found eit
71d0: 68 65 72 20 66 72 6f 6d 20 63 61 6c 6c 65 64 20 her from called
71e0: 70 61 74 68 20 6f 72 20 62 75 74 20 75 73 69 6e path or but usin
71f0: 67 20 74 68 65 20 e2 80 9c 65 78 65 63 74 75 61 g the “exectua
7200: 62 6c 65 e2 80 9d 20 6b 65 79 77 6f 72 64 20 69 ble” keyword i
7210: 6e 20 74 68 65 20 5b 73 65 74 75 70 5d 20 73 65 n the [setup] se
7220: 63 74 69 6f 6e 2e 0a 3c 2f 74 64 3e 0a 0a 3c 2f ction..</td>..</
7230: 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 tr>.<tr>.<td ali
7240: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
7250: 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 ="top" style="wi
7260: 64 74 68 3a 20 31 30 25 3b 22 3e 0a 26 6c 74 3b dth: 10%;">.<
7270: 66 69 65 6c 64 31 26 67 74 3b 20 2e 2e 2e 2e 0a field1> .....
7280: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
7290: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
72a0: 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 op" style="width
72b0: 3a 20 35 30 25 3b 22 3e 0a 54 68 65 20 66 69 65 : 50%;">.The fie
72c0: 6c 64 20 76 61 6c 75 65 73 20 61 73 20 73 65 74 ld values as set
72d0: 20 6f 6e 20 74 68 65 20 6d 65 67 61 74 65 73 74 on the megatest
72e0: 20 2d 72 75 6e 61 6c 6c 20 63 6f 6d 6d 61 6e 64 -runall command
72f0: 20 6c 69 6e 65 20 28 65 2e 67 2e 20 3a 66 69 65 line (e.g. :fie
7300: 6c 64 31 20 61 62 63 29 0a 3c 2f 74 64 3e 0a 0a ld1 abc).</td>..
7310: 3c 2f 74 72 3e 0a 0a 3c 2f 74 61 62 6c 65 3e 0a </tr>..</table>.
7320: 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 73 .</div>.<h2 clas
7330: 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a s="Subsection">.
7340: 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e <a class="toc" n
7350: 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 ame="toc-Subsect
7360: 69 6f 6e 2d 31 33 2e 33 22 3e 31 33 2e 33 3c 2f ion-13.3">13.3</
7370: 61 3e e2 80 83 6d 65 67 61 74 65 73 74 2e 63 6f a> megatest.co
7380: 6e 66 69 67 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 nfig.</h2>.<div
7390: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
73a0: 3e 0a 3c 74 61 62 6c 65 3e 0a 3c 74 72 3e 0a 3c >.<table>.<tr>.<
73b0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
73c0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
73d0: 6c 65 3d 22 77 69 64 74 68 3a 20 31 30 25 3b 22 le="width: 10%;"
73e0: 3e 0a 73 65 63 74 69 6f 6e 0a 3c 2f 74 64 3e 0a >.section.</td>.
73f0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
7400: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 valign="top" st
7410: 79 6c 65 3d 22 77 69 64 74 68 3a 20 31 35 25 3b yle="width: 15%;
7420: 22 3e 0a 76 61 72 69 61 62 6c 65 0a 3c 2f 74 64 ">.variable.</td
7430: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
7440: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 t" valign="top"
7450: 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 32 30 style="width: 20
7460: 25 3b 22 3e 0a 76 61 6c 75 65 0a 3c 2f 74 64 3e %;">.value.</td>
7470: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
7480: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 " valign="top" s
7490: 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 36 25 3b tyle="width: 6%;
74a0: 22 3e 0a 72 65 71 75 69 72 65 64 0a 3c 2f 74 64 ">.required.</td
74b0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
74c0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 t" valign="top"
74d0: 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 32 30 style="width: 20
74e0: 25 3b 22 3e 0a 63 6f 6d 6d 65 6e 74 0a 3c 2f 74 %;">.comment.</t
74f0: 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c d>..</tr>.<tr>.<
7500: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
7510: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
7520: 6c 65 3d 22 77 69 64 74 68 3a 20 31 30 25 3b 22 le="width: 10%;"
7530: 3e 0a 5b 73 65 74 75 70 5d 0a 3c 2f 74 64 3e 0a >.[setup].</td>.
7540: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
7550: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 valign="top" st
7560: 79 6c 65 3d 22 77 69 64 74 68 3a 20 31 35 25 3b yle="width: 15%;
7570: 22 3e 0a 6d 61 78 5f 63 6f 6e 63 75 72 72 65 6e ">.max_concurren
7580: 74 5f 6a 6f 62 73 0a 3c 2f 74 64 3e 0a 3c 74 64 t_jobs.</td>.<td
7590: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
75a0: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
75b0: 3d 22 77 69 64 74 68 3a 20 32 30 25 3b 22 3e 0a ="width: 20%;">.
75c0: 69 66 20 76 61 72 69 61 62 6c 65 20 69 73 20 6e if variable is n
75d0: 6f 74 20 64 65 66 69 6e 65 64 20 6e 6f 20 6c 69 ot defined no li
75e0: 6d 69 74 20 6f 6e 20 6a 6f 62 73 0a 3c 2f 74 64 mit on jobs.</td
75f0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
7600: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 t" valign="top"
7610: 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 36 25 style="width: 6%
7620: 3b 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 ;">.no.</td>.<td
7630: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
7640: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
7650: 3d 22 77 69 64 74 68 3a 20 32 30 25 3b 22 3e 0a ="width: 20%;">.
7660: 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 .</td>..</tr>.<t
7670: 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 r>.<td align="le
7680: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
7690: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 31 style="width: 1
76a0: 30 25 3b 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 0%;">..</td>.<td
76b0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
76c0: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
76d0: 3d 22 77 69 64 74 68 3a 20 31 35 25 3b 22 3e 0a ="width: 15%;">.
76e0: 65 78 65 63 75 74 61 62 6c 65 0a 3c 2f 74 64 3e executable.</td>
76f0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
7700: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 " valign="top" s
7710: 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 32 30 25 tyle="width: 20%
7720: 3b 22 3e 0a 66 75 6c 6c 20 70 61 74 68 20 74 6f ;">.full path to
7730: 20 6d 65 67 61 74 65 73 74 20 62 69 6e 61 72 79 megatest binary
7740: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
7750: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
7760: 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 top" style="widt
7770: 68 3a 20 36 25 3b 22 3e 0a 6e 6f 0a 3c 2f 74 64 h: 6%;">.no.</td
7780: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
7790: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 t" valign="top"
77a0: 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 32 30 style="width: 20
77b0: 25 3b 22 3e 0a 55 73 65 20 6f 6e 6c 79 20 69 66 %;">.Use only if
77c0: 20 6e 65 63 65 73 73 61 72 79 2c 20 6d 65 67 61 necessary, mega
77d0: 74 65 73 74 20 77 69 6c 6c 20 65 78 74 72 61 63 test will extrac
77e0: 74 20 74 68 65 20 6c 6f 63 61 74 69 6f 6e 20 66 t the location f
77f0: 72 6f 6d 20 77 68 65 72 65 20 69 74 20 75 73 65 rom where it use
7800: 64 20 74 6f 20 6c 61 75 6e 63 68 20 61 6e 64 20 d to launch and
7810: 61 64 64 20 61 70 70 65 6e 64 20 74 68 61 74 20 add append that
7820: 74 6f 20 74 68 65 20 50 41 54 48 20 66 6f 72 20 to the PATH for
7830: 74 65 73 74 20 72 75 6e 73 2e 0a 3c 2f 74 64 3e test runs..</td>
7840: 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 ..</tr>.<tr>.<td
7850: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
7860: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
7870: 3d 22 77 69 64 74 68 3a 20 31 30 25 3b 22 3e 0a ="width: 10%;">.
7880: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
7890: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
78a0: 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 top" style="widt
78b0: 68 3a 20 31 35 25 3b 22 3e 0a 72 75 6e 73 64 69 h: 15%;">.runsdi
78c0: 72 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 r.</td>.<td alig
78d0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
78e0: 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 "top" style="wid
78f0: 74 68 3a 20 32 30 25 3b 22 3e 0a 66 75 6c 6c 20 th: 20%;">.full
7900: 70 61 74 68 20 74 6f 20 77 68 65 72 65 20 74 68 path to where th
7910: 65 20 6c 69 6e 6b 20 74 72 65 65 20 74 6f 20 61 e link tree to a
7920: 6c 6c 20 72 75 6e 73 20 77 69 6c 6c 20 62 65 20 ll runs will be
7930: 63 72 65 61 74 65 64 0a 3c 2f 74 64 3e 0a 3c 74 created.</td>.<t
7940: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
7950: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
7960: 65 3d 22 77 69 64 74 68 3a 20 36 25 3b 22 3e 0a e="width: 6%;">.
7970: 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 no.</td>.<td ali
7980: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
7990: 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 ="top" style="wi
79a0: 64 74 68 3a 20 32 30 25 3b 22 3e 0a 42 65 63 61 dth: 20%;">.Beca
79b0: 75 73 65 20 79 6f 75 72 20 72 75 6e 73 20 6d 61 use your runs ma
79c0: 79 20 62 65 20 73 70 72 65 61 64 20 6f 75 74 20 y be spread out
79d0: 6f 76 65 72 20 73 65 76 65 72 61 6c 20 64 69 73 over several dis
79e0: 6b 20 70 61 72 74 69 74 69 6f 6e 73 20 61 20 63 k partitions a c
79f0: 65 6e 74 72 61 6c 20 6c 69 6e 6b 20 74 72 65 65 entral link tree
7a00: 20 69 73 20 63 72 65 61 74 65 64 20 74 6f 20 6d is created to m
7a10: 61 6b 65 20 66 69 6e 64 69 6e 67 20 61 6c 6c 20 ake finding all
7a20: 74 68 65 20 72 75 6e 73 20 65 61 73 79 2e 0a 3c the runs easy..<
7a30: 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e /td>..</tr>.<tr>
7a40: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
7a50: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 " valign="top" s
7a60: 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 31 30 25 tyle="width: 10%
7a70: 3b 22 3e 0a 5b 66 69 65 6c 64 73 5d 0a 3c 2f 74 ;">.[fields].</t
7a80: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
7a90: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
7aa0: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 31 style="width: 1
7ab0: 35 25 3b 22 3e 0a 73 74 72 69 6e 67 20 6f 66 20 5%;">.string of
7ac0: 6c 65 74 74 65 72 73 2c 20 6e 75 6d 62 65 72 73 letters, numbers
7ad0: 20 61 6e 64 20 75 6e 64 65 72 73 63 6f 72 65 0a and underscore.
7ae0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
7af0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
7b00: 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 op" style="width
7b10: 3a 20 32 30 25 3b 22 3e 0a 73 74 72 69 6e 67 20 : 20%;">.string
7b20: 6f 66 20 6c 65 74 74 65 72 73 2c 20 6e 75 6d 62 of letters, numb
7b30: 65 72 73 20 61 6e 64 20 75 6e 64 65 72 73 63 6f ers and undersco
7b40: 72 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 re.</td>.<td ali
7b50: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
7b60: 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 ="top" style="wi
7b70: 64 74 68 3a 20 36 25 3b 22 3e 0a 61 74 20 6c 65 dth: 6%;">.at le
7b80: 61 73 74 20 6f 6e 65 0a 3c 2f 74 64 3e 0a 3c 74 ast one.</td>.<t
7b90: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
7ba0: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
7bb0: 65 3d 22 77 69 64 74 68 3a 20 32 30 25 3b 22 3e e="width: 20%;">
7bc0: 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c ..</td>..</tr>.<
7bd0: 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c tr>.<td align="l
7be0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
7bf0: 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 " style="width:
7c00: 31 30 25 3b 22 3e 0a 5b 6a 6f 62 74 6f 6f 6c 73 10%;">.[jobtools
7c10: 5d 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 ].</td>.<td alig
7c20: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
7c30: 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 "top" style="wid
7c40: 74 68 3a 20 31 35 25 3b 22 3e 0a 6c 61 75 6e 63 th: 15%;">.launc
7c50: 68 65 72 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c her.</td>.<td al
7c60: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
7c70: 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 n="top" style="w
7c80: 69 64 74 68 3a 20 32 30 25 3b 22 3e 0a 63 6f 6d idth: 20%;">.com
7c90: 6d 61 6e 64 20 6c 69 6e 65 20 75 73 65 64 20 74 mand line used t
7ca0: 6f 20 6c 61 75 6e 63 68 20 6a 6f 62 73 20 2d 20 o launch jobs -
7cb0: 74 68 65 20 6a 6f 62 20 63 6f 6d 6d 61 6e 64 20 the job command
7cc0: 28 6d 65 67 61 74 65 73 74 20 2d 65 78 65 63 75 (megatest -execu
7cd0: 74 65 29 20 77 69 6c 6c 20 62 65 20 61 70 70 65 te) will be appe
7ce0: 6e 64 65 64 20 74 6f 20 74 68 69 73 0a 3c 2f 74 nded to this.</t
7cf0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
7d00: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
7d10: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 36 style="width: 6
7d20: 25 3b 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 %;">.no.</td>.<t
7d30: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
7d40: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
7d50: 65 3d 22 77 69 64 74 68 3a 20 32 30 25 3b 22 3e e="width: 20%;">
7d60: 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c ..</td>..</tr>.<
7d70: 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c tr>.<td align="l
7d80: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
7d90: 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 " style="width:
7da0: 31 30 25 3b 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 10%;">..</td>.<t
7db0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
7dc0: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
7dd0: 65 3d 22 77 69 64 74 68 3a 20 31 35 25 3b 22 3e e="width: 15%;">
7de0: 0a 77 6f 72 6b 68 6f 73 74 73 0a 3c 2f 74 64 3e .workhosts.</td>
7df0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
7e00: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 " valign="top" s
7e10: 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 32 30 25 tyle="width: 20%
7e20: 3b 22 3e 0a 6c 69 73 74 20 6f 66 20 68 6f 73 74 ;">.list of host
7e30: 6e 61 6d 65 73 20 74 6f 20 72 75 6e 20 6a 6f 62 names to run job
7e40: 73 20 6f 6e 20 4e 4f 54 20 53 55 50 50 4f 52 54 s on NOT SUPPORT
7e50: 45 44 20 52 49 47 48 54 20 4e 4f 57 0a 3c 2f 74 ED RIGHT NOW.</t
7e60: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
7e70: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
7e80: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 36 style="width: 6
7e90: 25 3b 22 3e 0a 6e 2f 61 0a 3c 2f 74 64 3e 0a 3c %;">.n/a.</td>.<
7ea0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
7eb0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
7ec0: 6c 65 3d 22 77 69 64 74 68 3a 20 32 30 25 3b 22 le="width: 20%;"
7ed0: 3e 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a >..</td>..</tr>.
7ee0: 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 <tr>.<td align="
7ef0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
7f00: 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a p" style="width:
7f10: 20 31 30 25 3b 22 3e 0a 5b 6a 6f 62 67 72 6f 75 10%;">.[jobgrou
7f20: 70 73 5d 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c ps].</td>.<td al
7f30: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
7f40: 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 n="top" style="w
7f50: 69 64 74 68 3a 20 31 35 25 3b 22 3e 0a 73 74 72 idth: 15%;">.str
7f60: 69 6e 67 20 6f 66 20 6c 65 74 74 65 72 73 2c 20 ing of letters,
7f70: 6e 75 6d 62 65 72 73 20 61 6e 64 20 75 6e 64 65 numbers and unde
7f80: 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a 3c 74 64 rscore.</td>.<td
7f90: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
7fa0: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
7fb0: 3d 22 77 69 64 74 68 3a 20 32 30 25 3b 22 3e 0a ="width: 20%;">.
7fc0: 6e 75 6d 62 65 72 0a 3c 2f 74 64 3e 0a 3c 74 64 number.</td>.<td
7fd0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
7fe0: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
7ff0: 3d 22 77 69 64 74 68 3a 20 36 25 3b 22 3e 0a 6e ="width: 6%;">.n
8000: 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 o.</td>.<td alig
8010: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
8020: 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 "top" style="wid
8030: 74 68 3a 20 32 30 25 3b 22 3e 0a 43 6f 6e 74 72 th: 20%;">.Contr
8040: 6f 6c 20 6e 75 6d 62 65 72 20 6f 66 20 6a 6f 62 ol number of job
8050: 73 20 61 6c 6c 6f 77 65 64 20 74 6f 20 63 6f 6e s allowed to con
8060: 63 75 72 72 65 6e 74 6c 79 20 72 75 6e 20 69 6e currently run in
8070: 20 63 61 74 65 67 6f 72 69 65 73 2e 20 53 65 65 categories. See
8080: 20 5b 6a 6f 62 67 72 6f 75 70 5d 20 69 6e 20 74 [jobgroup] in t
8090: 65 73 74 63 6f 6e 66 69 67 0a 3c 2f 74 64 3e 0a estconfig.</td>.
80a0: 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 .</tr>.<tr>.<td
80b0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
80c0: 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d ign="top" style=
80d0: 22 77 69 64 74 68 3a 20 31 30 25 3b 22 3e 0a 5b "width: 10%;">.[
80e0: 65 6e 76 2d 6f 76 65 72 72 69 64 65 5d 0a 3c 2f env-override].</
80f0: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
8100: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
8110: 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 " style="width:
8120: 31 35 25 3b 22 3e 0a 73 74 72 69 6e 67 20 6f 66 15%;">.string of
8130: 20 6c 65 74 74 65 72 73 2c 20 6e 75 6d 62 65 72 letters, number
8140: 73 20 61 6e 64 20 75 6e 64 65 72 73 63 6f 72 65 s and underscore
8150: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
8160: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
8170: 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 top" style="widt
8180: 68 3a 20 32 30 25 3b 22 3e 0a 61 6e 79 20 73 74 h: 20%;">.any st
8190: 72 69 6e 67 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 ring.</td>.<td a
81a0: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
81b0: 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 gn="top" style="
81c0: 77 69 64 74 68 3a 20 36 25 3b 22 3e 0a 6e 6f 0a width: 6%;">.no.
81d0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
81e0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
81f0: 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 op" style="width
8200: 3a 20 32 30 25 3b 22 3e 0a 54 68 65 73 65 20 61 : 20%;">.These a
8210: 72 65 20 73 65 74 20 6f 6e 20 74 68 65 20 74 65 re set on the te
8220: 73 74 20 6c 61 75 6e 63 68 69 6e 67 20 6d 61 63 st launching mac
8230: 68 69 6e 65 2c 20 6e 6f 74 20 74 68 65 20 74 65 hine, not the te
8240: 73 74 20 72 75 6e 6e 69 6e 67 20 6d 61 63 68 69 st running machi
8250: 6e 65 2e 20 54 79 70 69 63 61 6c 20 75 73 61 67 ne. Typical usag
8260: 65 20 69 73 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 e is to control
8270: 74 68 65 20 68 6f 73 74 20 6f 72 20 72 75 6e 20 the host or run
8280: 71 75 65 75 65 20 66 6f 72 20 6c 61 75 6e 63 68 queue for launch
8290: 69 6e 67 20 74 65 73 74 73 2e 20 54 68 65 73 65 ing tests. These
82a0: 20 76 61 6c 75 65 73 20 77 69 6c 6c 20 6e 6f 74 values will not
82b0: 20 62 65 20 73 65 65 6e 20 62 79 20 74 68 65 20 be seen by the
82c0: 74 65 73 74 20 77 68 65 6e 20 69 74 20 72 75 6e test when it run
82d0: 73 2e 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a s..</td>..</tr>.
82e0: 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 <tr>.<td align="
82f0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
8300: 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a p" style="width:
8310: 20 31 30 25 3b 22 3e 0a 5b 64 69 73 6b 73 5d 0a 10%;">.[disks].
8320: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
8330: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
8340: 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 op" style="width
8350: 3a 20 31 35 25 3b 22 3e 0a 73 74 72 69 6e 67 20 : 15%;">.string
8360: 6f 66 20 6c 65 74 74 65 72 73 2c 20 6e 75 6d 62 of letters, numb
8370: 65 72 73 20 61 6e 64 20 75 6e 64 65 72 73 63 6f ers and undersco
8380: 72 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 re.</td>.<td ali
8390: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
83a0: 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 ="top" style="wi
83b0: 64 74 68 3a 20 32 30 25 3b 22 3e 0a 61 20 76 61 dth: 20%;">.a va
83c0: 6c 69 64 20 70 61 74 68 20 77 72 69 74 61 62 6c lid path writabl
83d0: 65 20 62 79 20 74 68 65 20 74 65 73 74 20 6c 61 e by the test la
83e0: 75 6e 63 68 69 6e 67 20 70 72 6f 63 65 73 73 20 unching process
83f0: 61 6e 64 20 62 79 20 74 68 65 20 74 65 73 74 20 and by the test
8400: 70 72 6f 63 65 73 73 0a 3c 2f 74 64 3e 0a 3c 74 process.</td>.<t
8410: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
8420: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
8430: 65 3d 22 77 69 64 74 68 3a 20 36 25 3b 22 3e 0a e="width: 6%;">.
8440: 79 65 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c yes.</td>.<td al
8450: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
8460: 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 n="top" style="w
8470: 69 64 74 68 3a 20 32 30 25 3b 22 3e 0a 54 68 65 idth: 20%;">.The
8480: 20 64 69 73 6b 20 75 73 61 67 65 20 62 61 6c 61 disk usage bala
8490: 6e 63 69 6e 67 20 61 6c 67 6f 72 69 74 68 6d 20 ncing algorithm
84a0: 69 73 20 74 6f 20 63 68 6f 6f 73 65 20 74 68 65 is to choose the
84b0: 20 64 69 73 6b 20 77 69 74 68 20 74 68 65 20 6c disk with the l
84c0: 65 61 73 74 20 73 70 61 63 65 20 66 6f 72 20 65 east space for e
84d0: 61 63 68 20 74 65 73 74 20 72 75 6e 2e 20 0a 3c ach test run. .<
84e0: 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 0a 3c 2f 74 /td>..</tr>..</t
84f0: 61 62 6c 65 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 68 able>..</div>.<h
8500: 32 20 63 6c 61 73 73 3d 22 53 75 62 73 65 63 74 2 class="Subsect
8510: 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 ion">.<a class="
8520: 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 toc" name="toc-S
8530: 75 62 73 65 63 74 69 6f 6e 2d 31 33 2e 34 22 3e ubsection-13.4">
8540: 31 33 2e 34 3c 2f 61 3e e2 80 83 72 75 6e 63 6f 13.4</a> runco
8550: 6e 66 69 67 73 2e 63 6f 6e 66 69 67 20 66 69 6c nfigs.config fil
8560: 65 0a 3c 2f 68 32 3e 0a 3c 64 69 76 20 63 6c 61 e.</h2>.<div cla
8570: 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a 3c ss="Standard">.<
8580: 74 61 62 6c 65 3e 0a 3c 74 72 3e 0a 3c 74 64 20 table>.<tr>.<td
8590: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
85a0: 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d ign="top" style=
85b0: 22 77 69 64 74 68 3a 20 32 30 25 3b 22 3e 0a 73 "width: 20%;">.s
85c0: 65 63 74 69 6f 6e 0a 3c 2f 74 64 3e 0a 3c 74 64 ection.</td>.<td
85d0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
85e0: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
85f0: 3d 22 77 69 64 74 68 3a 20 31 32 25 3b 22 3e 0a ="width: 12%;">.
8600: 76 61 72 69 61 62 6c 65 0a 3c 2f 74 64 3e 0a 3c variable.</td>.<
8610: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
8620: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
8630: 6c 65 3d 22 77 69 64 74 68 3a 20 33 25 3b 22 3e le="width: 3%;">
8640: 0a 76 61 6c 75 65 0a 3c 2f 74 64 3e 0a 3c 74 64 .value.</td>.<td
8650: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
8660: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
8670: 3d 22 77 69 64 74 68 3a 20 34 25 3b 22 3e 0a 72 ="width: 4%;">.r
8680: 65 71 75 69 72 65 64 3f 0a 3c 2f 74 64 3e 0a 3c equired?.</td>.<
8690: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
86a0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
86b0: 6c 65 3d 22 77 69 64 74 68 3a 20 33 30 25 3b 22 le="width: 30%;"
86c0: 3e 0a 63 6f 6d 6d 65 6e 74 0a 3c 2f 74 64 3e 0a >.comment.</td>.
86d0: 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 .</tr>.<tr>.<td
86e0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
86f0: 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d ign="top" style=
8700: 22 77 69 64 74 68 3a 20 32 30 25 3b 22 3e 0a 5b "width: 20%;">.[
8710: 64 65 66 61 75 6c 74 5d 0a 3c 2f 74 64 3e 0a 3c default].</td>.<
8720: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
8730: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
8740: 6c 65 3d 22 77 69 64 74 68 3a 20 31 32 25 3b 22 le="width: 12%;"
8750: 3e 0a 73 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 >.string of lett
8760: 65 72 73 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 ers, numbers and
8770: 20 75 6e 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 underscore.</td
8780: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
8790: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 t" valign="top"
87a0: 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 33 25 style="width: 3%
87b0: 3b 22 3e 0a 61 6e 79 0a 3c 2f 74 64 3e 0a 3c 74 ;">.any.</td>.<t
87c0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
87d0: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
87e0: 65 3d 22 77 69 64 74 68 3a 20 34 25 3b 22 3e 0a e="width: 4%;">.
87f0: 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 no.</td>.<td ali
8800: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
8810: 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 ="top" style="wi
8820: 64 74 68 3a 20 33 30 25 3b 22 3e 0a 76 61 72 69 dth: 30%;">.vari
8830: 61 62 6c 65 73 20 73 65 74 20 69 6e 20 74 68 69 ables set in thi
8840: 73 20 73 65 63 74 69 6f 6e 20 77 69 6c 6c 20 62 s section will b
8850: 65 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 e available for
8860: 61 6c 6c 20 72 75 6e 73 2c 20 64 65 66 69 6e 69 all runs, defini
8870: 6e 67 20 74 68 65 20 73 61 6d 65 20 76 61 72 69 ng the same vari
8880: 61 62 6c 65 20 69 6e 20 61 6e 6f 74 68 65 72 20 able in another
8890: 73 65 63 74 69 6f 6e 20 77 69 6c 6c 20 6f 76 65 section will ove
88a0: 72 72 69 64 65 20 74 68 65 20 76 61 6c 75 65 20 rride the value
88b0: 66 72 6f 6d 20 74 68 65 20 64 65 66 61 75 6c 74 from the default
88c0: 20 73 65 63 74 69 6f 6e 0a 3c 2f 74 64 3e 0a 0a section.</td>..
88d0: 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 </tr>.<tr>.<td a
88e0: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
88f0: 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 gn="top" style="
8900: 77 69 64 74 68 3a 20 32 30 25 3b 22 3e 0a 5b 66 width: 20%;">.[f
8910: 69 65 6c 64 31 76 61 6c 75 65 2f 66 69 65 6c 64 ield1value/field
8920: 32 76 61 6c 75 65 2e 2e 2e 5d 0a 3c 2f 74 64 3e 2value...].</td>
8930: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
8940: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 " valign="top" s
8950: 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 31 32 25 tyle="width: 12%
8960: 3b 22 3e 0a 73 74 72 69 6e 67 20 6f 66 20 6c 65 ;">.string of le
8970: 74 74 65 72 73 2c 20 6e 75 6d 62 65 72 73 20 61 tters, numbers a
8980: 6e 64 20 75 6e 64 65 72 73 63 6f 72 65 0a 3c 2f nd underscore.</
8990: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
89a0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
89b0: 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 " style="width:
89c0: 33 25 3b 22 3e 0a 61 6e 79 0a 3c 2f 74 64 3e 0a 3%;">.any.</td>.
89d0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
89e0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 valign="top" st
89f0: 79 6c 65 3d 22 77 69 64 74 68 3a 20 34 25 3b 22 yle="width: 4%;"
8a00: 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 >.no.</td>.<td a
8a10: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
8a20: 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 gn="top" style="
8a30: 77 69 64 74 68 3a 20 33 30 25 3b 22 3e 0a 74 68 width: 30%;">.th
8a40: 65 20 76 61 6c 75 65 73 20 69 6e 20 74 68 69 73 e values in this
8a50: 20 73 65 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 section will be
8a60: 20 73 65 74 20 66 6f 72 20 61 6e 79 20 72 75 6e set for any run
8a70: 20 77 68 65 72 65 20 66 69 65 6c 64 31 20 69 73 where field1 is
8a80: 20 66 69 65 6c 64 31 76 61 6c 75 65 2c 20 66 69 field1value, fi
8a90: 65 6c 64 32 20 69 73 20 66 69 65 6c 64 32 76 61 eld2 is field2va
8aa0: 6c 75 65 20 61 6e 64 20 66 69 65 6c 64 4e 20 69 lue and fieldN i
8ab0: 73 20 66 69 65 6c 64 4e 76 61 6c 75 65 2e 20 0a s fieldNvalue. .
8ac0: 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 0a 3c 2f </td>..</tr>..</
8ad0: 74 61 62 6c 65 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c table>..</div>.<
8ae0: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
8af0: 61 72 64 22 3e 0a 45 78 61 6d 70 6c 65 3a 20 61 ard">.Example: a
8b00: 20 74 65 73 74 20 73 75 69 74 65 20 74 68 61 74 test suite that
8b10: 20 63 68 65 63 6b 73 20 74 68 61 74 20 61 20 70 checks that a p
8b20: 69 65 63 65 20 6f 66 20 73 6f 66 74 77 61 72 65 iece of software
8b30: 20 77 6f 72 6b 73 20 63 6f 72 72 65 63 74 6c 79 works correctly
8b40: 20 66 6f 72 20 64 69 66 66 65 72 65 6e 74 20 63 for different c
8b50: 75 73 74 6f 6d 65 72 20 63 6f 6e 66 69 67 75 72 ustomer configur
8b60: 61 74 69 6f 6e 73 20 61 6e 64 20 6c 6f 63 61 74 ations and locat
8b70: 69 6f 6e 73 20 65 61 63 68 20 6f 66 20 77 68 69 ions each of whi
8b80: 63 68 20 69 73 20 64 6f 6e 65 20 61 73 20 61 20 ch is done as a
8b90: 73 65 70 61 72 61 74 65 20 72 65 6c 65 61 73 65 separate release
8ba0: 20 72 65 67 72 65 73 73 69 6f 6e 20 72 75 6e 2e regression run.
8bb0: 20 54 68 65 20 66 69 65 6c 64 73 2c 20 43 55 53 The fields, CUS
8bc0: 54 4f 4d 45 52 20 61 6e 64 20 4c 4f 43 41 54 49 TOMER and LOCATI
8bd0: 4f 4e 20 77 65 72 65 20 63 68 6f 73 65 6e 2e 20 ON were chosen.
8be0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 75 The following ru
8bf0: 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 20 nconfigs.config
8c00: 66 69 6c 65 20 77 6f 75 6c 64 20 73 65 74 20 73 file would set s
8c10: 6f 6d 65 20 76 61 72 69 61 62 6c 65 73 20 73 70 ome variables sp
8c20: 65 63 69 66 69 63 20 74 6f 20 72 75 6e 73 20 66 ecific to runs f
8c30: 6f 72 20 6d 65 67 61 63 6f 72 70 20 69 6e 20 49 or megacorp in I
8c40: 6e 64 69 61 20 61 6e 64 20 66 65 6d 74 6f 63 6f ndia and femtoco
8c50: 72 70 20 69 6e 20 74 68 65 20 43 6f 6f 6b 20 49 rp in the Cook I
8c60: 73 6c 61 6e 64 73 20 61 6e 64 20 4e 65 77 20 5a slands and New Z
8c70: 65 61 6c 61 6e 64 3a 0a 3c 2f 64 69 76 3e 0a 3c ealand:.</div>.<
8c80: 64 69 76 20 63 6c 61 73 73 3d 22 53 74 61 6e 64 div class="Stand
8c90: 61 72 64 22 3e 0a 3c 64 69 76 20 63 6c 61 73 73 ard">.<div class
8ca0: 3d 22 6c 69 73 74 69 6e 67 22 3e 0a 3c 70 72 65 ="listing">.<pre
8cb0: 20 63 6c 61 73 73 3d 22 6c 69 73 74 69 6e 67 22 class="listing"
8cc0: 3e 23 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 6f ># runconfigs.co
8cd0: 6e 66 69 67 0a 5b 64 65 66 61 75 6c 74 5d 0a 45 nfig.[default].E
8ce0: 4e 43 52 59 54 49 4f 4e 20 74 72 75 65 0a e2 80 NCRYTION true.
8cf0: 8b 0a 5b 6d 65 67 61 63 6f 72 70 2f 69 6e 64 69 .[megacorp/indi
8d00: 61 5d 0a 54 45 53 54 50 41 54 48 20 2f 6e 66 73 a].TESTPATH /nfs
8d10: 2f 74 65 73 74 69 6e 67 2f 6d 65 67 61 63 6f 72 /testing/megacor
8d20: 70 5f 72 75 6e 73 0a e2 80 8b 0a 5b 66 65 6d 74 p_runs..[femt
8d30: 6f 63 6f 72 70 2f 63 6f 6f 6b 5f 69 73 6c 61 6e ocorp/cook_islan
8d40: 64 73 5d 0a 45 4e 43 52 59 54 49 4f 4e 20 66 61 ds].ENCRYTION fa
8d50: 6c 73 65 0a 54 45 53 54 50 41 54 48 20 2f 61 66 lse.TESTPATH /af
8d60: 73 2f 6b 69 61 74 6f 61 2f 74 65 73 74 69 6e 67 s/kiatoa/testing
8d70: 2f 63 6f 6f 6b 5f 69 73 6c 61 6e 64 73 0a e2 80 /cook_islands.
8d80: 8b 0a 5b 66 65 6d 74 6f 63 6f 72 70 2f 6e 65 77 .[femtocorp/new
8d90: 5f 7a 65 61 6c 61 6e 64 5d 0a 54 45 53 54 50 41 _zealand].TESTPA
8da0: 54 48 20 2f 61 66 73 2f 6b 69 61 74 6f 61 2f 74 TH /afs/kiatoa/t
8db0: 65 73 74 69 6e 67 2f 6e 65 77 5f 7a 65 61 6c 61 esting/new_zeala
8dc0: 6e 64 0a e2 80 8b 0a 5b 6d 65 67 61 63 6f 72 70 nd..[megacorp
8dd0: 2f 6e 65 77 5f 7a 65 61 6c 61 6e 64 5d 0a 54 45 /new_zealand].TE
8de0: 53 54 50 41 54 48 20 2f 6e 66 73 2f 74 65 73 74 STPATH /nfs/test
8df0: 69 6e 67 2f 6d 65 67 61 63 6f 72 70 5f 72 75 6e ing/megacorp_run
8e00: 73 0a 3c 2f 70 72 65 3e 0a 3c 2f 64 69 76 3e 0a s.</pre>.</div>.
8e10: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 .</div>.<div cla
8e20: 73 73 3d 22 50 61 72 61 67 72 61 70 68 2d 22 3e ss="Paragraph-">
8e30: 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 .<a class="toc"
8e40: 6e 61 6d 65 3d 22 74 6f 63 2d 50 61 72 61 67 72 name="toc-Paragr
8e50: 61 70 68 2d 2d 31 22 3e 3c 2f 61 3e 52 75 6e 6e aph--1"></a>Runn
8e60: 69 6e 67 20 6d 65 67 61 74 65 73 74 20 6c 69 6b ing megatest lik
8e70: 65 20 74 68 69 73 3a 0a 3c 2f 64 69 76 3e 0a 3c e this:.</div>.<
8e80: 64 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 div class="Code"
8e90: 3e 0a 6d 65 67 61 74 65 73 74 20 3a 43 55 53 54 >.megatest :CUST
8ea0: 4f 4d 45 52 20 6d 65 67 61 63 6f 72 70 20 3a 4c OMER megacorp :L
8eb0: 4f 43 41 54 49 4f 4e 20 6e 65 77 5f 7a 65 61 6c OCATION new_zeal
8ec0: 61 6e 64 20 3a 72 75 6e 6e 61 6d 65 20 77 65 65 and :runname wee
8ed0: 6b 31 32 5f 32 30 31 31 5f 72 75 6e 31 20 2d 72 k12_2011_run1 -r
8ee0: 75 6e 61 6c 6c 0a 3c 2f 64 69 76 3e 0a 3c 64 69 unall.</div>.<di
8ef0: 76 20 63 6c 61 73 73 3d 22 50 61 72 61 67 72 61 v class="Paragra
8f00: 70 68 2d 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 ph-">.<a class="
8f10: 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 50 toc" name="toc-P
8f20: 61 72 61 67 72 61 70 68 2d 2d 32 22 3e 3c 2f 61 aragraph--2"></a
8f30: 3e 57 6f 75 6c 64 20 73 65 74 3a 0a 3c 2f 64 69 >Would set:.</di
8f40: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 v>.<div class="C
8f50: 6f 64 65 22 3e 0a 45 4e 43 52 59 50 54 49 4f 4e ode">.ENCRYPTION
8f60: 20 74 72 75 65 0a 3c 2f 64 69 76 3e 0a 3c 64 69 true.</div>.<di
8f70: 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a v class="Code">.
8f80: 54 45 53 54 50 41 54 48 20 2f 6e 66 73 2f 74 65 TESTPATH /nfs/te
8f90: 73 74 69 6e 67 2f 6d 65 67 61 63 6f 72 70 5f 72 sting/megacorp_r
8fa0: 75 6e 73 0a 3c 2f 64 69 76 3e 0a 3c 68 32 20 63 uns.</div>.<h2 c
8fb0: 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e lass="Subsection
8fc0: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 ">.<a class="toc
8fd0: 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 " name="toc-Subs
8fe0: 65 63 74 69 6f 6e 2d 31 33 2e 35 22 3e 31 33 2e ection-13.5">13.
8ff0: 35 3c 2f 61 3e e2 80 83 57 72 69 74 69 6e 67 20 5</a> Writing
9000: 74 65 73 74 73 0a 3c 2f 68 32 3e 0a 3c 68 33 20 tests.</h2>.<h3
9010: 63 6c 61 73 73 3d 22 53 75 62 73 75 62 73 65 63 class="Subsubsec
9020: 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d tion">.<a class=
9030: 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d "toc" name="toc-
9040: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 31 33 Subsubsection-13
9050: 2e 35 2e 31 22 3e 31 33 2e 35 2e 31 3c 2f 61 3e .5.1">13.5.1</a>
9060: e2 80 83 74 65 73 74 63 6f 6e 66 69 67 20 66 69 testconfig fi
9070: 6c 65 0a 3c 2f 68 33 3e 0a 3c 64 69 76 20 63 6c le.</h3>.<div cl
9080: 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 3e 0a ass="Standard">.
9090: 3c 74 61 62 6c 65 3e 0a 3c 74 72 3e 0a 3c 74 64 <table>.<tr>.<td
90a0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
90b0: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
90c0: 3d 22 77 69 64 74 68 3a 20 38 25 3b 22 3e 0a 73 ="width: 8%;">.s
90d0: 65 63 74 69 6f 6e 0a 3c 2f 74 64 3e 0a 3c 74 64 ection.</td>.<td
90e0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
90f0: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
9100: 3d 22 77 69 64 74 68 3a 20 36 25 3b 22 3e 0a 76 ="width: 6%;">.v
9110: 61 72 69 61 62 6c 65 0a 3c 2f 74 64 3e 0a 3c 74 ariable.</td>.<t
9120: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
9130: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
9140: 65 3d 22 77 69 64 74 68 3a 20 31 32 25 3b 22 3e e="width: 12%;">
9150: 0a 76 61 6c 75 65 0a 3c 2f 74 64 3e 0a 3c 74 64 .value.</td>.<td
9160: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
9170: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
9180: 3d 22 77 69 64 74 68 3a 20 36 25 3b 22 3e 0a 72 ="width: 6%;">.r
9190: 65 71 75 69 72 65 64 3f 0a 3c 2f 74 64 3e 0a 3c equired?.</td>.<
91a0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
91b0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
91c0: 6c 65 3d 22 77 69 64 74 68 3a 20 33 30 25 3b 22 le="width: 30%;"
91d0: 3e 0a 63 6f 6d 6d 65 6e 74 73 0a 3c 2f 74 64 3e >.comments.</td>
91e0: 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 ..</tr>.<tr>.<td
91f0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
9200: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
9210: 3d 22 77 69 64 74 68 3a 20 38 25 3b 22 3e 0a 5b ="width: 8%;">.[
9220: 73 65 74 75 70 5d 0a 3c 2f 74 64 3e 0a 3c 74 64 setup].</td>.<td
9230: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
9240: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
9250: 3d 22 77 69 64 74 68 3a 20 36 25 3b 22 3e 0a 72 ="width: 6%;">.r
9260: 75 6e 73 63 72 69 70 74 0a 3c 2f 74 64 3e 0a 3c unscript.</td>.<
9270: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
9280: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 valign="top" sty
9290: 6c 65 3d 22 77 69 64 74 68 3a 20 31 32 25 3b 22 le="width: 12%;"
92a0: 3e 0a 6e 61 6d 65 20 6f 66 20 73 63 72 69 70 74 >.name of script
92b0: 20 74 6f 20 65 78 65 63 75 74 65 20 66 6f 72 20 to execute for
92c0: 74 68 69 73 20 74 65 73 74 0a 3c 2f 74 64 3e 0a this test.</td>.
92d0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
92e0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 valign="top" st
92f0: 79 6c 65 3d 22 77 69 64 74 68 3a 20 36 25 3b 22 yle="width: 6%;"
9300: 3e 0a 79 65 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 >.yes.</td>.<td
9310: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
9320: 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d ign="top" style=
9330: 22 77 69 64 74 68 3a 20 33 30 25 3b 22 3e 0a 54 "width: 30%;">.T
9340: 68 65 20 73 63 72 69 70 74 20 6d 75 73 74 20 62 he script must b
9350: 65 20 65 78 65 63 75 74 61 62 6c 65 20 61 6e 64 e executable and
9360: 20 65 69 74 68 65 72 20 70 72 6f 76 69 64 65 20 either provide
9370: 74 68 65 20 66 75 6c 6c 20 70 61 74 68 20 6f 72 the full path or
9380: 20 70 75 74 20 61 20 63 6f 70 79 20 61 74 20 74 put a copy at t
9390: 68 65 20 74 6f 70 20 6f 66 20 79 6f 75 72 20 74 he top of your t
93a0: 65 73 74 20 64 69 72 65 63 74 6f 72 79 0a 3c 2f est directory.</
93b0: 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a td>..</tr>.<tr>.
93c0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
93d0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 valign="top" st
93e0: 79 6c 65 3d 22 77 69 64 74 68 3a 20 38 25 3b 22 yle="width: 8%;"
93f0: 3e 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d >.[requirements]
9400: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
9410: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
9420: 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 top" style="widt
9430: 68 3a 20 36 25 3b 22 3e 0a 77 61 69 74 6f 6e 0a h: 6%;">.waiton.
9440: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
9450: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
9460: 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 op" style="width
9470: 3a 20 31 32 25 3b 22 3e 0a 6c 69 73 74 20 6f 66 : 12%;">.list of
9480: 20 76 61 6c 69 64 20 74 65 73 74 20 6e 61 6d 65 valid test name
9490: 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 s.</td>.<td alig
94a0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
94b0: 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 "top" style="wid
94c0: 74 68 3a 20 36 25 3b 22 3e 0a 6e 6f 0a 3c 2f 74 th: 6%;">.no.</t
94d0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
94e0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
94f0: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 33 style="width: 3
9500: 30 25 3b 22 3e 0a 54 68 69 73 20 74 65 73 74 20 0%;">.This test
9510: 77 69 6c 6c 20 6e 6f 74 20 72 75 6e 20 75 6e 74 will not run unt
9520: 69 6c 20 74 68 65 20 6e 61 6d 65 64 20 74 65 73 il the named tes
9530: 74 73 20 61 72 65 20 73 74 61 74 65 20 63 6f 6d ts are state com
9540: 70 6c 65 74 65 64 20 61 6e 64 20 73 74 61 74 75 pleted and statu
9550: 73 20 50 41 53 53 0a 3c 2f 74 64 3e 0a 0a 3c 2f s PASS.</td>..</
9560: 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 tr>.<tr>.<td ali
9570: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
9580: 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 ="top" style="wi
9590: 64 74 68 3a 20 38 25 3b 22 3e 0a 0a 3c 2f 74 64 dth: 8%;">..</td
95a0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
95b0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 t" valign="top"
95c0: 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 36 25 style="width: 6%
95d0: 3b 22 3e 0a 6a 6f 62 67 72 6f 75 70 0a 3c 2f 74 ;">.jobgroup.</t
95e0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
95f0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
9600: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 31 style="width: 1
9610: 32 25 3b 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 2%;">..</td>.<td
9620: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
9630: 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 lign="top" style
9640: 3d 22 77 69 64 74 68 3a 20 36 25 3b 22 3e 0a 0a ="width: 6%;">..
9650: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
9660: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
9670: 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 op" style="width
9680: 3a 20 33 30 25 3b 22 3e 0a 0a 3c 2f 74 64 3e 0a : 30%;">..</td>.
9690: 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 .</tr>.<tr>.<td
96a0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
96b0: 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d ign="top" style=
96c0: 22 77 69 64 74 68 3a 20 38 25 3b 22 3e 0a 5b 69 "width: 8%;">.[i
96d0: 74 65 6d 73 5d 0a 3c 2f 74 64 3e 0a 3c 74 64 20 tems].</td>.<td
96e0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
96f0: 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d ign="top" style=
9700: 22 77 69 64 74 68 3a 20 36 25 3b 22 3e 0a 61 6e "width: 6%;">.an
9710: 79 20 76 61 6c 69 64 0a 3c 2f 74 64 3e 0a 3c 74 y valid.</td>.<t
9720: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
9730: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
9740: 65 3d 22 77 69 64 74 68 3a 20 31 32 25 3b 22 3e e="width: 12%;">
9750: 0a 6c 69 73 74 20 6f 66 20 76 61 6c 75 65 73 0a .list of values.
9760: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
9770: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
9780: 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 op" style="width
9790: 3a 20 36 25 3b 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e : 6%;">.no.</td>
97a0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
97b0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 " valign="top" s
97c0: 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 33 30 25 tyle="width: 30%
97d0: 3b 22 3e 0a 54 68 65 20 74 65 73 74 20 77 69 6c ;">.The test wil
97e0: 6c 20 62 65 20 72 65 70 65 61 74 65 64 20 6f 6e l be repeated on
97f0: 63 65 20 66 6f 72 20 65 61 63 68 20 69 74 65 6d ce for each item
9800: 20 77 69 74 68 20 74 68 65 20 76 61 72 69 61 62 with the variab
9810: 6c 65 20 6e 61 6d 65 20 73 65 74 20 74 6f 20 74 le name set to t
9820: 68 65 20 76 61 6c 75 65 2e 20 49 66 20 74 68 65 he value. If the
9830: 72 65 20 69 73 20 6d 6f 72 65 20 74 68 61 6e 20 re is more than
9840: 6f 6e 65 20 76 61 72 69 61 62 6c 65 20 74 68 65 one variable the
9850: 6e 20 74 68 65 20 74 65 73 74 20 77 69 6c 6c 20 n the test will
9860: 62 65 20 72 75 6e 20 61 67 61 69 6e 73 74 20 61 be run against a
9870: 6c 6c 20 75 6e 69 71 75 65 20 63 6f 6d 62 69 6e ll unique combin
9880: 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 76 61 ations of the va
9890: 6c 75 65 73 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 lues.</td>..</tr
98a0: 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e >.<tr>.<td align
98b0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
98c0: 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 top" style="widt
98d0: 68 3a 20 38 25 3b 22 3e 0a 5b 65 7a 74 65 73 74 h: 8%;">.[eztest
98e0: 73 5d 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 s].</td>.<td ali
98f0: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
9900: 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 ="top" style="wi
9910: 64 74 68 3a 20 36 25 3b 22 3e 0a 61 6e 79 20 76 dth: 6%;">.any v
9920: 61 6c 69 64 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 alid.</td>.<td a
9930: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
9940: 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 gn="top" style="
9950: 77 69 64 74 68 3a 20 31 32 25 3b 22 3e 0a 73 74 width: 12%;">.st
9960: 65 70 6e 61 6d 65 20 63 6f 6d 6d 61 6e 64 0a 3c epname command.<
9970: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
9980: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
9990: 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a p" style="width:
99a0: 20 36 25 3b 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 6%;">.no.</td>.
99b0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
99c0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 valign="top" st
99d0: 79 6c 65 3d 22 77 69 64 74 68 3a 20 33 30 25 3b yle="width: 30%;
99e0: 22 3e 0a 55 73 65 20 69 6e 20 61 64 64 69 74 69 ">.Use in additi
99f0: 6f 6e 20 74 6f 20 6f 72 20 69 6e 73 74 65 61 64 on to or instead
9a00: 20 6f 66 20 72 75 6e 73 63 72 69 70 74 20 66 6f of runscript fo
9a10: 72 20 65 61 73 79 20 69 6d 70 6c 65 6d 65 6e 74 r easy implement
9a20: 61 74 69 6f 6e 20 6f 66 20 73 74 65 70 73 2e 20 ation of steps.
9a30: 49 66 20 26 6c 74 3b 73 74 65 70 6e 61 6d 65 26 If <stepname&
9a40: 67 74 3b 2e 6c 6f 67 70 72 6f 20 65 78 69 73 74 gt;.logpro exist
9a50: 73 20 69 74 20 77 69 6c 6c 20 62 65 20 61 70 70 s it will be app
9a60: 6c 69 65 64 20 74 6f 20 74 68 65 20 26 6c 74 3b lied to the <
9a70: 73 74 65 70 6e 61 6d 65 26 67 74 3b 2e 6c 6f 67 stepname>.log
9a80: 20 61 6e 64 20 72 65 73 75 6c 74 69 6e 67 20 65 and resulting e
9a90: 78 69 74 20 63 6f 64 65 20 77 69 6c 6c 20 62 65 xit code will be
9aa0: 20 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d 69 used to determi
9ab0: 6e 65 20 50 41 53 53 2f 46 41 49 4c 2f 57 41 52 ne PASS/FAIL/WAR
9ac0: 4e 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 0a N.</td>..</tr>..
9ad0: 3c 2f 74 61 62 6c 65 3e 0a 0a 3c 2f 64 69 76 3e </table>..</div>
9ae0: 0a 3c 68 33 20 63 6c 61 73 73 3d 22 53 75 62 73 .<h3 class="Subs
9af0: 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 ubsection">.<a c
9b00: 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d lass="toc" name=
9b10: 22 74 6f 63 2d 53 75 62 73 75 62 73 65 63 74 69 "toc-Subsubsecti
9b20: 6f 6e 2d 31 33 2e 35 2e 32 22 3e 31 33 2e 35 2e on-13.5.2">13.5.
9b30: 32 3c 2f 61 3e e2 80 83 43 6f 6d 6d 61 6e 64 20 2</a> Command
9b40: 6c 69 6e 65 0a 3c 2f 68 33 3e 0a 3c 64 69 76 20 line.</h3>.<div
9b50: 63 6c 61 73 73 3d 22 53 74 61 6e 64 61 72 64 22 class="Standard"
9b60: 3e 0a 3c 74 61 62 6c 65 3e 0a 3c 74 72 3e 0a 3c >.<table>.<tr>.<
9b70: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
9b80: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73 77 valign="top">.sw
9b90: 69 74 63 68 20 6f 72 20 70 61 72 61 6d 0a 3c 2f itch or param.</
9ba0: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
9bb0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
9bc0: 22 3e 0a 70 61 72 61 6d 65 74 65 72 0a 3c 2f 74 ">.parameter.</t
9bd0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
9be0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
9bf0: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 33 style="width: 3
9c00: 30 25 3b 22 3e 0a 70 75 72 70 6f 73 65 0a 3c 2f 0%;">.purpose.</
9c10: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
9c20: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
9c30: 22 3e 0a 63 6f 6d 6d 65 6e 74 73 0a 3c 2f 74 64 ">.comments.</td
9c40: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
9c50: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
9c60: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d 68 0a align="top">.-h.
9c70: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
9c80: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
9c90: 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 op">..</td>.<td
9ca0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
9cb0: 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d ign="top" style=
9cc0: 22 77 69 64 74 68 3a 20 33 30 25 3b 22 3e 0a 62 "width: 30%;">.b
9cd0: 72 69 65 66 20 68 65 6c 70 0a 3c 2f 74 64 3e 0a rief help.</td>.
9ce0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
9cf0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a valign="top">..
9d00: 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 </td>..</tr>.<tr
9d10: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
9d20: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
9d30: 0a 2d 72 75 6e 61 6c 6c 0a 3c 2f 74 64 3e 0a 3c .-runall.</td>.<
9d40: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
9d50: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c valign="top">..<
9d60: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
9d70: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
9d80: 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a p" style="width:
9d90: 20 33 30 25 3b 22 3e 0a 72 75 6e 20 61 6c 6c 20 30%;">.run all
9da0: 74 65 73 74 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 tests.</td>.<td
9db0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
9dc0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 ign="top">..</td
9dd0: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
9de0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
9df0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d 72 75 align="top">.-ru
9e00: 6e 74 65 73 74 73 0a 3c 2f 74 64 3e 0a 3c 74 64 ntests.</td>.<td
9e10: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
9e20: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 74 65 73 74 lign="top">.test
9e30: 31 2c 74 65 73 74 32 2c 2e 2e 2e 0a 3c 2f 74 64 1,test2,....</td
9e40: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
9e50: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 t" valign="top"
9e60: 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 33 30 style="width: 30
9e70: 25 3b 22 3e 0a 72 75 6e 20 6f 6e 65 20 6f 72 20 %;">.run one or
9e80: 6d 6f 72 65 20 74 65 73 74 73 0a 3c 2f 74 64 3e more tests.</td>
9e90: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
9ea0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a " valign="top">.
9eb0: 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 .</td>..</tr>.<t
9ec0: 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 r>.<td align="le
9ed0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
9ee0: 3e 0a 2d 73 74 65 70 0a 3c 2f 74 64 3e 0a 3c 74 >.-step.</td>.<t
9ef0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
9f00: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73 74 65 align="top">.ste
9f10: 70 6e 61 6d 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 pname.</td>.<td
9f20: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
9f30: 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d ign="top" style=
9f40: 22 77 69 64 74 68 3a 20 33 30 25 3b 22 3e 0a 72 "width: 30%;">.r
9f50: 65 63 6f 72 64 20 61 20 73 74 65 70 0a 3c 2f 74 ecord a step.</t
9f60: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
9f70: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
9f80: 3e 0a 72 65 71 75 69 72 65 73 20 3a 73 74 61 74 >.requires :stat
9f90: 65 20 61 6e 64 20 3a 73 74 61 74 75 73 0a 3c 2f e and :status.</
9fa0: 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a td>..</tr>.<tr>.
9fb0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
9fc0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d valign="top">.-
9fd0: 74 65 73 74 2d 73 74 61 74 75 73 0a 3c 2f 74 64 test-status.</td
9fe0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
9ff0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
a000: 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 ..</td>.<td alig
a010: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
a020: 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 "top" style="wid
a030: 74 68 3a 20 33 30 25 3b 22 3e 0a 72 65 63 6f 72 th: 30%;">.recor
a040: 64 20 74 68 65 20 74 65 73 74 20 73 74 61 74 75 d the test statu
a050: 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 s.</td>.<td alig
a060: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
a070: 22 74 6f 70 22 3e 0a 72 65 71 75 69 72 65 73 20 "top">.requires
a080: 3a 73 74 61 74 65 20 61 6e 64 20 3a 73 74 61 74 :state and :stat
a090: 75 73 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a us.</td>..</tr>.
a0a0: 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 <tr>.<td align="
a0b0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
a0c0: 70 22 3e 0a 2d 73 65 74 6c 6f 67 0a 3c 2f 74 64 p">.-setlog.</td
a0d0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
a0e0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
a0f0: 0a 6c 6f 67 66 69 6c 65 6e 61 6d 65 0a 3c 2f 74 .logfilename.</t
a100: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
a110: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
a120: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 33 style="width: 3
a130: 30 25 3b 22 3e 0a 73 65 74 20 74 68 65 20 6c 6f 0%;">.set the lo
a140: 67 66 69 6c 65 20 6e 61 6d 65 20 66 6f 72 20 61 gfile name for a
a150: 20 74 65 73 74 0a 3c 2f 74 64 3e 0a 3c 74 64 20 test.</td>.<td
a160: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
a170: 69 67 6e 3d 22 74 6f 70 22 3e 0a 70 61 74 68 20 ign="top">.path
a180: 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 62 65 is assumed to be
a190: 20 72 65 6c 61 74 69 76 65 20 74 6f 20 74 68 65 relative to the
a1a0: 20 74 65 73 74 20 72 75 6e 20 64 69 72 65 63 74 test run direct
a1b0: 6f 72 79 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e ory.</td>..</tr>
a1c0: 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d .<tr>.<td align=
a1d0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
a1e0: 6f 70 22 3e 0a 2d 73 65 74 2d 74 6f 70 6c 6f 67 op">.-set-toplog
a1f0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
a200: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
a210: 74 6f 70 22 3e 0a 6c 6f 67 66 69 6c 65 6e 61 6d top">.logfilenam
a220: 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 e.</td>.<td alig
a230: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
a240: 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 "top" style="wid
a250: 74 68 3a 20 33 30 25 3b 22 3e 0a 73 65 74 20 74 th: 30%;">.set t
a260: 68 65 20 6c 6f 67 66 69 6c 65 20 6e 61 6d 65 20 he logfile name
a270: 66 6f 72 20 74 68 65 20 74 6f 70 20 74 65 73 74 for the top test
a280: 20 69 6e 20 61 6e 20 69 74 65 72 61 74 65 64 20 in an iterated
a290: 74 65 73 74 20 72 75 6e 0a 3c 2f 74 64 3e 0a 3c test run.</td>.<
a2a0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
a2b0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 65 61 valign="top">.ea
a2c0: 63 68 20 73 75 62 20 74 65 73 74 20 63 61 6e 20 ch sub test can
a2d0: 68 61 76 65 20 69 74 73 20 6f 77 6e 20 6c 6f 67 have its own log
a2e0: 66 69 6c 65 20 73 65 74 0a 3c 2f 74 64 3e 0a 0a file set.</td>..
a2f0: 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 </tr>.<tr>.<td a
a300: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
a310: 67 6e 3d 22 74 6f 70 22 3e 0a 2d 6d 0a 3c 2f 74 gn="top">.-m.</t
a320: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
a330: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
a340: 3e 0a 26 6c 64 71 75 6f 3b 63 6f 6d 6d 65 6e 74 >.“comment
a350: 26 72 64 71 75 6f 3b 0a 3c 2f 74 64 3e 0a 3c 74 ”.</td>.<t
a360: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
a370: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
a380: 65 3d 22 77 69 64 74 68 3a 20 33 30 25 3b 22 3e e="width: 30%;">
a390: 0a 73 65 74 73 20 61 20 63 6f 6d 6d 65 6e 74 20 .sets a comment
a3a0: 66 6f 72 20 74 68 65 20 73 74 65 70 2c 20 74 65 for the step, te
a3b0: 73 74 20 6f 72 20 72 75 6e 0a 3c 2f 74 64 3e 0a st or run.</td>.
a3c0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
a3d0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a valign="top">..
a3e0: 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 </td>..</tr>.<tr
a3f0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
a400: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
a410: 0a 3a 72 75 6e 6e 61 6d 65 0a 3c 2f 74 64 3e 0a .:runname.</td>.
a420: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
a430: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 5b valign="top">.[
a440: 61 2d 7a 41 2d 5a 30 2d 39 5f 2d 5d 2b 0a 3c 2f a-zA-Z0-9_-]+.</
a450: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
a460: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
a470: 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 " style="width:
a480: 33 30 25 3b 22 3e 0a 64 69 72 65 63 74 6f 72 79 30%;">.directory
a490: 20 69 6e 20 77 68 69 63 68 20 74 68 69 73 20 72 in which this r
a4a0: 75 6e 20 77 69 6c 6c 20 62 65 20 73 74 6f 72 65 un will be store
a4b0: 64 20 69 6e 20 74 68 65 20 74 65 73 74 20 72 75 d in the test ru
a4c0: 6e 20 61 72 65 61 20 0a 3c 2f 74 64 3e 0a 3c 74 n area .</td>.<t
a4d0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
a4e0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f align="top">..</
a4f0: 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a td>..</tr>.<tr>.
a500: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
a510: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 3a valign="top">.:
a520: 73 74 61 74 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 state.</td>.<td
a530: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
a540: 69 67 6e 3d 22 74 6f 70 22 3e 0a 61 6e 79 20 76 ign="top">.any v
a550: 61 6c 75 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 alue.</td>.<td a
a560: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
a570: 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 gn="top" style="
a580: 77 69 64 74 68 3a 20 33 30 25 3b 22 3e 0a 53 65 width: 30%;">.Se
a590: 74 20 74 68 65 20 73 74 65 70 20 6f 72 20 74 65 t the step or te
a5a0: 73 74 20 73 74 61 74 65 2c 20 74 68 69 73 20 69 st state, this i
a5b0: 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 s stored in the
a5c0: 73 74 61 74 65 20 66 69 65 6c 64 20 69 6e 20 74 state field in t
a5d0: 68 65 20 73 74 65 70 73 20 6f 72 20 74 65 73 74 he steps or test
a5e0: 73 20 74 61 62 6c 65 20 72 65 73 70 65 63 74 69 s table respecti
a5f0: 76 65 6c 79 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 vely.</td>.<td a
a600: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
a610: 67 6e 3d 22 74 6f 70 22 3e 0a 46 6f 72 20 74 65 gn="top">.For te
a620: 73 74 73 20 4d 65 67 61 74 65 73 74 20 72 65 63 sts Megatest rec
a630: 6f 67 6e 69 73 65 73 20 26 6c 64 71 75 6f 3b 49 ognises “I
a640: 4e 43 4f 4d 50 4c 45 54 45 26 72 64 71 75 6f 3b NCOMPLETE”
a650: 2c 20 26 6c 64 71 75 6f 3b 43 4f 4d 50 4c 45 54 , “COMPLET
a660: 45 26 72 64 71 75 6f 3b 0a 3c 2f 74 64 3e 0a 0a E”.</td>..
a670: 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 </tr>.<tr>.<td a
a680: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
a690: 67 6e 3d 22 74 6f 70 22 3e 0a 3a 73 74 61 74 75 gn="top">.:statu
a6a0: 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 s.</td>.<td alig
a6b0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
a6c0: 22 74 6f 70 22 3e 0a 61 6e 79 20 76 61 6c 75 65 "top">.any value
a6d0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
a6e0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
a6f0: 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 top" style="widt
a700: 68 3a 20 33 30 25 3b 22 3e 0a 53 65 74 20 74 68 h: 30%;">.Set th
a710: 65 20 73 74 65 70 20 6f 72 20 74 65 73 74 20 73 e step or test s
a720: 74 61 74 75 73 2c 20 74 68 69 73 20 69 73 20 73 tatus, this is s
a730: 74 6f 72 65 64 20 69 6e 20 74 68 65 20 73 74 61 tored in the sta
a740: 74 75 73 20 66 69 65 6c 64 20 69 6e 20 74 68 65 tus field in the
a750: 20 73 74 65 70 73 20 6f 72 20 74 65 73 74 73 20 steps or tests
a760: 74 61 62 6c 65 20 72 65 73 70 65 63 74 69 76 65 table respective
a770: 6c 79 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 ly.</td>.<td ali
a780: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
a790: 3d 22 74 6f 70 22 3e 0a 46 6f 72 20 74 65 73 74 ="top">.For test
a7a0: 73 20 4d 65 67 61 74 65 73 74 20 72 65 63 6f 67 s Megatest recog
a7b0: 6e 69 73 65 73 20 26 6c 64 71 75 6f 3b 50 41 53 nises “PAS
a7c0: 53 26 72 64 71 75 6f 3b 2c 20 26 6c 64 71 75 6f S”, &ldquo
a7d0: 3b 46 41 49 4c 26 72 64 71 75 6f 3b 2c 20 61 6e ;FAIL”, an
a7e0: 64 20 26 6c 64 71 75 6f 3b 43 48 45 43 4b 26 72 d “CHECK&r
a7f0: 64 71 75 6f 3b 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 dquo;.</td>..</t
a800: 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 r>.<tr>.<td alig
a810: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
a820: 22 74 6f 70 22 3e 0a 2d 6c 69 73 74 2d 72 75 6e "top">.-list-run
a830: 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 s.</td>.<td alig
a840: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
a850: 22 74 6f 70 22 3e 0a 61 6e 79 20 76 61 6c 75 65 "top">.any value
a860: 2c 20 25 20 69 73 20 77 69 6c 64 63 61 72 64 0a , % is wildcard.
a870: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
a880: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
a890: 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 op" style="width
a8a0: 3a 20 33 30 25 3b 22 3e 0a 52 65 73 70 65 63 74 : 30%;">.Respect
a8b0: 73 20 2d 69 74 65 6d 70 61 74 74 20 61 6e 64 20 s -itempatt and
a8c0: 2d 74 65 73 74 70 61 74 74 20 66 6f 72 20 66 69 -testpatt for fi
a8d0: 6c 74 65 72 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 lters.</td>.<td
a8e0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
a8f0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 ign="top">..</td
a900: 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 >..</tr>.<tr>.<t
a910: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
a920: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d 74 65 align="top">.-te
a930: 73 74 70 61 74 74 0a 3c 2f 74 64 3e 0a 3c 74 64 stpatt.</td>.<td
a940: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
a950: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 61 6e 79 20 lign="top">.any
a960: 76 61 6c 75 65 2c 20 25 20 69 73 20 77 69 6c 64 value, % is wild
a970: 63 61 72 64 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 card.</td>.<td a
a980: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
a990: 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 gn="top" style="
a9a0: 77 69 64 74 68 3a 20 33 30 25 3b 22 3e 0a 0a 3c width: 30%;">..<
a9b0: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
a9c0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
a9d0: 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 p">..</td>..</tr
a9e0: 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e >.<tr>.<td align
a9f0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
aa00: 74 6f 70 22 3e 0a 2d 69 74 65 6d 70 61 74 74 0a top">.-itempatt.
aa10: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d </td>.<td align=
aa20: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
aa30: 6f 70 22 3e 0a 61 6e 79 20 76 61 6c 75 65 2c 20 op">.any value,
aa40: 25 20 69 73 20 77 69 6c 64 63 61 72 64 0a 3c 2f % is wildcard.</
aa50: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c td>.<td align="l
aa60: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 eft" valign="top
aa70: 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 " style="width:
aa80: 33 30 25 3b 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 30%;">..</td>.<t
aa90: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
aaa0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f align="top">..</
aab0: 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a td>..</tr>.<tr>.
aac0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
aad0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d valign="top">.-
aae0: 73 68 6f 77 6b 65 79 73 0a 3c 2f 74 64 3e 0a 3c showkeys.</td>.<
aaf0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
ab00: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c valign="top">..<
ab10: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 /td>.<td align="
ab20: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f left" valign="to
ab30: 70 22 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a p" style="width:
ab40: 20 33 30 25 3b 22 3e 0a 50 72 69 6e 74 20 74 68 30%;">.Print th
ab50: 65 20 6b 65 79 73 20 62 65 69 6e 67 20 75 73 65 e keys being use
ab60: 64 20 66 6f 72 20 74 68 69 73 20 64 61 74 61 62 d for this datab
ab70: 61 73 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c ase.</td>.<td al
ab80: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
ab90: 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a n="top">..</td>.
aba0: 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 .</tr>.<tr>.<td
abb0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c align="left" val
abc0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d 66 6f 72 63 ign="top">.-forc
abd0: 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 e.</td>.<td alig
abe0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
abf0: 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 "top">..</td>.<t
ac00: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
ac10: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
ac20: 65 3d 22 77 69 64 74 68 3a 20 33 30 25 3b 22 3e e="width: 30%;">
ac30: 0a 54 65 73 74 20 77 69 6c 6c 20 6e 6f 74 20 72 .Test will not r
ac40: 65 2d 72 75 6e 20 69 66 20 69 6e 20 74 68 65 20 e-run if in the
ac50: 26 6c 64 71 75 6f 3b 50 41 53 53 26 72 64 71 75 “PASS&rdqu
ac60: 6f 3b 2c 20 26 6c 64 71 75 6f 3b 43 48 45 43 4b o;, “CHECK
ac70: 26 72 64 71 75 6f 3b 20 6f 72 20 26 6c 64 71 75 ” or &ldqu
ac80: 6f 3b 4b 49 4c 4c 45 44 26 72 64 71 75 6f 3b 2c o;KILLED”,
ac90: 20 75 73 69 6e 67 20 2d 66 6f 72 63 65 20 77 69 using -force wi
aca0: 6c 6c 20 66 6f 72 63 65 20 74 68 65 20 72 75 6e ll force the run
acb0: 20 74 6f 20 62 65 20 6c 61 75 6e 63 68 65 64 2e to be launched.
acc0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
acd0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
ace0: 74 6f 70 22 3e 0a 57 41 52 4e 49 4e 47 3a 20 54 top">.WARNING: T
acf0: 68 65 20 2d 66 6f 72 63 65 20 73 77 69 74 63 68 he -force switch
ad00: 20 77 69 6c 6c 20 62 79 70 61 73 73 20 61 6e 79 will bypass any
ad10: 20 26 6c 64 71 75 6f 3b 77 61 69 74 6f 6e 26 72 “waiton&r
ad20: 64 71 75 6f 3b 20 64 65 70 65 6e 64 65 6e 63 69 dquo; dependenci
ad30: 65 73 2e 0a 3c 2f 74 64 3e 0a 0a 3c 2f 74 72 3e es..</td>..</tr>
ad40: 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d .<tr>.<td align=
ad50: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 "left" valign="t
ad60: 6f 70 22 3e 0a 2d 78 74 65 72 6d 0a 3c 2f 74 64 op">.-xterm.</td
ad70: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 >.<td align="lef
ad80: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e t" valign="top">
ad90: 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 ..</td>.<td alig
ada0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
adb0: 22 74 6f 70 22 20 73 74 79 6c 65 3d 22 77 69 64 "top" style="wid
adc0: 74 68 3a 20 33 30 25 3b 22 3e 0a 4c 61 75 6e 63 th: 30%;">.Launc
add0: 68 20 61 6e 20 78 74 65 72 6d 20 69 6e 73 74 65 h an xterm inste
ade0: 61 64 20 6f 66 20 72 75 6e 20 74 68 65 20 74 65 ad of run the te
adf0: 73 74 2e 20 54 68 65 20 78 74 65 72 6d 20 77 69 st. The xterm wi
ae00: 6c 6c 20 68 61 76 65 20 74 68 65 20 65 6e 76 69 ll have the envi
ae10: 72 6f 6e 6d 65 6e 74 20 74 68 61 74 20 74 68 65 ronment that the
ae20: 20 74 65 73 74 20 77 6f 75 6c 64 20 73 65 65 2e test would see.
ae30: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
ae40: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
ae50: 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f top">..</td>..</
ae60: 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c 69 tr>.<tr>.<td ali
ae70: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e gn="left" valign
ae80: 3d 22 74 6f 70 22 3e 0a 2d 72 65 6d 6f 76 65 2d ="top">.-remove-
ae90: 72 75 6e 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 runs.</td>.<td a
aea0: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 lign="left" vali
aeb0: 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e gn="top">..</td>
aec0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 .<td align="left
aed0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 " valign="top" s
aee0: 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 33 30 25 tyle="width: 30%
aef0: 3b 22 3e 0a 52 65 6d 6f 76 65 20 61 20 72 75 6e ;">.Remove a run
af00: 2c 20 74 65 73 74 20 6f 72 20 73 75 62 74 65 73 , test or subtes
af10: 74 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 t from the datab
af20: 61 73 65 20 61 6e 64 20 74 68 65 20 64 69 73 6b ase and the disk
af30: 2e 20 43 61 6e 6e 6f 74 20 62 65 20 75 6e 64 6f . Cannot be undo
af40: 6e 65 2e 20 52 65 71 75 69 72 65 73 20 2d 74 65 ne. Requires -te
af50: 73 74 70 61 74 74 2c 20 2d 69 74 65 6d 70 61 74 stpatt, -itempat
af60: 74 2c 20 3a 72 75 6e 6e 61 6d 65 20 61 6e 64 20 t, :runname and
af70: 61 6c 6c 20 6b 65 79 73 20 62 65 20 73 70 65 63 all keys be spec
af80: 69 66 69 65 64 2e 0a 3c 2f 74 64 3e 0a 3c 74 64 ified..</td>.<td
af90: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
afa0: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 lign="top">..</t
afb0: 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 3c d>..</tr>.<tr>.<
afc0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 td align="left"
afd0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 3c 69 valign="top">.<i
afe0: 3e 54 65 73 74 20 68 65 6c 70 65 72 73 3c 2f 69 >Test helpers</i
aff0: 3e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 >.</td>.<td alig
b000: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
b010: 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 "top">..</td>.<t
b020: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
b030: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
b040: 65 3d 22 77 69 64 74 68 3a 20 33 30 25 3b 22 3e e="width: 30%;">
b050: 0a 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 ..</td>.<td alig
b060: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
b070: 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a 3c "top">..</td>..<
b080: 2f 74 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 61 6c /tr>.<tr>.<td al
b090: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 ign="left" valig
b0a0: 6e 3d 22 74 6f 70 22 3e 0a 2d 72 75 6e 73 74 65 n="top">.-runste
b0b0: 70 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 p.</td>.<td alig
b0c0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d n="left" valign=
b0d0: 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 74 "top">..</td>.<t
b0e0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
b0f0: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 73 74 79 6c align="top" styl
b100: 65 3d 22 77 69 64 74 68 3a 20 33 30 25 3b 22 3e e="width: 30%;">
b110: 0a 55 73 65 64 20 69 6e 73 69 64 65 20 61 20 74 .Used inside a t
b120: 65 73 74 20 74 6f 20 72 75 6e 20 61 20 73 74 65 est to run a ste
b130: 70 2c 20 72 65 63 6f 72 64 20 74 68 65 20 73 74 p, record the st
b140: 61 72 74 20 61 6e 64 20 65 6e 64 20 6f 66 20 74 art and end of t
b150: 68 65 20 73 74 65 70 20 61 6e 64 20 6f 70 74 69 he step and opti
b160: 6f 6e 61 6c 6c 79 20 61 6e 61 6c 79 7a 65 20 74 onally analyze t
b170: 68 65 20 6f 75 74 70 75 74 20 75 73 69 6e 67 20 he output using
b180: 6c 6f 67 70 72 6f 2e 0a 3c 2f 74 64 3e 0a 3c 74 logpro..</td>.<t
b190: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 d align="left" v
b1a0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f align="top">..</
b1b0: 74 64 3e 0a 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a td>..</tr>.<tr>.
b1c0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 <td align="left"
b1d0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 2d valign="top">.-
b1e0: 6c 6f 67 70 72 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 logpro.</td>.<td
b1f0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 align="left" va
b200: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 lign="top">..</t
b210: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 d>.<td align="le
b220: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 ft" valign="top"
b230: 20 73 74 79 6c 65 3d 22 77 69 64 74 68 3a 20 33 style="width: 3
b240: 30 25 3b 22 3e 0a 49 66 20 75 73 69 6e 67 20 6c 0%;">.If using l
b250: 6f 67 70 72 6f 20 74 6f 20 61 63 65 73 73 20 74 ogpro to acess t
b260: 68 65 20 50 41 53 53 2f 46 41 49 4c 20 73 74 61 he PASS/FAIL sta
b270: 74 75 73 20 6f 66 20 74 68 65 20 73 74 65 70 20 tus of the step
b280: 79 6f 75 20 73 70 65 63 69 66 79 20 74 68 65 20 you specify the
b290: 6c 6f 67 70 72 6f 20 66 69 6c 65 20 77 69 74 68 logpro file with
b2a0: 20 74 68 69 73 20 70 61 72 61 6d 65 74 65 72 2e this parameter.
b2b0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e .</td>.<td align
b2c0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 ="left" valign="
b2d0: 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 0a 3c 2f top">..</td>..</
b2e0: 74 72 3e 0a 0a 3c 2f 74 61 62 6c 65 3e 0a 0a 3c tr>..</table>..<
b2f0: 2f 64 69 76 3e 0a 3c 68 31 20 63 6c 61 73 73 3d /div>.<h1 class=
b300: 22 53 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c "Section">.<a cl
b310: 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 ass="toc" name="
b320: 74 6f 63 2d 41 70 70 65 6e 64 69 78 2d 41 22 3e toc-Appendix-A">
b330: 41 3c 2f 61 3e e2 80 83 44 61 74 61 0a 3c 2f 68 A</a> Data.</h
b340: 31 3e 0a 3c 68 31 20 63 6c 61 73 73 3d 22 53 65 1>.<h1 class="Se
b350: 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 ction">.<a class
b360: 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 ="toc" name="toc
b370: 2d 41 70 70 65 6e 64 69 78 2d 42 22 3e 42 3c 2f -Appendix-B">B</
b380: 61 3e e2 80 83 52 65 66 65 72 65 6e 63 65 73 0a a> References.
b390: 3c 2f 68 31 3e 0a 0a 3c 68 72 20 63 6c 61 73 73 </h1>..<hr class
b3a0: 3d 22 66 6f 6f 74 65 72 22 2f 3e 0a 3c 64 69 76 ="footer"/>.<div
b3b0: 20 63 6c 61 73 73 3d 22 66 6f 6f 74 65 72 22 20 class="footer"
b3c0: 69 64 3d 22 67 65 6e 65 72 61 74 65 64 2d 62 79 id="generated-by
b3d0: 22 3e 0a 44 6f 63 75 6d 65 6e 74 20 67 65 6e 65 ">.Document gene
b3e0: 72 61 74 65 64 20 62 79 20 3c 61 20 68 72 65 66 rated by <a href
b3f0: 3d 22 68 74 74 70 3a 2f 2f 65 6c 79 78 65 72 2e ="http://elyxer.
b400: 6e 6f 6e 67 6e 75 2e 6f 72 67 2f 22 3e 65 4c 79 nongnu.org/">eLy
b410: 58 65 72 20 31 2e 32 2e 32 20 28 32 30 31 31 2d Xer 1.2.2 (2011-
b420: 30 36 2d 31 32 29 3c 2f 61 3e 20 6f 6e 20 3c 73 06-12)</a> on <s
b430: 70 61 6e 20 63 6c 61 73 73 3d 22 63 72 65 61 74 pan class="creat
b440: 65 2d 64 61 74 65 22 3e 32 30 31 31 2d 31 32 2d e-date">2011-12-
b450: 31 35 54 32 31 3a 35 33 3a 32 31 2e 35 32 37 35 15T21:53:21.5275
b460: 30 36 3c 2f 73 70 61 6e 3e 0a 3c 2f 64 69 76 3e 06</span>.</div>
b470: 0a 3c 2f 64 69 76 3e 0a 3c 2f 62 6f 64 79 3e 0a .</div>.</body>.
b480: 3c 2f 68 74 6d 6c 3e 0a </html>.