0000: 44 20 32 30 31 38 2d 30 31 2d 33 30 54 31 38 3a D 2018-01-30T18:
0010: 31 39 3a 32 31 2e 32 34 39 0a 4c 20 72 65 66 65 19:21.249.L refe
0020: 72 65 6e 63 65 0a 55 20 6d 72 77 65 6c 6c 61 6e rence.U mrwellan
0030: 0a 57 20 32 32 32 35 32 0a 0a 52 65 66 65 72 65 .W 22252..Refere
0040: 6e 63 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 nce.---------..C
0050: 6f 6e 66 69 67 20 46 69 6c 65 20 48 65 6c 70 65 onfig File Helpe
0060: 72 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e rs.~~~~~~~~~~~~~
0070: 7e 7e 7e 7e 7e 7e 0a 0a 56 61 72 69 6f 75 73 20 ~~~~~~..Various
0080: 68 65 6c 70 65 72 73 20 66 6f 72 20 6d 6f 72 65 helpers for more
0090: 20 61 64 76 61 6e 63 65 64 20 63 6f 6e 66 69 67 advanced config
00a0: 20 66 69 6c 65 73 2e 0a 0a 2e 48 65 6c 70 65 72 files....Helper
00b0: 73 0a 5b 77 69 64 74 68 3d 22 38 30 25 22 2c 63 s.[width="80%",c
00c0: 6f 6c 73 3d 22 5e 2c 32 6d 2c 32 6d 2c 32 6d 22 ols="^,2m,2m,2m"
00d0: 2c 66 72 61 6d 65 3d 22 74 6f 70 62 6f 74 22 2c ,frame="topbot",
00e0: 6f 70 74 69 6f 6e 73 3d 22 68 65 61 64 65 72 22 options="header"
00f0: 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ].|=============
0100: 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 48 65 6c 70 65 =========.|Helpe
0110: 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r
0120: 20 20 20 20 20 20 20 7c 20 50 75 72 70 6f 73 65 | Purpose
0130: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0140: 20 20 20 20 20 20 20 7c 20 56 61 6c 69 64 20 76 | Valid v
0150: 61 6c 75 65 73 20 20 20 20 20 20 20 20 20 20 20 alues
0160: 20 7c 20 43 6f 6d 6d 65 6e 74 73 0a 7c 20 23 7b | Comments.| #{
0170: 73 63 68 65 6d 65 20 28 73 63 68 65 6d 65 20 63 scheme (scheme c
0180: 6f 64 65 2e 2e 2e 29 7d 20 7c 20 45 78 65 63 75 ode...)} | Execu
0190: 74 65 20 61 72 62 69 74 72 61 72 79 20 73 63 68 te arbitrary sch
01a0: 65 6d 65 20 63 6f 64 65 20 7c 20 41 6e 79 20 76 eme code | Any v
01b0: 61 6c 69 64 20 73 63 68 65 6d 65 20 20 20 20 20 alid scheme
01c0: 20 20 20 7c 20 56 61 6c 75 65 20 72 65 74 75 72 | Value retur
01d0: 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 63 61 6c ned from the cal
01e0: 6c 20 69 73 20 63 6f 6e 76 65 72 74 65 64 20 74 l is converted t
01f0: 6f 20 61 20 73 74 72 69 6e 67 20 61 6e 64 20 70 o a string and p
0200: 72 6f 63 65 73 73 65 64 20 61 73 20 70 61 72 74 rocessed as part
0210: 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 20 66 of the config f
0220: 69 6c 65 0a 7c 20 23 7b 73 79 73 74 65 6d 20 63 ile.| #{system c
0230: 6f 6d 6d 61 6e 64 7d 20 20 20 20 20 20 20 20 20 ommand}
0240: 20 7c 20 45 78 65 63 75 74 65 20 70 72 6f 67 72 | Execute progr
0250: 61 6d 2c 20 69 6e 73 65 72 74 73 20 65 78 69 74 am, inserts exit
0260: 20 63 6f 64 65 20 20 7c 20 41 6e 79 20 76 61 6c code | Any val
0270: 69 64 20 55 6e 69 78 20 63 6f 6d 6d 61 6e 64 20 id Unix command
0280: 20 7c 20 44 69 73 63 61 72 64 73 20 74 68 65 20 | Discards the
0290: 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 65 20 output from the
02a0: 70 72 6f 67 72 61 6d 0a 7c 20 23 7b 73 68 65 6c program.| #{shel
02b0: 6c 20 20 63 6f 6d 6d 61 6e 64 7d 20 6f 72 20 23 l command} or #
02c0: 7b 73 68 20 2e 2e 2e 7d 20 20 7c 20 45 78 65 63 {sh ...} | Exec
02d0: 75 74 65 20 70 72 6f 67 72 61 6d 2c 20 69 6e 73 ute program, ins
02e0: 65 72 74 73 20 72 65 73 75 6c 74 20 66 72 6f 6d erts result from
02f0: 20 73 74 64 6f 75 74 20 7c 20 41 6e 79 20 76 61 stdout | Any va
0300: 6c 69 64 20 55 6e 69 78 20 63 6f 6d 6d 61 6e 64 lid Unix command
0310: 20 7c 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 | Value returne
0320: 64 20 66 72 6f 6d 20 74 68 65 20 63 61 6c 6c 20 d from the call
0330: 69 73 20 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 is converted to
0340: 61 20 73 74 72 69 6e 67 20 61 6e 64 20 70 72 6f a string and pro
0350: 63 65 73 73 65 64 20 61 73 20 70 61 72 74 20 6f cessed as part o
0360: 66 20 74 68 65 20 63 6f 6e 66 69 67 20 66 69 6c f the config fil
0370: 65 0a 7c 20 23 7b 72 65 61 6c 70 61 74 68 20 70 e.| #{realpath p
0380: 61 74 68 7d 20 6f 72 20 23 7b 72 70 20 2e 2e 2e ath} or #{rp ...
0390: 7d 20 20 20 7c 20 52 65 70 6c 61 63 65 20 77 69 } | Replace wi
03a0: 74 68 20 6e 6f 72 6d 61 6c 69 7a 65 64 20 70 61 th normalized pa
03b0: 74 68 20 7c 20 4d 75 73 74 20 62 65 20 61 20 76 th | Must be a v
03c0: 61 6c 69 64 20 70 61 74 68 20 7c 0a 7c 20 23 7b alid path |.| #{
03d0: 67 65 74 65 6e 76 20 56 41 52 7d 20 6f 72 20 23 getenv VAR} or #
03e0: 7b 67 76 20 56 41 52 7d 20 20 20 20 20 20 7c 20 {gv VAR} |
03f0: 52 65 70 6c 61 63 65 20 77 69 74 68 20 63 6f 6e Replace with con
0400: 74 65 6e 74 20 6f 66 20 65 6e 76 20 76 61 72 69 tent of env vari
0410: 61 62 6c 65 20 7c 20 4d 75 73 74 20 62 65 20 61 able | Must be a
0420: 20 76 61 6c 69 64 20 76 61 72 20 7c 0a 7c 20 23 valid var |.| #
0430: 7b 67 65 74 20 73 20 76 7d 20 6f 72 20 23 7b 67 {get s v} or #{g
0440: 20 73 20 76 7d 20 20 20 20 20 7c 20 52 65 70 6c s v} | Repl
0450: 61 63 65 20 77 69 74 68 20 76 61 72 69 61 62 6c ace with variabl
0460: 65 20 76 20 66 72 6f 6d 20 73 65 63 74 69 6f 6e e v from section
0470: 20 73 20 7c 20 56 61 72 69 61 62 6c 65 20 6d 75 s | Variable mu
0480: 73 74 20 62 65 20 64 65 66 69 6e 65 64 20 62 65 st be defined be
0490: 66 6f 72 65 20 75 73 65 20 7c 0a 7c 20 23 7b 72 fore use |.| #{r
04a0: 67 65 74 20 76 7d 20 20 20 20 20 20 20 20 20 20 get v}
04b0: 20 20 20 20 20 20 20 20 7c 20 52 65 70 6c 61 63 | Replac
04c0: 65 20 77 69 74 68 20 76 61 72 69 61 62 6c 65 20 e with variable
04d0: 76 20 66 72 6f 6d 20 74 61 72 67 65 74 20 6f 72 v from target or
04e0: 20 64 65 66 61 75 6c 74 20 6f 66 20 72 75 6e 63 default of runc
04f0: 6f 6e 66 69 67 73 20 66 69 6c 65 20 7c 20 7c 0a onfigs file | |.
0500: 7c 20 23 7b 6d 74 72 61 68 7d 20 20 20 20 20 20 | #{mtrah}
0510: 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 52 | R
0520: 65 70 6c 61 63 65 20 77 69 74 68 20 74 68 65 20 eplace with the
0530: 70 61 74 68 20 74 6f 20 74 68 65 20 6d 65 67 61 path to the mega
0540: 74 65 73 74 20 74 65 73 74 73 75 69 74 65 20 61 test testsuite a
0550: 72 65 61 20 7c 20 7c 20 0a 7c 3d 3d 3d 3d 3d 3d rea | | .|======
0560: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0570: 0a 0a 43 6f 6e 66 69 67 20 46 69 6c 65 20 53 65 ..Config File Se
0580: 74 74 69 6e 67 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e ttings.~~~~~~~~~
0590: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 53 65 74 ~~~~~~~~~~~..Set
05a0: 74 69 6e 67 73 20 69 6e 20 6d 65 67 61 74 65 73 tings in megates
05b0: 74 2e 63 6f 6e 66 69 67 0a 0a 43 6f 6e 66 69 67 t.config..Config
05c0: 20 46 69 6c 65 20 41 64 64 69 74 69 6f 6e 61 6c File Additional
05d0: 20 46 65 61 74 75 72 65 73 0a 7e 7e 7e 7e 7e 7e Features.~~~~~~
05e0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
05f0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 63 6c 75 ~~~~~~~~~..Inclu
0600: 64 69 6e 67 20 6f 75 74 70 75 74 20 66 72 6f 6d ding output from
0610: 20 61 20 73 63 72 69 70 74 20 61 73 20 69 66 20 a script as if
0620: 69 74 20 77 61 73 20 69 6e 6c 69 6e 65 20 74 6f it was inline to
0630: 20 74 68 65 20 63 6f 6e 66 69 67 20 66 69 6c 65 the config file
0640: 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d :..-------------
0650: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 63 ------------.[sc
0660: 72 69 70 74 69 6e 63 20 6d 79 73 63 72 69 70 74 riptinc myscript
0670: 2e 73 68 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .sh].-----------
0680: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
0690: 49 66 20 74 68 65 20 73 63 72 69 70 74 20 6f 75 If the script ou
06a0: 74 70 75 74 73 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d tputs:..--------
06b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
06c0: 2d 0a 5b 69 74 65 6d 73 5d 0a 41 20 61 20 62 20 -.[items].A a b
06d0: 63 0a 42 20 64 20 65 20 66 0a 2d 2d 2d 2d 2d 2d c.B d e f.------
06e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
06f0: 2d 2d 2d 0a 0a 54 68 65 6e 20 74 68 65 20 63 6f ---..Then the co
0700: 6e 66 69 67 20 66 69 6c 65 20 77 6f 75 6c 64 20 nfig file would
0710: 65 66 66 65 63 74 69 76 65 6c 79 20 61 70 70 65 effectively appe
0720: 61 72 20 74 6f 20 63 6f 6e 74 61 69 6e 20 61 6e ar to contain an
0730: 20 69 74 65 6d 73 20 73 65 63 74 69 6f 6e 0a 65 items section.e
0740: 78 61 63 74 6c 79 20 6c 69 6b 65 20 74 68 65 20 xactly like the
0750: 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 65 20 output from the
0760: 73 63 72 69 70 74 2e 20 54 68 69 73 20 69 73 20 script. This is
0770: 75 73 65 66 75 6c 20 77 68 65 6e 20 64 79 6e 61 useful when dyna
0780: 6d 69 63 61 6c 6c 79 0a 63 72 65 61 74 69 6e 67 mically.creating
0790: 20 69 74 65 6d 73 2c 20 69 74 65 6d 73 74 61 62 items, itemstab
07a0: 6c 65 73 20 61 6e 64 20 6f 74 68 65 72 20 63 6f les and other co
07b0: 6e 66 69 67 20 73 74 72 75 63 74 75 72 65 73 2e nfig structures.
07c0: 20 59 6f 75 20 63 61 6e 20 73 65 65 20 74 68 65 You can see the
07d0: 0a 65 78 70 61 6e 73 69 6f 6e 20 6f 66 20 74 68 .expansion of th
07e0: 65 20 63 61 6c 6c 20 62 79 20 6c 6f 6f 6b 69 6e e call by lookin
07f0: 67 20 69 6e 20 74 68 65 20 63 61 63 68 65 64 20 g in the cached
0800: 66 69 6c 65 73 20 28 6c 6f 6f 6b 20 69 6e 20 79 files (look in y
0810: 6f 75 72 20 6c 69 6e 6b 74 72 65 65 0a 66 6f 72 our linktree.for
0820: 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 megatest.config
0830: 20 61 6e 64 20 72 75 6e 63 6f 6e 66 69 67 73 2e and runconfigs.
0840: 63 6f 6e 66 69 67 20 63 61 63 68 65 20 66 69 6c config cache fil
0850: 65 73 20 61 6e 64 20 69 6e 20 79 6f 75 72 20 74 es and in your t
0860: 65 73 74 20 72 75 6e 0a 61 72 65 61 73 20 66 6f est run.areas fo
0870: 72 20 74 68 65 20 65 78 70 61 6e 64 65 64 20 61 r the expanded a
0880: 6e 64 20 63 61 63 68 65 64 20 74 65 73 74 63 6f nd cached testco
0890: 6e 66 69 67 29 2e 0a 0a 57 69 6c 64 63 61 72 64 nfig)...Wildcard
08a0: 73 20 61 6e 64 20 72 65 67 65 78 65 73 20 69 6e s and regexes in
08b0: 20 54 61 72 67 65 74 73 0a 0a 2d 2d 2d 2d 2d 2d Targets..------
08c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
08d0: 2d 2d 2d 0a 5b 61 2f 32 2f 62 5d 0a 56 41 52 31 ---.[a/2/b].VAR1
08e0: 20 56 41 4c 31 0a 0a 5b 61 2f 25 2f 62 5d 0a 56 VAL1..[a/%/b].V
08f0: 41 52 31 20 56 41 4c 32 0a 2d 2d 2d 2d 2d 2d 2d AR1 VAL2.-------
0900: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0910: 2d 2d 0a 0a 57 69 6c 6c 20 72 65 73 75 6c 74 20 --..Will result
0920: 69 6e 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d in:..-----------
0930: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
0940: 61 2f 32 2f 62 5d 0a 56 41 52 31 20 56 41 4c 32 a/2/b].VAR1 VAL2
0950: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0960: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 61 6e 20 ----------..Can
0970: 75 73 65 20 65 69 74 68 65 72 20 77 69 6c 64 63 use either wildc
0980: 61 72 64 20 6f 66 20 22 25 22 20 6f 72 20 61 20 ard of "%" or a
0990: 72 65 67 75 6c 61 72 20 65 78 70 72 65 73 73 69 regular expressi
09a0: 6f 6e 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d on:..-----------
09b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
09c0: 2f 61 62 63 2e 2a 64 65 66 2f 5d 0a 2d 2d 2d 2d /abc.*def/].----
09d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
09e0: 2d 2d 2d 2d 2d 0a 0a 44 69 73 6b 20 53 70 61 63 -----..Disk Spac
09f0: 65 20 43 68 65 63 6b 73 0a 5e 5e 5e 5e 5e 5e 5e e Checks.^^^^^^^
0a00: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 53 6f 6d 65 ^^^^^^^^^^..Some
0a10: 20 70 61 72 61 6d 65 74 65 72 73 20 79 6f 75 20 parameters you
0a20: 63 61 6e 20 70 75 74 20 69 6e 20 74 68 65 20 5b can put in the [
0a30: 73 65 74 75 70 5d 20 73 65 63 74 69 6f 6e 20 6f setup] section o
0a40: 66 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 f megatest.confi
0a50: 67 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d g:..------------
0a60: 2d 2d 2d 2d 2d 2d 2d 0a 23 20 6d 69 6e 69 6d 75 -------.# minimu
0a70: 6d 20 73 70 61 63 65 20 72 65 71 75 69 72 65 64 m space required
0a80: 20 69 6e 20 61 20 72 75 6e 20 64 69 73 6b 20 0a in a run disk .
0a90: 6d 69 6e 73 70 61 63 65 20 31 30 30 30 30 30 30 minspace 1000000
0aa0: 30 0a 0a 23 20 6d 69 6e 69 6d 75 6d 20 73 70 61 0..# minimum spa
0ab0: 63 65 20 72 65 71 75 69 72 65 64 20 69 6e 20 64 ce required in d
0ac0: 62 64 69 72 3a 0a 64 62 64 69 72 2d 73 70 61 63 bdir:.dbdir-spac
0ad0: 65 2d 72 65 71 75 69 72 65 64 20 31 30 30 30 30 e-required 10000
0ae0: 30 0a 0a 23 20 73 63 72 69 70 74 20 74 68 61 74 0..# script that
0af0: 20 74 61 6b 65 73 20 70 61 74 68 20 61 73 20 70 takes path as p
0b00: 61 72 61 6d 65 74 65 72 20 61 6e 64 20 72 65 74 arameter and ret
0b10: 75 72 6e 73 20 6e 75 6d 62 65 72 20 6f 66 20 62 urns number of b
0b20: 79 74 65 73 20 61 76 61 69 6c 61 62 6c 65 3a 0a ytes available:.
0b30: 66 72 65 65 2d 73 70 61 63 65 2d 73 63 72 69 70 free-space-scrip
0b40: 74 20 63 68 65 63 6b 2d 73 70 61 63 65 2e 73 68 t check-space.sh
0b50: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0b60: 2d 2d 2d 2d 0a 0a 54 72 69 6d 20 74 72 61 69 6c ----..Trim trail
0b70: 69 6e 67 20 73 70 61 63 65 73 0a 5e 5e 5e 5e 5e ing spaces.^^^^^
0b80: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a ^^^^^^^^^^^^^^^.
0b90: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0ba0: 2d 2d 2d 0a 5b 63 6f 6e 66 69 67 66 3a 73 65 74 ---.[configf:set
0bb0: 74 69 6e 67 73 20 74 72 69 6d 2d 74 72 61 69 6c tings trim-trail
0bc0: 69 6e 67 2d 73 70 61 63 65 73 20 79 65 73 5d 0a ing-spaces yes].
0bd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0be0: 2d 2d 0a 0a 4a 6f 62 20 53 75 62 6d 69 73 73 69 --..Job Submissi
0bf0: 6f 6e 20 43 6f 6e 74 72 6f 6c 0a 5e 5e 5e 5e 5e on Control.^^^^^
0c00: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
0c10: 5e 0a 0a 53 75 62 6d 69 74 20 6a 6f 62 73 20 74 ^..Submit jobs t
0c20: 6f 20 48 6f 73 74 20 54 79 70 65 73 20 62 61 73 o Host Types bas
0c30: 65 64 20 6f 6e 20 54 65 73 74 20 4e 61 6d 65 0a ed on Test Name.
0c40: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ++++++++++++++++
0c50: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ++++++++++++++++
0c60: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 2e 49 ++++++++++++...I
0c70: 6e 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 n megatest.confi
0c80: 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d g.--------------
0c90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 68 6f 73 74 ----------.[host
0ca0: 2d 74 79 70 65 73 5d 0a 67 65 6e 65 72 61 6c 20 -types].general
0cb0: 20 20 6e 62 66 61 6b 65 0a 72 65 6d 6f 74 65 20 nbfake.remote
0cc0: 20 20 20 62 73 75 62 0a 0a 5b 6c 61 75 6e 63 68 bsub..[launch
0cd0: 65 72 73 5d 0a 72 75 6e 66 69 72 73 74 2f 73 75 ers].runfirst/su
0ce0: 6d 25 20 72 65 6d 6f 74 65 0a 25 20 67 65 6e 65 m% remote.% gene
0cf0: 72 61 6c 0a 0a 5b 6a 6f 62 74 6f 6f 6c 73 5d 0a ral..[jobtools].
0d00: 6c 61 75 6e 63 68 65 72 20 62 73 75 62 0a 23 20 launcher bsub.#
0d10: 69 66 20 64 65 66 69 6e 65 64 20 61 6e 64 20 6e if defined and n
0d20: 6f 74 20 22 6e 6f 22 20 66 6c 65 78 69 2d 6c 61 ot "no" flexi-la
0d30: 75 6e 63 68 65 72 20 77 69 6c 6c 20 62 79 70 61 uncher will bypa
0d40: 73 73 20 6c 61 75 6e 63 68 65 72 20 75 6e 6c 65 ss launcher unle
0d50: 73 73 20 0a 23 20 74 68 65 72 65 20 69 73 20 6e ss .# there is n
0d60: 6f 20 68 6f 73 74 2d 74 79 70 65 20 6d 61 74 63 o host-type matc
0d70: 68 2e 0a 66 6c 65 78 69 2d 6c 61 75 6e 63 68 65 h..flexi-launche
0d80: 72 20 79 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d r yes.----------
0d90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
0da0: 68 6f 73 74 2d 74 79 70 65 73 0a 2b 2b 2b 2b 2b host-types.+++++
0db0: 2b 2b 2b 2b 2b 0a 0a 4c 69 73 74 20 6f 66 20 68 +++++..List of h
0dc0: 6f 73 74 20 74 79 70 65 73 20 61 6e 64 20 74 68 ost types and th
0dd0: 65 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65 20 74 6f e commandline to
0de0: 20 72 75 6e 20 61 20 6a 6f 62 20 6f 6e 20 74 68 run a job on th
0df0: 61 74 20 68 6f 73 74 20 74 79 70 65 2e 0a 0a 2e at host type....
0e00: 68 6f 73 74 2d 74 79 70 65 20 3d 3e 20 6c 61 75 host-type => lau
0e10: 6e 63 68 20 63 6f 6d 6d 61 6e 64 0a 2d 2d 2d 2d nch command.----
0e20: 2d 2d 2d 2d 2d 2d 2d 2d 0a 67 65 6e 65 72 61 6c --------.general
0e30: 20 6e 62 66 61 6b 65 0a 2d 2d 2d 2d 2d 2d 2d 2d nbfake.--------
0e40: 2d 2d 2d 2d 0a 0a 6c 61 75 6e 63 68 65 72 73 0a ----..launchers.
0e50: 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 2e 74 65 73 74 +++++++++...test
0e60: 2f 69 74 65 6d 70 61 74 68 20 3d 3e 20 68 6f 73 /itempath => hos
0e70: 74 2d 74 79 70 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d t-type.---------
0e80: 2d 2d 2d 0a 72 75 6e 66 69 72 73 74 2f 73 75 6d ---.runfirst/sum
0e90: 25 20 72 65 6d 6f 74 65 0a 2d 2d 2d 2d 2d 2d 2d % remote.-------
0ea0: 2d 2d 2d 2d 2d 0a 0a 4d 69 73 63 65 6c 6c 61 6e -----..Miscellan
0eb0: 65 6f 75 73 20 53 65 74 75 70 20 49 74 65 6d 73 eous Setup Items
0ec0: 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b .+++++++++++++++
0ed0: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 41 74 74 65 ++++++++++..Atte
0ee0: 6d 70 74 20 74 6f 20 72 65 72 75 6e 20 74 65 73 mpt to rerun tes
0ef0: 74 73 20 69 6e 20 22 53 54 55 43 4b 2f 44 45 41 ts in "STUCK/DEA
0f00: 44 22 2c 20 22 6e 2f 61 22 2c 20 22 5a 45 52 4f D", "n/a", "ZERO
0f10: 5f 49 54 45 4d 53 22 20 73 74 61 74 65 73 2e 0a _ITEMS" states..
0f20: 0a 2e 49 6e 20 6d 65 67 61 74 65 73 74 2e 63 6f ..In megatest.co
0f30: 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d nfig.-----------
0f40: 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 70 5d 0a -------.[setup].
0f50: 72 65 72 75 6e 73 20 35 0a 2d 2d 2d 2d 2d 2d 2d reruns 5.-------
0f60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 65 70 -----------..Rep
0f70: 6c 61 63 65 20 74 68 65 20 64 65 66 61 75 6c 74 lace the default
0f80: 20 62 6c 61 63 6b 6c 69 73 74 65 64 20 65 6e 76 blacklisted env
0f90: 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c ironment variabl
0fa0: 65 73 20 77 69 74 68 20 75 73 65 72 20 73 75 70 es with user sup
0fb0: 70 6c 69 65 64 0a 6c 69 73 74 2e 0a 0a 44 65 66 plied.list...Def
0fc0: 61 75 6c 74 20 6c 69 73 74 3a 20 55 53 45 52 20 ault list: USER
0fd0: 48 4f 4d 45 20 44 49 53 50 4c 41 59 20 4c 53 5f HOME DISPLAY LS_
0fe0: 43 4f 4c 4f 52 53 20 58 4b 45 59 53 59 4d 44 42 COLORS XKEYSYMDB
0ff0: 20 45 44 49 54 4f 52 20 4d 41 4b 45 46 4c 41 47 EDITOR MAKEFLAG
1000: 53 20 4d 41 4b 45 46 20 4d 41 4b 45 4f 56 45 52 S MAKEF MAKEOVER
1010: 52 49 44 45 53 0a 0a 2e 41 64 64 20 61 20 22 62 RIDES...Add a "b
1020: 61 64 22 20 76 61 72 69 61 62 6c 65 20 22 50 52 ad" variable "PR
1030: 4f 4d 50 54 22 20 74 6f 20 74 68 65 20 76 61 72 OMPT" to the var
1040: 69 61 62 6c 65 73 20 74 68 61 74 20 77 69 6c 6c iables that will
1050: 20 62 65 20 63 6f 6d 6d 65 6e 74 65 64 20 6f 75 be commented ou
1060: 74 0a 69 6e 20 74 68 65 20 6d 65 67 61 74 65 73 t.in the megates
1070: 74 2e 73 68 20 61 6e 64 20 6d 65 67 61 74 65 73 t.sh and megates
1080: 74 2e 63 73 68 20 66 69 6c 65 73 3a 0a 2d 2d 2d t.csh files:.---
1090: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
10a0: 73 65 74 75 70 5d 0a 62 6c 61 63 6b 6c 69 73 74 setup].blacklist
10b0: 76 61 72 73 20 55 53 45 52 20 48 4f 4d 45 20 44 vars USER HOME D
10c0: 49 53 50 4c 41 59 20 4c 53 5f 43 4f 4c 4f 52 53 ISPLAY LS_COLORS
10d0: 20 58 4b 45 59 53 59 4d 44 42 20 45 44 49 54 4f XKEYSYMDB EDITO
10e0: 52 20 4d 41 4b 45 46 4c 41 47 53 20 50 52 4f 4d R MAKEFLAGS PROM
10f0: 50 54 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d PT.-------------
1100: 2d 2d 2d 2d 0a 0a 52 75 6e 20 74 69 6d 65 20 6c ----..Run time l
1110: 69 6d 69 74 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b imit.+++++++++++
1120: 2b 2b 2b 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d +++..-----------
1130: 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 70 5d 0a 23 ------.[setup].#
1140: 20 74 68 69 73 20 77 69 6c 6c 20 61 75 74 6f 6d this will autom
1150: 61 74 69 63 61 6c 6c 79 20 6b 69 6c 6c 20 74 68 atically kill th
1160: 65 20 74 65 73 74 20 69 66 20 69 74 20 72 75 6e e test if it run
1170: 73 20 66 6f 72 20 6d 6f 72 65 20 74 68 61 6e 20 s for more than
1180: 31 68 20 32 6d 20 61 6e 64 20 33 73 0a 72 75 6e 1h 2m and 3s.run
1190: 74 69 6d 65 6c 69 6d 20 31 68 20 32 6d 20 33 73 timelim 1h 2m 3s
11a0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
11b0: 2d 2d 0a 0a 54 65 73 74 73 20 62 72 6f 77 73 65 --..Tests browse
11c0: 72 20 76 69 65 77 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e r view.~~~~~~~~~
11d0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 54 68 65 20 74 ~~~~~~~~~..The t
11e0: 65 73 74 73 20 62 72 6f 77 73 65 72 20 28 73 65 ests browser (se
11f0: 65 20 74 68 65 20 52 75 6e 20 43 6f 6e 74 72 6f e the Run Contro
1200: 6c 20 74 61 62 20 6f 6e 20 74 68 65 20 64 61 73 l tab on the das
1210: 68 62 6f 61 72 64 29 20 68 61 73 20 74 77 6f 20 hboard) has two
1220: 76 69 65 77 73 20 66 6f 72 20 64 69 73 70 6c 61 views for displa
1230: 79 69 6e 67 20 74 68 65 20 74 65 73 74 73 2e 20 ying the tests.
1240: 0a 0a 2e 20 44 6f 74 20 28 67 72 61 70 68 76 69 ... Dot (graphvi
1250: 7a 29 20 62 61 73 65 64 20 74 72 65 65 0a 2e 20 z) based tree..
1260: 4e 6f 20 64 6f 74 2c 20 70 6c 61 69 6e 20 6c 69 No dot, plain li
1270: 73 74 69 6e 67 0a 0a 54 68 65 20 64 65 66 61 75 sting..The defau
1280: 6c 74 20 69 73 20 74 68 65 20 67 72 61 70 68 76 lt is the graphv
1290: 69 7a 20 62 61 73 65 64 20 74 72 65 65 20 62 75 iz based tree bu
12a0: 74 20 69 66 20 79 6f 75 72 20 74 65 73 74 73 20 t if your tests
12b0: 64 6f 6e 27 74 20 76 69 65 77 0a 77 65 6c 6c 20 don't view.well
12c0: 69 6e 20 74 68 61 74 20 6d 6f 64 65 20 74 68 65 in that mode the
12d0: 6e 20 75 73 65 20 22 6e 6f 64 6f 74 22 20 74 6f n use "nodot" to
12e0: 20 74 75 72 6e 20 69 74 20 6f 66 66 2e 0a 0a 2d turn it off...-
12f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1300: 0a 5b 73 65 74 75 70 5d 0a 6e 6f 64 6f 74 0a 2d .[setup].nodot.-
1310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1320: 0a 0a 44 61 73 68 62 6f 61 72 64 20 73 65 74 74 ..Dashboard sett
1330: 69 6e 67 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ings.~~~~~~~~~~~
1340: 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 52 75 6e 73 20 74 ~~~~~~~...Runs t
1350: 61 62 20 62 75 74 74 6f 6e 73 2c 20 66 6f 6e 74 ab buttons, font
1360: 20 61 6e 64 20 73 69 7a 65 0a 2d 2d 2d 2d 2d 2d and size.------
1370: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 64 61 ------------.[da
1380: 73 68 62 6f 61 72 64 5d 0a 62 74 6e 2d 68 65 69 shboard].btn-hei
1390: 67 68 74 20 78 31 34 0a 62 74 6e 2d 66 6f 6e 74 ght x14.btn-font
13a0: 73 7a 20 31 30 0a 63 65 6c 6c 2d 77 69 64 74 68 sz 10.cell-width
13b0: 20 36 30 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 60.------------
13c0: 2d 2d 2d 2d 2d 2d 0a 0a 44 61 74 61 62 61 73 65 ------..Database
13d0: 20 73 65 74 74 69 6e 67 73 0a 7e 7e 7e 7e 7e 7e settings.~~~~~~
13e0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 44 61 ~~~~~~~~~~~...Da
13f0: 74 61 62 61 73 65 20 63 6f 6e 66 69 67 20 73 65 tabase config se
1400: 74 74 69 6e 67 73 20 69 6e 20 5b 73 65 74 75 70 ttings in [setup
1410: 5d 20 73 65 63 74 69 6f 6e 20 6f 66 20 6d 65 67 ] section of meg
1420: 61 74 65 73 74 2e 63 6f 6e 66 69 67 0a 5b 77 69 atest.config.[wi
1430: 64 74 68 3d 22 37 30 25 22 2c 63 6f 6c 73 3d 22 dth="70%",cols="
1440: 5e 2c 32 6d 2c 32 6d 2c 32 6d 22 2c 66 72 61 6d ^,2m,2m,2m",fram
1450: 65 3d 22 74 6f 70 62 6f 74 22 2c 6f 70 74 69 6f e="topbot",optio
1460: 6e 73 3d 22 68 65 61 64 65 72 22 5d 0a 7c 3d 3d ns="header"].|==
1470: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
1480: 3d 3d 3d 3d 0a 7c 56 61 72 20 20 20 20 20 20 20 ====.|Var
1490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14a0: 7c 20 50 75 72 70 6f 73 65 20 20 20 20 20 20 20 | Purpose
14b0: 20 20 20 20 20 7c 20 56 61 6c 69 64 20 76 61 6c | Valid val
14c0: 75 65 73 20 20 20 20 20 20 20 20 20 20 20 20 7c ues |
14d0: 20 43 6f 6d 6d 65 6e 74 73 0a 7c 64 65 6c 61 79 Comments.|delay
14e0: 2d 6f 6e 2d 62 75 73 79 20 20 20 20 20 20 20 20 -on-busy
14f0: 20 20 20 20 20 7c 20 50 72 65 76 65 6e 74 20 63 | Prevent c
1500: 6f 6e 63 75 72 72 65 6e 74 20 61 63 63 65 73 73 oncurrent access
1510: 20 69 73 73 75 65 73 20 7c 20 79 65 73 5c 7c 6e issues | yes\|n
1520: 6f 20 6f 72 20 6e 6f 74 20 64 65 66 69 6e 65 64 o or not defined
1530: 20 7c 20 44 65 66 61 75 6c 74 3d 6e 6f 2c 20 6d | Default=no, m
1540: 61 79 20 68 65 6c 70 20 6f 6e 20 73 6f 6d 65 20 ay help on some
1550: 6e 65 74 77 6f 72 6b 20 66 69 6c 65 20 73 79 73 network file sys
1560: 74 65 6d 73 2c 20 6d 61 79 20 73 6c 6f 77 20 74 tems, may slow t
1570: 68 69 6e 67 73 20 64 6f 77 6e 20 61 6c 73 6f 2e hings down also.
1580: 0a 7c 64 61 65 6d 6f 6e 69 7a 65 20 20 20 20 20 .|daemonize
1590: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 44 61 | Da
15a0: 65 6d 6f 6e 69 7a 65 20 74 68 65 20 73 65 72 76 emonize the serv
15b0: 65 72 20 6f 6e 20 73 74 61 72 74 20 7c 20 79 65 er on start | ye
15c0: 73 5c 7c 6e 6f 20 6f 72 20 6e 6f 74 20 64 65 66 s\|no or not def
15d0: 69 6e 65 64 20 7c 20 44 65 66 61 75 6c 74 3d 6e ined | Default=n
15e0: 6f 0a 7c 66 61 73 74 73 74 61 72 74 09 09 20 20 o.|faststart..
15f0: 20 7c 20 41 6c 6c 20 64 69 72 65 63 74 20 66 69 | All direct fi
1600: 6c 65 20 61 63 63 65 73 73 20 74 6f 20 73 71 6c le access to sql
1610: 69 74 65 20 64 62 20 66 69 6c 65 73 20 7c 20 79 ite db files | y
1620: 65 73 5c 7c 6e 6f 20 6f 72 20 6e 6f 74 20 64 65 es\|no or not de
1630: 66 69 6e 65 64 20 7c 20 44 65 66 61 75 6c 74 3d fined | Default=
1640: 79 65 73 2c 20 73 75 67 67 65 73 74 20 6e 6f 20 yes, suggest no
1650: 66 6f 72 20 63 65 6e 74 72 61 6c 20 61 75 74 6f for central auto
1660: 6d 61 74 65 64 20 73 79 73 74 65 6d 73 20 61 6e mated systems an
1670: 64 20 79 65 73 20 66 6f 72 20 69 6e 74 65 72 61 d yes for intera
1680: 63 74 69 76 65 20 75 73 65 0a 7c 68 6f 6d 65 68 ctive use.|homeh
1690: 6f 73 74 20 09 09 20 20 20 7c 20 53 74 61 72 74 ost .. | Start
16a0: 20 73 65 72 76 65 72 73 20 6f 6e 20 74 68 69 73 servers on this
16b0: 20 68 6f 73 74 20 7c 20 3c 68 6f 73 74 6e 61 6d host | <hostnam
16c0: 65 3e 20 7c 20 44 65 66 61 75 6c 74 73 20 74 6f e> | Defaults to
16d0: 20 6c 6f 63 61 6c 20 68 6f 73 74 0a 7c 68 6f 73 local host.|hos
16e0: 74 6e 61 6d 65 09 09 20 20 20 7c 20 48 6f 73 74 tname.. | Host
16f0: 6e 61 6d 65 20 74 6f 20 62 69 6e 64 20 74 6f 20 name to bind to
1700: 7c 20 3c 68 6f 73 74 6e 61 6d 65 3e 5c 7c 2d 09 | <hostname>\|-.
1710: 20 20 7c 20 4f 6e 20 6d 75 6c 74 69 2d 68 6f 6d | On multi-hom
1720: 65 64 20 68 6f 73 74 73 20 61 6c 6c 6f 77 73 20 ed hosts allows
1730: 62 69 6e 64 69 6e 67 20 74 6f 20 73 70 65 63 69 binding to speci
1740: 66 69 63 20 68 6f 73 74 6e 61 6d 65 0a 7c 6c 6f fic hostname.|lo
1750: 77 70 6f 72 74 09 09 20 20 20 7c 20 53 74 61 72 wport.. | Star
1760: 74 20 73 65 61 72 63 68 69 6e 67 20 66 6f 72 20 t searching for
1770: 61 20 70 6f 72 74 20 61 74 20 74 68 69 73 20 70 a port at this p
1780: 6f 72 74 6e 75 6d 7c 20 33 32 37 36 38 20 7c 20 ortnum| 32768 |
1790: 0a 7c 72 65 71 75 69 72 65 64 09 09 20 20 20 7c .|required.. |
17a0: 20 53 65 72 76 65 72 20 72 65 71 75 69 72 65 64 Server required
17b0: 20 20 20 20 7c 20 79 65 73 5c 7c 6e 6f 20 6f 72 | yes\|no or
17c0: 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 20 7c 20 not defined |
17d0: 44 65 66 61 75 6c 74 3d 6e 6f 2c 20 66 6f 72 63 Default=no, forc
17e0: 65 20 73 74 61 72 74 20 6f 66 20 73 65 72 76 65 e start of serve
17f0: 72 20 61 6c 77 61 79 73 0a 7c 73 65 72 76 65 72 r always.|server
1800: 2d 71 75 65 72 79 2d 74 68 72 65 73 68 6f 6c 64 -query-threshold
1810: 09 20 20 20 7c 20 53 74 61 72 74 20 73 65 72 76 . | Start serv
1820: 65 72 20 77 68 65 6e 20 71 75 65 72 69 65 73 20 er when queries
1830: 74 61 6b 65 20 6c 6f 6e 67 65 72 20 74 68 61 6e take longer than
1840: 20 74 68 69 73 20 7c 20 6e 75 6d 62 65 72 20 69 this | number i
1850: 6e 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 7c n milliseconds |
1860: 20 44 65 66 61 75 6c 74 3d 33 30 30 0a 7c 74 69 Default=300.|ti
1870: 6d 65 6f 75 74 09 09 20 20 20 7c 20 68 74 74 70 meout.. | http
1880: 20 61 70 69 20 74 69 6d 65 6f 75 74 20 09 7c 20 api timeout .|
1890: 6e 75 6d 62 65 72 20 69 6e 20 68 6f 75 72 73 09 number in hours.
18a0: 20 20 7c 20 44 65 66 61 75 6c 74 20 69 73 20 31 | Default is 1
18b0: 20 6d 69 6e 75 74 65 2c 20 64 6f 20 6e 6f 74 20 minute, do not
18c0: 63 68 61 6e 67 65 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d change.|========
18d0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a ==============..
18e0: 54 68 65 20 74 65 73 74 63 6f 6e 66 69 67 20 46 The testconfig F
18f0: 69 6c 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ile.------------
1900: 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 65 74 75 70 20 73 -------..Setup s
1910: 65 63 74 69 6f 6e 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e ection.~~~~~~~~~
1920: 7e 7e 7e 7e 0a 0a 48 65 61 64 65 72 0a 5e 5e 5e ~~~~..Header.^^^
1930: 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^^..-----------
1940: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 70 5d --------.[setup]
1950: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
1960: 2d 2d 2d 2d 0a 0a 54 68 65 20 72 75 6e 73 63 72 ----..The runscr
1970: 69 70 74 20 6d 65 74 68 6f 64 20 69 73 20 61 20 ipt method is a
1980: 62 72 75 74 65 20 66 6f 72 63 65 20 77 61 79 20 brute force way
1990: 74 6f 20 72 75 6e 20 73 63 72 69 70 74 73 20 77 to run scripts w
19a0: 68 65 72 65 20 74 68 65 0a 75 73 65 72 20 69 73 here the.user is
19b0: 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 responsible for
19c0: 20 73 65 74 74 69 6e 67 20 53 54 41 54 45 20 61 setting STATE a
19d0: 6e 64 20 53 54 41 54 55 53 0a 0a 2d 2d 2d 2d 2d nd STATUS..-----
19e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 72 --------------.r
19f0: 75 6e 73 63 72 69 70 74 20 6d 61 69 6e 2e 63 73 unscript main.cs
1a00: 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d h.--------------
1a10: 2d 2d 2d 2d 2d 0a 0a 52 65 71 75 69 72 65 6d 65 -----..Requireme
1a20: 6e 74 73 20 73 65 63 74 69 6f 6e 0a 7e 7e 7e 7e nts section.~~~~
1a30: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
1a40: 0a 0a 2e 48 65 61 64 65 72 0a 2d 2d 2d 2d 2d 2d ...Header.------
1a50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 -------------.[r
1a60: 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 2d 2d 2d equirements].---
1a70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1a80: 0a 0a 57 61 69 74 20 6f 6e 20 4f 74 68 65 72 20 ..Wait on Other
1a90: 54 65 73 74 73 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e Tests.^^^^^^^^^^
1aa0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d ^^^^^^^^^..-----
1ab0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 --------------.#
1ac0: 20 41 20 6e 6f 72 6d 61 6c 20 77 61 69 74 6f 6e A normal waiton
1ad0: 20 77 61 69 74 73 20 66 6f 72 20 74 68 65 20 70 waits for the p
1ae0: 72 69 6f 72 20 74 65 73 74 73 20 74 6f 20 62 65 rior tests to be
1af0: 20 43 4f 4d 50 4c 45 54 45 44 20 0a 23 20 61 6e COMPLETED .# an
1b00: 64 20 50 41 53 53 2c 20 43 48 45 43 4b 20 6f 72 d PASS, CHECK or
1b10: 20 57 41 49 56 45 44 0a 77 61 69 74 6f 6e 20 74 WAIVED.waiton t
1b20: 65 73 74 31 20 74 65 73 74 32 0a 2d 2d 2d 2d 2d est1 test2.-----
1b30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
1b40: 4d 6f 64 65 0a 5e 5e 5e 5e 0a 0a 54 68 65 20 64 Mode.^^^^..The d
1b50: 65 66 61 75 6c 74 20 28 69 2e 65 2e 20 69 66 20 efault (i.e. if
1b60: 6d 6f 64 65 20 69 73 20 6e 6f 74 20 73 70 65 63 mode is not spec
1b70: 69 66 69 65 64 29 20 69 73 20 6e 6f 72 6d 61 6c ified) is normal
1b80: 2e 20 41 6c 6c 20 70 72 65 2d 64 65 70 65 6e 64 . All pre-depend
1b90: 65 6e 74 20 74 65 73 74 73 0a 6d 75 73 74 20 62 ent tests.must b
1ba0: 65 20 43 4f 4d 50 4c 45 54 45 44 20 61 6e 64 20 e COMPLETED and
1bb0: 50 41 53 53 2c 20 43 48 45 43 4b 20 6f 72 20 57 PASS, CHECK or W
1bc0: 41 49 56 45 44 20 62 65 66 6f 72 65 20 74 68 65 AIVED before the
1bd0: 20 74 65 73 74 20 77 69 6c 6c 20 73 74 61 72 74 test will start
1be0: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
1bf0: 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 -----.[requireme
1c00: 6e 74 73 5d 0a 6d 6f 64 65 20 20 20 6e 6f 72 6d nts].mode norm
1c10: 61 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d al.-------------
1c20: 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 20 74 6f 70 6c ------..The topl
1c30: 65 76 65 6c 20 6d 6f 64 65 20 72 65 71 75 69 72 evel mode requir
1c40: 65 73 20 6f 6e 6c 79 20 74 68 61 74 20 74 68 65 es only that the
1c50: 20 70 72 69 6f 72 20 74 65 73 74 73 20 61 72 65 prior tests are
1c60: 20 43 4f 4d 50 4c 45 54 45 44 2e 0a 0a 2d 2d 2d COMPLETED...---
1c70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1c80: 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a .[requirements].
1c90: 6d 6f 64 65 20 74 6f 70 6c 65 76 65 6c 0a 2d 2d mode toplevel.--
1ca0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1cb0: 2d 0a 0a 41 20 69 74 65 6d 20 62 61 73 65 64 20 -..A item based
1cc0: 77 61 69 74 6f 6e 20 77 69 6c 6c 20 73 74 61 72 waiton will star
1cd0: 74 20 69 74 65 6d 73 20 69 6e 20 61 20 74 65 73 t items in a tes
1ce0: 74 20 77 68 65 6e 20 74 68 65 20 73 61 6d 65 2d t when the same-
1cf0: 6e 61 6d 65 64 0a 69 74 65 6d 20 69 73 20 43 4f named.item is CO
1d00: 4d 50 4c 45 54 45 44 20 61 6e 64 20 50 41 53 53 MPLETED and PASS
1d10: 2c 20 43 48 45 43 4b 20 6f 72 20 57 41 49 56 45 , CHECK or WAIVE
1d20: 44 20 69 6e 20 74 68 65 20 70 72 69 6f 72 20 74 D in the prior t
1d30: 65 73 74 2e 20 54 68 69 73 0a 77 61 73 20 68 69 est. This.was hi
1d40: 73 74 6f 72 69 63 61 6c 6c 79 20 63 61 6c 6c 65 storically calle
1d50: 64 20 22 69 74 65 6d 77 61 69 74 22 20 6d 6f 64 d "itemwait" mod
1d60: 65 2e 20 54 68 65 20 74 65 72 6d 73 20 22 69 74 e. The terms "it
1d70: 65 6d 77 61 69 74 22 20 61 6e 64 0a 22 69 74 65 emwait" and."ite
1d80: 6d 6d 61 74 63 68 22 20 61 72 65 20 73 79 6e 6f mmatch" are syno
1d90: 6e 79 6d 73 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d nyms...---------
1da0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 ----------.[requ
1db0: 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 69 irements].mode i
1dc0: 74 65 6d 6d 61 74 63 68 0a 2d 2d 2d 2d 2d 2d 2d temmatch.-------
1dd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4f 76 ------------..Ov
1de0: 65 72 72 69 64 69 6e 67 20 45 6e 76 69 72 6f 6d erriding Envirom
1df0: 65 6e 74 20 56 61 72 69 61 62 6c 65 73 0a 7e 7e ent Variables.~~
1e00: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
1e10: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 4f ~~~~~~~~~~~~~..O
1e20: 76 65 72 72 69 64 65 20 76 61 72 69 61 62 6c 65 verride variable
1e30: 73 20 62 65 66 6f 72 65 20 73 74 61 72 74 69 6e s before startin
1e40: 67 20 74 68 65 20 74 65 73 74 2e 20 43 61 6e 20 g the test. Can
1e50: 69 6e 63 6c 75 64 65 20 66 69 6c 65 73 20 28 70 include files (p
1e60: 65 72 68 61 70 73 20 67 65 6e 65 72 61 74 65 64 erhaps generated
1e70: 20 62 79 20 6d 65 67 61 74 65 73 74 20 2d 65 6e by megatest -en
1e80: 76 64 65 6c 74 61 20 6f 72 20 73 69 6d 69 6c 61 vdelta or simila
1e90: 72 29 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d r)...-----------
1ea0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 70 72 65 2d 6c ---------.[pre-l
1eb0: 61 75 6e 63 68 2d 65 6e 76 2d 76 61 72 73 5d 0a aunch-env-vars].
1ec0: 56 41 52 31 20 76 61 6c 75 65 31 0a 0a 23 20 47 VAR1 value1..# G
1ed0: 65 74 20 73 6f 6d 65 20 67 65 6e 65 72 61 74 65 et some generate
1ee0: 64 20 73 65 74 74 69 6e 67 73 0a 5b 69 6e 63 6c d settings.[incl
1ef0: 75 64 65 20 2e 2e 2f 67 65 6e 65 72 61 74 65 64 ude ../generated
1f00: 2d 76 61 72 73 2e 63 6f 6e 66 69 67 5d 0a 0a 23 -vars.config]..#
1f10: 20 55 73 65 20 74 68 69 73 20 74 72 69 63 6b 20 Use this trick
1f20: 74 6f 20 75 6e 73 65 74 20 76 61 72 69 61 62 6c to unset variabl
1f30: 65 73 0a 23 7b 73 63 68 65 6d 65 20 28 75 6e 73 es.#{scheme (uns
1f40: 65 74 65 6e 76 20 22 46 4f 4f 42 41 52 22 29 7d etenv "FOOBAR")}
1f50: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
1f60: 2d 2d 2d 2d 2d 0a 0a 49 74 65 6d 6d 61 70 20 48 -----..Itemmap H
1f70: 61 6e 64 6c 69 6e 67 0a 7e 7e 7e 7e 7e 7e 7e 7e andling.~~~~~~~~
1f80: 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 46 6f 72 20 63 61 ~~~~~~~~..For ca
1f90: 73 65 73 20 77 65 72 65 20 74 68 65 20 64 65 70 ses were the dep
1fa0: 65 6e 64 65 6e 74 20 74 65 73 74 20 68 61 73 20 endent test has
1fb0: 61 20 73 69 6d 69 6c 61 72 20 62 75 74 20 6e 6f a similar but no
1fc0: 74 20 69 64 65 6e 74 69 63 61 6c 0a 69 74 65 6d t identical.item
1fd0: 70 61 74 68 20 74 6f 20 74 68 65 20 64 6f 77 6e path to the down
1fe0: 73 74 72 65 61 6d 20 74 65 73 74 20 61 6e 20 69 stream test an i
1ff0: 74 65 6d 6d 61 70 20 63 61 6e 20 61 6c 6c 6f 77 temmap can allow
2000: 20 66 6f 72 20 69 74 65 6d 6d 61 74 63 68 0a 6d for itemmatch.m
2010: 6f 64 65 0a 0a 2e 65 78 61 6d 70 6c 65 20 66 6f ode...example fo
2020: 72 20 72 65 6d 6f 76 69 6e 67 20 70 61 72 74 20 r removing part
2030: 6f 66 20 69 74 65 6d 6d 61 70 20 66 6f 72 20 77 of itemmap for w
2040: 61 69 74 6f 6e 20 74 65 73 74 20 28 65 67 3a 20 aiton test (eg:
2050: 69 74 65 6d 20 2b 66 6f 6f 2d 78 2f 62 61 72 2b item +foo-x/bar+
2060: 20 64 65 70 65 6e 64 73 20 6f 6e 20 77 61 69 74 depends on wait
2070: 6f 6e 27 73 20 69 74 65 6d 20 2b 79 2f 62 61 72 on's item +y/bar
2080: 2b 29 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d +).-------------
2090: 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d ------.[requirem
20a0: 65 6e 74 73 5d 0a 6d 6f 64 65 20 69 74 65 6d 77 ents].mode itemw
20b0: 61 69 74 0a 23 20 69 74 65 6d 6d 61 70 20 3c 69 ait.# itemmap <i
20c0: 74 65 6d 20 70 61 74 74 65 72 6e 20 66 6f 72 20 tem pattern for
20d0: 74 68 69 73 20 74 65 73 74 3e 20 20 3c 69 74 65 this test> <ite
20e0: 6d 20 72 65 70 6c 61 63 65 6d 65 6e 74 20 70 61 m replacement pa
20f0: 74 74 65 72 6e 20 66 6f 72 20 77 61 69 74 6f 6e ttern for waiton
2100: 20 74 65 73 74 3e 0a 69 74 65 6d 6d 61 70 20 2e test>.itemmap .
2110: 2a 78 2f 20 79 2f 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d *x/ y/..--------
2120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 78 -----------...ex
2130: 61 6d 70 6c 65 20 66 6f 72 20 72 65 6d 6f 76 69 ample for removi
2140: 6e 67 20 70 61 72 74 20 6f 66 20 69 74 65 6d 6d ng part of itemm
2150: 61 70 20 66 6f 72 20 77 61 69 74 6f 6e 20 74 65 ap for waiton te
2160: 73 74 20 28 65 67 3a 20 69 74 65 6d 20 2b 66 6f st (eg: item +fo
2170: 6f 2f 62 61 72 2f 62 61 7a 2b 20 69 6e 20 74 68 o/bar/baz+ in th
2180: 69 73 20 74 65 73 74 20 64 65 70 65 6e 64 73 20 is test depends
2190: 6f 6e 20 77 61 69 74 6f 6e 27 73 20 69 74 65 6d on waiton's item
21a0: 20 2b 62 61 7a 2b 29 0a 2d 2d 2d 2d 2d 2d 2d 2d +baz+).--------
21b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 23 20 23 -----------..# #
21c0: 23 20 70 61 74 74 65 72 6e 20 72 65 70 6c 61 63 # pattern replac
21d0: 65 6d 65 6e 74 20 6e 6f 74 65 73 0a 23 0a 23 20 ement notes.#.#
21e0: 23 23 20 45 78 61 6d 70 6c 65 0a 23 20 23 23 20 ## Example.# ##
21f0: 52 65 6d 6f 76 65 20 65 76 65 72 79 74 68 69 6e Remove everythin
2200: 67 20 75 70 20 74 6f 20 74 68 65 20 6c 61 73 74 g up to the last
2210: 20 2f 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 /.[requirements
2220: 5d 0a 6d 6f 64 65 20 69 74 65 6d 77 61 69 74 0a ].mode itemwait.
2230: 23 20 69 74 65 6d 6d 61 70 20 3c 69 74 65 6d 20 # itemmap <item
2240: 70 61 74 74 65 72 6e 20 66 6f 72 20 74 68 69 73 pattern for this
2250: 20 74 65 73 74 3e 20 3c 6e 6f 74 68 69 6e 67 20 test> <nothing
2260: 68 65 72 65 20 69 6e 64 69 63 61 74 65 73 20 72 here indicates r
2270: 65 6d 6f 76 61 6c 3e 0a 69 74 65 6d 6d 61 70 20 emoval>.itemmap
2280: 2e 2a 2f 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .*/.------------
2290: 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 78 61 6d 70 6c -------...exampl
22a0: 65 20 72 65 70 6c 61 63 69 6e 67 20 70 61 72 74 e replacing part
22b0: 20 6f 66 20 69 74 65 6d 6d 61 70 20 66 6f 72 20 of itemmap for
22c0: 28 65 67 3a 20 69 74 65 6d 20 2b 66 6f 6f 2f 31 (eg: item +foo/1
22d0: 32 33 34 2b 20 77 69 6c 6c 20 69 6d 70 6c 79 20 234+ will imply
22e0: 77 61 69 74 6f 6e 27 73 20 69 74 65 6d 20 2b 62 waiton's item +b
22f0: 61 72 2f 31 32 33 34 2b 29 0a 2d 2d 2d 2d 2d 2d ar/1234+).------
2300: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 23 -------------..#
2310: 0a 23 20 23 23 20 45 78 61 6d 70 6c 65 0a 23 20 .# ## Example.#
2320: 23 23 20 52 65 70 6c 61 63 65 20 66 6f 6f 2f 20 ## Replace foo/
2330: 77 69 74 68 20 62 61 72 2f 0a 5b 72 65 71 75 69 with bar/.[requi
2340: 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 69 74 rements].mode it
2350: 65 6d 77 61 69 74 0a 23 20 69 74 65 6d 6d 61 70 emwait.# itemmap
2360: 20 3c 69 74 65 6d 20 70 61 74 74 65 72 6e 20 66 <item pattern f
2370: 6f 72 20 74 68 69 73 20 74 65 73 74 3e 20 20 3c or this test> <
2380: 69 74 65 6d 20 72 65 70 6c 61 63 65 6d 65 6e 74 item replacement
2390: 20 70 61 74 74 65 72 6e 20 66 6f 72 20 77 61 69 pattern for wai
23a0: 74 6f 6e 20 74 65 73 74 3e 0a 69 74 65 6d 6d 61 ton test>.itemma
23b0: 70 20 66 6f 6f 2f 20 62 61 72 2f 0a 0a 2d 2d 2d p foo/ bar/..---
23c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
23d0: 0a 0a 2e 65 78 61 6d 70 6c 65 20 66 6f 72 20 62 ...example for b
23e0: 61 63 6b 72 65 66 65 72 65 6e 63 65 20 28 65 67 ackreference (eg
23f0: 3a 20 69 74 65 6d 20 2b 66 6f 6f 32 33 2f 74 68 : item +foo23/th
2400: 75 64 2b 20 77 69 6c 6c 20 69 6d 70 6c 79 20 77 ud+ will imply w
2410: 61 69 74 6f 6e 27 73 20 69 74 65 6d 20 2b 6e 75 aiton's item +nu
2420: 6d 2d 32 33 2f 62 61 72 2f 74 68 75 64 2b 0a 2d m-23/bar/thud+.-
2430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2440: 2d 2d 0a 23 0a 23 20 23 23 20 45 78 61 6d 70 6c --.#.# ## Exampl
2450: 65 0a 23 20 23 23 20 63 61 6e 20 75 73 65 20 5c e.# ## can use \
2460: 7b 6e 75 6d 62 65 72 7d 20 69 6e 20 72 65 70 6c {number} in repl
2470: 61 63 65 6d 65 6e 74 20 70 61 74 74 65 72 6e 20 acement pattern
2480: 74 6f 20 62 61 63 6b 72 65 66 65 72 65 6e 63 65 to backreference
2490: 20 61 20 28 63 61 70 74 75 72 65 29 20 66 72 6f a (capture) fro
24a0: 6d 20 6d 61 74 63 68 69 6e 67 20 70 61 74 74 65 m matching patte
24b0: 72 6e 20 73 69 6d 69 6c 61 72 20 74 6f 20 73 65 rn similar to se
24c0: 64 20 6f 72 20 70 65 72 6c 0a 5b 72 65 71 75 69 d or perl.[requi
24d0: 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 69 74 rements].mode it
24e0: 65 6d 77 61 69 74 0a 23 20 69 74 65 6d 6d 61 70 emwait.# itemmap
24f0: 20 3c 69 74 65 6d 20 70 61 74 74 65 72 6e 20 66 <item pattern f
2500: 6f 72 20 74 68 69 73 20 74 65 73 74 3e 20 20 3c or this test> <
2510: 69 74 65 6d 20 72 65 70 6c 61 63 65 6d 65 6e 74 item replacement
2520: 20 70 61 74 74 65 72 6e 20 66 6f 72 20 77 61 69 pattern for wai
2530: 74 6f 6e 20 74 65 73 74 3e 0a 69 74 65 6d 6d 61 ton test>.itemma
2540: 70 20 66 6f 6f 28 5c 64 2b 29 2f 20 6e 75 6d 2d p foo(\d+)/ num-
2550: 5c 31 2f 62 61 72 2f 0a 0a 2d 2d 2d 2d 2d 2d 2d \1/bar/..-------
2560: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 ------------...e
2570: 78 61 6d 70 6c 65 20 6d 75 6c 74 69 70 6c 65 20 xample multiple
2580: 69 74 65 6d 6d 61 70 73 0a 2d 2d 2d 2d 2d 2d 2d itemmaps.-------
2590: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 23 20 ------------..#
25a0: 6d 75 6c 74 69 2d 6c 69 6e 65 3b 20 6d 61 74 63 multi-line; matc
25b0: 68 65 73 20 61 72 65 20 61 70 70 6c 69 65 64 20 hes are applied
25c0: 69 6e 20 74 68 65 20 6c 69 73 74 65 64 20 6f 72 in the listed or
25d0: 64 65 72 0a 23 20 54 68 65 20 66 6f 6c 6c 6f 77 der.# The follow
25e0: 69 6e 67 20 77 6f 75 6c 64 20 6d 61 70 3a 0a 23 ing would map:.#
25f0: 20 20 20 61 31 32 33 62 33 32 31 20 74 6f 20 62 a123b321 to b
2600: 33 32 31 66 6f 6f 61 31 32 33 20 74 68 65 6e 20 321fooa123 then
2610: 74 6f 20 33 32 31 66 6f 6f 61 31 32 33 70 0a 23 to 321fooa123p.#
2620: 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a .[requirements].
2630: 69 74 65 6d 6d 61 70 20 28 61 5c 64 2b 29 28 62 itemmap (a\d+)(b
2640: 5c 64 2b 29 20 5c 32 66 6f 6f 5c 31 0a 20 20 62 \d+) \2foo\1. b
2650: 28 2e 2a 29 20 5c 31 70 0a 2d 2d 2d 2d 2d 2d 2d (.*) \1p.-------
2660: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 0a 43 ------------...C
2670: 6f 6d 70 6c 65 78 20 6d 61 70 70 69 6e 67 0a 5e omplex mapping.^
2680: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 43 ^^^^^^^^^^^^^^.C
2690: 6f 6d 70 6c 65 78 20 6d 61 70 70 69 6e 67 73 20 omplex mappings
26a0: 63 61 6e 20 62 65 20 68 61 6e 64 6c 65 64 20 77 can be handled w
26b0: 69 74 68 20 61 20 73 65 70 61 72 61 74 65 20 5b ith a separate [
26c0: 69 74 65 6d 6d 61 70 5d 20 73 65 63 74 69 6f 6e itemmap] section
26d0: 20 28 69 6e 73 74 65 61 64 20 69 66 20 61 6e 20 (instead if an
26e0: 69 74 65 6d 6d 61 70 20 6c 69 6e 65 20 69 6e 20 itemmap line in
26f0: 74 68 65 20 5b 72 65 71 75 69 72 65 6d 65 6e 74 the [requirement
2700: 73 5d 20 73 65 63 74 69 6f 6e 29 0a 0a 45 61 63 s] section)..Eac
2710: 68 20 6c 69 6e 65 20 69 6e 20 61 6e 20 69 74 65 h line in an ite
2720: 6d 6d 61 70 20 73 65 63 74 69 6f 6e 20 73 74 61 mmap section sta
2730: 72 74 73 20 77 69 74 68 20 61 20 77 61 69 74 6f rts with a waito
2740: 6e 20 74 65 73 74 20 6e 61 6d 65 20 66 6f 6c 6c n test name foll
2750: 6f 77 65 64 20 62 79 20 61 6e 20 69 74 65 6d 6d owed by an itemm
2760: 61 70 20 65 78 70 72 65 73 73 69 6f 6e 0a 0a 2e ap expression...
2770: 65 67 3a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e eg: The followin
2780: 67 20 63 61 75 73 65 73 20 77 61 69 74 6f 6e 20 g causes waiton
2790: 74 65 73 74 20 41 20 69 74 65 6d 20 2b 62 61 72 test A item +bar
27a0: 2f 31 32 33 34 2b 20 74 6f 20 72 75 6e 20 77 68 /1234+ to run wh
27b0: 65 6e 20 6f 75 72 20 74 65 73 74 27 73 20 2b 66 en our test's +f
27c0: 6f 6f 2f 31 32 33 34 2b 20 69 74 65 6d 20 69 73 oo/1234+ item is
27d0: 20 72 65 71 75 65 73 74 65 64 20 61 73 20 77 65 requested as we
27e0: 6c 6c 20 61 73 20 63 61 75 73 69 6e 67 20 77 61 ll as causing wa
27f0: 69 74 6f 6e 20 74 65 73 74 20 42 27 73 20 2b 62 iton test B's +b
2800: 6c 61 68 2b 20 69 74 65 6d 20 74 6f 20 72 75 6e lah+ item to run
2810: 20 77 68 65 6e 20 6f 75 72 20 74 65 73 74 27 73 when our test's
2820: 20 2b 73 74 75 66 66 2f 62 6c 61 68 2b 20 69 74 +stuff/blah+ it
2830: 65 6d 20 69 73 20 72 65 71 75 65 73 74 65 64 0a em is requested.
2840: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
2850: 69 74 65 6d 6d 61 70 5d 0a 41 20 66 6f 6f 2f 20 itemmap].A foo/
2860: 62 61 72 2f 0a 42 20 73 74 75 66 66 2f 0a 2d 2d bar/.B stuff/.--
2870: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 0a 43 ------------...C
2880: 6f 6d 70 6c 65 78 20 6d 61 70 70 69 6e 67 20 65 omplex mapping e
2890: 78 61 6d 70 6c 65 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e xample.^^^^^^^^^
28a0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a ^^^^^^^^^^^^^^..
28b0: 0a 0a 2f 2f 20 69 6d 61 67 65 3a 3a 69 74 65 6d ..// image::item
28c0: 6d 61 70 2e 70 6e 67 5b 5d 0a 69 6d 61 67 65 3a map.png[].image:
28d0: 3a 63 6f 6d 70 6c 65 78 2d 69 74 65 6d 6d 61 70 :complex-itemmap
28e0: 2e 70 6e 67 5b 5d 0a 0a 0a 57 65 20 61 63 63 6f .png[]...We acco
28f0: 6d 70 6c 69 73 68 20 74 68 69 73 20 62 79 20 63 mplish this by c
2900: 6f 6e 66 69 67 75 72 69 6e 67 20 74 68 65 20 74 onfiguring the t
2910: 65 73 74 63 6f 6e 66 69 67 73 20 6f 66 20 6f 75 estconfigs of ou
2920: 72 20 74 65 73 74 73 20 43 20 44 20 61 6e 64 20 r tests C D and
2930: 45 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 0a 2e E as follows:...
2940: 54 65 73 74 63 6f 6e 66 69 67 20 66 6f 72 20 54 Testconfig for T
2950: 65 73 74 20 45 20 68 61 73 0a 2d 2d 2d 2d 2d 2d est E has.------
2960: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2970: 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a .[requirements].
2980: 77 61 69 74 6f 6e 20 43 0a 69 74 65 6d 6d 61 70 waiton C.itemmap
2990: 20 28 5c 64 2b 29 2f 72 65 73 20 5c 31 2f 62 62 (\d+)/res \1/bb
29a0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
29b0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 54 65 73 74 63 6f -------...Testco
29c0: 6e 66 69 67 20 66 6f 72 20 54 65 73 74 20 44 20 nfig for Test D
29d0: 68 61 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d has.------------
29e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 ----------.[requ
29f0: 69 72 65 6d 65 6e 74 73 5d 0a 77 61 69 74 6f 6e irements].waiton
2a00: 20 43 0a 69 74 65 6d 6d 61 70 20 28 5c 64 2b 29 C.itemmap (\d+)
2a10: 2f 72 65 73 20 5c 31 2f 61 61 0a 2d 2d 2d 2d 2d /res \1/aa.-----
2a20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2a30: 2d 0a 0a 2e 54 65 73 74 63 6f 6e 66 69 67 20 66 -...Testconfig f
2a40: 6f 72 20 54 65 73 74 20 43 20 68 61 73 0a 2d 2d or Test C has.--
2a50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2a60: 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e ----.[requiremen
2a70: 74 73 5d 0a 77 61 69 74 6f 6e 20 41 20 42 0a 0a ts].waiton A B..
2a80: 5b 69 74 65 6d 6d 61 70 5d 0a 41 20 28 5c 64 2b [itemmap].A (\d+
2a90: 29 2f 61 61 20 61 61 2f 5c 31 0a 42 20 28 5c 64 )/aa aa/\1.B (\d
2aa0: 2b 29 2f 62 62 20 62 62 2f 5c 31 0a 2d 2d 2d 2d +)/bb bb/\1.----
2ab0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2ac0: 2d 2d 0a 0a 2e 54 65 73 74 63 6f 6e 66 69 67 73 --...Testconfigs
2ad0: 20 66 6f 72 20 54 65 73 74 20 42 20 61 6e 64 20 for Test B and
2ae0: 54 65 73 74 20 41 20 68 61 76 65 20 6e 6f 20 77 Test A have no w
2af0: 61 69 74 6f 6e 20 6f 72 20 69 74 65 6d 6d 61 70 aiton or itemmap
2b00: 20 63 6f 6e 66 69 67 75 72 65 64 0a 2d 2d 2d 2d configured.----
2b10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
2b20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2b30: 2d 2d 2d 0a 0a 2e 57 61 6c 6b 20 74 68 72 6f 75 ---...Walk throu
2b40: 67 68 20 6f 6e 65 20 69 74 65 6d 20 2d 2d 20 77 gh one item -- w
2b50: 65 20 77 61 6e 74 20 74 68 65 20 66 6f 6c 6c 6f e want the follo
2b60: 77 69 6e 67 20 74 6f 20 68 61 70 70 65 6e 20 66 wing to happen f
2b70: 6f 72 20 74 65 73 74 70 61 74 74 20 2b 44 2f 31 or testpatt +D/1
2b80: 2f 72 65 73 2b 20 28 73 65 65 20 62 6c 75 65 20 /res+ (see blue
2b90: 62 6f 78 65 73 20 69 6e 20 63 6f 6d 70 6c 65 78 boxes in complex
2ba0: 20 69 74 65 6d 6d 61 70 69 6e 67 20 66 69 67 75 itemmaping figu
2bb0: 72 65 20 61 62 6f 76 65 29 3a 0a 0a 2e 20 65 67 re above):... eg
2bc0: 20 66 72 6f 6d 20 63 6f 6d 6d 61 6e 64 20 6c 69 from command li
2bd0: 6e 65 20 2b 6d 65 67 61 74 65 73 74 20 2d 72 75 ne +megatest -ru
2be0: 6e 20 2d 74 65 73 74 70 61 74 74 20 44 2f 31 2f n -testpatt D/1/
2bf0: 72 65 73 20 2d 74 61 72 67 65 74 20 6d 79 74 61 res -target myta
2c00: 72 67 65 74 20 2d 72 75 6e 6e 61 6d 65 20 6d 79 rget -runname my
2c10: 72 75 6e 6e 61 6d 65 2b 0a 2e 20 46 75 6c 6c 20 runname+.. Full
2c20: 6c 69 73 74 20 74 6f 20 62 65 20 72 75 6e 20 69 list to be run i
2c30: 73 20 6e 6f 77 3a 20 2b 44 2f 31 2f 72 65 73 2b s now: +D/1/res+
2c40: 0a 2e 20 54 65 73 74 20 44 20 68 61 73 20 61 20 .. Test D has a
2c50: 77 61 69 74 6f 6e 20 2d 20 74 65 73 74 20 43 2e waiton - test C.
2c60: 20 20 54 65 73 74 20 44 27 73 20 69 74 65 6d 6d Test D's itemm
2c70: 61 70 20 72 75 6c 65 20 2b 69 74 65 6d 6d 61 70 ap rule +itemmap
2c80: 20 28 5c 64 26 70 6c 75 73 3b 29 2f 72 65 73 20 (\d+)/res
2c90: 5c 31 2f 61 61 2b 20 2d 3e 20 20 63 61 75 73 65 \1/aa+ -> cause
2ca0: 73 20 2b 43 2f 31 2f 61 61 2b 20 74 6f 20 72 75 s +C/1/aa+ to ru
2cb0: 6e 20 62 65 66 6f 72 65 20 2b 44 2f 31 2f 72 65 n before +D/1/re
2cc0: 73 2b 0a 2e 20 46 75 6c 6c 20 6c 69 73 74 20 74 s+.. Full list t
2cd0: 6f 20 62 65 20 72 75 6e 20 69 73 20 6e 6f 77 3a o be run is now:
2ce0: 20 2b 44 2f 31 2f 72 65 73 2b 2c 20 2b 43 2f 31 +D/1/res+, +C/1
2cf0: 2f 61 61 2b 0a 2e 20 54 65 73 74 20 43 20 77 61 /aa+.. Test C wa
2d00: 73 20 61 20 77 61 69 74 6f 6e 20 2d 20 74 65 73 s a waiton - tes
2d10: 74 20 41 2e 20 54 65 73 74 20 43 27 73 20 72 75 t A. Test C's ru
2d20: 6c 65 20 2b 41 20 28 5c 64 26 70 6c 75 73 3b 29 le +A (\d+)
2d30: 2f 61 61 20 61 61 2f 5c 31 2b 20 2d 3e 20 63 61 /aa aa/\1+ -> ca
2d40: 75 73 65 73 20 2b 41 2f 61 61 2f 31 2b 20 74 6f uses +A/aa/1+ to
2d50: 20 72 75 6e 20 62 65 66 6f 72 65 20 2b 43 2f 31 run before +C/1
2d60: 2f 61 61 2b 0a 2e 20 46 75 6c 6c 20 6c 69 73 74 /aa+.. Full list
2d70: 20 74 6f 20 62 65 20 72 75 6e 20 69 73 20 6e 6f to be run is no
2d80: 77 3a 20 2b 44 2f 31 2f 72 65 73 2b 2c 20 2b 43 w: +D/1/res+, +C
2d90: 2f 31 2f 61 61 2b 2c 20 2b 41 2f 61 61 2f 31 2b /1/aa+, +A/aa/1+
2da0: 0a 2e 20 54 65 73 74 20 41 20 68 61 73 20 6e 6f .. Test A has no
2db0: 20 77 61 69 74 6f 6e 73 2e 20 20 41 6c 6c 20 77 waitons. All w
2dc0: 61 69 74 6f 6e 73 20 6f 66 20 61 6c 6c 20 74 65 aitons of all te
2dd0: 73 74 73 20 69 6e 20 66 75 6c 6c 20 6c 69 73 74 sts in full list
2de0: 20 68 61 76 65 20 62 65 65 6e 20 70 72 6f 63 65 have been proce
2df0: 73 73 65 64 2e 20 20 46 75 6c 6c 20 6c 69 73 74 ssed. Full list
2e00: 20 69 73 20 66 69 6e 61 6c 69 7a 65 64 2e 0a 0a is finalized...
2e10: 0a 44 79 6e 61 6d 69 63 20 46 6c 6f 77 20 44 65 .Dynamic Flow De
2e20: 70 65 6e 64 65 6e 63 79 20 54 72 65 65 0a 5e 5e pendency Tree.^^
2e30: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
2e40: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2e 41 75 74 ^^^^^^^^^^...Aut
2e50: 6f 67 65 6e 65 72 61 74 69 6f 6e 20 77 61 69 74 ogeneration wait
2e60: 6f 6e 20 6c 69 73 74 20 66 6f 72 20 64 79 6e 61 on list for dyna
2e70: 6d 69 63 20 66 6c 6f 77 20 64 65 70 65 6e 64 65 mic flow depende
2e80: 6e 63 79 20 74 72 65 65 73 0a 2d 2d 2d 2d 2d 2d ncy trees.------
2e90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 -------------.[r
2ea0: 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 23 20 57 equirements].# W
2eb0: 69 74 68 20 61 20 74 6f 70 6c 65 76 65 6c 20 74 ith a toplevel t
2ec0: 65 73 74 20 79 6f 75 20 6d 61 79 20 77 69 73 68 est you may wish
2ed0: 20 74 6f 20 67 65 6e 65 72 61 74 65 20 79 6f 75 to generate you
2ee0: 72 20 6c 69 73 74 20 0a 23 20 6f 66 20 74 65 73 r list .# of tes
2ef0: 74 73 20 74 6f 20 72 75 6e 20 64 79 6e 61 6d 69 ts to run dynami
2f00: 63 61 6c 6c 79 0a 23 0a 77 61 69 74 6f 6e 20 23 cally.#.waiton #
2f10: 7b 73 68 65 6c 6c 20 67 65 74 2d 76 61 6c 69 64 {shell get-valid
2f20: 2d 74 65 73 74 73 2d 74 6f 2d 72 75 6e 2e 73 68 -tests-to-run.sh
2f30: 7d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d }.--------------
2f40: 2d 2d 2d 2d 2d 0a 0a 52 75 6e 20 74 69 6d 65 20 -----..Run time
2f50: 6c 69 6d 69 74 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e limit.^^^^^^^^^^
2f60: 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^^^..----------
2f70: 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 -------.[require
2f80: 6d 65 6e 74 73 5d 0a 72 75 6e 74 69 6d 65 6c 69 ments].runtimeli
2f90: 6d 20 31 68 20 32 6d 20 33 73 20 20 23 20 74 68 m 1h 2m 3s # th
2fa0: 69 73 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 is will automati
2fb0: 63 61 6c 6c 79 20 6b 69 6c 6c 20 74 68 65 20 74 cally kill the t
2fc0: 65 73 74 20 69 66 20 69 74 20 72 75 6e 73 20 66 est if it runs f
2fd0: 6f 72 20 6d 6f 72 65 20 74 68 61 6e 20 31 68 20 or more than 1h
2fe0: 32 6d 20 61 6e 64 20 33 73 0a 2d 2d 2d 2d 2d 2d 2m and 3s.------
2ff0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 -----------..Ski
3000: 70 0a 5e 5e 5e 5e 0a 0a 41 20 74 65 73 74 20 77 p.^^^^..A test w
3010: 69 74 68 20 61 20 73 6b 69 70 20 73 65 63 74 69 ith a skip secti
3020: 6f 6e 20 77 69 6c 6c 20 63 6f 6e 64 69 74 69 6f on will conditio
3030: 6e 61 6c 20 73 6b 69 70 20 72 75 6e 6e 69 6e 67 nal skip running
3040: 2e 0a 0a 2e 53 6b 69 70 20 73 65 63 74 69 6f 6e ....Skip section
3050: 20 65 78 61 6d 70 6c 65 0a 2d 2d 2d 2d 2d 2d 2d example.-------
3060: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 6b 69 70 ----------.[skip
3070: 5d 0a 70 72 65 76 72 75 6e 6e 69 6e 67 20 78 0a ].prevrunning x.
3080: 23 20 72 75 6e 64 65 6c 61 79 20 33 30 6d 20 31 # rundelay 30m 1
3090: 35 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 5s.-------------
30a0: 2d 2d 2d 2d 0a 0a 53 6b 69 70 20 6f 6e 20 53 74 ----..Skip on St
30b0: 69 6c 6c 2d 72 75 6e 6e 69 6e 67 20 54 65 73 74 ill-running Test
30c0: 73 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e s.^^^^^^^^^^^^^^
30d0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2d ^^^^^^^^^^^^^..-
30e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
30f0: 0a 23 20 4e 42 2f 2f 20 49 66 20 74 68 65 20 70 .# NB// If the p
3100: 72 65 76 72 75 6e 6e 69 6e 67 20 6c 69 6e 65 20 revrunning line
3110: 65 78 69 73 74 73 20 77 69 74 68 20 2a 61 6e 79 exists with *any
3120: 2a 20 76 61 6c 75 65 20 74 68 65 20 74 65 73 74 * value the test
3130: 20 77 69 6c 6c 0a 23 20 61 75 74 6f 6d 61 74 69 will.# automati
3140: 63 61 6c 6c 79 20 53 4b 49 50 20 69 66 20 74 68 cally SKIP if th
3150: 65 20 73 61 6d 65 2d 6e 61 6d 65 64 20 74 65 73 e same-named tes
3160: 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 52 t is currently R
3170: 55 4e 4e 49 4e 47 2e 20 54 68 65 0a 23 20 22 78 UNNING. The.# "x
3180: 22 20 63 61 6e 20 62 65 20 61 6e 79 20 73 74 72 " can be any str
3190: 69 6e 67 2e 20 43 6f 6d 6d 65 6e 74 20 6f 75 74 ing. Comment out
31a0: 20 74 68 65 20 70 72 65 76 72 75 6e 6e 69 6e 67 the prevrunning
31b0: 20 6c 69 6e 65 20 74 6f 20 74 75 72 6e 20 6f 66 line to turn of
31c0: 66 0a 23 20 73 6b 69 70 2e 0a 0a 5b 73 6b 69 70 f.# skip...[skip
31d0: 5d 0a 70 72 65 76 72 75 6e 6e 69 6e 67 20 78 0a ].prevrunning x.
31e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
31f0: 2d 0a 0a 53 6b 69 70 20 69 66 20 61 20 46 69 6c -..Skip if a Fil
3200: 65 20 45 78 69 73 74 73 0a 5e 5e 5e 5e 5e 5e 5e e Exists.^^^^^^^
3210: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a ^^^^^^^^^^^^^^..
3220: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3230: 2d 0a 5b 73 6b 69 70 5d 0a 66 69 6c 65 65 78 69 -.[skip].fileexi
3240: 73 74 73 20 2f 70 61 74 68 2f 74 6f 2f 61 2f 66 sts /path/to/a/f
3250: 69 6c 65 20 23 20 73 6b 69 70 20 69 66 20 2f 70 ile # skip if /p
3260: 61 74 68 2f 74 6f 2f 61 2f 66 69 6c 65 20 65 78 ath/to/a/file ex
3270: 69 73 74 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ists.-----------
3280: 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 70 20 69 66 20 ------..Skip if
3290: 74 65 73 74 20 72 61 6e 20 6d 6f 72 65 20 72 65 test ran more re
32a0: 63 65 6e 74 6c 79 20 74 68 61 6e 20 73 70 65 63 cently than spec
32b0: 69 66 69 65 64 20 74 69 6d 65 0a 5e 5e 5e 5e 5e ified time.^^^^^
32c0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
32d0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
32e0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2e ^^^^^^^^^^^^^...
32f0: 53 6b 69 70 20 69 66 20 74 68 69 73 20 74 65 73 Skip if this tes
3300: 74 20 68 61 73 20 62 65 65 6e 20 72 75 6e 20 69 t has been run i
3310: 6e 20 74 68 65 20 70 61 73 74 20 66 69 66 74 65 n the past fifte
3320: 65 6e 20 6d 69 6e 75 74 65 73 20 61 6e 64 20 31 en minutes and 1
3330: 35 20 73 65 63 6f 6e 64 73 2e 0a 2d 2d 2d 2d 2d 5 seconds..-----
3340: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 6b ------------.[sk
3350: 69 70 5d 0a 72 75 6e 64 65 6c 61 79 20 31 35 6d ip].rundelay 15m
3360: 20 31 35 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 15s.-----------
3370: 2d 2d 2d 2d 2d 2d 0a 0a 44 69 73 6b 73 0a 5e 5e ------..Disks.^^
3380: 5e 5e 5e 0a 0a 41 20 64 69 73 6b 73 20 73 65 63 ^^^..A disks sec
3390: 74 69 6f 6e 20 69 6e 20 74 65 73 74 63 6f 6e 66 tion in testconf
33a0: 69 67 20 77 69 6c 6c 20 6f 76 65 72 72 69 64 65 ig will override
33b0: 20 74 68 65 20 64 69 73 6b 73 20 73 65 63 74 69 the disks secti
33c0: 6f 6e 20 69 6e 0a 6d 65 67 61 74 65 73 74 2e 63 on in.megatest.c
33d0: 6f 6e 66 69 67 2e 20 54 68 69 73 20 63 61 6e 20 onfig. This can
33e0: 62 65 20 75 73 65 64 20 74 6f 20 61 6c 6c 6f 63 be used to alloc
33f0: 61 74 65 20 64 69 73 6b 73 20 6f 6e 20 61 20 70 ate disks on a p
3400: 65 72 2d 74 65 73 74 20 6f 72 20 70 65 72 20 69 er-test or per i
3410: 74 65 6d 0a 62 61 73 69 73 2e 0a 0a 43 6f 6e 74 tem.basis...Cont
3420: 72 6f 6c 6c 65 64 20 77 61 69 76 65 72 20 70 72 rolled waiver pr
3430: 6f 70 61 67 61 74 69 6f 6e 0a 5e 5e 5e 5e 5e 5e opagation.^^^^^^
3440: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3450: 5e 5e 5e 5e 5e 5e 5e 0a 0a 49 66 20 74 65 73 74 ^^^^^^^..If test
3460: 20 69 73 20 46 41 49 4c 20 61 6e 64 20 70 72 65 is FAIL and pre
3470: 76 69 6f 75 73 20 74 65 73 74 20 69 6e 20 72 75 vious test in ru
3480: 6e 20 77 69 74 68 20 73 61 6d 65 20 4d 54 5f 54 n with same MT_T
3490: 41 52 47 45 54 20 69 73 20 57 41 49 56 45 44 20 ARGET is WAIVED
34a0: 74 68 65 6e 20 61 70 70 6c 79 20 74 68 65 20 66 then apply the f
34b0: 6f 6c 6c 6f 77 69 6e 67 20 72 75 6c 65 73 20 66 ollowing rules f
34c0: 72 6f 6d 20 74 68 65 20 74 65 73 74 63 6f 6e 66 rom the testconf
34d0: 69 67 3a 0a 49 66 20 61 20 77 61 69 76 65 72 20 ig:.If a waiver
34e0: 63 68 65 63 6b 20 69 73 20 73 70 65 63 69 66 69 check is specifi
34f0: 65 64 20 69 6e 20 74 68 65 20 74 65 73 74 63 6f ed in the testco
3500: 6e 66 69 67 20 61 70 70 6c 79 20 74 68 65 20 63 nfig apply the c
3510: 68 65 63 6b 20 61 6e 64 20 69 66 20 69 74 20 70 heck and if it p
3520: 61 73 73 65 73 20 74 68 65 6e 20 73 65 74 20 74 asses then set t
3530: 68 69 73 20 46 41 49 4c 20 74 6f 20 57 41 49 56 his FAIL to WAIV
3540: 45 44 0a 0a 57 61 69 76 65 72 20 63 68 65 63 6b ED..Waiver check
3550: 20 68 61 73 20 74 77 6f 20 70 61 72 74 73 2c 20 has two parts,
3560: 31 29 20 61 20 6c 69 73 74 20 6f 66 20 77 61 69 1) a list of wai
3570: 76 65 72 2c 20 72 75 6c 65 6e 61 6d 65 2c 20 66 ver, rulename, f
3580: 69 6c 65 70 61 74 74 65 72 6e 73 20 61 6e 64 20 ilepatterns and
3590: 32 29 20 74 68 65 20 72 75 6c 65 6e 61 6d 65 20 2) the rulename
35a0: 73 63 72 69 70 74 20 73 70 65 63 20 28 6e 6f 74 script spec (not
35b0: 65 20 74 68 61 74 20 22 64 69 66 66 22 20 61 6e e that "diff" an
35c0: 64 20 22 6c 6f 67 70 72 6f 22 20 61 72 65 20 70 d "logpro" are p
35d0: 72 65 64 65 66 69 6e 65 64 29 0a 0a 2d 2d 2d 2d redefined)..----
35e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 23 -------------.##
35f0: 23 23 23 23 20 45 58 41 4d 50 4c 45 20 46 52 4f #### EXAMPLE FRO
3600: 4d 20 74 65 73 74 63 6f 6e 66 69 67 20 23 23 23 M testconfig ###
3610: 23 23 23 23 23 23 0a 23 20 6d 61 74 63 68 69 6e ######.# matchin
3620: 67 20 66 69 6c 65 28 73 29 20 77 69 6c 6c 20 62 g file(s) will b
3630: 65 20 64 69 66 66 27 64 20 77 69 74 68 20 70 72 e diff'd with pr
3640: 65 76 69 6f 75 73 20 72 75 6e 20 61 6e 64 20 6c evious run and l
3650: 6f 67 70 72 6f 20 61 70 70 6c 69 65 64 0a 23 20 ogpro applied.#
3660: 69 66 20 50 41 53 53 20 6f 72 20 57 41 52 4e 20 if PASS or WARN
3670: 72 65 73 75 6c 74 20 66 72 6f 6d 20 6c 6f 67 70 result from logp
3680: 72 6f 20 74 68 65 6e 20 57 41 49 56 45 52 20 73 ro then WAIVER s
3690: 74 61 74 65 20 69 73 20 73 65 74 0a 23 0a 5b 77 tate is set.#.[w
36a0: 61 69 76 65 72 73 5d 0a 23 20 6c 6f 67 70 72 6f aivers].# logpro
36b0: 5f 66 69 6c 65 20 20 20 20 72 75 6c 65 6e 61 6d _file rulenam
36c0: 65 20 20 20 20 20 20 69 6e 70 75 74 5f 67 6c 6f e input_glo
36d0: 62 0a 77 61 69 76 65 72 5f 31 20 20 20 20 20 20 b.waiver_1
36e0: 20 20 20 6c 6f 67 70 72 6f 20 20 20 20 20 20 20 logpro
36f0: 20 6c 6f 6f 6b 69 74 74 6d 70 2e 6c 6f 67 0a 0a lookittmp.log..
3700: 5b 77 61 69 76 65 72 5f 72 75 6c 65 73 5d 0a 0a [waiver_rules]..
3710: 23 20 54 68 69 73 20 62 75 69 6c 74 69 6e 20 72 # This builtin r
3720: 75 6c 65 20 69 73 20 74 68 65 20 64 65 66 61 75 ule is the defau
3730: 6c 74 20 69 66 20 74 68 65 72 65 20 69 73 20 6e lt if there is n
3740: 6f 20 3c 77 61 69 76 65 72 6e 61 6d 65 3e 2e 6c o <waivername>.l
3750: 6f 67 70 72 6f 20 66 69 6c 65 0a 23 20 64 69 66 ogpro file.# dif
3760: 66 20 20 20 64 69 66 66 20 25 66 69 6c 65 31 25 f diff %file1%
3770: 20 25 66 69 6c 65 32 25 0a 0a 23 20 54 68 69 73 %file2%..# This
3780: 20 62 75 69 6c 74 69 6e 20 72 75 6c 65 20 69 73 builtin rule is
3790: 20 61 70 70 6c 69 65 64 20 69 66 20 61 20 3c 77 applied if a <w
37a0: 61 69 76 65 72 6e 61 6d 65 3e 2e 6c 6f 67 70 72 aivername>.logpr
37b0: 6f 20 66 69 6c 65 20 65 78 69 73 74 73 0a 23 20 o file exists.#
37c0: 6c 6f 67 70 72 6f 20 64 69 66 66 20 25 66 69 6c logpro diff %fil
37d0: 65 31 25 20 25 66 69 6c 65 32 25 20 7c 20 6c 6f e1% %file2% | lo
37e0: 67 70 72 6f 20 25 77 61 69 76 65 72 6e 61 6d 65 gpro %waivername
37f0: 25 2e 6c 6f 67 70 72 6f 20 25 77 61 69 76 65 72 %.logpro %waiver
3800: 6e 61 6d 65 25 2e 68 74 6d 6c 0a 2d 2d 2d 2d 2d name%.html.-----
3810: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 45 7a ------------..Ez
3820: 73 74 65 70 73 0a 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e steps.~~~~~~~...
3830: 45 78 61 6d 70 6c 65 20 65 7a 73 74 65 70 73 20 Example ezsteps
3840: 77 69 74 68 20 6c 6f 67 70 72 6f 20 72 75 6c 65 with logpro rule
3850: 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d s.--------------
3860: 2d 2d 2d 0a 5b 65 7a 73 74 65 70 73 5d 0a 6c 6f ---.[ezsteps].lo
3870: 6f 6b 69 74 74 6d 70 20 20 20 6c 73 20 2f 74 6d okittmp ls /tm
3880: 70 0a 0a 5b 6c 6f 67 70 72 6f 5d 0a 6c 6f 6f 6b p..[logpro].look
3890: 69 74 74 6d 70 20 3b 3b 20 4e 6f 74 65 3a 20 63 ittmp ;; Note: c
38a0: 6f 6e 66 69 67 20 66 69 6c 65 20 66 6f 72 6d 61 onfig file forma
38b0: 74 20 73 75 70 70 6f 72 74 73 20 6d 75 6c 74 69 t supports multi
38c0: 2d 6c 69 6e 65 20 65 6e 74 72 69 65 73 20 77 68 -line entries wh
38d0: 65 72 65 20 6c 65 61 64 69 6e 67 20 77 68 69 74 ere leading whit
38e0: 65 73 70 61 63 65 20 69 73 20 72 65 6d 6f 76 65 espace is remove
38f0: 64 20 66 72 6f 6d 20 65 61 63 68 20 6c 69 6e 65 d from each line
3900: 0a 20 20 3b 3b 20 20 20 20 20 61 20 62 6c 61 6e . ;; a blan
3910: 6b 20 6c 69 6e 65 20 69 6e 64 69 63 61 74 65 73 k line indicates
3920: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
3930: 62 6c 6f 63 6b 20 6f 66 20 74 65 78 74 20 0a 20 block of text .
3940: 20 28 65 78 70 65 63 74 3a 72 65 71 75 69 72 65 (expect:require
3950: 64 20 69 6e 20 22 4c 6f 67 46 69 6c 65 42 6f 64 d in "LogFileBod
3960: 79 22 20 3e 20 30 20 22 41 20 66 69 6c 65 20 6e y" > 0 "A file n
3970: 61 6d 65 20 74 68 61 74 20 73 68 6f 75 6c 64 20 ame that should
3980: 6e 65 76 65 72 20 65 78 69 73 74 21 22 20 23 2f never exist!" #/
3990: 54 68 69 73 20 69 73 20 61 20 61 77 66 75 6c 6c This is a awfull
39a0: 79 20 73 74 75 70 69 64 20 66 69 6c 65 20 6e 61 y stupid file na
39b0: 6d 65 20 74 68 61 74 20 73 68 6f 75 6c 64 20 6e me that should n
39c0: 65 76 65 72 20 62 65 20 66 6f 75 6e 64 20 69 6e ever be found in
39d0: 20 74 68 65 20 74 65 6d 70 20 64 69 72 2f 29 0a the temp dir/).
39e0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
39f0: 2d 2d 0a 0a 54 6f 20 74 72 61 6e 73 66 65 72 20 --..To transfer
3a00: 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 the environment
3a10: 74 6f 20 74 68 65 20 6e 65 78 74 20 73 74 65 70 to the next step
3a20: 20 79 6f 75 20 63 61 6e 20 64 6f 20 74 68 65 20 you can do the
3a30: 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 0a 2d 2d 2d 2d following:..----
3a40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3a50: 2d 2d 2d 2d 2d 2d 2d 2d 0a 24 4d 54 5f 4d 45 47 --------.$MT_MEG
3a60: 41 54 45 53 54 20 2d 65 6e 76 32 66 69 6c 65 20 ATEST -env2file
3a70: 2e 65 7a 73 74 65 70 73 2f 24 7b 73 74 65 70 6e .ezsteps/${stepn
3a80: 61 6d 65 7d 09 20 20 0a 2d 2d 2d 2d 2d 2d 2d 2d ame}. .--------
3a90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3aa0: 2d 2d 2d 2d 0a 0a 54 72 69 67 67 65 72 73 0a 7e ----..Triggers.~
3ab0: 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 20 79 6f 75 72 ~~~~~~~..In your
3ac0: 20 74 65 73 74 63 6f 6e 66 69 67 20 6f 72 20 6d testconfig or m
3ad0: 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 20 74 egatest.config t
3ae0: 72 69 67 67 65 72 73 20 63 61 6e 20 62 65 20 73 riggers can be s
3af0: 70 65 63 69 66 69 65 64 20 0a 0a 2d 2d 2d 2d 2d pecified ..-----
3b00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 74 72 ------------.[tr
3b10: 69 67 67 65 72 73 5d 0a 0a 23 20 43 61 6c 6c 20 iggers]..# Call
3b20: 73 63 72 69 70 74 20 72 75 6e 6e 69 6e 67 2e 73 script running.s
3b30: 68 20 77 68 65 6e 20 74 65 73 74 20 67 6f 65 73 h when test goes
3b40: 20 74 6f 20 73 74 61 74 65 3d 52 55 4e 4e 49 4e to state=RUNNIN
3b50: 47 2c 20 73 74 61 74 75 73 3d 50 41 53 53 0a 52 G, status=PASS.R
3b60: 55 4e 4e 49 4e 47 2f 50 41 53 53 20 72 75 6e 6e UNNING/PASS runn
3b70: 69 6e 67 2e 73 68 0a 0a 23 20 43 61 6c 6c 20 73 ing.sh..# Call s
3b80: 63 72 69 70 74 20 72 75 6e 6e 69 6e 67 2e 73 68 cript running.sh
3b90: 20 61 6e 79 20 74 69 6d 65 20 73 74 61 74 65 20 any time state
3ba0: 67 6f 65 73 20 74 6f 20 52 55 4e 4e 49 4e 47 0a goes to RUNNING.
3bb0: 52 55 4e 4e 49 4e 47 2f 20 72 75 6e 6e 69 6e 67 RUNNING/ running
3bc0: 2e 73 68 0a 0a 23 20 43 61 6c 6c 20 73 63 72 69 .sh..# Call scri
3bd0: 70 74 20 6f 6e 70 61 73 73 2e 73 68 20 61 6e 79 pt onpass.sh any
3be0: 20 74 69 6d 65 20 73 74 61 74 75 73 20 67 6f 65 time status goe
3bf0: 73 20 74 6f 20 50 41 53 53 0a 50 41 53 53 2f 20 s to PASS.PASS/
3c00: 6f 6e 70 61 73 73 2e 73 68 0a 2d 2d 2d 2d 2d 2d onpass.sh.------
3c10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 63 72 -----------..Scr
3c20: 69 70 74 73 20 63 61 6c 6c 65 64 20 77 69 6c 6c ipts called will
3c30: 20 68 61 76 65 3b 20 74 65 73 74 2d 69 64 20 74 have; test-id t
3c40: 65 73 74 2d 72 75 6e 64 69 72 20 74 72 69 67 67 est-rundir trigg
3c50: 65 72 20 74 65 73 74 2d 6e 61 6d 65 20 69 74 65 er test-name ite
3c60: 6d 2d 70 61 74 68 20 73 74 61 74 65 20 73 74 61 m-path state sta
3c70: 74 75 73 20 65 76 65 6e 74 2d 74 69 6d 65 2c 20 tus event-time,
3c80: 61 64 64 65 64 20 74 6f 20 74 68 65 20 63 6f 6d added to the com
3c90: 6d 61 6e 64 6c 69 6e 65 2e 0a 0a 48 49 4e 54 0a mandline...HINT.
3ca0: 0a 54 6f 20 73 74 61 72 74 20 61 6e 20 78 74 65 .To start an xte
3cb0: 72 6d 20 28 75 73 65 66 75 6c 20 66 6f 72 20 64 rm (useful for d
3cc0: 65 62 75 67 67 69 6e 67 29 2c 20 75 73 65 20 61 ebugging), use a
3cd0: 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 6c 69 command line li
3ce0: 6b 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ke the following
3cf0: 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d :..-------------
3d00: 2d 2d 2d 2d 0a 5b 74 72 69 67 67 65 72 73 5d 0a ----.[triggers].
3d10: 43 4f 4d 50 4c 45 54 45 44 2f 20 78 74 65 72 6d COMPLETED/ xterm
3d20: 20 2d 65 20 62 61 73 68 20 2d 73 20 2d 2d 20 0a -e bash -s -- .
3d30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3d40: 2d 0a 0a 4e 4f 54 45 3a 20 54 68 65 72 65 20 69 -..NOTE: There i
3d50: 73 20 61 20 74 72 61 69 6c 69 6e 67 20 73 70 61 s a trailing spa
3d60: 63 65 20 61 66 74 65 72 20 74 68 65 20 2d 2d 0a ce after the --.
3d70: 0a 54 68 65 72 65 20 61 72 65 20 61 20 6e 75 6d .There are a num
3d80: 62 65 72 20 6f 66 20 65 6e 76 69 72 6f 6e 6d 65 ber of environme
3d90: 6e 74 20 76 61 72 69 61 62 6c 65 73 20 61 76 61 nt variables ava
3da0: 69 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 74 72 ilable to the tr
3db0: 69 67 67 65 72 20 73 63 72 69 70 74 0a 62 75 74 igger script.but
3dc0: 20 73 69 6e 63 65 20 74 72 69 67 67 65 72 73 20 since triggers
3dd0: 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 69 6e can be called in
3de0: 20 76 61 72 69 6f 75 73 20 63 6f 6e 74 65 78 74 various context
3df0: 73 20 6e 6f 74 20 61 6c 6c 20 76 61 72 69 61 62 s not all variab
3e00: 6c 65 73 20 61 72 65 0a 61 76 61 69 6c 61 62 6c les are.availabl
3e10: 65 20 61 74 20 61 6c 6c 20 74 69 6d 65 73 2e 20 e at all times.
3e20: 54 68 65 20 74 72 69 67 67 65 72 20 73 63 72 69 The trigger scri
3e30: 70 74 20 73 68 6f 75 6c 64 20 63 68 65 63 6b 20 pt should check
3e40: 66 6f 72 20 74 68 65 20 76 61 72 69 61 62 6c 65 for the variable
3e50: 20 61 6e 64 0a 66 61 69 6c 20 67 72 61 63 65 66 and.fail gracef
3e60: 75 6c 6c 79 20 69 66 20 69 74 20 64 6f 65 73 6e ully if it doesn
3e70: 27 74 20 65 78 69 73 74 2e 0a 0a 2e 45 6e 76 69 't exist....Envi
3e80: 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 ronment variable
3e90: 73 20 76 69 73 69 62 6c 65 20 74 6f 20 74 68 65 s visible to the
3ea0: 20 74 72 69 67 67 65 72 20 73 63 72 69 70 74 0a trigger script.
3eb0: 5b 77 69 64 74 68 3d 22 39 30 25 22 2c 63 6f 6c [width="90%",col
3ec0: 73 3d 22 5e 2c 32 6d 22 2c 66 72 61 6d 65 3d 22 s="^,2m",frame="
3ed0: 74 6f 70 62 6f 74 22 2c 6f 70 74 69 6f 6e 73 3d topbot",options=
3ee0: 22 68 65 61 64 65 72 22 5d 0a 7c 3d 3d 3d 3d 3d "header"].|=====
3ef0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
3f00: 3d 0a 7c 56 61 72 69 61 62 6c 65 20 20 20 20 20 =.|Variable
3f10: 20 20 20 20 20 20 20 20 7c 20 50 75 72 70 6f 73 | Purpos
3f20: 65 20 20 20 20 20 20 20 20 20 20 20 20 0a 7c 20 e .|
3f30: 4d 54 5f 54 45 53 54 5f 52 55 4e 5f 44 49 52 20 MT_TEST_RUN_DIR
3f40: 20 20 20 20 7c 20 54 68 65 20 64 69 72 65 63 74 | The direct
3f50: 6f 72 79 20 77 68 65 72 65 20 4d 65 67 61 74 65 ory where Megate
3f60: 73 74 20 72 61 6e 20 74 68 69 73 20 74 65 73 74 st ran this test
3f70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
3f80: 20 20 20 0a 7c 20 4d 54 5f 43 4d 44 49 4e 46 4f .| MT_CMDINFO
3f90: 20 20 20 20 20 20 20 20 20 20 7c 20 45 6e 63 6f | Enco
3fa0: 64 65 64 20 63 6f 6d 6d 61 6e 64 20 64 61 74 61 ded command data
3fb0: 20 66 6f 72 20 74 68 65 20 74 65 73 74 20 20 20 for the test
3fc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
3fd0: 0a 7c 20 4d 54 5f 44 45 42 55 47 5f 4d 4f 44 45 .| MT_DEBUG_MODE
3fe0: 20 20 20 20 20 20 20 7c 20 55 73 65 64 20 74 6f | Used to
3ff0: 20 70 61 73 73 20 74 68 65 20 64 65 62 75 67 20 pass the debug
4000: 6d 6f 64 65 20 74 6f 20 6e 65 73 74 65 64 20 63 mode to nested c
4010: 61 6c 6c 73 20 74 6f 20 4d 65 67 61 74 65 73 74 alls to Megatest
4020: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4030: 20 20 20 0a 7c 20 4d 54 5f 52 55 4e 5f 41 52 45 .| MT_RUN_ARE
4040: 41 5f 48 4f 4d 45 20 20 20 20 7c 20 4d 65 67 61 A_HOME | Mega
4050: 74 65 73 74 20 68 6f 6d 65 20 61 72 65 61 20 0a test home area .
4060: 7c 20 4d 54 5f 54 45 53 54 53 55 49 54 45 4e 41 | MT_TESTSUITENA
4070: 4d 45 20 20 20 20 7c 20 54 68 65 20 6e 61 6d 65 ME | The name
4080: 20 6f 66 20 74 68 69 73 20 74 65 73 74 73 75 69 of this testsui
4090: 74 65 20 6f 72 20 61 72 65 61 20 20 20 20 20 20 te or area
40a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 0a 7c 20 .|
40b0: 4d 54 5f 54 45 53 54 5f 4e 41 4d 45 20 20 20 20 MT_TEST_NAME
40c0: 20 20 20 20 7c 20 54 68 65 20 6e 61 6d 65 20 6f | The name o
40d0: 66 20 74 68 69 73 20 74 65 73 74 0a 7c 20 4d 54 f this test.| MT
40e0: 5f 49 54 45 4d 5f 49 4e 46 4f 20 20 20 20 20 20 _ITEM_INFO
40f0: 20 20 7c 20 54 68 65 20 76 61 72 69 61 62 6c 65 | The variable
4100: 20 61 6e 64 20 76 61 6c 75 65 73 20 66 6f 72 20 and values for
4110: 74 68 65 20 74 65 73 74 20 69 74 65 6d 0a 7c 20 the test item.|
4120: 4d 54 5f 4d 45 47 41 54 45 53 54 20 20 20 20 20 MT_MEGATEST
4130: 20 20 20 20 7c 20 57 68 69 63 68 20 4d 65 67 61 | Which Mega
4140: 74 65 73 74 20 62 69 6e 61 72 79 20 69 73 20 62 test binary is b
4150: 65 69 6e 67 20 75 73 65 64 20 62 79 20 74 68 69 eing used by thi
4160: 73 20 61 72 65 61 0a 7c 20 4d 54 5f 54 41 52 47 s area.| MT_TARG
4170: 45 54 20 20 20 20 20 20 20 20 20 20 20 7c 20 54 ET | T
4180: 68 65 20 74 61 72 67 65 74 20 76 61 72 69 61 62 he target variab
4190: 6c 65 20 76 61 6c 75 65 73 2c 20 73 65 70 61 72 le values, separ
41a0: 61 74 65 64 20 62 79 20 27 2f 27 0a 7c 20 4d 54 ated by '/'.| MT
41b0: 5f 4c 49 4e 4b 54 52 45 45 20 20 20 20 20 20 20 _LINKTREE
41c0: 20 20 7c 20 54 68 65 20 62 61 73 65 20 6f 66 20 | The base of
41d0: 74 68 65 20 6c 69 6e 6b 20 74 72 65 65 20 77 68 the link tree wh
41e0: 65 72 65 20 61 6c 6c 20 72 75 6e 20 74 65 73 74 ere all run test
41f0: 73 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 0a 7c s can be found.|
4200: 20 4d 54 5f 49 54 45 4d 50 41 54 48 20 20 20 20 MT_ITEMPATH
4210: 20 20 20 20 20 7c 20 54 68 65 20 76 61 6c 75 65 | The value
4220: 73 20 6f 66 20 74 68 65 20 69 74 65 6d 20 70 61 s of the item pa
4230: 74 68 20 76 61 72 69 61 62 6c 65 73 2c 20 73 65 th variables, se
4240: 70 61 72 61 74 65 64 20 62 79 20 27 2f 27 0a 7c parated by '/'.|
4250: 20 4d 54 5f 52 55 4e 4e 41 4d 45 20 20 20 20 20 MT_RUNNAME
4260: 20 20 20 20 20 7c 20 54 68 65 20 6e 61 6d 65 20 | The name
4270: 6f 66 20 74 68 65 20 72 75 6e 0a 7c 3d 3d 3d 3d of the run.|====
4280: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
4290: 3d 3d 0a 0a 0a 4f 76 65 72 72 69 64 65 20 74 68 ==...Override th
42a0: 65 20 54 6f 70 6c 65 76 65 6c 20 48 54 4d 4c 20 e Toplevel HTML
42b0: 46 69 6c 65 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e File.~~~~~~~~~~~
42c0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
42d0: 7e 7e 7e 7e 0a 0a 4d 65 67 61 74 65 73 74 20 67 ~~~~..Megatest g
42e0: 65 6e 65 72 61 74 65 73 20 61 20 73 69 6d 70 6c enerates a simpl
42f0: 65 20 68 74 6d 6c 20 66 69 6c 65 20 73 75 6d 6d e html file summ
4300: 61 72 79 20 66 6f 72 20 74 6f 70 20 6c 65 76 65 ary for top leve
4310: 6c 20 74 65 73 74 73 20 6f 66 0a 69 74 65 72 61 l tests of.itera
4320: 74 65 64 20 74 65 73 74 73 2e 20 54 68 65 20 67 ted tests. The g
4330: 65 6e 65 72 61 74 69 6f 6e 20 63 61 6e 20 62 65 eneration can be
4340: 20 6f 76 65 72 72 69 64 64 65 6e 2e 20 4e 4f 54 overridden. NOT
4350: 45 3a 20 74 68 65 20 6f 75 74 70 75 74 20 6f 66 E: the output of
4360: 0a 74 68 65 20 73 63 72 69 70 74 20 69 73 20 63 .the script is c
4370: 61 70 74 75 72 65 64 20 66 72 6f 6d 20 73 74 64 aptured from std
4380: 6f 75 74 20 74 6f 20 63 72 65 61 74 65 20 74 68 out to create th
4390: 65 20 68 74 6d 6c 2e 0a 0a 0a 2e 46 6f 72 20 74 e html.....For t
43a0: 65 73 74 20 22 72 75 6e 66 69 72 73 74 22 20 6f est "runfirst" o
43b0: 76 65 72 72 69 64 65 20 74 68 65 20 74 6f 70 6c verride the topl
43c0: 65 76 65 6c 20 67 65 6e 65 72 61 74 69 6f 6e 20 evel generation
43d0: 77 69 74 68 20 61 20 73 63 72 69 70 74 20 22 6d with a script "m
43e0: 79 73 75 6d 6d 61 72 79 2e 73 68 22 0a 2d 2d 2d ysummary.sh".---
43f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 --------------.#
4400: 20 4f 76 65 72 72 69 64 65 20 74 68 65 20 72 6f Override the ro
4410: 6c 6c 75 70 20 66 6f 72 20 73 70 65 63 69 66 69 llup for specifi
4420: 63 20 74 65 73 74 73 0a 5b 74 65 73 74 72 6f 6c c tests.[testrol
4430: 6c 75 70 5d 0a 72 75 6e 66 69 72 73 74 20 6d 79 lup].runfirst my
4440: 73 75 6d 6d 61 72 79 2e 73 68 0a 2d 2d 2d 2d 2d summary.sh.-----
4450: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 72 ------------..Ar
4460: 63 68 69 76 69 6e 67 20 53 65 74 75 70 0a 2d 2d chiving Setup.--
4470: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 -------------..I
4480: 6e 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 n megatest.confi
4490: 67 20 61 64 64 20 74 68 65 20 66 6f 6c 6c 6f 77 g add the follow
44a0: 69 6e 67 20 73 65 63 74 69 6f 6e 73 3a 0a 0a 2e ing sections:...
44b0: 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 0a megatest.config.
44c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
44d0: 61 72 63 68 69 76 65 5d 0a 23 20 77 68 65 72 65 archive].# where
44e0: 20 74 6f 20 67 65 74 20 62 75 70 20 65 78 65 63 to get bup exec
44f0: 75 74 61 62 6c 65 0a 23 20 62 75 70 20 2f 70 61 utable.# bup /pa
4500: 74 68 2f 74 6f 2f 62 75 70 0a 0a 5b 61 72 63 68 th/to/bup..[arch
4510: 69 76 65 2d 64 69 73 6b 73 5d 0a 0a 23 20 41 72 ive-disks]..# Ar
4520: 63 68 69 76 65 73 20 77 69 6c 6c 20 62 65 20 6f chives will be o
4530: 72 67 61 6e 69 73 65 64 20 75 6e 64 65 72 20 74 rganised under t
4540: 68 65 73 65 20 70 61 74 68 73 20 6c 69 6b 65 20 hese paths like
4550: 74 68 69 73 3a 0a 23 20 20 3c 74 65 73 74 73 75 this:.# <testsu
4560: 69 74 65 3e 2f 3c 63 72 65 61 74 69 6f 6e 64 61 ite>/<creationda
4570: 74 65 3e 0a 23 20 57 69 74 68 69 6e 20 74 68 65 te>.# Within the
4580: 20 61 72 63 68 69 76 65 20 74 68 65 20 64 61 74 archive the dat
4590: 61 20 69 73 20 73 74 72 75 63 74 75 72 65 64 20 a is structured
45a0: 6c 69 6b 65 20 74 68 69 73 3a 0a 23 20 20 3c 74 like this:.# <t
45b0: 61 72 67 65 74 3e 2f 3c 72 75 6e 6e 61 6d 65 3e arget>/<runname>
45c0: 2f 3c 74 65 73 74 3e 2f 0a 61 72 63 68 69 76 65 /<test>/.archive
45d0: 30 20 2f 6d 66 73 2f 6d 79 61 72 63 68 69 76 65 0 /mfs/myarchive
45e0: 2d 64 61 74 61 2f 61 64 69 73 6b 31 0a 2d 2d 2d -data/adisk1.---
45f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 48 61 6e -----------..Han
4600: 64 6c 69 6e 67 20 45 6e 76 69 72 6f 6e 6d 65 6e dling Environmen
4610: 74 20 56 61 72 69 61 62 6c 65 73 0a 2d 2d 2d 2d t Variables.----
4620: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4630: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 74 20 69 ----------..It i
4640: 73 20 6f 66 74 65 6e 20 6e 65 63 65 73 73 61 72 s often necessar
4650: 79 20 74 6f 20 63 61 70 74 75 72 65 20 61 6e 64 y to capture and
4660: 20 6f 72 20 6d 61 6e 69 70 75 6c 61 74 65 20 65 or manipulate e
4670: 6e 76 69 72 6f 6e 6d 65 6e 74 0a 76 61 72 69 61 nvironment.varia
4680: 62 6c 65 73 2e 20 4d 65 67 61 74 65 73 74 20 68 bles. Megatest h
4690: 61 73 20 73 6f 6d 65 20 66 61 63 69 6c 69 74 69 as some faciliti
46a0: 65 73 20 62 75 69 6c 74 20 69 6e 20 74 6f 20 68 es built in to h
46b0: 65 6c 70 2e 0a 0a 43 61 70 74 75 72 65 20 76 61 elp...Capture va
46c0: 72 69 61 62 6c 65 73 0a 7e 7e 7e 7e 7e 7e 7e 7e riables.~~~~~~~~
46d0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 43 6f 6d 6d ~~~~~~~~~...Comm
46e0: 61 6e 64 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ands.-----------
46f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4700: 2d 2d 2d 0a 23 20 63 61 70 74 75 72 65 20 74 68 ---.# capture th
4710: 65 20 63 75 72 72 65 6e 74 20 65 6e 76 69 72 6f e current enviro
4720: 6d 65 6e 74 20 69 6e 74 6f 20 61 20 64 62 20 63 ment into a db c
4730: 61 6c 6c 65 64 20 65 6e 76 64 61 74 2e 64 62 20 alled envdat.db
4740: 75 6e 64 65 72 0a 23 20 74 68 65 20 63 6f 6e 74 under.# the cont
4750: 65 78 74 20 22 62 65 66 6f 72 65 22 0a 6d 65 67 ext "before".meg
4760: 61 74 65 73 74 20 2d 65 6e 76 63 61 70 20 62 65 atest -envcap be
4770: 66 6f 72 65 0a 0a 23 20 63 61 70 74 75 72 65 20 fore..# capture
4780: 74 68 65 20 63 75 72 72 65 6e 74 20 65 6e 76 69 the current envi
4790: 72 6f 6e 6d 65 6e 74 20 69 6e 74 6f 20 61 20 64 ronment into a d
47a0: 62 20 63 61 6c 6c 65 64 20 73 74 61 72 74 75 70 b called startup
47b0: 2e 64 62 20 77 69 74 68 20 0a 23 20 63 6f 6e 74 .db with .# cont
47c0: 65 78 74 20 22 61 66 74 65 72 22 0a 6d 65 67 61 ext "after".mega
47d0: 74 65 73 74 20 2d 65 6e 76 63 61 70 20 61 66 74 test -envcap aft
47e0: 65 72 20 73 74 61 72 74 75 70 2e 64 62 0a 0a 23 er startup.db..#
47f0: 20 77 72 69 74 65 20 74 68 65 20 64 69 66 66 20 write the diff
4800: 66 72 6f 6d 20 62 65 66 6f 72 65 20 74 6f 20 61 from before to a
4810: 66 74 65 72 0a 6d 65 67 61 74 65 73 74 20 2d 65 fter.megatest -e
4820: 6e 76 64 65 6c 74 61 20 62 65 66 6f 72 65 2d 61 nvdelta before-a
4830: 66 74 65 72 20 2d 64 75 6d 70 6d 6f 64 65 20 62 fter -dumpmode b
4840: 61 73 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ash.------------
4850: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4860: 2d 2d 0a 0a 44 75 6d 70 20 6d 6f 64 65 73 20 69 --..Dump modes i
4870: 6e 63 6c 75 64 65 20 62 61 73 68 2c 20 63 73 68 nclude bash, csh
4880: 20 61 6e 64 20 63 6f 6e 66 69 67 2e 20 59 6f 75 and config. You
4890: 20 63 61 6e 20 69 6e 63 6c 75 64 65 20 63 6f 6e can include con
48a0: 66 69 67 20 64 61 74 61 0a 69 6e 74 6f 20 6d 65 fig data.into me
48b0: 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 20 6f 72 gatest.config or
48c0: 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 6f 6e 66 runconfigs.conf
48d0: 69 67 2e 0a 0a 2e 45 78 61 6d 70 6c 65 20 6f 66 ig....Example of
48e0: 20 67 65 6e 65 72 61 74 69 6e 67 20 61 6e 64 20 generating and
48f0: 75 73 69 6e 67 20 63 6f 6e 66 69 67 20 64 61 74 using config dat
4900: 61 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d a.--------------
4910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4920: 0a 6d 65 67 61 74 65 73 74 20 2d 65 6e 76 63 61 .megatest -envca
4930: 70 20 6f 72 69 67 69 6e 61 6c 0a 23 20 64 6f 20 p original.# do
4940: 73 6f 6d 65 20 73 74 75 66 66 20 68 65 72 65 0a some stuff here.
4950: 6d 65 67 61 74 65 73 74 20 2d 65 6e 76 63 61 70 megatest -envcap
4960: 20 6d 75 6e 67 65 64 0a 6d 65 67 61 74 65 73 74 munged.megatest
4970: 20 2d 65 6e 76 64 65 6c 74 61 20 6f 72 69 67 69 -envdelta origi
4980: 6e 61 6c 2d 6d 75 6e 67 65 64 20 2d 64 75 6d 70 nal-munged -dump
4990: 6d 6f 64 65 20 69 6e 69 20 2d 6f 20 6d 6f 64 69 mode ini -o modi
49a0: 66 69 65 64 2e 63 6f 6e 66 69 67 0a 2d 2d 2d 2d fied.config.----
49b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
49c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 6e ----------..Then
49d0: 20 69 6e 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 in runconfigs.c
49e0: 6f 6e 66 69 67 0a 0a 2e 45 78 61 6d 70 6c 65 20 onfig...Example
49f0: 6f 66 20 75 73 69 6e 67 20 6d 6f 64 69 66 69 65 of using modifie
4a00: 64 2e 63 6f 6e 66 69 67 20 69 6e 20 61 20 74 65 d.config in a te
4a10: 73 74 63 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d stconfig.-------
4a20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4a30: 2d 2d 2d 2d 2d 2d 2d 0a 63 61 74 20 74 65 73 74 -------.cat test
4a40: 63 6f 6e 66 69 67 0a 5b 70 72 65 2d 6c 61 75 6e config.[pre-laun
4a50: 63 68 2d 65 6e 76 2d 76 61 72 73 5d 0a 5b 69 6e ch-env-vars].[in
4a60: 63 6c 75 64 65 20 6d 6f 64 69 66 69 65 64 2e 63 clude modified.c
4a70: 6f 6e 66 69 67 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d onfig].---------
4a80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4a90: 2d 2d 2d 2d 2d 0a 0a 4d 61 6e 61 67 69 6e 67 20 -----..Managing
4aa0: 4f 6c 64 20 52 75 6e 73 0a 2d 2d 2d 2d 2d 2d 2d Old Runs.-------
4ab0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 74 20 69 ----------..It i
4ac0: 73 20 6f 66 74 65 6e 20 64 65 73 69 72 65 64 20 s often desired
4ad0: 74 6f 20 6b 65 65 70 20 73 6f 6d 65 20 6f 6c 64 to keep some old
4ae0: 65 72 20 72 75 6e 73 20 61 72 6f 75 6e 64 20 62 er runs around b
4af0: 75 74 20 74 68 69 73 20 6d 75 73 74 20 62 65 20 ut this must be
4b00: 62 61 6c 61 6e 63 65 64 20 77 69 74 68 20 74 68 balanced with th
4b10: 65 20 63 6f 73 74 73 20 6f 66 20 64 69 73 6b 20 e costs of disk
4b20: 73 70 61 63 65 2e 0a 0a 2e 20 55 73 65 20 2d 72 space.... Use -r
4b30: 65 6d 6f 76 65 2d 6b 65 65 70 0a 2e 20 55 73 65 emove-keep.. Use
4b40: 20 2d 61 72 63 68 69 76 65 20 28 63 61 6e 20 61 -archive (can a
4b50: 6c 73 6f 20 62 65 20 64 6f 6e 65 20 66 72 6f 6d lso be done from
4b60: 20 74 68 65 20 2d 72 65 6d 6f 76 65 2d 6b 65 65 the -remove-kee
4b70: 70 20 69 6e 74 65 72 66 61 63 65 29 0a 2e 20 75 p interface).. u
4b80: 73 65 20 2d 72 65 6d 6f 76 65 2d 72 75 6e 73 20 se -remove-runs
4b90: 77 69 74 68 20 2d 6b 65 65 70 2d 72 65 63 6f 72 with -keep-recor
4ba0: 64 73 0a 0a 2e 46 6f 72 20 65 61 63 68 20 74 61 ds...For each ta
4bb0: 72 67 65 74 2c 20 72 65 6d 6f 76 65 20 61 6c 6c rget, remove all
4bc0: 20 72 75 6e 73 20 62 75 74 20 74 68 65 20 6d 6f runs but the mo
4bd0: 73 74 20 72 65 63 65 6e 74 20 33 20 69 66 20 74 st recent 3 if t
4be0: 68 65 79 20 61 72 65 20 6f 76 65 72 20 31 20 77 hey are over 1 w
4bf0: 65 65 6b 20 6f 6c 64 0a 2d 2d 2d 2d 2d 2d 2d 2d eek old.--------
4c00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 -------------.#
4c10: 75 73 65 20 2d 70 72 65 63 6d 64 20 27 73 6c 65 use -precmd 'sle
4c20: 65 70 20 35 3b 6e 62 66 61 6b 65 27 20 74 6f 20 ep 5;nbfake' to
4c30: 6c 69 6d 69 74 20 6f 76 65 72 6c 6f 61 64 69 6e limit overloadin
4c40: 67 20 74 68 65 20 68 6f 73 74 20 63 6f 6d 70 75 g the host compu
4c50: 74 65 72 20 62 75 74 20 74 6f 20 61 6c 6c 6f 77 ter but to allow
4c60: 20 74 68 65 20 72 65 6d 6f 76 65 73 20 74 6f 20 the removes to
4c70: 72 75 6e 20 69 6e 20 70 61 72 61 6c 6c 65 6c 2e run in parallel.
4c80: 0a 6d 65 67 61 74 65 73 74 20 2d 61 63 74 69 6f .megatest -actio
4c90: 6e 73 20 70 72 69 6e 74 2c 72 65 6d 6f 76 65 2d ns print,remove-
4ca0: 72 75 6e 73 20 2d 72 65 6d 6f 76 65 2d 6b 65 65 runs -remove-kee
4cb0: 70 20 33 20 2d 74 61 72 67 65 74 20 25 2f 25 2f p 3 -target %/%/
4cc0: 25 2f 25 20 2d 72 75 6e 6e 61 6d 65 20 25 20 2d %/% -runname % -
4cd0: 61 67 65 20 31 77 20 2d 70 72 65 63 6d 64 20 27 age 1w -precmd '
4ce0: 73 6c 65 65 70 20 35 3b 6e 62 66 61 6b 65 27 22 sleep 5;nbfake'"
4cf0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
4d00: 2d 2d 2d 2d 2d 2d 0a 0a 4e 65 73 74 65 64 20 52 ------..Nested R
4d10: 75 6e 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a uns.-----------.
4d20: 0a 41 20 4d 65 67 61 74 65 73 74 20 74 65 73 74 .A Megatest test
4d30: 20 63 61 6e 20 72 75 6e 20 61 20 66 75 6c 6c 20 can run a full
4d40: 4d 65 67 61 74 65 73 74 20 72 75 6e 20 69 6e 20 Megatest run in
4d50: 65 69 74 68 65 72 20 74 68 65 20 73 61 6d 65 0a either the same.
4d60: 4d 65 67 61 74 65 73 74 20 61 72 65 61 20 6f 72 Megatest area or
4d70: 20 69 6e 20 61 6e 6f 74 68 65 72 20 61 72 65 61 in another area
4d80: 2e 20 54 68 69 73 20 69 73 20 61 20 70 6f 77 65 . This is a powe
4d90: 72 66 75 6c 20 77 61 79 20 6f 66 20 63 68 61 69 rful way of chai
4da0: 6e 69 6e 67 0a 63 6f 6d 70 6c 65 78 20 73 75 69 ning.complex sui
4db0: 74 65 73 20 6f 66 20 74 65 73 74 73 20 61 6e 64 tes of tests and
4dc0: 20 6f 72 20 61 63 74 69 6f 6e 73 2e 0a 0a 49 66 or actions...If
4dd0: 20 79 6f 75 20 61 72 65 20 6e 6f 74 20 75 73 69 you are not usi
4de0: 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 61 ng the current a
4df0: 72 65 61 20 79 6f 75 20 63 61 6e 20 75 73 65 20 rea you can use
4e00: 65 7a 73 74 65 70 73 20 74 6f 20 72 65 74 72 69 ezsteps to retri
4e10: 65 76 65 0a 61 6e 64 20 73 65 74 75 70 20 74 68 eve.and setup th
4e20: 65 20 73 75 62 2d 4d 65 67 61 74 65 73 74 20 72 e sub-Megatest r
4e30: 75 6e 20 61 72 65 61 2e 0a 0a 49 6e 20 74 68 65 un area...In the
4e40: 20 74 65 73 74 63 6f 6e 66 69 67 3a 0a 2d 2d 2d testconfig:.---
4e50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 75 ------------.[su
4e60: 62 72 75 6e 5d 0a 0a 23 20 52 65 71 75 69 72 65 brun]..# Require
4e70: 64 3a 20 77 61 69 74 20 66 6f 72 20 74 68 65 20 d: wait for the
4e80: 72 75 6e 20 6f 72 20 6a 75 73 74 20 6c 61 75 6e run or just laun
4e90: 63 68 20 69 74 0a 23 20 20 20 20 20 20 20 20 20 ch it.#
4ea0: 20 20 69 66 20 6e 6f 20 74 68 65 6e 20 74 68 65 if no then the
4eb0: 20 72 75 6e 20 77 69 6c 6c 20 62 65 20 61 6e 20 run will be an
4ec0: 61 75 74 6f 6d 61 74 69 63 20 50 41 53 53 20 69 automatic PASS i
4ed0: 72 72 65 73 70 65 63 74 69 76 65 20 6f 66 20 74 rrespective of t
4ee0: 68 65 20 61 63 74 75 61 6c 20 72 65 73 75 6c 74 he actual result
4ef0: 0a 72 75 6e 2d 77 61 69 74 20 79 65 73 7c 6e 6f .run-wait yes|no
4f00: 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 77 68 ..# Optional: wh
4f10: 65 72 65 20 74 6f 20 65 78 65 63 75 74 65 20 74 ere to execute t
4f20: 68 65 20 72 75 6e 2e 20 44 65 66 61 75 6c 74 20 he run. Default
4f30: 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 is the current r
4f40: 75 6e 61 72 65 61 0a 72 75 6e 2d 61 72 65 61 20 unarea.run-area
4f50: 2f 73 6f 6d 65 2f 70 61 74 68 2f 74 6f 2f 6d 65 /some/path/to/me
4f60: 67 61 74 65 73 74 2f 61 72 65 61 0a 0a 23 20 4f gatest/area..# O
4f70: 70 74 69 6f 6e 61 6c 3a 20 6d 65 74 68 6f 64 20 ptional: method
4f80: 74 6f 20 75 73 65 20 74 6f 20 64 65 74 65 72 6d to use to determ
4f90: 69 6e 65 20 70 61 73 73 2f 66 61 69 6c 20 73 74 ine pass/fail st
4fa0: 61 74 75 73 20 6f 66 20 74 68 65 20 72 75 6e 0a atus of the run.
4fb0: 23 20 20 20 61 75 74 6f 20 28 64 65 66 61 75 6c # auto (defaul
4fc0: 74 29 20 2d 20 72 6f 6c 6c 20 75 70 20 74 68 65 t) - roll up the
4fd0: 20 6e 65 74 20 73 74 61 74 65 2f 73 74 61 74 75 net state/statu
4fe0: 73 20 6f 66 20 74 68 65 20 73 75 62 2d 72 75 6e s of the sub-run
4ff0: 0a 23 20 20 20 6c 6f 67 70 72 6f 20 20 20 20 20 .# logpro
5000: 20 20 20 20 2d 20 75 73 65 20 74 68 65 20 70 72 - use the pr
5010: 6f 76 69 64 65 64 20 6c 6f 67 70 72 6f 20 72 75 ovided logpro ru
5020: 6c 65 73 2c 20 68 61 70 70 65 6e 73 20 61 75 74 les, happens aut
5030: 6f 6d 61 74 69 63 61 6c 6c 79 20 69 66 20 74 68 omatically if th
5040: 65 72 65 20 69 73 20 61 20 6c 6f 67 70 72 6f 20 ere is a logpro
5050: 73 65 63 74 69 6f 6e 0a 23 20 70 61 73 73 66 61 section.# passfa
5060: 69 6c 20 61 75 74 6f 7c 6c 6f 67 70 72 6f 0a 23 il auto|logpro.#
5070: 20 45 78 61 6d 70 6c 65 20 6f 66 20 6c 6f 67 70 Example of logp
5080: 72 6f 3a 0a 70 61 73 73 66 61 69 6c 20 6c 6f 67 ro:.passfail log
5090: 70 72 6f 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a pro..# Optional:
50a0: 20 0a 6c 6f 67 70 72 6f 20 3b 3b 20 69 66 20 74 .logpro ;; if t
50b0: 68 69 73 20 73 65 63 74 69 6f 6e 20 65 78 69 73 his section exis
50c0: 74 73 20 74 68 65 6e 20 6c 6f 67 70 72 6f 20 69 ts then logpro i
50d0: 73 20 75 73 65 64 20 74 6f 20 64 65 74 65 72 6d s used to determ
50e0: 69 6e 65 20 70 61 73 73 2f 66 61 69 6c 0a 20 20 ine pass/fail.
50f0: 28 65 78 70 65 63 74 3a 72 65 71 75 69 72 65 64 (expect:required
5100: 20 69 6e 20 22 4c 6f 67 46 69 6c 65 42 6f 64 79 in "LogFileBody
5110: 22 20 3e 3d 20 31 20 22 41 74 20 6c 65 61 73 74 " >= 1 "At least
5120: 20 6f 6e 65 20 70 61 73 73 22 20 23 2f 50 41 53 one pass" #/PAS
5130: 53 2f 29 0a 20 20 28 65 78 70 65 63 74 3a 66 61 S/). (expect:fa
5140: 69 6c 20 20 20 20 20 69 6e 20 22 4c 6f 67 46 69 il in "LogFi
5150: 6c 65 42 6f 64 79 22 20 20 3d 20 30 20 22 4e 6f leBody" = 0 "No
5160: 20 46 41 49 4c 73 20 61 6c 6c 6f 77 65 64 22 20 FAILs allowed"
5170: 20 23 2f 46 41 49 4c 2f 29 0a 0a 23 20 4f 70 74 #/FAIL/)..# Opt
5180: 69 6f 6e 61 6c 3a 20 74 61 72 67 65 74 20 74 72 ional: target tr
5190: 61 6e 73 6c 61 74 6f 72 2c 20 64 65 66 61 75 6c anslator, defaul
51a0: 74 20 69 73 20 74 6f 20 75 73 65 20 74 68 65 20 t is to use the
51b0: 70 61 72 65 6e 74 20 74 61 72 67 65 74 0a 74 61 parent target.ta
51c0: 72 67 65 74 20 23 7b 73 68 65 6c 6c 20 73 6f 6d rget #{shell som
51d0: 65 73 63 72 69 70 74 2e 73 68 7d 0a 0a 23 20 4f escript.sh}..# O
51e0: 70 74 69 6f 6e 61 6c 3a 20 72 75 6e 6e 61 6d 65 ptional: runname
51f0: 20 74 72 61 6e 73 6c 61 74 6f 72 2f 67 65 6e 65 translator/gene
5200: 72 61 74 6f 72 2c 20 64 65 66 61 75 6c 74 20 69 rator, default i
5210: 73 20 74 6f 20 75 73 65 20 74 68 65 20 70 61 72 s to use the par
5220: 65 6e 74 20 72 75 6e 6e 61 6d 65 0a 72 75 6e 2d ent runname.run-
5230: 6e 61 6d 65 20 23 7b 73 6f 6d 65 73 63 72 69 70 name #{somescrip
5240: 74 2e 73 68 7d 0a 0a 23 20 4f 70 74 69 6f 6e 61 t.sh}..# Optiona
5250: 6c 3a 20 74 65 73 74 70 61 74 74 20 73 70 65 63 l: testpatt spec
5260: 2c 20 64 65 66 61 75 6c 74 20 69 73 20 74 6f 20 , default is to
5270: 66 69 72 73 74 20 6c 6f 6f 6b 20 66 6f 72 20 54 first look for T
5280: 45 53 54 50 41 54 54 20 73 70 65 63 20 66 72 6f ESTPATT spec fro
5290: 6d 20 72 75 6e 63 6f 6e 66 69 67 73 20 75 6e 6c m runconfigs unl
52a0: 65 73 73 20 74 68 65 72 65 20 69 73 20 61 20 63 ess there is a c
52b0: 6f 6e 74 6f 75 72 20 73 70 65 63 0a 74 65 73 74 ontour spec.test
52c0: 2d 70 61 74 74 20 25 2f 69 74 65 6d 31 2c 74 65 -patt %/item1,te
52d0: 73 74 32 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a st2..# Optional:
52e0: 20 63 6f 6e 74 6f 75 72 20 73 70 65 63 2c 20 75 contour spec, u
52f0: 73 65 20 74 68 65 20 6e 61 6d 65 64 20 63 6f 6e se the named con
5300: 74 6f 75 72 20 66 72 6f 6d 20 74 68 65 20 6d 65 tour from the me
5310: 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 20 63 6f gatest.config co
5320: 6e 74 6f 75 72 20 73 70 65 63 0a 63 6f 6e 74 6f ntour spec.conto
5330: 75 72 20 63 6f 6e 74 6f 75 72 6e 61 6d 65 20 23 ur contourname #
5340: 23 23 20 4e 4f 54 45 3a 20 4e 6f 74 20 69 6d 70 ## NOTE: Not imp
5350: 6c 65 6d 65 6e 74 65 64 20 79 65 74 21 20 4c 65 lemented yet! Le
5360: 74 20 75 73 20 6b 6e 6f 77 20 69 66 20 79 6f 75 t us know if you
5370: 20 6e 65 65 64 20 74 68 69 73 20 66 65 61 74 75 need this featu
5380: 72 65 2e 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a re...# Optional:
5390: 20 6d 6f 64 65 2d 70 61 74 74 2c 20 75 73 65 20 mode-patt, use
53a0: 74 68 69 73 20 73 70 65 63 20 66 6f 72 20 74 65 this spec for te
53b0: 73 74 70 61 74 74 20 66 72 6f 6d 20 72 75 6e 63 stpatt from runc
53c0: 6f 6e 66 69 67 73 0a 6d 6f 64 65 2d 70 61 74 74 onfigs.mode-patt
53d0: 20 54 45 53 54 50 41 54 54 0a 0a 23 20 4f 70 74 TESTPATT..# Opt
53e0: 69 6f 6e 61 6c 3a 20 74 61 67 2d 65 78 70 72 2c ional: tag-expr,
53f0: 20 75 73 65 20 74 68 69 73 20 74 61 67 2d 65 78 use this tag-ex
5400: 70 72 20 74 6f 20 73 65 6c 65 63 74 20 74 65 73 pr to select tes
5410: 74 73 0a 74 61 67 2d 65 78 70 72 20 71 75 69 63 ts.tag-expr quic
5420: 6b 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 28 k..# Optional: (
5430: 6e 6f 74 20 79 65 74 20 69 6d 70 6c 65 6d 65 6e not yet implemen
5440: 74 65 64 2c 20 72 65 6d 6f 76 65 2d 72 75 6e 73 ted, remove-runs
5450: 20 69 73 20 61 6c 77 61 79 73 20 70 72 6f 70 61 is always propa
5460: 67 61 74 65 64 20 61 74 20 74 68 69 73 20 74 69 gated at this ti
5470: 6d 65 29 2c 20 70 72 6f 70 61 67 61 74 65 20 74 me), propagate t
5480: 68 65 73 65 20 61 63 74 69 6f 6e 73 20 66 72 6f hese actions fro
5490: 6d 20 74 68 65 20 70 61 72 65 6e 74 0a 23 20 20 m the parent.#
54a0: 20 20 20 20 20 20 20 20 20 74 65 73 74 0a 23 20 test.#
54b0: 20 20 4e 6f 74 65 2f 2f 20 64 65 66 61 75 6c 74 Note// default
54c0: 20 69 73 20 25 20 66 6f 72 20 61 6c 6c 0a 70 72 is % for all.pr
54d0: 6f 70 61 67 61 74 65 20 72 65 6d 6f 76 65 2d 72 opagate remove-r
54e0: 75 6e 73 20 61 72 63 68 69 76 65 20 2e 2e 2e 0a uns archive ....
54f0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
5500: 0a 0a 50 72 6f 67 72 61 6d 6d 69 6e 67 20 41 50 ..Programming AP
5510: 49 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d I.--------------
5520: 2d 0a 0a 54 68 65 73 65 20 72 6f 75 74 69 6e 65 -..These routine
5530: 73 20 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 s can be called
5540: 66 72 6f 6d 20 74 68 65 20 6d 65 67 61 74 65 73 from the megates
5550: 74 20 72 65 70 6c 2e 20 0a 0a 2e 41 50 49 20 4b t repl. ...API K
5560: 65 79 73 20 52 65 6c 61 74 65 64 20 43 61 6c 6c eys Related Call
5570: 73 0a 5b 77 69 64 74 68 3d 22 37 30 25 22 2c 63 s.[width="70%",c
5580: 6f 6c 73 3d 22 5e 2c 32 6d 2c 32 6d 2c 32 6d 22 ols="^,2m,2m,2m"
5590: 2c 66 72 61 6d 65 3d 22 74 6f 70 62 6f 74 22 2c ,frame="topbot",
55a0: 6f 70 74 69 6f 6e 73 3d 22 68 65 61 64 65 72 2c options="header,
55b0: 66 6f 6f 74 65 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d footer"].|======
55c0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
55d0: 0a 7c 41 50 49 20 43 61 6c 6c 20 20 20 20 20 20 .|API Call
55e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
55f0: 20 20 7c 20 50 75 72 70 6f 73 65 20 63 6f 6d 6d | Purpose comm
5600: 65 6e 74 73 20 20 20 7c 20 52 65 74 75 72 6e 73 ents | Returns
5610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5620: 20 7c 20 43 6f 6d 6d 65 6e 74 73 0a 7c 28 72 6d | Comments.|(rm
5630: 74 3a 67 65 74 2d 6b 65 79 73 20 72 75 6e 2d 69 t:get-keys run-i
5640: 64 29 20 20 20 20 20 20 20 20 20 20 20 7c 20 20 d) |
5650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5660: 20 20 7c 20 28 20 6b 65 79 31 20 6b 65 79 32 20 | ( key1 key2
5670: 2e 2e 2e 20 29 20 20 20 20 20 20 20 7c 20 0a 7c ... ) | .|
5680: 20 28 72 6d 74 3a 67 65 74 2d 6b 65 79 2d 76 61 (rmt:get-key-va
5690: 6c 2d 70 61 69 72 73 20 72 75 6e 2d 69 64 29 20 l-pairs run-id)
56a0: 7c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 |
56b0: 20 20 20 20 20 7c 20 23 74 3d 73 75 63 63 65 73 | #t=succes
56c0: 73 2f 23 66 3d 66 61 69 6c 20 20 20 20 20 20 7c s/#f=fail |
56d0: 20 57 6f 72 6b 73 20 6f 6e 6c 79 20 69 66 20 74 Works only if t
56e0: 68 65 20 73 65 72 76 65 72 20 69 73 20 73 74 69 he server is sti
56f0: 6c 6c 20 72 65 61 63 68 61 62 6c 65 0a 7c 3d 3d ll reachable.|==
5700: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
5710: 3d 3d 3d 3d 0a 0a 0a 3a 6e 75 6d 62 65 72 65 64 ====...:numbered
5720: 21 3a 0a 0a 0a 0a 5a 20 65 30 32 35 30 64 34 39 !:....Z e0250d49
5730: 39 63 62 36 31 62 30 32 31 30 61 63 36 34 30 65 9cb61b0210ac640e
5740: 37 31 37 63 64 35 61 61 0a 717cd5aa.