Artifact
45163346aeed53c0941cc3eed9a9aa4f21f9cd9a:
0000: 0a 52 65 66 65 72 65 6e 63 65 0a 2d 2d 2d 2d 2d .Reference.-----
0010: 2d 2d 2d 2d 0a 0a 43 6f 6e 66 69 67 20 46 69 6c ----..Config Fil
0020: 65 20 48 65 6c 70 65 72 73 0a 7e 7e 7e 7e 7e 7e e Helpers.~~~~~~
0030: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 56 ~~~~~~~~~~~~~..V
0040: 61 72 69 6f 75 73 20 68 65 6c 70 65 72 73 20 66 arious helpers f
0050: 6f 72 20 6d 6f 72 65 20 61 64 76 61 6e 63 65 64 or more advanced
0060: 20 63 6f 6e 66 69 67 20 66 69 6c 65 73 2e 0a 0a config files...
0070: 2e 48 65 6c 70 65 72 73 0a 5b 77 69 64 74 68 3d .Helpers.[width=
0080: 22 38 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d "80%",cols="^,2m
0090: 2c 32 6d 2c 32 6d 22 2c 66 72 61 6d 65 3d 22 74 ,2m,2m",frame="t
00a0: 6f 70 62 6f 74 22 2c 6f 70 74 69 6f 6e 73 3d 22 opbot",options="
00b0: 68 65 61 64 65 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d header"].|======
00c0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
00d0: 0a 7c 48 65 6c 70 65 72 20 20 20 20 20 20 20 20 .|Helper
00e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
00f0: 50 75 72 70 6f 73 65 20 20 20 20 20 20 20 20 20 Purpose
0100: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
0110: 56 61 6c 69 64 20 76 61 6c 75 65 73 20 20 20 20 Valid values
0120: 20 20 20 20 20 20 20 20 7c 20 43 6f 6d 6d 65 6e | Commen
0130: 74 73 0a 7c 20 23 7b 73 63 68 65 6d 65 20 28 73 ts.| #{scheme (s
0140: 63 68 65 6d 65 20 63 6f 64 65 2e 2e 2e 29 7d 20 cheme code...)}
0150: 7c 20 45 78 65 63 75 74 65 20 61 72 62 69 74 72 | Execute arbitr
0160: 61 72 79 20 73 63 68 65 6d 65 20 63 6f 64 65 20 ary scheme code
0170: 7c 20 41 6e 79 20 76 61 6c 69 64 20 73 63 68 65 | Any valid sche
0180: 6d 65 20 20 20 20 20 20 20 20 7c 20 56 61 6c 75 me | Valu
0190: 65 20 72 65 74 75 72 6e 65 64 20 66 72 6f 6d 20 e returned from
01a0: 74 68 65 20 63 61 6c 6c 20 69 73 20 63 6f 6e 76 the call is conv
01b0: 65 72 74 65 64 20 74 6f 20 61 20 73 74 72 69 6e erted to a strin
01c0: 67 20 61 6e 64 20 70 72 6f 63 65 73 73 65 64 20 g and processed
01d0: 61 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 as part of the c
01e0: 6f 6e 66 69 67 20 66 69 6c 65 0a 7c 20 23 7b 73 onfig file.| #{s
01f0: 79 73 74 65 6d 20 63 6f 6d 6d 61 6e 64 7d 20 20 ystem command}
0200: 20 20 20 20 20 20 20 20 7c 20 45 78 65 63 75 74 | Execut
0210: 65 20 70 72 6f 67 72 61 6d 2c 20 69 6e 73 65 72 e program, inser
0220: 74 73 20 65 78 69 74 20 63 6f 64 65 20 20 7c 20 ts exit code |
0230: 41 6e 79 20 76 61 6c 69 64 20 55 6e 69 78 20 63 Any valid Unix c
0240: 6f 6d 6d 61 6e 64 20 20 7c 20 44 69 73 63 61 72 ommand | Discar
0250: 64 73 20 74 68 65 20 6f 75 74 70 75 74 20 66 72 ds the output fr
0260: 6f 6d 20 74 68 65 20 70 72 6f 67 72 61 6d 0a 7c om the program.|
0270: 20 23 7b 73 68 65 6c 6c 20 20 63 6f 6d 6d 61 6e #{shell comman
0280: 64 7d 20 6f 72 20 23 7b 73 68 20 2e 2e 2e 7d 20 d} or #{sh ...}
0290: 20 7c 20 45 78 65 63 75 74 65 20 70 72 6f 67 72 | Execute progr
02a0: 61 6d 2c 20 69 6e 73 65 72 74 73 20 72 65 73 75 am, inserts resu
02b0: 6c 74 20 66 72 6f 6d 20 73 74 64 6f 75 74 20 7c lt from stdout |
02c0: 20 41 6e 79 20 76 61 6c 69 64 20 55 6e 69 78 20 Any valid Unix
02d0: 63 6f 6d 6d 61 6e 64 20 7c 20 56 61 6c 75 65 20 command | Value
02e0: 72 65 74 75 72 6e 65 64 20 66 72 6f 6d 20 74 68 returned from th
02f0: 65 20 63 61 6c 6c 20 69 73 20 63 6f 6e 76 65 72 e call is conver
0300: 74 65 64 20 74 6f 20 61 20 73 74 72 69 6e 67 20 ted to a string
0310: 61 6e 64 20 70 72 6f 63 65 73 73 65 64 20 61 73 and processed as
0320: 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f 6e part of the con
0330: 66 69 67 20 66 69 6c 65 0a 7c 20 23 7b 72 65 61 fig file.| #{rea
0340: 6c 70 61 74 68 20 70 61 74 68 7d 20 6f 72 20 23 lpath path} or #
0350: 7b 72 70 20 2e 2e 2e 7d 20 20 20 7c 20 52 65 70 {rp ...} | Rep
0360: 6c 61 63 65 20 77 69 74 68 20 6e 6f 72 6d 61 6c lace with normal
0370: 69 7a 65 64 20 70 61 74 68 20 7c 20 4d 75 73 74 ized path | Must
0380: 20 62 65 20 61 20 76 61 6c 69 64 20 70 61 74 68 be a valid path
0390: 20 7c 0a 7c 20 23 7b 67 65 74 65 6e 76 20 56 41 |.| #{getenv VA
03a0: 52 7d 20 6f 72 20 23 7b 67 76 20 56 41 52 7d 20 R} or #{gv VAR}
03b0: 20 20 20 20 20 7c 20 52 65 70 6c 61 63 65 20 77 | Replace w
03c0: 69 74 68 20 63 6f 6e 74 65 6e 74 20 6f 66 20 65 ith content of e
03d0: 6e 76 20 76 61 72 69 61 62 6c 65 20 7c 20 4d 75 nv variable | Mu
03e0: 73 74 20 62 65 20 61 20 76 61 6c 69 64 20 76 61 st be a valid va
03f0: 72 20 7c 0a 7c 20 23 7b 67 65 74 20 73 20 76 7d r |.| #{get s v}
0400: 20 6f 72 20 23 7b 67 20 73 20 76 7d 20 20 20 20 or #{g s v}
0410: 20 7c 20 52 65 70 6c 61 63 65 20 77 69 74 68 20 | Replace with
0420: 76 61 72 69 61 62 6c 65 20 76 20 66 72 6f 6d 20 variable v from
0430: 73 65 63 74 69 6f 6e 20 73 20 7c 20 56 61 72 69 section s | Vari
0440: 61 62 6c 65 20 6d 75 73 74 20 62 65 20 64 65 66 able must be def
0450: 69 6e 65 64 20 62 65 66 6f 72 65 20 75 73 65 20 ined before use
0460: 7c 0a 7c 20 23 7b 72 67 65 74 20 76 7d 20 20 20 |.| #{rget v}
0470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
0480: 20 52 65 70 6c 61 63 65 20 77 69 74 68 20 76 61 Replace with va
0490: 72 69 61 62 6c 65 20 76 20 66 72 6f 6d 20 74 61 riable v from ta
04a0: 72 67 65 74 20 6f 72 20 64 65 66 61 75 6c 74 20 rget or default
04b0: 6f 66 20 72 75 6e 63 6f 6e 66 69 67 73 20 66 69 of runconfigs fi
04c0: 6c 65 20 7c 20 7c 0a 7c 20 23 7b 6d 74 72 61 68 le | |.| #{mtrah
04d0: 7d 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 }
04e0: 20 20 20 20 7c 20 52 65 70 6c 61 63 65 20 77 69 | Replace wi
04f0: 74 68 20 74 68 65 20 70 61 74 68 20 74 6f 20 74 th the path to t
0500: 68 65 20 6d 65 67 61 74 65 73 74 20 74 65 73 74 he megatest test
0510: 73 75 69 74 65 20 61 72 65 61 20 7c 20 7c 20 0a suite area | | .
0520: 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |===============
0530: 3d 3d 3d 3d 3d 3d 3d 0a 0a 43 6f 6e 66 69 67 20 =======..Config
0540: 46 69 6c 65 20 53 65 74 74 69 6e 67 73 0a 7e 7e File Settings.~~
0550: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0560: 7e 7e 0a 0a 53 65 74 74 69 6e 67 73 20 69 6e 20 ~~..Settings in
0570: 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 0a megatest.config.
0580: 0a 43 6f 6e 66 69 67 20 46 69 6c 65 20 41 64 64 .Config File Add
0590: 69 74 69 6f 6e 61 6c 20 46 65 61 74 75 72 65 73 itional Features
05a0: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e .~~~~~~~~~~~~~~~
05b0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
05c0: 0a 0a 49 6e 63 6c 75 64 69 6e 67 20 6f 75 74 70 ..Including outp
05d0: 75 74 20 66 72 6f 6d 20 61 20 73 63 72 69 70 74 ut from a script
05e0: 20 61 73 20 69 66 20 69 74 20 77 61 73 20 69 6e as if it was in
05f0: 6c 69 6e 65 20 74 6f 20 74 68 65 20 63 6f 6e 66 line to the conf
0600: 69 67 20 66 69 6c 65 3a 0a 0a 2d 2d 2d 2d 2d 2d ig file:..------
0610: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0620: 2d 2d 2d 0a 5b 73 63 72 69 70 74 69 6e 63 20 6d ---.[scriptinc m
0630: 79 73 63 72 69 70 74 2e 73 68 5d 0a 2d 2d 2d 2d yscript.sh].----
0640: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0650: 2d 2d 2d 2d 2d 0a 0a 49 66 20 74 68 65 20 73 63 -----..If the sc
0660: 72 69 70 74 20 6f 75 74 70 75 74 73 3a 0a 0a 2d ript outputs:..-
0670: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0680: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 69 74 65 6d 73 5d --------.[items]
0690: 0a 41 20 61 20 62 20 63 0a 42 20 64 20 65 20 66 .A a b c.B d e f
06a0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
06b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 6e ----------..Then
06c0: 20 74 68 65 20 63 6f 6e 66 69 67 20 66 69 6c 65 the config file
06d0: 20 77 6f 75 6c 64 20 65 66 66 65 63 74 69 76 65 would effective
06e0: 6c 79 20 61 70 70 65 61 72 20 74 6f 20 63 6f 6e ly appear to con
06f0: 74 61 69 6e 20 61 6e 20 69 74 65 6d 73 20 73 65 tain an items se
0700: 63 74 69 6f 6e 0a 65 78 61 63 74 6c 79 20 6c 69 ction.exactly li
0710: 6b 65 20 74 68 65 20 6f 75 74 70 75 74 20 66 72 ke the output fr
0720: 6f 6d 20 74 68 65 20 73 63 72 69 70 74 2e 20 54 om the script. T
0730: 68 69 73 20 69 73 20 75 73 65 66 75 6c 20 77 68 his is useful wh
0740: 65 6e 20 64 79 6e 61 6d 69 63 61 6c 6c 79 0a 63 en dynamically.c
0750: 72 65 61 74 69 6e 67 20 69 74 65 6d 73 2c 20 69 reating items, i
0760: 74 65 6d 73 74 61 62 6c 65 73 20 61 6e 64 20 6f temstables and o
0770: 74 68 65 72 20 63 6f 6e 66 69 67 20 73 74 72 75 ther config stru
0780: 63 74 75 72 65 73 2e 20 59 6f 75 20 63 61 6e 20 ctures. You can
0790: 73 65 65 20 74 68 65 0a 65 78 70 61 6e 73 69 6f see the.expansio
07a0: 6e 20 6f 66 20 74 68 65 20 63 61 6c 6c 20 62 79 n of the call by
07b0: 20 6c 6f 6f 6b 69 6e 67 20 69 6e 20 74 68 65 20 looking in the
07c0: 63 61 63 68 65 64 20 66 69 6c 65 73 20 28 6c 6f cached files (lo
07d0: 6f 6b 20 69 6e 20 79 6f 75 72 20 6c 69 6e 6b 74 ok in your linkt
07e0: 72 65 65 0a 66 6f 72 20 6d 65 67 61 74 65 73 74 ree.for megatest
07f0: 2e 63 6f 6e 66 69 67 20 61 6e 64 20 72 75 6e 63 .config and runc
0800: 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 20 63 61 onfigs.config ca
0810: 63 68 65 20 66 69 6c 65 73 20 61 6e 64 20 69 6e che files and in
0820: 20 79 6f 75 72 20 74 65 73 74 20 72 75 6e 0a 61 your test run.a
0830: 72 65 61 73 20 66 6f 72 20 74 68 65 20 65 78 70 reas for the exp
0840: 61 6e 64 65 64 20 61 6e 64 20 63 61 63 68 65 64 anded and cached
0850: 20 74 65 73 74 63 6f 6e 66 69 67 29 2e 0a 0a 57 testconfig)...W
0860: 69 6c 64 63 61 72 64 73 20 61 6e 64 20 72 65 67 ildcards and reg
0870: 65 78 65 73 20 69 6e 20 54 61 72 67 65 74 73 0a exes in Targets.
0880: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0890: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 61 2f 32 2f ----------.[a/2/
08a0: 62 5d 0a 56 41 52 31 20 56 41 4c 31 0a 0a 5b 61 b].VAR1 VAL1..[a
08b0: 2f 25 2f 62 5d 0a 56 41 52 31 20 56 41 4c 32 0a /%/b].VAR1 VAL2.
08c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
08d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 57 69 6c 6c 20 ---------..Will
08e0: 72 65 73 75 6c 74 20 69 6e 3a 0a 0a 2d 2d 2d 2d result in:..----
08f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0900: 2d 2d 2d 2d 2d 0a 5b 61 2f 32 2f 62 5d 0a 56 41 -----.[a/2/b].VA
0910: 52 31 20 56 41 4c 32 0a 2d 2d 2d 2d 2d 2d 2d 2d R1 VAL2.--------
0920: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0930: 2d 0a 0a 43 61 6e 20 75 73 65 20 65 69 74 68 65 -..Can use eithe
0940: 72 20 77 69 6c 64 63 61 72 64 20 6f 66 20 22 25 r wildcard of "%
0950: 22 20 6f 72 20 61 20 72 65 67 75 6c 61 72 20 65 " or a regular e
0960: 78 70 72 65 73 73 69 6f 6e 3a 0a 0a 5b 2f 61 62 xpression:..[/ab
0970: 63 2e 2a 64 65 66 2f 5d 0a 0a 44 69 73 6b 20 53 c.*def/]..Disk S
0980: 70 61 63 65 20 43 68 65 63 6b 73 0a 5e 5e 5e 5e pace Checks.^^^^
0990: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 53 ^^^^^^^^^^^^^..S
09a0: 6f 6d 65 20 70 61 72 61 6d 65 74 65 72 73 20 79 ome parameters y
09b0: 6f 75 20 63 61 6e 20 70 75 74 20 69 6e 20 74 68 ou can put in th
09c0: 65 20 5b 73 65 74 75 70 5d 20 73 65 63 74 69 6f e [setup] sectio
09d0: 6e 20 6f 66 20 6d 65 67 61 74 65 73 74 2e 63 6f n of megatest.co
09e0: 6e 66 69 67 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d nfig:..---------
09f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 6d 69 6e ----------.# min
0a00: 69 6d 75 6d 20 73 70 61 63 65 20 72 65 71 75 69 imum space requi
0a10: 72 65 64 20 69 6e 20 61 20 72 75 6e 20 64 69 73 red in a run dis
0a20: 6b 20 0a 6d 69 6e 73 70 61 63 65 20 31 30 30 30 k .minspace 1000
0a30: 30 30 30 30 0a 0a 23 20 6d 69 6e 69 6d 75 6d 20 0000..# minimum
0a40: 73 70 61 63 65 20 72 65 71 75 69 72 65 64 20 69 space required i
0a50: 6e 20 64 62 64 69 72 3a 0a 64 62 64 69 72 2d 73 n dbdir:.dbdir-s
0a60: 70 61 63 65 2d 72 65 71 75 69 72 65 64 20 31 30 pace-required 10
0a70: 30 30 30 30 0a 0a 23 20 73 63 72 69 70 74 20 74 0000..# script t
0a80: 68 61 74 20 74 61 6b 65 73 20 70 61 74 68 20 61 hat takes path a
0a90: 73 20 70 61 72 61 6d 65 74 65 72 20 61 6e 64 20 s parameter and
0aa0: 72 65 74 75 72 6e 73 20 6e 75 6d 62 65 72 20 6f returns number o
0ab0: 66 20 62 79 74 65 73 20 61 76 61 69 6c 61 62 6c f bytes availabl
0ac0: 65 3a 0a 66 72 65 65 2d 73 70 61 63 65 2d 73 63 e:.free-space-sc
0ad0: 72 69 70 74 20 63 68 65 63 6b 2d 73 70 61 63 65 ript check-space
0ae0: 2e 73 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .sh.------------
0af0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 72 69 6d 20 74 72 -------..Trim tr
0b00: 61 69 6c 69 6e 67 20 73 70 61 63 65 73 0a 5e 5e ailing spaces.^^
0b10: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
0b20: 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^..------------
0b30: 2d 2d 2d 2d 2d 2d 0a 5b 63 6f 6e 66 69 67 66 3a ------.[configf:
0b40: 73 65 74 74 69 6e 67 73 20 74 72 69 6d 2d 74 72 settings trim-tr
0b50: 61 69 6c 69 6e 67 2d 73 70 61 63 65 73 20 79 65 ailing-spaces ye
0b60: 73 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d s].-------------
0b70: 2d 2d 2d 2d 2d 0a 0a 4a 6f 62 20 53 75 62 6d 69 -----..Job Submi
0b80: 73 73 69 6f 6e 20 43 6f 6e 74 72 6f 6c 0a 5e 5e ssion Control.^^
0b90: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
0ba0: 5e 5e 5e 5e 0a 0a 53 75 62 6d 69 74 20 6a 6f 62 ^^^^..Submit job
0bb0: 73 20 74 6f 20 48 6f 73 74 20 54 79 70 65 73 20 s to Host Types
0bc0: 62 61 73 65 64 20 6f 6e 20 54 65 73 74 20 4e 61 based on Test Na
0bd0: 6d 65 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b me.+++++++++++++
0be0: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ++++++++++++++++
0bf0: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a +++++++++++++++.
0c00: 0a 2e 49 6e 20 6d 65 67 61 74 65 73 74 2e 63 6f ..In megatest.co
0c10: 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d nfig.-----------
0c20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 68 -------------.[h
0c30: 6f 73 74 2d 74 79 70 65 73 5d 0a 67 65 6e 65 72 ost-types].gener
0c40: 61 6c 20 20 20 6e 62 66 61 6b 65 0a 72 65 6d 6f al nbfake.remo
0c50: 74 65 20 20 20 20 62 73 75 62 0a 0a 5b 6c 61 75 te bsub..[lau
0c60: 6e 63 68 65 72 73 5d 0a 72 75 6e 66 69 72 73 74 nchers].runfirst
0c70: 2f 73 75 6d 25 20 72 65 6d 6f 74 65 0a 25 20 67 /sum% remote.% g
0c80: 65 6e 65 72 61 6c 0a 0a 5b 6a 6f 62 74 6f 6f 6c eneral..[jobtool
0c90: 73 5d 0a 6c 61 75 6e 63 68 65 72 20 62 73 75 62 s].launcher bsub
0ca0: 0a 23 20 69 66 20 64 65 66 69 6e 65 64 20 61 6e .# if defined an
0cb0: 64 20 6e 6f 74 20 22 6e 6f 22 20 66 6c 65 78 69 d not "no" flexi
0cc0: 2d 6c 61 75 6e 63 68 65 72 20 77 69 6c 6c 20 62 -launcher will b
0cd0: 79 70 61 73 73 20 6c 61 75 6e 63 68 65 72 20 75 ypass launcher u
0ce0: 6e 6c 65 73 73 20 0a 23 20 74 68 65 72 65 20 69 nless .# there i
0cf0: 73 20 6e 6f 20 68 6f 73 74 2d 74 79 70 65 20 6d s no host-type m
0d00: 61 74 63 68 2e 0a 66 6c 65 78 69 2d 6c 61 75 6e atch..flexi-laun
0d10: 63 68 65 72 20 79 65 73 0a 2d 2d 2d 2d 2d 2d 2d cher yes.-------
0d20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0d30: 2d 0a 0a 68 6f 73 74 2d 74 79 70 65 73 0a 2b 2b -..host-types.++
0d40: 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 4c 69 73 74 20 6f ++++++++..List o
0d50: 66 20 68 6f 73 74 20 74 79 70 65 73 20 61 6e 64 f host types and
0d60: 20 74 68 65 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65 the commandline
0d70: 20 74 6f 20 72 75 6e 20 61 20 6a 6f 62 20 6f 6e to run a job on
0d80: 20 74 68 61 74 20 68 6f 73 74 20 74 79 70 65 2e that host type.
0d90: 0a 0a 2e 68 6f 73 74 2d 74 79 70 65 20 3d 3e 20 ...host-type =>
0da0: 6c 61 75 6e 63 68 20 63 6f 6d 6d 61 6e 64 0a 2d launch command.-
0db0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 67 65 6e 65 -----------.gene
0dc0: 72 61 6c 20 6e 62 66 61 6b 65 0a 2d 2d 2d 2d 2d ral nbfake.-----
0dd0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 6c 61 75 6e 63 68 65 -------..launche
0de0: 72 73 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 2e 74 rs.+++++++++...t
0df0: 65 73 74 2f 69 74 65 6d 70 61 74 68 20 3d 3e 20 est/itempath =>
0e00: 68 6f 73 74 2d 74 79 70 65 0a 2d 2d 2d 2d 2d 2d host-type.------
0e10: 2d 2d 2d 2d 2d 2d 0a 72 75 6e 66 69 72 73 74 2f ------.runfirst/
0e20: 73 75 6d 25 20 72 65 6d 6f 74 65 0a 2d 2d 2d 2d sum% remote.----
0e30: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4d 69 73 63 65 6c --------..Miscel
0e40: 6c 61 6e 65 6f 75 73 20 53 65 74 75 70 20 49 74 laneous Setup It
0e50: 65 6d 73 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ems.++++++++++++
0e60: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 41 +++++++++++++..A
0e70: 74 74 65 6d 70 74 20 74 6f 20 72 65 72 75 6e 20 ttempt to rerun
0e80: 74 65 73 74 73 20 69 6e 20 22 53 54 55 43 4b 2f tests in "STUCK/
0e90: 44 45 41 44 22 2c 20 22 6e 2f 61 22 2c 20 22 5a DEAD", "n/a", "Z
0ea0: 45 52 4f 5f 49 54 45 4d 53 22 20 73 74 61 74 65 ERO_ITEMS" state
0eb0: 73 2e 0a 0a 2e 49 6e 20 6d 65 67 61 74 65 73 74 s....In megatest
0ec0: 2e 63 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d .config.--------
0ed0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 ----------.[setu
0ee0: 70 5d 0a 72 65 72 75 6e 73 20 35 0a 2d 2d 2d 2d p].reruns 5.----
0ef0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
0f00: 52 75 6e 20 74 69 6d 65 20 6c 69 6d 69 74 0a 2b Run time limit.+
0f10: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 2d +++++++++++++..-
0f20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0f30: 0a 5b 73 65 74 75 70 5d 0a 23 20 74 68 69 73 20 .[setup].# this
0f40: 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c will automatical
0f50: 6c 79 20 6b 69 6c 6c 20 74 68 65 20 74 65 73 74 ly kill the test
0f60: 20 69 66 20 69 74 20 72 75 6e 73 20 66 6f 72 20 if it runs for
0f70: 6d 6f 72 65 20 74 68 61 6e 20 31 68 20 32 6d 20 more than 1h 2m
0f80: 61 6e 64 20 33 73 0a 72 75 6e 74 69 6d 65 6c 69 and 3s.runtimeli
0f90: 6d 20 31 68 20 32 6d 20 33 73 0a 2d 2d 2d 2d 2d m 1h 2m 3s.-----
0fa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 65 ------------..Te
0fb0: 73 74 73 20 62 72 6f 77 73 65 72 20 76 69 65 77 sts browser view
0fc0: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e .~~~~~~~~~~~~~~~
0fd0: 7e 7e 7e 0a 0a 54 68 65 20 74 65 73 74 73 20 62 ~~~..The tests b
0fe0: 72 6f 77 73 65 72 20 28 73 65 65 20 74 68 65 20 rowser (see the
0ff0: 52 75 6e 20 43 6f 6e 74 72 6f 6c 20 74 61 62 20 Run Control tab
1000: 6f 6e 20 74 68 65 20 64 61 73 68 62 6f 61 72 64 on the dashboard
1010: 29 20 68 61 73 20 74 77 6f 20 76 69 65 77 73 20 ) has two views
1020: 66 6f 72 20 64 69 73 70 6c 61 79 69 6e 67 20 74 for displaying t
1030: 68 65 20 74 65 73 74 73 2e 20 0a 0a 2e 20 44 6f he tests. ... Do
1040: 74 20 28 67 72 61 70 68 76 69 7a 29 20 62 61 73 t (graphviz) bas
1050: 65 64 20 74 72 65 65 0a 2e 20 4e 6f 20 64 6f 74 ed tree.. No dot
1060: 2c 20 70 6c 61 69 6e 20 6c 69 73 74 69 6e 67 0a , plain listing.
1070: 0a 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 .The default is
1080: 74 68 65 20 67 72 61 70 68 76 69 7a 20 62 61 73 the graphviz bas
1090: 65 64 20 74 72 65 65 20 62 75 74 20 69 66 20 79 ed tree but if y
10a0: 6f 75 72 20 74 65 73 74 73 20 64 6f 6e 27 74 20 our tests don't
10b0: 76 69 65 77 0a 77 65 6c 6c 20 69 6e 20 74 68 61 view.well in tha
10c0: 74 20 6d 6f 64 65 20 74 68 65 6e 20 75 73 65 20 t mode then use
10d0: 22 6e 6f 64 6f 74 22 20 74 6f 20 74 75 72 6e 20 "nodot" to turn
10e0: 69 74 20 6f 66 66 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d it off...-------
10f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 ----------.[setu
1100: 70 5d 0a 6e 6f 64 6f 74 0a 2d 2d 2d 2d 2d 2d 2d p].nodot.-------
1110: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 61 73 68 ----------..Dash
1120: 62 6f 61 72 64 20 73 65 74 74 69 6e 67 73 0a 7e board settings.~
1130: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
1140: 7e 0a 0a 2e 52 75 6e 73 20 74 61 62 20 62 75 74 ~...Runs tab but
1150: 74 6f 6e 73 2c 20 66 6f 6e 74 20 61 6e 64 20 73 tons, font and s
1160: 69 7a 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ize.------------
1170: 2d 2d 2d 2d 2d 2d 0a 5b 64 61 73 68 62 6f 61 72 ------.[dashboar
1180: 64 5d 0a 62 74 6e 2d 68 65 69 67 68 74 20 78 31 d].btn-height x1
1190: 34 0a 62 74 6e 2d 66 6f 6e 74 73 7a 20 31 30 0a 4.btn-fontsz 10.
11a0: 63 65 6c 6c 2d 77 69 64 74 68 20 36 30 0a 2d 2d cell-width 60.--
11b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
11c0: 0a 0a 44 61 74 61 62 61 73 65 20 73 65 74 74 69 ..Database setti
11d0: 6e 67 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ngs.~~~~~~~~~~~~
11e0: 7e 7e 7e 7e 7e 0a 0a 2e 44 61 74 61 62 61 73 65 ~~~~~...Database
11f0: 20 63 6f 6e 66 69 67 20 73 65 74 74 69 6e 67 73 config settings
1200: 20 69 6e 20 5b 73 65 74 75 70 5d 20 73 65 63 74 in [setup] sect
1210: 69 6f 6e 20 6f 66 20 6d 65 67 61 74 65 73 74 2e ion of megatest.
1220: 63 6f 6e 66 69 67 0a 5b 77 69 64 74 68 3d 22 37 config.[width="7
1230: 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d 2c 32 0%",cols="^,2m,2
1240: 6d 2c 32 6d 22 2c 66 72 61 6d 65 3d 22 74 6f 70 m,2m",frame="top
1250: 62 6f 74 22 2c 6f 70 74 69 6f 6e 73 3d 22 68 65 bot",options="he
1260: 61 64 65 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d ader"].|========
1270: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c ==============.|
1280: 56 61 72 20 20 20 20 20 20 20 20 20 20 20 20 20 Var
1290: 20 20 20 20 20 20 20 20 20 20 7c 20 50 75 72 70 | Purp
12a0: 6f 73 65 20 20 20 20 20 20 20 20 20 20 20 20 7c ose |
12b0: 20 56 61 6c 69 64 20 76 61 6c 75 65 73 20 20 20 Valid values
12c0: 20 20 20 20 20 20 20 20 20 7c 20 43 6f 6d 6d 65 | Comme
12d0: 6e 74 73 0a 7c 64 65 6c 61 79 2d 6f 6e 2d 62 75 nts.|delay-on-bu
12e0: 73 79 20 20 20 20 20 20 20 20 20 20 20 20 20 7c sy |
12f0: 20 50 72 65 76 65 6e 74 20 63 6f 6e 63 75 72 72 Prevent concurr
1300: 65 6e 74 20 61 63 63 65 73 73 20 69 73 73 75 65 ent access issue
1310: 73 20 7c 20 79 65 73 5c 7c 6e 6f 20 6f 72 20 6e s | yes\|no or n
1320: 6f 74 20 64 65 66 69 6e 65 64 20 7c 20 44 65 66 ot defined | Def
1330: 61 75 6c 74 3d 6e 6f 2c 20 6d 61 79 20 68 65 6c ault=no, may hel
1340: 70 20 6f 6e 20 73 6f 6d 65 20 6e 65 74 77 6f 72 p on some networ
1350: 6b 20 66 69 6c 65 20 73 79 73 74 65 6d 73 2c 20 k file systems,
1360: 6d 61 79 20 73 6c 6f 77 20 74 68 69 6e 67 73 20 may slow things
1370: 64 6f 77 6e 20 61 6c 73 6f 2e 0a 7c 64 61 65 6d down also..|daem
1380: 6f 6e 69 7a 65 20 20 20 20 20 20 20 20 20 20 20 onize
1390: 20 20 20 20 20 20 7c 20 44 61 65 6d 6f 6e 69 7a | Daemoniz
13a0: 65 20 74 68 65 20 73 65 72 76 65 72 20 6f 6e 20 e the server on
13b0: 73 74 61 72 74 20 7c 20 79 65 73 5c 7c 6e 6f 20 start | yes\|no
13c0: 6f 72 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 7c or not defined |
13d0: 20 44 65 66 61 75 6c 74 3d 6e 6f 0a 7c 66 61 73 Default=no.|fas
13e0: 74 73 74 61 72 74 09 09 20 20 20 7c 20 41 6c 6c tstart.. | All
13f0: 20 64 69 72 65 63 74 20 66 69 6c 65 20 61 63 63 direct file acc
1400: 65 73 73 20 74 6f 20 73 71 6c 69 74 65 20 64 62 ess to sqlite db
1410: 20 66 69 6c 65 73 20 7c 20 79 65 73 5c 7c 6e 6f files | yes\|no
1420: 20 6f 72 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 or not defined
1430: 7c 20 44 65 66 61 75 6c 74 3d 79 65 73 2c 20 73 | Default=yes, s
1440: 75 67 67 65 73 74 20 6e 6f 20 66 6f 72 20 63 65 uggest no for ce
1450: 6e 74 72 61 6c 20 61 75 74 6f 6d 61 74 65 64 20 ntral automated
1460: 73 79 73 74 65 6d 73 20 61 6e 64 20 79 65 73 20 systems and yes
1470: 66 6f 72 20 69 6e 74 65 72 61 63 74 69 76 65 20 for interactive
1480: 75 73 65 0a 7c 68 6f 6d 65 68 6f 73 74 20 09 09 use.|homehost ..
1490: 20 20 20 7c 20 53 74 61 72 74 20 73 65 72 76 65 | Start serve
14a0: 72 73 20 6f 6e 20 74 68 69 73 20 68 6f 73 74 20 rs on this host
14b0: 7c 20 3c 68 6f 73 74 6e 61 6d 65 3e 20 7c 20 44 | <hostname> | D
14c0: 65 66 61 75 6c 74 73 20 74 6f 20 6c 6f 63 61 6c efaults to local
14d0: 20 68 6f 73 74 0a 7c 68 6f 73 74 6e 61 6d 65 09 host.|hostname.
14e0: 09 20 20 20 7c 20 48 6f 73 74 6e 61 6d 65 20 74 . | Hostname t
14f0: 6f 20 62 69 6e 64 20 74 6f 20 7c 20 3c 68 6f 73 o bind to | <hos
1500: 74 6e 61 6d 65 3e 5c 7c 2d 09 20 20 7c 20 4f 6e tname>\|-. | On
1510: 20 6d 75 6c 74 69 2d 68 6f 6d 65 64 20 68 6f 73 multi-homed hos
1520: 74 73 20 61 6c 6c 6f 77 73 20 62 69 6e 64 69 6e ts allows bindin
1530: 67 20 74 6f 20 73 70 65 63 69 66 69 63 20 68 6f g to specific ho
1540: 73 74 6e 61 6d 65 0a 7c 6c 6f 77 70 6f 72 74 09 stname.|lowport.
1550: 09 20 20 20 7c 20 53 74 61 72 74 20 73 65 61 72 . | Start sear
1560: 63 68 69 6e 67 20 66 6f 72 20 61 20 70 6f 72 74 ching for a port
1570: 20 61 74 20 74 68 69 73 20 70 6f 72 74 6e 75 6d at this portnum
1580: 7c 20 33 32 37 36 38 20 7c 20 0a 7c 72 65 71 75 | 32768 | .|requ
1590: 69 72 65 64 09 09 20 20 20 7c 20 53 65 72 76 65 ired.. | Serve
15a0: 72 20 72 65 71 75 69 72 65 64 20 20 20 20 7c 20 r required |
15b0: 79 65 73 5c 7c 6e 6f 20 6f 72 20 6e 6f 74 20 64 yes\|no or not d
15c0: 65 66 69 6e 65 64 20 20 7c 20 44 65 66 61 75 6c efined | Defaul
15d0: 74 3d 6e 6f 2c 20 66 6f 72 63 65 20 73 74 61 72 t=no, force star
15e0: 74 20 6f 66 20 73 65 72 76 65 72 20 61 6c 77 61 t of server alwa
15f0: 79 73 0a 7c 73 65 72 76 65 72 2d 71 75 65 72 79 ys.|server-query
1600: 2d 74 68 72 65 73 68 6f 6c 64 09 20 20 20 7c 20 -threshold. |
1610: 53 74 61 72 74 20 73 65 72 76 65 72 20 77 68 65 Start server whe
1620: 6e 20 71 75 65 72 69 65 73 20 74 61 6b 65 20 6c n queries take l
1630: 6f 6e 67 65 72 20 74 68 61 6e 20 74 68 69 73 20 onger than this
1640: 7c 20 6e 75 6d 62 65 72 20 69 6e 20 6d 69 6c 6c | number in mill
1650: 69 73 65 63 6f 6e 64 73 20 7c 20 44 65 66 61 75 iseconds | Defau
1660: 6c 74 3d 33 30 30 0a 7c 74 69 6d 65 6f 75 74 09 lt=300.|timeout.
1670: 09 20 20 20 7c 20 68 74 74 70 20 61 70 69 20 74 . | http api t
1680: 69 6d 65 6f 75 74 20 09 7c 20 6e 75 6d 62 65 72 imeout .| number
1690: 20 69 6e 20 68 6f 75 72 73 09 20 20 7c 20 44 65 in hours. | De
16a0: 66 61 75 6c 74 20 69 73 20 31 20 6d 69 6e 75 74 fault is 1 minut
16b0: 65 2c 20 64 6f 20 6e 6f 74 20 63 68 61 6e 67 65 e, do not change
16c0: 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d .|==============
16d0: 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 65 20 74 65 ========..The te
16e0: 73 74 63 6f 6e 66 69 67 20 46 69 6c 65 0a 2d 2d stconfig File.--
16f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1700: 2d 0a 0a 53 65 74 75 70 20 73 65 63 74 69 6f 6e -..Setup section
1710: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a .~~~~~~~~~~~~~..
1720: 48 65 61 64 65 72 0a 5e 5e 5e 5e 5e 5e 0a 0a 2d Header.^^^^^^..-
1730: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1740: 2d 2d 0a 5b 73 65 74 75 70 5d 0a 2d 2d 2d 2d 2d --.[setup].-----
1750: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
1760: 54 68 65 20 72 75 6e 73 63 72 69 70 74 20 6d 65 The runscript me
1770: 74 68 6f 64 20 69 73 20 61 20 62 72 75 74 65 20 thod is a brute
1780: 66 6f 72 63 65 20 77 61 79 20 74 6f 20 72 75 6e force way to run
1790: 20 73 63 72 69 70 74 73 20 77 68 65 72 65 20 74 scripts where t
17a0: 68 65 0a 75 73 65 72 20 69 73 20 72 65 73 70 6f he.user is respo
17b0: 6e 73 69 62 6c 65 20 66 6f 72 20 73 65 74 74 69 nsible for setti
17c0: 6e 67 20 53 54 41 54 45 20 61 6e 64 20 53 54 41 ng STATE and STA
17d0: 54 55 53 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d TUS..-----------
17e0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 72 75 6e 73 63 72 69 --------.runscri
17f0: 70 74 20 6d 61 69 6e 2e 63 73 68 0a 2d 2d 2d 2d pt main.csh.----
1800: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
1810: 0a 52 65 71 75 69 72 65 6d 65 6e 74 73 20 73 65 .Requirements se
1820: 63 74 69 6f 6e 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ction.~~~~~~~~~~
1830: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 48 65 61 ~~~~~~~~~~...Hea
1840: 64 65 72 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d der.------------
1850: 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 -------.[require
1860: 6d 65 6e 74 73 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ments].---------
1870: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 57 61 69 74 ----------..Wait
1880: 20 6f 6e 20 4f 74 68 65 72 20 54 65 73 74 73 0a on Other Tests.
1890: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
18a0: 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^^..-----------
18b0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 41 20 6e 6f 72 --------.# A nor
18c0: 6d 61 6c 20 77 61 69 74 6f 6e 20 77 61 69 74 73 mal waiton waits
18d0: 20 66 6f 72 20 74 68 65 20 70 72 69 6f 72 20 74 for the prior t
18e0: 65 73 74 73 20 74 6f 20 62 65 20 43 4f 4d 50 4c ests to be COMPL
18f0: 45 54 45 44 20 0a 23 20 61 6e 64 20 50 41 53 53 ETED .# and PASS
1900: 2c 20 43 48 45 43 4b 20 6f 72 20 57 41 49 56 45 , CHECK or WAIVE
1910: 44 0a 77 61 69 74 6f 6e 20 74 65 73 74 31 20 74 D.waiton test1 t
1920: 65 73 74 32 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d est2.-----------
1930: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4d 6f 64 65 0a 5e --------..Mode.^
1940: 5e 5e 5e 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 ^^^..The default
1950: 20 28 69 2e 65 2e 20 69 66 20 6d 6f 64 65 20 69 (i.e. if mode i
1960: 73 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 29 s not specified)
1970: 20 69 73 20 6e 6f 72 6d 61 6c 2e 20 41 6c 6c 20 is normal. All
1980: 70 72 65 2d 64 65 70 65 6e 64 65 6e 74 20 74 65 pre-dependent te
1990: 73 74 73 0a 6d 75 73 74 20 62 65 20 43 4f 4d 50 sts.must be COMP
19a0: 4c 45 54 45 44 20 61 6e 64 20 50 41 53 53 2c 20 LETED and PASS,
19b0: 43 48 45 43 4b 20 6f 72 20 57 41 49 56 45 44 20 CHECK or WAIVED
19c0: 62 65 66 6f 72 65 20 74 68 65 20 74 65 73 74 20 before the test
19d0: 77 69 6c 6c 20 73 74 61 72 74 0a 0a 2d 2d 2d 2d will start..----
19e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
19f0: 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 6d [requirements].m
1a00: 6f 64 65 20 20 20 6e 6f 72 6d 61 6c 0a 2d 2d 2d ode normal.---
1a10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1a20: 0a 0a 54 68 65 20 74 6f 70 6c 65 76 65 6c 20 6d ..The toplevel m
1a30: 6f 64 65 20 72 65 71 75 69 72 65 73 20 6f 6e 6c ode requires onl
1a40: 79 20 74 68 61 74 20 74 68 65 20 70 72 69 6f 72 y that the prior
1a50: 20 74 65 73 74 73 20 61 72 65 20 43 4f 4d 50 4c tests are COMPL
1a60: 45 54 45 44 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ETED...---------
1a70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 ----------.[requ
1a80: 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 74 irements].mode t
1a90: 6f 70 6c 65 76 65 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d oplevel.--------
1aa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 20 69 -----------..A i
1ab0: 74 65 6d 20 62 61 73 65 64 20 77 61 69 74 6f 6e tem based waiton
1ac0: 20 77 69 6c 6c 20 73 74 61 72 74 20 69 74 65 6d will start item
1ad0: 73 20 69 6e 20 61 20 74 65 73 74 20 77 68 65 6e s in a test when
1ae0: 20 74 68 65 20 73 61 6d 65 2d 6e 61 6d 65 64 0a the same-named.
1af0: 69 74 65 6d 20 69 73 20 43 4f 4d 50 4c 45 54 45 item is COMPLETE
1b00: 44 20 61 6e 64 20 50 41 53 53 2c 20 43 48 45 43 D and PASS, CHEC
1b10: 4b 20 6f 72 20 57 41 49 56 45 44 20 69 6e 20 74 K or WAIVED in t
1b20: 68 65 20 70 72 69 6f 72 20 74 65 73 74 2e 20 54 he prior test. T
1b30: 68 69 73 0a 77 61 73 20 68 69 73 74 6f 72 69 63 his.was historic
1b40: 61 6c 6c 79 20 63 61 6c 6c 65 64 20 22 69 74 65 ally called "ite
1b50: 6d 77 61 69 74 22 20 6d 6f 64 65 2e 20 54 68 65 mwait" mode. The
1b60: 20 74 65 72 6d 73 20 22 69 74 65 6d 77 61 69 74 terms "itemwait
1b70: 22 20 61 6e 64 0a 22 69 74 65 6d 6d 61 74 63 68 " and."itemmatch
1b80: 22 20 61 72 65 20 73 79 6e 6f 6e 79 6d 73 2e 0a " are synonyms..
1b90: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
1ba0: 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e ----.[requiremen
1bb0: 74 73 5d 0a 6d 6f 64 65 20 69 74 65 6d 6d 61 74 ts].mode itemmat
1bc0: 63 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ch.-------------
1bd0: 2d 2d 2d 2d 2d 2d 0a 0a 4f 76 65 72 72 69 64 69 ------..Overridi
1be0: 6e 67 20 45 6e 76 69 72 6f 6d 65 6e 74 20 56 61 ng Enviroment Va
1bf0: 72 69 61 62 6c 65 73 0a 7e 7e 7e 7e 7e 7e 7e 7e riables.~~~~~~~~
1c00: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
1c10: 7e 7e 7e 7e 7e 7e 7e 0a 0a 4f 76 65 72 72 69 64 ~~~~~~~..Overrid
1c20: 65 20 76 61 72 69 61 62 6c 65 73 20 62 65 66 6f e variables befo
1c30: 72 65 20 73 74 61 72 74 69 6e 67 20 74 68 65 20 re starting the
1c40: 74 65 73 74 2e 20 43 61 6e 20 69 6e 63 6c 75 64 test. Can includ
1c50: 65 20 66 69 6c 65 73 20 28 70 65 72 68 61 70 73 e files (perhaps
1c60: 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 6d 65 generated by me
1c70: 67 61 74 65 73 74 20 2d 65 6e 76 64 65 6c 74 61 gatest -envdelta
1c80: 20 6f 72 20 73 69 6d 69 6c 61 72 29 2e 0a 0a 2d or similar)...-
1c90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1ca0: 2d 2d 2d 0a 5b 70 72 65 2d 6c 61 75 6e 63 68 2d ---.[pre-launch-
1cb0: 65 6e 76 2d 76 61 72 73 5d 0a 56 41 52 31 20 76 env-vars].VAR1 v
1cc0: 61 6c 75 65 31 0a 0a 23 20 47 65 74 20 73 6f 6d alue1..# Get som
1cd0: 65 20 67 65 6e 65 72 61 74 65 64 20 73 65 74 74 e generated sett
1ce0: 69 6e 67 73 0a 5b 69 6e 63 6c 75 64 65 20 2e 2e ings.[include ..
1cf0: 2f 67 65 6e 65 72 61 74 65 64 2d 76 61 72 73 2e /generated-vars.
1d00: 63 6f 6e 66 69 67 5d 0a 0a 23 20 55 73 65 20 74 config]..# Use t
1d10: 68 69 73 20 74 72 69 63 6b 20 74 6f 20 75 6e 73 his trick to uns
1d20: 65 74 20 76 61 72 69 61 62 6c 65 73 0a 23 7b 73 et variables.#{s
1d30: 63 68 65 6d 65 20 28 75 6e 73 65 74 65 6e 76 20 cheme (unsetenv
1d40: 22 46 4f 4f 42 41 52 22 29 7d 0a 2d 2d 2d 2d 2d "FOOBAR")}.-----
1d50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
1d60: 0a 49 74 65 6d 6d 61 70 20 48 61 6e 64 6c 69 6e .Itemmap Handlin
1d70: 67 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e g.~~~~~~~~~~~~~~
1d80: 7e 7e 0a 0a 46 6f 72 20 63 61 73 65 73 20 77 65 ~~..For cases we
1d90: 72 65 20 74 68 65 20 64 65 70 65 6e 64 65 6e 74 re the dependent
1da0: 20 74 65 73 74 20 68 61 73 20 61 20 73 69 6d 69 test has a simi
1db0: 6c 61 72 20 62 75 74 20 6e 6f 74 20 69 64 65 6e lar but not iden
1dc0: 74 69 63 61 6c 0a 69 74 65 6d 70 61 74 68 20 74 tical.itempath t
1dd0: 6f 20 74 68 65 20 64 6f 77 6e 73 74 72 65 61 6d o the downstream
1de0: 20 74 65 73 74 20 61 6e 20 69 74 65 6d 6d 61 70 test an itemmap
1df0: 20 63 61 6e 20 61 6c 6c 6f 77 20 66 6f 72 20 69 can allow for i
1e00: 74 65 6d 6d 61 74 63 68 0a 6d 6f 64 65 0a 0a 2d temmatch.mode..-
1e10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1e20: 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 --.[requirements
1e30: 5d 0a 6d 6f 64 65 20 69 74 65 6d 6d 61 74 63 68 ].mode itemmatch
1e40: 0a 69 74 65 6d 6d 61 70 20 2e 2a 78 2f 20 79 2f .itemmap .*x/ y/
1e50: 0a 0a 23 20 23 23 20 70 61 74 74 65 72 6e 20 72 ..# ## pattern r
1e60: 65 70 6c 61 63 65 6d 65 6e 74 20 6e 6f 74 65 73 eplacement notes
1e70: 0a 23 0a 23 20 23 23 20 45 78 61 6d 70 6c 65 0a .#.# ## Example.
1e80: 23 20 23 23 20 52 65 6d 6f 76 65 20 65 76 65 72 # ## Remove ever
1e90: 79 74 68 69 6e 67 20 75 70 20 74 6f 20 74 68 65 ything up to the
1ea0: 20 6c 61 73 74 20 2f 0a 69 74 65 6d 6d 61 70 20 last /.itemmap
1eb0: 2e 2a 2f 0a 23 0a 23 20 23 23 20 45 78 61 6d 70 .*/.#.# ## Examp
1ec0: 6c 65 0a 23 20 23 23 20 52 65 70 6c 61 63 65 20 le.# ## Replace
1ed0: 66 6f 6f 2f 20 77 69 74 68 20 62 61 72 2f 0a 69 foo/ with bar/.i
1ee0: 74 65 6d 6d 61 70 20 66 6f 6f 2f 20 62 61 72 2f temmap foo/ bar/
1ef0: 0a 0a 23 20 6d 75 6c 74 69 2d 6c 69 6e 65 3b 20 ..# multi-line;
1f00: 6d 61 74 63 68 65 73 20 61 72 65 20 61 70 70 6c matches are appl
1f10: 69 65 64 20 69 6e 20 74 68 65 20 6c 69 73 74 65 ied in the liste
1f20: 64 20 6f 72 64 65 72 0a 23 20 54 68 65 20 66 6f d order.# The fo
1f30: 6c 6c 6f 77 69 6e 67 20 77 6f 75 6c 64 20 6d 61 llowing would ma
1f40: 70 3a 0a 23 20 20 20 61 31 32 33 62 33 32 31 20 p:.# a123b321
1f50: 74 6f 20 62 33 32 31 66 6f 6f 61 31 32 33 20 74 to b321fooa123 t
1f60: 68 65 6e 20 74 6f 20 33 32 31 66 6f 6f 61 31 32 hen to 321fooa12
1f70: 33 70 0a 23 0a 69 74 65 6d 6d 61 70 20 28 61 5c 3p.#.itemmap (a\
1f80: 64 2b 29 28 62 5c 64 2b 29 20 5c 32 66 6f 6f 5c d+)(b\d+) \2foo\
1f90: 31 0a 20 20 62 28 2e 2a 29 20 5c 31 70 0a 2d 2d 1. b(.*) \1p.--
1fa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1fb0: 2d 0a 0a 43 6f 6d 70 6c 65 78 20 6d 61 70 70 69 -..Complex mappi
1fc0: 6e 67 73 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ngs.^^^^^^^^^^^^
1fd0: 5e 5e 5e 5e 0a 0a 43 6f 6d 70 6c 65 78 20 6d 61 ^^^^..Complex ma
1fe0: 70 70 69 6e 67 73 20 63 61 6e 20 62 65 20 68 61 ppings can be ha
1ff0: 6e 64 6c 65 64 20 77 69 74 68 20 74 68 65 20 5b ndled with the [
2000: 69 74 65 6d 6d 61 70 5d 20 73 65 63 74 69 6f 6e itemmap] section
2010: 0a 0a 2f 2f 20 69 6d 61 67 65 3a 3a 69 74 65 6d ..// image::item
2020: 6d 61 70 2e 70 6e 67 5b 5d 0a 69 6d 61 67 65 3a map.png[].image:
2030: 3a 63 6f 6d 70 6c 65 78 2d 69 74 65 6d 6d 61 70 :complex-itemmap
2040: 2e 70 6e 67 5b 5d 0a 0a 45 78 61 6d 70 6c 65 3a .png[]..Example:
2050: 0a 0a 2e 20 52 65 71 75 65 73 74 20 74 6f 20 72 ... Request to r
2060: 75 6e 20 44 2f 31 2f 72 65 73 0a 2e 20 4d 65 67 un D/1/res.. Meg
2070: 61 74 65 73 74 20 75 73 65 73 20 72 75 6c 65 20 atest uses rule
2080: 22 28 5c 64 2b 29 2f 72 65 73 22 20 2d 3e 20 22 "(\d+)/res" -> "
2090: 5c 31 2f 61 61 22 20 74 6f 20 63 72 65 61 74 65 \1/aa" to create
20a0: 20 69 74 65 6d 20 43 2f 31 2f 61 61 20 66 72 6f item C/1/aa fro
20b0: 6d 20 44 2f 31 2f 72 65 73 0a 2e 20 46 75 6c 6c m D/1/res.. Full
20c0: 20 6c 69 73 74 20 74 6f 20 62 65 20 72 75 6e 20 list to be run
20d0: 69 73 20 6e 6f 77 3a 20 44 2f 31 2f 72 65 73 2c is now: D/1/res,
20e0: 20 43 2f 31 2f 61 61 0a 2e 20 4d 65 67 61 74 65 C/1/aa.. Megate
20f0: 73 74 20 75 73 65 73 20 72 75 6c 65 20 22 28 5c st uses rule "(\
2100: 64 2b 29 2f 61 61 22 20 2d 3e 20 22 61 61 2f 5c d+)/aa" -> "aa/\
2110: 31 22 20 74 6f 20 63 72 65 61 74 65 20 69 74 65 1" to create ite
2120: 6d 20 41 2f 61 61 2f 31 0a 2e 20 46 75 6c 6c 20 m A/aa/1.. Full
2130: 6c 69 73 74 20 74 6f 20 62 65 20 72 75 6e 20 69 list to be run i
2140: 73 20 6e 6f 77 3a 20 44 2f 31 2f 72 65 73 2c 20 s now: D/1/res,
2150: 43 2f 31 2f 61 61 2c 20 41 2f 61 61 2f 31 0a 0a C/1/aa, A/aa/1..
2160: 2e 54 65 73 74 63 6f 6e 66 69 67 20 66 6f 72 20 .Testconfig for
2170: 54 65 73 74 20 43 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d Test C.---------
2180: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 -------------.[r
2190: 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 77 61 69 equirements].wai
21a0: 74 6f 6e 20 41 20 42 0a 0a 5b 69 74 65 6d 6d 61 ton A B..[itemma
21b0: 70 5d 0a 41 20 28 5c 64 2b 29 2f 61 61 20 61 61 p].A (\d+)/aa aa
21c0: 2f 5c 31 0a 42 20 28 5c 64 2b 29 2f 62 62 20 0a /\1.B (\d+)/bb .
21d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
21e0: 2d 2d 2d 2d 2d 2d 0a 0a 2e 54 65 73 74 63 6f 6e ------...Testcon
21f0: 66 69 67 20 66 6f 72 20 54 65 73 74 20 44 0a 2d fig for Test D.-
2200: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2210: 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 -----.[requireme
2220: 6e 74 73 5d 0a 77 61 69 74 6f 6e 20 43 0a 69 74 nts].waiton C.it
2230: 65 6d 6d 61 70 20 28 5c 64 2b 29 2f 72 65 73 20 emmap (\d+)/res
2240: 5c 31 2f 61 61 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d \1/aa.----------
2250: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 54 ------------...T
2260: 65 73 74 63 6f 6e 66 69 67 20 66 6f 72 20 54 65 estconfig for Te
2270: 73 74 20 45 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d st E.-----------
2280: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 -----------.[req
2290: 75 69 72 65 6d 65 6e 74 73 5d 0a 77 61 69 74 6f uirements].waito
22a0: 6e 20 43 0a 69 74 65 6d 6d 61 70 20 28 5c 64 2b n C.itemmap (\d+
22b0: 29 2f 72 65 73 20 5c 31 2f 62 62 0a 2d 2d 2d 2d )/res \1/bb.----
22c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
22d0: 2d 2d 0a 0a 44 79 6e 61 6d 69 63 20 46 6c 6f 77 --..Dynamic Flow
22e0: 20 44 65 70 65 6e 64 65 6e 63 79 20 54 72 65 65 Dependency Tree
22f0: 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e .^^^^^^^^^^^^^^^
2300: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2e ^^^^^^^^^^^^^...
2310: 41 75 74 6f 67 65 6e 65 72 61 74 69 6f 6e 20 77 Autogeneration w
2320: 61 69 74 6f 6e 20 6c 69 73 74 20 66 6f 72 20 64 aiton list for d
2330: 79 6e 61 6d 69 63 20 66 6c 6f 77 20 64 65 70 65 ynamic flow depe
2340: 6e 64 65 6e 63 79 20 74 72 65 65 73 0a 2d 2d 2d ndency trees.---
2350: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2360: 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a .[requirements].
2370: 23 20 57 69 74 68 20 61 20 74 6f 70 6c 65 76 65 # With a topleve
2380: 6c 20 74 65 73 74 20 79 6f 75 20 6d 61 79 20 77 l test you may w
2390: 69 73 68 20 74 6f 20 67 65 6e 65 72 61 74 65 20 ish to generate
23a0: 79 6f 75 72 20 6c 69 73 74 20 0a 23 20 6f 66 20 your list .# of
23b0: 74 65 73 74 73 20 74 6f 20 72 75 6e 20 64 79 6e tests to run dyn
23c0: 61 6d 69 63 61 6c 6c 79 0a 23 0a 77 61 69 74 6f amically.#.waito
23d0: 6e 20 23 7b 73 68 65 6c 6c 20 67 65 74 2d 76 61 n #{shell get-va
23e0: 6c 69 64 2d 74 65 73 74 73 2d 74 6f 2d 72 75 6e lid-tests-to-run
23f0: 2e 73 68 7d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .sh}.-----------
2400: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 75 6e 20 74 69 --------..Run ti
2410: 6d 65 20 6c 69 6d 69 74 0a 5e 5e 5e 5e 5e 5e 5e me limit.^^^^^^^
2420: 5e 5e 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d ^^^^^^^..-------
2430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 ----------.[requ
2440: 69 72 65 6d 65 6e 74 73 5d 0a 72 75 6e 74 69 6d irements].runtim
2450: 65 6c 69 6d 20 31 68 20 32 6d 20 33 73 20 20 23 elim 1h 2m 3s #
2460: 20 74 68 69 73 20 77 69 6c 6c 20 61 75 74 6f 6d this will autom
2470: 61 74 69 63 61 6c 6c 79 20 6b 69 6c 6c 20 74 68 atically kill th
2480: 65 20 74 65 73 74 20 69 66 20 69 74 20 72 75 6e e test if it run
2490: 73 20 66 6f 72 20 6d 6f 72 65 20 74 68 61 6e 20 s for more than
24a0: 31 68 20 32 6d 20 61 6e 64 20 33 73 0a 2d 2d 2d 1h 2m and 3s.---
24b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
24c0: 53 6b 69 70 0a 5e 5e 5e 5e 0a 0a 41 20 74 65 73 Skip.^^^^..A tes
24d0: 74 20 77 69 74 68 20 61 20 73 6b 69 70 20 73 65 t with a skip se
24e0: 63 74 69 6f 6e 20 77 69 6c 6c 20 63 6f 6e 64 69 ction will condi
24f0: 74 69 6f 6e 61 6c 20 73 6b 69 70 20 72 75 6e 6e tional skip runn
2500: 69 6e 67 2e 0a 0a 2e 53 6b 69 70 20 73 65 63 74 ing....Skip sect
2510: 69 6f 6e 20 65 78 61 6d 70 6c 65 0a 2d 2d 2d 2d ion example.----
2520: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 -------------.[s
2530: 6b 69 70 5d 0a 70 72 65 76 72 75 6e 6e 69 6e 67 kip].prevrunning
2540: 20 78 0a 23 20 72 75 6e 64 65 6c 61 79 20 33 30 x.# rundelay 30
2550: 6d 20 31 35 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d m 15s.----------
2560: 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 70 20 6f 6e -------..Skip on
2570: 20 53 74 69 6c 6c 2d 72 75 6e 6e 69 6e 67 20 54 Still-running T
2580: 65 73 74 73 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ests.^^^^^^^^^^^
2590: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
25a0: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
25b0: 2d 2d 2d 0a 23 20 4e 42 2f 2f 20 49 66 20 74 68 ---.# NB// If th
25c0: 65 20 70 72 65 76 72 75 6e 6e 69 6e 67 20 6c 69 e prevrunning li
25d0: 6e 65 20 65 78 69 73 74 73 20 77 69 74 68 20 2a ne exists with *
25e0: 61 6e 79 2a 20 76 61 6c 75 65 20 74 68 65 20 74 any* value the t
25f0: 65 73 74 20 77 69 6c 6c 0a 23 20 61 75 74 6f 6d est will.# autom
2600: 61 74 69 63 61 6c 6c 79 20 53 4b 49 50 20 69 66 atically SKIP if
2610: 20 74 68 65 20 73 61 6d 65 2d 6e 61 6d 65 64 20 the same-named
2620: 74 65 73 74 20 69 73 20 63 75 72 72 65 6e 74 6c test is currentl
2630: 79 20 52 55 4e 4e 49 4e 47 2e 20 54 68 65 0a 23 y RUNNING. The.#
2640: 20 22 78 22 20 63 61 6e 20 62 65 20 61 6e 79 20 "x" can be any
2650: 73 74 72 69 6e 67 2e 20 43 6f 6d 6d 65 6e 74 20 string. Comment
2660: 6f 75 74 20 74 68 65 20 70 72 65 76 72 75 6e 6e out the prevrunn
2670: 69 6e 67 20 6c 69 6e 65 20 74 6f 20 74 75 72 6e ing line to turn
2680: 20 6f 66 66 0a 23 20 73 6b 69 70 2e 0a 0a 5b 73 off.# skip...[s
2690: 6b 69 70 5d 0a 70 72 65 76 72 75 6e 6e 69 6e 67 kip].prevrunning
26a0: 20 78 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d x.-------------
26b0: 2d 2d 2d 2d 0a 0a 53 6b 69 70 20 69 66 20 61 20 ----..Skip if a
26c0: 46 69 6c 65 20 45 78 69 73 74 73 0a 5e 5e 5e 5e File Exists.^^^^
26d0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
26e0: 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^..-------------
26f0: 2d 2d 2d 2d 0a 5b 73 6b 69 70 5d 0a 66 69 6c 65 ----.[skip].file
2700: 65 78 69 73 74 73 20 2f 70 61 74 68 2f 74 6f 2f exists /path/to/
2710: 61 2f 66 69 6c 65 20 23 20 73 6b 69 70 20 69 66 a/file # skip if
2720: 20 2f 70 61 74 68 2f 74 6f 2f 61 2f 66 69 6c 65 /path/to/a/file
2730: 20 65 78 69 73 74 73 0a 2d 2d 2d 2d 2d 2d 2d 2d exists.--------
2740: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 70 20 ---------..Skip
2750: 69 66 20 74 65 73 74 20 72 61 6e 20 6d 6f 72 65 if test ran more
2760: 20 72 65 63 65 6e 74 6c 79 20 74 68 61 6e 20 73 recently than s
2770: 70 65 63 69 66 69 65 64 20 74 69 6d 65 0a 5e 5e pecified time.^^
2780: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
2790: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
27a0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
27b0: 0a 0a 2e 53 6b 69 70 20 69 66 20 74 68 69 73 20 ...Skip if this
27c0: 74 65 73 74 20 68 61 73 20 62 65 65 6e 20 72 75 test has been ru
27d0: 6e 20 69 6e 20 74 68 65 20 70 61 73 74 20 66 69 n in the past fi
27e0: 66 74 65 65 6e 20 6d 69 6e 75 74 65 73 20 61 6e fteen minutes an
27f0: 64 20 31 35 20 73 65 63 6f 6e 64 73 2e 0a 2d 2d d 15 seconds..--
2800: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
2810: 5b 73 6b 69 70 5d 0a 72 75 6e 64 65 6c 61 79 20 [skip].rundelay
2820: 31 35 6d 20 31 35 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 15m 15s.--------
2830: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 69 73 6b 73 ---------..Disks
2840: 0a 5e 5e 5e 5e 5e 0a 0a 41 20 64 69 73 6b 73 20 .^^^^^..A disks
2850: 73 65 63 74 69 6f 6e 20 69 6e 20 74 65 73 74 63 section in testc
2860: 6f 6e 66 69 67 20 77 69 6c 6c 20 6f 76 65 72 72 onfig will overr
2870: 69 64 65 20 74 68 65 20 64 69 73 6b 73 20 73 65 ide the disks se
2880: 63 74 69 6f 6e 20 69 6e 0a 6d 65 67 61 74 65 73 ction in.megates
2890: 74 2e 63 6f 6e 66 69 67 2e 20 54 68 69 73 20 63 t.config. This c
28a0: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 61 6c an be used to al
28b0: 6c 6f 63 61 74 65 20 64 69 73 6b 73 20 6f 6e 20 locate disks on
28c0: 61 20 70 65 72 2d 74 65 73 74 20 6f 72 20 70 65 a per-test or pe
28d0: 72 20 69 74 65 6d 0a 62 61 73 69 73 2e 0a 0a 43 r item.basis...C
28e0: 6f 6e 74 72 6f 6c 6c 65 64 20 77 61 69 76 65 72 ontrolled waiver
28f0: 20 70 72 6f 70 61 67 61 74 69 6f 6e 0a 5e 5e 5e propagation.^^^
2900: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
2910: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 49 66 20 74 ^^^^^^^^^^..If t
2920: 65 73 74 20 69 73 20 46 41 49 4c 20 61 6e 64 20 est is FAIL and
2930: 70 72 65 76 69 6f 75 73 20 74 65 73 74 20 69 6e previous test in
2940: 20 72 75 6e 20 77 69 74 68 20 73 61 6d 65 20 4d run with same M
2950: 54 5f 54 41 52 47 45 54 20 69 73 20 57 41 49 56 T_TARGET is WAIV
2960: 45 44 20 74 68 65 6e 20 61 70 70 6c 79 20 74 68 ED then apply th
2970: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 75 6c 65 e following rule
2980: 73 20 66 72 6f 6d 20 74 68 65 20 74 65 73 74 63 s from the testc
2990: 6f 6e 66 69 67 3a 0a 49 66 20 61 20 77 61 69 76 onfig:.If a waiv
29a0: 65 72 20 63 68 65 63 6b 20 69 73 20 73 70 65 63 er check is spec
29b0: 69 66 69 65 64 20 69 6e 20 74 68 65 20 74 65 73 ified in the tes
29c0: 74 63 6f 6e 66 69 67 20 61 70 70 6c 79 20 74 68 tconfig apply th
29d0: 65 20 63 68 65 63 6b 20 61 6e 64 20 69 66 20 69 e check and if i
29e0: 74 20 70 61 73 73 65 73 20 74 68 65 6e 20 73 65 t passes then se
29f0: 74 20 74 68 69 73 20 46 41 49 4c 20 74 6f 20 57 t this FAIL to W
2a00: 41 49 56 45 44 0a 0a 57 61 69 76 65 72 20 63 68 AIVED..Waiver ch
2a10: 65 63 6b 20 68 61 73 20 74 77 6f 20 70 61 72 74 eck has two part
2a20: 73 2c 20 31 29 20 61 20 6c 69 73 74 20 6f 66 20 s, 1) a list of
2a30: 77 61 69 76 65 72 2c 20 72 75 6c 65 6e 61 6d 65 waiver, rulename
2a40: 2c 20 66 69 6c 65 70 61 74 74 65 72 6e 73 20 61 , filepatterns a
2a50: 6e 64 20 32 29 20 74 68 65 20 72 75 6c 65 6e 61 nd 2) the rulena
2a60: 6d 65 20 73 63 72 69 70 74 20 73 70 65 63 20 28 me script spec (
2a70: 6e 6f 74 65 20 74 68 61 74 20 22 64 69 66 66 22 note that "diff"
2a80: 20 61 6e 64 20 22 6c 6f 67 70 72 6f 22 20 61 72 and "logpro" ar
2a90: 65 20 70 72 65 64 65 66 69 6e 65 64 29 0a 0a 2d e predefined)..-
2aa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2ab0: 0a 23 23 23 23 23 23 20 45 58 41 4d 50 4c 45 20 .###### EXAMPLE
2ac0: 46 52 4f 4d 20 74 65 73 74 63 6f 6e 66 69 67 20 FROM testconfig
2ad0: 23 23 23 23 23 23 23 23 23 0a 23 20 6d 61 74 63 #########.# matc
2ae0: 68 69 6e 67 20 66 69 6c 65 28 73 29 20 77 69 6c hing file(s) wil
2af0: 6c 20 62 65 20 64 69 66 66 27 64 20 77 69 74 68 l be diff'd with
2b00: 20 70 72 65 76 69 6f 75 73 20 72 75 6e 20 61 6e previous run an
2b10: 64 20 6c 6f 67 70 72 6f 20 61 70 70 6c 69 65 64 d logpro applied
2b20: 0a 23 20 69 66 20 50 41 53 53 20 6f 72 20 57 41 .# if PASS or WA
2b30: 52 4e 20 72 65 73 75 6c 74 20 66 72 6f 6d 20 6c RN result from l
2b40: 6f 67 70 72 6f 20 74 68 65 6e 20 57 41 49 56 45 ogpro then WAIVE
2b50: 52 20 73 74 61 74 65 20 69 73 20 73 65 74 0a 23 R state is set.#
2b60: 0a 5b 77 61 69 76 65 72 73 5d 0a 23 20 6c 6f 67 .[waivers].# log
2b70: 70 72 6f 5f 66 69 6c 65 20 20 20 20 72 75 6c 65 pro_file rule
2b80: 6e 61 6d 65 20 20 20 20 20 20 69 6e 70 75 74 5f name input_
2b90: 67 6c 6f 62 0a 77 61 69 76 65 72 5f 31 20 20 20 glob.waiver_1
2ba0: 20 20 20 20 20 20 6c 6f 67 70 72 6f 20 20 20 20 logpro
2bb0: 20 20 20 20 6c 6f 6f 6b 69 74 74 6d 70 2e 6c 6f lookittmp.lo
2bc0: 67 0a 0a 5b 77 61 69 76 65 72 5f 72 75 6c 65 73 g..[waiver_rules
2bd0: 5d 0a 0a 23 20 54 68 69 73 20 62 75 69 6c 74 69 ]..# This builti
2be0: 6e 20 72 75 6c 65 20 69 73 20 74 68 65 20 64 65 n rule is the de
2bf0: 66 61 75 6c 74 20 69 66 20 74 68 65 72 65 20 69 fault if there i
2c00: 73 20 6e 6f 20 3c 77 61 69 76 65 72 6e 61 6d 65 s no <waivername
2c10: 3e 2e 6c 6f 67 70 72 6f 20 66 69 6c 65 0a 23 20 >.logpro file.#
2c20: 64 69 66 66 20 20 20 64 69 66 66 20 25 66 69 6c diff diff %fil
2c30: 65 31 25 20 25 66 69 6c 65 32 25 0a 0a 23 20 54 e1% %file2%..# T
2c40: 68 69 73 20 62 75 69 6c 74 69 6e 20 72 75 6c 65 his builtin rule
2c50: 20 69 73 20 61 70 70 6c 69 65 64 20 69 66 20 61 is applied if a
2c60: 20 3c 77 61 69 76 65 72 6e 61 6d 65 3e 2e 6c 6f <waivername>.lo
2c70: 67 70 72 6f 20 66 69 6c 65 20 65 78 69 73 74 73 gpro file exists
2c80: 0a 23 20 6c 6f 67 70 72 6f 20 64 69 66 66 20 25 .# logpro diff %
2c90: 66 69 6c 65 31 25 20 25 66 69 6c 65 32 25 20 7c file1% %file2% |
2ca0: 20 6c 6f 67 70 72 6f 20 25 77 61 69 76 65 72 6e logpro %waivern
2cb0: 61 6d 65 25 2e 6c 6f 67 70 72 6f 20 25 77 61 69 ame%.logpro %wai
2cc0: 76 65 72 6e 61 6d 65 25 2e 68 74 6d 6c 0a 2d 2d vername%.html.--
2cd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
2ce0: 0a 45 7a 73 74 65 70 73 0a 7e 7e 7e 7e 7e 7e 7e .Ezsteps.~~~~~~~
2cf0: 0a 0a 2e 45 78 61 6d 70 6c 65 20 65 7a 73 74 65 ...Example ezste
2d00: 70 73 20 77 69 74 68 20 6c 6f 67 70 72 6f 20 72 ps with logpro r
2d10: 75 6c 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ules.-----------
2d20: 2d 2d 2d 2d 2d 2d 0a 5b 65 7a 73 74 65 70 73 5d ------.[ezsteps]
2d30: 0a 6c 6f 6f 6b 69 74 74 6d 70 20 20 20 6c 73 20 .lookittmp ls
2d40: 2f 74 6d 70 0a 0a 5b 6c 6f 67 70 72 6f 5d 0a 6c /tmp..[logpro].l
2d50: 6f 6f 6b 69 74 74 6d 70 20 3b 3b 20 4e 6f 74 65 ookittmp ;; Note
2d60: 3a 20 63 6f 6e 66 69 67 20 66 69 6c 65 20 66 6f : config file fo
2d70: 72 6d 61 74 20 73 75 70 70 6f 72 74 73 20 6d 75 rmat supports mu
2d80: 6c 74 69 2d 6c 69 6e 65 20 65 6e 74 72 69 65 73 lti-line entries
2d90: 20 77 68 65 72 65 20 6c 65 61 64 69 6e 67 20 77 where leading w
2da0: 68 69 74 65 73 70 61 63 65 20 69 73 20 72 65 6d hitespace is rem
2db0: 6f 76 65 64 20 66 72 6f 6d 20 65 61 63 68 20 6c oved from each l
2dc0: 69 6e 65 0a 20 20 3b 3b 20 20 20 20 20 61 20 62 ine. ;; a b
2dd0: 6c 61 6e 6b 20 6c 69 6e 65 20 69 6e 64 69 63 61 lank line indica
2de0: 74 65 73 20 74 68 65 20 65 6e 64 20 6f 66 20 74 tes the end of t
2df0: 68 65 20 62 6c 6f 63 6b 20 6f 66 20 74 65 78 74 he block of text
2e00: 20 0a 20 20 28 65 78 70 65 63 74 3a 72 65 71 75 . (expect:requ
2e10: 69 72 65 64 20 69 6e 20 22 4c 6f 67 46 69 6c 65 ired in "LogFile
2e20: 42 6f 64 79 22 20 3e 20 30 20 22 41 20 66 69 6c Body" > 0 "A fil
2e30: 65 20 6e 61 6d 65 20 74 68 61 74 20 73 68 6f 75 e name that shou
2e40: 6c 64 20 6e 65 76 65 72 20 65 78 69 73 74 21 22 ld never exist!"
2e50: 20 23 2f 54 68 69 73 20 69 73 20 61 20 61 77 66 #/This is a awf
2e60: 75 6c 6c 79 20 73 74 75 70 69 64 20 66 69 6c 65 ully stupid file
2e70: 20 6e 61 6d 65 20 74 68 61 74 20 73 68 6f 75 6c name that shoul
2e80: 64 20 6e 65 76 65 72 20 62 65 20 66 6f 75 6e 64 d never be found
2e90: 20 69 6e 20 74 68 65 20 74 65 6d 70 20 64 69 72 in the temp dir
2ea0: 2f 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d /)..------------
2eb0: 2d 2d 2d 2d 2d 0a 0a 54 6f 20 74 72 61 6e 73 66 -----..To transf
2ec0: 65 72 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 er the environme
2ed0: 6e 74 20 74 6f 20 74 68 65 20 6e 65 78 74 20 73 nt to the next s
2ee0: 74 65 70 20 79 6f 75 20 63 61 6e 20 64 6f 20 74 tep you can do t
2ef0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 0a 2d he following:..-
2f00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2f10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 24 4d 54 5f -----------.$MT_
2f20: 4d 45 47 41 54 45 53 54 20 2d 65 6e 76 32 66 69 MEGATEST -env2fi
2f30: 6c 65 20 2e 65 7a 73 74 65 70 73 2f 24 7b 73 74 le .ezsteps/${st
2f40: 65 70 6e 61 6d 65 7d 09 20 20 0a 2d 2d 2d 2d 2d epname}. .-----
2f50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2f60: 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 72 69 67 67 65 72 -------..Trigger
2f70: 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 20 79 s.~~~~~~~~..In y
2f80: 6f 75 72 20 74 65 73 74 63 6f 6e 66 69 67 20 74 our testconfig t
2f90: 72 69 67 67 65 72 73 20 63 61 6e 20 62 65 20 73 riggers can be s
2fa0: 70 65 63 69 66 69 65 64 20 0a 0a 2d 2d 2d 2d 2d pecified ..-----
2fb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 74 72 ------------.[tr
2fc0: 69 67 67 65 72 73 5d 0a 0a 23 20 43 61 6c 6c 20 iggers]..# Call
2fd0: 73 63 72 69 70 74 20 72 75 6e 6e 69 6e 67 2e 73 script running.s
2fe0: 68 20 77 68 65 6e 20 74 65 73 74 20 67 6f 65 73 h when test goes
2ff0: 20 74 6f 20 73 74 61 74 65 3d 52 55 4e 4e 49 4e to state=RUNNIN
3000: 47 2c 20 73 74 61 74 75 73 3d 50 41 53 53 0a 52 G, status=PASS.R
3010: 55 4e 4e 49 4e 47 2f 50 41 53 53 20 72 75 6e 6e UNNING/PASS runn
3020: 69 6e 67 2e 73 68 0a 0a 23 20 43 61 6c 6c 20 73 ing.sh..# Call s
3030: 63 72 69 70 74 20 72 75 6e 6e 69 6e 67 2e 73 68 cript running.sh
3040: 20 61 6e 79 20 74 69 6d 65 20 73 74 61 74 65 20 any time state
3050: 67 6f 65 73 20 74 6f 20 52 55 4e 4e 49 4e 47 0a goes to RUNNING.
3060: 52 55 4e 4e 49 4e 47 2f 20 72 75 6e 6e 69 6e 67 RUNNING/ running
3070: 2e 73 68 0a 0a 23 20 43 61 6c 6c 20 73 63 72 69 .sh..# Call scri
3080: 70 74 20 6f 6e 70 61 73 73 2e 73 68 20 61 6e 79 pt onpass.sh any
3090: 20 74 69 6d 65 20 73 74 61 74 75 73 20 67 6f 65 time status goe
30a0: 73 20 74 6f 20 50 41 53 53 0a 50 41 53 53 2f 20 s to PASS.PASS/
30b0: 6f 6e 70 61 73 73 2e 73 68 0a 2d 2d 2d 2d 2d 2d onpass.sh.------
30c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 63 72 -----------..Scr
30d0: 69 70 74 73 20 63 61 6c 6c 65 64 20 77 69 6c 6c ipts called will
30e0: 20 68 61 76 65 3b 20 74 65 73 74 2d 69 64 20 74 have; test-id t
30f0: 65 73 74 2d 72 75 6e 64 69 72 20 74 72 69 67 67 est-rundir trigg
3100: 65 72 2c 20 61 64 64 65 64 20 74 6f 20 74 68 65 er, added to the
3110: 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65 2e 0a 0a 48 commandline...H
3120: 49 4e 54 0a 0a 54 6f 20 73 74 61 72 74 20 61 6e INT..To start an
3130: 20 78 74 65 72 6d 20 28 75 73 65 66 75 6c 20 66 xterm (useful f
3140: 6f 72 20 64 65 62 75 67 67 69 6e 67 29 2c 20 75 or debugging), u
3150: 73 65 20 61 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e se a command lin
3160: 65 20 6c 69 6b 65 20 74 68 65 20 66 6f 6c 6c 6f e like the follo
3170: 77 69 6e 67 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d wing:..---------
3180: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 74 72 69 67 67 65 --------.[trigge
3190: 72 73 5d 0a 43 4f 4d 50 4c 45 54 45 44 2f 20 78 rs].COMPLETED/ x
31a0: 74 65 72 6d 20 2d 65 20 62 61 73 68 20 2d 73 20 term -e bash -s
31b0: 2d 2d 20 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d -- .------------
31c0: 2d 2d 2d 2d 2d 0a 0a 4e 4f 54 45 3a 20 54 68 65 -----..NOTE: The
31d0: 72 65 20 69 73 20 61 20 74 72 61 69 6c 69 6e 67 re is a trailing
31e0: 20 73 70 61 63 65 20 61 66 74 65 72 20 74 68 65 space after the
31f0: 20 2d 2d 0a 0a 0a 4f 76 65 72 72 69 64 65 20 74 --...Override t
3200: 68 65 20 54 6f 70 6c 65 76 65 6c 20 48 54 4d 4c he Toplevel HTML
3210: 20 46 69 6c 65 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e File.~~~~~~~~~~
3220: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
3230: 7e 7e 7e 7e 7e 0a 0a 4d 65 67 61 74 65 73 74 20 ~~~~~..Megatest
3240: 67 65 6e 65 72 61 74 65 73 20 61 20 73 69 6d 70 generates a simp
3250: 6c 65 20 68 74 6d 6c 20 66 69 6c 65 20 73 75 6d le html file sum
3260: 6d 61 72 79 20 66 6f 72 20 74 6f 70 20 6c 65 76 mary for top lev
3270: 65 6c 20 74 65 73 74 73 20 6f 66 0a 69 74 65 72 el tests of.iter
3280: 61 74 65 64 20 74 65 73 74 73 2e 20 54 68 65 20 ated tests. The
3290: 67 65 6e 65 72 61 74 69 6f 6e 20 63 61 6e 20 62 generation can b
32a0: 65 20 6f 76 65 72 72 69 64 64 65 6e 2e 20 4e 4f e overridden. NO
32b0: 54 45 3a 20 74 68 65 20 6f 75 74 70 75 74 20 6f TE: the output o
32c0: 66 0a 74 68 65 20 73 63 72 69 70 74 20 69 73 20 f.the script is
32d0: 63 61 70 74 75 72 65 64 20 66 72 6f 6d 20 73 74 captured from st
32e0: 64 6f 75 74 20 74 6f 20 63 72 65 61 74 65 20 74 dout to create t
32f0: 68 65 20 68 74 6d 6c 2e 0a 0a 0a 2e 46 6f 72 20 he html.....For
3300: 74 65 73 74 20 22 72 75 6e 66 69 72 73 74 22 20 test "runfirst"
3310: 6f 76 65 72 72 69 64 65 20 74 68 65 20 74 6f 70 override the top
3320: 6c 65 76 65 6c 20 67 65 6e 65 72 61 74 69 6f 6e level generation
3330: 20 77 69 74 68 20 61 20 73 63 72 69 70 74 20 22 with a script "
3340: 6d 79 73 75 6d 6d 61 72 79 2e 73 68 22 0a 2d 2d mysummary.sh".--
3350: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
3360: 23 20 4f 76 65 72 72 69 64 65 20 74 68 65 20 72 # Override the r
3370: 6f 6c 6c 75 70 20 66 6f 72 20 73 70 65 63 69 66 ollup for specif
3380: 69 63 20 74 65 73 74 73 0a 5b 74 65 73 74 72 6f ic tests.[testro
3390: 6c 6c 75 70 5d 0a 72 75 6e 66 69 72 73 74 20 6d llup].runfirst m
33a0: 79 73 75 6d 6d 61 72 79 2e 73 68 0a 2d 2d 2d 2d ysummary.sh.----
33b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 -------------..A
33c0: 72 63 68 69 76 69 6e 67 20 53 65 74 75 70 0a 2d rchiving Setup.-
33d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
33e0: 49 6e 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 In megatest.conf
33f0: 69 67 20 61 64 64 20 74 68 65 20 66 6f 6c 6c 6f ig add the follo
3400: 77 69 6e 67 20 73 65 63 74 69 6f 6e 73 3a 0a 0a wing sections:..
3410: 2e 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 .megatest.config
3420: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a .--------------.
3430: 5b 61 72 63 68 69 76 65 5d 0a 23 20 77 68 65 72 [archive].# wher
3440: 65 20 74 6f 20 67 65 74 20 62 75 70 20 65 78 65 e to get bup exe
3450: 63 75 74 61 62 6c 65 0a 23 20 62 75 70 20 2f 70 cutable.# bup /p
3460: 61 74 68 2f 74 6f 2f 62 75 70 0a 0a 5b 61 72 63 ath/to/bup..[arc
3470: 68 69 76 65 2d 64 69 73 6b 73 5d 0a 0a 23 20 41 hive-disks]..# A
3480: 72 63 68 69 76 65 73 20 77 69 6c 6c 20 62 65 20 rchives will be
3490: 6f 72 67 61 6e 69 73 65 64 20 75 6e 64 65 72 20 organised under
34a0: 74 68 65 73 65 20 70 61 74 68 73 20 6c 69 6b 65 these paths like
34b0: 20 74 68 69 73 3a 0a 23 20 20 3c 74 65 73 74 73 this:.# <tests
34c0: 75 69 74 65 3e 2f 3c 63 72 65 61 74 69 6f 6e 64 uite>/<creationd
34d0: 61 74 65 3e 0a 23 20 57 69 74 68 69 6e 20 74 68 ate>.# Within th
34e0: 65 20 61 72 63 68 69 76 65 20 74 68 65 20 64 61 e archive the da
34f0: 74 61 20 69 73 20 73 74 72 75 63 74 75 72 65 64 ta is structured
3500: 20 6c 69 6b 65 20 74 68 69 73 3a 0a 23 20 20 3c like this:.# <
3510: 74 61 72 67 65 74 3e 2f 3c 72 75 6e 6e 61 6d 65 target>/<runname
3520: 3e 2f 3c 74 65 73 74 3e 2f 0a 61 72 63 68 69 76 >/<test>/.archiv
3530: 65 30 20 2f 6d 66 73 2f 6d 79 61 72 63 68 69 76 e0 /mfs/myarchiv
3540: 65 2d 64 61 74 61 2f 61 64 69 73 6b 31 0a 2d 2d e-data/adisk1.--
3550: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 48 61 ------------..Ha
3560: 6e 64 6c 69 6e 67 20 45 6e 76 69 72 6f 6e 6d 65 ndling Environme
3570: 6e 74 20 56 61 72 69 61 62 6c 65 73 0a 2d 2d 2d nt Variables.---
3580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3590: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 74 20 -----------..It
35a0: 69 73 20 6f 66 74 65 6e 20 6e 65 63 65 73 73 61 is often necessa
35b0: 72 79 20 74 6f 20 63 61 70 74 75 72 65 20 61 6e ry to capture an
35c0: 64 20 6f 72 20 6d 61 6e 69 70 75 6c 61 74 65 20 d or manipulate
35d0: 65 6e 76 69 72 6f 6e 6d 65 6e 74 0a 76 61 72 69 environment.vari
35e0: 61 62 6c 65 73 2e 20 4d 65 67 61 74 65 73 74 20 ables. Megatest
35f0: 68 61 73 20 73 6f 6d 65 20 66 61 63 69 6c 69 74 has some facilit
3600: 69 65 73 20 62 75 69 6c 74 20 69 6e 20 74 6f 20 ies built in to
3610: 68 65 6c 70 2e 0a 0a 43 61 70 74 75 72 65 20 76 help...Capture v
3620: 61 72 69 61 62 6c 65 73 0a 7e 7e 7e 7e 7e 7e 7e ariables.~~~~~~~
3630: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 43 6f 6d ~~~~~~~~~~...Com
3640: 6d 61 6e 64 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d mands.----------
3650: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3660: 2d 2d 2d 2d 0a 23 20 63 61 70 74 75 72 65 20 74 ----.# capture t
3670: 68 65 20 63 75 72 72 65 6e 74 20 65 6e 76 69 72 he current envir
3680: 6f 6d 65 6e 74 20 69 6e 74 6f 20 61 20 64 62 20 oment into a db
3690: 63 61 6c 6c 65 64 20 65 6e 76 64 61 74 2e 64 62 called envdat.db
36a0: 20 75 6e 64 65 72 0a 23 20 74 68 65 20 63 6f 6e under.# the con
36b0: 74 65 78 74 20 22 62 65 66 6f 72 65 22 0a 6d 65 text "before".me
36c0: 67 61 74 65 73 74 20 2d 65 6e 76 63 61 70 20 62 gatest -envcap b
36d0: 65 66 6f 72 65 0a 0a 23 20 63 61 70 74 75 72 65 efore..# capture
36e0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 65 6e 76 the current env
36f0: 69 72 6f 6e 6d 65 6e 74 20 69 6e 74 6f 20 61 20 ironment into a
3700: 64 62 20 63 61 6c 6c 65 64 20 73 74 61 72 74 75 db called startu
3710: 70 2e 64 62 20 77 69 74 68 20 0a 23 20 63 6f 6e p.db with .# con
3720: 74 65 78 74 20 22 61 66 74 65 72 22 0a 6d 65 67 text "after".meg
3730: 61 74 65 73 74 20 2d 65 6e 76 63 61 70 20 61 66 atest -envcap af
3740: 74 65 72 20 73 74 61 72 74 75 70 2e 64 62 0a 0a ter startup.db..
3750: 23 20 77 72 69 74 65 20 74 68 65 20 64 69 66 66 # write the diff
3760: 20 66 72 6f 6d 20 62 65 66 6f 72 65 20 74 6f 20 from before to
3770: 61 66 74 65 72 0a 6d 65 67 61 74 65 73 74 20 2d after.megatest -
3780: 65 6e 76 64 65 6c 74 61 20 62 65 66 6f 72 65 2d envdelta before-
3790: 61 66 74 65 72 20 2d 64 75 6d 70 6d 6f 64 65 20 after -dumpmode
37a0: 62 61 73 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d bash.-----------
37b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
37c0: 2d 2d 2d 0a 0a 44 75 6d 70 20 6d 6f 64 65 73 20 ---..Dump modes
37d0: 69 6e 63 6c 75 64 65 20 62 61 73 68 2c 20 63 73 include bash, cs
37e0: 68 20 61 6e 64 20 63 6f 6e 66 69 67 2e 20 59 6f h and config. Yo
37f0: 75 20 63 61 6e 20 69 6e 63 6c 75 64 65 20 63 6f u can include co
3800: 6e 66 69 67 20 64 61 74 61 0a 69 6e 74 6f 20 6d nfig data.into m
3810: 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 20 6f egatest.config o
3820: 72 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e r runconfigs.con
3830: 66 69 67 2e 0a 0a 2e 45 78 61 6d 70 6c 65 20 6f fig....Example o
3840: 66 20 67 65 6e 65 72 61 74 69 6e 67 20 61 6e 64 f generating and
3850: 20 75 73 69 6e 67 20 63 6f 6e 66 69 67 20 64 61 using config da
3860: 74 61 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ta.-------------
3870: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3880: 2d 0a 6d 65 67 61 74 65 73 74 20 2d 65 6e 76 63 -.megatest -envc
3890: 61 70 20 6f 72 69 67 69 6e 61 6c 0a 23 20 64 6f ap original.# do
38a0: 20 73 6f 6d 65 20 73 74 75 66 66 20 68 65 72 65 some stuff here
38b0: 0a 6d 65 67 61 74 65 73 74 20 2d 65 6e 76 63 61 .megatest -envca
38c0: 70 20 6d 75 6e 67 65 64 0a 6d 65 67 61 74 65 73 p munged.megates
38d0: 74 20 2d 65 6e 76 64 65 6c 74 61 20 6f 72 69 67 t -envdelta orig
38e0: 69 6e 61 6c 2d 6d 75 6e 67 65 64 20 2d 64 75 6d inal-munged -dum
38f0: 70 6d 6f 64 65 20 69 6e 69 20 2d 6f 20 6d 6f 64 pmode ini -o mod
3900: 69 66 69 65 64 2e 63 6f 6e 66 69 67 0a 2d 2d 2d ified.config.---
3910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3920: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 -----------..The
3930: 6e 20 69 6e 20 72 75 6e 63 6f 6e 66 69 67 73 2e n in runconfigs.
3940: 63 6f 6e 66 69 67 0a 0a 2e 45 78 61 6d 70 6c 65 config...Example
3950: 20 6f 66 20 75 73 69 6e 67 20 6d 6f 64 69 66 69 of using modifi
3960: 65 64 2e 63 6f 6e 66 69 67 20 69 6e 20 61 20 74 ed.config in a t
3970: 65 73 74 63 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d estconfig.------
3980: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3990: 2d 2d 2d 2d 2d 2d 2d 2d 0a 63 61 74 20 74 65 73 --------.cat tes
39a0: 74 63 6f 6e 66 69 67 0a 0a 5b 70 72 65 2d 6c 61 tconfig..[pre-la
39b0: 75 6e 63 68 2d 65 6e 76 2d 76 61 72 73 5d 0a 5b unch-env-vars].[
39c0: 69 6e 63 6c 75 64 65 20 6d 6f 64 69 66 69 65 64 include modified
39d0: 2e 63 6f 6e 66 69 67 5d 0a 2d 2d 2d 2d 2d 2d 2d .config].-------
39e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
39f0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 0a 50 72 6f 67 72 61 -------...Progra
3a00: 6d 6d 69 6e 67 20 41 50 49 0a 2d 2d 2d 2d 2d 2d mming API.------
3a10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 73 65 ---------..These
3a20: 20 72 6f 75 74 69 6e 65 73 20 63 61 6e 20 62 65 routines can be
3a30: 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 called from the
3a40: 20 6d 65 67 61 74 65 73 74 20 72 65 70 6c 2e 20 megatest repl.
3a50: 0a 0a 2e 41 50 49 20 4b 65 79 73 20 52 65 6c 61 ...API Keys Rela
3a60: 74 65 64 20 43 61 6c 6c 73 0a 5b 77 69 64 74 68 ted Calls.[width
3a70: 3d 22 37 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 ="70%",cols="^,2
3a80: 6d 2c 32 6d 2c 32 6d 22 2c 66 72 61 6d 65 3d 22 m,2m,2m",frame="
3a90: 74 6f 70 62 6f 74 22 2c 6f 70 74 69 6f 6e 73 3d topbot",options=
3aa0: 22 68 65 61 64 65 72 2c 66 6f 6f 74 65 72 22 5d "header,footer"]
3ab0: 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d .|==============
3ac0: 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 41 50 49 20 43 61 ========.|API Ca
3ad0: 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ll
3ae0: 20 20 20 20 20 20 20 20 20 20 7c 20 50 75 72 70 | Purp
3af0: 6f 73 65 20 63 6f 6d 6d 65 6e 74 73 20 20 20 7c ose comments |
3b00: 20 52 65 74 75 72 6e 73 20 20 20 20 20 20 20 20 Returns
3b10: 20 20 20 20 20 20 20 20 20 7c 20 43 6f 6d 6d 65 | Comme
3b20: 6e 74 73 0a 7c 28 72 6d 74 3a 67 65 74 2d 6b 65 nts.|(rmt:get-ke
3b30: 79 73 20 72 75 6e 2d 69 64 29 20 20 20 20 20 20 ys run-id)
3b40: 20 20 20 20 20 7c 20 20 20 20 20 20 20 20 20 20 |
3b50: 20 20 20 20 20 20 20 20 20 20 7c 20 28 20 6b 65 | ( ke
3b60: 79 31 20 6b 65 79 32 20 2e 2e 2e 20 29 20 20 20 y1 key2 ... )
3b70: 20 20 20 20 7c 20 0a 7c 20 28 72 6d 74 3a 67 65 | .| (rmt:ge
3b80: 74 2d 6b 65 79 2d 76 61 6c 2d 70 61 69 72 73 20 t-key-val-pairs
3b90: 72 75 6e 2d 69 64 29 20 7c 20 20 20 20 20 20 20 run-id) |
3ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 23 | #
3bb0: 74 3d 73 75 63 63 65 73 73 2f 23 66 3d 66 61 69 t=success/#f=fai
3bc0: 6c 20 20 20 20 20 20 7c 20 57 6f 72 6b 73 20 6f l | Works o
3bd0: 6e 6c 79 20 69 66 20 74 68 65 20 73 65 72 76 65 nly if the serve
3be0: 72 20 69 73 20 73 74 69 6c 6c 20 72 65 61 63 68 r is still reach
3bf0: 61 62 6c 65 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d able.|==========
3c00: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 0a 3a ============...:
3c10: 6e 75 6d 62 65 72 65 64 21 3a 0a 0a numbered!:..