Megatest

Hex Artifact Content
Login

Artifact 6cfc483e564ca3c9d75658e850b0918b21075fbe:


0000: 3c 3f 78 6d 6c 20 76 65 72 73 69 6f 6e 3d 22 31  <?xml version="1
0010: 2e 30 22 20 65 6e 63 6f 64 69 6e 67 3d 22 55 54  .0" encoding="UT
0020: 46 2d 38 22 3f 3e 0a 3c 21 44 4f 43 54 59 50 45  F-8"?>.<!DOCTYPE
0030: 20 68 74 6d 6c 20 50 55 42 4c 49 43 20 22 2d 2f   html PUBLIC "-/
0040: 2f 57 33 43 2f 2f 44 54 44 20 58 48 54 4d 4c 20  /W3C//DTD XHTML 
0050: 31 2e 30 20 54 72 61 6e 73 69 74 69 6f 6e 61 6c  1.0 Transitional
0060: 2f 2f 45 4e 22 20 22 68 74 74 70 3a 2f 2f 77 77  //EN" "http://ww
0070: 77 2e 77 33 2e 6f 72 67 2f 54 52 2f 78 68 74 6d  w.w3.org/TR/xhtm
0080: 6c 31 2f 44 54 44 2f 78 68 74 6d 6c 31 2d 74 72  l1/DTD/xhtml1-tr
0090: 61 6e 73 69 74 69 6f 6e 61 6c 2e 64 74 64 22 3e  ansitional.dtd">
00a0: 0a 3c 68 74 6d 6c 20 78 6d 6c 6e 73 3d 22 68 74  .<html xmlns="ht
00b0: 74 70 3a 2f 2f 77 77 77 2e 77 33 2e 6f 72 67 2f  tp://www.w3.org/
00c0: 31 39 39 39 2f 78 68 74 6d 6c 22 20 78 6d 6c 3a  1999/xhtml" xml:
00d0: 6c 61 6e 67 3d 22 65 6e 22 20 6c 61 6e 67 3d 22  lang="en" lang="
00e0: 65 6e 22 3e 0a 3c 68 65 61 64 3e 0a 3c 6d 65 74  en">.<head>.<met
00f0: 61 20 68 74 74 70 2d 65 71 75 69 76 3d 22 43 6f  a http-equiv="Co
0100: 6e 74 65 6e 74 2d 54 79 70 65 22 20 63 6f 6e 74  ntent-Type" cont
0110: 65 6e 74 3d 22 74 65 78 74 2f 68 74 6d 6c 3b 20  ent="text/html; 
0120: 63 68 61 72 73 65 74 3d 55 54 46 2d 38 22 2f 3e  charset=UTF-8"/>
0130: 0a 3c 6d 65 74 61 20 6e 61 6d 65 3d 22 67 65 6e  .<meta name="gen
0140: 65 72 61 74 6f 72 22 20 63 6f 6e 74 65 6e 74 3d  erator" content=
0150: 22 68 74 74 70 3a 2f 2f 77 77 77 2e 6e 6f 6e 67  "http://www.nong
0160: 6e 75 2e 6f 72 67 2f 65 6c 79 78 65 72 2f 22 2f  nu.org/elyxer/"/
0170: 3e 0a 3c 6d 65 74 61 20 6e 61 6d 65 3d 22 63 72  >.<meta name="cr
0180: 65 61 74 65 2d 64 61 74 65 22 20 63 6f 6e 74 65  eate-date" conte
0190: 6e 74 3d 22 32 30 31 31 2d 30 35 2d 30 38 22 2f  nt="2011-05-08"/
01a0: 3e 0a 3c 6c 69 6e 6b 20 72 65 6c 3d 22 73 74 79  >.<link rel="sty
01b0: 6c 65 73 68 65 65 74 22 20 68 72 65 66 3d 22 68  lesheet" href="h
01c0: 74 74 70 3a 2f 2f 77 77 77 2e 6e 6f 6e 67 6e 75  ttp://www.nongnu
01d0: 2e 6f 72 67 2f 65 6c 79 78 65 72 2f 6c 79 78 2e  .org/elyxer/lyx.
01e0: 63 73 73 22 20 74 79 70 65 3d 22 74 65 78 74 2f  css" type="text/
01f0: 63 73 73 22 20 6d 65 64 69 61 3d 22 73 63 72 65  css" media="scre
0200: 65 6e 22 2f 3e 0a 3c 74 69 74 6c 65 3e 4d 65 67  en"/>.<title>Meg
0210: 61 74 65 73 74 3c 2f 74 69 74 6c 65 3e 0a 3c 2f  atest</title>.</
0220: 68 65 61 64 3e 0a 3c 62 6f 64 79 3e 0a 3c 64 69  head>.<body>.<di
0230: 76 20 69 64 3d 22 67 6c 6f 62 61 6c 57 72 61 70  v id="globalWrap
0240: 70 65 72 22 3e 0a 0a 3c 68 31 20 63 6c 61 73 73  per">..<h1 class
0250: 3d 22 74 69 74 6c 65 22 3e 0a 4d 65 67 61 74 65  ="title">.Megate
0260: 73 74 0a 3c 2f 68 31 3e 0a 3c 68 32 20 63 6c 61  st.</h1>.<h2 cla
0270: 73 73 3d 22 44 61 74 65 22 3e 0a 35 2f 35 2f 32  ss="Date">.5/5/2
0280: 30 31 31 20 0a 3c 2f 68 32 3e 0a 3c 68 32 20 63  011 .</h2>.<h2 c
0290: 6c 61 73 73 3d 22 61 75 74 68 6f 72 22 3e 0a 4d  lass="author">.M
02a0: 61 74 74 20 57 65 6c 6c 61 6e 64 0a 3c 2f 68 32  att Welland.</h2
02b0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 61 62  >.<div class="ab
02c0: 73 74 72 61 63 74 22 3e 0a 0a 3c 70 20 63 6c 61  stract">..<p cla
02d0: 73 73 3d 22 61 62 73 74 72 61 63 74 2d 6d 65 73  ss="abstract-mes
02e0: 73 61 67 65 22 3e 0a 41 62 73 74 72 61 63 74 0a  sage">.Abstract.
02f0: 3c 2f 70 3e 4d 65 67 61 74 65 73 74 20 69 73 20  </p>Megatest is 
0300: 61 20 6d 69 6e 69 6d 61 6c 69 73 74 69 63 20 74  a minimalistic t
0310: 6f 6f 6c 20 74 6f 20 68 65 6c 70 20 61 75 74 6f  ool to help auto
0320: 6d 61 74 65 20 61 6e 64 20 6d 61 6e 61 67 65 20  mate and manage 
0330: 74 68 65 20 72 75 6e 6e 69 6e 67 20 6f 66 20 61  the running of a
0340: 20 73 75 69 74 65 20 6f 66 20 72 65 67 72 65 73   suite of regres
0350: 73 69 6f 6e 20 74 65 73 74 73 20 6f 72 20 6f 74  sion tests or ot
0360: 68 65 72 20 70 72 6f 63 65 73 73 65 73 20 61 6e  her processes an
0370: 64 20 74 6f 20 72 6f 6c 6c 20 75 70 20 74 68 65  d to roll up the
0380: 20 72 65 73 75 6c 74 73 20 66 6f 72 20 64 69 73   results for dis
0390: 70 6c 61 79 20 6f 6e 20 61 20 77 65 62 20 70 61  play on a web pa
03a0: 67 65 20 6f 72 20 64 61 73 68 62 6f 61 72 64 2e  ge or dashboard.
03b0: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61  .</div>.<div cla
03c0: 73 73 3d 22 55 6e 69 6e 64 65 6e 74 65 64 22 3e  ss="Unindented">
03d0: 0a 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 66 75  ..<div class="fu
03e0: 6c 6c 74 6f 63 22 3e 0a 0a 3c 64 69 76 20 63 6c  lltoc">..<div cl
03f0: 61 73 73 3d 22 74 6f 63 68 65 61 64 65 72 22 3e  ass="tocheader">
0400: 0a 54 61 62 6c 65 20 6f 66 20 43 6f 6e 74 65 6e  .Table of Conten
0410: 74 73 0a 3c 2f 64 69 76 3e 3c 64 69 76 20 63 6c  ts.</div><div cl
0420: 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e  ass="tocindent">
0430: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63  .<div class="toc
0440: 69 6e 64 65 6e 74 22 3e 0a 0a 3c 64 69 76 20 63  indent">..<div c
0450: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63  lass="toc">.<a c
0460: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66  lass="Link" href
0470: 3d 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 30  ="#toc-Section-0
0480: 2e 31 22 3e 53 65 63 74 69 6f 6e 20 30 2e 31 3a  .1">Section 0.1:
0490: e2 80 83 41 62 6f 75 74 20 4d 65 67 61 74 65 73   About Megates
04a0: 74 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 3c 64 69 76  t</a>.</div><div
04b0: 20 63 6c 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e   class="tocinden
04c0: 74 22 3e 0a 0a 3c 64 69 76 20 63 6c 61 73 73 3d  t">..<div class=
04d0: 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d  "toc">.<a class=
04e0: 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f  "Link" href="#to
04f0: 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 30 2e 31  c-Subsection-0.1
0500: 2e 31 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 30  .1">Subsection 0
0510: 2e 31 2e 31 3a e2 80 83 4d 65 67 61 74 65 73 74  .1.1: Megatest
0520: 20 64 65 73 69 67 6e 20 70 68 69 6c 6f 73 6f 70   design philosop
0530: 68 79 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64  hy</a>.</div>.<d
0540: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a  iv class="toc">.
0550: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20  <a class="Link" 
0560: 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 65  href="#toc-Subse
0570: 63 74 69 6f 6e 2d 30 2e 31 2e 32 22 3e 53 75 62  ction-0.1.2">Sub
0580: 73 65 63 74 69 6f 6e 20 30 2e 31 2e 32 3a e2 80  section 0.1.2:
0590: 83 4d 65 67 61 74 65 73 74 20 61 72 63 68 69 74  Megatest archit
05a0: 65 63 74 75 72 65 3c 2f 61 3e 0a 3c 2f 64 69 76  ecture</a>.</div
05b0: 3e 3c 2f 64 69 76 3e 0a 0a 3c 64 69 76 20 63 6c  ></div>..<div cl
05c0: 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c  ass="toc">.<a cl
05d0: 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d  ass="Link" href=
05e0: 22 23 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 30 2e  "#toc-Section-0.
05f0: 32 22 3e 53 65 63 74 69 6f 6e 20 30 2e 32 3a e2  2">Section 0.2:
0600: 80 83 49 6e 73 74 61 6c 6c 61 74 69 6f 6e 3c 2f  Installation</
0610: 61 3e 0a 3c 2f 64 69 76 3e 3c 64 69 76 20 63 6c  a>.</div><div cl
0620: 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e  ass="tocindent">
0630: 0a 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f  ..<div class="to
0640: 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69  c">.<a class="Li
0650: 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53  nk" href="#toc-S
0660: 75 62 73 65 63 74 69 6f 6e 2d 30 2e 32 2e 31 22  ubsection-0.2.1"
0670: 3e 53 75 62 73 65 63 74 69 6f 6e 20 30 2e 32 2e  >Subsection 0.2.
0680: 31 3a e2 80 83 43 6f 6d 70 69 6c 61 74 69 6f 6e  1: Compilation
0690: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 3c 64 69 76 20  </a>.</div><div 
06a0: 63 6c 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74  class="tocindent
06b0: 22 3e 0a 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22  ">..<div class="
06c0: 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22  toc">.<a class="
06d0: 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63  Link" href="#toc
06e0: 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 30  -Subsubsection-0
06f0: 2e 32 2e 31 2e 31 22 3e 53 75 62 73 75 62 73 65  .2.1.1">Subsubse
0700: 63 74 69 6f 6e 20 30 2e 32 2e 31 2e 31 3a e2 80  ction 0.2.1.1:
0710: 83 44 65 70 65 6e 64 65 6e 63 69 65 73 3c 2f 61  Dependencies</a
0720: 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c  >.</div>.<div cl
0730: 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c  ass="toc">.<a cl
0740: 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d  ass="Link" href=
0750: 22 23 74 6f 63 2d 53 75 62 73 75 62 73 65 63 74  "#toc-Subsubsect
0760: 69 6f 6e 2d 30 2e 32 2e 31 2e 32 22 3e 53 75 62  ion-0.2.1.2">Sub
0770: 73 75 62 73 65 63 74 69 6f 6e 20 30 2e 32 2e 31  subsection 0.2.1
0780: 2e 32 3a e2 80 83 42 75 69 6c 64 20 61 6e 64 20  .2: Build and 
0790: 69 6e 73 74 61 6c 6c 3c 2f 61 3e 0a 3c 2f 64 69  install</a>.</di
07a0: 76 3e 3c 2f 64 69 76 3e 0a 0a 3c 64 69 76 20 63  v></div>..<div c
07b0: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63  lass="toc">.<a c
07c0: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66  lass="Link" href
07d0: 3d 22 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f  ="#toc-Subsectio
07e0: 6e 2d 30 2e 32 2e 32 22 3e 53 75 62 73 65 63 74  n-0.2.2">Subsect
07f0: 69 6f 6e 20 30 2e 32 2e 32 3a e2 80 83 53 65 74  ion 0.2.2: Set
0800: 75 70 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 3c 64 69  up</a>.</div><di
0810: 76 20 63 6c 61 73 73 3d 22 74 6f 63 69 6e 64 65  v class="tocinde
0820: 6e 74 22 3e 0a 0a 3c 64 69 76 20 63 6c 61 73 73  nt">..<div class
0830: 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73  ="toc">.<a class
0840: 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74  ="Link" href="#t
0850: 6f 63 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e  oc-Subsubsection
0860: 2d 30 2e 32 2e 32 2e 31 22 3e 53 75 62 73 75 62  -0.2.2.1">Subsub
0870: 73 65 63 74 69 6f 6e 20 30 2e 32 2e 32 2e 31 3a  section 0.2.2.1:
0880: e2 80 83 43 72 65 61 74 65 20 6d 65 67 61 74 65   Create megate
0890: 73 74 2e 63 6f 6e 66 69 67 3c 2f 61 3e 0a 3c 2f  st.config</a>.</
08a0: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d  div>.<div class=
08b0: 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d  "toc">.<a class=
08c0: 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f  "Link" href="#to
08d0: 63 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d  c-Subsubsection-
08e0: 30 2e 32 2e 32 2e 32 22 3e 53 75 62 73 75 62 73  0.2.2.2">Subsubs
08f0: 65 63 74 69 6f 6e 20 30 2e 32 2e 32 2e 32 3a e2  ection 0.2.2.2:
0900: 80 83 43 72 65 61 74 65 20 72 75 6e 63 6f 6e 66  Create runconf
0910: 69 67 73 2e 63 6f 6e 66 69 67 3c 2f 61 3e 0a 3c  igs.config</a>.<
0920: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73  /div>.<div class
0930: 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73  ="toc">.<a class
0940: 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74  ="Link" href="#t
0950: 6f 63 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e  oc-Subsubsection
0960: 2d 30 2e 32 2e 32 2e 33 22 3e 53 75 62 73 75 62  -0.2.2.3">Subsub
0970: 73 65 63 74 69 6f 6e 20 30 2e 32 2e 32 2e 33 3a  section 0.2.2.3:
0980: e2 80 83 43 72 65 61 74 65 20 74 68 65 20 74 65   Create the te
0990: 73 74 73 20 64 69 72 65 63 74 6f 72 79 20 61 6e  sts directory an
09a0: 64 20 79 6f 75 72 20 66 69 72 73 74 20 74 65 73  d your first tes
09b0: 74 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69  t</a>.</div>.<di
09c0: 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c  v class="toc">.<
09d0: 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68  a class="Link" h
09e0: 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 75 62  ref="#toc-Subsub
09f0: 73 65 63 74 69 6f 6e 2d 30 2e 32 2e 32 2e 34 22  section-0.2.2.4"
0a00: 3e 53 75 62 73 75 62 73 65 63 74 69 6f 6e 20 30  >Subsubsection 0
0a10: 2e 32 2e 32 2e 34 3a e2 80 83 43 72 65 61 74 65  .2.2.4: Create
0a20: 20 74 68 65 20 74 65 73 74 63 6f 6e 66 69 67 20   the testconfig 
0a30: 66 69 6c 65 20 66 6f 72 20 79 6f 75 72 20 74 65  file for your te
0a40: 73 74 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64  st</a>.</div>.<d
0a50: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a  iv class="toc">.
0a60: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20  <a class="Link" 
0a70: 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73 75  href="#toc-Subsu
0a80: 62 73 65 63 74 69 6f 6e 2d 30 2e 32 2e 32 2e 35  bsection-0.2.2.5
0a90: 22 3e 53 75 62 73 75 62 73 65 63 74 69 6f 6e 20  ">Subsubsection 
0aa0: 30 2e 32 2e 32 2e 35 3a e2 80 83 43 72 65 61 74  0.2.2.5: Creat
0ab0: 65 20 79 6f 75 72 20 74 65 73 74 20 72 75 6e 6e  e your test runn
0ac0: 69 6e 67 20 73 63 72 69 70 74 2c 20 6d 61 69 6e  ing script, main
0ad0: 2e 73 68 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 0a 3c  .sh</a>.</div>.<
0ae0: 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e  div class="toc">
0af0: 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22  .<a class="Link"
0b00: 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62 73   href="#toc-Subs
0b10: 75 62 73 65 63 74 69 6f 6e 2d 30 2e 32 2e 32 2e  ubsection-0.2.2.
0b20: 36 22 3e 53 75 62 73 75 62 73 65 63 74 69 6f 6e  6">Subsubsection
0b30: 20 30 2e 32 2e 32 2e 36 3a e2 80 83 52 75 6e 20   0.2.2.6: Run 
0b40: 6d 65 67 61 74 65 73 74 20 61 6e 64 20 77 61 74  megatest and wat
0b50: 63 68 20 79 6f 75 72 20 72 75 6e 20 70 72 6f 67  ch your run prog
0b60: 72 65 73 73 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 3c  ress</a>.</div><
0b70: 2f 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a 0a 3c 64  /div>.</div>..<d
0b80: 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22 3e 0a  iv class="toc">.
0b90: 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b 22 20  <a class="Link" 
0ba0: 68 72 65 66 3d 22 23 74 6f 63 2d 53 65 63 74 69  href="#toc-Secti
0bb0: 6f 6e 2d 30 2e 33 22 3e 53 65 63 74 69 6f 6e 20  on-0.3">Section 
0bc0: 30 2e 33 3a e2 80 83 52 65 66 65 72 65 6e 63 65  0.3: Reference
0bd0: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 3c 64 69 76 20  </a>.</div><div 
0be0: 63 6c 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74  class="tocindent
0bf0: 22 3e 0a 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22  ">..<div class="
0c00: 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22  toc">.<a class="
0c10: 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63  Link" href="#toc
0c20: 2d 53 75 62 73 65 63 74 69 6f 6e 2d 30 2e 33 2e  -Subsection-0.3.
0c30: 31 22 3e 53 75 62 73 65 63 74 69 6f 6e 20 30 2e  1">Subsection 0.
0c40: 33 2e 31 3a e2 80 83 45 6e 76 69 72 6f 6e 6d 65  3.1: Environme
0c50: 6e 74 20 76 61 72 69 61 62 6c 65 73 3c 2f 61 3e  nt variables</a>
0c60: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61  .</div>.<div cla
0c70: 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63 6c 61  ss="toc">.<a cla
0c80: 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66 3d 22  ss="Link" href="
0c90: 23 74 6f 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d  #toc-Subsection-
0ca0: 30 2e 33 2e 32 22 3e 53 75 62 73 65 63 74 69 6f  0.3.2">Subsectio
0cb0: 6e 20 30 2e 33 2e 32 3a e2 80 83 43 6f 6e 66 69  n 0.3.2: Confi
0cc0: 67 75 72 61 74 69 6f 6e 20 66 69 6c 65 73 3c 2f  guration files</
0cd0: 61 3e 0a 3c 2f 64 69 76 3e 3c 64 69 76 20 63 6c  a>.</div><div cl
0ce0: 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74 22 3e  ass="tocindent">
0cf0: 0a 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f  ..<div class="to
0d00: 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69  c">.<a class="Li
0d10: 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53  nk" href="#toc-S
0d20: 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 30 2e 33  ubsubsection-0.3
0d30: 2e 32 2e 31 22 3e 53 75 62 73 75 62 73 65 63 74  .2.1">Subsubsect
0d40: 69 6f 6e 20 30 2e 33 2e 32 2e 31 3a e2 80 83 6d  ion 0.3.2.1: m
0d50: 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 3c 2f  egatest.config</
0d60: 61 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63  a>.</div>.<div c
0d70: 6c 61 73 73 3d 22 74 6f 63 22 3e 0a 3c 61 20 63  lass="toc">.<a c
0d80: 6c 61 73 73 3d 22 4c 69 6e 6b 22 20 68 72 65 66  lass="Link" href
0d90: 3d 22 23 74 6f 63 2d 53 75 62 73 75 62 73 65 63  ="#toc-Subsubsec
0da0: 74 69 6f 6e 2d 30 2e 33 2e 32 2e 32 22 3e 53 75  tion-0.3.2.2">Su
0db0: 62 73 75 62 73 65 63 74 69 6f 6e 20 30 2e 33 2e  bsubsection 0.3.
0dc0: 32 2e 32 3a e2 80 83 72 75 6e 63 6f 6e 66 69 67  2.2: runconfig
0dd0: 73 2e 63 6f 6e 66 69 67 20 66 69 6c 65 3c 2f 61  s.config file</a
0de0: 3e 0a 3c 2f 64 69 76 3e 3c 2f 64 69 76 3e 0a 0a  >.</div></div>..
0df0: 3c 64 69 76 20 63 6c 61 73 73 3d 22 74 6f 63 22  <div class="toc"
0e00: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 4c 69 6e 6b  >.<a class="Link
0e10: 22 20 68 72 65 66 3d 22 23 74 6f 63 2d 53 75 62  " href="#toc-Sub
0e20: 73 65 63 74 69 6f 6e 2d 30 2e 33 2e 33 22 3e 53  section-0.3.3">S
0e30: 75 62 73 65 63 74 69 6f 6e 20 30 2e 33 2e 33 3a  ubsection 0.3.3:
0e40: e2 80 83 57 72 69 74 69 6e 67 20 74 65 73 74 73   Writing tests
0e50: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 3c 64 69 76 20  </a>.</div><div 
0e60: 63 6c 61 73 73 3d 22 74 6f 63 69 6e 64 65 6e 74  class="tocindent
0e70: 22 3e 0a 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22  ">..<div class="
0e80: 74 6f 63 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22  toc">.<a class="
0e90: 4c 69 6e 6b 22 20 68 72 65 66 3d 22 23 74 6f 63  Link" href="#toc
0ea0: 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 30  -Subsubsection-0
0eb0: 2e 33 2e 33 2e 31 22 3e 53 75 62 73 75 62 73 65  .3.3.1">Subsubse
0ec0: 63 74 69 6f 6e 20 30 2e 33 2e 33 2e 31 3a e2 80  ction 0.3.3.1:
0ed0: 83 74 65 73 74 63 6f 6e 66 69 67 20 66 69 6c 65  testconfig file
0ee0: 3c 2f 61 3e 0a 3c 2f 64 69 76 3e 3c 2f 64 69 76  </a>.</div></div
0ef0: 3e 0a 3c 2f 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a  >.</div>.</div>.
0f00: 3c 2f 64 69 76 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c  </div>..</div>.<
0f10: 2f 64 69 76 3e 0a 3c 68 32 20 63 6c 61 73 73 3d  /div>.<h2 class=
0f20: 22 53 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c  "Section">.<a cl
0f30: 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22  ass="toc" name="
0f40: 74 6f 63 2d 53 65 63 74 69 6f 6e 2d 30 2e 31 22  toc-Section-0.1"
0f50: 3e 30 2e 31 3c 2f 61 3e e2 80 83 41 62 6f 75 74  >0.1</a> About
0f60: 20 4d 65 67 61 74 65 73 74 0a 3c 2f 68 32 3e 0a   Megatest.</h2>.
0f70: 3c 68 33 20 63 6c 61 73 73 3d 22 53 75 62 73 65  <h3 class="Subse
0f80: 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73  ction">.<a class
0f90: 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63  ="toc" name="toc
0fa0: 2d 53 75 62 73 65 63 74 69 6f 6e 2d 30 2e 31 2e  -Subsection-0.1.
0fb0: 31 22 3e 30 2e 31 2e 31 3c 2f 61 3e e2 80 83 4d  1">0.1.1</a> M
0fc0: 65 67 61 74 65 73 74 20 64 65 73 69 67 6e 20 70  egatest design p
0fd0: 68 69 6c 6f 73 6f 70 68 79 0a 3c 2f 68 33 3e 0a  hilosophy.</h3>.
0fe0: 3c 64 69 76 20 63 6c 61 73 73 3d 22 55 6e 69 6e  <div class="Unin
0ff0: 64 65 6e 74 65 64 22 3e 0a 4d 65 67 61 74 65 73  dented">.Megates
1000: 74 20 69 73 20 69 6e 74 65 6e 64 65 64 20 74 6f  t is intended to
1010: 20 70 72 6f 76 69 64 65 20 74 68 65 20 6d 69 6e   provide the min
1020: 69 6d 75 6d 20 6e 65 65 64 65 64 20 72 65 73 6f  imum needed reso
1030: 75 72 63 65 73 20 74 6f 20 6d 61 6b 65 20 77 72  urces to make wr
1040: 69 74 69 6e 67 20 61 20 73 75 69 74 65 20 6f 66  iting a suite of
1050: 20 74 65 73 74 73 20 66 6f 72 20 73 6f 66 74 77   tests for softw
1060: 61 72 65 2c 20 64 65 73 69 67 6e 20 65 6e 67 69  are, design engi
1070: 6e 65 65 72 69 6e 67 20 6f 72 20 70 72 6f 63 65  neering or proce
1080: 73 73 20 63 6f 6e 74 72 6f 6c 20 28 76 69 61 20  ss control (via 
1090: 6f 77 6c 66 73 20 66 6f 72 20 65 78 61 6d 70 6c  owlfs for exampl
10a0: 65 29 20 77 69 74 68 6f 75 74 20 62 65 69 6e 67  e) without being
10b0: 20 73 70 65 63 69 61 6c 69 7a 65 64 20 66 6f 72   specialized for
10c0: 20 61 6e 79 20 73 70 65 63 69 66 69 63 20 70 72   any specific pr
10d0: 6f 62 6c 65 6d 20 73 70 61 63 65 2e 20 4d 65 67  oblem space. Meg
10e0: 61 74 65 73 74 20 69 6e 20 6f 66 20 69 74 73 65  atest in of itse
10f0: 6c 66 20 64 6f 65 73 20 6e 6f 74 20 6b 6e 6f 77  lf does not know
1100: 20 77 68 61 74 20 63 6f 6e 73 74 69 74 75 74 65   what constitute
1110: 73 20 61 20 50 41 53 53 20 6f 72 20 46 41 49 4c  s a PASS or FAIL
1120: 20 6f 66 20 61 20 74 65 73 74 2e 20 49 6e 20 6d   of a test. In m
1130: 6f 73 74 20 63 61 73 65 73 20 6d 65 67 61 74 65  ost cases megate
1140: 73 74 20 69 73 20 62 65 73 74 20 75 73 65 64 20  st is best used 
1150: 69 6e 20 63 6f 6e 6a 75 6e 63 74 69 6f 6e 20 77  in conjunction w
1160: 69 74 68 20 6c 6f 67 70 72 6f 20 6f 72 20 61 20  ith logpro or a 
1170: 73 69 6d 69 6c 61 72 20 74 6f 6f 6c 20 74 6f 20  similar tool to 
1180: 70 61 72 73 65 2c 20 61 6e 61 6c 79 7a 65 20 61  parse, analyze a
1190: 6e 64 20 64 65 63 69 64 65 20 6f 6e 20 74 68 65  nd decide on the
11a0: 20 74 65 73 74 20 6f 75 74 63 6f 6d 65 2e 20 41   test outcome. A
11b0: 20 63 61 6c 6c 20 74 6f 20 6d 65 67 61 74 65 73   call to megates
11c0: 74 20 63 61 6e 20 74 68 65 6e 20 62 65 20 6d 61  t can then be ma
11d0: 64 65 20 74 6f 20 72 65 63 6f 72 64 20 74 68 65  de to record the
11e0: 20 72 65 73 75 6c 74 2e 20 0a 3c 2f 64 69 76 3e   result. .</div>
11f0: 0a 3c 68 33 20 63 6c 61 73 73 3d 22 53 75 62 73  .<h3 class="Subs
1200: 65 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73  ection">.<a clas
1210: 73 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f  s="toc" name="to
1220: 63 2d 53 75 62 73 65 63 74 69 6f 6e 2d 30 2e 31  c-Subsection-0.1
1230: 2e 32 22 3e 30 2e 31 2e 32 3c 2f 61 3e e2 80 83  .2">0.1.2</a> 
1240: 4d 65 67 61 74 65 73 74 20 61 72 63 68 69 74 65  Megatest archite
1250: 63 74 75 72 65 0a 3c 2f 68 33 3e 0a 3c 64 69 76  cture.</h3>.<div
1260: 20 63 6c 61 73 73 3d 22 55 6e 69 6e 64 65 6e 74   class="Unindent
1270: 65 64 22 3e 0a 41 6c 6c 20 64 61 74 61 20 74 6f  ed">.All data to
1280: 20 73 70 65 63 69 66 79 20 74 68 65 20 74 65 73   specify the tes
1290: 74 73 20 61 6e 64 20 63 6f 6e 66 69 67 75 72 65  ts and configure
12a0: 20 74 68 65 20 73 79 73 74 65 6d 20 69 73 20 73   the system is s
12b0: 74 6f 72 65 64 20 69 6e 20 70 6c 61 69 6e 20 74  tored in plain t
12c0: 65 78 74 20 66 69 6c 65 73 2e 20 41 6c 6c 20 73  ext files. All s
12d0: 79 73 74 65 6d 20 73 74 61 74 65 20 69 73 20 73  ystem state is s
12e0: 74 6f 72 65 64 20 69 6e 20 61 6e 20 73 71 6c 69  tored in an sqli
12f0: 74 65 33 20 64 61 74 61 62 61 73 65 2e 20 54 65  te3 database. Te
1300: 73 74 73 20 61 72 65 20 6c 61 75 6e 63 68 65 64  sts are launched
1310: 20 75 73 69 6e 67 20 74 68 65 20 6c 61 75 6e 63   using the launc
1320: 68 69 6e 67 20 73 79 73 74 65 6d 20 61 76 61 69  hing system avai
1330: 6c 61 62 6c 65 20 66 6f 72 20 74 68 65 20 64 69  lable for the di
1340: 73 74 72 69 62 75 74 65 64 20 63 6f 6d 70 75 74  stributed comput
1350: 65 20 70 6c 61 74 66 6f 72 6d 20 69 6e 20 75 73  e platform in us
1360: 65 2e 20 41 20 74 65 6d 70 6c 61 74 65 20 73 63  e. A template sc
1370: 72 69 70 74 20 69 73 20 70 72 6f 76 69 64 65 64  ript is provided
1380: 20 77 68 69 63 68 20 63 61 6e 20 6c 61 75 6e 63   which can launc
1390: 68 20 6a 6f 62 73 20 6f 6e 20 6c 6f 63 61 6c 20  h jobs on local 
13a0: 61 6e 64 20 72 65 6d 6f 74 65 20 4c 69 6e 75 78  and remote Linux
13b0: 20 68 6f 73 74 73 2e 20 43 75 72 72 65 6e 74 6c   hosts. Currentl
13c0: 79 20 6d 65 67 61 74 65 73 74 20 75 73 65 73 20  y megatest uses 
13d0: 74 68 65 20 6e 65 74 77 6f 72 6b 20 66 69 6c 65  the network file
13e0: 73 79 73 74 65 6d 20 74 6f 20 e2 80 9c 63 61 6c  system to “cal
13f0: 6c 20 68 6f 6d 65 e2 80 9d 20 74 6f 20 79 6f 75  l home” to you
1400: 72 20 6d 61 73 74 65 72 20 73 71 6c 69 74 65 33  r master sqlite3
1410: 20 64 61 74 61 62 61 73 65 2e 0a 3c 2f 64 69 76   database..</div
1420: 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 65 63  >.<h2 class="Sec
1430: 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d  tion">.<a class=
1440: 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d  "toc" name="toc-
1450: 53 65 63 74 69 6f 6e 2d 30 2e 32 22 3e 30 2e 32  Section-0.2">0.2
1460: 3c 2f 61 3e e2 80 83 49 6e 73 74 61 6c 6c 61 74  </a> Installat
1470: 69 6f 6e 0a 3c 2f 68 32 3e 0a 3c 68 33 20 63 6c  ion.</h2>.<h3 cl
1480: 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22  ass="Subsection"
1490: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22  >.<a class="toc"
14a0: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65   name="toc-Subse
14b0: 63 74 69 6f 6e 2d 30 2e 32 2e 31 22 3e 30 2e 32  ction-0.2.1">0.2
14c0: 2e 31 3c 2f 61 3e e2 80 83 43 6f 6d 70 69 6c 61  .1</a> Compila
14d0: 74 69 6f 6e 0a 3c 2f 68 33 3e 0a 3c 68 34 20 63  tion.</h3>.<h4 c
14e0: 6c 61 73 73 3d 22 53 75 62 73 75 62 73 65 63 74  lass="Subsubsect
14f0: 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22  ion">.<a class="
1500: 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53  toc" name="toc-S
1510: 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 30 2e 32  ubsubsection-0.2
1520: 2e 31 2e 31 22 3e 30 2e 32 2e 31 2e 31 3c 2f 61  .1.1">0.2.1.1</a
1530: 3e e2 80 83 44 65 70 65 6e 64 65 6e 63 69 65 73  > Dependencies
1540: 0a 3c 2f 68 34 3e 0a 3c 64 69 76 20 63 6c 61 73  .</h4>.<div clas
1550: 73 3d 22 55 6e 69 6e 64 65 6e 74 65 64 22 3e 0a  s="Unindented">.
1560: 43 68 69 63 6b 65 6e 20 73 63 68 65 6d 65 20 61  Chicken scheme a
1570: 6e 64 20 61 20 6e 75 6d 62 65 72 20 6f 66 20 65  nd a number of e
1580: 67 67 73 20 61 72 65 20 72 65 71 75 69 72 65 64  ggs are required
1590: 20 66 6f 72 20 62 75 69 6c 64 69 6e 67 20 6d 65   for building me
15a0: 67 61 74 65 73 74 2e 20 53 65 65 20 74 68 65 20  gatest. See the 
15b0: 66 69 6c 65 20 75 74 69 6c 73 2f 69 6e 73 74 61  file utils/insta
15c0: 6c 6c 61 6c 6c 2e 73 68 20 66 6f 72 20 61 6e 20  llall.sh for an 
15d0: 61 75 74 6f 6d 61 74 65 64 20 77 61 79 20 74 6f  automated way to
15e0: 20 69 6e 73 74 61 6c 6c 20 74 68 65 20 64 65 70   install the dep
15f0: 65 6e 64 65 6e 63 69 65 73 20 6f 6e 20 4c 69 6e  endencies on Lin
1600: 75 78 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 34 20 63  ux..</div>.<h4 c
1610: 6c 61 73 73 3d 22 53 75 62 73 75 62 73 65 63 74  lass="Subsubsect
1620: 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22  ion">.<a class="
1630: 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53  toc" name="toc-S
1640: 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 30 2e 32  ubsubsection-0.2
1650: 2e 31 2e 32 22 3e 30 2e 32 2e 31 2e 32 3c 2f 61  .1.2">0.2.1.2</a
1660: 3e e2 80 83 42 75 69 6c 64 20 61 6e 64 20 69 6e  > Build and in
1670: 73 74 61 6c 6c 0a 3c 2f 68 34 3e 0a 3c 64 69 76  stall.</h4>.<div
1680: 20 63 6c 61 73 73 3d 22 55 6e 69 6e 64 65 6e 74   class="Unindent
1690: 65 64 22 3e 0a 52 75 6e 20 e2 80 9c 6d 61 6b 65  ed">.Run “make
16a0: 20 74 65 73 74 e2 80 9d 20 74 6f 20 63 72 65 61   test” to crea
16b0: 74 65 20 74 68 65 20 6d 65 67 61 74 65 73 74 20  te the megatest 
16c0: 65 78 65 63 75 74 61 62 6c 65 2e 20 59 6f 75 20  executable. You 
16d0: 6d 61 79 20 77 69 73 68 20 74 6f 20 63 6f 70 79  may wish to copy
16e0: 20 74 68 65 20 65 78 65 63 75 74 61 62 6c 65 20   the executable 
16f0: 74 6f 20 61 20 63 65 6e 74 72 61 6c 6c 79 20 61  to a centrally a
1700: 63 63 65 73 73 69 62 6c 65 20 6c 6f 63 61 74 69  ccessible locati
1710: 6f 6e 2e 0a 3c 2f 64 69 76 3e 0a 3c 68 33 20 63  on..</div>.<h3 c
1720: 6c 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e  lass="Subsection
1730: 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63  ">.<a class="toc
1740: 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73  " name="toc-Subs
1750: 65 63 74 69 6f 6e 2d 30 2e 32 2e 32 22 3e 30 2e  ection-0.2.2">0.
1760: 32 2e 32 3c 2f 61 3e e2 80 83 53 65 74 75 70 0a  2.2</a> Setup.
1770: 3c 2f 68 33 3e 0a 3c 68 34 20 63 6c 61 73 73 3d  </h3>.<h4 class=
1780: 22 53 75 62 73 75 62 73 65 63 74 69 6f 6e 22 3e  "Subsubsection">
1790: 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20  .<a class="toc" 
17a0: 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 75 62  name="toc-Subsub
17b0: 73 65 63 74 69 6f 6e 2d 30 2e 32 2e 32 2e 31 22  section-0.2.2.1"
17c0: 3e 30 2e 32 2e 32 2e 31 3c 2f 61 3e e2 80 83 43  >0.2.2.1</a> C
17d0: 72 65 61 74 65 20 6d 65 67 61 74 65 73 74 2e 63  reate megatest.c
17e0: 6f 6e 66 69 67 0a 3c 2f 68 34 3e 0a 3c 64 69 76  onfig.</h4>.<div
17f0: 20 63 6c 61 73 73 3d 22 55 6e 69 6e 64 65 6e 74   class="Unindent
1800: 65 64 22 3e 0a 43 72 65 61 74 65 20 74 68 65 20  ed">.Create the 
1810: 66 69 6c 65 20 6d 65 67 61 74 65 73 74 2e 63 6f  file megatest.co
1820: 6e 66 69 67 20 75 73 69 6e 67 20 74 68 65 20 6d  nfig using the m
1830: 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 20 74  egatest.config t
1840: 65 6d 70 6c 61 74 65 20 66 72 6f 6d 20 74 68 65  emplate from the
1850: 20 74 65 73 74 73 20 64 69 72 65 63 74 6f 72 79   tests directory
1860: 2e 20 41 74 20 61 20 6d 69 6e 69 6d 75 6d 20 79  . At a minimum y
1870: 6f 75 20 6e 65 65 64 20 74 68 65 20 66 6f 6c 6c  ou need the foll
1880: 6f 77 69 6e 67 3a 0a 3c 2f 64 69 76 3e 0a 3c 64  owing:.</div>.<d
1890: 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e  iv class="Code">
18a0: 0a 23 20 46 69 65 6c 64 73 20 61 72 65 20 74 68  .# Fields are th
18b0: 65 20 6b 65 79 73 20 75 6e 64 65 72 20 77 68 69  e keys under whi
18c0: 63 68 20 79 6f 75 72 20 74 65 73 74 20 72 75 6e  ch your test run
18d0: 73 20 61 72 65 20 6f 72 67 61 6e 69 7a 65 64 0a  s are organized.
18e0: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73  </div>.<div clas
18f0: 73 3d 22 43 6f 64 65 22 3e 0a 5b 66 69 65 6c 64  s="Code">.[field
1900: 73 5d 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63  s].</div>.<div c
1910: 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 66 69 65  lass="Code">.fie
1920: 6c 64 31 20 54 45 58 54 0a 3c 2f 64 69 76 3e 0a  ld1 TEXT.</div>.
1930: 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 65  <div class="Code
1940: 22 3e 0a 66 69 65 6c 64 32 20 54 45 58 54 0a 3c  ">.field2 TEXT.<
1950: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73  /div>.<div class
1960: 3d 22 43 6f 64 65 22 3e 0a 0a 3c 2f 64 69 76 3e  ="Code">..</div>
1970: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f 64  .<div class="Cod
1980: 65 22 3e 0a 5b 6a 6f 62 74 6f 6f 6c 73 5d 0a 3c  e">.[jobtools].<
1990: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73  /div>.<div class
19a0: 3d 22 43 6f 64 65 22 3e 0a 23 20 54 68 65 20 6c  ="Code">.# The l
19b0: 61 75 6e 63 68 65 72 20 6c 61 75 6e 63 68 65 73  auncher launches
19c0: 20 6a 6f 62 73 20 74 6f 20 74 68 65 20 6c 6f 63   jobs to the loc
19d0: 61 6c 20 6f 72 20 72 65 6d 6f 74 65 20 68 6f 73  al or remote hos
19e0: 74 73 2c 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20  ts,.</div>.<div 
19f0: 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 23 20  class="Code">.# 
1a00: 74 68 65 20 6a 6f 62 20 69 73 20 6d 61 6e 61 67  the job is manag
1a10: 65 64 20 6f 6e 20 74 68 65 20 74 61 72 67 65 74  ed on the target
1a20: 20 68 6f 73 74 20 62 79 20 6d 65 67 61 74 65 73   host by megates
1a30: 74 2c 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63  t,.</div>.<div c
1a40: 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 23 20 63  lass="Code">.# c
1a50: 6f 6d 6d 65 6e 74 20 6f 75 74 20 6c 61 75 6e 63  omment out launc
1a60: 68 65 72 20 74 6f 20 72 75 6e 20 6c 6f 63 61 6c  her to run local
1a70: 20 6f 6e 6c 79 2e 20 41 6e 20 65 78 61 6d 70 6c   only. An exampl
1a80: 65 20 6c 61 75 6e 63 68 65 72 0a 3c 2f 64 69 76  e launcher.</div
1a90: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f  >.<div class="Co
1aa0: 64 65 22 3e 0a 23 20 22 6e 62 66 61 6b 65 22 20  de">.# "nbfake" 
1ab0: 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 69 6e 20  can be found in 
1ac0: 74 68 65 20 75 74 69 6c 73 20 64 69 72 65 63 74  the utils direct
1ad0: 6f 72 79 2e 20 0a 3c 2f 64 69 76 3e 0a 3c 64 69  ory. .</div>.<di
1ae0: 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a  v class="Code">.
1af0: 6c 61 75 6e 63 68 65 72 20 6e 62 66 61 6b 65 0a  launcher nbfake.
1b00: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73  </div>.<div clas
1b10: 73 3d 22 43 6f 64 65 22 3e 0a 0a 3c 2f 64 69 76  s="Code">..</div
1b20: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f  >.<div class="Co
1b30: 64 65 22 3e 0a 23 20 54 68 65 20 64 69 73 6b 73  de">.# The disks
1b40: 20 73 65 63 74 69 6f 6e 20 73 70 65 63 69 66 69   section specifi
1b50: 65 73 20 77 68 65 72 65 20 74 68 65 20 74 65 73  es where the tes
1b60: 74 73 20 77 69 6c 6c 20 62 65 20 72 75 6e 2e 20  ts will be run. 
1b70: 41 73 20 79 6f 75 0a 3c 2f 64 69 76 3e 0a 3c 64  As you.</div>.<d
1b80: 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e  iv class="Code">
1b90: 0a 23 20 72 75 6e 20 6f 75 74 20 6f 66 20 73 70  .# run out of sp
1ba0: 61 63 65 20 69 6e 20 61 20 70 61 72 74 69 74 69  ace in a partiti
1bb0: 6f 6e 20 79 6f 75 20 63 61 6e 20 61 64 64 20 61  on you can add a
1bc0: 64 64 69 74 69 6f 6e 61 6c 20 64 69 73 6b 73 0a  dditional disks.
1bd0: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73  </div>.<div clas
1be0: 73 3d 22 43 6f 64 65 22 3e 0a 23 20 65 6e 74 72  s="Code">.# entr
1bf0: 69 65 73 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76  ies..</div>.<div
1c00: 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 23   class="Code">.#
1c10: 20 46 6f 72 6d 61 74 20 69 73 3a 0a 3c 2f 64 69   Format is:.</di
1c20: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43  v>.<div class="C
1c30: 6f 64 65 22 3e 0a 23 20 6e 61 6d 65 20 2f 70 61  ode">.# name /pa
1c40: 74 68 2f 74 6f 2f 61 72 65 61 20 0a 3c 2f 64 69  th/to/area .</di
1c50: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43  v>.<div class="C
1c60: 6f 64 65 22 3e 0a 5b 64 69 73 6b 73 5d 0a 3c 2f  ode">.[disks].</
1c70: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d  div>.<div class=
1c80: 22 43 6f 64 65 22 3e 0a 31 20 2f 74 6d 70 20 0a  "Code">.1 /tmp .
1c90: 3c 2f 64 69 76 3e 0a 3c 68 34 20 63 6c 61 73 73  </div>.<h4 class
1ca0: 3d 22 53 75 62 73 75 62 73 65 63 74 69 6f 6e 22  ="Subsubsection"
1cb0: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22  >.<a class="toc"
1cc0: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 75   name="toc-Subsu
1cd0: 62 73 65 63 74 69 6f 6e 2d 30 2e 32 2e 32 2e 32  bsection-0.2.2.2
1ce0: 22 3e 30 2e 32 2e 32 2e 32 3c 2f 61 3e e2 80 83  ">0.2.2.2</a> 
1cf0: 43 72 65 61 74 65 20 72 75 6e 63 6f 6e 66 69 67  Create runconfig
1d00: 73 2e 63 6f 6e 66 69 67 0a 3c 2f 68 34 3e 0a 3c  s.config.</h4>.<
1d10: 64 69 76 20 63 6c 61 73 73 3d 22 55 6e 69 6e 64  div class="Unind
1d20: 65 6e 74 65 64 22 3e 0a 54 68 69 73 20 66 69 6c  ented">.This fil
1d30: 65 20 69 73 20 75 73 65 64 20 74 6f 20 73 65 74  e is used to set
1d40: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72   environment var
1d50: 69 61 62 6c 65 73 20 74 68 61 74 20 61 72 65 20  iables that are 
1d60: 72 75 6e 20 73 70 65 63 69 66 69 63 2e 20 59 6f  run specific. Yo
1d70: 75 20 63 61 6e 20 73 69 6d 70 6c 79 20 63 72 65  u can simply cre
1d80: 61 74 65 20 61 6e 20 65 6d 70 74 79 20 66 69 6c  ate an empty fil
1d90: 65 20 74 6f 20 73 74 61 72 74 2e 0a 3c 2f 64 69  e to start..</di
1da0: 76 3e 0a 3c 68 34 20 63 6c 61 73 73 3d 22 53 75  v>.<h4 class="Su
1db0: 62 73 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61  bsubsection">.<a
1dc0: 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d   class="toc" nam
1dd0: 65 3d 22 74 6f 63 2d 53 75 62 73 75 62 73 65 63  e="toc-Subsubsec
1de0: 74 69 6f 6e 2d 30 2e 32 2e 32 2e 33 22 3e 30 2e  tion-0.2.2.3">0.
1df0: 32 2e 32 2e 33 3c 2f 61 3e e2 80 83 43 72 65 61  2.2.3</a> Crea
1e00: 74 65 20 74 68 65 20 74 65 73 74 73 20 64 69 72  te the tests dir
1e10: 65 63 74 6f 72 79 20 61 6e 64 20 79 6f 75 72 20  ectory and your 
1e20: 66 69 72 73 74 20 74 65 73 74 0a 3c 2f 68 34 3e  first test.</h4>
1e30: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 55 6e 69  .<div class="Uni
1e40: 6e 64 65 6e 74 65 64 22 3e 0a 54 68 65 20 73 74  ndented">.The st
1e50: 72 75 63 74 75 72 65 20 73 68 6f 75 6c 64 20 6c  ructure should l
1e60: 6f 6f 6b 20 6c 69 6b 65 20 74 68 69 73 3a 0a 3c  ook like this:.<
1e70: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73  /div>.<div class
1e80: 3d 22 43 6f 64 65 22 3e 0a 2e 2e 2f 74 65 73 74  ="Code">.../test
1e90: 73 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c  s.</div>.<div cl
1ea0: 61 73 73 3d 22 43 6f 64 65 22 3e 0a e2 94 9c e2  ass="Code">.├
1eb0: 94 80 e2 94 80 20 6d 65 67 61 74 65 73 74 2e 63  ─ megatest.c
1ec0: 6f 6e 66 69 67 0a 3c 2f 64 69 76 3e 0a 3c 64 69  onfig.</div>.<di
1ed0: 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a  v class="Code">.
1ee0: e2 94 9c e2 94 80 e2 94 80 20 72 75 6e 63 6f 6e  ├── runcon
1ef0: 66 69 67 73 2e 63 6f 6e 66 69 67 20 0a 3c 2f 64  figs.config .</d
1f00: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22  iv>.<div class="
1f10: 43 6f 64 65 22 3e 0a e2 94 94 e2 94 80 e2 94 80  Code">.└──
1f20: 20 74 65 73 74 73 20 0a 3c 2f 64 69 76 3e 0a 3c   tests .</div>.<
1f30: 64 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22  div class="Code"
1f40: 3e 0a 20 c2 a0 c2 a0 20 e2 94 94 e2 94 80 e2 94  >.    └─
1f50: 80 20 6d 79 74 65 73 74 20 0a 3c 2f 64 69 76 3e   mytest .</div>
1f60: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f 64  .<div class="Cod
1f70: 65 22 3e 0a 20 20 20 20 20 20 20 e2 94 9c e2 94  e">.       ├
1f80: 80 e2 94 80 20 6d 61 69 6e 2e 73 68 0a 3c 2f 64  ─ main.sh.</d
1f90: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22  iv>.<div class="
1fa0: 43 6f 64 65 22 3e 0a 20 20 20 20 c2 a0 c2 a0 20  Code">.       
1fb0: e2 94 94 e2 94 80 e2 94 80 20 74 65 73 74 63 6f  └── testco
1fc0: 6e 66 69 67 20 0a 3c 2f 64 69 76 3e 0a 3c 68 34  nfig .</div>.<h4
1fd0: 20 63 6c 61 73 73 3d 22 53 75 62 73 75 62 73 65   class="Subsubse
1fe0: 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73  ction">.<a class
1ff0: 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63  ="toc" name="toc
2000: 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 30  -Subsubsection-0
2010: 2e 32 2e 32 2e 34 22 3e 30 2e 32 2e 32 2e 34 3c  .2.2.4">0.2.2.4<
2020: 2f 61 3e e2 80 83 43 72 65 61 74 65 20 74 68 65  /a> Create the
2030: 20 74 65 73 74 63 6f 6e 66 69 67 20 66 69 6c 65   testconfig file
2040: 20 66 6f 72 20 79 6f 75 72 20 74 65 73 74 0a 3c   for your test.<
2050: 2f 68 34 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d  /h4>.<div class=
2060: 22 43 6f 64 65 22 3e 0a 5b 73 65 74 75 70 5d 0a  "Code">.[setup].
2070: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73  </div>.<div clas
2080: 73 3d 22 43 6f 64 65 22 3e 0a 72 75 6e 73 63 72  s="Code">.runscr
2090: 69 70 74 20 6d 61 69 6e 2e 73 68 0a 3c 2f 64 69  ipt main.sh.</di
20a0: 76 3e 0a 3c 68 34 20 63 6c 61 73 73 3d 22 53 75  v>.<h4 class="Su
20b0: 62 73 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61  bsubsection">.<a
20c0: 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d   class="toc" nam
20d0: 65 3d 22 74 6f 63 2d 53 75 62 73 75 62 73 65 63  e="toc-Subsubsec
20e0: 74 69 6f 6e 2d 30 2e 32 2e 32 2e 35 22 3e 30 2e  tion-0.2.2.5">0.
20f0: 32 2e 32 2e 35 3c 2f 61 3e e2 80 83 43 72 65 61  2.2.5</a> Crea
2100: 74 65 20 79 6f 75 72 20 74 65 73 74 20 72 75 6e  te your test run
2110: 6e 69 6e 67 20 73 63 72 69 70 74 2c 20 6d 61 69  ning script, mai
2120: 6e 2e 73 68 0a 3c 2f 68 34 3e 0a 3c 64 69 76 20  n.sh.</h4>.<div 
2130: 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 23 21  class="Code">.#!
2140: 2f 62 69 6e 2f 62 61 73 68 0a 3c 2f 64 69 76 3e  /bin/bash.</div>
2150: 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f 64  .<div class="Cod
2160: 65 22 3e 0a 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76  e">..</div>.<div
2170: 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 6d   class="Code">.m
2180: 65 67 61 74 65 73 74 20 2d 72 75 6e 73 74 65 70  egatest -runstep
2190: 20 6d 79 73 74 65 70 31 20 22 73 6c 65 65 70 20   mystep1 "sleep 
21a0: 32 30 3b 65 63 68 6f 20 44 6f 6e 65 22 20 2d 6d  20;echo Done" -m
21b0: 20 22 6d 79 73 74 65 70 31 20 69 73 20 64 6f 6e   "mystep1 is don
21c0: 65 22 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63  e".</div>.<div c
21d0: 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 6d 65 67  lass="Code">.meg
21e0: 61 74 65 73 74 20 2d 74 65 73 74 2d 73 74 61 74  atest -test-stat
21f0: 75 73 20 3a 73 74 61 74 65 20 43 4f 4d 50 4c 45  us :state COMPLE
2200: 54 45 44 20 3a 73 74 61 74 75 73 20 50 41 53 53  TED :status PASS
2210: 20 2d 6d 20 22 54 68 69 73 20 69 73 20 61 20 74   -m "This is a t
2220: 65 73 74 20 6c 65 76 65 6c 20 63 6f 6d 6d 65 6e  est level commen
2230: 74 22 0a 3c 2f 64 69 76 3e 0a 3c 68 34 20 63 6c  t".</div>.<h4 cl
2240: 61 73 73 3d 22 53 75 62 73 75 62 73 65 63 74 69  ass="Subsubsecti
2250: 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74  on">.<a class="t
2260: 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75  oc" name="toc-Su
2270: 62 73 75 62 73 65 63 74 69 6f 6e 2d 30 2e 32 2e  bsubsection-0.2.
2280: 32 2e 36 22 3e 30 2e 32 2e 32 2e 36 3c 2f 61 3e  2.6">0.2.2.6</a>
2290: e2 80 83 52 75 6e 20 6d 65 67 61 74 65 73 74 20   Run megatest 
22a0: 61 6e 64 20 77 61 74 63 68 20 79 6f 75 72 20 72  and watch your r
22b0: 75 6e 20 70 72 6f 67 72 65 73 73 0a 3c 2f 68 34  un progress.</h4
22c0: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f  >.<div class="Co
22d0: 64 65 22 3e 0a 6d 65 67 61 74 65 73 74 20 3a 66  de">.megatest :f
22e0: 69 65 6c 64 31 20 61 62 63 20 3a 66 69 65 6c 64  ield1 abc :field
22f0: 32 20 64 65 66 20 3a 72 75 6e 6e 61 6d 65 20 32  2 def :runname 2
2300: 30 31 31 77 65 65 6b 30 38 2e 34 61 20 2d 72 75  011week08.4a -ru
2310: 6e 61 6c 6c 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76  nall.</div>.<div
2320: 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 77   class="Code">.w
2330: 61 74 63 68 20 6d 65 67 61 74 65 73 74 20 2d 6c  atch megatest -l
2340: 69 73 74 2d 72 75 6e 73 20 25 0a 3c 2f 64 69 76  ist-runs %.</div
2350: 3e 0a 3c 68 32 20 63 6c 61 73 73 3d 22 53 65 63  >.<h2 class="Sec
2360: 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73 3d  tion">.<a class=
2370: 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d  "toc" name="toc-
2380: 53 65 63 74 69 6f 6e 2d 30 2e 33 22 3e 30 2e 33  Section-0.3">0.3
2390: 3c 2f 61 3e e2 80 83 52 65 66 65 72 65 6e 63 65  </a> Reference
23a0: 0a 3c 2f 68 32 3e 0a 3c 68 33 20 63 6c 61 73 73  .</h2>.<h3 class
23b0: 3d 22 53 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c  ="Subsection">.<
23c0: 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61  a class="toc" na
23d0: 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65 63 74 69  me="toc-Subsecti
23e0: 6f 6e 2d 30 2e 33 2e 31 22 3e 30 2e 33 2e 31 3c  on-0.3.1">0.3.1<
23f0: 2f 61 3e e2 80 83 45 6e 76 69 72 6f 6e 6d 65 6e  /a> Environmen
2400: 74 20 76 61 72 69 61 62 6c 65 73 0a 3c 2f 68 33  t variables.</h3
2410: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 55 6e  >.<div class="Un
2420: 69 6e 64 65 6e 74 65 64 22 3e 0a 0a 3c 74 61 62  indented">..<tab
2430: 6c 65 3e 0a 0a 3c 74 72 3e 0a 0a 3c 74 64 20 61  le>..<tr>..<td a
2440: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69  lign="left" vali
2450: 67 6e 3d 22 74 6f 70 22 3e 0a 56 61 72 69 61 62  gn="top">.Variab
2460: 6c 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69  le.</td>.<td ali
2470: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e  gn="left" valign
2480: 3d 22 74 6f 70 22 3e 0a 50 75 72 70 6f 73 65 0a  ="top">.Purpose.
2490: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d  </td>.<td align=
24a0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74  "left" valign="t
24b0: 6f 70 22 3e 0a 44 65 66 61 75 6c 74 20 76 61 6c  op">.Default val
24c0: 75 65 2f 43 6f 6d 6d 65 6e 74 0a 3c 2f 74 64 3e  ue/Comment.</td>
24d0: 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 0a 3c 74 64  .</tr>.<tr>..<td
24e0: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61   align="left" va
24f0: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 4d 54 5f 43  lign="top">.MT_C
2500: 4d 44 49 4e 46 4f 0a 3c 2f 74 64 3e 0a 3c 74 64  MDINFO.</td>.<td
2510: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61   align="left" va
2520: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 43 6f 6e 76  lign="top">.Conv
2530: 65 79 73 20 74 65 73 74 20 76 61 72 69 61 62 6c  eys test variabl
2540: 65 73 20 74 6f 20 74 68 65 20 6d 65 67 61 74 65  es to the megate
2550: 73 74 20 74 65 73 74 20 72 75 6e 6e 65 72 2e 0a  st test runner..
2560: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d  </td>.<td align=
2570: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74  "left" valign="t
2580: 6f 70 22 3e 0a 4e 6f 74 20 66 6f 72 20 75 73 65  op">.Not for use
2590: 20 62 79 20 74 68 65 20 65 6e 64 20 75 73 65 72   by the end user
25a0: 0a 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72  .</td>.</tr>.<tr
25b0: 3e 0a 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65  >..<td align="le
25c0: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  ft" valign="top"
25d0: 3e 0a 4d 54 5f 54 45 53 54 5f 52 55 4e 5f 44 49  >.MT_TEST_RUN_DI
25e0: 52 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67  R.</td>.<td alig
25f0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d  n="left" valign=
2600: 22 74 6f 70 22 3e 0a 44 69 72 65 63 74 6f 72 79  "top">.Directory
2610: 20 61 73 73 69 67 6e 65 64 20 62 79 20 6d 65 67   assigned by meg
2620: 61 74 65 73 74 20 66 6f 72 20 74 68 65 20 74 65  atest for the te
2630: 73 74 20 74 6f 20 72 75 6e 2e 0a 3c 2f 74 64 3e  st to run..</td>
2640: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
2650: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
2660: 54 65 73 74 73 20 63 61 6e 20 63 6f 6e 73 69 64  Tests can consid
2670: 65 72 20 74 68 69 73 20 74 68 65 69 72 20 e2 80  er this their 
2680: 9c 68 6f 6d 65 e2 80 9d 20 64 69 72 65 63 74 6f  home” directo
2690: 72 79 0a 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c  ry.</td>.</tr>.<
26a0: 74 72 3e 0a 0a 3c 74 64 20 61 6c 69 67 6e 3d 22  tr>..<td align="
26b0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f  left" valign="to
26c0: 70 22 3e 0a 4d 54 5f 54 45 53 54 5f 4e 41 4d 45  p">.MT_TEST_NAME
26d0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e  .</td>.<td align
26e0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22  ="left" valign="
26f0: 74 6f 70 22 3e 0a 4e 61 6d 65 20 6f 66 20 74 68  top">.Name of th
2700: 65 20 74 65 73 74 2c 20 63 6f 72 72 6f 73 70 6f  e test, corrospo
2710: 6e 64 73 20 74 6f 20 74 68 65 20 64 69 72 65 63  nds to the direc
2720: 74 6f 72 79 20 6e 61 6d 65 20 75 6e 64 65 72 20  tory name under 
2730: 74 65 73 74 73 2e 0a 3c 2f 74 64 3e 0a 3c 74 64  tests..</td>.<td
2740: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61   align="left" va
2750: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74  lign="top">..</t
2760: 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 0a 3c  d>.</tr>.<tr>..<
2770: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
2780: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 4d 54  valign="top">.MT
2790: 5f 49 54 45 4d 5f 49 4e 46 4f 0a 3c 2f 74 64 3e  _ITEM_INFO.</td>
27a0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
27b0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
27c0: 49 74 65 72 61 74 65 64 20 74 65 73 74 73 20 77  Iterated tests w
27d0: 69 6c 6c 20 73 65 74 20 74 68 69 73 20 74 6f 20  ill set this to 
27e0: 61 20 73 65 71 75 65 6e 63 65 20 6f 66 20 6b 65  a sequence of ke
27f0: 79 2f 76 61 6c 75 65 73 20 28 28 4b 45 59 20 76  y/values ((KEY v
2800: 61 6c 29 20 2e 2e 2e 29 20 0a 3c 2f 74 64 3e 0a  al) ...) .</td>.
2810: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22  <td align="left"
2820: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a   valign="top">..
2830: 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e  </td>.</tr>.<tr>
2840: 0a 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66  ..<td align="lef
2850: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e  t" valign="top">
2860: 0a 4d 54 5f 52 55 4e 5f 41 52 45 41 5f 48 4f 4d  .MT_RUN_AREA_HOM
2870: 45 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67  E.</td>.<td alig
2880: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d  n="left" valign=
2890: 22 74 6f 70 22 3e 0a 44 69 72 65 63 74 6f 72 79  "top">.Directory
28a0: 20 77 68 65 72 65 20 6d 65 67 61 74 65 73 74 20   where megatest 
28b0: 77 61 73 20 6c 61 75 6e 63 68 65 64 20 66 72 6f  was launched fro
28c0: 6d 20 61 6e 64 20 77 68 65 72 65 20 74 68 65 20  m and where the 
28d0: 74 65 73 74 73 20 63 6f 64 65 20 63 61 6e 20 62  tests code can b
28e0: 65 20 66 6f 75 6e 64 0a 3c 2f 74 64 3e 0a 3c 74  e found.</td>.<t
28f0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76  d align="left" v
2900: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f  align="top">..</
2910: 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 0a  td>.</tr>.<tr>..
2920: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22  <td align="left"
2930: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 4d   valign="top">.M
2940: 54 5f 52 55 4e 4e 41 4d 45 0a 3c 2f 74 64 3e 0a  T_RUNNAME.</td>.
2950: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22  <td align="left"
2960: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 4e   valign="top">.N
2970: 61 6d 65 20 6f 66 20 74 68 69 73 20 72 75 6e 20  ame of this run 
2980: 61 73 20 73 65 74 20 62 79 20 74 68 65 20 3a 72  as set by the :r
2990: 75 6e 6e 61 6d 65 20 70 61 72 61 6d 65 74 65 72  unname parameter
29a0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e  .</td>.<td align
29b0: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22  ="left" valign="
29c0: 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 2f 74  top">..</td>.</t
29d0: 72 3e 0a 3c 74 72 3e 0a 0a 3c 74 64 20 61 6c 69  r>.<tr>..<td ali
29e0: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e  gn="left" valign
29f0: 3d 22 74 6f 70 22 3e 0a 26 6c 74 3b 66 69 65 6c  ="top">.&lt;fiel
2a00: 64 31 26 67 74 3b 20 2e 2e 2e 2e 0a 3c 2f 74 64  d1&gt; .....</td
2a10: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66  >.<td align="lef
2a20: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e  t" valign="top">
2a30: 0a 54 68 65 20 66 69 65 6c 64 20 76 61 6c 75 65  .The field value
2a40: 73 20 61 73 20 73 65 74 20 6f 6e 20 74 68 65 20  s as set on the 
2a50: 6d 65 67 61 74 65 73 74 20 2d 72 75 6e 61 6c 6c  megatest -runall
2a60: 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 28 65   command line (e
2a70: 2e 67 2e 20 3a 66 69 65 6c 64 31 20 61 62 63 29  .g. :field1 abc)
2a80: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e  .</td>.<td align
2a90: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22  ="left" valign="
2aa0: 74 6f 70 22 3e 0a 50 6c 61 6e 6e 69 6e 67 20 61  top">.Planning a
2ab0: 68 65 61 64 20 79 6f 75 72 20 66 69 65 6c 64 20  head your field 
2ac0: 6e 61 6d 65 73 20 69 73 20 69 6d 70 6f 72 74 61  names is importa
2ad0: 6e 74 20 73 6f 20 61 73 20 74 6f 20 61 76 6f 69  nt so as to avoi
2ae0: 64 20 63 6f 6c 6c 69 73 69 6f 6e 73 20 77 69 74  d collisions wit
2af0: 68 20 6f 74 68 65 72 20 65 6e 76 69 72 6f 6e 6d  h other environm
2b00: 65 6e 74 20 76 61 72 69 61 62 6c 65 73 0a 3c 2f  ent variables.</
2b10: 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 2f 74 61 62 6c  td>.</tr>.</tabl
2b20: 65 3e 0a 3c 2f 64 69 76 3e 0a 3c 68 33 20 63 6c  e>.</div>.<h3 cl
2b30: 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22  ass="Subsection"
2b40: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22  >.<a class="toc"
2b50: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65   name="toc-Subse
2b60: 63 74 69 6f 6e 2d 30 2e 33 2e 32 22 3e 30 2e 33  ction-0.3.2">0.3
2b70: 2e 32 3c 2f 61 3e e2 80 83 43 6f 6e 66 69 67 75  .2</a> Configu
2b80: 72 61 74 69 6f 6e 20 66 69 6c 65 73 0a 3c 2f 68  ration files.</h
2b90: 33 3e 0a 3c 68 34 20 63 6c 61 73 73 3d 22 53 75  3>.<h4 class="Su
2ba0: 62 73 75 62 73 65 63 74 69 6f 6e 22 3e 0a 3c 61  bsubsection">.<a
2bb0: 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e 61 6d   class="toc" nam
2bc0: 65 3d 22 74 6f 63 2d 53 75 62 73 75 62 73 65 63  e="toc-Subsubsec
2bd0: 74 69 6f 6e 2d 30 2e 33 2e 32 2e 31 22 3e 30 2e  tion-0.3.2.1">0.
2be0: 33 2e 32 2e 31 3c 2f 61 3e e2 80 83 6d 65 67 61  3.2.1</a> mega
2bf0: 74 65 73 74 2e 63 6f 6e 66 69 67 0a 3c 2f 68 34  test.config.</h4
2c00: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 55 6e  >.<div class="Un
2c10: 69 6e 64 65 6e 74 65 64 22 3e 0a 0a 3c 74 61 62  indented">..<tab
2c20: 6c 65 3e 0a 0a 3c 74 72 3e 0a 0a 3c 74 64 20 61  le>..<tr>..<td a
2c30: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69  lign="left" vali
2c40: 67 6e 3d 22 74 6f 70 22 3e 0a 73 65 63 74 69 6f  gn="top">.sectio
2c50: 6e 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67  n.</td>.<td alig
2c60: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d  n="left" valign=
2c70: 22 74 6f 70 22 3e 0a 76 61 72 69 61 62 6c 65 0a  "top">.variable.
2c80: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d  </td>.<td align=
2c90: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74  "left" valign="t
2ca0: 6f 70 22 3e 0a 76 61 6c 75 65 0a 3c 2f 74 64 3e  op">.value.</td>
2cb0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
2cc0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
2cd0: 72 65 71 75 69 72 65 64 0a 3c 2f 74 64 3e 0a 3c  required.</td>.<
2ce0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
2cf0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 63 6f  valign="top">.co
2d00: 6d 6d 65 6e 74 0a 3c 2f 74 64 3e 0a 3c 2f 74 72  mment.</td>.</tr
2d10: 3e 0a 3c 74 72 3e 0a 0a 3c 74 64 20 61 6c 69 67  >.<tr>..<td alig
2d20: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d  n="left" valign=
2d30: 22 74 6f 70 22 3e 0a 5b 73 65 74 75 70 5d 0a 3c  "top">.[setup].<
2d40: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22  /td>.<td align="
2d50: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f  left" valign="to
2d60: 70 22 3e 0a 6d 61 78 5f 63 6f 6e 63 75 72 72 65  p">.max_concurre
2d70: 6e 74 5f 6a 6f 62 73 0a 3c 2f 74 64 3e 0a 3c 74  nt_jobs.</td>.<t
2d80: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76  d align="left" v
2d90: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 69 66 20  align="top">.if 
2da0: 76 61 72 69 61 62 6c 65 20 69 73 20 6e 6f 74 20  variable is not 
2db0: 64 65 66 69 6e 65 64 20 6e 6f 20 6c 69 6d 69 74  defined no limit
2dc0: 20 6f 6e 20 6a 6f 62 73 0a 3c 2f 74 64 3e 0a 3c   on jobs.</td>.<
2dd0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
2de0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 6e 6f  valign="top">.no
2df0: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e  .</td>.<td align
2e00: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22  ="left" valign="
2e10: 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c 2f 74  top">..</td>.</t
2e20: 72 3e 0a 3c 74 72 3e 0a 0a 3c 74 64 20 61 6c 69  r>.<tr>..<td ali
2e30: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e  gn="left" valign
2e40: 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a 3c  ="top">..</td>.<
2e50: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
2e60: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 65 78  valign="top">.ex
2e70: 65 63 75 74 61 62 6c 65 0a 3c 2f 74 64 3e 0a 3c  ecutable.</td>.<
2e80: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
2e90: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 66 75  valign="top">.fu
2ea0: 6c 6c 20 70 61 74 68 20 74 6f 20 6d 65 67 61 74  ll path to megat
2eb0: 65 73 74 20 62 69 6e 61 72 79 0a 3c 2f 74 64 3e  est binary.</td>
2ec0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
2ed0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
2ee0: 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69  no.</td>.<td ali
2ef0: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e  gn="left" valign
2f00: 3d 22 74 6f 70 22 3e 0a 55 73 65 20 6f 6e 6c 79  ="top">.Use only
2f10: 20 69 66 20 6e 65 63 65 73 73 61 72 79 2c 20 6d   if necessary, m
2f20: 65 67 61 74 65 73 74 20 77 69 6c 6c 20 65 78 74  egatest will ext
2f30: 72 61 63 74 20 74 68 65 20 6c 6f 63 61 74 69 6f  ract the locatio
2f40: 6e 20 66 72 6f 6d 20 77 68 65 72 65 20 69 74 20  n from where it 
2f50: 75 73 65 64 20 74 6f 20 6c 61 75 6e 63 68 20 61  used to launch a
2f60: 6e 64 20 61 64 64 20 61 70 70 65 6e 64 20 74 68  nd add append th
2f70: 61 74 20 74 6f 20 74 68 65 20 50 41 54 48 20 66  at to the PATH f
2f80: 6f 72 20 74 65 73 74 20 72 75 6e 73 2e 0a 3c 2f  or test runs..</
2f90: 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 0a  td>.</tr>.<tr>..
2fa0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22  <td align="left"
2fb0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a   valign="top">..
2fc0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d  </td>.<td align=
2fd0: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74  "left" valign="t
2fe0: 6f 70 22 3e 0a 72 75 6e 73 64 69 72 0a 3c 2f 74  op">.runsdir.</t
2ff0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65  d>.<td align="le
3000: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  ft" valign="top"
3010: 3e 0a 66 75 6c 6c 20 70 61 74 68 20 74 6f 20 77  >.full path to w
3020: 68 65 72 65 20 74 68 65 20 6c 69 6e 6b 20 74 72  here the link tr
3030: 65 65 20 74 6f 20 61 6c 6c 20 72 75 6e 73 20 77  ee to all runs w
3040: 69 6c 6c 20 62 65 20 63 72 65 61 74 65 64 0a 3c  ill be created.<
3050: 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22  /td>.<td align="
3060: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f  left" valign="to
3070: 70 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64  p">.no.</td>.<td
3080: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61   align="left" va
3090: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 42 65 63 61  lign="top">.Beca
30a0: 75 73 65 20 79 6f 75 72 20 72 75 6e 73 20 6d 61  use your runs ma
30b0: 79 20 62 65 20 73 70 72 65 61 64 20 6f 75 74 20  y be spread out 
30c0: 6f 76 65 72 20 73 65 76 65 72 61 6c 20 64 69 73  over several dis
30d0: 6b 20 70 61 72 74 69 74 69 6f 6e 73 20 61 20 63  k partitions a c
30e0: 65 6e 74 72 61 6c 20 6c 69 6e 6b 20 74 72 65 65  entral link tree
30f0: 20 69 73 20 63 72 65 61 74 65 64 20 74 6f 20 6d   is created to m
3100: 61 6b 65 20 66 69 6e 64 69 6e 67 20 61 6c 6c 20  ake finding all 
3110: 74 68 65 20 72 75 6e 73 20 65 61 73 79 2e 0a 3c  the runs easy..<
3120: 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a  /td>.</tr>.<tr>.
3130: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
3140: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
3150: 5b 66 69 65 6c 64 73 5d 0a 3c 2f 74 64 3e 0a 3c  [fields].</td>.<
3160: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
3170: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73 74  valign="top">.st
3180: 72 69 6e 67 20 6f 66 20 6c 65 74 74 65 72 73 2c  ring of letters,
3190: 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 75 6e 64   numbers and und
31a0: 65 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a 3c 74  erscore.</td>.<t
31b0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76  d align="left" v
31c0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73 74 72  align="top">.str
31d0: 69 6e 67 20 6f 66 20 6c 65 74 74 65 72 73 2c 20  ing of letters, 
31e0: 6e 75 6d 62 65 72 73 20 61 6e 64 20 75 6e 64 65  numbers and unde
31f0: 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a 3c 74 64  rscore.</td>.<td
3200: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61   align="left" va
3210: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 61 74 20 6c  lign="top">.at l
3220: 65 61 73 74 20 6f 6e 65 0a 3c 2f 74 64 3e 0a 3c  east one.</td>.<
3230: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
3240: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c  valign="top">..<
3250: 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a  /td>.</tr>.<tr>.
3260: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
3270: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
3280: 5b 6a 6f 62 74 6f 6f 6c 73 5d 0a 3c 2f 74 64 3e  [jobtools].</td>
3290: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
32a0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
32b0: 6c 61 75 6e 63 68 65 72 0a 3c 2f 74 64 3e 0a 3c  launcher.</td>.<
32c0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
32d0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 63 6f  valign="top">.co
32e0: 6d 6d 61 6e 64 20 6c 69 6e 65 20 75 73 65 64 20  mmand line used 
32f0: 74 6f 20 6c 61 75 6e 63 68 20 6a 6f 62 73 20 2d  to launch jobs -
3300: 20 74 68 65 20 6a 6f 62 20 63 6f 6d 6d 61 6e 64   the job command
3310: 20 28 6d 65 67 61 74 65 73 74 20 2d 65 78 65 63   (megatest -exec
3320: 75 74 65 29 20 77 69 6c 6c 20 62 65 20 61 70 70  ute) will be app
3330: 65 6e 64 65 64 20 74 6f 20 74 68 69 73 0a 3c 2f  ended to this.</
3340: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c  td>.<td align="l
3350: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70  eft" valign="top
3360: 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20  ">.no.</td>.<td 
3370: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c  align="left" val
3380: 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64  ign="top">..</td
3390: 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 0a 3c 74  >.</tr>.<tr>..<t
33a0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76  d align="left" v
33b0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f  align="top">..</
33c0: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c  td>.<td align="l
33d0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70  eft" valign="top
33e0: 22 3e 0a 77 6f 72 6b 68 6f 73 74 73 0a 3c 2f 74  ">.workhosts.</t
33f0: 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65  d>.<td align="le
3400: 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  ft" valign="top"
3410: 3e 0a 6c 69 73 74 20 6f 66 20 68 6f 73 74 6e 61  >.list of hostna
3420: 6d 65 73 20 74 6f 20 72 75 6e 20 6a 6f 62 73 20  mes to run jobs 
3430: 6f 6e 20 4e 4f 54 20 53 55 50 50 4f 52 54 45 44  on NOT SUPPORTED
3440: 20 52 49 47 48 54 20 4e 4f 57 0a 3c 2f 74 64 3e   RIGHT NOW.</td>
3450: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
3460: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
3470: 6e 2f 61 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c  n/a.</td>.<td al
3480: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67  ign="left" valig
3490: 6e 3d 22 74 6f 70 22 3e 0a 0a 3c 2f 74 64 3e 0a  n="top">..</td>.
34a0: 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 0a 3c 74 64 20  </tr>.<tr>..<td 
34b0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c  align="left" val
34c0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 5b 65 6e 76 2d  ign="top">.[env-
34d0: 6f 76 65 72 72 69 64 65 5d 0a 3c 2f 74 64 3e 0a  override].</td>.
34e0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22  <td align="left"
34f0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73   valign="top">.s
3500: 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 65 72 73  tring of letters
3510: 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 75 6e  , numbers and un
3520: 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a 3c  derscore.</td>.<
3530: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
3540: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 61 6e  valign="top">.an
3550: 79 20 73 74 72 69 6e 67 0a 3c 2f 74 64 3e 0a 3c  y string.</td>.<
3560: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
3570: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 6e 6f  valign="top">.no
3580: 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e  .</td>.<td align
3590: 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22  ="left" valign="
35a0: 74 6f 70 22 3e 0a 54 68 65 73 65 20 61 72 65 20  top">.These are 
35b0: 73 65 74 20 6f 6e 20 74 68 65 20 74 65 73 74 20  set on the test 
35c0: 6c 61 75 6e 63 68 69 6e 67 20 6d 61 63 68 69 6e  launching machin
35d0: 65 2c 20 6e 6f 74 20 74 68 65 20 74 65 73 74 20  e, not the test 
35e0: 72 75 6e 6e 69 6e 67 20 6d 61 63 68 69 6e 65 2e  running machine.
35f0: 20 54 79 70 69 63 61 6c 20 75 73 61 67 65 20 69   Typical usage i
3600: 73 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 74 68 65  s to control the
3610: 20 68 6f 73 74 20 6f 72 20 72 75 6e 20 71 75 65   host or run que
3620: 75 65 20 66 6f 72 20 6c 61 75 6e 63 68 69 6e 67  ue for launching
3630: 20 74 65 73 74 73 2e 20 54 68 65 73 65 20 76 61   tests. These va
3640: 6c 75 65 73 20 77 69 6c 6c 20 6e 6f 74 20 62 65  lues will not be
3650: 20 73 65 65 6e 20 62 79 20 74 68 65 20 74 65 73   seen by the tes
3660: 74 20 77 68 65 6e 20 69 74 20 72 75 6e 73 2e 0a  t when it runs..
3670: 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e  </td>.</tr>.<tr>
3680: 0a 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66  ..<td align="lef
3690: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e  t" valign="top">
36a0: 0a 5b 64 69 73 6b 73 5d 0a 3c 2f 74 64 3e 0a 3c  .[disks].</td>.<
36b0: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
36c0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 73 74  valign="top">.st
36d0: 72 69 6e 67 20 6f 66 20 6c 65 74 74 65 72 73 2c  ring of letters,
36e0: 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 75 6e 64   numbers and und
36f0: 65 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a 3c 74  erscore.</td>.<t
3700: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76  d align="left" v
3710: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 61 20 76  align="top">.a v
3720: 61 6c 69 64 20 70 61 74 68 20 77 72 69 74 61 62  alid path writab
3730: 6c 65 20 62 79 20 74 68 65 20 74 65 73 74 20 6c  le by the test l
3740: 61 75 6e 63 68 69 6e 67 20 70 72 6f 63 65 73 73  aunching process
3750: 20 61 6e 64 20 62 79 20 74 68 65 20 74 65 73 74   and by the test
3760: 20 70 72 6f 63 65 73 73 0a 3c 2f 74 64 3e 0a 3c   process.</td>.<
3770: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
3780: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 79 65  valign="top">.ye
3790: 73 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67  s.</td>.<td alig
37a0: 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d  n="left" valign=
37b0: 22 74 6f 70 22 3e 0a 54 68 65 20 64 69 73 6b 20  "top">.The disk 
37c0: 75 73 61 67 65 20 62 61 6c 61 6e 63 69 6e 67 20  usage balancing 
37d0: 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 74 6f 20  algorithm is to 
37e0: 63 68 6f 6f 73 65 20 74 68 65 20 64 69 73 6b 20  choose the disk 
37f0: 77 69 74 68 20 74 68 65 20 6c 65 61 73 74 20 73  with the least s
3800: 70 61 63 65 20 66 6f 72 20 65 61 63 68 20 74 65  pace for each te
3810: 73 74 20 72 75 6e 2e 20 0a 3c 2f 74 64 3e 0a 3c  st run. .</td>.<
3820: 2f 74 72 3e 0a 3c 2f 74 61 62 6c 65 3e 0a 3c 2f  /tr>.</table>.</
3830: 64 69 76 3e 0a 3c 68 34 20 63 6c 61 73 73 3d 22  div>.<h4 class="
3840: 53 75 62 73 75 62 73 65 63 74 69 6f 6e 22 3e 0a  Subsubsection">.
3850: 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e  <a class="toc" n
3860: 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 75 62 73  ame="toc-Subsubs
3870: 65 63 74 69 6f 6e 2d 30 2e 33 2e 32 2e 32 22 3e  ection-0.3.2.2">
3880: 30 2e 33 2e 32 2e 32 3c 2f 61 3e e2 80 83 72 75  0.3.2.2</a> ru
3890: 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 20  nconfigs.config 
38a0: 66 69 6c 65 0a 3c 2f 68 34 3e 0a 3c 64 69 76 20  file.</h4>.<div 
38b0: 63 6c 61 73 73 3d 22 55 6e 69 6e 64 65 6e 74 65  class="Unindente
38c0: 64 22 3e 0a 0a 3c 74 61 62 6c 65 3e 0a 0a 3c 74  d">..<table>..<t
38d0: 72 3e 0a 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c  r>..<td align="l
38e0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70  eft" valign="top
38f0: 22 3e 0a 73 65 63 74 69 6f 6e 0a 3c 2f 74 64 3e  ">.section.</td>
3900: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
3910: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
3920: 76 61 72 69 61 62 6c 65 0a 3c 2f 74 64 3e 0a 3c  variable.</td>.<
3930: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
3940: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 76 61  valign="top">.va
3950: 6c 75 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c  lue.</td>.<td al
3960: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67  ign="left" valig
3970: 6e 3d 22 74 6f 70 22 3e 0a 72 65 71 75 69 72 65  n="top">.require
3980: 64 3f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69  d?.</td>.<td ali
3990: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e  gn="left" valign
39a0: 3d 22 74 6f 70 22 3e 0a 63 6f 6d 6d 65 6e 74 0a  ="top">.comment.
39b0: 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e  </td>.</tr>.<tr>
39c0: 0a 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66  ..<td align="lef
39d0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e  t" valign="top">
39e0: 0a 5b 64 65 66 61 75 6c 74 5d 0a 3c 2f 74 64 3e  .[default].</td>
39f0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
3a00: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
3a10: 73 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 65 72  string of letter
3a20: 73 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 75  s, numbers and u
3a30: 6e 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a  nderscore.</td>.
3a40: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22  <td align="left"
3a50: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 61   valign="top">.a
3a60: 6e 79 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69  ny.</td>.<td ali
3a70: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e  gn="left" valign
3a80: 3d 22 74 6f 70 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e  ="top">.no.</td>
3a90: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
3aa0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
3ab0: 76 61 72 69 61 62 6c 65 73 20 73 65 74 20 69 6e  variables set in
3ac0: 20 74 68 69 73 20 73 65 63 74 69 6f 6e 20 77 69   this section wi
3ad0: 6c 6c 20 62 65 20 61 76 61 69 6c 61 62 6c 65 20  ll be available 
3ae0: 66 6f 72 20 61 6c 6c 20 72 75 6e 73 2c 20 64 65  for all runs, de
3af0: 66 69 6e 69 6e 67 20 74 68 65 20 73 61 6d 65 20  fining the same 
3b00: 76 61 72 69 61 62 6c 65 20 69 6e 20 61 6e 6f 74  variable in anot
3b10: 68 65 72 20 73 65 63 74 69 6f 6e 20 77 69 6c 6c  her section will
3b20: 20 6f 76 65 72 72 69 64 65 20 74 68 65 20 76 61   override the va
3b30: 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 64 65 66  lue from the def
3b40: 61 75 6c 74 20 73 65 63 74 69 6f 6e 0a 3c 2f 74  ault section.</t
3b50: 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 0a 3c  d>.</tr>.<tr>..<
3b60: 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20  td align="left" 
3b70: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 5b 66  valign="top">.[f
3b80: 69 65 6c 64 31 76 61 6c 75 65 2f 66 69 65 6c 64  ield1value/field
3b90: 32 76 61 6c 75 65 2e 2e 2e 5d 0a 3c 2f 74 64 3e  2value...].</td>
3ba0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
3bb0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
3bc0: 73 74 72 69 6e 67 20 6f 66 20 6c 65 74 74 65 72  string of letter
3bd0: 73 2c 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 75  s, numbers and u
3be0: 6e 64 65 72 73 63 6f 72 65 0a 3c 2f 74 64 3e 0a  nderscore.</td>.
3bf0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22  <td align="left"
3c00: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 61   valign="top">.a
3c10: 6e 79 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69  ny.</td>.<td ali
3c20: 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67 6e  gn="left" valign
3c30: 3d 22 74 6f 70 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e  ="top">.no.</td>
3c40: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
3c50: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
3c60: 74 68 65 20 76 61 6c 75 65 73 20 69 6e 20 74 68  the values in th
3c70: 69 73 20 73 65 63 74 69 6f 6e 20 77 69 6c 6c 20  is section will 
3c80: 62 65 20 73 65 74 20 66 6f 72 20 61 6e 79 20 72  be set for any r
3c90: 75 6e 20 77 68 65 72 65 20 66 69 65 6c 64 31 20  un where field1 
3ca0: 69 73 20 66 69 65 6c 64 31 76 61 6c 75 65 2c 20  is field1value, 
3cb0: 66 69 65 6c 64 32 20 69 73 20 66 69 65 6c 64 32  field2 is field2
3cc0: 76 61 6c 75 65 20 61 6e 64 20 66 69 65 6c 64 4e  value and fieldN
3cd0: 20 69 73 20 66 69 65 6c 64 4e 76 61 6c 75 65 2e   is fieldNvalue.
3ce0: 20 0a 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 2f   .</td>.</tr>.</
3cf0: 74 61 62 6c 65 3e 0a 3c 2f 64 69 76 3e 0a 3c 64  table>.</div>.<d
3d00: 69 76 20 63 6c 61 73 73 3d 22 49 6e 64 65 6e 74  iv class="Indent
3d10: 65 64 22 3e 0a 45 78 61 6d 70 6c 65 3a 20 61 20  ed">.Example: a 
3d20: 74 65 73 74 20 73 75 69 74 65 20 74 68 61 74 20  test suite that 
3d30: 63 68 65 63 6b 73 20 74 68 61 74 20 61 20 70 69  checks that a pi
3d40: 65 63 65 20 6f 66 20 73 6f 66 74 77 61 72 65 20  ece of software 
3d50: 77 6f 72 6b 73 20 63 6f 72 72 65 63 74 6c 79 20  works correctly 
3d60: 66 6f 72 20 64 69 66 66 65 72 65 6e 74 20 63 75  for different cu
3d70: 73 74 6f 6d 65 72 20 63 6f 6e 66 69 67 75 72 61  stomer configura
3d80: 74 69 6f 6e 73 20 61 6e 64 20 6c 6f 63 61 74 69  tions and locati
3d90: 6f 6e 73 20 65 61 63 68 20 6f 66 20 77 68 69 63  ons each of whic
3da0: 68 20 69 73 20 64 6f 6e 65 20 61 73 20 61 20 73  h is done as a s
3db0: 65 70 61 72 61 74 65 20 72 65 6c 65 61 73 65 20  eparate release 
3dc0: 72 65 67 72 65 73 73 69 6f 6e 20 72 75 6e 2e 20  regression run. 
3dd0: 54 68 65 20 66 69 65 6c 64 73 2c 20 43 55 53 54  The fields, CUST
3de0: 4f 4d 45 52 20 61 6e 64 20 4c 4f 43 41 54 49 4f  OMER and LOCATIO
3df0: 4e 20 77 65 72 65 20 63 68 6f 73 65 6e 2e 20 54  N were chosen. T
3e00: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 75 6e  he following run
3e10: 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 20 66  configs.config f
3e20: 69 6c 65 20 77 6f 75 6c 64 20 73 65 74 20 73 6f  ile would set so
3e30: 6d 65 20 76 61 72 69 61 62 6c 65 73 20 73 70 65  me variables spe
3e40: 63 69 66 69 63 20 74 6f 20 72 75 6e 73 20 66 6f  cific to runs fo
3e50: 72 20 6d 65 67 61 63 6f 72 70 20 69 6e 20 49 6e  r megacorp in In
3e60: 64 69 61 20 61 6e 64 20 66 65 6d 74 6f 63 6f 72  dia and femtocor
3e70: 70 20 69 6e 20 74 68 65 20 43 6f 6f 6b 20 49 73  p in the Cook Is
3e80: 6c 61 6e 64 73 20 61 6e 64 20 4e 65 77 20 5a 65  lands and New Ze
3e90: 61 6c 61 6e 64 3a 0a 3c 2f 64 69 76 3e 0a 3c 64  aland:.</div>.<d
3ea0: 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e  iv class="Code">
3eb0: 0a 23 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 6f  .# runconfigs.co
3ec0: 6e 66 69 67 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76  nfig.</div>.<div
3ed0: 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 5b   class="Code">.[
3ee0: 64 65 66 61 75 6c 74 5d 0a 3c 2f 64 69 76 3e 0a  default].</div>.
3ef0: 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 65  <div class="Code
3f00: 22 3e 0a 45 4e 43 52 59 54 49 4f 4e 20 74 72 75  ">.ENCRYTION tru
3f10: 65 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c  e.</div>.<div cl
3f20: 61 73 73 3d 22 43 6f 64 65 22 3e 0a 5b 6d 65 67  ass="Code">.[meg
3f30: 61 63 6f 72 70 2f 69 6e 64 69 61 5d 0a 3c 2f 64  acorp/india].</d
3f40: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22  iv>.<div class="
3f50: 43 6f 64 65 22 3e 0a 54 45 53 54 50 41 54 48 20  Code">.TESTPATH 
3f60: 2f 6e 66 73 2f 74 65 73 74 69 6e 67 2f 6d 65 67  /nfs/testing/meg
3f70: 61 63 6f 72 70 5f 72 75 6e 73 0a 3c 2f 64 69 76  acorp_runs.</div
3f80: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f  >.<div class="Co
3f90: 64 65 22 3e 0a 5b 66 65 6d 74 6f 63 6f 72 70 2f  de">.[femtocorp/
3fa0: 63 6f 6f 6b 5f 69 73 6c 61 6e 64 73 5d 0a 3c 2f  cook_islands].</
3fb0: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d  div>.<div class=
3fc0: 22 43 6f 64 65 22 3e 0a 45 4e 43 52 59 54 49 4f  "Code">.ENCRYTIO
3fd0: 4e 20 66 61 6c 73 65 0a 3c 2f 64 69 76 3e 0a 3c  N false.</div>.<
3fe0: 64 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22  div class="Code"
3ff0: 3e 0a 54 45 53 54 50 41 54 48 20 2f 61 66 73 2f  >.TESTPATH /afs/
4000: 6b 69 61 74 6f 61 2f 74 65 73 74 69 6e 67 2f 63  kiatoa/testing/c
4010: 6f 6f 6b 5f 69 73 6c 61 6e 64 73 0a 3c 2f 64 69  ook_islands.</di
4020: 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43  v>.<div class="C
4030: 6f 64 65 22 3e 0a 5b 66 65 6d 74 6f 63 6f 72 70  ode">.[femtocorp
4040: 2f 6e 65 77 5f 7a 65 61 6c 61 6e 64 5d 0a 3c 2f  /new_zealand].</
4050: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d  div>.<div class=
4060: 22 43 6f 64 65 22 3e 0a 54 45 53 54 50 41 54 48  "Code">.TESTPATH
4070: 20 2f 61 66 73 2f 6b 69 61 74 61 6f 2f 74 65 73   /afs/kiatao/tes
4080: 74 69 6e 67 2f 6e 65 77 5f 7a 65 61 6c 61 6e 64  ting/new_zealand
4090: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61  .</div>.<div cla
40a0: 73 73 3d 22 43 6f 64 65 22 3e 0a 5b 6d 65 67 61  ss="Code">.[mega
40b0: 63 6f 72 70 2f 6e 65 77 5f 7a 65 61 6c 61 6e 64  corp/new_zealand
40c0: 5d 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c  ].</div>.<div cl
40d0: 61 73 73 3d 22 43 6f 64 65 22 3e 0a 54 45 53 54  ass="Code">.TEST
40e0: 50 41 54 48 20 2f 6e 66 73 2f 74 65 73 74 69 6e  PATH /nfs/testin
40f0: 67 2f 6d 65 67 61 63 6f 72 70 5f 72 75 6e 73 0a  g/megacorp_runs.
4100: 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73  </div>.<div clas
4110: 73 3d 22 50 61 72 61 67 72 61 70 68 2d 22 3e 0a  s="Paragraph-">.
4120: 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22 20 6e  <a class="toc" n
4130: 61 6d 65 3d 22 74 6f 63 2d 50 61 72 61 67 72 61  ame="toc-Paragra
4140: 70 68 2a 2d 31 22 3e 3c 2f 61 3e 52 75 6e 6e 69  ph*-1"></a>Runni
4150: 6e 67 20 6d 65 67 61 74 65 73 74 20 6c 69 6b 65  ng megatest like
4160: 20 74 68 69 73 3a 0a 3c 2f 64 69 76 3e 0a 3c 64   this:.</div>.<d
4170: 69 76 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e  iv class="Code">
4180: 0a 6d 65 67 61 74 65 73 74 20 3a 43 55 53 54 4f  .megatest :CUSTO
4190: 4d 45 52 20 6d 65 67 61 63 6f 72 70 20 3a 4c 4f  MER megacorp :LO
41a0: 43 41 54 49 4f 4e 20 6e 65 77 5f 7a 65 61 6c 61  CATION new_zeala
41b0: 6e 64 20 3a 72 75 6e 6e 61 6d 65 20 77 65 65 6b  nd :runname week
41c0: 31 32 5f 32 30 31 31 5f 72 75 6e 31 20 2d 72 75  12_2011_run1 -ru
41d0: 6e 61 6c 6c 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76  nall.</div>.<div
41e0: 20 63 6c 61 73 73 3d 22 50 61 72 61 67 72 61 70   class="Paragrap
41f0: 68 2d 22 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74  h-">.<a class="t
4200: 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63 2d 50 61  oc" name="toc-Pa
4210: 72 61 67 72 61 70 68 2a 2d 32 22 3e 3c 2f 61 3e  ragraph*-2"></a>
4220: 57 6f 75 6c 64 20 73 65 74 3a 0a 3c 2f 64 69 76  Would set:.</div
4230: 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22 43 6f  >.<div class="Co
4240: 64 65 22 3e 0a 45 4e 43 52 59 50 54 49 4f 4e 20  de">.ENCRYPTION 
4250: 74 72 75 65 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76  true.</div>.<div
4260: 20 63 6c 61 73 73 3d 22 43 6f 64 65 22 3e 0a 54   class="Code">.T
4270: 45 53 54 50 41 54 48 20 2f 6e 66 73 2f 74 65 73  ESTPATH /nfs/tes
4280: 74 69 6e 67 2f 6d 65 67 61 63 6f 72 70 5f 72 75  ting/megacorp_ru
4290: 6e 73 0a 3c 2f 64 69 76 3e 0a 3c 68 33 20 63 6c  ns.</div>.<h3 cl
42a0: 61 73 73 3d 22 53 75 62 73 65 63 74 69 6f 6e 22  ass="Subsection"
42b0: 3e 0a 3c 61 20 63 6c 61 73 73 3d 22 74 6f 63 22  >.<a class="toc"
42c0: 20 6e 61 6d 65 3d 22 74 6f 63 2d 53 75 62 73 65   name="toc-Subse
42d0: 63 74 69 6f 6e 2d 30 2e 33 2e 33 22 3e 30 2e 33  ction-0.3.3">0.3
42e0: 2e 33 3c 2f 61 3e e2 80 83 57 72 69 74 69 6e 67  .3</a> Writing
42f0: 20 74 65 73 74 73 0a 3c 2f 68 33 3e 0a 3c 68 34   tests.</h3>.<h4
4300: 20 63 6c 61 73 73 3d 22 53 75 62 73 75 62 73 65   class="Subsubse
4310: 63 74 69 6f 6e 22 3e 0a 3c 61 20 63 6c 61 73 73  ction">.<a class
4320: 3d 22 74 6f 63 22 20 6e 61 6d 65 3d 22 74 6f 63  ="toc" name="toc
4330: 2d 53 75 62 73 75 62 73 65 63 74 69 6f 6e 2d 30  -Subsubsection-0
4340: 2e 33 2e 33 2e 31 22 3e 30 2e 33 2e 33 2e 31 3c  .3.3.1">0.3.3.1<
4350: 2f 61 3e e2 80 83 74 65 73 74 63 6f 6e 66 69 67  /a> testconfig
4360: 20 66 69 6c 65 0a 3c 2f 68 34 3e 0a 3c 64 69 76   file.</h4>.<div
4370: 20 63 6c 61 73 73 3d 22 55 6e 69 6e 64 65 6e 74   class="Unindent
4380: 65 64 22 3e 0a 0a 3c 74 61 62 6c 65 3e 0a 0a 3c  ed">..<table>..<
4390: 74 72 3e 0a 0a 3c 74 64 20 61 6c 69 67 6e 3d 22  tr>..<td align="
43a0: 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f  left" valign="to
43b0: 70 22 3e 0a 73 65 63 74 69 6f 6e 0a 3c 2f 74 64  p">.section.</td
43c0: 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66  >.<td align="lef
43d0: 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e  t" valign="top">
43e0: 0a 76 61 72 69 61 62 6c 65 0a 3c 2f 74 64 3e 0a  .variable.</td>.
43f0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22  <td align="left"
4400: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 76   valign="top">.v
4410: 61 6c 75 65 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61  alue.</td>.<td a
4420: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69  lign="left" vali
4430: 67 6e 3d 22 74 6f 70 22 3e 0a 72 65 71 75 69 72  gn="top">.requir
4440: 65 64 3f 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c  ed?.</td>.<td al
4450: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67  ign="left" valig
4460: 6e 3d 22 74 6f 70 22 3e 0a 63 6f 6d 6d 65 6e 74  n="top">.comment
4470: 73 0a 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74  s.</td>.</tr>.<t
4480: 72 3e 0a 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c  r>..<td align="l
4490: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70  eft" valign="top
44a0: 22 3e 0a 5b 73 65 74 75 70 5d 0a 3c 2f 74 64 3e  ">.[setup].</td>
44b0: 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74  .<td align="left
44c0: 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a  " valign="top">.
44d0: 72 75 6e 73 63 72 69 70 74 0a 3c 2f 74 64 3e 0a  runscript.</td>.
44e0: 3c 74 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22  <td align="left"
44f0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 6e   valign="top">.n
4500: 61 6d 65 20 6f 66 20 73 63 72 69 70 74 20 74 6f  ame of script to
4510: 20 65 78 65 63 75 74 65 20 66 6f 72 20 74 68 69   execute for thi
4520: 73 20 74 65 73 74 0a 3c 2f 74 64 3e 0a 3c 74 64  s test.</td>.<td
4530: 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61   align="left" va
4540: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 79 65 73 0a  lign="top">.yes.
4550: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d  </td>.<td align=
4560: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74  "left" valign="t
4570: 6f 70 22 3e 0a 54 68 65 20 73 63 72 69 70 74 20  op">.The script 
4580: 6d 75 73 74 20 62 65 20 65 78 65 63 75 74 61 62  must be executab
4590: 6c 65 20 61 6e 64 20 65 69 74 68 65 72 20 70 72  le and either pr
45a0: 6f 76 69 64 65 20 74 68 65 20 66 75 6c 6c 20 70  ovide the full p
45b0: 61 74 68 20 6f 72 20 70 75 74 20 61 20 63 6f 70  ath or put a cop
45c0: 79 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20  y at the top of 
45d0: 79 6f 75 72 20 74 65 73 74 20 64 69 72 65 63 74  your test direct
45e0: 6f 72 79 0a 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a  ory.</td>.</tr>.
45f0: 3c 74 72 3e 0a 0a 3c 74 64 20 61 6c 69 67 6e 3d  <tr>..<td align=
4600: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74  "left" valign="t
4610: 6f 70 22 3e 0a 5b 72 65 71 75 69 72 65 6d 65 6e  op">.[requiremen
4620: 74 73 5d 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c  ts].</td>.<td al
4630: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67  ign="left" valig
4640: 6e 3d 22 74 6f 70 22 3e 0a 77 61 69 74 6f 6e 0a  n="top">.waiton.
4650: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d  </td>.<td align=
4660: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74  "left" valign="t
4670: 6f 70 22 3e 0a 6c 69 73 74 20 6f 66 20 76 61 6c  op">.list of val
4680: 69 64 20 74 65 73 74 20 6e 61 6d 65 73 0a 3c 2f  id test names.</
4690: 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d 22 6c  td>.<td align="l
46a0: 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74 6f 70  eft" valign="top
46b0: 22 3e 0a 6e 6f 0a 3c 2f 74 64 3e 0a 3c 74 64 20  ">.no.</td>.<td 
46c0: 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c  align="left" val
46d0: 69 67 6e 3d 22 74 6f 70 22 3e 0a 54 68 69 73 20  ign="top">.This 
46e0: 74 65 73 74 20 77 69 6c 6c 20 6e 6f 74 20 72 75  test will not ru
46f0: 6e 20 75 6e 74 69 6c 20 74 68 65 20 6e 61 6d 65  n until the name
4700: 64 20 74 65 73 74 73 20 61 72 65 20 73 74 61 74  d tests are stat
4710: 65 20 63 6f 6d 70 6c 65 74 65 64 20 61 6e 64 20  e completed and 
4720: 73 74 61 74 75 73 20 50 41 53 53 0a 3c 2f 74 64  status PASS.</td
4730: 3e 0a 3c 2f 74 72 3e 0a 3c 74 72 3e 0a 0a 3c 74  >.</tr>.<tr>..<t
4740: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76  d align="left" v
4750: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 5b 69 74  align="top">.[it
4760: 65 6d 73 5d 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61  ems].</td>.<td a
4770: 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69  lign="left" vali
4780: 67 6e 3d 22 74 6f 70 22 3e 0a 61 6e 79 20 76 61  gn="top">.any va
4790: 6c 69 64 0a 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c  lid.</td>.<td al
47a0: 69 67 6e 3d 22 6c 65 66 74 22 20 76 61 6c 69 67  ign="left" valig
47b0: 6e 3d 22 74 6f 70 22 3e 0a 6c 69 73 74 20 6f 66  n="top">.list of
47c0: 20 76 61 6c 75 65 73 0a 3c 2f 74 64 3e 0a 3c 74   values.</td>.<t
47d0: 64 20 61 6c 69 67 6e 3d 22 6c 65 66 74 22 20 76  d align="left" v
47e0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 6e 6f 0a  align="top">.no.
47f0: 3c 2f 74 64 3e 0a 3c 74 64 20 61 6c 69 67 6e 3d  </td>.<td align=
4800: 22 6c 65 66 74 22 20 76 61 6c 69 67 6e 3d 22 74  "left" valign="t
4810: 6f 70 22 3e 0a 54 68 65 20 74 65 73 74 20 77 69  op">.The test wi
4820: 6c 6c 20 62 65 20 72 65 70 65 61 74 65 64 20 6f  ll be repeated o
4830: 6e 63 65 20 66 6f 72 20 65 61 63 68 20 69 74 65  nce for each ite
4840: 6d 20 77 69 74 68 20 74 68 65 20 76 61 72 69 61  m with the varia
4850: 62 6c 65 20 6e 61 6d 65 20 73 65 74 20 74 6f 20  ble name set to 
4860: 74 68 65 20 76 61 6c 75 65 2e 20 49 66 20 74 68  the value. If th
4870: 65 72 65 20 69 73 20 6d 6f 72 65 20 74 68 61 6e  ere is more than
4880: 20 6f 6e 65 20 76 61 72 69 61 62 6c 65 20 74 68   one variable th
4890: 65 6e 20 74 68 65 20 74 65 73 74 20 77 69 6c 6c  en the test will
48a0: 20 62 65 20 72 75 6e 20 61 67 61 69 6e 73 74 20   be run against 
48b0: 61 6c 6c 20 75 6e 69 71 75 65 20 63 6f 6d 62 69  all unique combi
48c0: 6e 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 76  nations of the v
48d0: 61 6c 75 65 73 0a 3c 2f 74 64 3e 0a 3c 2f 74 72  alues.</td>.</tr
48e0: 3e 0a 3c 2f 74 61 62 6c 65 3e 0a 3c 2f 64 69 76  >.</table>.</div
48f0: 3e 0a 0a 3c 68 72 2f 3e 0a 3c 70 3e 43 6f 70 79  >..<hr/>.<p>Copy
4900: 72 69 67 68 74 20 28 43 29 20 32 30 31 31 20 4d  right (C) 2011 M
4910: 61 74 74 20 57 65 6c 6c 61 6e 64 3c 2f 70 3e 0a  att Welland</p>.
4920: 3c 2f 64 69 76 3e 0a 3c 2f 62 6f 64 79 3e 0a 3c  </div>.</body>.<
4930: 2f 68 74 6d 6c 3e 0a                             /html>.