0000: 2f 2f 20 54 68 69 73 20 66 69 6c 65 20 69 73 20 // This file is
0010: 70 61 72 74 20 6f 66 20 4d 65 67 61 74 65 73 74 part of Megatest
0020: 2e 0a 2f 2f 20 0a 2f 2f 20 20 20 20 20 4d 65 67 ..// .// Meg
0030: 61 74 65 73 74 20 69 73 20 66 72 65 65 20 73 6f atest is free so
0040: 66 74 77 61 72 65 3a 20 79 6f 75 20 63 61 6e 20 ftware: you can
0050: 72 65 64 69 73 74 72 69 62 75 74 65 20 69 74 20 redistribute it
0060: 61 6e 64 2f 6f 72 20 6d 6f 64 69 66 79 0a 2f 2f and/or modify.//
0070: 20 20 20 20 20 69 74 20 75 6e 64 65 72 20 74 68 it under th
0080: 65 20 74 65 72 6d 73 20 6f 66 20 74 68 65 20 47 e terms of the G
0090: 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 NU General Publi
00a0: 63 20 4c 69 63 65 6e 73 65 20 61 73 20 70 75 62 c License as pub
00b0: 6c 69 73 68 65 64 20 62 79 0a 2f 2f 20 20 20 20 lished by.//
00c0: 20 74 68 65 20 46 72 65 65 20 53 6f 66 74 77 61 the Free Softwa
00d0: 72 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 65 re Foundation, e
00e0: 69 74 68 65 72 20 76 65 72 73 69 6f 6e 20 33 20 ither version 3
00f0: 6f 66 20 74 68 65 20 4c 69 63 65 6e 73 65 2c 20 of the License,
0100: 6f 72 0a 2f 2f 20 20 20 20 20 28 61 74 20 79 6f or.// (at yo
0110: 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79 20 6c ur option) any l
0120: 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 2f 2f ater version..//
0130: 20 0a 2f 2f 20 20 20 20 20 4d 65 67 61 74 65 73 .// Megates
0140: 74 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 t is distributed
0150: 20 69 6e 20 74 68 65 20 68 6f 70 65 20 74 68 61 in the hope tha
0160: 74 20 69 74 20 77 69 6c 6c 20 62 65 20 75 73 65 t it will be use
0170: 66 75 6c 2c 0a 2f 2f 20 20 20 20 20 62 75 74 20 ful,.// but
0180: 57 49 54 48 4f 55 54 20 41 4e 59 20 57 41 52 52 WITHOUT ANY WARR
0190: 41 4e 54 59 3b 20 77 69 74 68 6f 75 74 20 65 76 ANTY; without ev
01a0: 65 6e 20 74 68 65 20 69 6d 70 6c 69 65 64 20 77 en the implied w
01b0: 61 72 72 61 6e 74 79 20 6f 66 0a 2f 2f 20 20 20 arranty of.//
01c0: 20 20 4d 45 52 43 48 41 4e 54 41 42 49 4c 49 54 MERCHANTABILIT
01d0: 59 20 6f 72 20 46 49 54 4e 45 53 53 20 46 4f 52 Y or FITNESS FOR
01e0: 20 41 20 50 41 52 54 49 43 55 4c 41 52 20 50 55 A PARTICULAR PU
01f0: 52 50 4f 53 45 2e 20 20 53 65 65 20 74 68 65 0a RPOSE. See the.
0200: 2f 2f 20 20 20 20 20 47 4e 55 20 47 65 6e 65 72 // GNU Gener
0210: 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 al Public Licens
0220: 65 20 66 6f 72 20 6d 6f 72 65 20 64 65 74 61 69 e for more detai
0230: 6c 73 2e 0a 2f 2f 20 0a 2f 2f 20 20 20 20 20 59 ls..// .// Y
0240: 6f 75 20 73 68 6f 75 6c 64 20 68 61 76 65 20 72 ou should have r
0250: 65 63 65 69 76 65 64 20 61 20 63 6f 70 79 20 6f eceived a copy o
0260: 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 f the GNU Genera
0270: 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 l Public License
0280: 0a 2f 2f 20 20 20 20 20 61 6c 6f 6e 67 20 77 69 .// along wi
0290: 74 68 20 4d 65 67 61 74 65 73 74 2e 20 20 49 66 th Megatest. If
02a0: 20 6e 6f 74 2c 20 73 65 65 20 3c 68 74 74 70 3a not, see <http:
02b0: 2f 2f 77 77 77 2e 67 6e 75 2e 6f 72 67 2f 6c 69 //www.gnu.org/li
02c0: 63 65 6e 73 65 73 2f 3e 2e 0a 0a 52 65 66 65 72 censes/>...Refer
02d0: 65 6e 63 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a ence.---------..
02e0: 4d 65 67 61 74 65 73 74 20 55 73 65 20 4d 6f 64 Megatest Use Mod
02f0: 65 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e es.~~~~~~~~~~~~~
0300: 7e 7e 7e 7e 7e 0a 0a 2e 42 61 73 65 20 63 6f 6d ~~~~~...Base com
0310: 6d 61 6e 64 73 0a 5b 77 69 64 74 68 3d 22 38 30 mands.[width="80
0320: 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d 2c 32 6d %",cols="^,2m,2m
0330: 22 2c 66 72 61 6d 65 3d 22 74 6f 70 62 6f 74 22 ",frame="topbot"
0340: 2c 6f 70 74 69 6f 6e 73 3d 22 68 65 61 64 65 72 ,options="header
0350: 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d "].|============
0360: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 55 73 65 20 ==========.|Use
0370: 63 61 73 65 09 20 20 20 20 20 20 20 20 20 7c 20 case. |
0380: 4d 65 67 61 74 65 73 74 20 63 6f 6d 6d 61 6e 64 Megatest command
0390: 09 7c 20 20 6d 74 75 74 69 6c 0a 7c 53 74 61 72 .| mtutil.|Star
03a0: 74 20 66 72 6f 6d 20 73 63 72 61 74 63 68 20 20 t from scratch
03b0: 20 20 20 20 20 7c 09 2d 72 65 72 75 6e 2d 61 6c |.-rerun-al
03c0: 6c 09 7c 20 20 72 65 73 74 61 72 74 09 0a 7c 52 l.| restart..|R
03d0: 65 72 75 6e 20 6e 6f 6e 2d 67 6f 6f 64 20 63 6f erun non-good co
03e0: 6d 70 6c 65 74 65 64 20 7c 09 2d 72 65 72 75 6e mpleted |.-rerun
03f0: 2d 63 6c 65 61 6e 09 7c 20 20 72 65 72 75 6e 63 -clean.| rerunc
0400: 6c 65 61 6e 09 0a 7c 52 65 72 75 6e 20 61 6c 6c lean..|Rerun all
0410: 20 6e 6f 6e 2d 67 6f 6f 64 20 61 6e 64 20 6e 6f non-good and no
0420: 74 20 63 6f 6d 70 6c 65 74 65 64 20 79 65 74 20 t completed yet
0430: 7c 20 2d 73 65 74 2d 73 74 61 74 65 2d 73 74 61 | -set-state-sta
0440: 74 75 73 20 4b 49 4c 4c 52 45 51 3b 20 2d 72 65 tus KILLREQ; -re
0450: 72 75 6e 2d 7c 63 6c 65 61 6e 20 7c 20 6b 69 6c run-|clean | kil
0460: 6c 72 65 72 75 6e 09 0a 7c 43 6f 6e 74 69 6e 75 lrerun..|Continu
0470: 65 20 72 75 6e 20 20 20 20 20 20 20 20 20 20 20 e run
0480: 20 20 7c 09 2d 72 75 6e 09 20 20 20 20 20 20 20 |.-run.
0490: 20 7c 20 20 72 65 73 75 6d 65 09 0a 7c 52 65 6d | resume..|Rem
04a0: 6f 76 65 20 72 75 6e 09 20 20 20 20 20 20 20 20 ove run.
04b0: 20 7c 20 20 20 20 20 20 2d 72 65 6d 6f 76 65 2d | -remove-
04c0: 72 75 6e 73 09 7c 20 20 63 6c 65 61 6e 09 0a 7c runs.| clean..|
04d0: 4c 6f 63 6b 20 72 75 6e 09 20 20 20 20 20 20 20 Lock run.
04e0: 20 20 7c 20 20 20 20 20 20 2d 6c 6f 63 6b 09 20 | -lock.
04f0: 20 20 20 20 20 20 20 7c 20 20 6c 6f 63 6b 09 0a | lock..
0500: 7c 55 6e 6c 6f 63 6b 20 72 75 6e 09 20 20 20 20 |Unlock run.
0510: 20 20 20 20 20 7c 20 20 20 20 20 20 2d 75 6e 6c | -unl
0520: 6f 63 6b 09 20 20 20 20 20 20 20 20 7c 20 20 75 ock. | u
0530: 6e 6c 6f 63 6b 09 0a 7c 6b 69 6c 6c 72 75 6e 09 nlock..|killrun.
0540: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0550: 20 7c 20 2d 73 65 74 2d 73 74 61 74 65 2d 73 74 | -set-state-st
0560: 61 74 75 73 20 4b 49 4c 4c 52 45 51 3b 20 2d 6b atus KILLREQ; -k
0570: 69 6c 6c 2d 72 75 6e 09 7c 20 6b 69 6c 6c 72 75 ill-run.| killru
0580: 6e 09 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d n..|============
0590: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 43 6f 6e 66 ==========..Conf
05a0: 69 67 20 46 69 6c 65 20 48 65 6c 70 65 72 73 0a ig File Helpers.
05b0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
05c0: 7e 7e 7e 0a 0a 56 61 72 69 6f 75 73 20 68 65 6c ~~~..Various hel
05d0: 70 65 72 73 20 66 6f 72 20 6d 6f 72 65 20 61 64 pers for more ad
05e0: 76 61 6e 63 65 64 20 63 6f 6e 66 69 67 20 66 69 vanced config fi
05f0: 6c 65 73 2e 0a 0a 2e 48 65 6c 70 65 72 73 0a 5b les....Helpers.[
0600: 77 69 64 74 68 3d 22 38 30 25 22 2c 63 6f 6c 73 width="80%",cols
0610: 3d 22 5e 2c 32 6d 2c 32 6d 2c 32 6d 22 2c 66 72 ="^,2m,2m,2m",fr
0620: 61 6d 65 3d 22 74 6f 70 62 6f 74 22 2c 6f 70 74 ame="topbot",opt
0630: 69 6f 6e 73 3d 22 68 65 61 64 65 72 22 5d 0a 7c ions="header"].|
0640: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0650: 3d 3d 3d 3d 3d 3d 0a 7c 48 65 6c 70 65 72 20 20 ======.|Helper
0660: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0670: 20 20 20 20 7c 20 50 75 72 70 6f 73 65 20 20 20 | Purpose
0680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0690: 20 20 20 20 7c 20 56 61 6c 69 64 20 76 61 6c 75 | Valid valu
06a0: 65 73 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 es |
06b0: 43 6f 6d 6d 65 6e 74 73 0a 7c 20 23 7b 73 63 68 Comments.| #{sch
06c0: 65 6d 65 20 28 73 63 68 65 6d 65 20 63 6f 64 65 eme (scheme code
06d0: 2e 2e 2e 29 7d 20 7c 20 45 78 65 63 75 74 65 20 ...)} | Execute
06e0: 61 72 62 69 74 72 61 72 79 20 73 63 68 65 6d 65 arbitrary scheme
06f0: 20 63 6f 64 65 20 7c 20 41 6e 79 20 76 61 6c 69 code | Any vali
0700: 64 20 73 63 68 65 6d 65 20 20 20 20 20 20 20 20 d scheme
0710: 7c 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 64 | Value returned
0720: 20 66 72 6f 6d 20 74 68 65 20 63 61 6c 6c 20 69 from the call i
0730: 73 20 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 61 s converted to a
0740: 20 73 74 72 69 6e 67 20 61 6e 64 20 70 72 6f 63 string and proc
0750: 65 73 73 65 64 20 61 73 20 70 61 72 74 20 6f 66 essed as part of
0760: 20 74 68 65 20 63 6f 6e 66 69 67 20 66 69 6c 65 the config file
0770: 0a 7c 20 23 7b 73 79 73 74 65 6d 20 63 6f 6d 6d .| #{system comm
0780: 61 6e 64 7d 20 20 20 20 20 20 20 20 20 20 7c 20 and} |
0790: 45 78 65 63 75 74 65 20 70 72 6f 67 72 61 6d 2c Execute program,
07a0: 20 69 6e 73 65 72 74 73 20 65 78 69 74 20 63 6f inserts exit co
07b0: 64 65 20 20 7c 20 41 6e 79 20 76 61 6c 69 64 20 de | Any valid
07c0: 55 6e 69 78 20 63 6f 6d 6d 61 6e 64 20 20 7c 20 Unix command |
07d0: 44 69 73 63 61 72 64 73 20 74 68 65 20 6f 75 74 Discards the out
07e0: 70 75 74 20 66 72 6f 6d 20 74 68 65 20 70 72 6f put from the pro
07f0: 67 72 61 6d 0a 7c 20 23 7b 73 68 65 6c 6c 20 20 gram.| #{shell
0800: 63 6f 6d 6d 61 6e 64 7d 20 6f 72 20 23 7b 73 68 command} or #{sh
0810: 20 2e 2e 2e 7d 20 20 7c 20 45 78 65 63 75 74 65 ...} | Execute
0820: 20 70 72 6f 67 72 61 6d 2c 20 69 6e 73 65 72 74 program, insert
0830: 73 20 72 65 73 75 6c 74 20 66 72 6f 6d 20 73 74 s result from st
0840: 64 6f 75 74 20 7c 20 41 6e 79 20 76 61 6c 69 64 dout | Any valid
0850: 20 55 6e 69 78 20 63 6f 6d 6d 61 6e 64 20 7c 20 Unix command |
0860: 56 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 66 Value returned f
0870: 72 6f 6d 20 74 68 65 20 63 61 6c 6c 20 69 73 20 rom the call is
0880: 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 61 20 73 converted to a s
0890: 74 72 69 6e 67 20 61 6e 64 20 70 72 6f 63 65 73 tring and proces
08a0: 73 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 74 sed as part of t
08b0: 68 65 20 63 6f 6e 66 69 67 20 66 69 6c 65 0a 7c he config file.|
08c0: 20 23 7b 72 65 61 6c 70 61 74 68 20 70 61 74 68 #{realpath path
08d0: 7d 20 6f 72 20 23 7b 72 70 20 2e 2e 2e 7d 20 20 } or #{rp ...}
08e0: 20 7c 20 52 65 70 6c 61 63 65 20 77 69 74 68 20 | Replace with
08f0: 6e 6f 72 6d 61 6c 69 7a 65 64 20 70 61 74 68 20 normalized path
0900: 7c 20 4d 75 73 74 20 62 65 20 61 20 76 61 6c 69 | Must be a vali
0910: 64 20 70 61 74 68 20 7c 0a 7c 20 23 7b 67 65 74 d path |.| #{get
0920: 65 6e 76 20 56 41 52 7d 20 6f 72 20 23 7b 67 76 env VAR} or #{gv
0930: 20 56 41 52 7d 20 20 20 20 20 20 7c 20 52 65 70 VAR} | Rep
0940: 6c 61 63 65 20 77 69 74 68 20 63 6f 6e 74 65 6e lace with conten
0950: 74 20 6f 66 20 65 6e 76 20 76 61 72 69 61 62 6c t of env variabl
0960: 65 20 7c 20 4d 75 73 74 20 62 65 20 61 20 76 61 e | Must be a va
0970: 6c 69 64 20 76 61 72 20 7c 0a 7c 20 23 7b 67 65 lid var |.| #{ge
0980: 74 20 73 20 76 7d 20 6f 72 20 23 7b 67 20 73 20 t s v} or #{g s
0990: 76 7d 20 20 20 20 20 7c 20 52 65 70 6c 61 63 65 v} | Replace
09a0: 20 77 69 74 68 20 76 61 72 69 61 62 6c 65 20 76 with variable v
09b0: 20 66 72 6f 6d 20 73 65 63 74 69 6f 6e 20 73 20 from section s
09c0: 7c 20 56 61 72 69 61 62 6c 65 20 6d 75 73 74 20 | Variable must
09d0: 62 65 20 64 65 66 69 6e 65 64 20 62 65 66 6f 72 be defined befor
09e0: 65 20 75 73 65 20 7c 0a 7c 20 23 7b 72 67 65 74 e use |.| #{rget
09f0: 20 76 7d 20 20 20 20 20 20 20 20 20 20 20 20 20 v}
0a00: 20 20 20 20 20 7c 20 52 65 70 6c 61 63 65 20 77 | Replace w
0a10: 69 74 68 20 76 61 72 69 61 62 6c 65 20 76 20 66 ith variable v f
0a20: 72 6f 6d 20 74 61 72 67 65 74 20 6f 72 20 64 65 rom target or de
0a30: 66 61 75 6c 74 20 6f 66 20 72 75 6e 63 6f 6e 66 fault of runconf
0a40: 69 67 73 20 66 69 6c 65 20 7c 20 7c 0a 7c 20 23 igs file | |.| #
0a50: 7b 6d 74 72 61 68 7d 20 20 20 20 20 20 20 20 20 {mtrah}
0a60: 20 20 20 20 20 20 20 20 20 20 7c 20 52 65 70 6c | Repl
0a70: 61 63 65 20 77 69 74 68 20 74 68 65 20 70 61 74 ace with the pat
0a80: 68 20 74 6f 20 74 68 65 20 6d 65 67 61 74 65 73 h to the megates
0a90: 74 20 74 65 73 74 73 75 69 74 65 20 61 72 65 61 t testsuite area
0aa0: 20 7c 20 7c 20 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d | | .|=========
0ab0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 43 =============..C
0ac0: 6f 6e 66 69 67 20 46 69 6c 65 20 53 65 74 74 69 onfig File Setti
0ad0: 6e 67 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ngs.~~~~~~~~~~~~
0ae0: 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 53 65 74 74 69 6e ~~~~~~~~..Settin
0af0: 67 73 20 69 6e 20 6d 65 67 61 74 65 73 74 2e 63 gs in megatest.c
0b00: 6f 6e 66 69 67 0a 0a 43 6f 6e 66 69 67 20 46 69 onfig..Config Fi
0b10: 6c 65 20 41 64 64 69 74 69 6f 6e 61 6c 20 46 65 le Additional Fe
0b20: 61 74 75 72 65 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e atures.~~~~~~~~~
0b30: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0b40: 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 63 6c 75 64 69 6e ~~~~~~..Includin
0b50: 67 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 61 20 g output from a
0b60: 73 63 72 69 70 74 20 61 73 20 69 66 20 69 74 20 script as if it
0b70: 77 61 73 20 69 6e 6c 69 6e 65 20 74 6f 20 74 68 was inline to th
0b80: 65 20 63 6f 6e 66 69 67 20 66 69 6c 65 3a 0a 0a e config file:..
0b90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0ba0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 63 72 69 70 ---------.[scrip
0bb0: 74 69 6e 63 20 6d 79 73 63 72 69 70 74 2e 73 68 tinc myscript.sh
0bc0: 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ].--------------
0bd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 66 20 -----------..If
0be0: 74 68 65 20 73 63 72 69 70 74 20 6f 75 74 70 75 the script outpu
0bf0: 74 73 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ts:..-----------
0c00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
0c10: 69 74 65 6d 73 5d 0a 41 20 61 20 62 20 63 0a 42 items].A a b c.B
0c20: 20 64 20 65 20 66 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d d e f.---------
0c30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0c40: 0a 0a 54 68 65 6e 20 74 68 65 20 63 6f 6e 66 69 ..Then the confi
0c50: 67 20 66 69 6c 65 20 77 6f 75 6c 64 20 65 66 66 g file would eff
0c60: 65 63 74 69 76 65 6c 79 20 61 70 70 65 61 72 20 ectively appear
0c70: 74 6f 20 63 6f 6e 74 61 69 6e 20 61 6e 20 69 74 to contain an it
0c80: 65 6d 73 20 73 65 63 74 69 6f 6e 0a 65 78 61 63 ems section.exac
0c90: 74 6c 79 20 6c 69 6b 65 20 74 68 65 20 6f 75 74 tly like the out
0ca0: 70 75 74 20 66 72 6f 6d 20 74 68 65 20 73 63 72 put from the scr
0cb0: 69 70 74 2e 20 54 68 69 73 20 69 73 20 75 73 65 ipt. This is use
0cc0: 66 75 6c 20 77 68 65 6e 20 64 79 6e 61 6d 69 63 ful when dynamic
0cd0: 61 6c 6c 79 0a 63 72 65 61 74 69 6e 67 20 69 74 ally.creating it
0ce0: 65 6d 73 2c 20 69 74 65 6d 73 74 61 62 6c 65 73 ems, itemstables
0cf0: 20 61 6e 64 20 6f 74 68 65 72 20 63 6f 6e 66 69 and other confi
0d00: 67 20 73 74 72 75 63 74 75 72 65 73 2e 20 59 6f g structures. Yo
0d10: 75 20 63 61 6e 20 73 65 65 20 74 68 65 0a 65 78 u can see the.ex
0d20: 70 61 6e 73 69 6f 6e 20 6f 66 20 74 68 65 20 63 pansion of the c
0d30: 61 6c 6c 20 62 79 20 6c 6f 6f 6b 69 6e 67 20 69 all by looking i
0d40: 6e 20 74 68 65 20 63 61 63 68 65 64 20 66 69 6c n the cached fil
0d50: 65 73 20 28 6c 6f 6f 6b 20 69 6e 20 79 6f 75 72 es (look in your
0d60: 20 6c 69 6e 6b 74 72 65 65 0a 66 6f 72 20 6d 65 linktree.for me
0d70: 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 20 61 6e gatest.config an
0d80: 64 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e d runconfigs.con
0d90: 66 69 67 20 63 61 63 68 65 20 66 69 6c 65 73 20 fig cache files
0da0: 61 6e 64 20 69 6e 20 79 6f 75 72 20 74 65 73 74 and in your test
0db0: 20 72 75 6e 0a 61 72 65 61 73 20 66 6f 72 20 74 run.areas for t
0dc0: 68 65 20 65 78 70 61 6e 64 65 64 20 61 6e 64 20 he expanded and
0dd0: 63 61 63 68 65 64 20 74 65 73 74 63 6f 6e 66 69 cached testconfi
0de0: 67 29 2e 0a 0a 57 69 6c 64 63 61 72 64 73 20 61 g)...Wildcards a
0df0: 6e 64 20 72 65 67 65 78 65 73 20 69 6e 20 54 61 nd regexes in Ta
0e00: 72 67 65 74 73 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d rgets..---------
0e10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0e20: 0a 5b 61 2f 32 2f 62 5d 0a 56 41 52 31 20 56 41 .[a/2/b].VAR1 VA
0e30: 4c 31 0a 0a 5b 61 2f 25 2f 62 5d 0a 56 41 52 31 L1..[a/%/b].VAR1
0e40: 20 56 41 4c 32 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d VAL2.----------
0e50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
0e60: 0a 57 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 3a .Will result in:
0e70: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
0e80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 61 2f 32 -----------.[a/2
0e90: 2f 62 5d 0a 56 41 52 31 20 56 41 4c 32 0a 2d 2d /b].VAR1 VAL2.--
0ea0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0eb0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 61 6e 20 75 73 65 -------..Can use
0ec0: 20 65 69 74 68 65 72 20 77 69 6c 64 63 61 72 64 either wildcard
0ed0: 20 6f 66 20 22 25 22 20 6f 72 20 61 20 72 65 67 of "%" or a reg
0ee0: 75 6c 61 72 20 65 78 70 72 65 73 73 69 6f 6e 3a ular expression:
0ef0: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
0f00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 2f 61 62 -----------.[/ab
0f10: 63 2e 2a 64 65 66 2f 5d 0a 2d 2d 2d 2d 2d 2d 2d c.*def/].-------
0f20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0f30: 2d 2d 0a 0a 44 69 73 6b 20 53 70 61 63 65 20 43 --..Disk Space C
0f40: 68 65 63 6b 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e hecks.~~~~~~~~~~
0f50: 7e 7e 7e 7e 7e 7e 7e 0a 0a 53 6f 6d 65 20 70 61 ~~~~~~~..Some pa
0f60: 72 61 6d 65 74 65 72 73 20 79 6f 75 20 63 61 6e rameters you can
0f70: 20 70 75 74 20 69 6e 20 74 68 65 20 5b 73 65 74 put in the [set
0f80: 75 70 5d 20 73 65 63 74 69 6f 6e 20 6f 66 20 6d up] section of m
0f90: 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 3a 0a egatest.config:.
0fa0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0fb0: 2d 2d 2d 2d 0a 23 20 6d 69 6e 69 6d 75 6d 20 73 ----.# minimum s
0fc0: 70 61 63 65 20 72 65 71 75 69 72 65 64 20 69 6e pace required in
0fd0: 20 61 20 72 75 6e 20 64 69 73 6b 20 0a 6d 69 6e a run disk .min
0fe0: 73 70 61 63 65 20 31 30 30 30 30 30 30 30 0a 0a space 10000000..
0ff0: 23 20 6d 69 6e 69 6d 75 6d 20 73 70 61 63 65 20 # minimum space
1000: 72 65 71 75 69 72 65 64 20 69 6e 20 64 62 64 69 required in dbdi
1010: 72 3a 0a 64 62 64 69 72 2d 73 70 61 63 65 2d 72 r:.dbdir-space-r
1020: 65 71 75 69 72 65 64 20 31 30 30 30 30 30 0a 0a equired 100000..
1030: 23 20 73 63 72 69 70 74 20 74 68 61 74 20 74 61 # script that ta
1040: 6b 65 73 20 70 61 74 68 20 61 73 20 70 61 72 61 kes path as para
1050: 6d 65 74 65 72 20 61 6e 64 20 72 65 74 75 72 6e meter and return
1060: 73 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 s number of byte
1070: 73 20 61 76 61 69 6c 61 62 6c 65 3a 0a 66 72 65 s available:.fre
1080: 65 2d 73 70 61 63 65 2d 73 63 72 69 70 74 20 63 e-space-script c
1090: 68 65 63 6b 2d 73 70 61 63 65 2e 73 68 0a 2d 2d heck-space.sh.--
10a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
10b0: 2d 0a 0a 54 72 69 6d 20 74 72 61 69 6c 69 6e 67 -..Trim trailing
10c0: 20 73 70 61 63 65 73 0a 7e 7e 7e 7e 7e 7e 7e 7e spaces.~~~~~~~~
10d0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2d 2d ~~~~~~~~~~~~..--
10e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
10f0: 0a 5b 63 6f 6e 66 69 67 66 3a 73 65 74 74 69 6e .[configf:settin
1100: 67 73 20 74 72 69 6d 2d 74 72 61 69 6c 69 6e 67 gs trim-trailing
1110: 2d 73 70 61 63 65 73 20 79 65 73 5d 0a 2d 2d 2d -spaces yes].---
1120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
1130: 0a 4a 6f 62 20 53 75 62 6d 69 73 73 69 6f 6e 20 .Job Submission
1140: 43 6f 6e 74 72 6f 6c 0a 7e 7e 7e 7e 7e 7e 7e 7e Control.~~~~~~~~
1150: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a ~~~~~~~~~~~~~~..
1160: 53 75 62 6d 69 74 20 6a 6f 62 73 20 74 6f 20 48 Submit jobs to H
1170: 6f 73 74 20 54 79 70 65 73 20 62 61 73 65 64 20 ost Types based
1180: 6f 6e 20 54 65 73 74 20 4e 61 6d 65 0a 5e 5e 5e on Test Name.^^^
1190: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
11a0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
11b0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2e 49 6e 20 6d ^^^^^^^^^...In m
11c0: 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 0a 2d egatest.config.-
11d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
11e0: 2d 2d 2d 2d 2d 2d 2d 0a 5b 68 6f 73 74 2d 74 79 -------.[host-ty
11f0: 70 65 73 5d 0a 67 65 6e 65 72 61 6c 20 20 20 6e pes].general n
1200: 62 66 61 6b 65 0a 72 65 6d 6f 74 65 20 20 20 20 bfake.remote
1210: 62 73 75 62 0a 0a 5b 6c 61 75 6e 63 68 65 72 73 bsub..[launchers
1220: 5d 0a 72 75 6e 66 69 72 73 74 2f 73 75 6d 25 20 ].runfirst/sum%
1230: 72 65 6d 6f 74 65 0a 25 20 67 65 6e 65 72 61 6c remote.% general
1240: 0a 0a 5b 6a 6f 62 74 6f 6f 6c 73 5d 0a 6c 61 75 ..[jobtools].lau
1250: 6e 63 68 65 72 20 62 73 75 62 0a 23 20 69 66 20 ncher bsub.# if
1260: 64 65 66 69 6e 65 64 20 61 6e 64 20 6e 6f 74 20 defined and not
1270: 22 6e 6f 22 20 66 6c 65 78 69 2d 6c 61 75 6e 63 "no" flexi-launc
1280: 68 65 72 20 77 69 6c 6c 20 62 79 70 61 73 73 20 her will bypass
1290: 6c 61 75 6e 63 68 65 72 20 75 6e 6c 65 73 73 20 launcher unless
12a0: 0a 23 20 74 68 65 72 65 20 69 73 20 6e 6f 20 68 .# there is no h
12b0: 6f 73 74 2d 74 79 70 65 20 6d 61 74 63 68 2e 0a ost-type match..
12c0: 66 6c 65 78 69 2d 6c 61 75 6e 63 68 65 72 20 79 flexi-launcher y
12d0: 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d es.-------------
12e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 68 6f 73 -----------..hos
12f0: 74 2d 74 79 70 65 73 0a 2b 2b 2b 2b 2b 2b 2b 2b t-types.++++++++
1300: 2b 2b 0a 0a 4c 69 73 74 20 6f 66 20 68 6f 73 74 ++..List of host
1310: 20 74 79 70 65 73 20 61 6e 64 20 74 68 65 20 63 types and the c
1320: 6f 6d 6d 61 6e 64 6c 69 6e 65 20 74 6f 20 72 75 ommandline to ru
1330: 6e 20 61 20 6a 6f 62 20 6f 6e 20 74 68 61 74 20 n a job on that
1340: 68 6f 73 74 20 74 79 70 65 2e 0a 0a 2e 68 6f 73 host type....hos
1350: 74 2d 74 79 70 65 20 3d 3e 20 6c 61 75 6e 63 68 t-type => launch
1360: 20 63 6f 6d 6d 61 6e 64 0a 2d 2d 2d 2d 2d 2d 2d command.-------
1370: 2d 2d 2d 2d 2d 0a 67 65 6e 65 72 61 6c 20 6e 62 -----.general nb
1380: 66 61 6b 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d fake.-----------
1390: 2d 0a 0a 6c 61 75 6e 63 68 65 72 73 0a 2b 2b 2b -..launchers.+++
13a0: 2b 2b 2b 2b 2b 2b 0a 0a 2e 74 65 73 74 2f 69 74 ++++++...test/it
13b0: 65 6d 70 61 74 68 20 3d 3e 20 68 6f 73 74 2d 74 empath => host-t
13c0: 79 70 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ype.------------
13d0: 0a 72 75 6e 66 69 72 73 74 2f 73 75 6d 25 20 72 .runfirst/sum% r
13e0: 65 6d 6f 74 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d emote.----------
13f0: 2d 2d 0a 0a 4d 69 73 63 65 6c 6c 61 6e 65 6f 75 --..Miscellaneou
1400: 73 20 53 65 74 75 70 20 49 74 65 6d 73 0a 2b 2b s Setup Items.++
1410: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ++++++++++++++++
1420: 2b 2b 2b 2b 2b 2b 2b 0a 0a 41 74 74 65 6d 70 74 +++++++..Attempt
1430: 20 74 6f 20 72 65 72 75 6e 20 74 65 73 74 73 20 to rerun tests
1440: 69 6e 20 22 53 54 55 43 4b 2f 44 45 41 44 22 2c in "STUCK/DEAD",
1450: 20 22 6e 2f 61 22 2c 20 22 5a 45 52 4f 5f 49 54 "n/a", "ZERO_IT
1460: 45 4d 53 22 20 73 74 61 74 65 73 2e 0a 0a 2e 49 EMS" states....I
1470: 6e 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 n megatest.confi
1480: 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d g.--------------
1490: 2d 2d 2d 2d 0a 5b 73 65 74 75 70 5d 0a 72 65 72 ----.[setup].rer
14a0: 75 6e 73 20 35 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d uns 5.----------
14b0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 65 70 6c 61 63 --------..Replac
14c0: 65 20 74 68 65 20 64 65 66 61 75 6c 74 20 62 6c e the default bl
14d0: 61 63 6b 6c 69 73 74 65 64 20 65 6e 76 69 72 6f acklisted enviro
14e0: 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73 20 nment variables
14f0: 77 69 74 68 20 75 73 65 72 20 73 75 70 70 6c 69 with user suppli
1500: 65 64 0a 6c 69 73 74 2e 0a 0a 44 65 66 61 75 6c ed.list...Defaul
1510: 74 20 6c 69 73 74 3a 20 55 53 45 52 20 48 4f 4d t list: USER HOM
1520: 45 20 44 49 53 50 4c 41 59 20 4c 53 5f 43 4f 4c E DISPLAY LS_COL
1530: 4f 52 53 20 58 4b 45 59 53 59 4d 44 42 20 45 44 ORS XKEYSYMDB ED
1540: 49 54 4f 52 20 4d 41 4b 45 46 4c 41 47 53 20 4d ITOR MAKEFLAGS M
1550: 41 4b 45 46 20 4d 41 4b 45 4f 56 45 52 52 49 44 AKEF MAKEOVERRID
1560: 45 53 0a 0a 2e 41 64 64 20 61 20 22 62 61 64 22 ES...Add a "bad"
1570: 20 76 61 72 69 61 62 6c 65 20 22 50 52 4f 4d 50 variable "PROMP
1580: 54 22 20 74 6f 20 74 68 65 20 76 61 72 69 61 62 T" to the variab
1590: 6c 65 73 20 74 68 61 74 20 77 69 6c 6c 20 62 65 les that will be
15a0: 20 63 6f 6d 6d 65 6e 74 65 64 20 6f 75 74 0a 69 commented out.i
15b0: 6e 20 74 68 65 20 6d 65 67 61 74 65 73 74 2e 73 n the megatest.s
15c0: 68 20 61 6e 64 20 6d 65 67 61 74 65 73 74 2e 63 h and megatest.c
15d0: 73 68 20 66 69 6c 65 73 3a 0a 2d 2d 2d 2d 2d 2d sh files:.------
15e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 -----------.[set
15f0: 75 70 5d 0a 62 6c 61 63 6b 6c 69 73 74 76 61 72 up].blacklistvar
1600: 73 20 55 53 45 52 20 48 4f 4d 45 20 44 49 53 50 s USER HOME DISP
1610: 4c 41 59 20 4c 53 5f 43 4f 4c 4f 52 53 20 58 4b LAY LS_COLORS XK
1620: 45 59 53 59 4d 44 42 20 45 44 49 54 4f 52 20 4d EYSYMDB EDITOR M
1630: 41 4b 45 46 4c 41 47 53 20 50 52 4f 4d 50 54 0a AKEFLAGS PROMPT.
1640: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1650: 2d 0a 0a 52 75 6e 20 74 69 6d 65 20 6c 69 6d 69 -..Run time limi
1660: 74 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b t.++++++++++++++
1670: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
1680: 2d 2d 2d 0a 5b 73 65 74 75 70 5d 0a 23 20 74 68 ---.[setup].# th
1690: 69 73 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 is will automati
16a0: 63 61 6c 6c 79 20 6b 69 6c 6c 20 74 68 65 20 74 cally kill the t
16b0: 65 73 74 20 69 66 20 69 74 20 72 75 6e 73 20 66 est if it runs f
16c0: 6f 72 20 6d 6f 72 65 20 74 68 61 6e 20 31 68 20 or more than 1h
16d0: 32 6d 20 61 6e 64 20 33 73 0a 72 75 6e 74 69 6d 2m and 3s.runtim
16e0: 65 6c 69 6d 20 31 68 20 32 6d 20 33 73 0a 2d 2d elim 1h 2m 3s.--
16f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
1700: 0a 54 65 73 74 73 20 62 72 6f 77 73 65 72 20 76 .Tests browser v
1710: 69 65 77 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e iew.~~~~~~~~~~~~
1720: 7e 7e 7e 7e 7e 7e 0a 0a 54 68 65 20 74 65 73 74 ~~~~~~..The test
1730: 73 20 62 72 6f 77 73 65 72 20 28 73 65 65 20 74 s browser (see t
1740: 68 65 20 52 75 6e 20 43 6f 6e 74 72 6f 6c 20 74 he Run Control t
1750: 61 62 20 6f 6e 20 74 68 65 20 64 61 73 68 62 6f ab on the dashbo
1760: 61 72 64 29 20 68 61 73 20 74 77 6f 20 76 69 65 ard) has two vie
1770: 77 73 20 66 6f 72 20 64 69 73 70 6c 61 79 69 6e ws for displayin
1780: 67 20 74 68 65 20 74 65 73 74 73 2e 20 0a 0a 2e g the tests. ...
1790: 20 44 6f 74 20 28 67 72 61 70 68 76 69 7a 29 20 Dot (graphviz)
17a0: 62 61 73 65 64 20 74 72 65 65 0a 2e 20 4e 6f 20 based tree.. No
17b0: 64 6f 74 2c 20 70 6c 61 69 6e 20 6c 69 73 74 69 dot, plain listi
17c0: 6e 67 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 20 ng..The default
17d0: 69 73 20 74 68 65 20 67 72 61 70 68 76 69 7a 20 is the graphviz
17e0: 62 61 73 65 64 20 74 72 65 65 20 62 75 74 20 69 based tree but i
17f0: 66 20 79 6f 75 72 20 74 65 73 74 73 20 64 6f 6e f your tests don
1800: 27 74 20 76 69 65 77 0a 77 65 6c 6c 20 69 6e 20 't view.well in
1810: 74 68 61 74 20 6d 6f 64 65 20 74 68 65 6e 20 75 that mode then u
1820: 73 65 20 22 6e 6f 64 6f 74 22 20 74 6f 20 74 75 se "nodot" to tu
1830: 72 6e 20 69 74 20 6f 66 66 2e 0a 0a 2d 2d 2d 2d rn it off...----
1840: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 -------------.[s
1850: 65 74 75 70 5d 0a 6e 6f 64 6f 74 0a 2d 2d 2d 2d etup].nodot.----
1860: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 -------------..C
1870: 61 70 74 75 72 69 6e 67 20 54 65 73 74 20 44 61 apturing Test Da
1880: 74 61 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ta.~~~~~~~~~~~~~
1890: 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 20 61 20 74 65 73 ~~~~~~..In a tes
18a0: 74 20 79 6f 75 20 63 61 6e 20 63 61 70 74 75 72 t you can captur
18b0: 65 20 61 72 62 69 74 72 61 72 79 20 76 61 72 69 e arbitrary vari
18c0: 61 62 6c 65 73 20 61 6e 64 20 72 6f 6c 6c 20 74 ables and roll t
18d0: 68 65 6d 20 75 70 20 69 6e 20 74 68 65 0a 6d 65 hem up in the.me
18e0: 67 61 74 65 73 74 20 64 61 74 61 62 61 73 65 20 gatest database
18f0: 66 6f 72 20 76 69 65 77 69 6e 67 20 6f 6e 20 74 for viewing on t
1900: 68 65 20 64 61 73 68 62 6f 61 72 64 20 6f 72 20 he dashboard or
1910: 77 65 62 20 61 70 70 2e 0a 0a 2e 49 6e 20 61 20 web app....In a
1920: 74 65 73 74 20 61 73 20 61 20 73 63 72 69 70 74 test as a script
1930: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
1940: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 24 4d 54 5f 4d 45 ---------.$MT_ME
1950: 47 41 54 45 53 54 20 2d 6c 6f 61 64 2d 74 65 73 GATEST -load-tes
1960: 74 2d 64 61 74 61 20 3c 3c 20 45 4f 46 0a 66 6f t-data << EOF.fo
1970: 6f 2c 62 61 72 2c 20 20 20 31 2e 32 2c 20 20 31 o,bar, 1.2, 1
1980: 2e 39 2c 20 3e 0a 66 6f 6f 2c 72 61 62 2c 20 31 .9, >.foo,rab, 1
1990: 2e 30 65 39 2c 20 31 30 65 39 2c 20 31 65 39 0a .0e9, 10e9, 1e9.
19a0: 66 6f 6f 2c 62 6c 61 2c 20 20 20 31 2e 32 2c 20 foo,bla, 1.2,
19b0: 20 31 2e 39 2c 20 3c 0a 66 6f 6f 2c 62 61 6c 2c 1.9, <.foo,bal,
19c0: 20 20 20 31 2e 32 2c 20 20 31 2e 32 2c 20 3c 20 1.2, 1.2, <
19d0: 20 20 2c 20 20 20 20 20 2c 43 68 65 63 6b 20 66 , ,Check f
19e0: 6f 72 20 6f 76 65 72 6c 6f 61 64 0a 66 6f 6f 2c or overload.foo,
19f0: 61 6c 62 2c 20 20 20 31 2e 32 2c 20 20 31 2e 32 alb, 1.2, 1.2
1a00: 2c 20 3c 3d 20 20 2c 20 41 6d 70 73 2c 54 68 69 , <= , Amps,Thi
1a10: 73 20 69 73 20 74 68 65 20 68 69 67 68 20 70 6f s is the high po
1a20: 77 65 72 20 63 69 72 63 75 69 74 20 74 65 73 74 wer circuit test
1a30: 0a 66 6f 6f 2c 61 62 6c 2c 20 20 20 31 2e 32 2c .foo,abl, 1.2,
1a40: 20 20 31 2e 33 2c 20 30 2e 31 0a 66 6f 6f 2c 62 1.3, 0.1.foo,b
1a50: 72 61 2c 20 20 20 31 2e 32 2c 20 70 61 73 73 2c ra, 1.2, pass,
1a60: 20 73 69 6c 6c 79 20 73 74 75 66 66 0a 66 61 7a silly stuff.faz
1a70: 2c 62 61 72 2c 20 20 20 20 31 30 2c 20 20 38 6d ,bar, 10, 8m
1a80: 41 2c 20 20 20 20 20 2c 20 20 20 20 20 2c 22 74 A, , ,"t
1a90: 68 69 73 20 69 73 20 61 20 63 6f 6d 6d 65 6e 74 his is a comment
1aa0: 22 0a 45 4f 46 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ".EOF.----------
1ab0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
1ac0: 41 6c 74 65 72 6e 61 74 69 76 65 6c 79 20 79 6f Alternatively yo
1ad0: 75 20 63 61 6e 20 75 73 65 20 6c 6f 67 70 72 6f u can use logpro
1ae0: 20 74 72 69 67 67 65 72 73 20 74 6f 20 63 61 70 triggers to cap
1af0: 74 75 72 65 20 76 61 6c 75 65 73 20 61 6e 64 20 ture values and
1b00: 69 6e 6a 65 63 74 20 74 68 65 6d 0a 69 6e 74 6f inject them.into
1b10: 20 6d 65 67 61 74 65 73 74 20 75 73 69 6e 67 20 megatest using
1b20: 74 68 65 20 2d 73 65 74 2d 76 61 6c 75 65 73 20 the -set-values
1b30: 6d 65 63 68 61 6e 69 73 6d 3a 0a 0a 2e 4d 65 67 mechanism:...Meg
1b40: 61 74 65 73 74 20 68 65 6c 70 20 72 65 6c 61 74 atest help relat
1b50: 65 64 20 74 6f 20 2d 73 65 74 2d 76 61 6c 75 65 ed to -set-value
1b60: 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d s.--------------
1b70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 54 65 73 74 20 ----------.Test
1b80: 64 61 74 61 20 63 61 70 74 75 72 65 0a 20 20 2d data capture. -
1b90: 73 65 74 2d 76 61 6c 75 65 73 20 20 20 20 20 20 set-values
1ba0: 20 20 20 20 20 20 20 3a 20 75 70 64 61 74 65 20 : update
1bb0: 6f 72 20 73 65 74 20 76 61 6c 75 65 73 20 69 6e or set values in
1bc0: 20 74 68 65 20 74 65 73 74 64 61 74 61 20 74 61 the testdata ta
1bd0: 62 6c 65 0a 20 20 3a 63 61 74 65 67 6f 72 79 20 ble. :category
1be0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 :
1bf0: 73 65 74 20 74 68 65 20 63 61 74 65 67 6f 72 79 set the category
1c00: 20 66 69 65 6c 64 20 28 6f 70 74 69 6f 6e 61 6c field (optional
1c10: 29 0a 20 20 3a 76 61 72 69 61 62 6c 65 20 20 20 ). :variable
1c20: 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 73 65 : se
1c30: 74 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 6e t the variable n
1c40: 61 6d 65 20 28 6f 70 74 69 6f 6e 61 6c 29 0a 20 ame (optional).
1c50: 20 3a 76 61 6c 75 65 20 20 20 20 20 20 20 20 20 :value
1c60: 20 20 20 20 20 20 20 20 20 3a 20 76 61 6c 75 65 : value
1c70: 20 6d 65 61 73 75 72 65 64 20 28 72 65 71 75 69 measured (requi
1c80: 72 65 64 29 0a 20 20 3a 65 78 70 65 63 74 65 64 red). :expected
1c90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a :
1ca0: 20 76 61 6c 75 65 20 65 78 70 65 63 74 65 64 20 value expected
1cb0: 28 72 65 71 75 69 72 65 64 29 0a 20 20 3a 74 6f (required). :to
1cc0: 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l
1cd0: 20 20 20 20 20 3a 20 7c 76 61 6c 75 65 2d 65 78 : |value-ex
1ce0: 70 65 63 74 7c 20 3c 3d 20 74 6f 6c 20 28 72 65 pect| <= tol (re
1cf0: 71 75 69 72 65 64 2c 20 63 61 6e 20 62 65 20 3c quired, can be <
1d00: 2c 20 3e 2c 20 3e 3d 2c 20 3c 3d 20 6f 72 20 6e , >, >=, <= or n
1d10: 75 6d 62 65 72 29 0a 20 20 3a 75 6e 69 74 73 20 umber). :units
1d20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d30: 20 3a 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 75 : name of the u
1d40: 6e 69 74 73 20 66 6f 72 20 76 61 6c 75 65 2c 20 nits for value,
1d50: 65 78 70 65 63 74 65 64 5f 76 61 6c 75 65 20 65 expected_value e
1d60: 74 63 2e 20 28 6f 70 74 69 6f 6e 61 6c 29 0a 2d tc. (optional).-
1d70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1d80: 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 61 73 68 62 6f 61 -------..Dashboa
1d90: 72 64 20 73 65 74 74 69 6e 67 73 0a 7e 7e 7e 7e rd settings.~~~~
1da0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a ~~~~~~~~~~~~~~..
1db0: 2e 52 75 6e 73 20 74 61 62 20 62 75 74 74 6f 6e .Runs tab button
1dc0: 73 2c 20 66 6f 6e 74 20 61 6e 64 20 73 69 7a 65 s, font and size
1dd0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
1de0: 2d 2d 2d 0a 5b 64 61 73 68 62 6f 61 72 64 5d 0a ---.[dashboard].
1df0: 62 74 6e 2d 68 65 69 67 68 74 20 78 31 34 0a 62 btn-height x14.b
1e00: 74 6e 2d 66 6f 6e 74 73 7a 20 31 30 0a 63 65 6c tn-fontsz 10.cel
1e10: 6c 2d 77 69 64 74 68 20 36 30 0a 2d 2d 2d 2d 2d l-width 60.-----
1e20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 -------------..D
1e30: 61 74 61 62 61 73 65 20 73 65 74 74 69 6e 67 73 atabase settings
1e40: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e .~~~~~~~~~~~~~~~
1e50: 7e 7e 0a 0a 2e 44 61 74 61 62 61 73 65 20 63 6f ~~...Database co
1e60: 6e 66 69 67 20 73 65 74 74 69 6e 67 73 20 69 6e nfig settings in
1e70: 20 5b 73 65 74 75 70 5d 20 73 65 63 74 69 6f 6e [setup] section
1e80: 20 6f 66 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e of megatest.con
1e90: 66 69 67 0a 5b 77 69 64 74 68 3d 22 37 30 25 22 fig.[width="70%"
1ea0: 2c 63 6f 6c 73 3d 22 5e 2c 32 6d 2c 32 6d 2c 32 ,cols="^,2m,2m,2
1eb0: 6d 22 2c 66 72 61 6d 65 3d 22 74 6f 70 62 6f 74 m",frame="topbot
1ec0: 22 2c 6f 70 74 69 6f 6e 73 3d 22 68 65 61 64 65 ",options="heade
1ed0: 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d r"].|===========
1ee0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 56 61 72 ===========.|Var
1ef0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f00: 20 20 20 20 20 20 20 7c 20 50 75 72 70 6f 73 65 | Purpose
1f10: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 56 61 | Va
1f20: 6c 69 64 20 76 61 6c 75 65 73 20 20 20 20 20 20 lid values
1f30: 20 20 20 20 20 20 7c 20 43 6f 6d 6d 65 6e 74 73 | Comments
1f40: 0a 7c 64 65 6c 61 79 2d 6f 6e 2d 62 75 73 79 20 .|delay-on-busy
1f50: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 50 72 | Pr
1f60: 65 76 65 6e 74 20 63 6f 6e 63 75 72 72 65 6e 74 event concurrent
1f70: 20 61 63 63 65 73 73 20 69 73 73 75 65 73 20 7c access issues |
1f80: 20 79 65 73 5c 7c 6e 6f 20 6f 72 20 6e 6f 74 20 yes\|no or not
1f90: 64 65 66 69 6e 65 64 20 7c 20 44 65 66 61 75 6c defined | Defaul
1fa0: 74 3d 6e 6f 2c 20 6d 61 79 20 68 65 6c 70 20 6f t=no, may help o
1fb0: 6e 20 73 6f 6d 65 20 6e 65 74 77 6f 72 6b 20 66 n some network f
1fc0: 69 6c 65 20 73 79 73 74 65 6d 73 2c 20 6d 61 79 ile systems, may
1fd0: 20 73 6c 6f 77 20 74 68 69 6e 67 73 20 64 6f 77 slow things dow
1fe0: 6e 20 61 6c 73 6f 2e 0a 7c 66 61 73 74 73 74 61 n also..|faststa
1ff0: 72 74 09 09 20 20 20 7c 20 41 6c 6c 20 64 69 72 rt.. | All dir
2000: 65 63 74 20 66 69 6c 65 20 61 63 63 65 73 73 20 ect file access
2010: 74 6f 20 73 71 6c 69 74 65 20 64 62 20 66 69 6c to sqlite db fil
2020: 65 73 20 7c 20 79 65 73 5c 7c 6e 6f 20 6f 72 20 es | yes\|no or
2030: 6e 6f 74 20 64 65 66 69 6e 65 64 20 7c 20 44 65 not defined | De
2040: 66 61 75 6c 74 3d 79 65 73 2c 20 73 75 67 67 65 fault=yes, sugge
2050: 73 74 20 6e 6f 20 66 6f 72 20 63 65 6e 74 72 61 st no for centra
2060: 6c 20 61 75 74 6f 6d 61 74 65 64 20 73 79 73 74 l automated syst
2070: 65 6d 73 20 61 6e 64 20 79 65 73 20 66 6f 72 20 ems and yes for
2080: 69 6e 74 65 72 61 63 74 69 76 65 20 75 73 65 0a interactive use.
2090: 7c 68 6f 6d 65 68 6f 73 74 20 09 09 20 20 20 7c |homehost .. |
20a0: 20 53 74 61 72 74 20 73 65 72 76 65 72 73 20 6f Start servers o
20b0: 6e 20 74 68 69 73 20 68 6f 73 74 20 7c 20 3c 68 n this host | <h
20c0: 6f 73 74 6e 61 6d 65 3e 20 7c 20 44 65 66 61 75 ostname> | Defau
20d0: 6c 74 73 20 74 6f 20 6c 6f 63 61 6c 20 68 6f 73 lts to local hos
20e0: 74 0a 7c 68 6f 73 74 6e 61 6d 65 09 09 20 20 20 t.|hostname..
20f0: 7c 20 48 6f 73 74 6e 61 6d 65 20 74 6f 20 62 69 | Hostname to bi
2100: 6e 64 20 74 6f 20 7c 20 3c 68 6f 73 74 6e 61 6d nd to | <hostnam
2110: 65 3e 5c 7c 2d 09 20 20 7c 20 4f 6e 20 6d 75 6c e>\|-. | On mul
2120: 74 69 2d 68 6f 6d 65 64 20 68 6f 73 74 73 20 61 ti-homed hosts a
2130: 6c 6c 6f 77 73 20 62 69 6e 64 69 6e 67 20 74 6f llows binding to
2140: 20 73 70 65 63 69 66 69 63 20 68 6f 73 74 6e 61 specific hostna
2150: 6d 65 0a 7c 6c 6f 77 70 6f 72 74 09 09 20 20 20 me.|lowport..
2160: 7c 20 53 74 61 72 74 20 73 65 61 72 63 68 69 6e | Start searchin
2170: 67 20 66 6f 72 20 61 20 70 6f 72 74 20 61 74 20 g for a port at
2180: 74 68 69 73 20 70 6f 72 74 6e 75 6d 7c 20 33 32 this portnum| 32
2190: 37 36 38 20 7c 20 0a 7c 72 65 71 75 69 72 65 64 768 | .|required
21a0: 09 09 20 20 20 7c 20 53 65 72 76 65 72 20 72 65 .. | Server re
21b0: 71 75 69 72 65 64 20 20 20 20 7c 20 79 65 73 5c quired | yes\
21c0: 7c 6e 6f 20 6f 72 20 6e 6f 74 20 64 65 66 69 6e |no or not defin
21d0: 65 64 20 20 7c 20 44 65 66 61 75 6c 74 3d 6e 6f ed | Default=no
21e0: 2c 20 66 6f 72 63 65 20 73 74 61 72 74 20 6f 66 , force start of
21f0: 20 73 65 72 76 65 72 20 61 6c 77 61 79 73 0a 7c server always.|
2200: 73 65 72 76 65 72 2d 71 75 65 72 79 2d 74 68 72 server-query-thr
2210: 65 73 68 6f 6c 64 09 20 20 20 7c 20 53 74 61 72 eshold. | Star
2220: 74 20 73 65 72 76 65 72 20 77 68 65 6e 20 71 75 t server when qu
2230: 65 72 69 65 73 20 74 61 6b 65 20 6c 6f 6e 67 65 eries take longe
2240: 72 20 74 68 61 6e 20 74 68 69 73 20 7c 20 6e 75 r than this | nu
2250: 6d 62 65 72 20 69 6e 20 6d 69 6c 6c 69 73 65 63 mber in millisec
2260: 6f 6e 64 73 20 7c 20 44 65 66 61 75 6c 74 3d 33 onds | Default=3
2270: 30 30 0a 7c 74 69 6d 65 6f 75 74 09 09 20 20 20 00.|timeout..
2280: 7c 20 68 74 74 70 20 61 70 69 20 74 69 6d 65 6f | http api timeo
2290: 75 74 20 09 7c 20 6e 75 6d 62 65 72 20 69 6e 20 ut .| number in
22a0: 68 6f 75 72 73 09 20 20 7c 20 44 65 66 61 75 6c hours. | Defaul
22b0: 74 20 69 73 20 31 20 6d 69 6e 75 74 65 2c 20 64 t is 1 minute, d
22c0: 6f 20 6e 6f 74 20 63 68 61 6e 67 65 0a 7c 3d 3d o not change.|==
22d0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
22e0: 3d 3d 3d 3d 0a 0a 54 68 65 20 74 65 73 74 63 6f ====..The testco
22f0: 6e 66 69 67 20 46 69 6c 65 0a 2d 2d 2d 2d 2d 2d nfig File.------
2300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 -------------..S
2310: 65 74 75 70 20 73 65 63 74 69 6f 6e 0a 7e 7e 7e etup section.~~~
2320: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 48 65 61 64 ~~~~~~~~~~..Head
2330: 65 72 0a 5e 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d er.^^^^^^..-----
2340: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
2350: 73 65 74 75 70 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d setup].---------
2360: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 20 ----------..The
2370: 72 75 6e 73 63 72 69 70 74 20 6d 65 74 68 6f 64 runscript method
2380: 20 69 73 20 61 20 62 72 75 74 65 20 66 6f 72 63 is a brute forc
2390: 65 20 77 61 79 20 74 6f 20 72 75 6e 20 73 63 72 e way to run scr
23a0: 69 70 74 73 20 77 68 65 72 65 20 74 68 65 0a 75 ipts where the.u
23b0: 73 65 72 20 69 73 20 72 65 73 70 6f 6e 73 69 62 ser is responsib
23c0: 6c 65 20 66 6f 72 20 73 65 74 74 69 6e 67 20 53 le for setting S
23d0: 54 41 54 45 20 61 6e 64 20 53 54 41 54 55 53 0a TATE and STATUS.
23e0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
23f0: 2d 2d 2d 2d 0a 72 75 6e 73 63 72 69 70 74 20 6d ----.runscript m
2400: 61 69 6e 2e 63 73 68 0a 2d 2d 2d 2d 2d 2d 2d 2d ain.csh.--------
2410: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 74 65 -----------..Ite
2420: 72 61 74 69 6f 6e 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e ration.~~~~~~~~~
2430: 0a 0a 2e 53 65 63 74 69 6f 6e 73 20 66 6f 72 20 ...Sections for
2440: 69 74 65 72 61 74 69 6f 6e 0a 2d 2d 2d 2d 2d 2d iteration.------
2450: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 66 ------------.# f
2460: 75 6c 6c 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 ull combinations
2470: 0a 5b 69 74 65 6d 73 5d 0a 41 20 78 20 79 0a 42 .[items].A x y.B
2480: 20 31 20 32 0a 0a 23 20 59 69 65 6c 64 73 3a 20 1 2..# Yields:
2490: 78 2f 31 20 78 2f 32 20 79 2f 31 20 79 2f 32 0a x/1 x/2 y/1 y/2.
24a0: 0a 23 20 74 61 62 6c 65 64 0a 5b 69 74 65 6d 73 .# tabled.[items
24b0: 74 61 62 6c 65 5d 0a 41 20 78 20 79 0a 42 20 31 table].A x y.B 1
24c0: 20 32 0a 0a 23 20 59 69 65 6c 64 73 20 78 2f 31 2..# Yields x/1
24d0: 20 79 2f 32 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d y/2.-----------
24e0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 0a 52 65 71 75 69 72 -------...Requir
24f0: 65 6d 65 6e 74 73 20 73 65 63 74 69 6f 6e 0a 7e ements section.~
2500: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
2510: 7e 7e 7e 0a 0a 2e 48 65 61 64 65 72 0a 2d 2d 2d ~~~...Header.---
2520: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2530: 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a .[requirements].
2540: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2550: 2d 2d 2d 0a 0a 57 61 69 74 20 6f 6e 20 4f 74 68 ---..Wait on Oth
2560: 65 72 20 54 65 73 74 73 0a 7e 7e 7e 7e 7e 7e 7e er Tests.~~~~~~~
2570: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2d 2d ~~~~~~~~~~~~..--
2580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2590: 2d 0a 23 20 41 20 6e 6f 72 6d 61 6c 20 77 61 69 -.# A normal wai
25a0: 74 6f 6e 20 77 61 69 74 73 20 66 6f 72 20 74 68 ton waits for th
25b0: 65 20 70 72 69 6f 72 20 74 65 73 74 73 20 74 6f e prior tests to
25c0: 20 62 65 20 43 4f 4d 50 4c 45 54 45 44 20 0a 23 be COMPLETED .#
25d0: 20 61 6e 64 20 50 41 53 53 2c 20 43 48 45 43 4b and PASS, CHECK
25e0: 20 6f 72 20 57 41 49 56 45 44 0a 77 61 69 74 6f or WAIVED.waito
25f0: 6e 20 74 65 73 74 31 20 74 65 73 74 32 0a 2d 2d n test1 test2.--
2600: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2610: 2d 0a 0a 4d 6f 64 65 0a 7e 7e 7e 7e 0a 0a 54 68 -..Mode.~~~~..Th
2620: 65 20 64 65 66 61 75 6c 74 20 28 69 2e 65 2e 20 e default (i.e.
2630: 69 66 20 6d 6f 64 65 20 69 73 20 6e 6f 74 20 73 if mode is not s
2640: 70 65 63 69 66 69 65 64 29 20 69 73 20 6e 6f 72 pecified) is nor
2650: 6d 61 6c 2e 20 41 6c 6c 20 70 72 65 2d 64 65 70 mal. All pre-dep
2660: 65 6e 64 65 6e 74 20 74 65 73 74 73 0a 6d 75 73 endent tests.mus
2670: 74 20 62 65 20 43 4f 4d 50 4c 45 54 45 44 20 61 t be COMPLETED a
2680: 6e 64 20 50 41 53 53 2c 20 43 48 45 43 4b 20 6f nd PASS, CHECK o
2690: 72 20 57 41 49 56 45 44 20 62 65 66 6f 72 65 20 r WAIVED before
26a0: 74 68 65 20 74 65 73 74 20 77 69 6c 6c 20 73 74 the test will st
26b0: 61 72 74 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d art..-----------
26c0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 --------.[requir
26d0: 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 20 20 6e ements].mode n
26e0: 6f 72 6d 61 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ormal.----------
26f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 20 74 ---------..The t
2700: 6f 70 6c 65 76 65 6c 20 6d 6f 64 65 20 72 65 71 oplevel mode req
2710: 75 69 72 65 73 20 6f 6e 6c 79 20 74 68 61 74 20 uires only that
2720: 74 68 65 20 70 72 69 6f 72 20 74 65 73 74 73 20 the prior tests
2730: 61 72 65 20 43 4f 4d 50 4c 45 54 45 44 2e 0a 0a are COMPLETED...
2740: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2750: 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 ---.[requirement
2760: 73 5d 0a 6d 6f 64 65 20 74 6f 70 6c 65 76 65 6c s].mode toplevel
2770: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
2780: 2d 2d 2d 2d 0a 0a 41 20 69 74 65 6d 20 62 61 73 ----..A item bas
2790: 65 64 20 77 61 69 74 6f 6e 20 77 69 6c 6c 20 73 ed waiton will s
27a0: 74 61 72 74 20 69 74 65 6d 73 20 69 6e 20 61 20 tart items in a
27b0: 74 65 73 74 20 77 68 65 6e 20 74 68 65 20 73 61 test when the sa
27c0: 6d 65 2d 6e 61 6d 65 64 0a 69 74 65 6d 20 69 73 me-named.item is
27d0: 20 43 4f 4d 50 4c 45 54 45 44 20 61 6e 64 20 50 COMPLETED and P
27e0: 41 53 53 2c 20 43 48 45 43 4b 20 6f 72 20 57 41 ASS, CHECK or WA
27f0: 49 56 45 44 20 69 6e 20 74 68 65 20 70 72 69 6f IVED in the prio
2800: 72 20 74 65 73 74 2e 20 54 68 69 73 0a 77 61 73 r test. This.was
2810: 20 68 69 73 74 6f 72 69 63 61 6c 6c 79 20 63 61 historically ca
2820: 6c 6c 65 64 20 22 69 74 65 6d 77 61 69 74 22 20 lled "itemwait"
2830: 6d 6f 64 65 2e 20 54 68 65 20 74 65 72 6d 73 20 mode. The terms
2840: 22 69 74 65 6d 77 61 69 74 22 20 61 6e 64 0a 22 "itemwait" and."
2850: 69 74 65 6d 6d 61 74 63 68 22 20 61 72 65 20 73 itemmatch" are s
2860: 79 6e 6f 6e 79 6d 73 2e 0a 0a 2d 2d 2d 2d 2d 2d ynonyms...------
2870: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 -------------.[r
2880: 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 equirements].mod
2890: 65 20 69 74 65 6d 6d 61 74 63 68 0a 2d 2d 2d 2d e itemmatch.----
28a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
28b0: 0a 4f 76 65 72 72 69 64 69 6e 67 20 45 6e 76 69 .Overriding Envi
28c0: 72 6f 6d 65 6e 74 20 56 61 72 69 61 62 6c 65 73 roment Variables
28d0: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e .~~~~~~~~~~~~~~~
28e0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
28f0: 0a 0a 4f 76 65 72 72 69 64 65 20 76 61 72 69 61 ..Override varia
2900: 62 6c 65 73 20 62 65 66 6f 72 65 20 73 74 61 72 bles before star
2910: 74 69 6e 67 20 74 68 65 20 74 65 73 74 2e 20 43 ting the test. C
2920: 61 6e 20 69 6e 63 6c 75 64 65 20 66 69 6c 65 73 an include files
2930: 20 28 70 65 72 68 61 70 73 20 67 65 6e 65 72 61 (perhaps genera
2940: 74 65 64 20 62 79 20 6d 65 67 61 74 65 73 74 20 ted by megatest
2950: 2d 65 6e 76 64 65 6c 74 61 20 6f 72 20 73 69 6d -envdelta or sim
2960: 69 6c 61 72 29 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d ilar)...--------
2970: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 70 72 ------------.[pr
2980: 65 2d 6c 61 75 6e 63 68 2d 65 6e 76 2d 76 61 72 e-launch-env-var
2990: 73 5d 0a 56 41 52 31 20 76 61 6c 75 65 31 0a 0a s].VAR1 value1..
29a0: 23 20 47 65 74 20 73 6f 6d 65 20 67 65 6e 65 72 # Get some gener
29b0: 61 74 65 64 20 73 65 74 74 69 6e 67 73 0a 5b 69 ated settings.[i
29c0: 6e 63 6c 75 64 65 20 2e 2e 2f 67 65 6e 65 72 61 nclude ../genera
29d0: 74 65 64 2d 76 61 72 73 2e 63 6f 6e 66 69 67 5d ted-vars.config]
29e0: 0a 0a 23 20 55 73 65 20 74 68 69 73 20 74 72 69 ..# Use this tri
29f0: 63 6b 20 74 6f 20 75 6e 73 65 74 20 76 61 72 69 ck to unset vari
2a00: 61 62 6c 65 73 0a 23 7b 73 63 68 65 6d 65 20 28 ables.#{scheme (
2a10: 75 6e 73 65 74 65 6e 76 20 22 46 4f 4f 42 41 52 unsetenv "FOOBAR
2a20: 22 29 7d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ")}.------------
2a30: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 74 65 6d 6d 61 --------..Itemma
2a40: 70 20 48 61 6e 64 6c 69 6e 67 0a 7e 7e 7e 7e 7e p Handling.~~~~~
2a50: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 46 6f 72 ~~~~~~~~~~~..For
2a60: 20 63 61 73 65 73 20 77 65 72 65 20 74 68 65 20 cases were the
2a70: 64 65 70 65 6e 64 65 6e 74 20 74 65 73 74 20 68 dependent test h
2a80: 61 73 20 61 20 73 69 6d 69 6c 61 72 20 62 75 74 as a similar but
2a90: 20 6e 6f 74 20 69 64 65 6e 74 69 63 61 6c 0a 69 not identical.i
2aa0: 74 65 6d 70 61 74 68 20 74 6f 20 74 68 65 20 64 tempath to the d
2ab0: 6f 77 6e 73 74 72 65 61 6d 20 74 65 73 74 20 61 ownstream test a
2ac0: 6e 20 69 74 65 6d 6d 61 70 20 63 61 6e 20 61 6c n itemmap can al
2ad0: 6c 6f 77 20 66 6f 72 20 69 74 65 6d 6d 61 74 63 low for itemmatc
2ae0: 68 0a 6d 6f 64 65 0a 0a 2e 65 78 61 6d 70 6c 65 h.mode...example
2af0: 20 66 6f 72 20 72 65 6d 6f 76 69 6e 67 20 70 61 for removing pa
2b00: 72 74 20 6f 66 20 69 74 65 6d 6d 61 70 20 66 6f rt of itemmap fo
2b10: 72 20 77 61 69 74 6f 6e 20 74 65 73 74 20 28 65 r waiton test (e
2b20: 67 3a 20 69 74 65 6d 20 2b 66 6f 6f 2d 78 2f 62 g: item +foo-x/b
2b30: 61 72 2b 20 64 65 70 65 6e 64 73 20 6f 6e 20 77 ar+ depends on w
2b40: 61 69 74 6f 6e 27 73 20 69 74 65 6d 20 2b 79 2f aiton's item +y/
2b50: 62 61 72 2b 29 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d bar+).----------
2b60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 ---------.[requi
2b70: 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 69 74 rements].mode it
2b80: 65 6d 77 61 69 74 0a 23 20 69 74 65 6d 6d 61 70 emwait.# itemmap
2b90: 20 3c 69 74 65 6d 20 70 61 74 74 65 72 6e 20 66 <item pattern f
2ba0: 6f 72 20 74 68 69 73 20 74 65 73 74 3e 20 20 3c or this test> <
2bb0: 69 74 65 6d 20 72 65 70 6c 61 63 65 6d 65 6e 74 item replacement
2bc0: 20 70 61 74 74 65 72 6e 20 66 6f 72 20 77 61 69 pattern for wai
2bd0: 74 6f 6e 20 74 65 73 74 3e 0a 69 74 65 6d 6d 61 ton test>.itemma
2be0: 70 20 2e 2a 78 2f 20 79 2f 0a 0a 2d 2d 2d 2d 2d p .*x/ y/..-----
2bf0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
2c00: 2e 65 78 61 6d 70 6c 65 20 66 6f 72 20 72 65 6d .example for rem
2c10: 6f 76 69 6e 67 20 70 61 72 74 20 6f 66 20 69 74 oving part of it
2c20: 65 6d 6d 61 70 20 66 6f 72 20 77 61 69 74 6f 6e emmap for waiton
2c30: 20 74 65 73 74 20 28 65 67 3a 20 69 74 65 6d 20 test (eg: item
2c40: 2b 66 6f 6f 2f 62 61 72 2f 62 61 7a 2b 20 69 6e +foo/bar/baz+ in
2c50: 20 74 68 69 73 20 74 65 73 74 20 64 65 70 65 6e this test depen
2c60: 64 73 20 6f 6e 20 77 61 69 74 6f 6e 27 73 20 69 ds on waiton's i
2c70: 74 65 6d 20 2b 62 61 7a 2b 29 0a 2d 2d 2d 2d 2d tem +baz+).-----
2c80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
2c90: 23 20 23 23 20 70 61 74 74 65 72 6e 20 72 65 70 # ## pattern rep
2ca0: 6c 61 63 65 6d 65 6e 74 20 6e 6f 74 65 73 0a 23 lacement notes.#
2cb0: 0a 23 20 23 23 20 45 78 61 6d 70 6c 65 0a 23 20 .# ## Example.#
2cc0: 23 23 20 52 65 6d 6f 76 65 20 65 76 65 72 79 74 ## Remove everyt
2cd0: 68 69 6e 67 20 75 70 20 74 6f 20 74 68 65 20 6c hing up to the l
2ce0: 61 73 74 20 2f 0a 5b 72 65 71 75 69 72 65 6d 65 ast /.[requireme
2cf0: 6e 74 73 5d 0a 6d 6f 64 65 20 69 74 65 6d 77 61 nts].mode itemwa
2d00: 69 74 0a 23 20 69 74 65 6d 6d 61 70 20 3c 69 74 it.# itemmap <it
2d10: 65 6d 20 70 61 74 74 65 72 6e 20 66 6f 72 20 74 em pattern for t
2d20: 68 69 73 20 74 65 73 74 3e 20 3c 6e 6f 74 68 69 his test> <nothi
2d30: 6e 67 20 68 65 72 65 20 69 6e 64 69 63 61 74 65 ng here indicate
2d40: 73 20 72 65 6d 6f 76 61 6c 3e 0a 69 74 65 6d 6d s removal>.itemm
2d50: 61 70 20 2e 2a 2f 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ap .*/.---------
2d60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 78 61 ----------...exa
2d70: 6d 70 6c 65 20 72 65 70 6c 61 63 69 6e 67 20 70 mple replacing p
2d80: 61 72 74 20 6f 66 20 69 74 65 6d 6d 61 70 20 66 art of itemmap f
2d90: 6f 72 20 28 65 67 3a 20 69 74 65 6d 20 2b 66 6f or (eg: item +fo
2da0: 6f 2f 31 32 33 34 2b 20 77 69 6c 6c 20 69 6d 70 o/1234+ will imp
2db0: 6c 79 20 77 61 69 74 6f 6e 27 73 20 69 74 65 6d ly waiton's item
2dc0: 20 2b 62 61 72 2f 31 32 33 34 2b 29 0a 2d 2d 2d +bar/1234+).---
2dd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2de0: 0a 0a 23 0a 23 20 23 23 20 45 78 61 6d 70 6c 65 ..#.# ## Example
2df0: 0a 23 20 23 23 20 52 65 70 6c 61 63 65 20 66 6f .# ## Replace fo
2e00: 6f 2f 20 77 69 74 68 20 62 61 72 2f 0a 5b 72 65 o/ with bar/.[re
2e10: 71 75 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 quirements].mode
2e20: 20 69 74 65 6d 77 61 69 74 0a 23 20 69 74 65 6d itemwait.# item
2e30: 6d 61 70 20 3c 69 74 65 6d 20 70 61 74 74 65 72 map <item patter
2e40: 6e 20 66 6f 72 20 74 68 69 73 20 74 65 73 74 3e n for this test>
2e50: 20 20 3c 69 74 65 6d 20 72 65 70 6c 61 63 65 6d <item replacem
2e60: 65 6e 74 20 70 61 74 74 65 72 6e 20 66 6f 72 20 ent pattern for
2e70: 77 61 69 74 6f 6e 20 74 65 73 74 3e 0a 69 74 65 waiton test>.ite
2e80: 6d 6d 61 70 20 66 6f 6f 2f 20 62 61 72 2f 0a 0a mmap foo/ bar/..
2e90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2ea0: 2d 2d 2d 0a 0a 2e 65 78 61 6d 70 6c 65 20 66 6f ---...example fo
2eb0: 72 20 62 61 63 6b 72 65 66 65 72 65 6e 63 65 20 r backreference
2ec0: 28 65 67 3a 20 69 74 65 6d 20 2b 66 6f 6f 32 33 (eg: item +foo23
2ed0: 2f 74 68 75 64 2b 20 77 69 6c 6c 20 69 6d 70 6c /thud+ will impl
2ee0: 79 20 77 61 69 74 6f 6e 27 73 20 69 74 65 6d 20 y waiton's item
2ef0: 2b 6e 75 6d 2d 32 33 2f 62 61 72 2f 74 68 75 64 +num-23/bar/thud
2f00: 2b 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d +.--------------
2f10: 2d 2d 2d 2d 2d 0a 23 0a 23 20 23 23 20 45 78 61 -----.#.# ## Exa
2f20: 6d 70 6c 65 0a 23 20 23 23 20 63 61 6e 20 75 73 mple.# ## can us
2f30: 65 20 5c 7b 6e 75 6d 62 65 72 7d 20 69 6e 20 72 e \{number} in r
2f40: 65 70 6c 61 63 65 6d 65 6e 74 20 70 61 74 74 65 eplacement patte
2f50: 72 6e 20 74 6f 20 62 61 63 6b 72 65 66 65 72 65 rn to backrefere
2f60: 6e 63 65 20 61 20 28 63 61 70 74 75 72 65 29 20 nce a (capture)
2f70: 66 72 6f 6d 20 6d 61 74 63 68 69 6e 67 20 70 61 from matching pa
2f80: 74 74 65 72 6e 20 73 69 6d 69 6c 61 72 20 74 6f ttern similar to
2f90: 20 73 65 64 20 6f 72 20 70 65 72 6c 0a 5b 72 65 sed or perl.[re
2fa0: 71 75 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 quirements].mode
2fb0: 20 69 74 65 6d 77 61 69 74 0a 23 20 69 74 65 6d itemwait.# item
2fc0: 6d 61 70 20 3c 69 74 65 6d 20 70 61 74 74 65 72 map <item patter
2fd0: 6e 20 66 6f 72 20 74 68 69 73 20 74 65 73 74 3e n for this test>
2fe0: 20 20 3c 69 74 65 6d 20 72 65 70 6c 61 63 65 6d <item replacem
2ff0: 65 6e 74 20 70 61 74 74 65 72 6e 20 66 6f 72 20 ent pattern for
3000: 77 61 69 74 6f 6e 20 74 65 73 74 3e 0a 69 74 65 waiton test>.ite
3010: 6d 6d 61 70 20 66 6f 6f 28 5c 64 2b 29 2f 20 6e mmap foo(\d+)/ n
3020: 75 6d 2d 5c 31 2f 62 61 72 2f 0a 0a 2d 2d 2d 2d um-\1/bar/..----
3030: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
3040: 0a 2e 65 78 61 6d 70 6c 65 20 6d 75 6c 74 69 70 ..example multip
3050: 6c 65 20 69 74 65 6d 6d 61 70 73 0a 2d 2d 2d 2d le itemmaps.----
3060: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
3070: 0a 23 20 6d 75 6c 74 69 2d 6c 69 6e 65 3b 20 6d .# multi-line; m
3080: 61 74 63 68 65 73 20 61 72 65 20 61 70 70 6c 69 atches are appli
3090: 65 64 20 69 6e 20 74 68 65 20 6c 69 73 74 65 64 ed in the listed
30a0: 20 6f 72 64 65 72 0a 23 20 54 68 65 20 66 6f 6c order.# The fol
30b0: 6c 6f 77 69 6e 67 20 77 6f 75 6c 64 20 6d 61 70 lowing would map
30c0: 3a 0a 23 20 20 20 61 31 32 33 62 33 32 31 20 74 :.# a123b321 t
30d0: 6f 20 62 33 32 31 66 6f 6f 61 31 32 33 20 74 68 o b321fooa123 th
30e0: 65 6e 20 74 6f 20 33 32 31 66 6f 6f 61 31 32 33 en to 321fooa123
30f0: 70 0a 23 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 p.#.[requirement
3100: 73 5d 0a 69 74 65 6d 6d 61 70 20 28 61 5c 64 2b s].itemmap (a\d+
3110: 29 28 62 5c 64 2b 29 20 5c 32 66 6f 6f 5c 31 0a )(b\d+) \2foo\1.
3120: 20 20 62 28 2e 2a 29 20 5c 31 70 0a 2d 2d 2d 2d b(.*) \1p.----
3130: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
3140: 0a 0a 43 6f 6d 70 6c 65 78 20 6d 61 70 70 69 6e ..Complex mappin
3150: 67 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e g.~~~~~~~~~~~~~~
3160: 7e 0a 43 6f 6d 70 6c 65 78 20 6d 61 70 70 69 6e ~.Complex mappin
3170: 67 73 20 63 61 6e 20 62 65 20 68 61 6e 64 6c 65 gs can be handle
3180: 64 20 77 69 74 68 20 61 20 73 65 70 61 72 61 74 d with a separat
3190: 65 20 5b 69 74 65 6d 6d 61 70 5d 20 73 65 63 74 e [itemmap] sect
31a0: 69 6f 6e 20 28 69 6e 73 74 65 61 64 20 69 66 20 ion (instead if
31b0: 61 6e 20 69 74 65 6d 6d 61 70 20 6c 69 6e 65 20 an itemmap line
31c0: 69 6e 20 74 68 65 20 5b 72 65 71 75 69 72 65 6d in the [requirem
31d0: 65 6e 74 73 5d 20 73 65 63 74 69 6f 6e 29 0a 0a ents] section)..
31e0: 45 61 63 68 20 6c 69 6e 65 20 69 6e 20 61 6e 20 Each line in an
31f0: 69 74 65 6d 6d 61 70 20 73 65 63 74 69 6f 6e 20 itemmap section
3200: 73 74 61 72 74 73 20 77 69 74 68 20 61 20 77 61 starts with a wa
3210: 69 74 6f 6e 20 74 65 73 74 20 6e 61 6d 65 20 66 iton test name f
3220: 6f 6c 6c 6f 77 65 64 20 62 79 20 61 6e 20 69 74 ollowed by an it
3230: 65 6d 6d 61 70 20 65 78 70 72 65 73 73 69 6f 6e emmap expression
3240: 0a 0a 2e 65 67 3a 20 54 68 65 20 66 6f 6c 6c 6f ...eg: The follo
3250: 77 69 6e 67 20 63 61 75 73 65 73 20 77 61 69 74 wing causes wait
3260: 6f 6e 20 74 65 73 74 20 41 20 69 74 65 6d 20 2b on test A item +
3270: 62 61 72 2f 31 32 33 34 2b 20 74 6f 20 72 75 6e bar/1234+ to run
3280: 20 77 68 65 6e 20 6f 75 72 20 74 65 73 74 27 73 when our test's
3290: 20 2b 66 6f 6f 2f 31 32 33 34 2b 20 69 74 65 6d +foo/1234+ item
32a0: 20 69 73 20 72 65 71 75 65 73 74 65 64 20 61 73 is requested as
32b0: 20 77 65 6c 6c 20 61 73 20 63 61 75 73 69 6e 67 well as causing
32c0: 20 77 61 69 74 6f 6e 20 74 65 73 74 20 42 27 73 waiton test B's
32d0: 20 2b 62 6c 61 68 2b 20 69 74 65 6d 20 74 6f 20 +blah+ item to
32e0: 72 75 6e 20 77 68 65 6e 20 6f 75 72 20 74 65 73 run when our tes
32f0: 74 27 73 20 2b 73 74 75 66 66 2f 62 6c 61 68 2b t's +stuff/blah+
3300: 20 69 74 65 6d 20 69 73 20 72 65 71 75 65 73 74 item is request
3310: 65 64 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ed.-------------
3320: 2d 0a 5b 69 74 65 6d 6d 61 70 5d 0a 41 20 66 6f -.[itemmap].A fo
3330: 6f 2f 20 62 61 72 2f 0a 42 20 73 74 75 66 66 2f o/ bar/.B stuff/
3340: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a .--------------.
3350: 0a 0a 43 6f 6d 70 6c 65 78 20 6d 61 70 70 69 6e ..Complex mappin
3360: 67 20 65 78 61 6d 70 6c 65 0a 7e 7e 7e 7e 7e 7e g example.~~~~~~
3370: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
3380: 7e 0a 0a 0a 0a 2f 2f 20 69 6d 61 67 65 3a 3a 69 ~....// image::i
3390: 74 65 6d 6d 61 70 2e 70 6e 67 5b 5d 0a 69 6d 61 temmap.png[].ima
33a0: 67 65 3a 3a 63 6f 6d 70 6c 65 78 2d 69 74 65 6d ge::complex-item
33b0: 6d 61 70 2e 70 6e 67 5b 5d 0a 0a 0a 57 65 20 61 map.png[]...We a
33c0: 63 63 6f 6d 70 6c 69 73 68 20 74 68 69 73 20 62 ccomplish this b
33d0: 79 20 63 6f 6e 66 69 67 75 72 69 6e 67 20 74 68 y configuring th
33e0: 65 20 74 65 73 74 63 6f 6e 66 69 67 73 20 6f 66 e testconfigs of
33f0: 20 6f 75 72 20 74 65 73 74 73 20 43 20 44 20 61 our tests C D a
3400: 6e 64 20 45 20 61 73 20 66 6f 6c 6c 6f 77 73 3a nd E as follows:
3410: 0a 0a 2e 54 65 73 74 63 6f 6e 66 69 67 20 66 6f ...Testconfig fo
3420: 72 20 54 65 73 74 20 45 20 68 61 73 0a 2d 2d 2d r Test E has.---
3430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3440: 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 ---.[requirement
3450: 73 5d 0a 77 61 69 74 6f 6e 20 43 0a 69 74 65 6d s].waiton C.item
3460: 6d 61 70 20 28 5c 64 2b 29 2f 72 65 73 20 5c 31 map (\d+)/res \1
3470: 2f 62 62 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d /bb.------------
3480: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 54 65 73 ----------...Tes
3490: 74 63 6f 6e 66 69 67 20 66 6f 72 20 54 65 73 74 tconfig for Test
34a0: 20 44 20 68 61 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d D has.---------
34b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 -------------.[r
34c0: 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 77 61 69 equirements].wai
34d0: 74 6f 6e 20 43 0a 69 74 65 6d 6d 61 70 20 28 5c ton C.itemmap (\
34e0: 64 2b 29 2f 72 65 73 20 5c 31 2f 61 61 0a 2d 2d d+)/res \1/aa.--
34f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3500: 2d 2d 2d 2d 0a 0a 2e 54 65 73 74 63 6f 6e 66 69 ----...Testconfi
3510: 67 20 66 6f 72 20 54 65 73 74 20 43 20 68 61 73 g for Test C has
3520: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
3530: 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 -------.[require
3540: 6d 65 6e 74 73 5d 0a 77 61 69 74 6f 6e 20 41 20 ments].waiton A
3550: 42 0a 0a 5b 69 74 65 6d 6d 61 70 5d 0a 41 20 28 B..[itemmap].A (
3560: 5c 64 2b 29 2f 61 61 20 61 61 2f 5c 31 0a 42 20 \d+)/aa aa/\1.B
3570: 28 5c 64 2b 29 2f 62 62 20 62 62 2f 5c 31 0a 2d (\d+)/bb bb/\1.-
3580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3590: 2d 2d 2d 2d 2d 0a 0a 2e 54 65 73 74 63 6f 6e 66 -----...Testconf
35a0: 69 67 73 20 66 6f 72 20 54 65 73 74 20 42 20 61 igs for Test B a
35b0: 6e 64 20 54 65 73 74 20 41 20 68 61 76 65 20 6e nd Test A have n
35c0: 6f 20 77 61 69 74 6f 6e 20 6f 72 20 69 74 65 6d o waiton or item
35d0: 6d 61 70 20 63 6f 6e 66 69 67 75 72 65 64 0a 2d map configured.-
35e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
35f0: 2d 2d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d --.-------------
3600: 2d 2d 2d 2d 2d 2d 0a 0a 2e 57 61 6c 6b 20 74 68 ------...Walk th
3610: 72 6f 75 67 68 20 6f 6e 65 20 69 74 65 6d 20 2d rough one item -
3620: 2d 20 77 65 20 77 61 6e 74 20 74 68 65 20 66 6f - we want the fo
3630: 6c 6c 6f 77 69 6e 67 20 74 6f 20 68 61 70 70 65 llowing to happe
3640: 6e 20 66 6f 72 20 74 65 73 74 70 61 74 74 20 2b n for testpatt +
3650: 44 2f 31 2f 72 65 73 2b 20 28 73 65 65 20 62 6c D/1/res+ (see bl
3660: 75 65 20 62 6f 78 65 73 20 69 6e 20 63 6f 6d 70 ue boxes in comp
3670: 6c 65 78 20 69 74 65 6d 6d 61 70 69 6e 67 20 66 lex itemmaping f
3680: 69 67 75 72 65 20 61 62 6f 76 65 29 3a 0a 0a 2e igure above):...
3690: 20 65 67 20 66 72 6f 6d 20 63 6f 6d 6d 61 6e 64 eg from command
36a0: 20 6c 69 6e 65 20 2b 6d 65 67 61 74 65 73 74 20 line +megatest
36b0: 2d 72 75 6e 20 2d 74 65 73 74 70 61 74 74 20 44 -run -testpatt D
36c0: 2f 31 2f 72 65 73 20 2d 74 61 72 67 65 74 20 6d /1/res -target m
36d0: 79 74 61 72 67 65 74 20 2d 72 75 6e 6e 61 6d 65 ytarget -runname
36e0: 20 6d 79 72 75 6e 6e 61 6d 65 2b 0a 2e 20 46 75 myrunname+.. Fu
36f0: 6c 6c 20 6c 69 73 74 20 74 6f 20 62 65 20 72 75 ll list to be ru
3700: 6e 20 69 73 20 6e 6f 77 3a 20 2b 44 2f 31 2f 72 n is now: +D/1/r
3710: 65 73 2b 0a 2e 20 54 65 73 74 20 44 20 68 61 73 es+.. Test D has
3720: 20 61 20 77 61 69 74 6f 6e 20 2d 20 74 65 73 74 a waiton - test
3730: 20 43 2e 20 20 54 65 73 74 20 44 27 73 20 69 74 C. Test D's it
3740: 65 6d 6d 61 70 20 72 75 6c 65 20 2b 69 74 65 6d emmap rule +item
3750: 6d 61 70 20 28 5c 64 26 70 6c 75 73 3b 29 2f 72 map (\d+)/r
3760: 65 73 20 5c 31 2f 61 61 2b 20 2d 3e 20 20 63 61 es \1/aa+ -> ca
3770: 75 73 65 73 20 2b 43 2f 31 2f 61 61 2b 20 74 6f uses +C/1/aa+ to
3780: 20 72 75 6e 20 62 65 66 6f 72 65 20 2b 44 2f 31 run before +D/1
3790: 2f 72 65 73 2b 0a 2e 20 46 75 6c 6c 20 6c 69 73 /res+.. Full lis
37a0: 74 20 74 6f 20 62 65 20 72 75 6e 20 69 73 20 6e t to be run is n
37b0: 6f 77 3a 20 2b 44 2f 31 2f 72 65 73 2b 2c 20 2b ow: +D/1/res+, +
37c0: 43 2f 31 2f 61 61 2b 0a 2e 20 54 65 73 74 20 43 C/1/aa+.. Test C
37d0: 20 77 61 73 20 61 20 77 61 69 74 6f 6e 20 2d 20 was a waiton -
37e0: 74 65 73 74 20 41 2e 20 54 65 73 74 20 43 27 73 test A. Test C's
37f0: 20 72 75 6c 65 20 2b 41 20 28 5c 64 26 70 6c 75 rule +A (\d&plu
3800: 73 3b 29 2f 61 61 20 61 61 2f 5c 31 2b 20 2d 3e s;)/aa aa/\1+ ->
3810: 20 63 61 75 73 65 73 20 2b 41 2f 61 61 2f 31 2b causes +A/aa/1+
3820: 20 74 6f 20 72 75 6e 20 62 65 66 6f 72 65 20 2b to run before +
3830: 43 2f 31 2f 61 61 2b 0a 2e 20 46 75 6c 6c 20 6c C/1/aa+.. Full l
3840: 69 73 74 20 74 6f 20 62 65 20 72 75 6e 20 69 73 ist to be run is
3850: 20 6e 6f 77 3a 20 2b 44 2f 31 2f 72 65 73 2b 2c now: +D/1/res+,
3860: 20 2b 43 2f 31 2f 61 61 2b 2c 20 2b 41 2f 61 61 +C/1/aa+, +A/aa
3870: 2f 31 2b 0a 2e 20 54 65 73 74 20 41 20 68 61 73 /1+.. Test A has
3880: 20 6e 6f 20 77 61 69 74 6f 6e 73 2e 20 20 41 6c no waitons. Al
3890: 6c 20 77 61 69 74 6f 6e 73 20 6f 66 20 61 6c 6c l waitons of all
38a0: 20 74 65 73 74 73 20 69 6e 20 66 75 6c 6c 20 6c tests in full l
38b0: 69 73 74 20 68 61 76 65 20 62 65 65 6e 20 70 72 ist have been pr
38c0: 6f 63 65 73 73 65 64 2e 20 20 46 75 6c 6c 20 6c ocessed. Full l
38d0: 69 73 74 20 69 73 20 66 69 6e 61 6c 69 7a 65 64 ist is finalized
38e0: 2e 0a 0a 0a 0a 69 74 65 6d 73 74 61 62 6c 65 0a .....itemstable.
38f0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 41 6e 20 61 6c ~~~~~~~~~~.An al
3900: 74 65 72 6e 61 74 69 76 65 20 74 6f 20 64 65 66 ternative to def
3910: 69 6e 69 6e 67 20 69 74 65 6d 73 20 69 73 20 74 ining items is t
3920: 68 65 20 69 74 65 6d 73 74 61 62 6c 65 20 73 65 he itemstable se
3930: 63 74 69 6f 6e 2e 20 20 54 68 69 73 20 6c 65 74 ction. This let
3940: 73 20 79 6f 75 20 64 65 66 69 6e 65 20 74 68 65 s you define the
3950: 20 69 74 65 6d 70 61 74 68 20 69 6e 20 61 20 74 itempath in a t
3960: 61 62 6c 65 20 66 6f 72 6d 61 74 20 72 61 74 68 able format rath
3970: 65 72 20 74 68 61 6e 20 73 70 65 63 69 66 79 69 er than specifyi
3980: 6e 67 20 63 6f 6d 70 6f 6e 65 6e 74 73 20 61 6e ng components an
3990: 64 20 72 65 6c 79 69 6e 67 20 6f 6e 20 67 65 74 d relying on get
39a0: 74 69 6e 67 20 61 6c 6c 20 70 65 72 6d 75 74 61 ting all permuta
39b0: 74 69 6f 6e 73 20 6f 66 20 74 68 6f 73 65 20 63 tions of those c
39c0: 6f 6d 70 6f 6e 65 6e 74 73 2e 0a 0a 0a 0a 0a 0a omponents.......
39d0: 44 79 6e 61 6d 69 63 20 46 6c 6f 77 20 44 65 70 Dynamic Flow Dep
39e0: 65 6e 64 65 6e 63 79 20 54 72 65 65 0a 7e 7e 7e endency Tree.~~~
39f0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
3a00: 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 41 75 74 6f ~~~~~~~~~...Auto
3a10: 67 65 6e 65 72 61 74 69 6f 6e 20 77 61 69 74 6f generation waito
3a20: 6e 20 6c 69 73 74 20 66 6f 72 20 64 79 6e 61 6d n list for dynam
3a30: 69 63 20 66 6c 6f 77 20 64 65 70 65 6e 64 65 6e ic flow dependen
3a40: 63 79 20 74 72 65 65 73 0a 2d 2d 2d 2d 2d 2d 2d cy trees.-------
3a50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 ------------.[re
3a60: 71 75 69 72 65 6d 65 6e 74 73 5d 0a 23 20 57 69 quirements].# Wi
3a70: 74 68 20 61 20 74 6f 70 6c 65 76 65 6c 20 74 65 th a toplevel te
3a80: 73 74 20 79 6f 75 20 6d 61 79 20 77 69 73 68 20 st you may wish
3a90: 74 6f 20 67 65 6e 65 72 61 74 65 20 79 6f 75 72 to generate your
3aa0: 20 6c 69 73 74 20 0a 23 20 6f 66 20 74 65 73 74 list .# of test
3ab0: 73 20 74 6f 20 72 75 6e 20 64 79 6e 61 6d 69 63 s to run dynamic
3ac0: 61 6c 6c 79 0a 23 0a 77 61 69 74 6f 6e 20 23 7b ally.#.waiton #{
3ad0: 73 68 65 6c 6c 20 67 65 74 2d 76 61 6c 69 64 2d shell get-valid-
3ae0: 74 65 73 74 73 2d 74 6f 2d 72 75 6e 2e 73 68 7d tests-to-run.sh}
3af0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
3b00: 2d 2d 2d 2d 0a 0a 52 75 6e 20 74 69 6d 65 20 6c ----..Run time l
3b10: 69 6d 69 74 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e imit.~~~~~~~~~~~
3b20: 7e 7e 7e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ~~~..-----------
3b30: 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d ------.[requirem
3b40: 65 6e 74 73 5d 0a 72 75 6e 74 69 6d 65 6c 69 6d ents].runtimelim
3b50: 20 31 68 20 32 6d 20 33 73 20 20 23 20 74 68 69 1h 2m 3s # thi
3b60: 73 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 s will automatic
3b70: 61 6c 6c 79 20 6b 69 6c 6c 20 74 68 65 20 74 65 ally kill the te
3b80: 73 74 20 69 66 20 69 74 20 72 75 6e 73 20 66 6f st if it runs fo
3b90: 72 20 6d 6f 72 65 20 74 68 61 6e 20 31 68 20 32 r more than 1h 2
3ba0: 6d 20 61 6e 64 20 33 73 0a 2d 2d 2d 2d 2d 2d 2d m and 3s.-------
3bb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 70 ----------..Skip
3bc0: 0a 7e 7e 7e 7e 0a 0a 41 20 74 65 73 74 20 77 69 .~~~~..A test wi
3bd0: 74 68 20 61 20 73 6b 69 70 20 73 65 63 74 69 6f th a skip sectio
3be0: 6e 20 77 69 6c 6c 20 63 6f 6e 64 69 74 69 6f 6e n will condition
3bf0: 61 6c 20 73 6b 69 70 20 72 75 6e 6e 69 6e 67 2e al skip running.
3c00: 0a 0a 2e 53 6b 69 70 20 73 65 63 74 69 6f 6e 20 ...Skip section
3c10: 65 78 61 6d 70 6c 65 0a 2d 2d 2d 2d 2d 2d 2d 2d example.--------
3c20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 6b 69 70 5d ---------.[skip]
3c30: 0a 70 72 65 76 72 75 6e 6e 69 6e 67 20 78 0a 23 .prevrunning x.#
3c40: 20 72 75 6e 64 65 6c 61 79 20 33 30 6d 20 31 35 rundelay 30m 15
3c50: 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d s.--------------
3c60: 2d 2d 2d 0a 0a 53 6b 69 70 20 6f 6e 20 53 74 69 ---..Skip on Sti
3c70: 6c 6c 2d 72 75 6e 6e 69 6e 67 20 54 65 73 74 73 ll-running Tests
3c80: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e .~~~~~~~~~~~~~~~
3c90: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2d 2d ~~~~~~~~~~~~..--
3ca0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
3cb0: 23 20 4e 42 2f 2f 20 49 66 20 74 68 65 20 70 72 # NB// If the pr
3cc0: 65 76 72 75 6e 6e 69 6e 67 20 6c 69 6e 65 20 65 evrunning line e
3cd0: 78 69 73 74 73 20 77 69 74 68 20 2a 61 6e 79 2a xists with *any*
3ce0: 20 76 61 6c 75 65 20 74 68 65 20 74 65 73 74 20 value the test
3cf0: 77 69 6c 6c 0a 23 20 61 75 74 6f 6d 61 74 69 63 will.# automatic
3d00: 61 6c 6c 79 20 53 4b 49 50 20 69 66 20 74 68 65 ally SKIP if the
3d10: 20 73 61 6d 65 2d 6e 61 6d 65 64 20 74 65 73 74 same-named test
3d20: 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 52 55 is currently RU
3d30: 4e 4e 49 4e 47 2e 20 54 68 65 0a 23 20 22 78 22 NNING. The.# "x"
3d40: 20 63 61 6e 20 62 65 20 61 6e 79 20 73 74 72 69 can be any stri
3d50: 6e 67 2e 20 43 6f 6d 6d 65 6e 74 20 6f 75 74 20 ng. Comment out
3d60: 74 68 65 20 70 72 65 76 72 75 6e 6e 69 6e 67 20 the prevrunning
3d70: 6c 69 6e 65 20 74 6f 20 74 75 72 6e 20 6f 66 66 line to turn off
3d80: 0a 23 20 73 6b 69 70 2e 0a 0a 5b 73 6b 69 70 5d .# skip...[skip]
3d90: 0a 70 72 65 76 72 75 6e 6e 69 6e 67 20 78 0a 2d .prevrunning x.-
3da0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3db0: 0a 0a 53 6b 69 70 20 69 66 20 61 20 46 69 6c 65 ..Skip if a File
3dc0: 20 45 78 69 73 74 73 0a 7e 7e 7e 7e 7e 7e 7e 7e Exists.~~~~~~~~
3dd0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2d ~~~~~~~~~~~~~..-
3de0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3df0: 0a 5b 73 6b 69 70 5d 0a 66 69 6c 65 65 78 69 73 .[skip].fileexis
3e00: 74 73 20 2f 70 61 74 68 2f 74 6f 2f 61 2f 66 69 ts /path/to/a/fi
3e10: 6c 65 20 23 20 73 6b 69 70 20 69 66 20 2f 70 61 le # skip if /pa
3e20: 74 68 2f 74 6f 2f 61 2f 66 69 6c 65 20 65 78 69 th/to/a/file exi
3e30: 73 74 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d sts.------------
3e40: 2d 2d 2d 2d 2d 0a 0a 53 6b 69 70 20 69 66 20 74 -----..Skip if t
3e50: 65 73 74 20 72 61 6e 20 6d 6f 72 65 20 72 65 63 est ran more rec
3e60: 65 6e 74 6c 79 20 74 68 61 6e 20 73 70 65 63 69 ently than speci
3e70: 66 69 65 64 20 74 69 6d 65 0a 7e 7e 7e 7e 7e 7e fied time.~~~~~~
3e80: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
3e90: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
3ea0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 53 ~~~~~~~~~~~~...S
3eb0: 6b 69 70 20 69 66 20 74 68 69 73 20 74 65 73 74 kip if this test
3ec0: 20 68 61 73 20 62 65 65 6e 20 72 75 6e 20 69 6e has been run in
3ed0: 20 74 68 65 20 70 61 73 74 20 66 69 66 74 65 65 the past fiftee
3ee0: 6e 20 6d 69 6e 75 74 65 73 20 61 6e 64 20 31 35 n minutes and 15
3ef0: 20 73 65 63 6f 6e 64 73 2e 0a 2d 2d 2d 2d 2d 2d seconds..------
3f00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 6b 69 -----------.[ski
3f10: 70 5d 0a 72 75 6e 64 65 6c 61 79 20 31 35 6d 20 p].rundelay 15m
3f20: 31 35 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 15s.------------
3f30: 2d 2d 2d 2d 2d 0a 0a 44 69 73 6b 73 0a 7e 7e 7e -----..Disks.~~~
3f40: 7e 7e 0a 0a 41 20 64 69 73 6b 73 20 73 65 63 74 ~~..A disks sect
3f50: 69 6f 6e 20 69 6e 20 74 65 73 74 63 6f 6e 66 69 ion in testconfi
3f60: 67 20 77 69 6c 6c 20 6f 76 65 72 72 69 64 65 20 g will override
3f70: 74 68 65 20 64 69 73 6b 73 20 73 65 63 74 69 6f the disks sectio
3f80: 6e 20 69 6e 0a 6d 65 67 61 74 65 73 74 2e 63 6f n in.megatest.co
3f90: 6e 66 69 67 2e 20 54 68 69 73 20 63 61 6e 20 62 nfig. This can b
3fa0: 65 20 75 73 65 64 20 74 6f 20 61 6c 6c 6f 63 61 e used to alloca
3fb0: 74 65 20 64 69 73 6b 73 20 6f 6e 20 61 20 70 65 te disks on a pe
3fc0: 72 2d 74 65 73 74 20 6f 72 20 70 65 72 20 69 74 r-test or per it
3fd0: 65 6d 0a 62 61 73 69 73 2e 0a 0a 43 6f 6e 74 72 em.basis...Contr
3fe0: 6f 6c 6c 65 64 20 77 61 69 76 65 72 20 70 72 6f olled waiver pro
3ff0: 70 61 67 61 74 69 6f 6e 0a 7e 7e 7e 7e 7e 7e 7e pagation.~~~~~~~
4000: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
4010: 7e 7e 7e 7e 7e 7e 0a 0a 49 66 20 74 65 73 74 20 ~~~~~~..If test
4020: 69 73 20 46 41 49 4c 20 61 6e 64 20 70 72 65 76 is FAIL and prev
4030: 69 6f 75 73 20 74 65 73 74 20 69 6e 20 72 75 6e ious test in run
4040: 20 77 69 74 68 20 73 61 6d 65 20 4d 54 5f 54 41 with same MT_TA
4050: 52 47 45 54 20 69 73 20 57 41 49 56 45 44 20 74 RGET is WAIVED t
4060: 68 65 6e 20 61 70 70 6c 79 20 74 68 65 20 66 6f hen apply the fo
4070: 6c 6c 6f 77 69 6e 67 20 72 75 6c 65 73 20 66 72 llowing rules fr
4080: 6f 6d 20 74 68 65 20 74 65 73 74 63 6f 6e 66 69 om the testconfi
4090: 67 3a 0a 49 66 20 61 20 77 61 69 76 65 72 20 63 g:.If a waiver c
40a0: 68 65 63 6b 20 69 73 20 73 70 65 63 69 66 69 65 heck is specifie
40b0: 64 20 69 6e 20 74 68 65 20 74 65 73 74 63 6f 6e d in the testcon
40c0: 66 69 67 20 61 70 70 6c 79 20 74 68 65 20 63 68 fig apply the ch
40d0: 65 63 6b 20 61 6e 64 20 69 66 20 69 74 20 70 61 eck and if it pa
40e0: 73 73 65 73 20 74 68 65 6e 20 73 65 74 20 74 68 sses then set th
40f0: 69 73 20 46 41 49 4c 20 74 6f 20 57 41 49 56 45 is FAIL to WAIVE
4100: 44 0a 0a 57 61 69 76 65 72 20 63 68 65 63 6b 20 D..Waiver check
4110: 68 61 73 20 74 77 6f 20 70 61 72 74 73 2c 20 31 has two parts, 1
4120: 29 20 61 20 6c 69 73 74 20 6f 66 20 77 61 69 76 ) a list of waiv
4130: 65 72 2c 20 72 75 6c 65 6e 61 6d 65 2c 20 66 69 er, rulename, fi
4140: 6c 65 70 61 74 74 65 72 6e 73 20 61 6e 64 20 32 lepatterns and 2
4150: 29 20 74 68 65 20 72 75 6c 65 6e 61 6d 65 20 73 ) the rulename s
4160: 63 72 69 70 74 20 73 70 65 63 20 28 6e 6f 74 65 cript spec (note
4170: 20 74 68 61 74 20 22 64 69 66 66 22 20 61 6e 64 that "diff" and
4180: 20 22 6c 6f 67 70 72 6f 22 20 61 72 65 20 70 72 "logpro" are pr
4190: 65 64 65 66 69 6e 65 64 29 0a 0a 2d 2d 2d 2d 2d edefined)..-----
41a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 23 23 ------------.###
41b0: 23 23 23 20 45 58 41 4d 50 4c 45 20 46 52 4f 4d ### EXAMPLE FROM
41c0: 20 74 65 73 74 63 6f 6e 66 69 67 20 23 23 23 23 testconfig ####
41d0: 23 23 23 23 23 0a 23 20 6d 61 74 63 68 69 6e 67 #####.# matching
41e0: 20 66 69 6c 65 28 73 29 20 77 69 6c 6c 20 62 65 file(s) will be
41f0: 20 64 69 66 66 27 64 20 77 69 74 68 20 70 72 65 diff'd with pre
4200: 76 69 6f 75 73 20 72 75 6e 20 61 6e 64 20 6c 6f vious run and lo
4210: 67 70 72 6f 20 61 70 70 6c 69 65 64 0a 23 20 69 gpro applied.# i
4220: 66 20 50 41 53 53 20 6f 72 20 57 41 52 4e 20 72 f PASS or WARN r
4230: 65 73 75 6c 74 20 66 72 6f 6d 20 6c 6f 67 70 72 esult from logpr
4240: 6f 20 74 68 65 6e 20 57 41 49 56 45 52 20 73 74 o then WAIVER st
4250: 61 74 65 20 69 73 20 73 65 74 0a 23 0a 5b 77 61 ate is set.#.[wa
4260: 69 76 65 72 73 5d 0a 23 20 6c 6f 67 70 72 6f 5f ivers].# logpro_
4270: 66 69 6c 65 20 20 20 20 72 75 6c 65 6e 61 6d 65 file rulename
4280: 20 20 20 20 20 20 69 6e 70 75 74 5f 67 6c 6f 62 input_glob
4290: 0a 77 61 69 76 65 72 5f 31 20 20 20 20 20 20 20 .waiver_1
42a0: 20 20 6c 6f 67 70 72 6f 20 20 20 20 20 20 20 20 logpro
42b0: 6c 6f 6f 6b 69 74 74 6d 70 2e 6c 6f 67 0a 0a 5b lookittmp.log..[
42c0: 77 61 69 76 65 72 5f 72 75 6c 65 73 5d 0a 0a 23 waiver_rules]..#
42d0: 20 54 68 69 73 20 62 75 69 6c 74 69 6e 20 72 75 This builtin ru
42e0: 6c 65 20 69 73 20 74 68 65 20 64 65 66 61 75 6c le is the defaul
42f0: 74 20 69 66 20 74 68 65 72 65 20 69 73 20 6e 6f t if there is no
4300: 20 3c 77 61 69 76 65 72 6e 61 6d 65 3e 2e 6c 6f <waivername>.lo
4310: 67 70 72 6f 20 66 69 6c 65 0a 23 20 64 69 66 66 gpro file.# diff
4320: 20 20 20 64 69 66 66 20 25 66 69 6c 65 31 25 20 diff %file1%
4330: 25 66 69 6c 65 32 25 0a 0a 23 20 54 68 69 73 20 %file2%..# This
4340: 62 75 69 6c 74 69 6e 20 72 75 6c 65 20 69 73 20 builtin rule is
4350: 61 70 70 6c 69 65 64 20 69 66 20 61 20 3c 77 61 applied if a <wa
4360: 69 76 65 72 6e 61 6d 65 3e 2e 6c 6f 67 70 72 6f ivername>.logpro
4370: 20 66 69 6c 65 20 65 78 69 73 74 73 0a 23 20 6c file exists.# l
4380: 6f 67 70 72 6f 20 64 69 66 66 20 25 66 69 6c 65 ogpro diff %file
4390: 31 25 20 25 66 69 6c 65 32 25 20 7c 20 6c 6f 67 1% %file2% | log
43a0: 70 72 6f 20 25 77 61 69 76 65 72 6e 61 6d 65 25 pro %waivername%
43b0: 2e 6c 6f 67 70 72 6f 20 25 77 61 69 76 65 72 6e .logpro %waivern
43c0: 61 6d 65 25 2e 68 74 6d 6c 0a 2d 2d 2d 2d 2d 2d ame%.html.------
43d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 45 7a 73 -----------..Ezs
43e0: 74 65 70 73 0a 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 45 teps.~~~~~~~...E
43f0: 78 61 6d 70 6c 65 20 65 7a 73 74 65 70 73 20 77 xample ezsteps w
4400: 69 74 68 20 6c 6f 67 70 72 6f 20 72 75 6c 65 73 ith logpro rules
4410: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
4420: 2d 2d 0a 5b 65 7a 73 74 65 70 73 5d 0a 6c 6f 6f --.[ezsteps].loo
4430: 6b 69 74 74 6d 70 20 20 20 6c 73 20 2f 74 6d 70 kittmp ls /tmp
4440: 0a 0a 5b 6c 6f 67 70 72 6f 5d 0a 6c 6f 6f 6b 69 ..[logpro].looki
4450: 74 74 6d 70 20 3b 3b 20 4e 6f 74 65 3a 20 63 6f ttmp ;; Note: co
4460: 6e 66 69 67 20 66 69 6c 65 20 66 6f 72 6d 61 74 nfig file format
4470: 20 73 75 70 70 6f 72 74 73 20 6d 75 6c 74 69 2d supports multi-
4480: 6c 69 6e 65 20 65 6e 74 72 69 65 73 20 77 68 65 line entries whe
4490: 72 65 20 6c 65 61 64 69 6e 67 20 77 68 69 74 65 re leading white
44a0: 73 70 61 63 65 20 69 73 20 72 65 6d 6f 76 65 64 space is removed
44b0: 20 66 72 6f 6d 20 65 61 63 68 20 6c 69 6e 65 0a from each line.
44c0: 20 20 3b 3b 20 20 20 20 20 61 20 62 6c 61 6e 6b ;; a blank
44d0: 20 6c 69 6e 65 20 69 6e 64 69 63 61 74 65 73 20 line indicates
44e0: 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 62 the end of the b
44f0: 6c 6f 63 6b 20 6f 66 20 74 65 78 74 20 0a 20 20 lock of text .
4500: 28 65 78 70 65 63 74 3a 72 65 71 75 69 72 65 64 (expect:required
4510: 20 69 6e 20 22 4c 6f 67 46 69 6c 65 42 6f 64 79 in "LogFileBody
4520: 22 20 3e 20 30 20 22 41 20 66 69 6c 65 20 6e 61 " > 0 "A file na
4530: 6d 65 20 74 68 61 74 20 73 68 6f 75 6c 64 20 6e me that should n
4540: 65 76 65 72 20 65 78 69 73 74 21 22 20 23 2f 54 ever exist!" #/T
4550: 68 69 73 20 69 73 20 61 20 61 77 66 75 6c 6c 79 his is a awfully
4560: 20 73 74 75 70 69 64 20 66 69 6c 65 20 6e 61 6d stupid file nam
4570: 65 20 74 68 61 74 20 73 68 6f 75 6c 64 20 6e 65 e that should ne
4580: 76 65 72 20 62 65 20 66 6f 75 6e 64 20 69 6e 20 ver be found in
4590: 74 68 65 20 74 65 6d 70 20 64 69 72 2f 29 0a 0a the temp dir/)..
45a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
45b0: 2d 0a 0a 54 6f 20 74 72 61 6e 73 66 65 72 20 74 -..To transfer t
45c0: 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 74 he environment t
45d0: 6f 20 74 68 65 20 6e 65 78 74 20 73 74 65 70 20 o the next step
45e0: 79 6f 75 20 63 61 6e 20 64 6f 20 74 68 65 20 66 you can do the f
45f0: 6f 6c 6c 6f 77 69 6e 67 3a 0a 0a 2e 50 72 6f 70 ollowing:...Prop
4600: 61 67 61 74 65 20 65 6e 76 69 72 6f 6e 6d 65 6e agate environmen
4610: 74 20 74 6f 20 6e 65 78 74 20 73 74 65 70 0a 2d t to next step.-
4620: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4630: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 24 4d 54 5f -----------.$MT_
4640: 4d 45 47 41 54 45 53 54 20 2d 65 6e 76 32 66 69 MEGATEST -env2fi
4650: 6c 65 20 2e 65 7a 73 74 65 70 73 2f 24 7b 73 74 le .ezsteps/${st
4660: 65 70 6e 61 6d 65 7d 09 20 20 0a 2d 2d 2d 2d 2d epname}. .-----
4670: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4680: 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 72 69 67 67 65 72 -------..Trigger
4690: 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 20 79 s.~~~~~~~~..In y
46a0: 6f 75 72 20 74 65 73 74 63 6f 6e 66 69 67 20 6f our testconfig o
46b0: 72 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 r megatest.confi
46c0: 67 20 74 72 69 67 67 65 72 73 20 63 61 6e 20 62 g triggers can b
46d0: 65 20 73 70 65 63 69 66 69 65 64 20 0a 0a 2e 54 e specified ...T
46e0: 72 69 67 67 65 72 73 20 73 70 65 63 0a 2d 2d 2d riggers spec.---
46f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
4700: 74 72 69 67 67 65 72 73 5d 0a 0a 23 20 43 61 6c triggers]..# Cal
4710: 6c 20 73 63 72 69 70 74 20 72 75 6e 6e 69 6e 67 l script running
4720: 2e 73 68 20 77 68 65 6e 20 74 65 73 74 20 67 6f .sh when test go
4730: 65 73 20 74 6f 20 73 74 61 74 65 3d 52 55 4e 4e es to state=RUNN
4740: 49 4e 47 2c 20 73 74 61 74 75 73 3d 50 41 53 53 ING, status=PASS
4750: 0a 52 55 4e 4e 49 4e 47 2f 50 41 53 53 20 72 75 .RUNNING/PASS ru
4760: 6e 6e 69 6e 67 2e 73 68 0a 0a 23 20 43 61 6c 6c nning.sh..# Call
4770: 20 73 63 72 69 70 74 20 72 75 6e 6e 69 6e 67 2e script running.
4780: 73 68 20 61 6e 79 20 74 69 6d 65 20 73 74 61 74 sh any time stat
4790: 65 20 67 6f 65 73 20 74 6f 20 52 55 4e 4e 49 4e e goes to RUNNIN
47a0: 47 0a 52 55 4e 4e 49 4e 47 2f 20 72 75 6e 6e 69 G.RUNNING/ runni
47b0: 6e 67 2e 73 68 0a 0a 23 20 43 61 6c 6c 20 73 63 ng.sh..# Call sc
47c0: 72 69 70 74 20 6f 6e 70 61 73 73 2e 73 68 20 61 ript onpass.sh a
47d0: 6e 79 20 74 69 6d 65 20 73 74 61 74 75 73 20 67 ny time status g
47e0: 6f 65 73 20 74 6f 20 50 41 53 53 0a 50 41 53 53 oes to PASS.PASS
47f0: 2f 20 6f 6e 70 61 73 73 2e 73 68 0a 2d 2d 2d 2d / onpass.sh.----
4800: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 -------------..S
4810: 63 72 69 70 74 73 20 63 61 6c 6c 65 64 20 77 69 cripts called wi
4820: 6c 6c 20 68 61 76 65 3b 20 74 65 73 74 2d 69 64 ll have; test-id
4830: 20 74 65 73 74 2d 72 75 6e 64 69 72 20 74 72 69 test-rundir tri
4840: 67 67 65 72 20 74 65 73 74 2d 6e 61 6d 65 20 69 gger test-name i
4850: 74 65 6d 2d 70 61 74 68 20 73 74 61 74 65 20 73 tem-path state s
4860: 74 61 74 75 73 20 65 76 65 6e 74 2d 74 69 6d 65 tatus event-time
4870: 2c 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 63 , added to the c
4880: 6f 6d 6d 61 6e 64 6c 69 6e 65 2e 0a 0a 48 49 4e ommandline...HIN
4890: 54 0a 0a 54 6f 20 73 74 61 72 74 20 61 6e 20 78 T..To start an x
48a0: 74 65 72 6d 20 28 75 73 65 66 75 6c 20 66 6f 72 term (useful for
48b0: 20 64 65 62 75 67 67 69 6e 67 29 2c 20 75 73 65 debugging), use
48c0: 20 61 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 a command line
48d0: 6c 69 6b 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 like the followi
48e0: 6e 67 3a 0a 0a 2e 53 74 61 72 74 20 61 6e 20 78 ng:...Start an x
48f0: 74 65 72 6d 20 75 73 69 6e 67 20 61 20 74 72 69 term using a tri
4900: 67 67 65 72 20 66 6f 72 20 74 65 73 74 20 63 6f gger for test co
4910: 6d 70 6c 65 74 65 64 2e 0a 2d 2d 2d 2d 2d 2d 2d mpleted..-------
4920: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 74 72 69 67 ----------.[trig
4930: 67 65 72 73 5d 0a 43 4f 4d 50 4c 45 54 45 44 2f gers].COMPLETED/
4940: 20 78 74 65 72 6d 20 2d 65 20 62 61 73 68 20 2d xterm -e bash -
4950: 73 20 2d 2d 20 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d s -- .----------
4960: 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e 4f 54 45 3a 20 54 -------..NOTE: T
4970: 68 65 72 65 20 69 73 20 61 20 74 72 61 69 6c 69 here is a traili
4980: 6e 67 20 73 70 61 63 65 20 61 66 74 65 72 20 74 ng space after t
4990: 68 65 20 64 6f 75 62 6c 65 2d 64 61 73 68 0a 0a he double-dash..
49a0: 54 68 65 72 65 20 61 72 65 20 61 20 6e 75 6d 62 There are a numb
49b0: 65 72 20 6f 66 20 65 6e 76 69 72 6f 6e 6d 65 6e er of environmen
49c0: 74 20 76 61 72 69 61 62 6c 65 73 20 61 76 61 69 t variables avai
49d0: 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 74 72 69 lable to the tri
49e0: 67 67 65 72 20 73 63 72 69 70 74 0a 62 75 74 20 gger script.but
49f0: 73 69 6e 63 65 20 74 72 69 67 67 65 72 73 20 63 since triggers c
4a00: 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 69 6e 20 an be called in
4a10: 76 61 72 69 6f 75 73 20 63 6f 6e 74 65 78 74 73 various contexts
4a20: 20 6e 6f 74 20 61 6c 6c 20 76 61 72 69 61 62 6c not all variabl
4a30: 65 73 20 61 72 65 0a 61 76 61 69 6c 61 62 6c 65 es are.available
4a40: 20 61 74 20 61 6c 6c 20 74 69 6d 65 73 2e 20 54 at all times. T
4a50: 68 65 20 74 72 69 67 67 65 72 20 73 63 72 69 70 he trigger scrip
4a60: 74 20 73 68 6f 75 6c 64 20 63 68 65 63 6b 20 66 t should check f
4a70: 6f 72 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 or the variable
4a80: 61 6e 64 0a 66 61 69 6c 20 67 72 61 63 65 66 75 and.fail gracefu
4a90: 6c 6c 79 20 69 66 20 69 74 20 64 6f 65 73 6e 27 lly if it doesn'
4aa0: 74 20 65 78 69 73 74 2e 0a 0a 2f 2f 20 2c 63 6f t exist...// ,co
4ab0: 6c 73 3d 22 5e 2c 32 6d 22 0a 0a 2e 45 6e 76 69 ls="^,2m"...Envi
4ac0: 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 ronment variable
4ad0: 73 20 76 69 73 69 62 6c 65 20 74 6f 20 74 68 65 s visible to the
4ae0: 20 74 72 69 67 67 65 72 20 73 63 72 69 70 74 0a trigger script.
4af0: 5b 77 69 64 74 68 3d 22 39 30 25 22 2c 66 72 61 [width="90%",fra
4b00: 6d 65 3d 22 74 6f 70 62 6f 74 22 2c 6f 70 74 69 me="topbot",opti
4b10: 6f 6e 73 3d 22 68 65 61 64 65 72 22 5d 0a 7c 3d ons="header"].|=
4b20: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
4b30: 3d 3d 3d 3d 3d 0a 7c 20 56 61 72 69 61 62 6c 65 =====.| Variable
4b40: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 50 75 | Pu
4b50: 72 70 6f 73 65 20 20 20 20 20 20 20 20 20 20 20 rpose
4b60: 20 0a 7c 20 4d 54 5f 54 45 53 54 5f 52 55 4e 5f .| MT_TEST_RUN_
4b70: 44 49 52 20 20 20 20 20 7c 20 54 68 65 20 64 69 DIR | The di
4b80: 72 65 63 74 6f 72 79 20 77 68 65 72 65 20 4d 65 rectory where Me
4b90: 67 61 74 65 73 74 20 72 61 6e 20 74 68 69 73 20 gatest ran this
4ba0: 74 65 73 74 20 20 20 20 20 20 20 20 20 20 20 20 test
4bb0: 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f 43 4d 44 .| MT_CMD
4bc0: 49 4e 46 4f 20 20 20 20 20 20 20 20 20 20 7c 20 INFO |
4bd0: 45 6e 63 6f 64 65 64 20 63 6f 6d 6d 61 6e 64 20 Encoded command
4be0: 64 61 74 61 20 66 6f 72 20 74 68 65 20 74 65 73 data for the tes
4bf0: 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t
4c00: 20 20 20 20 0a 7c 20 4d 54 5f 44 45 42 55 47 5f .| MT_DEBUG_
4c10: 4d 4f 44 45 20 20 20 20 20 20 20 7c 20 55 73 65 MODE | Use
4c20: 64 20 74 6f 20 70 61 73 73 20 74 68 65 20 64 65 d to pass the de
4c30: 62 75 67 20 6d 6f 64 65 20 74 6f 20 6e 65 73 74 bug mode to nest
4c40: 65 64 20 63 61 6c 6c 73 20 74 6f 20 4d 65 67 61 ed calls to Mega
4c50: 74 65 73 74 20 20 20 20 20 20 20 20 20 20 20 20 test
4c60: 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f 52 55 4e .| MT_RUN
4c70: 5f 41 52 45 41 5f 48 4f 4d 45 20 20 20 20 7c 20 _AREA_HOME |
4c80: 4d 65 67 61 74 65 73 74 20 68 6f 6d 65 20 61 72 Megatest home ar
4c90: 65 61 20 0a 7c 20 4d 54 5f 54 45 53 54 53 55 49 ea .| MT_TESTSUI
4ca0: 54 45 4e 41 4d 45 20 20 20 20 7c 20 54 68 65 20 TENAME | The
4cb0: 6e 61 6d 65 20 6f 66 20 74 68 69 73 20 74 65 73 name of this tes
4cc0: 74 73 75 69 74 65 20 6f 72 20 61 72 65 61 20 20 tsuite or area
4cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4ce0: 20 0a 7c 20 4d 54 5f 54 45 53 54 5f 4e 41 4d 45 .| MT_TEST_NAME
4cf0: 20 20 20 20 20 20 20 20 7c 20 54 68 65 20 6e 61 | The na
4d00: 6d 65 20 6f 66 20 74 68 69 73 20 74 65 73 74 0a me of this test.
4d10: 7c 20 4d 54 5f 49 54 45 4d 5f 49 4e 46 4f 20 20 | MT_ITEM_INFO
4d20: 20 20 20 20 20 20 7c 20 54 68 65 20 76 61 72 69 | The vari
4d30: 61 62 6c 65 20 61 6e 64 20 76 61 6c 75 65 73 20 able and values
4d40: 66 6f 72 20 74 68 65 20 74 65 73 74 20 69 74 65 for the test ite
4d50: 6d 0a 7c 20 4d 54 5f 4d 45 47 41 54 45 53 54 20 m.| MT_MEGATEST
4d60: 20 20 20 20 20 20 20 20 7c 20 57 68 69 63 68 20 | Which
4d70: 4d 65 67 61 74 65 73 74 20 62 69 6e 61 72 79 20 Megatest binary
4d80: 69 73 20 62 65 69 6e 67 20 75 73 65 64 20 62 79 is being used by
4d90: 20 74 68 69 73 20 61 72 65 61 0a 7c 20 4d 54 5f this area.| MT_
4da0: 54 41 52 47 45 54 20 20 20 20 20 20 20 20 20 20 TARGET
4db0: 20 7c 20 54 68 65 20 74 61 72 67 65 74 20 76 61 | The target va
4dc0: 72 69 61 62 6c 65 20 76 61 6c 75 65 73 2c 20 73 riable values, s
4dd0: 65 70 61 72 61 74 65 64 20 62 79 20 27 2f 27 0a eparated by '/'.
4de0: 7c 20 4d 54 5f 4c 49 4e 4b 54 52 45 45 20 20 20 | MT_LINKTREE
4df0: 20 20 20 20 20 20 7c 20 54 68 65 20 62 61 73 65 | The base
4e00: 20 6f 66 20 74 68 65 20 6c 69 6e 6b 20 74 72 65 of the link tre
4e10: 65 20 77 68 65 72 65 20 61 6c 6c 20 72 75 6e 20 e where all run
4e20: 74 65 73 74 73 20 63 61 6e 20 62 65 20 66 6f 75 tests can be fou
4e30: 6e 64 0a 7c 20 4d 54 5f 49 54 45 4d 50 41 54 48 nd.| MT_ITEMPATH
4e40: 20 20 20 20 20 20 20 20 20 7c 20 54 68 65 20 76 | The v
4e50: 61 6c 75 65 73 20 6f 66 20 74 68 65 20 69 74 65 alues of the ite
4e60: 6d 20 70 61 74 68 20 76 61 72 69 61 62 6c 65 73 m path variables
4e70: 2c 20 73 65 70 61 72 61 74 65 64 20 62 79 20 27 , separated by '
4e80: 2f 27 0a 7c 20 4d 54 5f 52 55 4e 4e 41 4d 45 20 /'.| MT_RUNNAME
4e90: 20 20 20 20 20 20 20 20 20 7c 20 54 68 65 20 6e | The n
4ea0: 61 6d 65 20 6f 66 20 74 68 65 20 72 75 6e 0a 7c ame of the run.|
4eb0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
4ec0: 3d 3d 3d 3d 3d 3d 0a 0a 0a 4f 76 65 72 72 69 64 ======...Overrid
4ed0: 65 20 74 68 65 20 54 6f 70 6c 65 76 65 6c 20 48 e the Toplevel H
4ee0: 54 4d 4c 20 46 69 6c 65 0a 7e 7e 7e 7e 7e 7e 7e TML File.~~~~~~~
4ef0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
4f00: 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 4d 65 67 61 74 65 ~~~~~~~~..Megate
4f10: 73 74 20 67 65 6e 65 72 61 74 65 73 20 61 20 73 st generates a s
4f20: 69 6d 70 6c 65 20 68 74 6d 6c 20 66 69 6c 65 20 imple html file
4f30: 73 75 6d 6d 61 72 79 20 66 6f 72 20 74 6f 70 20 summary for top
4f40: 6c 65 76 65 6c 20 74 65 73 74 73 20 6f 66 0a 69 level tests of.i
4f50: 74 65 72 61 74 65 64 20 74 65 73 74 73 2e 20 54 terated tests. T
4f60: 68 65 20 67 65 6e 65 72 61 74 69 6f 6e 20 63 61 he generation ca
4f70: 6e 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e 2e n be overridden.
4f80: 20 4e 4f 54 45 3a 20 74 68 65 20 6f 75 74 70 75 NOTE: the outpu
4f90: 74 20 6f 66 0a 74 68 65 20 73 63 72 69 70 74 20 t of.the script
4fa0: 69 73 20 63 61 70 74 75 72 65 64 20 66 72 6f 6d is captured from
4fb0: 20 73 74 64 6f 75 74 20 74 6f 20 63 72 65 61 74 stdout to creat
4fc0: 65 20 74 68 65 20 68 74 6d 6c 2e 0a 0a 0a 2e 46 e the html.....F
4fd0: 6f 72 20 74 65 73 74 20 22 72 75 6e 66 69 72 73 or test "runfirs
4fe0: 74 22 20 6f 76 65 72 72 69 64 65 20 74 68 65 20 t" override the
4ff0: 74 6f 70 6c 65 76 65 6c 20 67 65 6e 65 72 61 74 toplevel generat
5000: 69 6f 6e 20 77 69 74 68 20 61 20 73 63 72 69 70 ion with a scrip
5010: 74 20 22 6d 79 73 75 6d 6d 61 72 79 2e 73 68 22 t "mysummary.sh"
5020: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
5030: 2d 2d 0a 23 20 4f 76 65 72 72 69 64 65 20 74 68 --.# Override th
5040: 65 20 72 6f 6c 6c 75 70 20 66 6f 72 20 73 70 65 e rollup for spe
5050: 63 69 66 69 63 20 74 65 73 74 73 0a 5b 74 65 73 cific tests.[tes
5060: 74 72 6f 6c 6c 75 70 5d 0a 72 75 6e 66 69 72 73 trollup].runfirs
5070: 74 20 6d 79 73 75 6d 6d 61 72 79 2e 73 68 0a 2d t mysummary.sh.-
5080: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5090: 0a 0a 41 72 63 68 69 76 69 6e 67 20 53 65 74 75 ..Archiving Setu
50a0: 70 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d p.--------------
50b0: 2d 0a 0a 49 6e 20 6d 65 67 61 74 65 73 74 2e 63 -..In megatest.c
50c0: 6f 6e 66 69 67 20 61 64 64 20 74 68 65 20 66 6f onfig add the fo
50d0: 6c 6c 6f 77 69 6e 67 20 73 65 63 74 69 6f 6e 73 llowing sections
50e0: 3a 0a 0a 2e 6d 65 67 61 74 65 73 74 2e 63 6f 6e :...megatest.con
50f0: 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d fig.------------
5100: 2d 2d 0a 5b 61 72 63 68 69 76 65 5d 0a 23 20 77 --.[archive].# w
5110: 68 65 72 65 20 74 6f 20 67 65 74 20 62 75 70 20 here to get bup
5120: 65 78 65 63 75 74 61 62 6c 65 0a 23 20 62 75 70 executable.# bup
5130: 20 2f 70 61 74 68 2f 74 6f 2f 62 75 70 0a 0a 5b /path/to/bup..[
5140: 61 72 63 68 69 76 65 2d 64 69 73 6b 73 5d 0a 0a archive-disks]..
5150: 23 20 41 72 63 68 69 76 65 73 20 77 69 6c 6c 20 # Archives will
5160: 62 65 20 6f 72 67 61 6e 69 73 65 64 20 75 6e 64 be organised und
5170: 65 72 20 74 68 65 73 65 20 70 61 74 68 73 20 6c er these paths l
5180: 69 6b 65 20 74 68 69 73 3a 0a 23 20 20 3c 74 65 ike this:.# <te
5190: 73 74 73 75 69 74 65 3e 2f 3c 63 72 65 61 74 69 stsuite>/<creati
51a0: 6f 6e 64 61 74 65 3e 0a 23 20 57 69 74 68 69 6e ondate>.# Within
51b0: 20 74 68 65 20 61 72 63 68 69 76 65 20 74 68 65 the archive the
51c0: 20 64 61 74 61 20 69 73 20 73 74 72 75 63 74 75 data is structu
51d0: 72 65 64 20 6c 69 6b 65 20 74 68 69 73 3a 0a 23 red like this:.#
51e0: 20 20 3c 74 61 72 67 65 74 3e 2f 3c 72 75 6e 6e <target>/<runn
51f0: 61 6d 65 3e 2f 3c 74 65 73 74 3e 2f 0a 61 72 63 ame>/<test>/.arc
5200: 68 69 76 65 30 20 2f 6d 66 73 2f 6d 79 61 72 63 hive0 /mfs/myarc
5210: 68 69 76 65 2d 64 61 74 61 2f 61 64 69 73 6b 31 hive-data/adisk1
5220: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a .--------------.
5230: 0a 45 6e 76 69 72 6f 6e 6d 65 6e 74 20 56 61 72 .Environment Var
5240: 69 61 62 6c 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d iables.---------
5250: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 74 ------------..It
5260: 20 69 73 20 6f 66 74 65 6e 20 6e 65 63 65 73 73 is often necess
5270: 61 72 79 20 74 6f 20 63 61 70 74 75 72 65 20 61 ary to capture a
5280: 6e 64 20 6f 72 20 6d 61 6e 69 70 75 6c 61 74 65 nd or manipulate
5290: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 0a 76 61 72 environment.var
52a0: 69 61 62 6c 65 73 2e 20 4d 65 67 61 74 65 73 74 iables. Megatest
52b0: 20 68 61 73 20 73 6f 6d 65 20 66 61 63 69 6c 69 has some facili
52c0: 74 69 65 73 20 62 75 69 6c 74 20 69 6e 20 74 6f ties built in to
52d0: 20 68 65 6c 70 2e 0a 0a 43 61 70 74 75 72 65 20 help...Capture
52e0: 76 61 72 69 61 62 6c 65 73 0a 7e 7e 7e 7e 7e 7e variables.~~~~~~
52f0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 43 6f ~~~~~~~~~~~...Co
5300: 6d 6d 61 6e 64 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d mmands.---------
5310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5320: 2d 2d 2d 2d 2d 0a 23 20 63 61 70 74 75 72 65 20 -----.# capture
5330: 74 68 65 20 63 75 72 72 65 6e 74 20 65 6e 76 69 the current envi
5340: 72 6f 6d 65 6e 74 20 69 6e 74 6f 20 61 20 64 62 roment into a db
5350: 20 63 61 6c 6c 65 64 20 65 6e 76 64 61 74 2e 64 called envdat.d
5360: 62 20 75 6e 64 65 72 0a 23 20 74 68 65 20 63 6f b under.# the co
5370: 6e 74 65 78 74 20 22 62 65 66 6f 72 65 22 0a 6d ntext "before".m
5380: 65 67 61 74 65 73 74 20 2d 65 6e 76 63 61 70 20 egatest -envcap
5390: 62 65 66 6f 72 65 0a 0a 23 20 63 61 70 74 75 72 before..# captur
53a0: 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 65 6e e the current en
53b0: 76 69 72 6f 6e 6d 65 6e 74 20 69 6e 74 6f 20 61 vironment into a
53c0: 20 64 62 20 63 61 6c 6c 65 64 20 73 74 61 72 74 db called start
53d0: 75 70 2e 64 62 20 77 69 74 68 20 0a 23 20 63 6f up.db with .# co
53e0: 6e 74 65 78 74 20 22 61 66 74 65 72 22 0a 6d 65 ntext "after".me
53f0: 67 61 74 65 73 74 20 2d 65 6e 76 63 61 70 20 61 gatest -envcap a
5400: 66 74 65 72 20 73 74 61 72 74 75 70 2e 64 62 0a fter startup.db.
5410: 0a 23 20 77 72 69 74 65 20 74 68 65 20 64 69 66 .# write the dif
5420: 66 20 66 72 6f 6d 20 62 65 66 6f 72 65 20 74 6f f from before to
5430: 20 61 66 74 65 72 0a 6d 65 67 61 74 65 73 74 20 after.megatest
5440: 2d 65 6e 76 64 65 6c 74 61 20 62 65 66 6f 72 65 -envdelta before
5450: 2d 61 66 74 65 72 20 2d 64 75 6d 70 6d 6f 64 65 -after -dumpmode
5460: 20 62 61 73 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d bash.----------
5470: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5480: 2d 2d 2d 2d 0a 0a 44 75 6d 70 20 6d 6f 64 65 73 ----..Dump modes
5490: 20 69 6e 63 6c 75 64 65 20 62 61 73 68 2c 20 63 include bash, c
54a0: 73 68 20 61 6e 64 20 63 6f 6e 66 69 67 2e 20 59 sh and config. Y
54b0: 6f 75 20 63 61 6e 20 69 6e 63 6c 75 64 65 20 63 ou can include c
54c0: 6f 6e 66 69 67 20 64 61 74 61 0a 69 6e 74 6f 20 onfig data.into
54d0: 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 2c megatest.config,
54e0: 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 runconfigs.conf
54f0: 69 67 20 61 6e 64 20 74 65 73 74 63 6f 6e 66 69 ig and testconfi
5500: 67 20 66 69 6c 65 73 2e 20 54 68 69 73 20 69 73 g files. This is
5510: 0a 75 73 65 66 75 6c 20 66 6f 72 20 63 61 70 74 .useful for capt
5520: 75 72 69 6e 67 20 61 20 63 6f 6d 70 6c 65 78 20 uring a complex
5530: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 69 6e 20 61 environment in a
5540: 20 73 70 65 63 69 61 6c 2d 70 75 72 70 6f 73 65 special-purpose
5550: 20 74 65 73 74 0a 61 6e 64 20 74 68 65 6e 20 75 test.and then u
5560: 74 69 6c 69 7a 69 6e 67 20 74 68 61 74 20 65 6e tilizing that en
5570: 76 69 72 6f 6e 6d 65 6e 74 20 69 6e 20 64 6f 77 vironment in dow
5580: 6e 73 74 72 65 61 6d 20 74 65 73 74 73 2e 0a 0a nstream tests...
5590: 2e 45 78 61 6d 70 6c 65 20 6f 66 20 67 65 6e 65 .Example of gene
55a0: 72 61 74 69 6e 67 20 61 6e 64 20 75 73 69 6e 67 rating and using
55b0: 20 63 6f 6e 66 69 67 20 64 61 74 61 0a 2d 2d 2d config data.---
55c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
55d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 6d 65 67 61 -----------.mega
55e0: 74 65 73 74 20 2d 65 6e 76 63 61 70 20 6f 72 69 test -envcap ori
55f0: 67 69 6e 61 6c 0a 23 20 64 6f 20 73 6f 6d 65 20 ginal.# do some
5600: 73 74 75 66 66 20 68 65 72 65 0a 6d 65 67 61 74 stuff here.megat
5610: 65 73 74 20 2d 65 6e 76 63 61 70 20 6d 75 6e 67 est -envcap mung
5620: 65 64 0a 6d 65 67 61 74 65 73 74 20 2d 65 6e 76 ed.megatest -env
5630: 64 65 6c 74 61 20 6f 72 69 67 69 6e 61 6c 2d 6d delta original-m
5640: 75 6e 67 65 64 20 2d 64 75 6d 70 6d 6f 64 65 20 unged -dumpmode
5650: 69 6e 69 20 2d 6f 20 6d 6f 64 69 66 69 65 64 2e ini -o modified.
5660: 63 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d config.---------
5670: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5680: 2d 2d 2d 2d 2d 0a 0a 54 68 65 6e 20 69 6e 20 72 -----..Then in r
5690: 75 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 unconfigs.config
56a0: 0a 0a 2e 45 78 61 6d 70 6c 65 20 6f 66 20 75 73 ...Example of us
56b0: 69 6e 67 20 6d 6f 64 69 66 69 65 64 2e 63 6f 6e ing modified.con
56c0: 66 69 67 20 69 6e 20 61 20 74 65 73 74 63 6f 6e fig in a testcon
56d0: 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d fig.------------
56e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
56f0: 2d 2d 0a 5b 70 72 65 2d 6c 61 75 6e 63 68 2d 65 --.[pre-launch-e
5700: 6e 76 2d 76 61 72 73 5d 0a 5b 69 6e 63 6c 75 64 nv-vars].[includ
5710: 65 20 6d 6f 64 69 66 69 65 64 2e 63 6f 6e 66 69 e modified.confi
5720: 67 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d g].-------------
5730: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5740: 2d 0a 0a 4d 61 6e 61 67 69 6e 67 20 4f 6c 64 20 -..Managing Old
5750: 52 75 6e 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d Runs.-----------
5760: 2d 2d 2d 2d 2d 2d 0a 0a 49 74 20 69 73 20 6f 66 ------..It is of
5770: 74 65 6e 20 64 65 73 69 72 65 64 20 74 6f 20 6b ten desired to k
5780: 65 65 70 20 73 6f 6d 65 20 6f 6c 64 65 72 20 72 eep some older r
5790: 75 6e 73 20 61 72 6f 75 6e 64 20 62 75 74 20 74 uns around but t
57a0: 68 69 73 20 6d 75 73 74 20 62 65 20 62 61 6c 61 his must be bala
57b0: 6e 63 65 64 20 77 69 74 68 20 74 68 65 20 63 6f nced with the co
57c0: 73 74 73 20 6f 66 20 64 69 73 6b 20 73 70 61 63 sts of disk spac
57d0: 65 2e 0a 0a 2e 20 55 73 65 20 2d 72 65 6d 6f 76 e.... Use -remov
57e0: 65 2d 6b 65 65 70 0a 2e 20 55 73 65 20 2d 61 72 e-keep.. Use -ar
57f0: 63 68 69 76 65 20 28 63 61 6e 20 61 6c 73 6f 20 chive (can also
5800: 62 65 20 64 6f 6e 65 20 66 72 6f 6d 20 74 68 65 be done from the
5810: 20 2d 72 65 6d 6f 76 65 2d 6b 65 65 70 20 69 6e -remove-keep in
5820: 74 65 72 66 61 63 65 29 0a 2e 20 75 73 65 20 2d terface).. use -
5830: 72 65 6d 6f 76 65 2d 72 75 6e 73 20 77 69 74 68 remove-runs with
5840: 20 2d 6b 65 65 70 2d 72 65 63 6f 72 64 73 0a 0a -keep-records..
5850: 2e 46 6f 72 20 65 61 63 68 20 74 61 72 67 65 74 .For each target
5860: 2c 20 72 65 6d 6f 76 65 20 61 6c 6c 20 72 75 6e , remove all run
5870: 73 20 62 75 74 20 74 68 65 20 6d 6f 73 74 20 72 s but the most r
5880: 65 63 65 6e 74 20 33 20 69 66 20 74 68 65 79 20 ecent 3 if they
5890: 61 72 65 20 6f 76 65 72 20 31 20 77 65 65 6b 20 are over 1 week
58a0: 6f 6c 64 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d old.------------
58b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 75 73 65 20 ---------.# use
58c0: 2d 70 72 65 63 6d 64 20 27 73 6c 65 65 70 20 35 -precmd 'sleep 5
58d0: 3b 6e 62 66 61 6b 65 27 20 74 6f 20 6c 69 6d 69 ;nbfake' to limi
58e0: 74 20 6f 76 65 72 6c 6f 61 64 69 6e 67 20 74 68 t overloading th
58f0: 65 20 68 6f 73 74 20 63 6f 6d 70 75 74 65 72 20 e host computer
5900: 62 75 74 20 74 6f 20 61 6c 6c 6f 77 20 74 68 65 but to allow the
5910: 20 72 65 6d 6f 76 65 73 20 74 6f 20 72 75 6e 20 removes to run
5920: 69 6e 20 70 61 72 61 6c 6c 65 6c 2e 0a 6d 65 67 in parallel..meg
5930: 61 74 65 73 74 20 2d 61 63 74 69 6f 6e 73 20 70 atest -actions p
5940: 72 69 6e 74 2c 72 65 6d 6f 76 65 2d 72 75 6e 73 rint,remove-runs
5950: 20 2d 72 65 6d 6f 76 65 2d 6b 65 65 70 20 33 20 -remove-keep 3
5960: 2d 74 61 72 67 65 74 20 25 2f 25 2f 25 2f 25 20 -target %/%/%/%
5970: 2d 72 75 6e 6e 61 6d 65 20 25 20 2d 61 67 65 20 -runname % -age
5980: 31 77 20 2d 70 72 65 63 6d 64 20 27 73 6c 65 65 1w -precmd 'slee
5990: 70 20 35 3b 6e 62 66 61 6b 65 27 22 0a 2d 2d 2d p 5;nbfake'".---
59a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
59b0: 2d 2d 0a 0a 4e 65 73 74 65 64 20 52 75 6e 73 0a --..Nested Runs.
59c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 20 4d -----------..A M
59d0: 65 67 61 74 65 73 74 20 74 65 73 74 20 63 61 6e egatest test can
59e0: 20 72 75 6e 20 61 20 66 75 6c 6c 20 4d 65 67 61 run a full Mega
59f0: 74 65 73 74 20 72 75 6e 20 69 6e 20 65 69 74 68 test run in eith
5a00: 65 72 20 74 68 65 20 73 61 6d 65 0a 4d 65 67 61 er the same.Mega
5a10: 74 65 73 74 20 61 72 65 61 20 6f 72 20 69 6e 20 test area or in
5a20: 61 6e 6f 74 68 65 72 20 61 72 65 61 2e 20 54 68 another area. Th
5a30: 69 73 20 69 73 20 61 20 70 6f 77 65 72 66 75 6c is is a powerful
5a40: 20 77 61 79 20 6f 66 20 63 68 61 69 6e 69 6e 67 way of chaining
5a50: 0a 63 6f 6d 70 6c 65 78 20 73 75 69 74 65 73 20 .complex suites
5a60: 6f 66 20 74 65 73 74 73 20 61 6e 64 20 6f 72 20 of tests and or
5a70: 61 63 74 69 6f 6e 73 2e 0a 0a 49 66 20 79 6f 75 actions...If you
5a80: 20 61 72 65 20 6e 6f 74 20 75 73 69 6e 67 20 74 are not using t
5a90: 68 65 20 63 75 72 72 65 6e 74 20 61 72 65 61 20 he current area
5aa0: 79 6f 75 20 63 61 6e 20 75 73 65 20 65 7a 73 74 you can use ezst
5ab0: 65 70 73 20 74 6f 20 72 65 74 72 69 65 76 65 0a eps to retrieve.
5ac0: 61 6e 64 20 73 65 74 75 70 20 74 68 65 20 73 75 and setup the su
5ad0: 62 2d 4d 65 67 61 74 65 73 74 20 72 75 6e 20 61 b-Megatest run a
5ae0: 72 65 61 2e 0a 0a 49 6e 20 74 68 65 20 74 65 73 rea...In the tes
5af0: 74 63 6f 6e 66 69 67 3a 0a 2d 2d 2d 2d 2d 2d 2d tconfig:.-------
5b00: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 75 62 72 75 6e --------.[subrun
5b10: 5d 0a 0a 23 20 52 65 71 75 69 72 65 64 3a 20 77 ]..# Required: w
5b20: 61 69 74 20 66 6f 72 20 74 68 65 20 72 75 6e 20 ait for the run
5b30: 6f 72 20 6a 75 73 74 20 6c 61 75 6e 63 68 20 69 or just launch i
5b40: 74 0a 23 20 20 20 20 20 20 20 20 20 20 20 69 66 t.# if
5b50: 20 6e 6f 20 74 68 65 6e 20 74 68 65 20 72 75 6e no then the run
5b60: 20 77 69 6c 6c 20 62 65 20 61 6e 20 61 75 74 6f will be an auto
5b70: 6d 61 74 69 63 20 50 41 53 53 20 69 72 72 65 73 matic PASS irres
5b80: 70 65 63 74 69 76 65 20 6f 66 20 74 68 65 20 61 pective of the a
5b90: 63 74 75 61 6c 20 72 65 73 75 6c 74 0a 72 75 6e ctual result.run
5ba0: 2d 77 61 69 74 20 79 65 73 7c 6e 6f 0a 0a 23 20 -wait yes|no..#
5bb0: 4f 70 74 69 6f 6e 61 6c 3a 20 77 68 65 72 65 20 Optional: where
5bc0: 74 6f 20 65 78 65 63 75 74 65 20 74 68 65 20 72 to execute the r
5bd0: 75 6e 2e 20 44 65 66 61 75 6c 74 20 69 73 20 74 un. Default is t
5be0: 68 65 20 63 75 72 72 65 6e 74 20 72 75 6e 61 72 he current runar
5bf0: 65 61 0a 72 75 6e 2d 61 72 65 61 20 2f 73 6f 6d ea.run-area /som
5c00: 65 2f 70 61 74 68 2f 74 6f 2f 6d 65 67 61 74 65 e/path/to/megate
5c10: 73 74 2f 61 72 65 61 0a 0a 23 20 4f 70 74 69 6f st/area..# Optio
5c20: 6e 61 6c 3a 20 6d 65 74 68 6f 64 20 74 6f 20 75 nal: method to u
5c30: 73 65 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 se to determine
5c40: 70 61 73 73 2f 66 61 69 6c 20 73 74 61 74 75 73 pass/fail status
5c50: 20 6f 66 20 74 68 65 20 72 75 6e 0a 23 20 20 20 of the run.#
5c60: 61 75 74 6f 20 28 64 65 66 61 75 6c 74 29 20 2d auto (default) -
5c70: 20 72 6f 6c 6c 20 75 70 20 74 68 65 20 6e 65 74 roll up the net
5c80: 20 73 74 61 74 65 2f 73 74 61 74 75 73 20 6f 66 state/status of
5c90: 20 74 68 65 20 73 75 62 2d 72 75 6e 0a 23 20 20 the sub-run.#
5ca0: 20 6c 6f 67 70 72 6f 20 20 20 20 20 20 20 20 20 logpro
5cb0: 2d 20 75 73 65 20 74 68 65 20 70 72 6f 76 69 64 - use the provid
5cc0: 65 64 20 6c 6f 67 70 72 6f 20 72 75 6c 65 73 2c ed logpro rules,
5cd0: 20 68 61 70 70 65 6e 73 20 61 75 74 6f 6d 61 74 happens automat
5ce0: 69 63 61 6c 6c 79 20 69 66 20 74 68 65 72 65 20 ically if there
5cf0: 69 73 20 61 20 6c 6f 67 70 72 6f 20 73 65 63 74 is a logpro sect
5d00: 69 6f 6e 0a 23 20 70 61 73 73 66 61 69 6c 20 61 ion.# passfail a
5d10: 75 74 6f 7c 6c 6f 67 70 72 6f 0a 23 20 45 78 61 uto|logpro.# Exa
5d20: 6d 70 6c 65 20 6f 66 20 6c 6f 67 70 72 6f 3a 0a mple of logpro:.
5d30: 70 61 73 73 66 61 69 6c 20 6c 6f 67 70 72 6f 0a passfail logpro.
5d40: 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 0a 6c 6f .# Optional: .lo
5d50: 67 70 72 6f 20 3b 3b 20 69 66 20 74 68 69 73 20 gpro ;; if this
5d60: 73 65 63 74 69 6f 6e 20 65 78 69 73 74 73 20 74 section exists t
5d70: 68 65 6e 20 6c 6f 67 70 72 6f 20 69 73 20 75 73 hen logpro is us
5d80: 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 ed to determine
5d90: 70 61 73 73 2f 66 61 69 6c 0a 20 20 28 65 78 70 pass/fail. (exp
5da0: 65 63 74 3a 72 65 71 75 69 72 65 64 20 69 6e 20 ect:required in
5db0: 22 4c 6f 67 46 69 6c 65 42 6f 64 79 22 20 3e 3d "LogFileBody" >=
5dc0: 20 31 20 22 41 74 20 6c 65 61 73 74 20 6f 6e 65 1 "At least one
5dd0: 20 70 61 73 73 22 20 23 2f 50 41 53 53 2f 29 0a pass" #/PASS/).
5de0: 20 20 28 65 78 70 65 63 74 3a 65 72 72 6f 72 20 (expect:error
5df0: 20 20 20 20 69 6e 20 22 4c 6f 67 46 69 6c 65 42 in "LogFileB
5e00: 6f 64 79 22 20 20 3d 20 30 20 22 4e 6f 20 46 41 ody" = 0 "No FA
5e10: 49 4c 73 20 61 6c 6c 6f 77 65 64 22 20 20 23 2f ILs allowed" #/
5e20: 46 41 49 4c 2f 29 0a 0a 23 20 4f 70 74 69 6f 6e FAIL/)..# Option
5e30: 61 6c 3a 20 74 61 72 67 65 74 20 74 72 61 6e 73 al: target trans
5e40: 6c 61 74 6f 72 2c 20 64 65 66 61 75 6c 74 20 69 lator, default i
5e50: 73 20 74 6f 20 75 73 65 20 74 68 65 20 70 61 72 s to use the par
5e60: 65 6e 74 20 74 61 72 67 65 74 0a 74 61 72 67 65 ent target.targe
5e70: 74 20 23 7b 73 68 65 6c 6c 20 73 6f 6d 65 73 63 t #{shell somesc
5e80: 72 69 70 74 2e 73 68 7d 0a 0a 23 20 4f 70 74 69 ript.sh}..# Opti
5e90: 6f 6e 61 6c 3a 20 72 75 6e 6e 61 6d 65 20 74 72 onal: runname tr
5ea0: 61 6e 73 6c 61 74 6f 72 2f 67 65 6e 65 72 61 74 anslator/generat
5eb0: 6f 72 2c 20 64 65 66 61 75 6c 74 20 69 73 20 74 or, default is t
5ec0: 6f 20 75 73 65 20 74 68 65 20 70 61 72 65 6e 74 o use the parent
5ed0: 20 72 75 6e 6e 61 6d 65 0a 72 75 6e 2d 6e 61 6d runname.run-nam
5ee0: 65 20 23 7b 73 6f 6d 65 73 63 72 69 70 74 2e 73 e #{somescript.s
5ef0: 68 7d 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 h}..# Optional:
5f00: 74 65 73 74 70 61 74 74 20 73 70 65 63 2c 20 64 testpatt spec, d
5f10: 65 66 61 75 6c 74 20 69 73 20 74 6f 20 66 69 72 efault is to fir
5f20: 73 74 20 6c 6f 6f 6b 20 66 6f 72 20 54 45 53 54 st look for TEST
5f30: 50 41 54 54 20 73 70 65 63 20 66 72 6f 6d 20 72 PATT spec from r
5f40: 75 6e 63 6f 6e 66 69 67 73 20 75 6e 6c 65 73 73 unconfigs unless
5f50: 20 74 68 65 72 65 20 69 73 20 61 20 63 6f 6e 74 there is a cont
5f60: 6f 75 72 20 73 70 65 63 0a 74 65 73 74 2d 70 61 our spec.test-pa
5f70: 74 74 20 25 2f 69 74 65 6d 31 2c 74 65 73 74 32 tt %/item1,test2
5f80: 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 63 6f ..# Optional: co
5f90: 6e 74 6f 75 72 20 73 70 65 63 2c 20 75 73 65 20 ntour spec, use
5fa0: 74 68 65 20 6e 61 6d 65 64 20 63 6f 6e 74 6f 75 the named contou
5fb0: 72 20 66 72 6f 6d 20 74 68 65 20 6d 65 67 61 74 r from the megat
5fc0: 65 73 74 2e 63 6f 6e 66 69 67 20 63 6f 6e 74 6f est.config conto
5fd0: 75 72 20 73 70 65 63 0a 63 6f 6e 74 6f 75 72 20 ur spec.contour
5fe0: 63 6f 6e 74 6f 75 72 6e 61 6d 65 20 23 23 23 20 contourname ###
5ff0: 4e 4f 54 45 3a 20 4e 6f 74 20 69 6d 70 6c 65 6d NOTE: Not implem
6000: 65 6e 74 65 64 20 79 65 74 21 20 4c 65 74 20 75 ented yet! Let u
6010: 73 20 6b 6e 6f 77 20 69 66 20 79 6f 75 20 6e 65 s know if you ne
6020: 65 64 20 74 68 69 73 20 66 65 61 74 75 72 65 2e ed this feature.
6030: 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 6d 6f ..# Optional: mo
6040: 64 65 2d 70 61 74 74 2c 20 75 73 65 20 74 68 69 de-patt, use thi
6050: 73 20 73 70 65 63 20 66 6f 72 20 74 65 73 74 70 s spec for testp
6060: 61 74 74 20 66 72 6f 6d 20 72 75 6e 63 6f 6e 66 att from runconf
6070: 69 67 73 0a 6d 6f 64 65 2d 70 61 74 74 20 54 45 igs.mode-patt TE
6080: 53 54 50 41 54 54 0a 0a 23 20 4f 70 74 69 6f 6e STPATT..# Option
6090: 61 6c 3a 20 74 61 67 2d 65 78 70 72 2c 20 75 73 al: tag-expr, us
60a0: 65 20 74 68 69 73 20 74 61 67 2d 65 78 70 72 20 e this tag-expr
60b0: 74 6f 20 73 65 6c 65 63 74 20 74 65 73 74 73 0a to select tests.
60c0: 74 61 67 2d 65 78 70 72 20 71 75 69 63 6b 0a 0a tag-expr quick..
60d0: 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 28 6e 6f 74 # Optional: (not
60e0: 20 79 65 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 yet implemented
60f0: 2c 20 72 65 6d 6f 76 65 2d 72 75 6e 73 20 69 73 , remove-runs is
6100: 20 61 6c 77 61 79 73 20 70 72 6f 70 61 67 61 74 always propagat
6110: 65 64 20 61 74 20 74 68 69 73 20 74 69 6d 65 29 ed at this time)
6120: 2c 20 70 72 6f 70 61 67 61 74 65 20 74 68 65 73 , propagate thes
6130: 65 20 61 63 74 69 6f 6e 73 20 66 72 6f 6d 20 74 e actions from t
6140: 68 65 20 70 61 72 65 6e 74 0a 23 20 20 20 20 20 he parent.#
6150: 20 20 20 20 20 20 74 65 73 74 0a 23 20 20 20 4e test.# N
6160: 6f 74 65 2f 2f 20 64 65 66 61 75 6c 74 20 69 73 ote// default is
6170: 20 25 20 66 6f 72 20 61 6c 6c 0a 70 72 6f 70 61 % for all.propa
6180: 67 61 74 65 20 72 65 6d 6f 76 65 2d 72 75 6e 73 gate remove-runs
6190: 20 61 72 63 68 69 76 65 20 2e 2e 2e 0a 0a 2d 2d archive .....--
61a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 -------------..P
61b0: 72 6f 67 72 61 6d 6d 69 6e 67 20 41 50 49 0a 2d rogramming API.-
61c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
61d0: 54 68 65 73 65 20 72 6f 75 74 69 6e 65 73 20 63 These routines c
61e0: 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 66 72 6f an be called fro
61f0: 6d 20 74 68 65 20 6d 65 67 61 74 65 73 74 20 72 m the megatest r
6200: 65 70 6c 2e 20 0a 0a 2e 41 50 49 20 4b 65 79 73 epl. ...API Keys
6210: 20 52 65 6c 61 74 65 64 20 43 61 6c 6c 73 0a 5b Related Calls.[
6220: 77 69 64 74 68 3d 22 37 30 25 22 2c 63 6f 6c 73 width="70%",cols
6230: 3d 22 5e 2c 32 6d 2c 32 6d 2c 32 6d 22 2c 66 72 ="^,2m,2m,2m",fr
6240: 61 6d 65 3d 22 74 6f 70 62 6f 74 22 2c 6f 70 74 ame="topbot",opt
6250: 69 6f 6e 73 3d 22 68 65 61 64 65 72 2c 66 6f 6f ions="header,foo
6260: 74 65 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d ter"].|=========
6270: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 41 =============.|A
6280: 50 49 20 43 61 6c 6c 20 20 20 20 20 20 20 20 20 PI Call
6290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
62a0: 20 50 75 72 70 6f 73 65 20 63 6f 6d 6d 65 6e 74 Purpose comment
62b0: 73 20 20 20 7c 20 52 65 74 75 72 6e 73 20 20 20 s | Returns
62c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
62d0: 43 6f 6d 6d 65 6e 74 73 0a 7c 28 72 6d 74 3a 67 Comments.|(rmt:g
62e0: 65 74 2d 6b 65 79 73 20 72 75 6e 2d 69 64 29 20 et-keys run-id)
62f0: 20 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 |
6300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
6310: 20 28 20 6b 65 79 31 20 6b 65 79 32 20 2e 2e 2e ( key1 key2 ...
6320: 20 29 20 20 20 20 20 20 20 7c 20 0a 7c 20 28 72 ) | .| (r
6330: 6d 74 3a 67 65 74 2d 6b 65 79 2d 76 61 6c 2d 70 mt:get-key-val-p
6340: 61 69 72 73 20 72 75 6e 2d 69 64 29 20 7c 20 20 airs run-id) |
6350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6360: 20 20 7c 20 23 74 3d 73 75 63 63 65 73 73 2f 23 | #t=success/#
6370: 66 3d 66 61 69 6c 20 20 20 20 20 20 7c 20 57 6f f=fail | Wo
6380: 72 6b 73 20 6f 6e 6c 79 20 69 66 20 74 68 65 20 rks only if the
6390: 73 65 72 76 65 72 20 69 73 20 73 74 69 6c 6c 20 server is still
63a0: 72 65 61 63 68 61 62 6c 65 0a 7c 3d 3d 3d 3d 3d reachable.|=====
63b0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
63c0: 3d 0a 0a 0a 3a 6e 75 6d 62 65 72 65 64 21 3a 0a =...:numbered!:.