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: 43 6f 6e 66 69 67 20 46 69 6c 65 20 48 65 6c 70 Config File Help
02f0: 65 72 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ers.~~~~~~~~~~~~
0300: 7e 7e 7e 7e 7e 7e 7e 0a 0a 56 61 72 69 6f 75 73 ~~~~~~~..Various
0310: 20 68 65 6c 70 65 72 73 20 66 6f 72 20 6d 6f 72 helpers for mor
0320: 65 20 61 64 76 61 6e 63 65 64 20 63 6f 6e 66 69 e advanced confi
0330: 67 20 66 69 6c 65 73 2e 0a 0a 2e 48 65 6c 70 65 g files....Helpe
0340: 72 73 0a 5b 77 69 64 74 68 3d 22 38 30 25 22 2c rs.[width="80%",
0350: 63 6f 6c 73 3d 22 5e 2c 32 6d 2c 32 6d 2c 32 6d cols="^,2m,2m,2m
0360: 22 2c 66 72 61 6d 65 3d 22 74 6f 70 62 6f 74 22 ",frame="topbot"
0370: 2c 6f 70 74 69 6f 6e 73 3d 22 68 65 61 64 65 72 ,options="header
0380: 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d "].|============
0390: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 48 65 6c 70 ==========.|Help
03a0: 65 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 er
03b0: 20 20 20 20 20 20 20 20 7c 20 50 75 72 70 6f 73 | Purpos
03c0: 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e
03d0: 20 20 20 20 20 20 20 20 7c 20 56 61 6c 69 64 20 | Valid
03e0: 76 61 6c 75 65 73 20 20 20 20 20 20 20 20 20 20 values
03f0: 20 20 7c 20 43 6f 6d 6d 65 6e 74 73 0a 7c 20 23 | Comments.| #
0400: 7b 73 63 68 65 6d 65 20 28 73 63 68 65 6d 65 20 {scheme (scheme
0410: 63 6f 64 65 2e 2e 2e 29 7d 20 7c 20 45 78 65 63 code...)} | Exec
0420: 75 74 65 20 61 72 62 69 74 72 61 72 79 20 73 63 ute arbitrary sc
0430: 68 65 6d 65 20 63 6f 64 65 20 7c 20 41 6e 79 20 heme code | Any
0440: 76 61 6c 69 64 20 73 63 68 65 6d 65 20 20 20 20 valid scheme
0450: 20 20 20 20 7c 20 56 61 6c 75 65 20 72 65 74 75 | Value retu
0460: 72 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 63 61 rned from the ca
0470: 6c 6c 20 69 73 20 63 6f 6e 76 65 72 74 65 64 20 ll is converted
0480: 74 6f 20 61 20 73 74 72 69 6e 67 20 61 6e 64 20 to a string and
0490: 70 72 6f 63 65 73 73 65 64 20 61 73 20 70 61 72 processed as par
04a0: 74 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 20 t of the config
04b0: 66 69 6c 65 0a 7c 20 23 7b 73 79 73 74 65 6d 20 file.| #{system
04c0: 63 6f 6d 6d 61 6e 64 7d 20 20 20 20 20 20 20 20 command}
04d0: 20 20 7c 20 45 78 65 63 75 74 65 20 70 72 6f 67 | Execute prog
04e0: 72 61 6d 2c 20 69 6e 73 65 72 74 73 20 65 78 69 ram, inserts exi
04f0: 74 20 63 6f 64 65 20 20 7c 20 41 6e 79 20 76 61 t code | Any va
0500: 6c 69 64 20 55 6e 69 78 20 63 6f 6d 6d 61 6e 64 lid Unix command
0510: 20 20 7c 20 44 69 73 63 61 72 64 73 20 74 68 65 | Discards the
0520: 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 65 output from the
0530: 20 70 72 6f 67 72 61 6d 0a 7c 20 23 7b 73 68 65 program.| #{she
0540: 6c 6c 20 20 63 6f 6d 6d 61 6e 64 7d 20 6f 72 20 ll command} or
0550: 23 7b 73 68 20 2e 2e 2e 7d 20 20 7c 20 45 78 65 #{sh ...} | Exe
0560: 63 75 74 65 20 70 72 6f 67 72 61 6d 2c 20 69 6e cute program, in
0570: 73 65 72 74 73 20 72 65 73 75 6c 74 20 66 72 6f serts result fro
0580: 6d 20 73 74 64 6f 75 74 20 7c 20 41 6e 79 20 76 m stdout | Any v
0590: 61 6c 69 64 20 55 6e 69 78 20 63 6f 6d 6d 61 6e alid Unix comman
05a0: 64 20 7c 20 56 61 6c 75 65 20 72 65 74 75 72 6e d | Value return
05b0: 65 64 20 66 72 6f 6d 20 74 68 65 20 63 61 6c 6c ed from the call
05c0: 20 69 73 20 63 6f 6e 76 65 72 74 65 64 20 74 6f is converted to
05d0: 20 61 20 73 74 72 69 6e 67 20 61 6e 64 20 70 72 a string and pr
05e0: 6f 63 65 73 73 65 64 20 61 73 20 70 61 72 74 20 ocessed as part
05f0: 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 20 66 69 of the config fi
0600: 6c 65 0a 7c 20 23 7b 72 65 61 6c 70 61 74 68 20 le.| #{realpath
0610: 70 61 74 68 7d 20 6f 72 20 23 7b 72 70 20 2e 2e path} or #{rp ..
0620: 2e 7d 20 20 20 7c 20 52 65 70 6c 61 63 65 20 77 .} | Replace w
0630: 69 74 68 20 6e 6f 72 6d 61 6c 69 7a 65 64 20 70 ith normalized p
0640: 61 74 68 20 7c 20 4d 75 73 74 20 62 65 20 61 20 ath | Must be a
0650: 76 61 6c 69 64 20 70 61 74 68 20 7c 0a 7c 20 23 valid path |.| #
0660: 7b 67 65 74 65 6e 76 20 56 41 52 7d 20 6f 72 20 {getenv VAR} or
0670: 23 7b 67 76 20 56 41 52 7d 20 20 20 20 20 20 7c #{gv VAR} |
0680: 20 52 65 70 6c 61 63 65 20 77 69 74 68 20 63 6f Replace with co
0690: 6e 74 65 6e 74 20 6f 66 20 65 6e 76 20 76 61 72 ntent of env var
06a0: 69 61 62 6c 65 20 7c 20 4d 75 73 74 20 62 65 20 iable | Must be
06b0: 61 20 76 61 6c 69 64 20 76 61 72 20 7c 0a 7c 20 a valid var |.|
06c0: 23 7b 67 65 74 20 73 20 76 7d 20 6f 72 20 23 7b #{get s v} or #{
06d0: 67 20 73 20 76 7d 20 20 20 20 20 7c 20 52 65 70 g s v} | Rep
06e0: 6c 61 63 65 20 77 69 74 68 20 76 61 72 69 61 62 lace with variab
06f0: 6c 65 20 76 20 66 72 6f 6d 20 73 65 63 74 69 6f le v from sectio
0700: 6e 20 73 20 7c 20 56 61 72 69 61 62 6c 65 20 6d n s | Variable m
0710: 75 73 74 20 62 65 20 64 65 66 69 6e 65 64 20 62 ust be defined b
0720: 65 66 6f 72 65 20 75 73 65 20 7c 0a 7c 20 23 7b efore use |.| #{
0730: 72 67 65 74 20 76 7d 20 20 20 20 20 20 20 20 20 rget v}
0740: 20 20 20 20 20 20 20 20 20 7c 20 52 65 70 6c 61 | Repla
0750: 63 65 20 77 69 74 68 20 76 61 72 69 61 62 6c 65 ce with variable
0760: 20 76 20 66 72 6f 6d 20 74 61 72 67 65 74 20 6f v from target o
0770: 72 20 64 65 66 61 75 6c 74 20 6f 66 20 72 75 6e r default of run
0780: 63 6f 6e 66 69 67 73 20 66 69 6c 65 20 7c 20 7c configs file | |
0790: 0a 7c 20 23 7b 6d 74 72 61 68 7d 20 20 20 20 20 .| #{mtrah}
07a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
07b0: 52 65 70 6c 61 63 65 20 77 69 74 68 20 74 68 65 Replace with the
07c0: 20 70 61 74 68 20 74 6f 20 74 68 65 20 6d 65 67 path to the meg
07d0: 61 74 65 73 74 20 74 65 73 74 73 75 69 74 65 20 atest testsuite
07e0: 61 72 65 61 20 7c 20 7c 20 0a 7c 3d 3d 3d 3d 3d area | | .|=====
07f0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0800: 3d 0a 0a 43 6f 6e 66 69 67 20 46 69 6c 65 20 53 =..Config File S
0810: 65 74 74 69 6e 67 73 0a 7e 7e 7e 7e 7e 7e 7e 7e ettings.~~~~~~~~
0820: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 53 65 ~~~~~~~~~~~~..Se
0830: 74 74 69 6e 67 73 20 69 6e 20 6d 65 67 61 74 65 ttings in megate
0840: 73 74 2e 63 6f 6e 66 69 67 0a 0a 43 6f 6e 66 69 st.config..Confi
0850: 67 20 46 69 6c 65 20 41 64 64 69 74 69 6f 6e 61 g File Additiona
0860: 6c 20 46 65 61 74 75 72 65 73 0a 7e 7e 7e 7e 7e l Features.~~~~~
0870: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0880: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 63 6c ~~~~~~~~~~..Incl
0890: 75 64 69 6e 67 20 6f 75 74 70 75 74 20 66 72 6f uding output fro
08a0: 6d 20 61 20 73 63 72 69 70 74 20 61 73 20 69 66 m a script as if
08b0: 20 69 74 20 77 61 73 20 69 6e 6c 69 6e 65 20 74 it was inline t
08c0: 6f 20 74 68 65 20 63 6f 6e 66 69 67 20 66 69 6c o the config fil
08d0: 65 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d e:..------------
08e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 -------------.[s
08f0: 63 72 69 70 74 69 6e 63 20 6d 79 73 63 72 69 70 criptinc myscrip
0900: 74 2e 73 68 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d t.sh].----------
0910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
0920: 0a 49 66 20 74 68 65 20 73 63 72 69 70 74 20 6f .If the script o
0930: 75 74 70 75 74 73 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d utputs:..-------
0940: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0950: 2d 2d 0a 5b 69 74 65 6d 73 5d 0a 41 20 61 20 62 --.[items].A a b
0960: 20 63 0a 42 20 64 20 65 20 66 0a 2d 2d 2d 2d 2d c.B d e f.-----
0970: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0980: 2d 2d 2d 2d 0a 0a 54 68 65 6e 20 74 68 65 20 63 ----..Then the c
0990: 6f 6e 66 69 67 20 66 69 6c 65 20 77 6f 75 6c 64 onfig file would
09a0: 20 65 66 66 65 63 74 69 76 65 6c 79 20 61 70 70 effectively app
09b0: 65 61 72 20 74 6f 20 63 6f 6e 74 61 69 6e 20 61 ear to contain a
09c0: 6e 20 69 74 65 6d 73 20 73 65 63 74 69 6f 6e 0a n items section.
09d0: 65 78 61 63 74 6c 79 20 6c 69 6b 65 20 74 68 65 exactly like the
09e0: 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 65 output from the
09f0: 20 73 63 72 69 70 74 2e 20 54 68 69 73 20 69 73 script. This is
0a00: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 64 79 6e useful when dyn
0a10: 61 6d 69 63 61 6c 6c 79 0a 63 72 65 61 74 69 6e amically.creatin
0a20: 67 20 69 74 65 6d 73 2c 20 69 74 65 6d 73 74 61 g items, itemsta
0a30: 62 6c 65 73 20 61 6e 64 20 6f 74 68 65 72 20 63 bles and other c
0a40: 6f 6e 66 69 67 20 73 74 72 75 63 74 75 72 65 73 onfig structures
0a50: 2e 20 59 6f 75 20 63 61 6e 20 73 65 65 20 74 68 . You can see th
0a60: 65 0a 65 78 70 61 6e 73 69 6f 6e 20 6f 66 20 74 e.expansion of t
0a70: 68 65 20 63 61 6c 6c 20 62 79 20 6c 6f 6f 6b 69 he call by looki
0a80: 6e 67 20 69 6e 20 74 68 65 20 63 61 63 68 65 64 ng in the cached
0a90: 20 66 69 6c 65 73 20 28 6c 6f 6f 6b 20 69 6e 20 files (look in
0aa0: 79 6f 75 72 20 6c 69 6e 6b 74 72 65 65 0a 66 6f your linktree.fo
0ab0: 72 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 r megatest.confi
0ac0: 67 20 61 6e 64 20 72 75 6e 63 6f 6e 66 69 67 73 g and runconfigs
0ad0: 2e 63 6f 6e 66 69 67 20 63 61 63 68 65 20 66 69 .config cache fi
0ae0: 6c 65 73 20 61 6e 64 20 69 6e 20 79 6f 75 72 20 les and in your
0af0: 74 65 73 74 20 72 75 6e 0a 61 72 65 61 73 20 66 test run.areas f
0b00: 6f 72 20 74 68 65 20 65 78 70 61 6e 64 65 64 20 or the expanded
0b10: 61 6e 64 20 63 61 63 68 65 64 20 74 65 73 74 63 and cached testc
0b20: 6f 6e 66 69 67 29 2e 0a 0a 57 69 6c 64 63 61 72 onfig)...Wildcar
0b30: 64 73 20 61 6e 64 20 72 65 67 65 78 65 73 20 69 ds and regexes i
0b40: 6e 20 54 61 72 67 65 74 73 0a 0a 2d 2d 2d 2d 2d n Targets..-----
0b50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0b60: 2d 2d 2d 2d 0a 5b 61 2f 32 2f 62 5d 0a 56 41 52 ----.[a/2/b].VAR
0b70: 31 20 56 41 4c 31 0a 0a 5b 61 2f 25 2f 62 5d 0a 1 VAL1..[a/%/b].
0b80: 56 41 52 31 20 56 41 4c 32 0a 2d 2d 2d 2d 2d 2d VAR1 VAL2.------
0b90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0ba0: 2d 2d 2d 0a 0a 57 69 6c 6c 20 72 65 73 75 6c 74 ---..Will result
0bb0: 20 69 6e 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d in:..----------
0bc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
0bd0: 5b 61 2f 32 2f 62 5d 0a 56 41 52 31 20 56 41 4c [a/2/b].VAR1 VAL
0be0: 32 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2.--------------
0bf0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 61 6e -----------..Can
0c00: 20 75 73 65 20 65 69 74 68 65 72 20 77 69 6c 64 use either wild
0c10: 63 61 72 64 20 6f 66 20 22 25 22 20 6f 72 20 61 card of "%" or a
0c20: 20 72 65 67 75 6c 61 72 20 65 78 70 72 65 73 73 regular express
0c30: 69 6f 6e 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ion:..----------
0c40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
0c50: 5b 2f 61 62 63 2e 2a 64 65 66 2f 5d 0a 2d 2d 2d [/abc.*def/].---
0c60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0c70: 2d 2d 2d 2d 2d 2d 0a 0a 44 69 73 6b 20 53 70 61 ------..Disk Spa
0c80: 63 65 20 43 68 65 63 6b 73 0a 5e 5e 5e 5e 5e 5e ce Checks.^^^^^^
0c90: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 53 6f 6d ^^^^^^^^^^^..Som
0ca0: 65 20 70 61 72 61 6d 65 74 65 72 73 20 79 6f 75 e parameters you
0cb0: 20 63 61 6e 20 70 75 74 20 69 6e 20 74 68 65 20 can put in the
0cc0: 5b 73 65 74 75 70 5d 20 73 65 63 74 69 6f 6e 20 [setup] section
0cd0: 6f 66 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 of megatest.conf
0ce0: 69 67 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ig:..-----------
0cf0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 6d 69 6e 69 6d --------.# minim
0d00: 75 6d 20 73 70 61 63 65 20 72 65 71 75 69 72 65 um space require
0d10: 64 20 69 6e 20 61 20 72 75 6e 20 64 69 73 6b 20 d in a run disk
0d20: 0a 6d 69 6e 73 70 61 63 65 20 31 30 30 30 30 30 .minspace 100000
0d30: 30 30 0a 0a 23 20 6d 69 6e 69 6d 75 6d 20 73 70 00..# minimum sp
0d40: 61 63 65 20 72 65 71 75 69 72 65 64 20 69 6e 20 ace required in
0d50: 64 62 64 69 72 3a 0a 64 62 64 69 72 2d 73 70 61 dbdir:.dbdir-spa
0d60: 63 65 2d 72 65 71 75 69 72 65 64 20 31 30 30 30 ce-required 1000
0d70: 30 30 0a 0a 23 20 73 63 72 69 70 74 20 74 68 61 00..# script tha
0d80: 74 20 74 61 6b 65 73 20 70 61 74 68 20 61 73 20 t takes path as
0d90: 70 61 72 61 6d 65 74 65 72 20 61 6e 64 20 72 65 parameter and re
0da0: 74 75 72 6e 73 20 6e 75 6d 62 65 72 20 6f 66 20 turns number of
0db0: 62 79 74 65 73 20 61 76 61 69 6c 61 62 6c 65 3a bytes available:
0dc0: 0a 66 72 65 65 2d 73 70 61 63 65 2d 73 63 72 69 .free-space-scri
0dd0: 70 74 20 63 68 65 63 6b 2d 73 70 61 63 65 2e 73 pt check-space.s
0de0: 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d h.--------------
0df0: 2d 2d 2d 2d 2d 0a 0a 54 72 69 6d 20 74 72 61 69 -----..Trim trai
0e00: 6c 69 6e 67 20 73 70 61 63 65 73 0a 5e 5e 5e 5e ling spaces.^^^^
0e10: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
0e20: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
0e30: 2d 2d 2d 2d 0a 5b 63 6f 6e 66 69 67 66 3a 73 65 ----.[configf:se
0e40: 74 74 69 6e 67 73 20 74 72 69 6d 2d 74 72 61 69 ttings trim-trai
0e50: 6c 69 6e 67 2d 73 70 61 63 65 73 20 79 65 73 5d ling-spaces yes]
0e60: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0e70: 2d 2d 2d 0a 0a 4a 6f 62 20 53 75 62 6d 69 73 73 ---..Job Submiss
0e80: 69 6f 6e 20 43 6f 6e 74 72 6f 6c 0a 5e 5e 5e 5e ion Control.^^^^
0e90: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
0ea0: 5e 5e 0a 0a 53 75 62 6d 69 74 20 6a 6f 62 73 20 ^^..Submit jobs
0eb0: 74 6f 20 48 6f 73 74 20 54 79 70 65 73 20 62 61 to Host Types ba
0ec0: 73 65 64 20 6f 6e 20 54 65 73 74 20 4e 61 6d 65 sed on Test Name
0ed0: 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b .+++++++++++++++
0ee0: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ++++++++++++++++
0ef0: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 2e +++++++++++++...
0f00: 49 6e 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 In megatest.conf
0f10: 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ig.-------------
0f20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 68 6f 73 -----------.[hos
0f30: 74 2d 74 79 70 65 73 5d 0a 67 65 6e 65 72 61 6c t-types].general
0f40: 20 20 20 6e 62 66 61 6b 65 0a 72 65 6d 6f 74 65 nbfake.remote
0f50: 20 20 20 20 62 73 75 62 0a 0a 5b 6c 61 75 6e 63 bsub..[launc
0f60: 68 65 72 73 5d 0a 72 75 6e 66 69 72 73 74 2f 73 hers].runfirst/s
0f70: 75 6d 25 20 72 65 6d 6f 74 65 0a 25 20 67 65 6e um% remote.% gen
0f80: 65 72 61 6c 0a 0a 5b 6a 6f 62 74 6f 6f 6c 73 5d eral..[jobtools]
0f90: 0a 6c 61 75 6e 63 68 65 72 20 62 73 75 62 0a 23 .launcher bsub.#
0fa0: 20 69 66 20 64 65 66 69 6e 65 64 20 61 6e 64 20 if defined and
0fb0: 6e 6f 74 20 22 6e 6f 22 20 66 6c 65 78 69 2d 6c not "no" flexi-l
0fc0: 61 75 6e 63 68 65 72 20 77 69 6c 6c 20 62 79 70 auncher will byp
0fd0: 61 73 73 20 6c 61 75 6e 63 68 65 72 20 75 6e 6c ass launcher unl
0fe0: 65 73 73 20 0a 23 20 74 68 65 72 65 20 69 73 20 ess .# there is
0ff0: 6e 6f 20 68 6f 73 74 2d 74 79 70 65 20 6d 61 74 no host-type mat
1000: 63 68 2e 0a 66 6c 65 78 69 2d 6c 61 75 6e 63 68 ch..flexi-launch
1010: 65 72 20 79 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d er yes.---------
1020: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
1030: 0a 68 6f 73 74 2d 74 79 70 65 73 0a 2b 2b 2b 2b .host-types.++++
1040: 2b 2b 2b 2b 2b 2b 0a 0a 4c 69 73 74 20 6f 66 20 ++++++..List of
1050: 68 6f 73 74 20 74 79 70 65 73 20 61 6e 64 20 74 host types and t
1060: 68 65 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65 20 74 he commandline t
1070: 6f 20 72 75 6e 20 61 20 6a 6f 62 20 6f 6e 20 74 o run a job on t
1080: 68 61 74 20 68 6f 73 74 20 74 79 70 65 2e 0a 0a hat host type...
1090: 2e 68 6f 73 74 2d 74 79 70 65 20 3d 3e 20 6c 61 .host-type => la
10a0: 75 6e 63 68 20 63 6f 6d 6d 61 6e 64 0a 2d 2d 2d unch command.---
10b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 67 65 6e 65 72 61 ---------.genera
10c0: 6c 20 6e 62 66 61 6b 65 0a 2d 2d 2d 2d 2d 2d 2d l nbfake.-------
10d0: 2d 2d 2d 2d 2d 0a 0a 6c 61 75 6e 63 68 65 72 73 -----..launchers
10e0: 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 2e 74 65 73 .+++++++++...tes
10f0: 74 2f 69 74 65 6d 70 61 74 68 20 3d 3e 20 68 6f t/itempath => ho
1100: 73 74 2d 74 79 70 65 0a 2d 2d 2d 2d 2d 2d 2d 2d st-type.--------
1110: 2d 2d 2d 2d 0a 72 75 6e 66 69 72 73 74 2f 73 75 ----.runfirst/su
1120: 6d 25 20 72 65 6d 6f 74 65 0a 2d 2d 2d 2d 2d 2d m% remote.------
1130: 2d 2d 2d 2d 2d 2d 0a 0a 4d 69 73 63 65 6c 6c 61 ------..Miscella
1140: 6e 65 6f 75 73 20 53 65 74 75 70 20 49 74 65 6d neous Setup Item
1150: 73 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b s.++++++++++++++
1160: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 41 74 74 +++++++++++..Att
1170: 65 6d 70 74 20 74 6f 20 72 65 72 75 6e 20 74 65 empt to rerun te
1180: 73 74 73 20 69 6e 20 22 53 54 55 43 4b 2f 44 45 sts in "STUCK/DE
1190: 41 44 22 2c 20 22 6e 2f 61 22 2c 20 22 5a 45 52 AD", "n/a", "ZER
11a0: 4f 5f 49 54 45 4d 53 22 20 73 74 61 74 65 73 2e O_ITEMS" states.
11b0: 0a 0a 2e 49 6e 20 6d 65 67 61 74 65 73 74 2e 63 ...In megatest.c
11c0: 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d onfig.----------
11d0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 70 5d --------.[setup]
11e0: 0a 72 65 72 75 6e 73 20 35 0a 2d 2d 2d 2d 2d 2d .reruns 5.------
11f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 65 ------------..Re
1200: 70 6c 61 63 65 20 74 68 65 20 64 65 66 61 75 6c place the defaul
1210: 74 20 62 6c 61 63 6b 6c 69 73 74 65 64 20 65 6e t blacklisted en
1220: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
1230: 6c 65 73 20 77 69 74 68 20 75 73 65 72 20 73 75 les with user su
1240: 70 70 6c 69 65 64 0a 6c 69 73 74 2e 0a 0a 44 65 pplied.list...De
1250: 66 61 75 6c 74 20 6c 69 73 74 3a 20 55 53 45 52 fault list: USER
1260: 20 48 4f 4d 45 20 44 49 53 50 4c 41 59 20 4c 53 HOME DISPLAY LS
1270: 5f 43 4f 4c 4f 52 53 20 58 4b 45 59 53 59 4d 44 _COLORS XKEYSYMD
1280: 42 20 45 44 49 54 4f 52 20 4d 41 4b 45 46 4c 41 B EDITOR MAKEFLA
1290: 47 53 20 4d 41 4b 45 46 20 4d 41 4b 45 4f 56 45 GS MAKEF MAKEOVE
12a0: 52 52 49 44 45 53 0a 0a 2e 41 64 64 20 61 20 22 RRIDES...Add a "
12b0: 62 61 64 22 20 76 61 72 69 61 62 6c 65 20 22 50 bad" variable "P
12c0: 52 4f 4d 50 54 22 20 74 6f 20 74 68 65 20 76 61 ROMPT" to the va
12d0: 72 69 61 62 6c 65 73 20 74 68 61 74 20 77 69 6c riables that wil
12e0: 6c 20 62 65 20 63 6f 6d 6d 65 6e 74 65 64 20 6f l be commented o
12f0: 75 74 0a 69 6e 20 74 68 65 20 6d 65 67 61 74 65 ut.in the megate
1300: 73 74 2e 73 68 20 61 6e 64 20 6d 65 67 61 74 65 st.sh and megate
1310: 73 74 2e 63 73 68 20 66 69 6c 65 73 3a 0a 2d 2d st.csh files:.--
1320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
1330: 5b 73 65 74 75 70 5d 0a 62 6c 61 63 6b 6c 69 73 [setup].blacklis
1340: 74 76 61 72 73 20 55 53 45 52 20 48 4f 4d 45 20 tvars USER HOME
1350: 44 49 53 50 4c 41 59 20 4c 53 5f 43 4f 4c 4f 52 DISPLAY LS_COLOR
1360: 53 20 58 4b 45 59 53 59 4d 44 42 20 45 44 49 54 S XKEYSYMDB EDIT
1370: 4f 52 20 4d 41 4b 45 46 4c 41 47 53 20 50 52 4f OR MAKEFLAGS PRO
1380: 4d 50 54 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d MPT.------------
1390: 2d 2d 2d 2d 2d 0a 0a 52 75 6e 20 74 69 6d 65 20 -----..Run time
13a0: 6c 69 6d 69 74 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b limit.++++++++++
13b0: 2b 2b 2b 2b 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ++++..----------
13c0: 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 70 5d 0a -------.[setup].
13d0: 23 20 74 68 69 73 20 77 69 6c 6c 20 61 75 74 6f # this will auto
13e0: 6d 61 74 69 63 61 6c 6c 79 20 6b 69 6c 6c 20 74 matically kill t
13f0: 68 65 20 74 65 73 74 20 69 66 20 69 74 20 72 75 he test if it ru
1400: 6e 73 20 66 6f 72 20 6d 6f 72 65 20 74 68 61 6e ns for more than
1410: 20 31 68 20 32 6d 20 61 6e 64 20 33 73 0a 72 75 1h 2m and 3s.ru
1420: 6e 74 69 6d 65 6c 69 6d 20 31 68 20 32 6d 20 33 ntimelim 1h 2m 3
1430: 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d s.--------------
1440: 2d 2d 2d 0a 0a 54 65 73 74 73 20 62 72 6f 77 73 ---..Tests brows
1450: 65 72 20 76 69 65 77 0a 7e 7e 7e 7e 7e 7e 7e 7e er view.~~~~~~~~
1460: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 54 68 65 20 ~~~~~~~~~~..The
1470: 74 65 73 74 73 20 62 72 6f 77 73 65 72 20 28 73 tests browser (s
1480: 65 65 20 74 68 65 20 52 75 6e 20 43 6f 6e 74 72 ee the Run Contr
1490: 6f 6c 20 74 61 62 20 6f 6e 20 74 68 65 20 64 61 ol tab on the da
14a0: 73 68 62 6f 61 72 64 29 20 68 61 73 20 74 77 6f shboard) has two
14b0: 20 76 69 65 77 73 20 66 6f 72 20 64 69 73 70 6c views for displ
14c0: 61 79 69 6e 67 20 74 68 65 20 74 65 73 74 73 2e aying the tests.
14d0: 20 0a 0a 2e 20 44 6f 74 20 28 67 72 61 70 68 76 ... Dot (graphv
14e0: 69 7a 29 20 62 61 73 65 64 20 74 72 65 65 0a 2e iz) based tree..
14f0: 20 4e 6f 20 64 6f 74 2c 20 70 6c 61 69 6e 20 6c No dot, plain l
1500: 69 73 74 69 6e 67 0a 0a 54 68 65 20 64 65 66 61 isting..The defa
1510: 75 6c 74 20 69 73 20 74 68 65 20 67 72 61 70 68 ult is the graph
1520: 76 69 7a 20 62 61 73 65 64 20 74 72 65 65 20 62 viz based tree b
1530: 75 74 20 69 66 20 79 6f 75 72 20 74 65 73 74 73 ut if your tests
1540: 20 64 6f 6e 27 74 20 76 69 65 77 0a 77 65 6c 6c don't view.well
1550: 20 69 6e 20 74 68 61 74 20 6d 6f 64 65 20 74 68 in that mode th
1560: 65 6e 20 75 73 65 20 22 6e 6f 64 6f 74 22 20 74 en use "nodot" t
1570: 6f 20 74 75 72 6e 20 69 74 20 6f 66 66 2e 0a 0a o turn it off...
1580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1590: 2d 0a 5b 73 65 74 75 70 5d 0a 6e 6f 64 6f 74 0a -.[setup].nodot.
15a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
15b0: 2d 0a 0a 43 61 70 74 75 72 69 6e 67 20 54 65 73 -..Capturing Tes
15c0: 74 20 44 61 74 61 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e t Data.~~~~~~~~~
15d0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 20 61 ~~~~~~~~~~..In a
15e0: 20 74 65 73 74 20 79 6f 75 20 63 61 6e 20 63 61 test you can ca
15f0: 70 74 75 72 65 20 61 72 62 69 74 72 61 72 79 20 pture arbitrary
1600: 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 72 6f variables and ro
1610: 6c 6c 20 74 68 65 6d 20 75 70 20 69 6e 20 74 68 ll them up in th
1620: 65 0a 6d 65 67 61 74 65 73 74 20 64 61 74 61 62 e.megatest datab
1630: 61 73 65 20 66 6f 72 20 76 69 65 77 69 6e 67 20 ase for viewing
1640: 6f 6e 20 74 68 65 20 64 61 73 68 62 6f 61 72 64 on the dashboard
1650: 20 6f 72 20 77 65 62 20 61 70 70 2e 0a 0a 2e 49 or web app....I
1660: 6e 20 61 20 74 65 73 74 20 61 73 20 61 20 73 63 n a test as a sc
1670: 72 69 70 74 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ript.-----------
1680: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 24 4d -------------.$M
1690: 54 5f 4d 45 47 41 54 45 53 54 20 2d 6c 6f 61 64 T_MEGATEST -load
16a0: 2d 74 65 73 74 2d 64 61 74 61 20 3c 3c 20 45 4f -test-data << EO
16b0: 46 0a 66 6f 6f 2c 62 61 72 2c 20 20 20 31 2e 32 F.foo,bar, 1.2
16c0: 2c 20 20 31 2e 39 2c 20 3e 0a 66 6f 6f 2c 72 61 , 1.9, >.foo,ra
16d0: 62 2c 20 31 2e 30 65 39 2c 20 31 30 65 39 2c 20 b, 1.0e9, 10e9,
16e0: 31 65 39 0a 66 6f 6f 2c 62 6c 61 2c 20 20 20 31 1e9.foo,bla, 1
16f0: 2e 32 2c 20 20 31 2e 39 2c 20 3c 0a 66 6f 6f 2c .2, 1.9, <.foo,
1700: 62 61 6c 2c 20 20 20 31 2e 32 2c 20 20 31 2e 32 bal, 1.2, 1.2
1710: 2c 20 3c 20 20 20 2c 20 20 20 20 20 2c 43 68 65 , < , ,Che
1720: 63 6b 20 66 6f 72 20 6f 76 65 72 6c 6f 61 64 0a ck for overload.
1730: 66 6f 6f 2c 61 6c 62 2c 20 20 20 31 2e 32 2c 20 foo,alb, 1.2,
1740: 20 31 2e 32 2c 20 3c 3d 20 20 2c 20 41 6d 70 73 1.2, <= , Amps
1750: 2c 54 68 69 73 20 69 73 20 74 68 65 20 68 69 67 ,This is the hig
1760: 68 20 70 6f 77 65 72 20 63 69 72 63 75 69 74 20 h power circuit
1770: 74 65 73 74 0a 66 6f 6f 2c 61 62 6c 2c 20 20 20 test.foo,abl,
1780: 31 2e 32 2c 20 20 31 2e 33 2c 20 30 2e 31 0a 66 1.2, 1.3, 0.1.f
1790: 6f 6f 2c 62 72 61 2c 20 20 20 31 2e 32 2c 20 70 oo,bra, 1.2, p
17a0: 61 73 73 2c 20 73 69 6c 6c 79 20 73 74 75 66 66 ass, silly stuff
17b0: 0a 66 61 7a 2c 62 61 72 2c 20 20 20 20 31 30 2c .faz,bar, 10,
17c0: 20 20 38 6d 41 2c 20 20 20 20 20 2c 20 20 20 20 8mA, ,
17d0: 20 2c 22 74 68 69 73 20 69 73 20 61 20 63 6f 6d ,"this is a com
17e0: 6d 65 6e 74 22 0a 45 4f 46 0a 2d 2d 2d 2d 2d 2d ment".EOF.------
17f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1800: 2d 2d 0a 0a 41 6c 74 65 72 6e 61 74 69 76 65 6c --..Alternativel
1810: 79 20 79 6f 75 20 63 61 6e 20 75 73 65 20 6c 6f y you can use lo
1820: 67 70 72 6f 20 74 72 69 67 67 65 72 73 20 74 6f gpro triggers to
1830: 20 63 61 70 74 75 72 65 20 76 61 6c 75 65 73 20 capture values
1840: 61 6e 64 20 69 6e 6a 65 63 74 20 74 68 65 6d 0a and inject them.
1850: 69 6e 74 6f 20 6d 65 67 61 74 65 73 74 20 75 73 into megatest us
1860: 69 6e 67 20 74 68 65 20 2d 73 65 74 2d 76 61 6c ing the -set-val
1870: 75 65 73 20 6d 65 63 68 61 6e 69 73 6d 3a 0a 0a ues mechanism:..
1880: 2e 4d 65 67 61 74 65 73 74 20 68 65 6c 70 20 72 .Megatest help r
1890: 65 6c 61 74 65 64 20 74 6f 20 2d 73 65 74 2d 76 elated to -set-v
18a0: 61 6c 75 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d alues.----------
18b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 54 --------------.T
18c0: 65 73 74 20 64 61 74 61 20 63 61 70 74 75 72 65 est data capture
18d0: 0a 20 20 2d 73 65 74 2d 76 61 6c 75 65 73 20 20 . -set-values
18e0: 20 20 20 20 20 20 20 20 20 20 20 3a 20 75 70 64 : upd
18f0: 61 74 65 20 6f 72 20 73 65 74 20 76 61 6c 75 65 ate or set value
1900: 73 20 69 6e 20 74 68 65 20 74 65 73 74 64 61 74 s in the testdat
1910: 61 20 74 61 62 6c 65 0a 20 20 3a 63 61 74 65 67 a table. :categ
1920: 6f 72 79 20 20 20 20 20 20 20 20 20 20 20 20 20 ory
1930: 20 20 3a 20 73 65 74 20 74 68 65 20 63 61 74 65 : set the cate
1940: 67 6f 72 79 20 66 69 65 6c 64 20 28 6f 70 74 69 gory field (opti
1950: 6f 6e 61 6c 29 0a 20 20 3a 76 61 72 69 61 62 6c onal). :variabl
1960: 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e
1970: 3a 20 73 65 74 20 74 68 65 20 76 61 72 69 61 62 : set the variab
1980: 6c 65 20 6e 61 6d 65 20 28 6f 70 74 69 6f 6e 61 le name (optiona
1990: 6c 29 0a 20 20 3a 76 61 6c 75 65 20 20 20 20 20 l). :value
19a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 76 : v
19b0: 61 6c 75 65 20 6d 65 61 73 75 72 65 64 20 28 72 alue measured (r
19c0: 65 71 75 69 72 65 64 29 0a 20 20 3a 65 78 70 65 equired). :expe
19d0: 63 74 65 64 20 20 20 20 20 20 20 20 20 20 20 20 cted
19e0: 20 20 20 3a 20 76 61 6c 75 65 20 65 78 70 65 63 : value expec
19f0: 74 65 64 20 28 72 65 71 75 69 72 65 64 29 0a 20 ted (required).
1a00: 20 3a 74 6f 6c 20 20 20 20 20 20 20 20 20 20 20 :tol
1a10: 20 20 20 20 20 20 20 20 20 3a 20 7c 76 61 6c 75 : |valu
1a20: 65 2d 65 78 70 65 63 74 7c 20 3c 3d 20 74 6f 6c e-expect| <= tol
1a30: 20 28 72 65 71 75 69 72 65 64 2c 20 63 61 6e 20 (required, can
1a40: 62 65 20 3c 2c 20 3e 2c 20 3e 3d 2c 20 3c 3d 20 be <, >, >=, <=
1a50: 6f 72 20 6e 75 6d 62 65 72 29 0a 20 20 3a 75 6e or number). :un
1a60: 69 74 73 20 20 20 20 20 20 20 20 20 20 20 20 20 its
1a70: 20 20 20 20 20 3a 20 6e 61 6d 65 20 6f 66 20 74 : name of t
1a80: 68 65 20 75 6e 69 74 73 20 66 6f 72 20 76 61 6c he units for val
1a90: 75 65 2c 20 65 78 70 65 63 74 65 64 5f 76 61 6c ue, expected_val
1aa0: 75 65 20 65 74 63 2e 20 28 6f 70 74 69 6f 6e 61 ue etc. (optiona
1ab0: 6c 29 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d l).-------------
1ac0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 61 73 -----------..Das
1ad0: 68 62 6f 61 72 64 20 73 65 74 74 69 6e 67 73 0a hboard settings.
1ae0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
1af0: 7e 7e 0a 0a 2e 52 75 6e 73 20 74 61 62 20 62 75 ~~...Runs tab bu
1b00: 74 74 6f 6e 73 2c 20 66 6f 6e 74 20 61 6e 64 20 ttons, font and
1b10: 73 69 7a 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d size.-----------
1b20: 2d 2d 2d 2d 2d 2d 2d 0a 5b 64 61 73 68 62 6f 61 -------.[dashboa
1b30: 72 64 5d 0a 62 74 6e 2d 68 65 69 67 68 74 20 78 rd].btn-height x
1b40: 31 34 0a 62 74 6e 2d 66 6f 6e 74 73 7a 20 31 30 14.btn-fontsz 10
1b50: 0a 63 65 6c 6c 2d 77 69 64 74 68 20 36 30 0a 2d .cell-width 60.-
1b60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1b70: 2d 0a 0a 44 61 74 61 62 61 73 65 20 73 65 74 74 -..Database sett
1b80: 69 6e 67 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ings.~~~~~~~~~~~
1b90: 7e 7e 7e 7e 7e 7e 0a 0a 2e 44 61 74 61 62 61 73 ~~~~~~...Databas
1ba0: 65 20 63 6f 6e 66 69 67 20 73 65 74 74 69 6e 67 e config setting
1bb0: 73 20 69 6e 20 5b 73 65 74 75 70 5d 20 73 65 63 s in [setup] sec
1bc0: 74 69 6f 6e 20 6f 66 20 6d 65 67 61 74 65 73 74 tion of megatest
1bd0: 2e 63 6f 6e 66 69 67 0a 5b 77 69 64 74 68 3d 22 .config.[width="
1be0: 37 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d 2c 70%",cols="^,2m,
1bf0: 32 6d 2c 32 6d 22 2c 66 72 61 6d 65 3d 22 74 6f 2m,2m",frame="to
1c00: 70 62 6f 74 22 2c 6f 70 74 69 6f 6e 73 3d 22 68 pbot",options="h
1c10: 65 61 64 65 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d eader"].|=======
1c20: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a ===============.
1c30: 7c 56 61 72 20 20 20 20 20 20 20 20 20 20 20 20 |Var
1c40: 20 20 20 20 20 20 20 20 20 20 20 7c 20 50 75 72 | Pur
1c50: 70 6f 73 65 20 20 20 20 20 20 20 20 20 20 20 20 pose
1c60: 7c 20 56 61 6c 69 64 20 76 61 6c 75 65 73 20 20 | Valid values
1c70: 20 20 20 20 20 20 20 20 20 20 7c 20 43 6f 6d 6d | Comm
1c80: 65 6e 74 73 0a 7c 64 65 6c 61 79 2d 6f 6e 2d 62 ents.|delay-on-b
1c90: 75 73 79 20 20 20 20 20 20 20 20 20 20 20 20 20 usy
1ca0: 7c 20 50 72 65 76 65 6e 74 20 63 6f 6e 63 75 72 | Prevent concur
1cb0: 72 65 6e 74 20 61 63 63 65 73 73 20 69 73 73 75 rent access issu
1cc0: 65 73 20 7c 20 79 65 73 5c 7c 6e 6f 20 6f 72 20 es | yes\|no or
1cd0: 6e 6f 74 20 64 65 66 69 6e 65 64 20 7c 20 44 65 not defined | De
1ce0: 66 61 75 6c 74 3d 6e 6f 2c 20 6d 61 79 20 68 65 fault=no, may he
1cf0: 6c 70 20 6f 6e 20 73 6f 6d 65 20 6e 65 74 77 6f lp on some netwo
1d00: 72 6b 20 66 69 6c 65 20 73 79 73 74 65 6d 73 2c rk file systems,
1d10: 20 6d 61 79 20 73 6c 6f 77 20 74 68 69 6e 67 73 may slow things
1d20: 20 64 6f 77 6e 20 61 6c 73 6f 2e 0a 7c 66 61 73 down also..|fas
1d30: 74 73 74 61 72 74 09 09 20 20 20 7c 20 41 6c 6c tstart.. | All
1d40: 20 64 69 72 65 63 74 20 66 69 6c 65 20 61 63 63 direct file acc
1d50: 65 73 73 20 74 6f 20 73 71 6c 69 74 65 20 64 62 ess to sqlite db
1d60: 20 66 69 6c 65 73 20 7c 20 79 65 73 5c 7c 6e 6f files | yes\|no
1d70: 20 6f 72 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 or not defined
1d80: 7c 20 44 65 66 61 75 6c 74 3d 79 65 73 2c 20 73 | Default=yes, s
1d90: 75 67 67 65 73 74 20 6e 6f 20 66 6f 72 20 63 65 uggest no for ce
1da0: 6e 74 72 61 6c 20 61 75 74 6f 6d 61 74 65 64 20 ntral automated
1db0: 73 79 73 74 65 6d 73 20 61 6e 64 20 79 65 73 20 systems and yes
1dc0: 66 6f 72 20 69 6e 74 65 72 61 63 74 69 76 65 20 for interactive
1dd0: 75 73 65 0a 7c 68 6f 6d 65 68 6f 73 74 20 09 09 use.|homehost ..
1de0: 20 20 20 7c 20 53 74 61 72 74 20 73 65 72 76 65 | Start serve
1df0: 72 73 20 6f 6e 20 74 68 69 73 20 68 6f 73 74 20 rs on this host
1e00: 7c 20 3c 68 6f 73 74 6e 61 6d 65 3e 20 7c 20 44 | <hostname> | D
1e10: 65 66 61 75 6c 74 73 20 74 6f 20 6c 6f 63 61 6c efaults to local
1e20: 20 68 6f 73 74 0a 7c 68 6f 73 74 6e 61 6d 65 09 host.|hostname.
1e30: 09 20 20 20 7c 20 48 6f 73 74 6e 61 6d 65 20 74 . | Hostname t
1e40: 6f 20 62 69 6e 64 20 74 6f 20 7c 20 3c 68 6f 73 o bind to | <hos
1e50: 74 6e 61 6d 65 3e 5c 7c 2d 09 20 20 7c 20 4f 6e tname>\|-. | On
1e60: 20 6d 75 6c 74 69 2d 68 6f 6d 65 64 20 68 6f 73 multi-homed hos
1e70: 74 73 20 61 6c 6c 6f 77 73 20 62 69 6e 64 69 6e ts allows bindin
1e80: 67 20 74 6f 20 73 70 65 63 69 66 69 63 20 68 6f g to specific ho
1e90: 73 74 6e 61 6d 65 0a 7c 6c 6f 77 70 6f 72 74 09 stname.|lowport.
1ea0: 09 20 20 20 7c 20 53 74 61 72 74 20 73 65 61 72 . | Start sear
1eb0: 63 68 69 6e 67 20 66 6f 72 20 61 20 70 6f 72 74 ching for a port
1ec0: 20 61 74 20 74 68 69 73 20 70 6f 72 74 6e 75 6d at this portnum
1ed0: 7c 20 33 32 37 36 38 20 7c 20 0a 7c 72 65 71 75 | 32768 | .|requ
1ee0: 69 72 65 64 09 09 20 20 20 7c 20 53 65 72 76 65 ired.. | Serve
1ef0: 72 20 72 65 71 75 69 72 65 64 20 20 20 20 7c 20 r required |
1f00: 79 65 73 5c 7c 6e 6f 20 6f 72 20 6e 6f 74 20 64 yes\|no or not d
1f10: 65 66 69 6e 65 64 20 20 7c 20 44 65 66 61 75 6c efined | Defaul
1f20: 74 3d 6e 6f 2c 20 66 6f 72 63 65 20 73 74 61 72 t=no, force star
1f30: 74 20 6f 66 20 73 65 72 76 65 72 20 61 6c 77 61 t of server alwa
1f40: 79 73 0a 7c 73 65 72 76 65 72 2d 71 75 65 72 79 ys.|server-query
1f50: 2d 74 68 72 65 73 68 6f 6c 64 09 20 20 20 7c 20 -threshold. |
1f60: 53 74 61 72 74 20 73 65 72 76 65 72 20 77 68 65 Start server whe
1f70: 6e 20 71 75 65 72 69 65 73 20 74 61 6b 65 20 6c n queries take l
1f80: 6f 6e 67 65 72 20 74 68 61 6e 20 74 68 69 73 20 onger than this
1f90: 7c 20 6e 75 6d 62 65 72 20 69 6e 20 6d 69 6c 6c | number in mill
1fa0: 69 73 65 63 6f 6e 64 73 20 7c 20 44 65 66 61 75 iseconds | Defau
1fb0: 6c 74 3d 33 30 30 0a 7c 74 69 6d 65 6f 75 74 09 lt=300.|timeout.
1fc0: 09 20 20 20 7c 20 68 74 74 70 20 61 70 69 20 74 . | http api t
1fd0: 69 6d 65 6f 75 74 20 09 7c 20 6e 75 6d 62 65 72 imeout .| number
1fe0: 20 69 6e 20 68 6f 75 72 73 09 20 20 7c 20 44 65 in hours. | De
1ff0: 66 61 75 6c 74 20 69 73 20 31 20 6d 69 6e 75 74 fault is 1 minut
2000: 65 2c 20 64 6f 20 6e 6f 74 20 63 68 61 6e 67 65 e, do not change
2010: 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d .|==============
2020: 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 65 20 74 65 ========..The te
2030: 73 74 63 6f 6e 66 69 67 20 46 69 6c 65 0a 2d 2d stconfig File.--
2040: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2050: 2d 0a 0a 53 65 74 75 70 20 73 65 63 74 69 6f 6e -..Setup section
2060: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a .~~~~~~~~~~~~~..
2070: 48 65 61 64 65 72 0a 5e 5e 5e 5e 5e 5e 0a 0a 2d Header.^^^^^^..-
2080: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2090: 2d 2d 0a 5b 73 65 74 75 70 5d 0a 2d 2d 2d 2d 2d --.[setup].-----
20a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
20b0: 54 68 65 20 72 75 6e 73 63 72 69 70 74 20 6d 65 The runscript me
20c0: 74 68 6f 64 20 69 73 20 61 20 62 72 75 74 65 20 thod is a brute
20d0: 66 6f 72 63 65 20 77 61 79 20 74 6f 20 72 75 6e force way to run
20e0: 20 73 63 72 69 70 74 73 20 77 68 65 72 65 20 74 scripts where t
20f0: 68 65 0a 75 73 65 72 20 69 73 20 72 65 73 70 6f he.user is respo
2100: 6e 73 69 62 6c 65 20 66 6f 72 20 73 65 74 74 69 nsible for setti
2110: 6e 67 20 53 54 41 54 45 20 61 6e 64 20 53 54 41 ng STATE and STA
2120: 54 55 53 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d TUS..-----------
2130: 2d 2d 2d 2d 2d 2d 2d 2d 0a 72 75 6e 73 63 72 69 --------.runscri
2140: 70 74 20 6d 61 69 6e 2e 63 73 68 0a 2d 2d 2d 2d pt main.csh.----
2150: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
2160: 0a 52 65 71 75 69 72 65 6d 65 6e 74 73 20 73 65 .Requirements se
2170: 63 74 69 6f 6e 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ction.~~~~~~~~~~
2180: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 48 65 61 ~~~~~~~~~~...Hea
2190: 64 65 72 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d der.------------
21a0: 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 -------.[require
21b0: 6d 65 6e 74 73 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ments].---------
21c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 57 61 69 74 ----------..Wait
21d0: 20 6f 6e 20 4f 74 68 65 72 20 54 65 73 74 73 0a on Other Tests.
21e0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
21f0: 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^^..-----------
2200: 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 41 20 6e 6f 72 --------.# A nor
2210: 6d 61 6c 20 77 61 69 74 6f 6e 20 77 61 69 74 73 mal waiton waits
2220: 20 66 6f 72 20 74 68 65 20 70 72 69 6f 72 20 74 for the prior t
2230: 65 73 74 73 20 74 6f 20 62 65 20 43 4f 4d 50 4c ests to be COMPL
2240: 45 54 45 44 20 0a 23 20 61 6e 64 20 50 41 53 53 ETED .# and PASS
2250: 2c 20 43 48 45 43 4b 20 6f 72 20 57 41 49 56 45 , CHECK or WAIVE
2260: 44 0a 77 61 69 74 6f 6e 20 74 65 73 74 31 20 74 D.waiton test1 t
2270: 65 73 74 32 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d est2.-----------
2280: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4d 6f 64 65 0a 5e --------..Mode.^
2290: 5e 5e 5e 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 ^^^..The default
22a0: 20 28 69 2e 65 2e 20 69 66 20 6d 6f 64 65 20 69 (i.e. if mode i
22b0: 73 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 29 s not specified)
22c0: 20 69 73 20 6e 6f 72 6d 61 6c 2e 20 41 6c 6c 20 is normal. All
22d0: 70 72 65 2d 64 65 70 65 6e 64 65 6e 74 20 74 65 pre-dependent te
22e0: 73 74 73 0a 6d 75 73 74 20 62 65 20 43 4f 4d 50 sts.must be COMP
22f0: 4c 45 54 45 44 20 61 6e 64 20 50 41 53 53 2c 20 LETED and PASS,
2300: 43 48 45 43 4b 20 6f 72 20 57 41 49 56 45 44 20 CHECK or WAIVED
2310: 62 65 66 6f 72 65 20 74 68 65 20 74 65 73 74 20 before the test
2320: 77 69 6c 6c 20 73 74 61 72 74 0a 0a 2d 2d 2d 2d will start..----
2330: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
2340: 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 6d [requirements].m
2350: 6f 64 65 20 20 20 6e 6f 72 6d 61 6c 0a 2d 2d 2d ode normal.---
2360: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2370: 0a 0a 54 68 65 20 74 6f 70 6c 65 76 65 6c 20 6d ..The toplevel m
2380: 6f 64 65 20 72 65 71 75 69 72 65 73 20 6f 6e 6c ode requires onl
2390: 79 20 74 68 61 74 20 74 68 65 20 70 72 69 6f 72 y that the prior
23a0: 20 74 65 73 74 73 20 61 72 65 20 43 4f 4d 50 4c tests are COMPL
23b0: 45 54 45 44 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ETED...---------
23c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 ----------.[requ
23d0: 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 74 irements].mode t
23e0: 6f 70 6c 65 76 65 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d oplevel.--------
23f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 20 69 -----------..A i
2400: 74 65 6d 20 62 61 73 65 64 20 77 61 69 74 6f 6e tem based waiton
2410: 20 77 69 6c 6c 20 73 74 61 72 74 20 69 74 65 6d will start item
2420: 73 20 69 6e 20 61 20 74 65 73 74 20 77 68 65 6e s in a test when
2430: 20 74 68 65 20 73 61 6d 65 2d 6e 61 6d 65 64 0a the same-named.
2440: 69 74 65 6d 20 69 73 20 43 4f 4d 50 4c 45 54 45 item is COMPLETE
2450: 44 20 61 6e 64 20 50 41 53 53 2c 20 43 48 45 43 D and PASS, CHEC
2460: 4b 20 6f 72 20 57 41 49 56 45 44 20 69 6e 20 74 K or WAIVED in t
2470: 68 65 20 70 72 69 6f 72 20 74 65 73 74 2e 20 54 he prior test. T
2480: 68 69 73 0a 77 61 73 20 68 69 73 74 6f 72 69 63 his.was historic
2490: 61 6c 6c 79 20 63 61 6c 6c 65 64 20 22 69 74 65 ally called "ite
24a0: 6d 77 61 69 74 22 20 6d 6f 64 65 2e 20 54 68 65 mwait" mode. The
24b0: 20 74 65 72 6d 73 20 22 69 74 65 6d 77 61 69 74 terms "itemwait
24c0: 22 20 61 6e 64 0a 22 69 74 65 6d 6d 61 74 63 68 " and."itemmatch
24d0: 22 20 61 72 65 20 73 79 6e 6f 6e 79 6d 73 2e 0a " are synonyms..
24e0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
24f0: 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e ----.[requiremen
2500: 74 73 5d 0a 6d 6f 64 65 20 69 74 65 6d 6d 61 74 ts].mode itemmat
2510: 63 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ch.-------------
2520: 2d 2d 2d 2d 2d 2d 0a 0a 4f 76 65 72 72 69 64 69 ------..Overridi
2530: 6e 67 20 45 6e 76 69 72 6f 6d 65 6e 74 20 56 61 ng Enviroment Va
2540: 72 69 61 62 6c 65 73 0a 7e 7e 7e 7e 7e 7e 7e 7e riables.~~~~~~~~
2550: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
2560: 7e 7e 7e 7e 7e 7e 7e 0a 0a 4f 76 65 72 72 69 64 ~~~~~~~..Overrid
2570: 65 20 76 61 72 69 61 62 6c 65 73 20 62 65 66 6f e variables befo
2580: 72 65 20 73 74 61 72 74 69 6e 67 20 74 68 65 20 re starting the
2590: 74 65 73 74 2e 20 43 61 6e 20 69 6e 63 6c 75 64 test. Can includ
25a0: 65 20 66 69 6c 65 73 20 28 70 65 72 68 61 70 73 e files (perhaps
25b0: 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 6d 65 generated by me
25c0: 67 61 74 65 73 74 20 2d 65 6e 76 64 65 6c 74 61 gatest -envdelta
25d0: 20 6f 72 20 73 69 6d 69 6c 61 72 29 2e 0a 0a 2d or similar)...-
25e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
25f0: 2d 2d 2d 0a 5b 70 72 65 2d 6c 61 75 6e 63 68 2d ---.[pre-launch-
2600: 65 6e 76 2d 76 61 72 73 5d 0a 56 41 52 31 20 76 env-vars].VAR1 v
2610: 61 6c 75 65 31 0a 0a 23 20 47 65 74 20 73 6f 6d alue1..# Get som
2620: 65 20 67 65 6e 65 72 61 74 65 64 20 73 65 74 74 e generated sett
2630: 69 6e 67 73 0a 5b 69 6e 63 6c 75 64 65 20 2e 2e ings.[include ..
2640: 2f 67 65 6e 65 72 61 74 65 64 2d 76 61 72 73 2e /generated-vars.
2650: 63 6f 6e 66 69 67 5d 0a 0a 23 20 55 73 65 20 74 config]..# Use t
2660: 68 69 73 20 74 72 69 63 6b 20 74 6f 20 75 6e 73 his trick to uns
2670: 65 74 20 76 61 72 69 61 62 6c 65 73 0a 23 7b 73 et variables.#{s
2680: 63 68 65 6d 65 20 28 75 6e 73 65 74 65 6e 76 20 cheme (unsetenv
2690: 22 46 4f 4f 42 41 52 22 29 7d 0a 2d 2d 2d 2d 2d "FOOBAR")}.-----
26a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
26b0: 0a 49 74 65 6d 6d 61 70 20 48 61 6e 64 6c 69 6e .Itemmap Handlin
26c0: 67 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e g.~~~~~~~~~~~~~~
26d0: 7e 7e 0a 0a 46 6f 72 20 63 61 73 65 73 20 77 65 ~~..For cases we
26e0: 72 65 20 74 68 65 20 64 65 70 65 6e 64 65 6e 74 re the dependent
26f0: 20 74 65 73 74 20 68 61 73 20 61 20 73 69 6d 69 test has a simi
2700: 6c 61 72 20 62 75 74 20 6e 6f 74 20 69 64 65 6e lar but not iden
2710: 74 69 63 61 6c 0a 69 74 65 6d 70 61 74 68 20 74 tical.itempath t
2720: 6f 20 74 68 65 20 64 6f 77 6e 73 74 72 65 61 6d o the downstream
2730: 20 74 65 73 74 20 61 6e 20 69 74 65 6d 6d 61 70 test an itemmap
2740: 20 63 61 6e 20 61 6c 6c 6f 77 20 66 6f 72 20 69 can allow for i
2750: 74 65 6d 6d 61 74 63 68 0a 6d 6f 64 65 0a 0a 2e temmatch.mode...
2760: 65 78 61 6d 70 6c 65 20 66 6f 72 20 72 65 6d 6f example for remo
2770: 76 69 6e 67 20 70 61 72 74 20 6f 66 20 69 74 65 ving part of ite
2780: 6d 6d 61 70 20 66 6f 72 20 77 61 69 74 6f 6e 20 mmap for waiton
2790: 74 65 73 74 20 28 65 67 3a 20 69 74 65 6d 20 2b test (eg: item +
27a0: 66 6f 6f 2d 78 2f 62 61 72 2b 20 64 65 70 65 6e foo-x/bar+ depen
27b0: 64 73 20 6f 6e 20 77 61 69 74 6f 6e 27 73 20 69 ds on waiton's i
27c0: 74 65 6d 20 2b 79 2f 62 61 72 2b 29 0a 2d 2d 2d tem +y/bar+).---
27d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
27e0: 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a .[requirements].
27f0: 6d 6f 64 65 20 69 74 65 6d 77 61 69 74 0a 23 20 mode itemwait.#
2800: 69 74 65 6d 6d 61 70 20 3c 69 74 65 6d 20 70 61 itemmap <item pa
2810: 74 74 65 72 6e 20 66 6f 72 20 74 68 69 73 20 74 ttern for this t
2820: 65 73 74 3e 20 20 3c 69 74 65 6d 20 72 65 70 6c est> <item repl
2830: 61 63 65 6d 65 6e 74 20 70 61 74 74 65 72 6e 20 acement pattern
2840: 66 6f 72 20 77 61 69 74 6f 6e 20 74 65 73 74 3e for waiton test>
2850: 0a 69 74 65 6d 6d 61 70 20 2e 2a 78 2f 20 79 2f .itemmap .*x/ y/
2860: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
2870: 2d 2d 2d 2d 2d 0a 0a 2e 65 78 61 6d 70 6c 65 20 -----...example
2880: 66 6f 72 20 72 65 6d 6f 76 69 6e 67 20 70 61 72 for removing par
2890: 74 20 6f 66 20 69 74 65 6d 6d 61 70 20 66 6f 72 t of itemmap for
28a0: 20 77 61 69 74 6f 6e 20 74 65 73 74 20 28 65 67 waiton test (eg
28b0: 3a 20 69 74 65 6d 20 2b 66 6f 6f 2f 62 61 72 2f : item +foo/bar/
28c0: 62 61 7a 2b 20 69 6e 20 74 68 69 73 20 74 65 73 baz+ in this tes
28d0: 74 20 64 65 70 65 6e 64 73 20 6f 6e 20 77 61 69 t depends on wai
28e0: 74 6f 6e 27 73 20 69 74 65 6d 20 2b 62 61 7a 2b ton's item +baz+
28f0: 29 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ).--------------
2900: 2d 2d 2d 2d 2d 0a 0a 23 20 23 23 20 70 61 74 74 -----..# ## patt
2910: 65 72 6e 20 72 65 70 6c 61 63 65 6d 65 6e 74 20 ern replacement
2920: 6e 6f 74 65 73 0a 23 0a 23 20 23 23 20 45 78 61 notes.#.# ## Exa
2930: 6d 70 6c 65 0a 23 20 23 23 20 52 65 6d 6f 76 65 mple.# ## Remove
2940: 20 65 76 65 72 79 74 68 69 6e 67 20 75 70 20 74 everything up t
2950: 6f 20 74 68 65 20 6c 61 73 74 20 2f 0a 5b 72 65 o the last /.[re
2960: 71 75 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 quirements].mode
2970: 20 69 74 65 6d 77 61 69 74 0a 23 20 69 74 65 6d itemwait.# item
2980: 6d 61 70 20 3c 69 74 65 6d 20 70 61 74 74 65 72 map <item patter
2990: 6e 20 66 6f 72 20 74 68 69 73 20 74 65 73 74 3e n for this test>
29a0: 20 3c 6e 6f 74 68 69 6e 67 20 68 65 72 65 20 69 <nothing here i
29b0: 6e 64 69 63 61 74 65 73 20 72 65 6d 6f 76 61 6c ndicates removal
29c0: 3e 0a 69 74 65 6d 6d 61 70 20 2e 2a 2f 0a 2d 2d >.itemmap .*/.--
29d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
29e0: 2d 0a 0a 2e 65 78 61 6d 70 6c 65 20 72 65 70 6c -...example repl
29f0: 61 63 69 6e 67 20 70 61 72 74 20 6f 66 20 69 74 acing part of it
2a00: 65 6d 6d 61 70 20 66 6f 72 20 28 65 67 3a 20 69 emmap for (eg: i
2a10: 74 65 6d 20 2b 66 6f 6f 2f 31 32 33 34 2b 20 77 tem +foo/1234+ w
2a20: 69 6c 6c 20 69 6d 70 6c 79 20 77 61 69 74 6f 6e ill imply waiton
2a30: 27 73 20 69 74 65 6d 20 2b 62 61 72 2f 31 32 33 's item +bar/123
2a40: 34 2b 29 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 4+).------------
2a50: 2d 2d 2d 2d 2d 2d 2d 0a 0a 23 0a 23 20 23 23 20 -------..#.# ##
2a60: 45 78 61 6d 70 6c 65 0a 23 20 23 23 20 52 65 70 Example.# ## Rep
2a70: 6c 61 63 65 20 66 6f 6f 2f 20 77 69 74 68 20 62 lace foo/ with b
2a80: 61 72 2f 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 ar/.[requirement
2a90: 73 5d 0a 6d 6f 64 65 20 69 74 65 6d 77 61 69 74 s].mode itemwait
2aa0: 0a 23 20 69 74 65 6d 6d 61 70 20 3c 69 74 65 6d .# itemmap <item
2ab0: 20 70 61 74 74 65 72 6e 20 66 6f 72 20 74 68 69 pattern for thi
2ac0: 73 20 74 65 73 74 3e 20 20 3c 69 74 65 6d 20 72 s test> <item r
2ad0: 65 70 6c 61 63 65 6d 65 6e 74 20 70 61 74 74 65 eplacement patte
2ae0: 72 6e 20 66 6f 72 20 77 61 69 74 6f 6e 20 74 65 rn for waiton te
2af0: 73 74 3e 0a 69 74 65 6d 6d 61 70 20 66 6f 6f 2f st>.itemmap foo/
2b00: 20 62 61 72 2f 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d bar/..---------
2b10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 78 61 ----------...exa
2b20: 6d 70 6c 65 20 66 6f 72 20 62 61 63 6b 72 65 66 mple for backref
2b30: 65 72 65 6e 63 65 20 28 65 67 3a 20 69 74 65 6d erence (eg: item
2b40: 20 2b 66 6f 6f 32 33 2f 74 68 75 64 2b 20 77 69 +foo23/thud+ wi
2b50: 6c 6c 20 69 6d 70 6c 79 20 77 61 69 74 6f 6e 27 ll imply waiton'
2b60: 73 20 69 74 65 6d 20 2b 6e 75 6d 2d 32 33 2f 62 s item +num-23/b
2b70: 61 72 2f 74 68 75 64 2b 0a 2d 2d 2d 2d 2d 2d 2d ar/thud+.-------
2b80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 0a 23 ------------.#.#
2b90: 20 23 23 20 45 78 61 6d 70 6c 65 0a 23 20 23 23 ## Example.# ##
2ba0: 20 63 61 6e 20 75 73 65 20 5c 7b 6e 75 6d 62 65 can use \{numbe
2bb0: 72 7d 20 69 6e 20 72 65 70 6c 61 63 65 6d 65 6e r} in replacemen
2bc0: 74 20 70 61 74 74 65 72 6e 20 74 6f 20 62 61 63 t pattern to bac
2bd0: 6b 72 65 66 65 72 65 6e 63 65 20 61 20 28 63 61 kreference a (ca
2be0: 70 74 75 72 65 29 20 66 72 6f 6d 20 6d 61 74 63 pture) from matc
2bf0: 68 69 6e 67 20 70 61 74 74 65 72 6e 20 73 69 6d hing pattern sim
2c00: 69 6c 61 72 20 74 6f 20 73 65 64 20 6f 72 20 70 ilar to sed or p
2c10: 65 72 6c 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 erl.[requirement
2c20: 73 5d 0a 6d 6f 64 65 20 69 74 65 6d 77 61 69 74 s].mode itemwait
2c30: 0a 23 20 69 74 65 6d 6d 61 70 20 3c 69 74 65 6d .# itemmap <item
2c40: 20 70 61 74 74 65 72 6e 20 66 6f 72 20 74 68 69 pattern for thi
2c50: 73 20 74 65 73 74 3e 20 20 3c 69 74 65 6d 20 72 s test> <item r
2c60: 65 70 6c 61 63 65 6d 65 6e 74 20 70 61 74 74 65 eplacement patte
2c70: 72 6e 20 66 6f 72 20 77 61 69 74 6f 6e 20 74 65 rn for waiton te
2c80: 73 74 3e 0a 69 74 65 6d 6d 61 70 20 66 6f 6f 28 st>.itemmap foo(
2c90: 5c 64 2b 29 2f 20 6e 75 6d 2d 5c 31 2f 62 61 72 \d+)/ num-\1/bar
2ca0: 2f 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d /..-------------
2cb0: 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 78 61 6d 70 6c 65 ------...example
2cc0: 20 6d 75 6c 74 69 70 6c 65 20 69 74 65 6d 6d 61 multiple itemma
2cd0: 70 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ps.-------------
2ce0: 2d 2d 2d 2d 2d 2d 0a 0a 23 20 6d 75 6c 74 69 2d ------..# multi-
2cf0: 6c 69 6e 65 3b 20 6d 61 74 63 68 65 73 20 61 72 line; matches ar
2d00: 65 20 61 70 70 6c 69 65 64 20 69 6e 20 74 68 65 e applied in the
2d10: 20 6c 69 73 74 65 64 20 6f 72 64 65 72 0a 23 20 listed order.#
2d20: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 77 6f The following wo
2d30: 75 6c 64 20 6d 61 70 3a 0a 23 20 20 20 61 31 32 uld map:.# a12
2d40: 33 62 33 32 31 20 74 6f 20 62 33 32 31 66 6f 6f 3b321 to b321foo
2d50: 61 31 32 33 20 74 68 65 6e 20 74 6f 20 33 32 31 a123 then to 321
2d60: 66 6f 6f 61 31 32 33 70 0a 23 0a 5b 72 65 71 75 fooa123p.#.[requ
2d70: 69 72 65 6d 65 6e 74 73 5d 0a 69 74 65 6d 6d 61 irements].itemma
2d80: 70 20 28 61 5c 64 2b 29 28 62 5c 64 2b 29 20 5c p (a\d+)(b\d+) \
2d90: 32 66 6f 6f 5c 31 0a 20 20 62 28 2e 2a 29 20 5c 2foo\1. b(.*) \
2da0: 31 70 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 1p.-------------
2db0: 2d 2d 2d 2d 2d 2d 0a 0a 0a 43 6f 6d 70 6c 65 78 ------...Complex
2dc0: 20 6d 61 70 70 69 6e 67 0a 5e 5e 5e 5e 5e 5e 5e mapping.^^^^^^^
2dd0: 5e 5e 5e 5e 5e 5e 5e 5e 0a 43 6f 6d 70 6c 65 78 ^^^^^^^^.Complex
2de0: 20 6d 61 70 70 69 6e 67 73 20 63 61 6e 20 62 65 mappings can be
2df0: 20 68 61 6e 64 6c 65 64 20 77 69 74 68 20 61 20 handled with a
2e00: 73 65 70 61 72 61 74 65 20 5b 69 74 65 6d 6d 61 separate [itemma
2e10: 70 5d 20 73 65 63 74 69 6f 6e 20 28 69 6e 73 74 p] section (inst
2e20: 65 61 64 20 69 66 20 61 6e 20 69 74 65 6d 6d 61 ead if an itemma
2e30: 70 20 6c 69 6e 65 20 69 6e 20 74 68 65 20 5b 72 p line in the [r
2e40: 65 71 75 69 72 65 6d 65 6e 74 73 5d 20 73 65 63 equirements] sec
2e50: 74 69 6f 6e 29 0a 0a 45 61 63 68 20 6c 69 6e 65 tion)..Each line
2e60: 20 69 6e 20 61 6e 20 69 74 65 6d 6d 61 70 20 73 in an itemmap s
2e70: 65 63 74 69 6f 6e 20 73 74 61 72 74 73 20 77 69 ection starts wi
2e80: 74 68 20 61 20 77 61 69 74 6f 6e 20 74 65 73 74 th a waiton test
2e90: 20 6e 61 6d 65 20 66 6f 6c 6c 6f 77 65 64 20 62 name followed b
2ea0: 79 20 61 6e 20 69 74 65 6d 6d 61 70 20 65 78 70 y an itemmap exp
2eb0: 72 65 73 73 69 6f 6e 0a 0a 2e 65 67 3a 20 54 68 ression...eg: Th
2ec0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 61 75 73 e following caus
2ed0: 65 73 20 77 61 69 74 6f 6e 20 74 65 73 74 20 41 es waiton test A
2ee0: 20 69 74 65 6d 20 2b 62 61 72 2f 31 32 33 34 2b item +bar/1234+
2ef0: 20 74 6f 20 72 75 6e 20 77 68 65 6e 20 6f 75 72 to run when our
2f00: 20 74 65 73 74 27 73 20 2b 66 6f 6f 2f 31 32 33 test's +foo/123
2f10: 34 2b 20 69 74 65 6d 20 69 73 20 72 65 71 75 65 4+ item is reque
2f20: 73 74 65 64 20 61 73 20 77 65 6c 6c 20 61 73 20 sted as well as
2f30: 63 61 75 73 69 6e 67 20 77 61 69 74 6f 6e 20 74 causing waiton t
2f40: 65 73 74 20 42 27 73 20 2b 62 6c 61 68 2b 20 69 est B's +blah+ i
2f50: 74 65 6d 20 74 6f 20 72 75 6e 20 77 68 65 6e 20 tem to run when
2f60: 6f 75 72 20 74 65 73 74 27 73 20 2b 73 74 75 66 our test's +stuf
2f70: 66 2f 62 6c 61 68 2b 20 69 74 65 6d 20 69 73 20 f/blah+ item is
2f80: 72 65 71 75 65 73 74 65 64 0a 2d 2d 2d 2d 2d 2d requested.------
2f90: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 69 74 65 6d 6d 61 --------.[itemma
2fa0: 70 5d 0a 41 20 66 6f 6f 2f 20 62 61 72 2f 0a 42 p].A foo/ bar/.B
2fb0: 20 73 74 75 66 66 2f 0a 2d 2d 2d 2d 2d 2d 2d 2d stuff/.--------
2fc0: 2d 2d 2d 2d 2d 2d 0a 0a 0a 43 6f 6d 70 6c 65 78 ------...Complex
2fd0: 20 6d 61 70 70 69 6e 67 20 65 78 61 6d 70 6c 65 mapping example
2fe0: 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e .^^^^^^^^^^^^^^^
2ff0: 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 0a 0a 2f 2f 20 69 ^^^^^^^^....// i
3000: 6d 61 67 65 3a 3a 69 74 65 6d 6d 61 70 2e 70 6e mage::itemmap.pn
3010: 67 5b 5d 0a 69 6d 61 67 65 3a 3a 63 6f 6d 70 6c g[].image::compl
3020: 65 78 2d 69 74 65 6d 6d 61 70 2e 70 6e 67 5b 5d ex-itemmap.png[]
3030: 0a 0a 0a 57 65 20 61 63 63 6f 6d 70 6c 69 73 68 ...We accomplish
3040: 20 74 68 69 73 20 62 79 20 63 6f 6e 66 69 67 75 this by configu
3050: 72 69 6e 67 20 74 68 65 20 74 65 73 74 63 6f 6e ring the testcon
3060: 66 69 67 73 20 6f 66 20 6f 75 72 20 74 65 73 74 figs of our test
3070: 73 20 43 20 44 20 61 6e 64 20 45 20 61 73 20 66 s C D and E as f
3080: 6f 6c 6c 6f 77 73 3a 0a 0a 2e 54 65 73 74 63 6f ollows:...Testco
3090: 6e 66 69 67 20 66 6f 72 20 54 65 73 74 20 45 20 nfig for Test E
30a0: 68 61 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d has.------------
30b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 ----------.[requ
30c0: 69 72 65 6d 65 6e 74 73 5d 0a 77 61 69 74 6f 6e irements].waiton
30d0: 20 43 0a 69 74 65 6d 6d 61 70 20 28 5c 64 2b 29 C.itemmap (\d+)
30e0: 2f 72 65 73 20 5c 31 2f 62 62 0a 2d 2d 2d 2d 2d /res \1/bb.-----
30f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3100: 2d 0a 0a 2e 54 65 73 74 63 6f 6e 66 69 67 20 66 -...Testconfig f
3110: 6f 72 20 54 65 73 74 20 44 20 68 61 73 0a 2d 2d or Test D has.--
3120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3130: 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e ----.[requiremen
3140: 74 73 5d 0a 77 61 69 74 6f 6e 20 43 0a 69 74 65 ts].waiton C.ite
3150: 6d 6d 61 70 20 28 5c 64 2b 29 2f 72 65 73 20 5c mmap (\d+)/res \
3160: 31 2f 61 61 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 1/aa.-----------
3170: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 54 65 -----------...Te
3180: 73 74 63 6f 6e 66 69 67 20 66 6f 72 20 54 65 73 stconfig for Tes
3190: 74 20 43 20 68 61 73 0a 2d 2d 2d 2d 2d 2d 2d 2d t C has.--------
31a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
31b0: 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 77 61 requirements].wa
31c0: 69 74 6f 6e 20 41 20 42 0a 0a 5b 69 74 65 6d 6d iton A B..[itemm
31d0: 61 70 5d 0a 41 20 28 5c 64 2b 29 2f 61 61 20 61 ap].A (\d+)/aa a
31e0: 61 2f 5c 31 0a 42 20 28 5c 64 2b 29 2f 62 62 20 a/\1.B (\d+)/bb
31f0: 62 62 2f 5c 31 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d bb/\1.----------
3200: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 54 ------------...T
3210: 65 73 74 63 6f 6e 66 69 67 73 20 66 6f 72 20 54 estconfigs for T
3220: 65 73 74 20 42 20 61 6e 64 20 54 65 73 74 20 41 est B and Test A
3230: 20 68 61 76 65 20 6e 6f 20 77 61 69 74 6f 6e 20 have no waiton
3240: 6f 72 20 69 74 65 6d 6d 61 70 20 63 6f 6e 66 69 or itemmap confi
3250: 67 75 72 65 64 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d gured.----------
3260: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2d 2d 2d 2d 2d 2d ---------.------
3270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e -------------...
3280: 57 61 6c 6b 20 74 68 72 6f 75 67 68 20 6f 6e 65 Walk through one
3290: 20 69 74 65 6d 20 2d 2d 20 77 65 20 77 61 6e 74 item -- we want
32a0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 the following t
32b0: 6f 20 68 61 70 70 65 6e 20 66 6f 72 20 74 65 73 o happen for tes
32c0: 74 70 61 74 74 20 2b 44 2f 31 2f 72 65 73 2b 20 tpatt +D/1/res+
32d0: 28 73 65 65 20 62 6c 75 65 20 62 6f 78 65 73 20 (see blue boxes
32e0: 69 6e 20 63 6f 6d 70 6c 65 78 20 69 74 65 6d 6d in complex itemm
32f0: 61 70 69 6e 67 20 66 69 67 75 72 65 20 61 62 6f aping figure abo
3300: 76 65 29 3a 0a 0a 2e 20 65 67 20 66 72 6f 6d 20 ve):... eg from
3310: 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 2b 6d 65 command line +me
3320: 67 61 74 65 73 74 20 2d 72 75 6e 20 2d 74 65 73 gatest -run -tes
3330: 74 70 61 74 74 20 44 2f 31 2f 72 65 73 20 2d 74 tpatt D/1/res -t
3340: 61 72 67 65 74 20 6d 79 74 61 72 67 65 74 20 2d arget mytarget -
3350: 72 75 6e 6e 61 6d 65 20 6d 79 72 75 6e 6e 61 6d runname myrunnam
3360: 65 2b 0a 2e 20 46 75 6c 6c 20 6c 69 73 74 20 74 e+.. Full list t
3370: 6f 20 62 65 20 72 75 6e 20 69 73 20 6e 6f 77 3a o be run is now:
3380: 20 2b 44 2f 31 2f 72 65 73 2b 0a 2e 20 54 65 73 +D/1/res+.. Tes
3390: 74 20 44 20 68 61 73 20 61 20 77 61 69 74 6f 6e t D has a waiton
33a0: 20 2d 20 74 65 73 74 20 43 2e 20 20 54 65 73 74 - test C. Test
33b0: 20 44 27 73 20 69 74 65 6d 6d 61 70 20 72 75 6c D's itemmap rul
33c0: 65 20 2b 69 74 65 6d 6d 61 70 20 28 5c 64 26 70 e +itemmap (\d&p
33d0: 6c 75 73 3b 29 2f 72 65 73 20 5c 31 2f 61 61 2b lus;)/res \1/aa+
33e0: 20 2d 3e 20 20 63 61 75 73 65 73 20 2b 43 2f 31 -> causes +C/1
33f0: 2f 61 61 2b 20 74 6f 20 72 75 6e 20 62 65 66 6f /aa+ to run befo
3400: 72 65 20 2b 44 2f 31 2f 72 65 73 2b 0a 2e 20 46 re +D/1/res+.. F
3410: 75 6c 6c 20 6c 69 73 74 20 74 6f 20 62 65 20 72 ull list to be r
3420: 75 6e 20 69 73 20 6e 6f 77 3a 20 2b 44 2f 31 2f un is now: +D/1/
3430: 72 65 73 2b 2c 20 2b 43 2f 31 2f 61 61 2b 0a 2e res+, +C/1/aa+..
3440: 20 54 65 73 74 20 43 20 77 61 73 20 61 20 77 61 Test C was a wa
3450: 69 74 6f 6e 20 2d 20 74 65 73 74 20 41 2e 20 54 iton - test A. T
3460: 65 73 74 20 43 27 73 20 72 75 6c 65 20 2b 41 20 est C's rule +A
3470: 28 5c 64 26 70 6c 75 73 3b 29 2f 61 61 20 61 61 (\d+)/aa aa
3480: 2f 5c 31 2b 20 2d 3e 20 63 61 75 73 65 73 20 2b /\1+ -> causes +
3490: 41 2f 61 61 2f 31 2b 20 74 6f 20 72 75 6e 20 62 A/aa/1+ to run b
34a0: 65 66 6f 72 65 20 2b 43 2f 31 2f 61 61 2b 0a 2e efore +C/1/aa+..
34b0: 20 46 75 6c 6c 20 6c 69 73 74 20 74 6f 20 62 65 Full list to be
34c0: 20 72 75 6e 20 69 73 20 6e 6f 77 3a 20 2b 44 2f run is now: +D/
34d0: 31 2f 72 65 73 2b 2c 20 2b 43 2f 31 2f 61 61 2b 1/res+, +C/1/aa+
34e0: 2c 20 2b 41 2f 61 61 2f 31 2b 0a 2e 20 54 65 73 , +A/aa/1+.. Tes
34f0: 74 20 41 20 68 61 73 20 6e 6f 20 77 61 69 74 6f t A has no waito
3500: 6e 73 2e 20 20 41 6c 6c 20 77 61 69 74 6f 6e 73 ns. All waitons
3510: 20 6f 66 20 61 6c 6c 20 74 65 73 74 73 20 69 6e of all tests in
3520: 20 66 75 6c 6c 20 6c 69 73 74 20 68 61 76 65 20 full list have
3530: 62 65 65 6e 20 70 72 6f 63 65 73 73 65 64 2e 20 been processed.
3540: 20 46 75 6c 6c 20 6c 69 73 74 20 69 73 20 66 69 Full list is fi
3550: 6e 61 6c 69 7a 65 64 2e 0a 0a 0a 44 79 6e 61 6d nalized....Dynam
3560: 69 63 20 46 6c 6f 77 20 44 65 70 65 6e 64 65 6e ic Flow Dependen
3570: 63 79 20 54 72 65 65 0a 5e 5e 5e 5e 5e 5e 5e 5e cy Tree.^^^^^^^^
3580: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3590: 5e 5e 5e 5e 0a 0a 2e 41 75 74 6f 67 65 6e 65 72 ^^^^...Autogener
35a0: 61 74 69 6f 6e 20 77 61 69 74 6f 6e 20 6c 69 73 ation waiton lis
35b0: 74 20 66 6f 72 20 64 79 6e 61 6d 69 63 20 66 6c t for dynamic fl
35c0: 6f 77 20 64 65 70 65 6e 64 65 6e 63 79 20 74 72 ow dependency tr
35d0: 65 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ees.------------
35e0: 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 -------.[require
35f0: 6d 65 6e 74 73 5d 0a 23 20 57 69 74 68 20 61 20 ments].# With a
3600: 74 6f 70 6c 65 76 65 6c 20 74 65 73 74 20 79 6f toplevel test yo
3610: 75 20 6d 61 79 20 77 69 73 68 20 74 6f 20 67 65 u may wish to ge
3620: 6e 65 72 61 74 65 20 79 6f 75 72 20 6c 69 73 74 nerate your list
3630: 20 0a 23 20 6f 66 20 74 65 73 74 73 20 74 6f 20 .# of tests to
3640: 72 75 6e 20 64 79 6e 61 6d 69 63 61 6c 6c 79 0a run dynamically.
3650: 23 0a 77 61 69 74 6f 6e 20 23 7b 73 68 65 6c 6c #.waiton #{shell
3660: 20 67 65 74 2d 76 61 6c 69 64 2d 74 65 73 74 73 get-valid-tests
3670: 2d 74 6f 2d 72 75 6e 2e 73 68 7d 0a 2d 2d 2d 2d -to-run.sh}.----
3680: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
3690: 0a 52 75 6e 20 74 69 6d 65 20 6c 69 6d 69 74 0a .Run time limit.
36a0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a ^^^^^^^^^^^^^^..
36b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
36c0: 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d -.[requirements]
36d0: 0a 72 75 6e 74 69 6d 65 6c 69 6d 20 31 68 20 32 .runtimelim 1h 2
36e0: 6d 20 33 73 20 20 23 20 74 68 69 73 20 77 69 6c m 3s # this wil
36f0: 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 l automatically
3700: 6b 69 6c 6c 20 74 68 65 20 74 65 73 74 20 69 66 kill the test if
3710: 20 69 74 20 72 75 6e 73 20 66 6f 72 20 6d 6f 72 it runs for mor
3720: 65 20 74 68 61 6e 20 31 68 20 32 6d 20 61 6e 64 e than 1h 2m and
3730: 20 33 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 3s.------------
3740: 2d 2d 2d 2d 2d 0a 0a 53 6b 69 70 0a 5e 5e 5e 5e -----..Skip.^^^^
3750: 0a 0a 41 20 74 65 73 74 20 77 69 74 68 20 61 20 ..A test with a
3760: 73 6b 69 70 20 73 65 63 74 69 6f 6e 20 77 69 6c skip section wil
3770: 6c 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 20 73 6b l conditional sk
3780: 69 70 20 72 75 6e 6e 69 6e 67 2e 0a 0a 2e 53 6b ip running....Sk
3790: 69 70 20 73 65 63 74 69 6f 6e 20 65 78 61 6d 70 ip section examp
37a0: 6c 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d le.-------------
37b0: 2d 2d 2d 2d 0a 5b 73 6b 69 70 5d 0a 70 72 65 76 ----.[skip].prev
37c0: 72 75 6e 6e 69 6e 67 20 78 0a 23 20 72 75 6e 64 running x.# rund
37d0: 65 6c 61 79 20 33 30 6d 20 31 35 73 0a 2d 2d 2d elay 30m 15s.---
37e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
37f0: 53 6b 69 70 20 6f 6e 20 53 74 69 6c 6c 2d 72 75 Skip on Still-ru
3800: 6e 6e 69 6e 67 20 54 65 73 74 73 0a 5e 5e 5e 5e nning Tests.^^^^
3810: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3820: 5e 5e 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d ^^^^^^^..-------
3830: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 4e 42 2f ----------.# NB/
3840: 2f 20 49 66 20 74 68 65 20 70 72 65 76 72 75 6e / If the prevrun
3850: 6e 69 6e 67 20 6c 69 6e 65 20 65 78 69 73 74 73 ning line exists
3860: 20 77 69 74 68 20 2a 61 6e 79 2a 20 76 61 6c 75 with *any* valu
3870: 65 20 74 68 65 20 74 65 73 74 20 77 69 6c 6c 0a e the test will.
3880: 23 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 # automatically
3890: 53 4b 49 50 20 69 66 20 74 68 65 20 73 61 6d 65 SKIP if the same
38a0: 2d 6e 61 6d 65 64 20 74 65 73 74 20 69 73 20 63 -named test is c
38b0: 75 72 72 65 6e 74 6c 79 20 52 55 4e 4e 49 4e 47 urrently RUNNING
38c0: 2e 20 54 68 65 0a 23 20 22 78 22 20 63 61 6e 20 . The.# "x" can
38d0: 62 65 20 61 6e 79 20 73 74 72 69 6e 67 2e 20 43 be any string. C
38e0: 6f 6d 6d 65 6e 74 20 6f 75 74 20 74 68 65 20 70 omment out the p
38f0: 72 65 76 72 75 6e 6e 69 6e 67 20 6c 69 6e 65 20 revrunning line
3900: 74 6f 20 74 75 72 6e 20 6f 66 66 0a 23 20 73 6b to turn off.# sk
3910: 69 70 2e 0a 0a 5b 73 6b 69 70 5d 0a 70 72 65 76 ip...[skip].prev
3920: 72 75 6e 6e 69 6e 67 20 78 0a 2d 2d 2d 2d 2d 2d running x.------
3930: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 -----------..Ski
3940: 70 20 69 66 20 61 20 46 69 6c 65 20 45 78 69 73 p if a File Exis
3950: 74 73 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ts.^^^^^^^^^^^^^
3960: 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d ^^^^^^^^..------
3970: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 6b 69 -----------.[ski
3980: 70 5d 0a 66 69 6c 65 65 78 69 73 74 73 20 2f 70 p].fileexists /p
3990: 61 74 68 2f 74 6f 2f 61 2f 66 69 6c 65 20 23 20 ath/to/a/file #
39a0: 73 6b 69 70 20 69 66 20 2f 70 61 74 68 2f 74 6f skip if /path/to
39b0: 2f 61 2f 66 69 6c 65 20 65 78 69 73 74 73 0a 2d /a/file exists.-
39c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
39d0: 0a 0a 53 6b 69 70 20 69 66 20 74 65 73 74 20 72 ..Skip if test r
39e0: 61 6e 20 6d 6f 72 65 20 72 65 63 65 6e 74 6c 79 an more recently
39f0: 20 74 68 61 6e 20 73 70 65 63 69 66 69 65 64 20 than specified
3a00: 74 69 6d 65 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e time.^^^^^^^^^^^
3a10: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3a20: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3a30: 5e 5e 5e 5e 5e 5e 5e 0a 0a 2e 53 6b 69 70 20 69 ^^^^^^^...Skip i
3a40: 66 20 74 68 69 73 20 74 65 73 74 20 68 61 73 20 f this test has
3a50: 62 65 65 6e 20 72 75 6e 20 69 6e 20 74 68 65 20 been run in the
3a60: 70 61 73 74 20 66 69 66 74 65 65 6e 20 6d 69 6e past fifteen min
3a70: 75 74 65 73 20 61 6e 64 20 31 35 20 73 65 63 6f utes and 15 seco
3a80: 6e 64 73 2e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d nds..-----------
3a90: 2d 2d 2d 2d 2d 2d 0a 5b 73 6b 69 70 5d 0a 72 75 ------.[skip].ru
3aa0: 6e 64 65 6c 61 79 20 31 35 6d 20 31 35 73 0a 2d ndelay 15m 15s.-
3ab0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3ac0: 0a 0a 44 69 73 6b 73 0a 5e 5e 5e 5e 5e 0a 0a 41 ..Disks.^^^^^..A
3ad0: 20 64 69 73 6b 73 20 73 65 63 74 69 6f 6e 20 69 disks section i
3ae0: 6e 20 74 65 73 74 63 6f 6e 66 69 67 20 77 69 6c n testconfig wil
3af0: 6c 20 6f 76 65 72 72 69 64 65 20 74 68 65 20 64 l override the d
3b00: 69 73 6b 73 20 73 65 63 74 69 6f 6e 20 69 6e 0a isks section in.
3b10: 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 2e megatest.config.
3b20: 20 54 68 69 73 20 63 61 6e 20 62 65 20 75 73 65 This can be use
3b30: 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 64 69 d to allocate di
3b40: 73 6b 73 20 6f 6e 20 61 20 70 65 72 2d 74 65 73 sks on a per-tes
3b50: 74 20 6f 72 20 70 65 72 20 69 74 65 6d 0a 62 61 t or per item.ba
3b60: 73 69 73 2e 0a 0a 43 6f 6e 74 72 6f 6c 6c 65 64 sis...Controlled
3b70: 20 77 61 69 76 65 72 20 70 72 6f 70 61 67 61 74 waiver propagat
3b80: 69 6f 6e 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ion.^^^^^^^^^^^^
3b90: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3ba0: 5e 0a 0a 49 66 20 74 65 73 74 20 69 73 20 46 41 ^..If test is FA
3bb0: 49 4c 20 61 6e 64 20 70 72 65 76 69 6f 75 73 20 IL and previous
3bc0: 74 65 73 74 20 69 6e 20 72 75 6e 20 77 69 74 68 test in run with
3bd0: 20 73 61 6d 65 20 4d 54 5f 54 41 52 47 45 54 20 same MT_TARGET
3be0: 69 73 20 57 41 49 56 45 44 20 74 68 65 6e 20 61 is WAIVED then a
3bf0: 70 70 6c 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 pply the followi
3c00: 6e 67 20 72 75 6c 65 73 20 66 72 6f 6d 20 74 68 ng rules from th
3c10: 65 20 74 65 73 74 63 6f 6e 66 69 67 3a 0a 49 66 e testconfig:.If
3c20: 20 61 20 77 61 69 76 65 72 20 63 68 65 63 6b 20 a waiver check
3c30: 69 73 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 is specified in
3c40: 74 68 65 20 74 65 73 74 63 6f 6e 66 69 67 20 61 the testconfig a
3c50: 70 70 6c 79 20 74 68 65 20 63 68 65 63 6b 20 61 pply the check a
3c60: 6e 64 20 69 66 20 69 74 20 70 61 73 73 65 73 20 nd if it passes
3c70: 74 68 65 6e 20 73 65 74 20 74 68 69 73 20 46 41 then set this FA
3c80: 49 4c 20 74 6f 20 57 41 49 56 45 44 0a 0a 57 61 IL to WAIVED..Wa
3c90: 69 76 65 72 20 63 68 65 63 6b 20 68 61 73 20 74 iver check has t
3ca0: 77 6f 20 70 61 72 74 73 2c 20 31 29 20 61 20 6c wo parts, 1) a l
3cb0: 69 73 74 20 6f 66 20 77 61 69 76 65 72 2c 20 72 ist of waiver, r
3cc0: 75 6c 65 6e 61 6d 65 2c 20 66 69 6c 65 70 61 74 ulename, filepat
3cd0: 74 65 72 6e 73 20 61 6e 64 20 32 29 20 74 68 65 terns and 2) the
3ce0: 20 72 75 6c 65 6e 61 6d 65 20 73 63 72 69 70 74 rulename script
3cf0: 20 73 70 65 63 20 28 6e 6f 74 65 20 74 68 61 74 spec (note that
3d00: 20 22 64 69 66 66 22 20 61 6e 64 20 22 6c 6f 67 "diff" and "log
3d10: 70 72 6f 22 20 61 72 65 20 70 72 65 64 65 66 69 pro" are predefi
3d20: 6e 65 64 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ned)..----------
3d30: 2d 2d 2d 2d 2d 2d 2d 0a 23 23 23 23 23 23 20 45 -------.###### E
3d40: 58 41 4d 50 4c 45 20 46 52 4f 4d 20 74 65 73 74 XAMPLE FROM test
3d50: 63 6f 6e 66 69 67 20 23 23 23 23 23 23 23 23 23 config #########
3d60: 0a 23 20 6d 61 74 63 68 69 6e 67 20 66 69 6c 65 .# matching file
3d70: 28 73 29 20 77 69 6c 6c 20 62 65 20 64 69 66 66 (s) will be diff
3d80: 27 64 20 77 69 74 68 20 70 72 65 76 69 6f 75 73 'd with previous
3d90: 20 72 75 6e 20 61 6e 64 20 6c 6f 67 70 72 6f 20 run and logpro
3da0: 61 70 70 6c 69 65 64 0a 23 20 69 66 20 50 41 53 applied.# if PAS
3db0: 53 20 6f 72 20 57 41 52 4e 20 72 65 73 75 6c 74 S or WARN result
3dc0: 20 66 72 6f 6d 20 6c 6f 67 70 72 6f 20 74 68 65 from logpro the
3dd0: 6e 20 57 41 49 56 45 52 20 73 74 61 74 65 20 69 n WAIVER state i
3de0: 73 20 73 65 74 0a 23 0a 5b 77 61 69 76 65 72 73 s set.#.[waivers
3df0: 5d 0a 23 20 6c 6f 67 70 72 6f 5f 66 69 6c 65 20 ].# logpro_file
3e00: 20 20 20 72 75 6c 65 6e 61 6d 65 20 20 20 20 20 rulename
3e10: 20 69 6e 70 75 74 5f 67 6c 6f 62 0a 77 61 69 76 input_glob.waiv
3e20: 65 72 5f 31 20 20 20 20 20 20 20 20 20 6c 6f 67 er_1 log
3e30: 70 72 6f 20 20 20 20 20 20 20 20 6c 6f 6f 6b 69 pro looki
3e40: 74 74 6d 70 2e 6c 6f 67 0a 0a 5b 77 61 69 76 65 ttmp.log..[waive
3e50: 72 5f 72 75 6c 65 73 5d 0a 0a 23 20 54 68 69 73 r_rules]..# This
3e60: 20 62 75 69 6c 74 69 6e 20 72 75 6c 65 20 69 73 builtin rule is
3e70: 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 66 20 the default if
3e80: 74 68 65 72 65 20 69 73 20 6e 6f 20 3c 77 61 69 there is no <wai
3e90: 76 65 72 6e 61 6d 65 3e 2e 6c 6f 67 70 72 6f 20 vername>.logpro
3ea0: 66 69 6c 65 0a 23 20 64 69 66 66 20 20 20 64 69 file.# diff di
3eb0: 66 66 20 25 66 69 6c 65 31 25 20 25 66 69 6c 65 ff %file1% %file
3ec0: 32 25 0a 0a 23 20 54 68 69 73 20 62 75 69 6c 74 2%..# This built
3ed0: 69 6e 20 72 75 6c 65 20 69 73 20 61 70 70 6c 69 in rule is appli
3ee0: 65 64 20 69 66 20 61 20 3c 77 61 69 76 65 72 6e ed if a <waivern
3ef0: 61 6d 65 3e 2e 6c 6f 67 70 72 6f 20 66 69 6c 65 ame>.logpro file
3f00: 20 65 78 69 73 74 73 0a 23 20 6c 6f 67 70 72 6f exists.# logpro
3f10: 20 64 69 66 66 20 25 66 69 6c 65 31 25 20 25 66 diff %file1% %f
3f20: 69 6c 65 32 25 20 7c 20 6c 6f 67 70 72 6f 20 25 ile2% | logpro %
3f30: 77 61 69 76 65 72 6e 61 6d 65 25 2e 6c 6f 67 70 waivername%.logp
3f40: 72 6f 20 25 77 61 69 76 65 72 6e 61 6d 65 25 2e ro %waivername%.
3f50: 68 74 6d 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d html.-----------
3f60: 2d 2d 2d 2d 2d 2d 0a 0a 45 7a 73 74 65 70 73 0a ------..Ezsteps.
3f70: 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 45 78 61 6d 70 6c ~~~~~~~...Exampl
3f80: 65 20 65 7a 73 74 65 70 73 20 77 69 74 68 20 6c e ezsteps with l
3f90: 6f 67 70 72 6f 20 72 75 6c 65 73 0a 2d 2d 2d 2d ogpro rules.----
3fa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 65 -------------.[e
3fb0: 7a 73 74 65 70 73 5d 0a 6c 6f 6f 6b 69 74 74 6d zsteps].lookittm
3fc0: 70 20 20 20 6c 73 20 2f 74 6d 70 0a 0a 5b 6c 6f p ls /tmp..[lo
3fd0: 67 70 72 6f 5d 0a 6c 6f 6f 6b 69 74 74 6d 70 20 gpro].lookittmp
3fe0: 3b 3b 20 4e 6f 74 65 3a 20 63 6f 6e 66 69 67 20 ;; Note: config
3ff0: 66 69 6c 65 20 66 6f 72 6d 61 74 20 73 75 70 70 file format supp
4000: 6f 72 74 73 20 6d 75 6c 74 69 2d 6c 69 6e 65 20 orts multi-line
4010: 65 6e 74 72 69 65 73 20 77 68 65 72 65 20 6c 65 entries where le
4020: 61 64 69 6e 67 20 77 68 69 74 65 73 70 61 63 65 ading whitespace
4030: 20 69 73 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d is removed from
4040: 20 65 61 63 68 20 6c 69 6e 65 0a 20 20 3b 3b 20 each line. ;;
4050: 20 20 20 20 61 20 62 6c 61 6e 6b 20 6c 69 6e 65 a blank line
4060: 20 69 6e 64 69 63 61 74 65 73 20 74 68 65 20 65 indicates the e
4070: 6e 64 20 6f 66 20 74 68 65 20 62 6c 6f 63 6b 20 nd of the block
4080: 6f 66 20 74 65 78 74 20 0a 20 20 28 65 78 70 65 of text . (expe
4090: 63 74 3a 72 65 71 75 69 72 65 64 20 69 6e 20 22 ct:required in "
40a0: 4c 6f 67 46 69 6c 65 42 6f 64 79 22 20 3e 20 30 LogFileBody" > 0
40b0: 20 22 41 20 66 69 6c 65 20 6e 61 6d 65 20 74 68 "A file name th
40c0: 61 74 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 at should never
40d0: 65 78 69 73 74 21 22 20 23 2f 54 68 69 73 20 69 exist!" #/This i
40e0: 73 20 61 20 61 77 66 75 6c 6c 79 20 73 74 75 70 s a awfully stup
40f0: 69 64 20 66 69 6c 65 20 6e 61 6d 65 20 74 68 61 id file name tha
4100: 74 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 62 t should never b
4110: 65 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 74 e found in the t
4120: 65 6d 70 20 64 69 72 2f 29 0a 0a 2d 2d 2d 2d 2d emp dir/)..-----
4130: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 6f ------------..To
4140: 20 74 72 61 6e 73 66 65 72 20 74 68 65 20 65 6e transfer the en
4150: 76 69 72 6f 6e 6d 65 6e 74 20 74 6f 20 74 68 65 vironment to the
4160: 20 6e 65 78 74 20 73 74 65 70 20 79 6f 75 20 63 next step you c
4170: 61 6e 20 64 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 an do the follow
4180: 69 6e 67 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ing:..----------
4190: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
41a0: 2d 2d 0a 24 4d 54 5f 4d 45 47 41 54 45 53 54 20 --.$MT_MEGATEST
41b0: 2d 65 6e 76 32 66 69 6c 65 20 2e 65 7a 73 74 65 -env2file .ezste
41c0: 70 73 2f 24 7b 73 74 65 70 6e 61 6d 65 7d 09 20 ps/${stepname}.
41d0: 20 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .--------------
41e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
41f0: 54 72 69 67 67 65 72 73 0a 7e 7e 7e 7e 7e 7e 7e Triggers.~~~~~~~
4200: 7e 0a 0a 49 6e 20 79 6f 75 72 20 74 65 73 74 63 ~..In your testc
4210: 6f 6e 66 69 67 20 6f 72 20 6d 65 67 61 74 65 73 onfig or megates
4220: 74 2e 63 6f 6e 66 69 67 20 74 72 69 67 67 65 72 t.config trigger
4230: 73 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69 s can be specifi
4240: 65 64 20 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ed ..-----------
4250: 2d 2d 2d 2d 2d 2d 0a 5b 74 72 69 67 67 65 72 73 ------.[triggers
4260: 5d 0a 0a 23 20 43 61 6c 6c 20 73 63 72 69 70 74 ]..# Call script
4270: 20 72 75 6e 6e 69 6e 67 2e 73 68 20 77 68 65 6e running.sh when
4280: 20 74 65 73 74 20 67 6f 65 73 20 74 6f 20 73 74 test goes to st
4290: 61 74 65 3d 52 55 4e 4e 49 4e 47 2c 20 73 74 61 ate=RUNNING, sta
42a0: 74 75 73 3d 50 41 53 53 0a 52 55 4e 4e 49 4e 47 tus=PASS.RUNNING
42b0: 2f 50 41 53 53 20 72 75 6e 6e 69 6e 67 2e 73 68 /PASS running.sh
42c0: 0a 0a 23 20 43 61 6c 6c 20 73 63 72 69 70 74 20 ..# Call script
42d0: 72 75 6e 6e 69 6e 67 2e 73 68 20 61 6e 79 20 74 running.sh any t
42e0: 69 6d 65 20 73 74 61 74 65 20 67 6f 65 73 20 74 ime state goes t
42f0: 6f 20 52 55 4e 4e 49 4e 47 0a 52 55 4e 4e 49 4e o RUNNING.RUNNIN
4300: 47 2f 20 72 75 6e 6e 69 6e 67 2e 73 68 0a 0a 23 G/ running.sh..#
4310: 20 43 61 6c 6c 20 73 63 72 69 70 74 20 6f 6e 70 Call script onp
4320: 61 73 73 2e 73 68 20 61 6e 79 20 74 69 6d 65 20 ass.sh any time
4330: 73 74 61 74 75 73 20 67 6f 65 73 20 74 6f 20 50 status goes to P
4340: 41 53 53 0a 50 41 53 53 2f 20 6f 6e 70 61 73 73 ASS.PASS/ onpass
4350: 2e 73 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .sh.------------
4360: 2d 2d 2d 2d 2d 0a 0a 53 63 72 69 70 74 73 20 63 -----..Scripts c
4370: 61 6c 6c 65 64 20 77 69 6c 6c 20 68 61 76 65 3b alled will have;
4380: 20 74 65 73 74 2d 69 64 20 74 65 73 74 2d 72 75 test-id test-ru
4390: 6e 64 69 72 20 74 72 69 67 67 65 72 20 74 65 73 ndir trigger tes
43a0: 74 2d 6e 61 6d 65 20 69 74 65 6d 2d 70 61 74 68 t-name item-path
43b0: 20 73 74 61 74 65 20 73 74 61 74 75 73 20 65 76 state status ev
43c0: 65 6e 74 2d 74 69 6d 65 2c 20 61 64 64 65 64 20 ent-time, added
43d0: 74 6f 20 74 68 65 20 63 6f 6d 6d 61 6e 64 6c 69 to the commandli
43e0: 6e 65 2e 0a 0a 48 49 4e 54 0a 0a 54 6f 20 73 74 ne...HINT..To st
43f0: 61 72 74 20 61 6e 20 78 74 65 72 6d 20 28 75 73 art an xterm (us
4400: 65 66 75 6c 20 66 6f 72 20 64 65 62 75 67 67 69 eful for debuggi
4410: 6e 67 29 2c 20 75 73 65 20 61 20 63 6f 6d 6d 61 ng), use a comma
4420: 6e 64 20 6c 69 6e 65 20 6c 69 6b 65 20 74 68 65 nd line like the
4430: 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 0a 2d 2d 2d following:..---
4440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
4450: 74 72 69 67 67 65 72 73 5d 0a 43 4f 4d 50 4c 45 triggers].COMPLE
4460: 54 45 44 2f 20 78 74 65 72 6d 20 2d 65 20 62 61 TED/ xterm -e ba
4470: 73 68 20 2d 73 20 2d 2d 20 0a 2d 2d 2d 2d 2d 2d sh -s -- .------
4480: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e 4f 54 -----------..NOT
4490: 45 3a 20 54 68 65 72 65 20 69 73 20 61 20 74 72 E: There is a tr
44a0: 61 69 6c 69 6e 67 20 73 70 61 63 65 20 61 66 74 ailing space aft
44b0: 65 72 20 74 68 65 20 2d 2d 0a 0a 54 68 65 72 65 er the --..There
44c0: 20 61 72 65 20 61 20 6e 75 6d 62 65 72 20 6f 66 are a number of
44d0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 environment var
44e0: 69 61 62 6c 65 73 20 61 76 61 69 6c 61 62 6c 65 iables available
44f0: 20 74 6f 20 74 68 65 20 74 72 69 67 67 65 72 20 to the trigger
4500: 73 63 72 69 70 74 0a 62 75 74 20 73 69 6e 63 65 script.but since
4510: 20 74 72 69 67 67 65 72 73 20 63 61 6e 20 62 65 triggers can be
4520: 20 63 61 6c 6c 65 64 20 69 6e 20 76 61 72 69 6f called in vario
4530: 75 73 20 63 6f 6e 74 65 78 74 73 20 6e 6f 74 20 us contexts not
4540: 61 6c 6c 20 76 61 72 69 61 62 6c 65 73 20 61 72 all variables ar
4550: 65 0a 61 76 61 69 6c 61 62 6c 65 20 61 74 20 61 e.available at a
4560: 6c 6c 20 74 69 6d 65 73 2e 20 54 68 65 20 74 72 ll times. The tr
4570: 69 67 67 65 72 20 73 63 72 69 70 74 20 73 68 6f igger script sho
4580: 75 6c 64 20 63 68 65 63 6b 20 66 6f 72 20 74 68 uld check for th
4590: 65 20 76 61 72 69 61 62 6c 65 20 61 6e 64 0a 66 e variable and.f
45a0: 61 69 6c 20 67 72 61 63 65 66 75 6c 6c 79 20 69 ail gracefully i
45b0: 66 20 69 74 20 64 6f 65 73 6e 27 74 20 65 78 69 f it doesn't exi
45c0: 73 74 2e 0a 0a 2e 45 6e 76 69 72 6f 6e 6d 65 6e st....Environmen
45d0: 74 20 76 61 72 69 61 62 6c 65 73 20 76 69 73 69 t variables visi
45e0: 62 6c 65 20 74 6f 20 74 68 65 20 74 72 69 67 67 ble to the trigg
45f0: 65 72 20 73 63 72 69 70 74 0a 5b 77 69 64 74 68 er script.[width
4600: 3d 22 39 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 ="90%",cols="^,2
4610: 6d 22 2c 66 72 61 6d 65 3d 22 74 6f 70 62 6f 74 m",frame="topbot
4620: 22 2c 6f 70 74 69 6f 6e 73 3d 22 68 65 61 64 65 ",options="heade
4630: 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d r"].|===========
4640: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 56 61 72 ===========.|Var
4650: 69 61 62 6c 65 20 20 20 20 20 20 20 20 20 20 20 iable
4660: 20 20 7c 20 50 75 72 70 6f 73 65 20 20 20 20 20 | Purpose
4670: 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f 54 45 53 .| MT_TES
4680: 54 5f 52 55 4e 5f 44 49 52 20 20 20 20 20 7c 20 T_RUN_DIR |
4690: 54 68 65 20 64 69 72 65 63 74 6f 72 79 20 77 68 The directory wh
46a0: 65 72 65 20 4d 65 67 61 74 65 73 74 20 72 61 6e ere Megatest ran
46b0: 20 74 68 69 73 20 74 65 73 74 20 20 20 20 20 20 this test
46c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 0a 7c 20 .|
46d0: 4d 54 5f 43 4d 44 49 4e 46 4f 20 20 20 20 20 20 MT_CMDINFO
46e0: 20 20 20 20 7c 20 45 6e 63 6f 64 65 64 20 63 6f | Encoded co
46f0: 6d 6d 61 6e 64 20 64 61 74 61 20 66 6f 72 20 74 mmand data for t
4700: 68 65 20 74 65 73 74 20 20 20 20 20 20 20 20 20 he test
4710: 20 20 20 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f .| MT_
4720: 44 45 42 55 47 5f 4d 4f 44 45 20 20 20 20 20 20 DEBUG_MODE
4730: 20 7c 20 55 73 65 64 20 74 6f 20 70 61 73 73 20 | Used to pass
4740: 74 68 65 20 64 65 62 75 67 20 6d 6f 64 65 20 74 the debug mode t
4750: 6f 20 6e 65 73 74 65 64 20 63 61 6c 6c 73 20 74 o nested calls t
4760: 6f 20 4d 65 67 61 74 65 73 74 20 20 20 20 20 20 o Megatest
4770: 20 20 20 20 20 20 20 20 20 20 20 20 20 0a 7c 20 .|
4780: 4d 54 5f 52 55 4e 5f 41 52 45 41 5f 48 4f 4d 45 MT_RUN_AREA_HOME
4790: 20 20 20 20 7c 20 4d 65 67 61 74 65 73 74 20 68 | Megatest h
47a0: 6f 6d 65 20 61 72 65 61 20 0a 7c 20 4d 54 5f 54 ome area .| MT_T
47b0: 45 53 54 53 55 49 54 45 4e 41 4d 45 20 20 20 20 ESTSUITENAME
47c0: 7c 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 | The name of th
47d0: 69 73 20 74 65 73 74 73 75 69 74 65 20 6f 72 20 is testsuite or
47e0: 61 72 65 61 20 20 20 20 20 20 20 20 20 20 20 20 area
47f0: 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f 54 45 53 .| MT_TES
4800: 54 5f 4e 41 4d 45 20 20 20 20 20 20 20 20 7c 20 T_NAME |
4810: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 69 73 The name of this
4820: 20 74 65 73 74 0a 7c 20 4d 54 5f 49 54 45 4d 5f test.| MT_ITEM_
4830: 49 4e 46 4f 20 20 20 20 20 20 20 20 7c 20 54 68 INFO | Th
4840: 65 20 76 61 72 69 61 62 6c 65 20 61 6e 64 20 76 e variable and v
4850: 61 6c 75 65 73 20 66 6f 72 20 74 68 65 20 74 65 alues for the te
4860: 73 74 20 69 74 65 6d 0a 7c 20 4d 54 5f 4d 45 47 st item.| MT_MEG
4870: 41 54 45 53 54 20 20 20 20 20 20 20 20 20 7c 20 ATEST |
4880: 57 68 69 63 68 20 4d 65 67 61 74 65 73 74 20 62 Which Megatest b
4890: 69 6e 61 72 79 20 69 73 20 62 65 69 6e 67 20 75 inary is being u
48a0: 73 65 64 20 62 79 20 74 68 69 73 20 61 72 65 61 sed by this area
48b0: 0a 7c 20 4d 54 5f 54 41 52 47 45 54 20 20 20 20 .| MT_TARGET
48c0: 20 20 20 20 20 20 20 7c 20 54 68 65 20 74 61 72 | The tar
48d0: 67 65 74 20 76 61 72 69 61 62 6c 65 20 76 61 6c get variable val
48e0: 75 65 73 2c 20 73 65 70 61 72 61 74 65 64 20 62 ues, separated b
48f0: 79 20 27 2f 27 0a 7c 20 4d 54 5f 4c 49 4e 4b 54 y '/'.| MT_LINKT
4900: 52 45 45 20 20 20 20 20 20 20 20 20 7c 20 54 68 REE | Th
4910: 65 20 62 61 73 65 20 6f 66 20 74 68 65 20 6c 69 e base of the li
4920: 6e 6b 20 74 72 65 65 20 77 68 65 72 65 20 61 6c nk tree where al
4930: 6c 20 72 75 6e 20 74 65 73 74 73 20 63 61 6e 20 l run tests can
4940: 62 65 20 66 6f 75 6e 64 0a 7c 20 4d 54 5f 49 54 be found.| MT_IT
4950: 45 4d 50 41 54 48 20 20 20 20 20 20 20 20 20 7c EMPATH |
4960: 20 54 68 65 20 76 61 6c 75 65 73 20 6f 66 20 74 The values of t
4970: 68 65 20 69 74 65 6d 20 70 61 74 68 20 76 61 72 he item path var
4980: 69 61 62 6c 65 73 2c 20 73 65 70 61 72 61 74 65 iables, separate
4990: 64 20 62 79 20 27 2f 27 0a 7c 20 4d 54 5f 52 55 d by '/'.| MT_RU
49a0: 4e 4e 41 4d 45 20 20 20 20 20 20 20 20 20 20 7c NNAME |
49b0: 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 The name of the
49c0: 20 72 75 6e 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d run.|==========
49d0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 0a 4f ============...O
49e0: 76 65 72 72 69 64 65 20 74 68 65 20 54 6f 70 6c verride the Topl
49f0: 65 76 65 6c 20 48 54 4d 4c 20 46 69 6c 65 0a 7e evel HTML File.~
4a00: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
4a10: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a ~~~~~~~~~~~~~~..
4a20: 4d 65 67 61 74 65 73 74 20 67 65 6e 65 72 61 74 Megatest generat
4a30: 65 73 20 61 20 73 69 6d 70 6c 65 20 68 74 6d 6c es a simple html
4a40: 20 66 69 6c 65 20 73 75 6d 6d 61 72 79 20 66 6f file summary fo
4a50: 72 20 74 6f 70 20 6c 65 76 65 6c 20 74 65 73 74 r top level test
4a60: 73 20 6f 66 0a 69 74 65 72 61 74 65 64 20 74 65 s of.iterated te
4a70: 73 74 73 2e 20 54 68 65 20 67 65 6e 65 72 61 74 sts. The generat
4a80: 69 6f 6e 20 63 61 6e 20 62 65 20 6f 76 65 72 72 ion can be overr
4a90: 69 64 64 65 6e 2e 20 4e 4f 54 45 3a 20 74 68 65 idden. NOTE: the
4aa0: 20 6f 75 74 70 75 74 20 6f 66 0a 74 68 65 20 73 output of.the s
4ab0: 63 72 69 70 74 20 69 73 20 63 61 70 74 75 72 65 cript is capture
4ac0: 64 20 66 72 6f 6d 20 73 74 64 6f 75 74 20 74 6f d from stdout to
4ad0: 20 63 72 65 61 74 65 20 74 68 65 20 68 74 6d 6c create the html
4ae0: 2e 0a 0a 0a 2e 46 6f 72 20 74 65 73 74 20 22 72 .....For test "r
4af0: 75 6e 66 69 72 73 74 22 20 6f 76 65 72 72 69 64 unfirst" overrid
4b00: 65 20 74 68 65 20 74 6f 70 6c 65 76 65 6c 20 67 e the toplevel g
4b10: 65 6e 65 72 61 74 69 6f 6e 20 77 69 74 68 20 61 eneration with a
4b20: 20 73 63 72 69 70 74 20 22 6d 79 73 75 6d 6d 61 script "mysumma
4b30: 72 79 2e 73 68 22 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ry.sh".---------
4b40: 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 4f 76 65 72 72 --------.# Overr
4b50: 69 64 65 20 74 68 65 20 72 6f 6c 6c 75 70 20 66 ide the rollup f
4b60: 6f 72 20 73 70 65 63 69 66 69 63 20 74 65 73 74 or specific test
4b70: 73 0a 5b 74 65 73 74 72 6f 6c 6c 75 70 5d 0a 72 s.[testrollup].r
4b80: 75 6e 66 69 72 73 74 20 6d 79 73 75 6d 6d 61 72 unfirst mysummar
4b90: 79 2e 73 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d y.sh.-----------
4ba0: 2d 2d 2d 2d 2d 2d 0a 0a 41 72 63 68 69 76 69 6e ------..Archivin
4bb0: 67 20 53 65 74 75 70 0a 2d 2d 2d 2d 2d 2d 2d 2d g Setup.--------
4bc0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 6e 20 6d 65 67 61 -------..In mega
4bd0: 74 65 73 74 2e 63 6f 6e 66 69 67 20 61 64 64 20 test.config add
4be0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 the following se
4bf0: 63 74 69 6f 6e 73 3a 0a 0a 2e 6d 65 67 61 74 65 ctions:...megate
4c00: 73 74 2e 63 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d st.config.------
4c10: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 61 72 63 68 69 76 --------.[archiv
4c20: 65 5d 0a 23 20 77 68 65 72 65 20 74 6f 20 67 65 e].# where to ge
4c30: 74 20 62 75 70 20 65 78 65 63 75 74 61 62 6c 65 t bup executable
4c40: 0a 23 20 62 75 70 20 2f 70 61 74 68 2f 74 6f 2f .# bup /path/to/
4c50: 62 75 70 0a 0a 5b 61 72 63 68 69 76 65 2d 64 69 bup..[archive-di
4c60: 73 6b 73 5d 0a 0a 23 20 41 72 63 68 69 76 65 73 sks]..# Archives
4c70: 20 77 69 6c 6c 20 62 65 20 6f 72 67 61 6e 69 73 will be organis
4c80: 65 64 20 75 6e 64 65 72 20 74 68 65 73 65 20 70 ed under these p
4c90: 61 74 68 73 20 6c 69 6b 65 20 74 68 69 73 3a 0a aths like this:.
4ca0: 23 20 20 3c 74 65 73 74 73 75 69 74 65 3e 2f 3c # <testsuite>/<
4cb0: 63 72 65 61 74 69 6f 6e 64 61 74 65 3e 0a 23 20 creationdate>.#
4cc0: 57 69 74 68 69 6e 20 74 68 65 20 61 72 63 68 69 Within the archi
4cd0: 76 65 20 74 68 65 20 64 61 74 61 20 69 73 20 73 ve the data is s
4ce0: 74 72 75 63 74 75 72 65 64 20 6c 69 6b 65 20 74 tructured like t
4cf0: 68 69 73 3a 0a 23 20 20 3c 74 61 72 67 65 74 3e his:.# <target>
4d00: 2f 3c 72 75 6e 6e 61 6d 65 3e 2f 3c 74 65 73 74 /<runname>/<test
4d10: 3e 2f 0a 61 72 63 68 69 76 65 30 20 2f 6d 66 73 >/.archive0 /mfs
4d20: 2f 6d 79 61 72 63 68 69 76 65 2d 64 61 74 61 2f /myarchive-data/
4d30: 61 64 69 73 6b 31 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d adisk1.---------
4d40: 2d 2d 2d 2d 2d 0a 0a 48 61 6e 64 6c 69 6e 67 20 -----..Handling
4d50: 45 6e 76 69 72 6f 6e 6d 65 6e 74 20 56 61 72 69 Environment Vari
4d60: 61 62 6c 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ables.----------
4d70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4d80: 2d 2d 2d 2d 0a 0a 49 74 20 69 73 20 6f 66 74 65 ----..It is ofte
4d90: 6e 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 63 n necessary to c
4da0: 61 70 74 75 72 65 20 61 6e 64 20 6f 72 20 6d 61 apture and or ma
4db0: 6e 69 70 75 6c 61 74 65 20 65 6e 76 69 72 6f 6e nipulate environ
4dc0: 6d 65 6e 74 0a 76 61 72 69 61 62 6c 65 73 2e 20 ment.variables.
4dd0: 4d 65 67 61 74 65 73 74 20 68 61 73 20 73 6f 6d Megatest has som
4de0: 65 20 66 61 63 69 6c 69 74 69 65 73 20 62 75 69 e facilities bui
4df0: 6c 74 20 69 6e 20 74 6f 20 68 65 6c 70 2e 0a 0a lt in to help...
4e00: 43 61 70 74 75 72 65 20 76 61 72 69 61 62 6c 65 Capture variable
4e10: 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e s.~~~~~~~~~~~~~~
4e20: 7e 7e 7e 0a 0a 2e 43 6f 6d 6d 61 6e 64 73 0a 2d ~~~...Commands.-
4e30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4e40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 -------------.#
4e50: 63 61 70 74 75 72 65 20 74 68 65 20 63 75 72 72 capture the curr
4e60: 65 6e 74 20 65 6e 76 69 72 6f 6d 65 6e 74 20 69 ent enviroment i
4e70: 6e 74 6f 20 61 20 64 62 20 63 61 6c 6c 65 64 20 nto a db called
4e80: 65 6e 76 64 61 74 2e 64 62 20 75 6e 64 65 72 0a envdat.db under.
4e90: 23 20 74 68 65 20 63 6f 6e 74 65 78 74 20 22 62 # the context "b
4ea0: 65 66 6f 72 65 22 0a 6d 65 67 61 74 65 73 74 20 efore".megatest
4eb0: 2d 65 6e 76 63 61 70 20 62 65 66 6f 72 65 0a 0a -envcap before..
4ec0: 23 20 63 61 70 74 75 72 65 20 74 68 65 20 63 75 # capture the cu
4ed0: 72 72 65 6e 74 20 65 6e 76 69 72 6f 6e 6d 65 6e rrent environmen
4ee0: 74 20 69 6e 74 6f 20 61 20 64 62 20 63 61 6c 6c t into a db call
4ef0: 65 64 20 73 74 61 72 74 75 70 2e 64 62 20 77 69 ed startup.db wi
4f00: 74 68 20 0a 23 20 63 6f 6e 74 65 78 74 20 22 61 th .# context "a
4f10: 66 74 65 72 22 0a 6d 65 67 61 74 65 73 74 20 2d fter".megatest -
4f20: 65 6e 76 63 61 70 20 61 66 74 65 72 20 73 74 61 envcap after sta
4f30: 72 74 75 70 2e 64 62 0a 0a 23 20 77 72 69 74 65 rtup.db..# write
4f40: 20 74 68 65 20 64 69 66 66 20 66 72 6f 6d 20 62 the diff from b
4f50: 65 66 6f 72 65 20 74 6f 20 61 66 74 65 72 0a 6d efore to after.m
4f60: 65 67 61 74 65 73 74 20 2d 65 6e 76 64 65 6c 74 egatest -envdelt
4f70: 61 20 62 65 66 6f 72 65 2d 61 66 74 65 72 20 2d a before-after -
4f80: 64 75 6d 70 6d 6f 64 65 20 62 61 73 68 0a 2d 2d dumpmode bash.--
4f90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4fa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 75 ------------..Du
4fb0: 6d 70 20 6d 6f 64 65 73 20 69 6e 63 6c 75 64 65 mp modes include
4fc0: 20 62 61 73 68 2c 20 63 73 68 20 61 6e 64 20 63 bash, csh and c
4fd0: 6f 6e 66 69 67 2e 20 59 6f 75 20 63 61 6e 20 69 onfig. You can i
4fe0: 6e 63 6c 75 64 65 20 63 6f 6e 66 69 67 20 64 61 nclude config da
4ff0: 74 61 0a 69 6e 74 6f 20 6d 65 67 61 74 65 73 74 ta.into megatest
5000: 2e 63 6f 6e 66 69 67 20 6f 72 20 72 75 6e 63 6f .config or runco
5010: 6e 66 69 67 73 2e 63 6f 6e 66 69 67 2e 0a 0a 2e nfigs.config....
5020: 45 78 61 6d 70 6c 65 20 6f 66 20 67 65 6e 65 72 Example of gener
5030: 61 74 69 6e 67 20 61 6e 64 20 75 73 69 6e 67 20 ating and using
5040: 63 6f 6e 66 69 67 20 64 61 74 61 0a 2d 2d 2d 2d config data.----
5050: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5060: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 6d 65 67 61 74 ----------.megat
5070: 65 73 74 20 2d 65 6e 76 63 61 70 20 6f 72 69 67 est -envcap orig
5080: 69 6e 61 6c 0a 23 20 64 6f 20 73 6f 6d 65 20 73 inal.# do some s
5090: 74 75 66 66 20 68 65 72 65 0a 6d 65 67 61 74 65 tuff here.megate
50a0: 73 74 20 2d 65 6e 76 63 61 70 20 6d 75 6e 67 65 st -envcap munge
50b0: 64 0a 6d 65 67 61 74 65 73 74 20 2d 65 6e 76 64 d.megatest -envd
50c0: 65 6c 74 61 20 6f 72 69 67 69 6e 61 6c 2d 6d 75 elta original-mu
50d0: 6e 67 65 64 20 2d 64 75 6d 70 6d 6f 64 65 20 69 nged -dumpmode i
50e0: 6e 69 20 2d 6f 20 6d 6f 64 69 66 69 65 64 2e 63 ni -o modified.c
50f0: 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d onfig.----------
5100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5110: 2d 2d 2d 2d 0a 0a 54 68 65 6e 20 69 6e 20 72 75 ----..Then in ru
5120: 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 69 67 0a nconfigs.config.
5130: 0a 2e 45 78 61 6d 70 6c 65 20 6f 66 20 75 73 69 ..Example of usi
5140: 6e 67 20 6d 6f 64 69 66 69 65 64 2e 63 6f 6e 66 ng modified.conf
5150: 69 67 20 69 6e 20 61 20 74 65 73 74 63 6f 6e 66 ig in a testconf
5160: 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ig.-------------
5170: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5180: 2d 0a 63 61 74 20 74 65 73 74 63 6f 6e 66 69 67 -.cat testconfig
5190: 0a 5b 70 72 65 2d 6c 61 75 6e 63 68 2d 65 6e 76 .[pre-launch-env
51a0: 2d 76 61 72 73 5d 0a 5b 69 6e 63 6c 75 64 65 20 -vars].[include
51b0: 6d 6f 64 69 66 69 65 64 2e 63 6f 6e 66 69 67 5d modified.config]
51c0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
51d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
51e0: 0a 4d 61 6e 61 67 69 6e 67 20 4f 6c 64 20 52 75 .Managing Old Ru
51f0: 6e 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ns.-------------
5200: 2d 2d 2d 2d 0a 0a 49 74 20 69 73 20 6f 66 74 65 ----..It is ofte
5210: 6e 20 64 65 73 69 72 65 64 20 74 6f 20 6b 65 65 n desired to kee
5220: 70 20 73 6f 6d 65 20 6f 6c 64 65 72 20 72 75 6e p some older run
5230: 73 20 61 72 6f 75 6e 64 20 62 75 74 20 74 68 69 s around but thi
5240: 73 20 6d 75 73 74 20 62 65 20 62 61 6c 61 6e 63 s must be balanc
5250: 65 64 20 77 69 74 68 20 74 68 65 20 63 6f 73 74 ed with the cost
5260: 73 20 6f 66 20 64 69 73 6b 20 73 70 61 63 65 2e s of disk space.
5270: 0a 0a 2e 20 55 73 65 20 2d 72 65 6d 6f 76 65 2d ... Use -remove-
5280: 6b 65 65 70 0a 2e 20 55 73 65 20 2d 61 72 63 68 keep.. Use -arch
5290: 69 76 65 20 28 63 61 6e 20 61 6c 73 6f 20 62 65 ive (can also be
52a0: 20 64 6f 6e 65 20 66 72 6f 6d 20 74 68 65 20 2d done from the -
52b0: 72 65 6d 6f 76 65 2d 6b 65 65 70 20 69 6e 74 65 remove-keep inte
52c0: 72 66 61 63 65 29 0a 2e 20 75 73 65 20 2d 72 65 rface).. use -re
52d0: 6d 6f 76 65 2d 72 75 6e 73 20 77 69 74 68 20 2d move-runs with -
52e0: 6b 65 65 70 2d 72 65 63 6f 72 64 73 0a 0a 2e 46 keep-records...F
52f0: 6f 72 20 65 61 63 68 20 74 61 72 67 65 74 2c 20 or each target,
5300: 72 65 6d 6f 76 65 20 61 6c 6c 20 72 75 6e 73 20 remove all runs
5310: 62 75 74 20 74 68 65 20 6d 6f 73 74 20 72 65 63 but the most rec
5320: 65 6e 74 20 33 20 69 66 20 74 68 65 79 20 61 72 ent 3 if they ar
5330: 65 20 6f 76 65 72 20 31 20 77 65 65 6b 20 6f 6c e over 1 week ol
5340: 64 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d d.--------------
5350: 2d 2d 2d 2d 2d 2d 2d 0a 23 20 75 73 65 20 2d 70 -------.# use -p
5360: 72 65 63 6d 64 20 27 73 6c 65 65 70 20 35 3b 6e recmd 'sleep 5;n
5370: 62 66 61 6b 65 27 20 74 6f 20 6c 69 6d 69 74 20 bfake' to limit
5380: 6f 76 65 72 6c 6f 61 64 69 6e 67 20 74 68 65 20 overloading the
5390: 68 6f 73 74 20 63 6f 6d 70 75 74 65 72 20 62 75 host computer bu
53a0: 74 20 74 6f 20 61 6c 6c 6f 77 20 74 68 65 20 72 t to allow the r
53b0: 65 6d 6f 76 65 73 20 74 6f 20 72 75 6e 20 69 6e emoves to run in
53c0: 20 70 61 72 61 6c 6c 65 6c 2e 0a 6d 65 67 61 74 parallel..megat
53d0: 65 73 74 20 2d 61 63 74 69 6f 6e 73 20 70 72 69 est -actions pri
53e0: 6e 74 2c 72 65 6d 6f 76 65 2d 72 75 6e 73 20 2d nt,remove-runs -
53f0: 72 65 6d 6f 76 65 2d 6b 65 65 70 20 33 20 2d 74 remove-keep 3 -t
5400: 61 72 67 65 74 20 25 2f 25 2f 25 2f 25 20 2d 72 arget %/%/%/% -r
5410: 75 6e 6e 61 6d 65 20 25 20 2d 61 67 65 20 31 77 unname % -age 1w
5420: 20 2d 70 72 65 63 6d 64 20 27 73 6c 65 65 70 20 -precmd 'sleep
5430: 35 3b 6e 62 66 61 6b 65 27 22 0a 2d 2d 2d 2d 2d 5;nbfake'".-----
5440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5450: 0a 0a 4e 65 73 74 65 64 20 52 75 6e 73 0a 2d 2d ..Nested Runs.--
5460: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 20 4d 65 67 ---------..A Meg
5470: 61 74 65 73 74 20 74 65 73 74 20 63 61 6e 20 72 atest test can r
5480: 75 6e 20 61 20 66 75 6c 6c 20 4d 65 67 61 74 65 un a full Megate
5490: 73 74 20 72 75 6e 20 69 6e 20 65 69 74 68 65 72 st run in either
54a0: 20 74 68 65 20 73 61 6d 65 0a 4d 65 67 61 74 65 the same.Megate
54b0: 73 74 20 61 72 65 61 20 6f 72 20 69 6e 20 61 6e st area or in an
54c0: 6f 74 68 65 72 20 61 72 65 61 2e 20 54 68 69 73 other area. This
54d0: 20 69 73 20 61 20 70 6f 77 65 72 66 75 6c 20 77 is a powerful w
54e0: 61 79 20 6f 66 20 63 68 61 69 6e 69 6e 67 0a 63 ay of chaining.c
54f0: 6f 6d 70 6c 65 78 20 73 75 69 74 65 73 20 6f 66 omplex suites of
5500: 20 74 65 73 74 73 20 61 6e 64 20 6f 72 20 61 63 tests and or ac
5510: 74 69 6f 6e 73 2e 0a 0a 49 66 20 79 6f 75 20 61 tions...If you a
5520: 72 65 20 6e 6f 74 20 75 73 69 6e 67 20 74 68 65 re not using the
5530: 20 63 75 72 72 65 6e 74 20 61 72 65 61 20 79 6f current area yo
5540: 75 20 63 61 6e 20 75 73 65 20 65 7a 73 74 65 70 u can use ezstep
5550: 73 20 74 6f 20 72 65 74 72 69 65 76 65 0a 61 6e s to retrieve.an
5560: 64 20 73 65 74 75 70 20 74 68 65 20 73 75 62 2d d setup the sub-
5570: 4d 65 67 61 74 65 73 74 20 72 75 6e 20 61 72 65 Megatest run are
5580: 61 2e 0a 0a 49 6e 20 74 68 65 20 74 65 73 74 63 a...In the testc
5590: 6f 6e 66 69 67 3a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d onfig:.---------
55a0: 2d 2d 2d 2d 2d 2d 0a 5b 73 75 62 72 75 6e 5d 0a ------.[subrun].
55b0: 0a 23 20 52 65 71 75 69 72 65 64 3a 20 77 61 69 .# Required: wai
55c0: 74 20 66 6f 72 20 74 68 65 20 72 75 6e 20 6f 72 t for the run or
55d0: 20 6a 75 73 74 20 6c 61 75 6e 63 68 20 69 74 0a just launch it.
55e0: 23 20 20 20 20 20 20 20 20 20 20 20 69 66 20 6e # if n
55f0: 6f 20 74 68 65 6e 20 74 68 65 20 72 75 6e 20 77 o then the run w
5600: 69 6c 6c 20 62 65 20 61 6e 20 61 75 74 6f 6d 61 ill be an automa
5610: 74 69 63 20 50 41 53 53 20 69 72 72 65 73 70 65 tic PASS irrespe
5620: 63 74 69 76 65 20 6f 66 20 74 68 65 20 61 63 74 ctive of the act
5630: 75 61 6c 20 72 65 73 75 6c 74 0a 72 75 6e 2d 77 ual result.run-w
5640: 61 69 74 20 79 65 73 7c 6e 6f 0a 0a 23 20 4f 70 ait yes|no..# Op
5650: 74 69 6f 6e 61 6c 3a 20 77 68 65 72 65 20 74 6f tional: where to
5660: 20 65 78 65 63 75 74 65 20 74 68 65 20 72 75 6e execute the run
5670: 2e 20 44 65 66 61 75 6c 74 20 69 73 20 74 68 65 . Default is the
5680: 20 63 75 72 72 65 6e 74 20 72 75 6e 61 72 65 61 current runarea
5690: 0a 72 75 6e 2d 61 72 65 61 20 2f 73 6f 6d 65 2f .run-area /some/
56a0: 70 61 74 68 2f 74 6f 2f 6d 65 67 61 74 65 73 74 path/to/megatest
56b0: 2f 61 72 65 61 0a 0a 23 20 4f 70 74 69 6f 6e 61 /area..# Optiona
56c0: 6c 3a 20 6d 65 74 68 6f 64 20 74 6f 20 75 73 65 l: method to use
56d0: 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 70 61 to determine pa
56e0: 73 73 2f 66 61 69 6c 20 73 74 61 74 75 73 20 6f ss/fail status o
56f0: 66 20 74 68 65 20 72 75 6e 0a 23 20 20 20 61 75 f the run.# au
5700: 74 6f 20 28 64 65 66 61 75 6c 74 29 20 2d 20 72 to (default) - r
5710: 6f 6c 6c 20 75 70 20 74 68 65 20 6e 65 74 20 73 oll up the net s
5720: 74 61 74 65 2f 73 74 61 74 75 73 20 6f 66 20 74 tate/status of t
5730: 68 65 20 73 75 62 2d 72 75 6e 0a 23 20 20 20 6c he sub-run.# l
5740: 6f 67 70 72 6f 20 20 20 20 20 20 20 20 20 2d 20 ogpro -
5750: 75 73 65 20 74 68 65 20 70 72 6f 76 69 64 65 64 use the provided
5760: 20 6c 6f 67 70 72 6f 20 72 75 6c 65 73 2c 20 68 logpro rules, h
5770: 61 70 70 65 6e 73 20 61 75 74 6f 6d 61 74 69 63 appens automatic
5780: 61 6c 6c 79 20 69 66 20 74 68 65 72 65 20 69 73 ally if there is
5790: 20 61 20 6c 6f 67 70 72 6f 20 73 65 63 74 69 6f a logpro sectio
57a0: 6e 0a 23 20 70 61 73 73 66 61 69 6c 20 61 75 74 n.# passfail aut
57b0: 6f 7c 6c 6f 67 70 72 6f 0a 23 20 45 78 61 6d 70 o|logpro.# Examp
57c0: 6c 65 20 6f 66 20 6c 6f 67 70 72 6f 3a 0a 70 61 le of logpro:.pa
57d0: 73 73 66 61 69 6c 20 6c 6f 67 70 72 6f 0a 0a 23 ssfail logpro..#
57e0: 20 4f 70 74 69 6f 6e 61 6c 3a 20 0a 6c 6f 67 70 Optional: .logp
57f0: 72 6f 20 3b 3b 20 69 66 20 74 68 69 73 20 73 65 ro ;; if this se
5800: 63 74 69 6f 6e 20 65 78 69 73 74 73 20 74 68 65 ction exists the
5810: 6e 20 6c 6f 67 70 72 6f 20 69 73 20 75 73 65 64 n logpro is used
5820: 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 70 61 to determine pa
5830: 73 73 2f 66 61 69 6c 0a 20 20 28 65 78 70 65 63 ss/fail. (expec
5840: 74 3a 72 65 71 75 69 72 65 64 20 69 6e 20 22 4c t:required in "L
5850: 6f 67 46 69 6c 65 42 6f 64 79 22 20 3e 3d 20 31 ogFileBody" >= 1
5860: 20 22 41 74 20 6c 65 61 73 74 20 6f 6e 65 20 70 "At least one p
5870: 61 73 73 22 20 23 2f 50 41 53 53 2f 29 0a 20 20 ass" #/PASS/).
5880: 28 65 78 70 65 63 74 3a 66 61 69 6c 20 20 20 20 (expect:fail
5890: 20 69 6e 20 22 4c 6f 67 46 69 6c 65 42 6f 64 79 in "LogFileBody
58a0: 22 20 20 3d 20 30 20 22 4e 6f 20 46 41 49 4c 73 " = 0 "No FAILs
58b0: 20 61 6c 6c 6f 77 65 64 22 20 20 23 2f 46 41 49 allowed" #/FAI
58c0: 4c 2f 29 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a L/)..# Optional:
58d0: 20 74 61 72 67 65 74 20 74 72 61 6e 73 6c 61 74 target translat
58e0: 6f 72 2c 20 64 65 66 61 75 6c 74 20 69 73 20 74 or, default is t
58f0: 6f 20 75 73 65 20 74 68 65 20 70 61 72 65 6e 74 o use the parent
5900: 20 74 61 72 67 65 74 0a 74 61 72 67 65 74 20 23 target.target #
5910: 7b 73 68 65 6c 6c 20 73 6f 6d 65 73 63 72 69 70 {shell somescrip
5920: 74 2e 73 68 7d 0a 0a 23 20 4f 70 74 69 6f 6e 61 t.sh}..# Optiona
5930: 6c 3a 20 72 75 6e 6e 61 6d 65 20 74 72 61 6e 73 l: runname trans
5940: 6c 61 74 6f 72 2f 67 65 6e 65 72 61 74 6f 72 2c lator/generator,
5950: 20 64 65 66 61 75 6c 74 20 69 73 20 74 6f 20 75 default is to u
5960: 73 65 20 74 68 65 20 70 61 72 65 6e 74 20 72 75 se the parent ru
5970: 6e 6e 61 6d 65 0a 72 75 6e 2d 6e 61 6d 65 20 23 nname.run-name #
5980: 7b 73 6f 6d 65 73 63 72 69 70 74 2e 73 68 7d 0a {somescript.sh}.
5990: 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 74 65 73 .# Optional: tes
59a0: 74 70 61 74 74 20 73 70 65 63 2c 20 64 65 66 61 tpatt spec, defa
59b0: 75 6c 74 20 69 73 20 74 6f 20 66 69 72 73 74 20 ult is to first
59c0: 6c 6f 6f 6b 20 66 6f 72 20 54 45 53 54 50 41 54 look for TESTPAT
59d0: 54 20 73 70 65 63 20 66 72 6f 6d 20 72 75 6e 63 T spec from runc
59e0: 6f 6e 66 69 67 73 20 75 6e 6c 65 73 73 20 74 68 onfigs unless th
59f0: 65 72 65 20 69 73 20 61 20 63 6f 6e 74 6f 75 72 ere is a contour
5a00: 20 73 70 65 63 0a 74 65 73 74 2d 70 61 74 74 20 spec.test-patt
5a10: 25 2f 69 74 65 6d 31 2c 74 65 73 74 32 0a 0a 23 %/item1,test2..#
5a20: 20 4f 70 74 69 6f 6e 61 6c 3a 20 63 6f 6e 74 6f Optional: conto
5a30: 75 72 20 73 70 65 63 2c 20 75 73 65 20 74 68 65 ur spec, use the
5a40: 20 6e 61 6d 65 64 20 63 6f 6e 74 6f 75 72 20 66 named contour f
5a50: 72 6f 6d 20 74 68 65 20 6d 65 67 61 74 65 73 74 rom the megatest
5a60: 2e 63 6f 6e 66 69 67 20 63 6f 6e 74 6f 75 72 20 .config contour
5a70: 73 70 65 63 0a 63 6f 6e 74 6f 75 72 20 63 6f 6e spec.contour con
5a80: 74 6f 75 72 6e 61 6d 65 20 23 23 23 20 4e 4f 54 tourname ### NOT
5a90: 45 3a 20 4e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 E: Not implement
5aa0: 65 64 20 79 65 74 21 20 4c 65 74 20 75 73 20 6b ed yet! Let us k
5ab0: 6e 6f 77 20 69 66 20 79 6f 75 20 6e 65 65 64 20 now if you need
5ac0: 74 68 69 73 20 66 65 61 74 75 72 65 2e 0a 0a 23 this feature...#
5ad0: 20 4f 70 74 69 6f 6e 61 6c 3a 20 6d 6f 64 65 2d Optional: mode-
5ae0: 70 61 74 74 2c 20 75 73 65 20 74 68 69 73 20 73 patt, use this s
5af0: 70 65 63 20 66 6f 72 20 74 65 73 74 70 61 74 74 pec for testpatt
5b00: 20 66 72 6f 6d 20 72 75 6e 63 6f 6e 66 69 67 73 from runconfigs
5b10: 0a 6d 6f 64 65 2d 70 61 74 74 20 54 45 53 54 50 .mode-patt TESTP
5b20: 41 54 54 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a ATT..# Optional:
5b30: 20 74 61 67 2d 65 78 70 72 2c 20 75 73 65 20 74 tag-expr, use t
5b40: 68 69 73 20 74 61 67 2d 65 78 70 72 20 74 6f 20 his tag-expr to
5b50: 73 65 6c 65 63 74 20 74 65 73 74 73 0a 74 61 67 select tests.tag
5b60: 2d 65 78 70 72 20 71 75 69 63 6b 0a 0a 23 20 4f -expr quick..# O
5b70: 70 74 69 6f 6e 61 6c 3a 20 28 6e 6f 74 20 79 65 ptional: (not ye
5b80: 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 2c 20 72 t implemented, r
5b90: 65 6d 6f 76 65 2d 72 75 6e 73 20 69 73 20 61 6c emove-runs is al
5ba0: 77 61 79 73 20 70 72 6f 70 61 67 61 74 65 64 20 ways propagated
5bb0: 61 74 20 74 68 69 73 20 74 69 6d 65 29 2c 20 70 at this time), p
5bc0: 72 6f 70 61 67 61 74 65 20 74 68 65 73 65 20 61 ropagate these a
5bd0: 63 74 69 6f 6e 73 20 66 72 6f 6d 20 74 68 65 20 ctions from the
5be0: 70 61 72 65 6e 74 0a 23 20 20 20 20 20 20 20 20 parent.#
5bf0: 20 20 20 74 65 73 74 0a 23 20 20 20 4e 6f 74 65 test.# Note
5c00: 2f 2f 20 64 65 66 61 75 6c 74 20 69 73 20 25 20 // default is %
5c10: 66 6f 72 20 61 6c 6c 0a 70 72 6f 70 61 67 61 74 for all.propagat
5c20: 65 20 72 65 6d 6f 76 65 2d 72 75 6e 73 20 61 72 e remove-runs ar
5c30: 63 68 69 76 65 20 2e 2e 2e 0a 0a 2d 2d 2d 2d 2d chive .....-----
5c40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 72 6f 67 ----------..Prog
5c50: 72 61 6d 6d 69 6e 67 20 41 50 49 0a 2d 2d 2d 2d ramming API.----
5c60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 -----------..The
5c70: 73 65 20 72 6f 75 74 69 6e 65 73 20 63 61 6e 20 se routines can
5c80: 62 65 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 be called from t
5c90: 68 65 20 6d 65 67 61 74 65 73 74 20 72 65 70 6c he megatest repl
5ca0: 2e 20 0a 0a 2e 41 50 49 20 4b 65 79 73 20 52 65 . ...API Keys Re
5cb0: 6c 61 74 65 64 20 43 61 6c 6c 73 0a 5b 77 69 64 lated Calls.[wid
5cc0: 74 68 3d 22 37 30 25 22 2c 63 6f 6c 73 3d 22 5e th="70%",cols="^
5cd0: 2c 32 6d 2c 32 6d 2c 32 6d 22 2c 66 72 61 6d 65 ,2m,2m,2m",frame
5ce0: 3d 22 74 6f 70 62 6f 74 22 2c 6f 70 74 69 6f 6e ="topbot",option
5cf0: 73 3d 22 68 65 61 64 65 72 2c 66 6f 6f 74 65 72 s="header,footer
5d00: 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d "].|============
5d10: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 41 50 49 20 ==========.|API
5d20: 43 61 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 Call
5d30: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 50 75 | Pu
5d40: 72 70 6f 73 65 20 63 6f 6d 6d 65 6e 74 73 20 20 rpose comments
5d50: 20 7c 20 52 65 74 75 72 6e 73 20 20 20 20 20 20 | Returns
5d60: 20 20 20 20 20 20 20 20 20 20 20 7c 20 43 6f 6d | Com
5d70: 6d 65 6e 74 73 0a 7c 28 72 6d 74 3a 67 65 74 2d ments.|(rmt:get-
5d80: 6b 65 79 73 20 72 75 6e 2d 69 64 29 20 20 20 20 keys run-id)
5d90: 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 20 20 |
5da0: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 28 20 | (
5db0: 6b 65 79 31 20 6b 65 79 32 20 2e 2e 2e 20 29 20 key1 key2 ... )
5dc0: 20 20 20 20 20 20 7c 20 0a 7c 20 28 72 6d 74 3a | .| (rmt:
5dd0: 67 65 74 2d 6b 65 79 2d 76 61 6c 2d 70 61 69 72 get-key-val-pair
5de0: 73 20 72 75 6e 2d 69 64 29 20 7c 20 20 20 20 20 s run-id) |
5df0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
5e00: 20 23 74 3d 73 75 63 63 65 73 73 2f 23 66 3d 66 #t=success/#f=f
5e10: 61 69 6c 20 20 20 20 20 20 7c 20 57 6f 72 6b 73 ail | Works
5e20: 20 6f 6e 6c 79 20 69 66 20 74 68 65 20 73 65 72 only if the ser
5e30: 76 65 72 20 69 73 20 73 74 69 6c 6c 20 72 65 61 ver is still rea
5e40: 63 68 61 62 6c 65 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d chable.|========
5e50: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a ==============..
5e60: 0a 3a 6e 75 6d 62 65 72 65 64 21 3a 0a .:numbered!:.