0000: 44 20 32 30 31 38 2d 30 34 2d 31 34 54 30 30 3a D 2018-04-14T00:
0010: 34 36 3a 31 38 2e 38 30 30 0a 4c 20 72 65 66 65 46:18.800.L refe
0020: 72 65 6e 63 65 0a 4e 20 74 65 78 74 2f 70 6c 61 rence.N text/pla
0030: 69 6e 0a 50 20 62 63 61 39 30 66 64 62 66 66 32 in.P bca90fdbff2
0040: 31 33 31 31 37 65 62 39 65 65 36 63 35 63 36 38 13117eb9ee6c5c68
0050: 30 35 33 32 66 31 31 31 61 36 64 64 61 0a 55 20 0532f111a6dda.U
0060: 62 6a 62 61 72 63 6c 61 0a 57 20 32 34 34 30 39 bjbarcla.W 24409
0070: 0a 2f 2f 20 54 68 69 73 20 66 69 6c 65 20 69 73 .// This file is
0080: 20 70 61 72 74 20 6f 66 20 4d 65 67 61 74 65 73 part of Megates
0090: 74 2e 0a 2f 2f 20 0a 2f 2f 20 20 20 20 20 4d 65 t..// .// Me
00a0: 67 61 74 65 73 74 20 69 73 20 66 72 65 65 20 73 gatest is free s
00b0: 6f 66 74 77 61 72 65 3a 20 79 6f 75 20 63 61 6e oftware: you can
00c0: 20 72 65 64 69 73 74 72 69 62 75 74 65 20 69 74 redistribute it
00d0: 20 61 6e 64 2f 6f 72 20 6d 6f 64 69 66 79 0a 2f and/or modify./
00e0: 2f 20 20 20 20 20 69 74 20 75 6e 64 65 72 20 74 / it under t
00f0: 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 65 20 he terms of the
0100: 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c GNU General Publ
0110: 69 63 20 4c 69 63 65 6e 73 65 20 61 73 20 70 75 ic License as pu
0120: 62 6c 69 73 68 65 64 20 62 79 0a 2f 2f 20 20 20 blished by.//
0130: 20 20 74 68 65 20 46 72 65 65 20 53 6f 66 74 77 the Free Softw
0140: 61 72 65 20 46 6f 75 6e 64 61 74 69 6f 6e 2c 20 are Foundation,
0150: 65 69 74 68 65 72 20 76 65 72 73 69 6f 6e 20 33 either version 3
0160: 20 6f 66 20 74 68 65 20 4c 69 63 65 6e 73 65 2c of the License,
0170: 20 6f 72 0a 2f 2f 20 20 20 20 20 28 61 74 20 79 or.// (at y
0180: 6f 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79 20 our option) any
0190: 6c 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 2f later version../
01a0: 2f 20 0a 2f 2f 20 20 20 20 20 4d 65 67 61 74 65 / .// Megate
01b0: 73 74 20 69 73 20 64 69 73 74 72 69 62 75 74 65 st is distribute
01c0: 64 20 69 6e 20 74 68 65 20 68 6f 70 65 20 74 68 d in the hope th
01d0: 61 74 20 69 74 20 77 69 6c 6c 20 62 65 20 75 73 at it will be us
01e0: 65 66 75 6c 2c 0a 2f 2f 20 20 20 20 20 62 75 74 eful,.// but
01f0: 20 57 49 54 48 4f 55 54 20 41 4e 59 20 57 41 52 WITHOUT ANY WAR
0200: 52 41 4e 54 59 3b 20 77 69 74 68 6f 75 74 20 65 RANTY; without e
0210: 76 65 6e 20 74 68 65 20 69 6d 70 6c 69 65 64 20 ven the implied
0220: 77 61 72 72 61 6e 74 79 20 6f 66 0a 2f 2f 20 20 warranty of.//
0230: 20 20 20 4d 45 52 43 48 41 4e 54 41 42 49 4c 49 MERCHANTABILI
0240: 54 59 20 6f 72 20 46 49 54 4e 45 53 53 20 46 4f TY or FITNESS FO
0250: 52 20 41 20 50 41 52 54 49 43 55 4c 41 52 20 50 R A PARTICULAR P
0260: 55 52 50 4f 53 45 2e 20 20 53 65 65 20 74 68 65 URPOSE. See the
0270: 0a 2f 2f 20 20 20 20 20 47 4e 55 20 47 65 6e 65 .// GNU Gene
0280: 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e ral Public Licen
0290: 73 65 20 66 6f 72 20 6d 6f 72 65 20 64 65 74 61 se for more deta
02a0: 69 6c 73 2e 0a 2f 2f 20 0a 2f 2f 20 20 20 20 20 ils..// .//
02b0: 59 6f 75 20 73 68 6f 75 6c 64 20 68 61 76 65 20 You should have
02c0: 72 65 63 65 69 76 65 64 20 61 20 63 6f 70 79 20 received a copy
02d0: 6f 66 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 of the GNU Gener
02e0: 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 al Public Licens
02f0: 65 0a 2f 2f 20 20 20 20 20 61 6c 6f 6e 67 20 77 e.// along w
0300: 69 74 68 20 4d 65 67 61 74 65 73 74 2e 20 20 49 ith Megatest. I
0310: 66 20 6e 6f 74 2c 20 73 65 65 20 3c 68 74 74 70 f not, see <http
0320: 3a 2f 2f 77 77 77 2e 67 6e 75 2e 6f 72 67 2f 6c ://www.gnu.org/l
0330: 69 63 65 6e 73 65 73 2f 3e 2e 0a 0a 52 65 66 65 icenses/>...Refe
0340: 72 65 6e 63 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a rence.---------.
0350: 0a 43 6f 6e 66 69 67 20 46 69 6c 65 20 48 65 6c .Config File Hel
0360: 70 65 72 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e pers.~~~~~~~~~~~
0370: 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 56 61 72 69 6f 75 ~~~~~~~~..Variou
0380: 73 20 68 65 6c 70 65 72 73 20 66 6f 72 20 6d 6f s helpers for mo
0390: 72 65 20 61 64 76 61 6e 63 65 64 20 63 6f 6e 66 re advanced conf
03a0: 69 67 20 66 69 6c 65 73 2e 0a 0a 2e 48 65 6c 70 ig files....Help
03b0: 65 72 73 0a 5b 77 69 64 74 68 3d 22 38 30 25 22 ers.[width="80%"
03c0: 2c 63 6f 6c 73 3d 22 5e 2c 32 6d 2c 32 6d 2c 32 ,cols="^,2m,2m,2
03d0: 6d 22 2c 66 72 61 6d 65 3d 22 74 6f 70 62 6f 74 m",frame="topbot
03e0: 22 2c 6f 70 74 69 6f 6e 73 3d 22 68 65 61 64 65 ",options="heade
03f0: 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d r"].|===========
0400: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 48 65 6c ===========.|Hel
0410: 70 65 72 20 20 20 20 20 20 20 20 20 20 20 20 20 per
0420: 20 20 20 20 20 20 20 20 20 7c 20 50 75 72 70 6f | Purpo
0430: 73 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 se
0440: 20 20 20 20 20 20 20 20 20 7c 20 56 61 6c 69 64 | Valid
0450: 20 76 61 6c 75 65 73 20 20 20 20 20 20 20 20 20 values
0460: 20 20 20 7c 20 43 6f 6d 6d 65 6e 74 73 0a 7c 20 | Comments.|
0470: 23 7b 73 63 68 65 6d 65 20 28 73 63 68 65 6d 65 #{scheme (scheme
0480: 20 63 6f 64 65 2e 2e 2e 29 7d 20 7c 20 45 78 65 code...)} | Exe
0490: 63 75 74 65 20 61 72 62 69 74 72 61 72 79 20 73 cute arbitrary s
04a0: 63 68 65 6d 65 20 63 6f 64 65 20 7c 20 41 6e 79 cheme code | Any
04b0: 20 76 61 6c 69 64 20 73 63 68 65 6d 65 20 20 20 valid scheme
04c0: 20 20 20 20 20 7c 20 56 61 6c 75 65 20 72 65 74 | Value ret
04d0: 75 72 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 63 urned from the c
04e0: 61 6c 6c 20 69 73 20 63 6f 6e 76 65 72 74 65 64 all is converted
04f0: 20 74 6f 20 61 20 73 74 72 69 6e 67 20 61 6e 64 to a string and
0500: 20 70 72 6f 63 65 73 73 65 64 20 61 73 20 70 61 processed as pa
0510: 72 74 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 rt of the config
0520: 20 66 69 6c 65 0a 7c 20 23 7b 73 79 73 74 65 6d file.| #{system
0530: 20 63 6f 6d 6d 61 6e 64 7d 20 20 20 20 20 20 20 command}
0540: 20 20 20 7c 20 45 78 65 63 75 74 65 20 70 72 6f | Execute pro
0550: 67 72 61 6d 2c 20 69 6e 73 65 72 74 73 20 65 78 gram, inserts ex
0560: 69 74 20 63 6f 64 65 20 20 7c 20 41 6e 79 20 76 it code | Any v
0570: 61 6c 69 64 20 55 6e 69 78 20 63 6f 6d 6d 61 6e alid Unix comman
0580: 64 20 20 7c 20 44 69 73 63 61 72 64 73 20 74 68 d | Discards th
0590: 65 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 e output from th
05a0: 65 20 70 72 6f 67 72 61 6d 0a 7c 20 23 7b 73 68 e program.| #{sh
05b0: 65 6c 6c 20 20 63 6f 6d 6d 61 6e 64 7d 20 6f 72 ell command} or
05c0: 20 23 7b 73 68 20 2e 2e 2e 7d 20 20 7c 20 45 78 #{sh ...} | Ex
05d0: 65 63 75 74 65 20 70 72 6f 67 72 61 6d 2c 20 69 ecute program, i
05e0: 6e 73 65 72 74 73 20 72 65 73 75 6c 74 20 66 72 nserts result fr
05f0: 6f 6d 20 73 74 64 6f 75 74 20 7c 20 41 6e 79 20 om stdout | Any
0600: 76 61 6c 69 64 20 55 6e 69 78 20 63 6f 6d 6d 61 valid Unix comma
0610: 6e 64 20 7c 20 56 61 6c 75 65 20 72 65 74 75 72 nd | Value retur
0620: 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 63 61 6c ned from the cal
0630: 6c 20 69 73 20 63 6f 6e 76 65 72 74 65 64 20 74 l is converted t
0640: 6f 20 61 20 73 74 72 69 6e 67 20 61 6e 64 20 70 o a string and p
0650: 72 6f 63 65 73 73 65 64 20 61 73 20 70 61 72 74 rocessed as part
0660: 20 6f 66 20 74 68 65 20 63 6f 6e 66 69 67 20 66 of the config f
0670: 69 6c 65 0a 7c 20 23 7b 72 65 61 6c 70 61 74 68 ile.| #{realpath
0680: 20 70 61 74 68 7d 20 6f 72 20 23 7b 72 70 20 2e path} or #{rp .
0690: 2e 2e 7d 20 20 20 7c 20 52 65 70 6c 61 63 65 20 ..} | Replace
06a0: 77 69 74 68 20 6e 6f 72 6d 61 6c 69 7a 65 64 20 with normalized
06b0: 70 61 74 68 20 7c 20 4d 75 73 74 20 62 65 20 61 path | Must be a
06c0: 20 76 61 6c 69 64 20 70 61 74 68 20 7c 0a 7c 20 valid path |.|
06d0: 23 7b 67 65 74 65 6e 76 20 56 41 52 7d 20 6f 72 #{getenv VAR} or
06e0: 20 23 7b 67 76 20 56 41 52 7d 20 20 20 20 20 20 #{gv VAR}
06f0: 7c 20 52 65 70 6c 61 63 65 20 77 69 74 68 20 63 | Replace with c
0700: 6f 6e 74 65 6e 74 20 6f 66 20 65 6e 76 20 76 61 ontent of env va
0710: 72 69 61 62 6c 65 20 7c 20 4d 75 73 74 20 62 65 riable | Must be
0720: 20 61 20 76 61 6c 69 64 20 76 61 72 20 7c 0a 7c a valid var |.|
0730: 20 23 7b 67 65 74 20 73 20 76 7d 20 6f 72 20 23 #{get s v} or #
0740: 7b 67 20 73 20 76 7d 20 20 20 20 20 7c 20 52 65 {g s v} | Re
0750: 70 6c 61 63 65 20 77 69 74 68 20 76 61 72 69 61 place with varia
0760: 62 6c 65 20 76 20 66 72 6f 6d 20 73 65 63 74 69 ble v from secti
0770: 6f 6e 20 73 20 7c 20 56 61 72 69 61 62 6c 65 20 on s | Variable
0780: 6d 75 73 74 20 62 65 20 64 65 66 69 6e 65 64 20 must be defined
0790: 62 65 66 6f 72 65 20 75 73 65 20 7c 0a 7c 20 23 before use |.| #
07a0: 7b 72 67 65 74 20 76 7d 20 20 20 20 20 20 20 20 {rget v}
07b0: 20 20 20 20 20 20 20 20 20 20 7c 20 52 65 70 6c | Repl
07c0: 61 63 65 20 77 69 74 68 20 76 61 72 69 61 62 6c ace with variabl
07d0: 65 20 76 20 66 72 6f 6d 20 74 61 72 67 65 74 20 e v from target
07e0: 6f 72 20 64 65 66 61 75 6c 74 20 6f 66 20 72 75 or default of ru
07f0: 6e 63 6f 6e 66 69 67 73 20 66 69 6c 65 20 7c 20 nconfigs file |
0800: 7c 0a 7c 20 23 7b 6d 74 72 61 68 7d 20 20 20 20 |.| #{mtrah}
0810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
0820: 20 52 65 70 6c 61 63 65 20 77 69 74 68 20 74 68 Replace with th
0830: 65 20 70 61 74 68 20 74 6f 20 74 68 65 20 6d 65 e path to the me
0840: 67 61 74 65 73 74 20 74 65 73 74 73 75 69 74 65 gatest testsuite
0850: 20 61 72 65 61 20 7c 20 7c 20 0a 7c 3d 3d 3d 3d area | | .|====
0860: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0870: 3d 3d 0a 0a 43 6f 6e 66 69 67 20 46 69 6c 65 20 ==..Config File
0880: 53 65 74 74 69 6e 67 73 0a 7e 7e 7e 7e 7e 7e 7e Settings.~~~~~~~
0890: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 53 ~~~~~~~~~~~~~..S
08a0: 65 74 74 69 6e 67 73 20 69 6e 20 6d 65 67 61 74 ettings in megat
08b0: 65 73 74 2e 63 6f 6e 66 69 67 0a 0a 43 6f 6e 66 est.config..Conf
08c0: 69 67 20 46 69 6c 65 20 41 64 64 69 74 69 6f 6e ig File Addition
08d0: 61 6c 20 46 65 61 74 75 72 65 73 0a 7e 7e 7e 7e al Features.~~~~
08e0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
08f0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 63 ~~~~~~~~~~~..Inc
0900: 6c 75 64 69 6e 67 20 6f 75 74 70 75 74 20 66 72 luding output fr
0910: 6f 6d 20 61 20 73 63 72 69 70 74 20 61 73 20 69 om a script as i
0920: 66 20 69 74 20 77 61 73 20 69 6e 6c 69 6e 65 20 f it was inline
0930: 74 6f 20 74 68 65 20 63 6f 6e 66 69 67 20 66 69 to the config fi
0940: 6c 65 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d le:..-----------
0950: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
0960: 73 63 72 69 70 74 69 6e 63 20 6d 79 73 63 72 69 scriptinc myscri
0970: 70 74 2e 73 68 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d pt.sh].---------
0980: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0990: 0a 0a 49 66 20 74 68 65 20 73 63 72 69 70 74 20 ..If the script
09a0: 6f 75 74 70 75 74 73 3a 0a 0a 2d 2d 2d 2d 2d 2d outputs:..------
09b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
09c0: 2d 2d 2d 0a 5b 69 74 65 6d 73 5d 0a 41 20 61 20 ---.[items].A a
09d0: 62 20 63 0a 42 20 64 20 65 20 66 0a 2d 2d 2d 2d b c.B d e f.----
09e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
09f0: 2d 2d 2d 2d 2d 0a 0a 54 68 65 6e 20 74 68 65 20 -----..Then the
0a00: 63 6f 6e 66 69 67 20 66 69 6c 65 20 77 6f 75 6c config file woul
0a10: 64 20 65 66 66 65 63 74 69 76 65 6c 79 20 61 70 d effectively ap
0a20: 70 65 61 72 20 74 6f 20 63 6f 6e 74 61 69 6e 20 pear to contain
0a30: 61 6e 20 69 74 65 6d 73 20 73 65 63 74 69 6f 6e an items section
0a40: 0a 65 78 61 63 74 6c 79 20 6c 69 6b 65 20 74 68 .exactly like th
0a50: 65 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 74 68 e output from th
0a60: 65 20 73 63 72 69 70 74 2e 20 54 68 69 73 20 69 e script. This i
0a70: 73 20 75 73 65 66 75 6c 20 77 68 65 6e 20 64 79 s useful when dy
0a80: 6e 61 6d 69 63 61 6c 6c 79 0a 63 72 65 61 74 69 namically.creati
0a90: 6e 67 20 69 74 65 6d 73 2c 20 69 74 65 6d 73 74 ng items, itemst
0aa0: 61 62 6c 65 73 20 61 6e 64 20 6f 74 68 65 72 20 ables and other
0ab0: 63 6f 6e 66 69 67 20 73 74 72 75 63 74 75 72 65 config structure
0ac0: 73 2e 20 59 6f 75 20 63 61 6e 20 73 65 65 20 74 s. You can see t
0ad0: 68 65 0a 65 78 70 61 6e 73 69 6f 6e 20 6f 66 20 he.expansion of
0ae0: 74 68 65 20 63 61 6c 6c 20 62 79 20 6c 6f 6f 6b the call by look
0af0: 69 6e 67 20 69 6e 20 74 68 65 20 63 61 63 68 65 ing in the cache
0b00: 64 20 66 69 6c 65 73 20 28 6c 6f 6f 6b 20 69 6e d files (look in
0b10: 20 79 6f 75 72 20 6c 69 6e 6b 74 72 65 65 0a 66 your linktree.f
0b20: 6f 72 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 or megatest.conf
0b30: 69 67 20 61 6e 64 20 72 75 6e 63 6f 6e 66 69 67 ig and runconfig
0b40: 73 2e 63 6f 6e 66 69 67 20 63 61 63 68 65 20 66 s.config cache f
0b50: 69 6c 65 73 20 61 6e 64 20 69 6e 20 79 6f 75 72 iles and in your
0b60: 20 74 65 73 74 20 72 75 6e 0a 61 72 65 61 73 20 test run.areas
0b70: 66 6f 72 20 74 68 65 20 65 78 70 61 6e 64 65 64 for the expanded
0b80: 20 61 6e 64 20 63 61 63 68 65 64 20 74 65 73 74 and cached test
0b90: 63 6f 6e 66 69 67 29 2e 0a 0a 57 69 6c 64 63 61 config)...Wildca
0ba0: 72 64 73 20 61 6e 64 20 72 65 67 65 78 65 73 20 rds and regexes
0bb0: 69 6e 20 54 61 72 67 65 74 73 0a 0a 2d 2d 2d 2d in Targets..----
0bc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0bd0: 2d 2d 2d 2d 2d 0a 5b 61 2f 32 2f 62 5d 0a 56 41 -----.[a/2/b].VA
0be0: 52 31 20 56 41 4c 31 0a 0a 5b 61 2f 25 2f 62 5d R1 VAL1..[a/%/b]
0bf0: 0a 56 41 52 31 20 56 41 4c 32 0a 2d 2d 2d 2d 2d .VAR1 VAL2.-----
0c00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0c10: 2d 2d 2d 2d 0a 0a 57 69 6c 6c 20 72 65 73 75 6c ----..Will resul
0c20: 74 20 69 6e 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d t in:..---------
0c30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0c40: 0a 5b 61 2f 32 2f 62 5d 0a 56 41 52 31 20 56 41 .[a/2/b].VAR1 VA
0c50: 4c 32 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d L2.-------------
0c60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 61 ------------..Ca
0c70: 6e 20 75 73 65 20 65 69 74 68 65 72 20 77 69 6c n use either wil
0c80: 64 63 61 72 64 20 6f 66 20 22 25 22 20 6f 72 20 dcard of "%" or
0c90: 61 20 72 65 67 75 6c 61 72 20 65 78 70 72 65 73 a regular expres
0ca0: 73 69 6f 6e 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d sion:..---------
0cb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0cc0: 0a 5b 2f 61 62 63 2e 2a 64 65 66 2f 5d 0a 2d 2d .[/abc.*def/].--
0cd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0ce0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 69 73 6b 20 53 70 -------..Disk Sp
0cf0: 61 63 65 20 43 68 65 63 6b 73 0a 5e 5e 5e 5e 5e ace Checks.^^^^^
0d00: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 53 6f ^^^^^^^^^^^^..So
0d10: 6d 65 20 70 61 72 61 6d 65 74 65 72 73 20 79 6f me parameters yo
0d20: 75 20 63 61 6e 20 70 75 74 20 69 6e 20 74 68 65 u can put in the
0d30: 20 5b 73 65 74 75 70 5d 20 73 65 63 74 69 6f 6e [setup] section
0d40: 20 6f 66 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e of megatest.con
0d50: 66 69 67 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d fig:..----------
0d60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 6d 69 6e 69 ---------.# mini
0d70: 6d 75 6d 20 73 70 61 63 65 20 72 65 71 75 69 72 mum space requir
0d80: 65 64 20 69 6e 20 61 20 72 75 6e 20 64 69 73 6b ed in a run disk
0d90: 20 0a 6d 69 6e 73 70 61 63 65 20 31 30 30 30 30 .minspace 10000
0da0: 30 30 30 0a 0a 23 20 6d 69 6e 69 6d 75 6d 20 73 000..# minimum s
0db0: 70 61 63 65 20 72 65 71 75 69 72 65 64 20 69 6e pace required in
0dc0: 20 64 62 64 69 72 3a 0a 64 62 64 69 72 2d 73 70 dbdir:.dbdir-sp
0dd0: 61 63 65 2d 72 65 71 75 69 72 65 64 20 31 30 30 ace-required 100
0de0: 30 30 30 0a 0a 23 20 73 63 72 69 70 74 20 74 68 000..# script th
0df0: 61 74 20 74 61 6b 65 73 20 70 61 74 68 20 61 73 at takes path as
0e00: 20 70 61 72 61 6d 65 74 65 72 20 61 6e 64 20 72 parameter and r
0e10: 65 74 75 72 6e 73 20 6e 75 6d 62 65 72 20 6f 66 eturns number of
0e20: 20 62 79 74 65 73 20 61 76 61 69 6c 61 62 6c 65 bytes available
0e30: 3a 0a 66 72 65 65 2d 73 70 61 63 65 2d 73 63 72 :.free-space-scr
0e40: 69 70 74 20 63 68 65 63 6b 2d 73 70 61 63 65 2e ipt check-space.
0e50: 73 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d sh.-------------
0e60: 2d 2d 2d 2d 2d 2d 0a 0a 54 72 69 6d 20 74 72 61 ------..Trim tra
0e70: 69 6c 69 6e 67 20 73 70 61 63 65 73 0a 5e 5e 5e iling spaces.^^^
0e80: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
0e90: 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^..-------------
0ea0: 2d 2d 2d 2d 2d 0a 5b 63 6f 6e 66 69 67 66 3a 73 -----.[configf:s
0eb0: 65 74 74 69 6e 67 73 20 74 72 69 6d 2d 74 72 61 ettings trim-tra
0ec0: 69 6c 69 6e 67 2d 73 70 61 63 65 73 20 79 65 73 iling-spaces yes
0ed0: 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ].--------------
0ee0: 2d 2d 2d 2d 0a 0a 4a 6f 62 20 53 75 62 6d 69 73 ----..Job Submis
0ef0: 73 69 6f 6e 20 43 6f 6e 74 72 6f 6c 0a 5e 5e 5e sion Control.^^^
0f00: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
0f10: 5e 5e 5e 0a 0a 53 75 62 6d 69 74 20 6a 6f 62 73 ^^^..Submit jobs
0f20: 20 74 6f 20 48 6f 73 74 20 54 79 70 65 73 20 62 to Host Types b
0f30: 61 73 65 64 20 6f 6e 20 54 65 73 74 20 4e 61 6d ased on Test Nam
0f40: 65 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b e.++++++++++++++
0f50: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ++++++++++++++++
0f60: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a ++++++++++++++..
0f70: 2e 49 6e 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e .In megatest.con
0f80: 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d fig.------------
0f90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 68 6f ------------.[ho
0fa0: 73 74 2d 74 79 70 65 73 5d 0a 67 65 6e 65 72 61 st-types].genera
0fb0: 6c 20 20 20 6e 62 66 61 6b 65 0a 72 65 6d 6f 74 l nbfake.remot
0fc0: 65 20 20 20 20 62 73 75 62 0a 0a 5b 6c 61 75 6e e bsub..[laun
0fd0: 63 68 65 72 73 5d 0a 72 75 6e 66 69 72 73 74 2f chers].runfirst/
0fe0: 73 75 6d 25 20 72 65 6d 6f 74 65 0a 25 20 67 65 sum% remote.% ge
0ff0: 6e 65 72 61 6c 0a 0a 5b 6a 6f 62 74 6f 6f 6c 73 neral..[jobtools
1000: 5d 0a 6c 61 75 6e 63 68 65 72 20 62 73 75 62 0a ].launcher bsub.
1010: 23 20 69 66 20 64 65 66 69 6e 65 64 20 61 6e 64 # if defined and
1020: 20 6e 6f 74 20 22 6e 6f 22 20 66 6c 65 78 69 2d not "no" flexi-
1030: 6c 61 75 6e 63 68 65 72 20 77 69 6c 6c 20 62 79 launcher will by
1040: 70 61 73 73 20 6c 61 75 6e 63 68 65 72 20 75 6e pass launcher un
1050: 6c 65 73 73 20 0a 23 20 74 68 65 72 65 20 69 73 less .# there is
1060: 20 6e 6f 20 68 6f 73 74 2d 74 79 70 65 20 6d 61 no host-type ma
1070: 74 63 68 2e 0a 66 6c 65 78 69 2d 6c 61 75 6e 63 tch..flexi-launc
1080: 68 65 72 20 79 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d her yes.--------
1090: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
10a0: 0a 0a 68 6f 73 74 2d 74 79 70 65 73 0a 2b 2b 2b ..host-types.+++
10b0: 2b 2b 2b 2b 2b 2b 2b 0a 0a 4c 69 73 74 20 6f 66 +++++++..List of
10c0: 20 68 6f 73 74 20 74 79 70 65 73 20 61 6e 64 20 host types and
10d0: 74 68 65 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65 20 the commandline
10e0: 74 6f 20 72 75 6e 20 61 20 6a 6f 62 20 6f 6e 20 to run a job on
10f0: 74 68 61 74 20 68 6f 73 74 20 74 79 70 65 2e 0a that host type..
1100: 0a 2e 68 6f 73 74 2d 74 79 70 65 20 3d 3e 20 6c ..host-type => l
1110: 61 75 6e 63 68 20 63 6f 6d 6d 61 6e 64 0a 2d 2d aunch command.--
1120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 67 65 6e 65 72 ----------.gener
1130: 61 6c 20 6e 62 66 61 6b 65 0a 2d 2d 2d 2d 2d 2d al nbfake.------
1140: 2d 2d 2d 2d 2d 2d 0a 0a 6c 61 75 6e 63 68 65 72 ------..launcher
1150: 73 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 2e 74 65 s.+++++++++...te
1160: 73 74 2f 69 74 65 6d 70 61 74 68 20 3d 3e 20 68 st/itempath => h
1170: 6f 73 74 2d 74 79 70 65 0a 2d 2d 2d 2d 2d 2d 2d ost-type.-------
1180: 2d 2d 2d 2d 2d 0a 72 75 6e 66 69 72 73 74 2f 73 -----.runfirst/s
1190: 75 6d 25 20 72 65 6d 6f 74 65 0a 2d 2d 2d 2d 2d um% remote.-----
11a0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 4d 69 73 63 65 6c 6c -------..Miscell
11b0: 61 6e 65 6f 75 73 20 53 65 74 75 70 20 49 74 65 aneous Setup Ite
11c0: 6d 73 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ms.+++++++++++++
11d0: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 41 74 ++++++++++++..At
11e0: 74 65 6d 70 74 20 74 6f 20 72 65 72 75 6e 20 74 tempt to rerun t
11f0: 65 73 74 73 20 69 6e 20 22 53 54 55 43 4b 2f 44 ests in "STUCK/D
1200: 45 41 44 22 2c 20 22 6e 2f 61 22 2c 20 22 5a 45 EAD", "n/a", "ZE
1210: 52 4f 5f 49 54 45 4d 53 22 20 73 74 61 74 65 73 RO_ITEMS" states
1220: 2e 0a 0a 2e 49 6e 20 6d 65 67 61 74 65 73 74 2e ....In megatest.
1230: 63 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d config.---------
1240: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 70 ---------.[setup
1250: 5d 0a 72 65 72 75 6e 73 20 35 0a 2d 2d 2d 2d 2d ].reruns 5.-----
1260: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 -------------..R
1270: 65 70 6c 61 63 65 20 74 68 65 20 64 65 66 61 75 eplace the defau
1280: 6c 74 20 62 6c 61 63 6b 6c 69 73 74 65 64 20 65 lt blacklisted e
1290: 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 nvironment varia
12a0: 62 6c 65 73 20 77 69 74 68 20 75 73 65 72 20 73 bles with user s
12b0: 75 70 70 6c 69 65 64 0a 6c 69 73 74 2e 0a 0a 44 upplied.list...D
12c0: 65 66 61 75 6c 74 20 6c 69 73 74 3a 20 55 53 45 efault list: USE
12d0: 52 20 48 4f 4d 45 20 44 49 53 50 4c 41 59 20 4c R HOME DISPLAY L
12e0: 53 5f 43 4f 4c 4f 52 53 20 58 4b 45 59 53 59 4d S_COLORS XKEYSYM
12f0: 44 42 20 45 44 49 54 4f 52 20 4d 41 4b 45 46 4c DB EDITOR MAKEFL
1300: 41 47 53 20 4d 41 4b 45 46 20 4d 41 4b 45 4f 56 AGS MAKEF MAKEOV
1310: 45 52 52 49 44 45 53 0a 0a 2e 41 64 64 20 61 20 ERRIDES...Add a
1320: 22 62 61 64 22 20 76 61 72 69 61 62 6c 65 20 22 "bad" variable "
1330: 50 52 4f 4d 50 54 22 20 74 6f 20 74 68 65 20 76 PROMPT" to the v
1340: 61 72 69 61 62 6c 65 73 20 74 68 61 74 20 77 69 ariables that wi
1350: 6c 6c 20 62 65 20 63 6f 6d 6d 65 6e 74 65 64 20 ll be commented
1360: 6f 75 74 0a 69 6e 20 74 68 65 20 6d 65 67 61 74 out.in the megat
1370: 65 73 74 2e 73 68 20 61 6e 64 20 6d 65 67 61 74 est.sh and megat
1380: 65 73 74 2e 63 73 68 20 66 69 6c 65 73 3a 0a 2d est.csh files:.-
1390: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
13a0: 0a 5b 73 65 74 75 70 5d 0a 62 6c 61 63 6b 6c 69 .[setup].blackli
13b0: 73 74 76 61 72 73 20 55 53 45 52 20 48 4f 4d 45 stvars USER HOME
13c0: 20 44 49 53 50 4c 41 59 20 4c 53 5f 43 4f 4c 4f DISPLAY LS_COLO
13d0: 52 53 20 58 4b 45 59 53 59 4d 44 42 20 45 44 49 RS XKEYSYMDB EDI
13e0: 54 4f 52 20 4d 41 4b 45 46 4c 41 47 53 20 50 52 TOR MAKEFLAGS PR
13f0: 4f 4d 50 54 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d OMPT.-----------
1400: 2d 2d 2d 2d 2d 2d 0a 0a 52 75 6e 20 74 69 6d 65 ------..Run time
1410: 20 6c 69 6d 69 74 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b limit.+++++++++
1420: 2b 2b 2b 2b 2b 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d +++++..---------
1430: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 70 5d --------.[setup]
1440: 0a 23 20 74 68 69 73 20 77 69 6c 6c 20 61 75 74 .# this will aut
1450: 6f 6d 61 74 69 63 61 6c 6c 79 20 6b 69 6c 6c 20 omatically kill
1460: 74 68 65 20 74 65 73 74 20 69 66 20 69 74 20 72 the test if it r
1470: 75 6e 73 20 66 6f 72 20 6d 6f 72 65 20 74 68 61 uns for more tha
1480: 6e 20 31 68 20 32 6d 20 61 6e 64 20 33 73 0a 72 n 1h 2m and 3s.r
1490: 75 6e 74 69 6d 65 6c 69 6d 20 31 68 20 32 6d 20 untimelim 1h 2m
14a0: 33 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 3s.-------------
14b0: 2d 2d 2d 2d 0a 0a 54 65 73 74 73 20 62 72 6f 77 ----..Tests brow
14c0: 73 65 72 20 76 69 65 77 0a 7e 7e 7e 7e 7e 7e 7e ser view.~~~~~~~
14d0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 54 68 65 ~~~~~~~~~~~..The
14e0: 20 74 65 73 74 73 20 62 72 6f 77 73 65 72 20 28 tests browser (
14f0: 73 65 65 20 74 68 65 20 52 75 6e 20 43 6f 6e 74 see the Run Cont
1500: 72 6f 6c 20 74 61 62 20 6f 6e 20 74 68 65 20 64 rol tab on the d
1510: 61 73 68 62 6f 61 72 64 29 20 68 61 73 20 74 77 ashboard) has tw
1520: 6f 20 76 69 65 77 73 20 66 6f 72 20 64 69 73 70 o views for disp
1530: 6c 61 79 69 6e 67 20 74 68 65 20 74 65 73 74 73 laying the tests
1540: 2e 20 0a 0a 2e 20 44 6f 74 20 28 67 72 61 70 68 . ... Dot (graph
1550: 76 69 7a 29 20 62 61 73 65 64 20 74 72 65 65 0a viz) based tree.
1560: 2e 20 4e 6f 20 64 6f 74 2c 20 70 6c 61 69 6e 20 . No dot, plain
1570: 6c 69 73 74 69 6e 67 0a 0a 54 68 65 20 64 65 66 listing..The def
1580: 61 75 6c 74 20 69 73 20 74 68 65 20 67 72 61 70 ault is the grap
1590: 68 76 69 7a 20 62 61 73 65 64 20 74 72 65 65 20 hviz based tree
15a0: 62 75 74 20 69 66 20 79 6f 75 72 20 74 65 73 74 but if your test
15b0: 73 20 64 6f 6e 27 74 20 76 69 65 77 0a 77 65 6c s don't view.wel
15c0: 6c 20 69 6e 20 74 68 61 74 20 6d 6f 64 65 20 74 l in that mode t
15d0: 68 65 6e 20 75 73 65 20 22 6e 6f 64 6f 74 22 20 hen use "nodot"
15e0: 74 6f 20 74 75 72 6e 20 69 74 20 6f 66 66 2e 0a to turn it off..
15f0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
1600: 2d 2d 0a 5b 73 65 74 75 70 5d 0a 6e 6f 64 6f 74 --.[setup].nodot
1610: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
1620: 2d 2d 0a 0a 43 61 70 74 75 72 69 6e 67 20 54 65 --..Capturing Te
1630: 73 74 20 44 61 74 61 0a 7e 7e 7e 7e 7e 7e 7e 7e st Data.~~~~~~~~
1640: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 20 ~~~~~~~~~~~..In
1650: 61 20 74 65 73 74 20 79 6f 75 20 63 61 6e 20 63 a test you can c
1660: 61 70 74 75 72 65 20 61 72 62 69 74 72 61 72 79 apture arbitrary
1670: 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 72 variables and r
1680: 6f 6c 6c 20 74 68 65 6d 20 75 70 20 69 6e 20 74 oll them up in t
1690: 68 65 0a 6d 65 67 61 74 65 73 74 20 64 61 74 61 he.megatest data
16a0: 62 61 73 65 20 66 6f 72 20 76 69 65 77 69 6e 67 base for viewing
16b0: 20 6f 6e 20 74 68 65 20 64 61 73 68 62 6f 61 72 on the dashboar
16c0: 64 20 6f 72 20 77 65 62 20 61 70 70 2e 0a 0a 2e d or web app....
16d0: 49 6e 20 61 20 74 65 73 74 20 61 73 20 61 20 73 In a test as a s
16e0: 63 72 69 70 74 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d cript.----------
16f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 24 --------------.$
1700: 4d 54 5f 4d 45 47 41 54 45 53 54 20 2d 6c 6f 61 MT_MEGATEST -loa
1710: 64 2d 74 65 73 74 2d 64 61 74 61 20 3c 3c 20 45 d-test-data << E
1720: 4f 46 0a 66 6f 6f 2c 62 61 72 2c 20 20 20 31 2e OF.foo,bar, 1.
1730: 32 2c 20 20 31 2e 39 2c 20 3e 0a 66 6f 6f 2c 72 2, 1.9, >.foo,r
1740: 61 62 2c 20 31 2e 30 65 39 2c 20 31 30 65 39 2c ab, 1.0e9, 10e9,
1750: 20 31 65 39 0a 66 6f 6f 2c 62 6c 61 2c 20 20 20 1e9.foo,bla,
1760: 31 2e 32 2c 20 20 31 2e 39 2c 20 3c 0a 66 6f 6f 1.2, 1.9, <.foo
1770: 2c 62 61 6c 2c 20 20 20 31 2e 32 2c 20 20 31 2e ,bal, 1.2, 1.
1780: 32 2c 20 3c 20 20 20 2c 20 20 20 20 20 2c 43 68 2, < , ,Ch
1790: 65 63 6b 20 66 6f 72 20 6f 76 65 72 6c 6f 61 64 eck for overload
17a0: 0a 66 6f 6f 2c 61 6c 62 2c 20 20 20 31 2e 32 2c .foo,alb, 1.2,
17b0: 20 20 31 2e 32 2c 20 3c 3d 20 20 2c 20 41 6d 70 1.2, <= , Amp
17c0: 73 2c 54 68 69 73 20 69 73 20 74 68 65 20 68 69 s,This is the hi
17d0: 67 68 20 70 6f 77 65 72 20 63 69 72 63 75 69 74 gh power circuit
17e0: 20 74 65 73 74 0a 66 6f 6f 2c 61 62 6c 2c 20 20 test.foo,abl,
17f0: 20 31 2e 32 2c 20 20 31 2e 33 2c 20 30 2e 31 0a 1.2, 1.3, 0.1.
1800: 66 6f 6f 2c 62 72 61 2c 20 20 20 31 2e 32 2c 20 foo,bra, 1.2,
1810: 70 61 73 73 2c 20 73 69 6c 6c 79 20 73 74 75 66 pass, silly stuf
1820: 66 0a 66 61 7a 2c 62 61 72 2c 20 20 20 20 31 30 f.faz,bar, 10
1830: 2c 20 20 38 6d 41 2c 20 20 20 20 20 2c 20 20 20 , 8mA, ,
1840: 20 20 2c 22 74 68 69 73 20 69 73 20 61 20 63 6f ,"this is a co
1850: 6d 6d 65 6e 74 22 0a 45 4f 46 0a 2d 2d 2d 2d 2d mment".EOF.-----
1860: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1870: 2d 2d 2d 0a 0a 41 6c 74 65 72 6e 61 74 69 76 65 ---..Alternative
1880: 6c 79 20 79 6f 75 20 63 61 6e 20 75 73 65 20 6c ly you can use l
1890: 6f 67 70 72 6f 20 74 72 69 67 67 65 72 73 20 74 ogpro triggers t
18a0: 6f 20 63 61 70 74 75 72 65 20 76 61 6c 75 65 73 o capture values
18b0: 20 61 6e 64 20 69 6e 6a 65 63 74 20 74 68 65 6d and inject them
18c0: 0a 69 6e 74 6f 20 6d 65 67 61 74 65 73 74 20 75 .into megatest u
18d0: 73 69 6e 67 20 74 68 65 20 2d 73 65 74 2d 76 61 sing the -set-va
18e0: 6c 75 65 73 20 6d 65 63 68 61 6e 69 73 6d 3a 0a lues mechanism:.
18f0: 0a 2e 4d 65 67 61 74 65 73 74 20 68 65 6c 70 20 ..Megatest help
1900: 72 65 6c 61 74 65 64 20 74 6f 20 2d 73 65 74 2d related to -set-
1910: 76 61 6c 75 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d values.---------
1920: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
1930: 54 65 73 74 20 64 61 74 61 20 63 61 70 74 75 72 Test data captur
1940: 65 0a 20 20 2d 73 65 74 2d 76 61 6c 75 65 73 20 e. -set-values
1950: 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 75 70 : up
1960: 64 61 74 65 20 6f 72 20 73 65 74 20 76 61 6c 75 date or set valu
1970: 65 73 20 69 6e 20 74 68 65 20 74 65 73 74 64 61 es in the testda
1980: 74 61 20 74 61 62 6c 65 0a 20 20 3a 63 61 74 65 ta table. :cate
1990: 67 6f 72 79 20 20 20 20 20 20 20 20 20 20 20 20 gory
19a0: 20 20 20 3a 20 73 65 74 20 74 68 65 20 63 61 74 : set the cat
19b0: 65 67 6f 72 79 20 66 69 65 6c 64 20 28 6f 70 74 egory field (opt
19c0: 69 6f 6e 61 6c 29 0a 20 20 3a 76 61 72 69 61 62 ional). :variab
19d0: 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 le
19e0: 20 3a 20 73 65 74 20 74 68 65 20 76 61 72 69 61 : set the varia
19f0: 62 6c 65 20 6e 61 6d 65 20 28 6f 70 74 69 6f 6e ble name (option
1a00: 61 6c 29 0a 20 20 3a 76 61 6c 75 65 20 20 20 20 al). :value
1a10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 :
1a20: 76 61 6c 75 65 20 6d 65 61 73 75 72 65 64 20 28 value measured (
1a30: 72 65 71 75 69 72 65 64 29 0a 20 20 3a 65 78 70 required). :exp
1a40: 65 63 74 65 64 20 20 20 20 20 20 20 20 20 20 20 ected
1a50: 20 20 20 20 3a 20 76 61 6c 75 65 20 65 78 70 65 : value expe
1a60: 63 74 65 64 20 28 72 65 71 75 69 72 65 64 29 0a cted (required).
1a70: 20 20 3a 74 6f 6c 20 20 20 20 20 20 20 20 20 20 :tol
1a80: 20 20 20 20 20 20 20 20 20 20 3a 20 7c 76 61 6c : |val
1a90: 75 65 2d 65 78 70 65 63 74 7c 20 3c 3d 20 74 6f ue-expect| <= to
1aa0: 6c 20 28 72 65 71 75 69 72 65 64 2c 20 63 61 6e l (required, can
1ab0: 20 62 65 20 3c 2c 20 3e 2c 20 3e 3d 2c 20 3c 3d be <, >, >=, <=
1ac0: 20 6f 72 20 6e 75 6d 62 65 72 29 0a 20 20 3a 75 or number). :u
1ad0: 6e 69 74 73 20 20 20 20 20 20 20 20 20 20 20 20 nits
1ae0: 20 20 20 20 20 20 3a 20 6e 61 6d 65 20 6f 66 20 : name of
1af0: 74 68 65 20 75 6e 69 74 73 20 66 6f 72 20 76 61 the units for va
1b00: 6c 75 65 2c 20 65 78 70 65 63 74 65 64 5f 76 61 lue, expected_va
1b10: 6c 75 65 20 65 74 63 2e 20 28 6f 70 74 69 6f 6e lue etc. (option
1b20: 61 6c 29 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d al).------------
1b30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 61 ------------..Da
1b40: 73 68 62 6f 61 72 64 20 73 65 74 74 69 6e 67 73 shboard settings
1b50: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e .~~~~~~~~~~~~~~~
1b60: 7e 7e 7e 0a 0a 2e 52 75 6e 73 20 74 61 62 20 62 ~~~...Runs tab b
1b70: 75 74 74 6f 6e 73 2c 20 66 6f 6e 74 20 61 6e 64 uttons, font and
1b80: 20 73 69 7a 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d size.----------
1b90: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 64 61 73 68 62 6f --------.[dashbo
1ba0: 61 72 64 5d 0a 62 74 6e 2d 68 65 69 67 68 74 20 ard].btn-height
1bb0: 78 31 34 0a 62 74 6e 2d 66 6f 6e 74 73 7a 20 31 x14.btn-fontsz 1
1bc0: 30 0a 63 65 6c 6c 2d 77 69 64 74 68 20 36 30 0a 0.cell-width 60.
1bd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1be0: 2d 2d 0a 0a 44 61 74 61 62 61 73 65 20 73 65 74 --..Database set
1bf0: 74 69 6e 67 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e tings.~~~~~~~~~~
1c00: 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 44 61 74 61 62 61 ~~~~~~~...Databa
1c10: 73 65 20 63 6f 6e 66 69 67 20 73 65 74 74 69 6e se config settin
1c20: 67 73 20 69 6e 20 5b 73 65 74 75 70 5d 20 73 65 gs in [setup] se
1c30: 63 74 69 6f 6e 20 6f 66 20 6d 65 67 61 74 65 73 ction of megates
1c40: 74 2e 63 6f 6e 66 69 67 0a 5b 77 69 64 74 68 3d t.config.[width=
1c50: 22 37 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d "70%",cols="^,2m
1c60: 2c 32 6d 2c 32 6d 22 2c 66 72 61 6d 65 3d 22 74 ,2m,2m",frame="t
1c70: 6f 70 62 6f 74 22 2c 6f 70 74 69 6f 6e 73 3d 22 opbot",options="
1c80: 68 65 61 64 65 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d header"].|======
1c90: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
1ca0: 0a 7c 56 61 72 20 20 20 20 20 20 20 20 20 20 20 .|Var
1cb0: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 50 75 | Pu
1cc0: 72 70 6f 73 65 20 20 20 20 20 20 20 20 20 20 20 rpose
1cd0: 20 7c 20 56 61 6c 69 64 20 76 61 6c 75 65 73 20 | Valid values
1ce0: 20 20 20 20 20 20 20 20 20 20 20 7c 20 43 6f 6d | Com
1cf0: 6d 65 6e 74 73 0a 7c 64 65 6c 61 79 2d 6f 6e 2d ments.|delay-on-
1d00: 62 75 73 79 20 20 20 20 20 20 20 20 20 20 20 20 busy
1d10: 20 7c 20 50 72 65 76 65 6e 74 20 63 6f 6e 63 75 | Prevent concu
1d20: 72 72 65 6e 74 20 61 63 63 65 73 73 20 69 73 73 rrent access iss
1d30: 75 65 73 20 7c 20 79 65 73 5c 7c 6e 6f 20 6f 72 ues | yes\|no or
1d40: 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 7c 20 44 not defined | D
1d50: 65 66 61 75 6c 74 3d 6e 6f 2c 20 6d 61 79 20 68 efault=no, may h
1d60: 65 6c 70 20 6f 6e 20 73 6f 6d 65 20 6e 65 74 77 elp on some netw
1d70: 6f 72 6b 20 66 69 6c 65 20 73 79 73 74 65 6d 73 ork file systems
1d80: 2c 20 6d 61 79 20 73 6c 6f 77 20 74 68 69 6e 67 , may slow thing
1d90: 73 20 64 6f 77 6e 20 61 6c 73 6f 2e 0a 7c 66 61 s down also..|fa
1da0: 73 74 73 74 61 72 74 09 09 20 20 20 7c 20 41 6c ststart.. | Al
1db0: 6c 20 64 69 72 65 63 74 20 66 69 6c 65 20 61 63 l direct file ac
1dc0: 63 65 73 73 20 74 6f 20 73 71 6c 69 74 65 20 64 cess to sqlite d
1dd0: 62 20 66 69 6c 65 73 20 7c 20 79 65 73 5c 7c 6e b files | yes\|n
1de0: 6f 20 6f 72 20 6e 6f 74 20 64 65 66 69 6e 65 64 o or not defined
1df0: 20 7c 20 44 65 66 61 75 6c 74 3d 79 65 73 2c 20 | Default=yes,
1e00: 73 75 67 67 65 73 74 20 6e 6f 20 66 6f 72 20 63 suggest no for c
1e10: 65 6e 74 72 61 6c 20 61 75 74 6f 6d 61 74 65 64 entral automated
1e20: 20 73 79 73 74 65 6d 73 20 61 6e 64 20 79 65 73 systems and yes
1e30: 20 66 6f 72 20 69 6e 74 65 72 61 63 74 69 76 65 for interactive
1e40: 20 75 73 65 0a 7c 68 6f 6d 65 68 6f 73 74 20 09 use.|homehost .
1e50: 09 20 20 20 7c 20 53 74 61 72 74 20 73 65 72 76 . | Start serv
1e60: 65 72 73 20 6f 6e 20 74 68 69 73 20 68 6f 73 74 ers on this host
1e70: 20 7c 20 3c 68 6f 73 74 6e 61 6d 65 3e 20 7c 20 | <hostname> |
1e80: 44 65 66 61 75 6c 74 73 20 74 6f 20 6c 6f 63 61 Defaults to loca
1e90: 6c 20 68 6f 73 74 0a 7c 68 6f 73 74 6e 61 6d 65 l host.|hostname
1ea0: 09 09 20 20 20 7c 20 48 6f 73 74 6e 61 6d 65 20 .. | Hostname
1eb0: 74 6f 20 62 69 6e 64 20 74 6f 20 7c 20 3c 68 6f to bind to | <ho
1ec0: 73 74 6e 61 6d 65 3e 5c 7c 2d 09 20 20 7c 20 4f stname>\|-. | O
1ed0: 6e 20 6d 75 6c 74 69 2d 68 6f 6d 65 64 20 68 6f n multi-homed ho
1ee0: 73 74 73 20 61 6c 6c 6f 77 73 20 62 69 6e 64 69 sts allows bindi
1ef0: 6e 67 20 74 6f 20 73 70 65 63 69 66 69 63 20 68 ng to specific h
1f00: 6f 73 74 6e 61 6d 65 0a 7c 6c 6f 77 70 6f 72 74 ostname.|lowport
1f10: 09 09 20 20 20 7c 20 53 74 61 72 74 20 73 65 61 .. | Start sea
1f20: 72 63 68 69 6e 67 20 66 6f 72 20 61 20 70 6f 72 rching for a por
1f30: 74 20 61 74 20 74 68 69 73 20 70 6f 72 74 6e 75 t at this portnu
1f40: 6d 7c 20 33 32 37 36 38 20 7c 20 0a 7c 72 65 71 m| 32768 | .|req
1f50: 75 69 72 65 64 09 09 20 20 20 7c 20 53 65 72 76 uired.. | Serv
1f60: 65 72 20 72 65 71 75 69 72 65 64 20 20 20 20 7c er required |
1f70: 20 79 65 73 5c 7c 6e 6f 20 6f 72 20 6e 6f 74 20 yes\|no or not
1f80: 64 65 66 69 6e 65 64 20 20 7c 20 44 65 66 61 75 defined | Defau
1f90: 6c 74 3d 6e 6f 2c 20 66 6f 72 63 65 20 73 74 61 lt=no, force sta
1fa0: 72 74 20 6f 66 20 73 65 72 76 65 72 20 61 6c 77 rt of server alw
1fb0: 61 79 73 0a 7c 73 65 72 76 65 72 2d 71 75 65 72 ays.|server-quer
1fc0: 79 2d 74 68 72 65 73 68 6f 6c 64 09 20 20 20 7c y-threshold. |
1fd0: 20 53 74 61 72 74 20 73 65 72 76 65 72 20 77 68 Start server wh
1fe0: 65 6e 20 71 75 65 72 69 65 73 20 74 61 6b 65 20 en queries take
1ff0: 6c 6f 6e 67 65 72 20 74 68 61 6e 20 74 68 69 73 longer than this
2000: 20 7c 20 6e 75 6d 62 65 72 20 69 6e 20 6d 69 6c | number in mil
2010: 6c 69 73 65 63 6f 6e 64 73 20 7c 20 44 65 66 61 liseconds | Defa
2020: 75 6c 74 3d 33 30 30 0a 7c 74 69 6d 65 6f 75 74 ult=300.|timeout
2030: 09 09 20 20 20 7c 20 68 74 74 70 20 61 70 69 20 .. | http api
2040: 74 69 6d 65 6f 75 74 20 09 7c 20 6e 75 6d 62 65 timeout .| numbe
2050: 72 20 69 6e 20 68 6f 75 72 73 09 20 20 7c 20 44 r in hours. | D
2060: 65 66 61 75 6c 74 20 69 73 20 31 20 6d 69 6e 75 efault is 1 minu
2070: 74 65 2c 20 64 6f 20 6e 6f 74 20 63 68 61 6e 67 te, do not chang
2080: 65 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d e.|=============
2090: 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 65 20 74 =========..The t
20a0: 65 73 74 63 6f 6e 66 69 67 20 46 69 6c 65 0a 2d estconfig File.-
20b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
20c0: 2d 2d 0a 0a 53 65 74 75 70 20 73 65 63 74 69 6f --..Setup sectio
20d0: 6e 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a n.~~~~~~~~~~~~~.
20e0: 0a 48 65 61 64 65 72 0a 5e 5e 5e 5e 5e 5e 0a 0a .Header.^^^^^^..
20f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2100: 2d 2d 2d 0a 5b 73 65 74 75 70 5d 0a 2d 2d 2d 2d ---.[setup].----
2110: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
2120: 0a 54 68 65 20 72 75 6e 73 63 72 69 70 74 20 6d .The runscript m
2130: 65 74 68 6f 64 20 69 73 20 61 20 62 72 75 74 65 ethod is a brute
2140: 20 66 6f 72 63 65 20 77 61 79 20 74 6f 20 72 75 force way to ru
2150: 6e 20 73 63 72 69 70 74 73 20 77 68 65 72 65 20 n scripts where
2160: 74 68 65 0a 75 73 65 72 20 69 73 20 72 65 73 70 the.user is resp
2170: 6f 6e 73 69 62 6c 65 20 66 6f 72 20 73 65 74 74 onsible for sett
2180: 69 6e 67 20 53 54 41 54 45 20 61 6e 64 20 53 54 ing STATE and ST
2190: 41 54 55 53 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ATUS..----------
21a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 72 75 6e 73 63 72 ---------.runscr
21b0: 69 70 74 20 6d 61 69 6e 2e 63 73 68 0a 2d 2d 2d ipt main.csh.---
21c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
21d0: 0a 0a 52 65 71 75 69 72 65 6d 65 6e 74 73 20 73 ..Requirements s
21e0: 65 63 74 69 6f 6e 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e ection.~~~~~~~~~
21f0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 48 65 ~~~~~~~~~~~...He
2200: 61 64 65 72 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ader.-----------
2210: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 --------.[requir
2220: 65 6d 65 6e 74 73 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d ements].--------
2230: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 57 61 69 -----------..Wai
2240: 74 20 6f 6e 20 4f 74 68 65 72 20 54 65 73 74 73 t on Other Tests
2250: 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e .^^^^^^^^^^^^^^^
2260: 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^^^..----------
2270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 41 20 6e 6f ---------.# A no
2280: 72 6d 61 6c 20 77 61 69 74 6f 6e 20 77 61 69 74 rmal waiton wait
2290: 73 20 66 6f 72 20 74 68 65 20 70 72 69 6f 72 20 s for the prior
22a0: 74 65 73 74 73 20 74 6f 20 62 65 20 43 4f 4d 50 tests to be COMP
22b0: 4c 45 54 45 44 20 0a 23 20 61 6e 64 20 50 41 53 LETED .# and PAS
22c0: 53 2c 20 43 48 45 43 4b 20 6f 72 20 57 41 49 56 S, CHECK or WAIV
22d0: 45 44 0a 77 61 69 74 6f 6e 20 74 65 73 74 31 20 ED.waiton test1
22e0: 74 65 73 74 32 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d test2.----------
22f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4d 6f 64 65 0a ---------..Mode.
2300: 5e 5e 5e 5e 0a 0a 54 68 65 20 64 65 66 61 75 6c ^^^^..The defaul
2310: 74 20 28 69 2e 65 2e 20 69 66 20 6d 6f 64 65 20 t (i.e. if mode
2320: 69 73 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 is not specified
2330: 29 20 69 73 20 6e 6f 72 6d 61 6c 2e 20 41 6c 6c ) is normal. All
2340: 20 70 72 65 2d 64 65 70 65 6e 64 65 6e 74 20 74 pre-dependent t
2350: 65 73 74 73 0a 6d 75 73 74 20 62 65 20 43 4f 4d ests.must be COM
2360: 50 4c 45 54 45 44 20 61 6e 64 20 50 41 53 53 2c PLETED and PASS,
2370: 20 43 48 45 43 4b 20 6f 72 20 57 41 49 56 45 44 CHECK or WAIVED
2380: 20 62 65 66 6f 72 65 20 74 68 65 20 74 65 73 74 before the test
2390: 20 77 69 6c 6c 20 73 74 61 72 74 0a 0a 2d 2d 2d will start..---
23a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
23b0: 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a .[requirements].
23c0: 6d 6f 64 65 20 20 20 6e 6f 72 6d 61 6c 0a 2d 2d mode normal.--
23d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
23e0: 2d 0a 0a 54 68 65 20 74 6f 70 6c 65 76 65 6c 20 -..The toplevel
23f0: 6d 6f 64 65 20 72 65 71 75 69 72 65 73 20 6f 6e mode requires on
2400: 6c 79 20 74 68 61 74 20 74 68 65 20 70 72 69 6f ly that the prio
2410: 72 20 74 65 73 74 73 20 61 72 65 20 43 4f 4d 50 r tests are COMP
2420: 4c 45 54 45 44 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d LETED...--------
2430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 -----------.[req
2440: 75 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 uirements].mode
2450: 74 6f 70 6c 65 76 65 6c 0a 2d 2d 2d 2d 2d 2d 2d toplevel.-------
2460: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 20 ------------..A
2470: 69 74 65 6d 20 62 61 73 65 64 20 77 61 69 74 6f item based waito
2480: 6e 20 77 69 6c 6c 20 73 74 61 72 74 20 69 74 65 n will start ite
2490: 6d 73 20 69 6e 20 61 20 74 65 73 74 20 77 68 65 ms in a test whe
24a0: 6e 20 74 68 65 20 73 61 6d 65 2d 6e 61 6d 65 64 n the same-named
24b0: 0a 69 74 65 6d 20 69 73 20 43 4f 4d 50 4c 45 54 .item is COMPLET
24c0: 45 44 20 61 6e 64 20 50 41 53 53 2c 20 43 48 45 ED and PASS, CHE
24d0: 43 4b 20 6f 72 20 57 41 49 56 45 44 20 69 6e 20 CK or WAIVED in
24e0: 74 68 65 20 70 72 69 6f 72 20 74 65 73 74 2e 20 the prior test.
24f0: 54 68 69 73 0a 77 61 73 20 68 69 73 74 6f 72 69 This.was histori
2500: 63 61 6c 6c 79 20 63 61 6c 6c 65 64 20 22 69 74 cally called "it
2510: 65 6d 77 61 69 74 22 20 6d 6f 64 65 2e 20 54 68 emwait" mode. Th
2520: 65 20 74 65 72 6d 73 20 22 69 74 65 6d 77 61 69 e terms "itemwai
2530: 74 22 20 61 6e 64 0a 22 69 74 65 6d 6d 61 74 63 t" and."itemmatc
2540: 68 22 20 61 72 65 20 73 79 6e 6f 6e 79 6d 73 2e h" are synonyms.
2550: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
2560: 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 -----.[requireme
2570: 6e 74 73 5d 0a 6d 6f 64 65 20 69 74 65 6d 6d 61 nts].mode itemma
2580: 74 63 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d tch.------------
2590: 2d 2d 2d 2d 2d 2d 2d 0a 0a 4f 76 65 72 72 69 64 -------..Overrid
25a0: 69 6e 67 20 45 6e 76 69 72 6f 6d 65 6e 74 20 56 ing Enviroment V
25b0: 61 72 69 61 62 6c 65 73 0a 7e 7e 7e 7e 7e 7e 7e ariables.~~~~~~~
25c0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
25d0: 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 4f 76 65 72 72 69 ~~~~~~~~..Overri
25e0: 64 65 20 76 61 72 69 61 62 6c 65 73 20 62 65 66 de variables bef
25f0: 6f 72 65 20 73 74 61 72 74 69 6e 67 20 74 68 65 ore starting the
2600: 20 74 65 73 74 2e 20 43 61 6e 20 69 6e 63 6c 75 test. Can inclu
2610: 64 65 20 66 69 6c 65 73 20 28 70 65 72 68 61 70 de files (perhap
2620: 73 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 6d s generated by m
2630: 65 67 61 74 65 73 74 20 2d 65 6e 76 64 65 6c 74 egatest -envdelt
2640: 61 20 6f 72 20 73 69 6d 69 6c 61 72 29 2e 0a 0a a or similar)...
2650: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2660: 2d 2d 2d 2d 0a 5b 70 72 65 2d 6c 61 75 6e 63 68 ----.[pre-launch
2670: 2d 65 6e 76 2d 76 61 72 73 5d 0a 56 41 52 31 20 -env-vars].VAR1
2680: 76 61 6c 75 65 31 0a 0a 23 20 47 65 74 20 73 6f value1..# Get so
2690: 6d 65 20 67 65 6e 65 72 61 74 65 64 20 73 65 74 me generated set
26a0: 74 69 6e 67 73 0a 5b 69 6e 63 6c 75 64 65 20 2e tings.[include .
26b0: 2e 2f 67 65 6e 65 72 61 74 65 64 2d 76 61 72 73 ./generated-vars
26c0: 2e 63 6f 6e 66 69 67 5d 0a 0a 23 20 55 73 65 20 .config]..# Use
26d0: 74 68 69 73 20 74 72 69 63 6b 20 74 6f 20 75 6e this trick to un
26e0: 73 65 74 20 76 61 72 69 61 62 6c 65 73 0a 23 7b set variables.#{
26f0: 73 63 68 65 6d 65 20 28 75 6e 73 65 74 65 6e 76 scheme (unsetenv
2700: 20 22 46 4f 4f 42 41 52 22 29 7d 0a 2d 2d 2d 2d "FOOBAR")}.----
2710: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2720: 0a 0a 49 74 65 6d 6d 61 70 20 48 61 6e 64 6c 69 ..Itemmap Handli
2730: 6e 67 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ng.~~~~~~~~~~~~~
2740: 7e 7e 7e 0a 0a 46 6f 72 20 63 61 73 65 73 20 77 ~~~..For cases w
2750: 65 72 65 20 74 68 65 20 64 65 70 65 6e 64 65 6e ere the dependen
2760: 74 20 74 65 73 74 20 68 61 73 20 61 20 73 69 6d t test has a sim
2770: 69 6c 61 72 20 62 75 74 20 6e 6f 74 20 69 64 65 ilar but not ide
2780: 6e 74 69 63 61 6c 0a 69 74 65 6d 70 61 74 68 20 ntical.itempath
2790: 74 6f 20 74 68 65 20 64 6f 77 6e 73 74 72 65 61 to the downstrea
27a0: 6d 20 74 65 73 74 20 61 6e 20 69 74 65 6d 6d 61 m test an itemma
27b0: 70 20 63 61 6e 20 61 6c 6c 6f 77 20 66 6f 72 20 p can allow for
27c0: 69 74 65 6d 6d 61 74 63 68 0a 6d 6f 64 65 0a 0a itemmatch.mode..
27d0: 2e 65 78 61 6d 70 6c 65 20 66 6f 72 20 72 65 6d .example for rem
27e0: 6f 76 69 6e 67 20 70 61 72 74 20 6f 66 20 69 74 oving part of it
27f0: 65 6d 6d 61 70 20 66 6f 72 20 77 61 69 74 6f 6e emmap for waiton
2800: 20 74 65 73 74 20 28 65 67 3a 20 69 74 65 6d 20 test (eg: item
2810: 2b 66 6f 6f 2d 78 2f 62 61 72 2b 20 64 65 70 65 +foo-x/bar+ depe
2820: 6e 64 73 20 6f 6e 20 77 61 69 74 6f 6e 27 73 20 nds on waiton's
2830: 69 74 65 6d 20 2b 79 2f 62 61 72 2b 29 0a 2d 2d item +y/bar+).--
2840: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2850: 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d -.[requirements]
2860: 0a 6d 6f 64 65 20 69 74 65 6d 77 61 69 74 0a 23 .mode itemwait.#
2870: 20 69 74 65 6d 6d 61 70 20 3c 69 74 65 6d 20 70 itemmap <item p
2880: 61 74 74 65 72 6e 20 66 6f 72 20 74 68 69 73 20 attern for this
2890: 74 65 73 74 3e 20 20 3c 69 74 65 6d 20 72 65 70 test> <item rep
28a0: 6c 61 63 65 6d 65 6e 74 20 70 61 74 74 65 72 6e lacement pattern
28b0: 20 66 6f 72 20 77 61 69 74 6f 6e 20 74 65 73 74 for waiton test
28c0: 3e 0a 69 74 65 6d 6d 61 70 20 2e 2a 78 2f 20 79 >.itemmap .*x/ y
28d0: 2f 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d /..-------------
28e0: 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 78 61 6d 70 6c 65 ------...example
28f0: 20 66 6f 72 20 72 65 6d 6f 76 69 6e 67 20 70 61 for removing pa
2900: 72 74 20 6f 66 20 69 74 65 6d 6d 61 70 20 66 6f rt of itemmap fo
2910: 72 20 77 61 69 74 6f 6e 20 74 65 73 74 20 28 65 r waiton test (e
2920: 67 3a 20 69 74 65 6d 20 2b 66 6f 6f 2f 62 61 72 g: item +foo/bar
2930: 2f 62 61 7a 2b 20 69 6e 20 74 68 69 73 20 74 65 /baz+ in this te
2940: 73 74 20 64 65 70 65 6e 64 73 20 6f 6e 20 77 61 st depends on wa
2950: 69 74 6f 6e 27 73 20 69 74 65 6d 20 2b 62 61 7a iton's item +baz
2960: 2b 29 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d +).-------------
2970: 2d 2d 2d 2d 2d 2d 0a 0a 23 20 23 23 20 70 61 74 ------..# ## pat
2980: 74 65 72 6e 20 72 65 70 6c 61 63 65 6d 65 6e 74 tern replacement
2990: 20 6e 6f 74 65 73 0a 23 0a 23 20 23 23 20 45 78 notes.#.# ## Ex
29a0: 61 6d 70 6c 65 0a 23 20 23 23 20 52 65 6d 6f 76 ample.# ## Remov
29b0: 65 20 65 76 65 72 79 74 68 69 6e 67 20 75 70 20 e everything up
29c0: 74 6f 20 74 68 65 20 6c 61 73 74 20 2f 0a 5b 72 to the last /.[r
29d0: 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 equirements].mod
29e0: 65 20 69 74 65 6d 77 61 69 74 0a 23 20 69 74 65 e itemwait.# ite
29f0: 6d 6d 61 70 20 3c 69 74 65 6d 20 70 61 74 74 65 mmap <item patte
2a00: 72 6e 20 66 6f 72 20 74 68 69 73 20 74 65 73 74 rn for this test
2a10: 3e 20 3c 6e 6f 74 68 69 6e 67 20 68 65 72 65 20 > <nothing here
2a20: 69 6e 64 69 63 61 74 65 73 20 72 65 6d 6f 76 61 indicates remova
2a30: 6c 3e 0a 69 74 65 6d 6d 61 70 20 2e 2a 2f 0a 2d l>.itemmap .*/.-
2a40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2a50: 2d 2d 0a 0a 2e 65 78 61 6d 70 6c 65 20 72 65 70 --...example rep
2a60: 6c 61 63 69 6e 67 20 70 61 72 74 20 6f 66 20 69 lacing part of i
2a70: 74 65 6d 6d 61 70 20 66 6f 72 20 28 65 67 3a 20 temmap for (eg:
2a80: 69 74 65 6d 20 2b 66 6f 6f 2f 31 32 33 34 2b 20 item +foo/1234+
2a90: 77 69 6c 6c 20 69 6d 70 6c 79 20 77 61 69 74 6f will imply waito
2aa0: 6e 27 73 20 69 74 65 6d 20 2b 62 61 72 2f 31 32 n's item +bar/12
2ab0: 33 34 2b 29 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 34+).-----------
2ac0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 23 0a 23 20 23 23 --------..#.# ##
2ad0: 20 45 78 61 6d 70 6c 65 0a 23 20 23 23 20 52 65 Example.# ## Re
2ae0: 70 6c 61 63 65 20 66 6f 6f 2f 20 77 69 74 68 20 place foo/ with
2af0: 62 61 72 2f 0a 5b 72 65 71 75 69 72 65 6d 65 6e bar/.[requiremen
2b00: 74 73 5d 0a 6d 6f 64 65 20 69 74 65 6d 77 61 69 ts].mode itemwai
2b10: 74 0a 23 20 69 74 65 6d 6d 61 70 20 3c 69 74 65 t.# itemmap <ite
2b20: 6d 20 70 61 74 74 65 72 6e 20 66 6f 72 20 74 68 m pattern for th
2b30: 69 73 20 74 65 73 74 3e 20 20 3c 69 74 65 6d 20 is test> <item
2b40: 72 65 70 6c 61 63 65 6d 65 6e 74 20 70 61 74 74 replacement patt
2b50: 65 72 6e 20 66 6f 72 20 77 61 69 74 6f 6e 20 74 ern for waiton t
2b60: 65 73 74 3e 0a 69 74 65 6d 6d 61 70 20 66 6f 6f est>.itemmap foo
2b70: 2f 20 62 61 72 2f 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d / bar/..--------
2b80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 78 -----------...ex
2b90: 61 6d 70 6c 65 20 66 6f 72 20 62 61 63 6b 72 65 ample for backre
2ba0: 66 65 72 65 6e 63 65 20 28 65 67 3a 20 69 74 65 ference (eg: ite
2bb0: 6d 20 2b 66 6f 6f 32 33 2f 74 68 75 64 2b 20 77 m +foo23/thud+ w
2bc0: 69 6c 6c 20 69 6d 70 6c 79 20 77 61 69 74 6f 6e ill imply waiton
2bd0: 27 73 20 69 74 65 6d 20 2b 6e 75 6d 2d 32 33 2f 's item +num-23/
2be0: 62 61 72 2f 74 68 75 64 2b 0a 2d 2d 2d 2d 2d 2d bar/thud+.------
2bf0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 0a -------------.#.
2c00: 23 20 23 23 20 45 78 61 6d 70 6c 65 0a 23 20 23 # ## Example.# #
2c10: 23 20 63 61 6e 20 75 73 65 20 5c 7b 6e 75 6d 62 # can use \{numb
2c20: 65 72 7d 20 69 6e 20 72 65 70 6c 61 63 65 6d 65 er} in replaceme
2c30: 6e 74 20 70 61 74 74 65 72 6e 20 74 6f 20 62 61 nt pattern to ba
2c40: 63 6b 72 65 66 65 72 65 6e 63 65 20 61 20 28 63 ckreference a (c
2c50: 61 70 74 75 72 65 29 20 66 72 6f 6d 20 6d 61 74 apture) from mat
2c60: 63 68 69 6e 67 20 70 61 74 74 65 72 6e 20 73 69 ching pattern si
2c70: 6d 69 6c 61 72 20 74 6f 20 73 65 64 20 6f 72 20 milar to sed or
2c80: 70 65 72 6c 0a 5b 72 65 71 75 69 72 65 6d 65 6e perl.[requiremen
2c90: 74 73 5d 0a 6d 6f 64 65 20 69 74 65 6d 77 61 69 ts].mode itemwai
2ca0: 74 0a 23 20 69 74 65 6d 6d 61 70 20 3c 69 74 65 t.# itemmap <ite
2cb0: 6d 20 70 61 74 74 65 72 6e 20 66 6f 72 20 74 68 m pattern for th
2cc0: 69 73 20 74 65 73 74 3e 20 20 3c 69 74 65 6d 20 is test> <item
2cd0: 72 65 70 6c 61 63 65 6d 65 6e 74 20 70 61 74 74 replacement patt
2ce0: 65 72 6e 20 66 6f 72 20 77 61 69 74 6f 6e 20 74 ern for waiton t
2cf0: 65 73 74 3e 0a 69 74 65 6d 6d 61 70 20 66 6f 6f est>.itemmap foo
2d00: 28 5c 64 2b 29 2f 20 6e 75 6d 2d 5c 31 2f 62 61 (\d+)/ num-\1/ba
2d10: 72 2f 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d r/..------------
2d20: 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 78 61 6d 70 6c -------...exampl
2d30: 65 20 6d 75 6c 74 69 70 6c 65 20 69 74 65 6d 6d e multiple itemm
2d40: 61 70 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d aps.------------
2d50: 2d 2d 2d 2d 2d 2d 2d 0a 0a 23 20 6d 75 6c 74 69 -------..# multi
2d60: 2d 6c 69 6e 65 3b 20 6d 61 74 63 68 65 73 20 61 -line; matches a
2d70: 72 65 20 61 70 70 6c 69 65 64 20 69 6e 20 74 68 re applied in th
2d80: 65 20 6c 69 73 74 65 64 20 6f 72 64 65 72 0a 23 e listed order.#
2d90: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 77 The following w
2da0: 6f 75 6c 64 20 6d 61 70 3a 0a 23 20 20 20 61 31 ould map:.# a1
2db0: 32 33 62 33 32 31 20 74 6f 20 62 33 32 31 66 6f 23b321 to b321fo
2dc0: 6f 61 31 32 33 20 74 68 65 6e 20 74 6f 20 33 32 oa123 then to 32
2dd0: 31 66 6f 6f 61 31 32 33 70 0a 23 0a 5b 72 65 71 1fooa123p.#.[req
2de0: 75 69 72 65 6d 65 6e 74 73 5d 0a 69 74 65 6d 6d uirements].itemm
2df0: 61 70 20 28 61 5c 64 2b 29 28 62 5c 64 2b 29 20 ap (a\d+)(b\d+)
2e00: 5c 32 66 6f 6f 5c 31 0a 20 20 62 28 2e 2a 29 20 \2foo\1. b(.*)
2e10: 5c 31 70 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d \1p.------------
2e20: 2d 2d 2d 2d 2d 2d 2d 0a 0a 0a 43 6f 6d 70 6c 65 -------...Comple
2e30: 78 20 6d 61 70 70 69 6e 67 0a 5e 5e 5e 5e 5e 5e x mapping.^^^^^^
2e40: 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 43 6f 6d 70 6c 65 ^^^^^^^^^.Comple
2e50: 78 20 6d 61 70 70 69 6e 67 73 20 63 61 6e 20 62 x mappings can b
2e60: 65 20 68 61 6e 64 6c 65 64 20 77 69 74 68 20 61 e handled with a
2e70: 20 73 65 70 61 72 61 74 65 20 5b 69 74 65 6d 6d separate [itemm
2e80: 61 70 5d 20 73 65 63 74 69 6f 6e 20 28 69 6e 73 ap] section (ins
2e90: 74 65 61 64 20 69 66 20 61 6e 20 69 74 65 6d 6d tead if an itemm
2ea0: 61 70 20 6c 69 6e 65 20 69 6e 20 74 68 65 20 5b ap line in the [
2eb0: 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 20 73 65 requirements] se
2ec0: 63 74 69 6f 6e 29 0a 0a 45 61 63 68 20 6c 69 6e ction)..Each lin
2ed0: 65 20 69 6e 20 61 6e 20 69 74 65 6d 6d 61 70 20 e in an itemmap
2ee0: 73 65 63 74 69 6f 6e 20 73 74 61 72 74 73 20 77 section starts w
2ef0: 69 74 68 20 61 20 77 61 69 74 6f 6e 20 74 65 73 ith a waiton tes
2f00: 74 20 6e 61 6d 65 20 66 6f 6c 6c 6f 77 65 64 20 t name followed
2f10: 62 79 20 61 6e 20 69 74 65 6d 6d 61 70 20 65 78 by an itemmap ex
2f20: 70 72 65 73 73 69 6f 6e 0a 0a 2e 65 67 3a 20 54 pression...eg: T
2f30: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 61 75 he following cau
2f40: 73 65 73 20 77 61 69 74 6f 6e 20 74 65 73 74 20 ses waiton test
2f50: 41 20 69 74 65 6d 20 2b 62 61 72 2f 31 32 33 34 A item +bar/1234
2f60: 2b 20 74 6f 20 72 75 6e 20 77 68 65 6e 20 6f 75 + to run when ou
2f70: 72 20 74 65 73 74 27 73 20 2b 66 6f 6f 2f 31 32 r test's +foo/12
2f80: 33 34 2b 20 69 74 65 6d 20 69 73 20 72 65 71 75 34+ item is requ
2f90: 65 73 74 65 64 20 61 73 20 77 65 6c 6c 20 61 73 ested as well as
2fa0: 20 63 61 75 73 69 6e 67 20 77 61 69 74 6f 6e 20 causing waiton
2fb0: 74 65 73 74 20 42 27 73 20 2b 62 6c 61 68 2b 20 test B's +blah+
2fc0: 69 74 65 6d 20 74 6f 20 72 75 6e 20 77 68 65 6e item to run when
2fd0: 20 6f 75 72 20 74 65 73 74 27 73 20 2b 73 74 75 our test's +stu
2fe0: 66 66 2f 62 6c 61 68 2b 20 69 74 65 6d 20 69 73 ff/blah+ item is
2ff0: 20 72 65 71 75 65 73 74 65 64 0a 2d 2d 2d 2d 2d requested.-----
3000: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 69 74 65 6d 6d ---------.[itemm
3010: 61 70 5d 0a 41 20 66 6f 6f 2f 20 62 61 72 2f 0a ap].A foo/ bar/.
3020: 42 20 73 74 75 66 66 2f 0a 2d 2d 2d 2d 2d 2d 2d B stuff/.-------
3030: 2d 2d 2d 2d 2d 2d 2d 0a 0a 0a 43 6f 6d 70 6c 65 -------...Comple
3040: 78 20 6d 61 70 70 69 6e 67 20 65 78 61 6d 70 6c x mapping exampl
3050: 65 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e e.^^^^^^^^^^^^^^
3060: 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 0a 0a 2f 2f 20 ^^^^^^^^^....//
3070: 69 6d 61 67 65 3a 3a 69 74 65 6d 6d 61 70 2e 70 image::itemmap.p
3080: 6e 67 5b 5d 0a 69 6d 61 67 65 3a 3a 63 6f 6d 70 ng[].image::comp
3090: 6c 65 78 2d 69 74 65 6d 6d 61 70 2e 70 6e 67 5b lex-itemmap.png[
30a0: 5d 0a 0a 0a 57 65 20 61 63 63 6f 6d 70 6c 69 73 ]...We accomplis
30b0: 68 20 74 68 69 73 20 62 79 20 63 6f 6e 66 69 67 h this by config
30c0: 75 72 69 6e 67 20 74 68 65 20 74 65 73 74 63 6f uring the testco
30d0: 6e 66 69 67 73 20 6f 66 20 6f 75 72 20 74 65 73 nfigs of our tes
30e0: 74 73 20 43 20 44 20 61 6e 64 20 45 20 61 73 20 ts C D and E as
30f0: 66 6f 6c 6c 6f 77 73 3a 0a 0a 2e 54 65 73 74 63 follows:...Testc
3100: 6f 6e 66 69 67 20 66 6f 72 20 54 65 73 74 20 45 onfig for Test E
3110: 20 68 61 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d has.-----------
3120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 -----------.[req
3130: 75 69 72 65 6d 65 6e 74 73 5d 0a 77 61 69 74 6f uirements].waito
3140: 6e 20 43 0a 69 74 65 6d 6d 61 70 20 28 5c 64 2b n C.itemmap (\d+
3150: 29 2f 72 65 73 20 5c 31 2f 62 62 0a 2d 2d 2d 2d )/res \1/bb.----
3160: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3170: 2d 2d 0a 0a 2e 54 65 73 74 63 6f 6e 66 69 67 20 --...Testconfig
3180: 66 6f 72 20 54 65 73 74 20 44 20 68 61 73 0a 2d for Test D has.-
3190: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
31a0: 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 -----.[requireme
31b0: 6e 74 73 5d 0a 77 61 69 74 6f 6e 20 43 0a 69 74 nts].waiton C.it
31c0: 65 6d 6d 61 70 20 28 5c 64 2b 29 2f 72 65 73 20 emmap (\d+)/res
31d0: 5c 31 2f 61 61 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d \1/aa.----------
31e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 54 ------------...T
31f0: 65 73 74 63 6f 6e 66 69 67 20 66 6f 72 20 54 65 estconfig for Te
3200: 73 74 20 43 20 68 61 73 0a 2d 2d 2d 2d 2d 2d 2d st C has.-------
3210: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
3220: 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 77 [requirements].w
3230: 61 69 74 6f 6e 20 41 20 42 0a 0a 5b 69 74 65 6d aiton A B..[item
3240: 6d 61 70 5d 0a 41 20 28 5c 64 2b 29 2f 61 61 20 map].A (\d+)/aa
3250: 61 61 2f 5c 31 0a 42 20 28 5c 64 2b 29 2f 62 62 aa/\1.B (\d+)/bb
3260: 20 62 62 2f 5c 31 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d bb/\1.---------
3270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e -------------...
3280: 54 65 73 74 63 6f 6e 66 69 67 73 20 66 6f 72 20 Testconfigs for
3290: 54 65 73 74 20 42 20 61 6e 64 20 54 65 73 74 20 Test B and Test
32a0: 41 20 68 61 76 65 20 6e 6f 20 77 61 69 74 6f 6e A have no waiton
32b0: 20 6f 72 20 69 74 65 6d 6d 61 70 20 63 6f 6e 66 or itemmap conf
32c0: 69 67 75 72 65 64 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d igured.---------
32d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2d 2d 2d 2d 2d ----------.-----
32e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
32f0: 2e 57 61 6c 6b 20 74 68 72 6f 75 67 68 20 6f 6e .Walk through on
3300: 65 20 69 74 65 6d 20 2d 2d 20 77 65 20 77 61 6e e item -- we wan
3310: 74 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 t the following
3320: 74 6f 20 68 61 70 70 65 6e 20 66 6f 72 20 74 65 to happen for te
3330: 73 74 70 61 74 74 20 2b 44 2f 31 2f 72 65 73 2b stpatt +D/1/res+
3340: 20 28 73 65 65 20 62 6c 75 65 20 62 6f 78 65 73 (see blue boxes
3350: 20 69 6e 20 63 6f 6d 70 6c 65 78 20 69 74 65 6d in complex item
3360: 6d 61 70 69 6e 67 20 66 69 67 75 72 65 20 61 62 maping figure ab
3370: 6f 76 65 29 3a 0a 0a 2e 20 65 67 20 66 72 6f 6d ove):... eg from
3380: 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 2b 6d command line +m
3390: 65 67 61 74 65 73 74 20 2d 72 75 6e 20 2d 74 65 egatest -run -te
33a0: 73 74 70 61 74 74 20 44 2f 31 2f 72 65 73 20 2d stpatt D/1/res -
33b0: 74 61 72 67 65 74 20 6d 79 74 61 72 67 65 74 20 target mytarget
33c0: 2d 72 75 6e 6e 61 6d 65 20 6d 79 72 75 6e 6e 61 -runname myrunna
33d0: 6d 65 2b 0a 2e 20 46 75 6c 6c 20 6c 69 73 74 20 me+.. Full list
33e0: 74 6f 20 62 65 20 72 75 6e 20 69 73 20 6e 6f 77 to be run is now
33f0: 3a 20 2b 44 2f 31 2f 72 65 73 2b 0a 2e 20 54 65 : +D/1/res+.. Te
3400: 73 74 20 44 20 68 61 73 20 61 20 77 61 69 74 6f st D has a waito
3410: 6e 20 2d 20 74 65 73 74 20 43 2e 20 20 54 65 73 n - test C. Tes
3420: 74 20 44 27 73 20 69 74 65 6d 6d 61 70 20 72 75 t D's itemmap ru
3430: 6c 65 20 2b 69 74 65 6d 6d 61 70 20 28 5c 64 26 le +itemmap (\d&
3440: 70 6c 75 73 3b 29 2f 72 65 73 20 5c 31 2f 61 61 plus;)/res \1/aa
3450: 2b 20 2d 3e 20 20 63 61 75 73 65 73 20 2b 43 2f + -> causes +C/
3460: 31 2f 61 61 2b 20 74 6f 20 72 75 6e 20 62 65 66 1/aa+ to run bef
3470: 6f 72 65 20 2b 44 2f 31 2f 72 65 73 2b 0a 2e 20 ore +D/1/res+..
3480: 46 75 6c 6c 20 6c 69 73 74 20 74 6f 20 62 65 20 Full list to be
3490: 72 75 6e 20 69 73 20 6e 6f 77 3a 20 2b 44 2f 31 run is now: +D/1
34a0: 2f 72 65 73 2b 2c 20 2b 43 2f 31 2f 61 61 2b 0a /res+, +C/1/aa+.
34b0: 2e 20 54 65 73 74 20 43 20 77 61 73 20 61 20 77 . Test C was a w
34c0: 61 69 74 6f 6e 20 2d 20 74 65 73 74 20 41 2e 20 aiton - test A.
34d0: 54 65 73 74 20 43 27 73 20 72 75 6c 65 20 2b 41 Test C's rule +A
34e0: 20 28 5c 64 26 70 6c 75 73 3b 29 2f 61 61 20 61 (\d+)/aa a
34f0: 61 2f 5c 31 2b 20 2d 3e 20 63 61 75 73 65 73 20 a/\1+ -> causes
3500: 2b 41 2f 61 61 2f 31 2b 20 74 6f 20 72 75 6e 20 +A/aa/1+ to run
3510: 62 65 66 6f 72 65 20 2b 43 2f 31 2f 61 61 2b 0a before +C/1/aa+.
3520: 2e 20 46 75 6c 6c 20 6c 69 73 74 20 74 6f 20 62 . Full list to b
3530: 65 20 72 75 6e 20 69 73 20 6e 6f 77 3a 20 2b 44 e run is now: +D
3540: 2f 31 2f 72 65 73 2b 2c 20 2b 43 2f 31 2f 61 61 /1/res+, +C/1/aa
3550: 2b 2c 20 2b 41 2f 61 61 2f 31 2b 0a 2e 20 54 65 +, +A/aa/1+.. Te
3560: 73 74 20 41 20 68 61 73 20 6e 6f 20 77 61 69 74 st A has no wait
3570: 6f 6e 73 2e 20 20 41 6c 6c 20 77 61 69 74 6f 6e ons. All waiton
3580: 73 20 6f 66 20 61 6c 6c 20 74 65 73 74 73 20 69 s of all tests i
3590: 6e 20 66 75 6c 6c 20 6c 69 73 74 20 68 61 76 65 n full list have
35a0: 20 62 65 65 6e 20 70 72 6f 63 65 73 73 65 64 2e been processed.
35b0: 20 20 46 75 6c 6c 20 6c 69 73 74 20 69 73 20 66 Full list is f
35c0: 69 6e 61 6c 69 7a 65 64 2e 0a 0a 0a 0a 69 74 65 inalized.....ite
35d0: 6d 73 74 61 62 6c 65 0a 5e 5e 5e 5e 5e 5e 5e 5e mstable.^^^^^^^^
35e0: 5e 5e 0a 41 6e 20 61 6c 74 65 72 6e 61 74 69 76 ^^.An alternativ
35f0: 65 20 74 6f 20 64 65 66 69 6e 69 6e 67 20 69 74 e to defining it
3600: 65 6d 73 20 69 73 20 74 68 65 20 69 74 65 6d 73 ems is the items
3610: 74 61 62 6c 65 20 73 65 63 74 69 6f 6e 2e 20 20 table section.
3620: 54 68 69 73 20 6c 65 74 73 20 79 6f 75 20 64 65 This lets you de
3630: 66 69 6e 65 20 74 68 65 20 69 74 65 6d 70 61 74 fine the itempat
3640: 68 20 69 6e 20 61 20 74 61 62 6c 65 20 66 6f 72 h in a table for
3650: 6d 61 74 20 72 61 74 68 65 72 20 74 68 61 6e 20 mat rather than
3660: 73 70 65 63 69 66 79 69 6e 67 20 63 6f 6d 70 6f specifying compo
3670: 6e 65 6e 74 73 20 61 6e 64 20 72 65 6c 79 69 6e nents and relyin
3680: 67 20 6f 6e 20 67 65 74 74 69 6e 67 20 61 6c 6c g on getting all
3690: 20 70 65 72 6d 75 74 61 74 69 6f 6e 73 20 6f 66 permutations of
36a0: 20 74 68 6f 73 65 20 63 6f 6d 70 6f 6e 65 6e 74 those component
36b0: 73 2e 0a 0a 0a 0a 0a 0a 44 79 6e 61 6d 69 63 20 s.......Dynamic
36c0: 46 6c 6f 77 20 44 65 70 65 6e 64 65 6e 63 79 20 Flow Dependency
36d0: 54 72 65 65 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e Tree.^^^^^^^^^^^
36e0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
36f0: 5e 0a 0a 2e 41 75 74 6f 67 65 6e 65 72 61 74 69 ^...Autogenerati
3700: 6f 6e 20 77 61 69 74 6f 6e 20 6c 69 73 74 20 66 on waiton list f
3710: 6f 72 20 64 79 6e 61 6d 69 63 20 66 6c 6f 77 20 or dynamic flow
3720: 64 65 70 65 6e 64 65 6e 63 79 20 74 72 65 65 73 dependency trees
3730: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
3740: 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e ----.[requiremen
3750: 74 73 5d 0a 23 20 57 69 74 68 20 61 20 74 6f 70 ts].# With a top
3760: 6c 65 76 65 6c 20 74 65 73 74 20 79 6f 75 20 6d level test you m
3770: 61 79 20 77 69 73 68 20 74 6f 20 67 65 6e 65 72 ay wish to gener
3780: 61 74 65 20 79 6f 75 72 20 6c 69 73 74 20 0a 23 ate your list .#
3790: 20 6f 66 20 74 65 73 74 73 20 74 6f 20 72 75 6e of tests to run
37a0: 20 64 79 6e 61 6d 69 63 61 6c 6c 79 0a 23 0a 77 dynamically.#.w
37b0: 61 69 74 6f 6e 20 23 7b 73 68 65 6c 6c 20 67 65 aiton #{shell ge
37c0: 74 2d 76 61 6c 69 64 2d 74 65 73 74 73 2d 74 6f t-valid-tests-to
37d0: 2d 72 75 6e 2e 73 68 7d 0a 2d 2d 2d 2d 2d 2d 2d -run.sh}.-------
37e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 75 ------------..Ru
37f0: 6e 20 74 69 6d 65 20 6c 69 6d 69 74 0a 5e 5e 5e n time limit.^^^
3800: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d ^^^^^^^^^^^..---
3810: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
3820: 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 72 75 requirements].ru
3830: 6e 74 69 6d 65 6c 69 6d 20 31 68 20 32 6d 20 33 ntimelim 1h 2m 3
3840: 73 20 20 23 20 74 68 69 73 20 77 69 6c 6c 20 61 s # this will a
3850: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6b 69 6c utomatically kil
3860: 6c 20 74 68 65 20 74 65 73 74 20 69 66 20 69 74 l the test if it
3870: 20 72 75 6e 73 20 66 6f 72 20 6d 6f 72 65 20 74 runs for more t
3880: 68 61 6e 20 31 68 20 32 6d 20 61 6e 64 20 33 73 han 1h 2m and 3s
3890: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
38a0: 2d 2d 0a 0a 53 6b 69 70 0a 5e 5e 5e 5e 0a 0a 41 --..Skip.^^^^..A
38b0: 20 74 65 73 74 20 77 69 74 68 20 61 20 73 6b 69 test with a ski
38c0: 70 20 73 65 63 74 69 6f 6e 20 77 69 6c 6c 20 63 p section will c
38d0: 6f 6e 64 69 74 69 6f 6e 61 6c 20 73 6b 69 70 20 onditional skip
38e0: 72 75 6e 6e 69 6e 67 2e 0a 0a 2e 53 6b 69 70 20 running....Skip
38f0: 73 65 63 74 69 6f 6e 20 65 78 61 6d 70 6c 65 0a section example.
3900: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3910: 2d 0a 5b 73 6b 69 70 5d 0a 70 72 65 76 72 75 6e -.[skip].prevrun
3920: 6e 69 6e 67 20 78 0a 23 20 72 75 6e 64 65 6c 61 ning x.# rundela
3930: 79 20 33 30 6d 20 31 35 73 0a 2d 2d 2d 2d 2d 2d y 30m 15s.------
3940: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 -----------..Ski
3950: 70 20 6f 6e 20 53 74 69 6c 6c 2d 72 75 6e 6e 69 p on Still-runni
3960: 6e 67 20 54 65 73 74 73 0a 5e 5e 5e 5e 5e 5e 5e ng Tests.^^^^^^^
3970: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3980: 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^^^..----------
3990: 2d 2d 2d 2d 2d 2d 2d 0a 23 20 4e 42 2f 2f 20 49 -------.# NB// I
39a0: 66 20 74 68 65 20 70 72 65 76 72 75 6e 6e 69 6e f the prevrunnin
39b0: 67 20 6c 69 6e 65 20 65 78 69 73 74 73 20 77 69 g line exists wi
39c0: 74 68 20 2a 61 6e 79 2a 20 76 61 6c 75 65 20 74 th *any* value t
39d0: 68 65 20 74 65 73 74 20 77 69 6c 6c 0a 23 20 61 he test will.# a
39e0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 53 4b 49 utomatically SKI
39f0: 50 20 69 66 20 74 68 65 20 73 61 6d 65 2d 6e 61 P if the same-na
3a00: 6d 65 64 20 74 65 73 74 20 69 73 20 63 75 72 72 med test is curr
3a10: 65 6e 74 6c 79 20 52 55 4e 4e 49 4e 47 2e 20 54 ently RUNNING. T
3a20: 68 65 0a 23 20 22 78 22 20 63 61 6e 20 62 65 20 he.# "x" can be
3a30: 61 6e 79 20 73 74 72 69 6e 67 2e 20 43 6f 6d 6d any string. Comm
3a40: 65 6e 74 20 6f 75 74 20 74 68 65 20 70 72 65 76 ent out the prev
3a50: 72 75 6e 6e 69 6e 67 20 6c 69 6e 65 20 74 6f 20 running line to
3a60: 74 75 72 6e 20 6f 66 66 0a 23 20 73 6b 69 70 2e turn off.# skip.
3a70: 0a 0a 5b 73 6b 69 70 5d 0a 70 72 65 76 72 75 6e ..[skip].prevrun
3a80: 6e 69 6e 67 20 78 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ning x.---------
3a90: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 70 20 69 --------..Skip i
3aa0: 66 20 61 20 46 69 6c 65 20 45 78 69 73 74 73 0a f a File Exists.
3ab0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3ac0: 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^^^^..---------
3ad0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 6b 69 70 5d 0a --------.[skip].
3ae0: 66 69 6c 65 65 78 69 73 74 73 20 2f 70 61 74 68 fileexists /path
3af0: 2f 74 6f 2f 61 2f 66 69 6c 65 20 23 20 73 6b 69 /to/a/file # ski
3b00: 70 20 69 66 20 2f 70 61 74 68 2f 74 6f 2f 61 2f p if /path/to/a/
3b10: 66 69 6c 65 20 65 78 69 73 74 73 0a 2d 2d 2d 2d file exists.----
3b20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 -------------..S
3b30: 6b 69 70 20 69 66 20 74 65 73 74 20 72 61 6e 20 kip if test ran
3b40: 6d 6f 72 65 20 72 65 63 65 6e 74 6c 79 20 74 68 more recently th
3b50: 61 6e 20 73 70 65 63 69 66 69 65 64 20 74 69 6d an specified tim
3b60: 65 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e e.^^^^^^^^^^^^^^
3b70: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3b80: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3b90: 5e 5e 5e 5e 0a 0a 2e 53 6b 69 70 20 69 66 20 74 ^^^^...Skip if t
3ba0: 68 69 73 20 74 65 73 74 20 68 61 73 20 62 65 65 his test has bee
3bb0: 6e 20 72 75 6e 20 69 6e 20 74 68 65 20 70 61 73 n run in the pas
3bc0: 74 20 66 69 66 74 65 65 6e 20 6d 69 6e 75 74 65 t fifteen minute
3bd0: 73 20 61 6e 64 20 31 35 20 73 65 63 6f 6e 64 73 s and 15 seconds
3be0: 2e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
3bf0: 2d 2d 2d 0a 5b 73 6b 69 70 5d 0a 72 75 6e 64 65 ---.[skip].runde
3c00: 6c 61 79 20 31 35 6d 20 31 35 73 0a 2d 2d 2d 2d lay 15m 15s.----
3c10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 -------------..D
3c20: 69 73 6b 73 0a 5e 5e 5e 5e 5e 0a 0a 41 20 64 69 isks.^^^^^..A di
3c30: 73 6b 73 20 73 65 63 74 69 6f 6e 20 69 6e 20 74 sks section in t
3c40: 65 73 74 63 6f 6e 66 69 67 20 77 69 6c 6c 20 6f estconfig will o
3c50: 76 65 72 72 69 64 65 20 74 68 65 20 64 69 73 6b verride the disk
3c60: 73 20 73 65 63 74 69 6f 6e 20 69 6e 0a 6d 65 67 s section in.meg
3c70: 61 74 65 73 74 2e 63 6f 6e 66 69 67 2e 20 54 68 atest.config. Th
3c80: 69 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 is can be used t
3c90: 6f 20 61 6c 6c 6f 63 61 74 65 20 64 69 73 6b 73 o allocate disks
3ca0: 20 6f 6e 20 61 20 70 65 72 2d 74 65 73 74 20 6f on a per-test o
3cb0: 72 20 70 65 72 20 69 74 65 6d 0a 62 61 73 69 73 r per item.basis
3cc0: 2e 0a 0a 43 6f 6e 74 72 6f 6c 6c 65 64 20 77 61 ...Controlled wa
3cd0: 69 76 65 72 20 70 72 6f 70 61 67 61 74 69 6f 6e iver propagation
3ce0: 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e .^^^^^^^^^^^^^^^
3cf0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a ^^^^^^^^^^^^^^..
3d00: 49 66 20 74 65 73 74 20 69 73 20 46 41 49 4c 20 If test is FAIL
3d10: 61 6e 64 20 70 72 65 76 69 6f 75 73 20 74 65 73 and previous tes
3d20: 74 20 69 6e 20 72 75 6e 20 77 69 74 68 20 73 61 t in run with sa
3d30: 6d 65 20 4d 54 5f 54 41 52 47 45 54 20 69 73 20 me MT_TARGET is
3d40: 57 41 49 56 45 44 20 74 68 65 6e 20 61 70 70 6c WAIVED then appl
3d50: 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 y the following
3d60: 72 75 6c 65 73 20 66 72 6f 6d 20 74 68 65 20 74 rules from the t
3d70: 65 73 74 63 6f 6e 66 69 67 3a 0a 49 66 20 61 20 estconfig:.If a
3d80: 77 61 69 76 65 72 20 63 68 65 63 6b 20 69 73 20 waiver check is
3d90: 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 specified in the
3da0: 20 74 65 73 74 63 6f 6e 66 69 67 20 61 70 70 6c testconfig appl
3db0: 79 20 74 68 65 20 63 68 65 63 6b 20 61 6e 64 20 y the check and
3dc0: 69 66 20 69 74 20 70 61 73 73 65 73 20 74 68 65 if it passes the
3dd0: 6e 20 73 65 74 20 74 68 69 73 20 46 41 49 4c 20 n set this FAIL
3de0: 74 6f 20 57 41 49 56 45 44 0a 0a 57 61 69 76 65 to WAIVED..Waive
3df0: 72 20 63 68 65 63 6b 20 68 61 73 20 74 77 6f 20 r check has two
3e00: 70 61 72 74 73 2c 20 31 29 20 61 20 6c 69 73 74 parts, 1) a list
3e10: 20 6f 66 20 77 61 69 76 65 72 2c 20 72 75 6c 65 of waiver, rule
3e20: 6e 61 6d 65 2c 20 66 69 6c 65 70 61 74 74 65 72 name, filepatter
3e30: 6e 73 20 61 6e 64 20 32 29 20 74 68 65 20 72 75 ns and 2) the ru
3e40: 6c 65 6e 61 6d 65 20 73 63 72 69 70 74 20 73 70 lename script sp
3e50: 65 63 20 28 6e 6f 74 65 20 74 68 61 74 20 22 64 ec (note that "d
3e60: 69 66 66 22 20 61 6e 64 20 22 6c 6f 67 70 72 6f iff" and "logpro
3e70: 22 20 61 72 65 20 70 72 65 64 65 66 69 6e 65 64 " are predefined
3e80: 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d )..-------------
3e90: 2d 2d 2d 2d 0a 23 23 23 23 23 23 20 45 58 41 4d ----.###### EXAM
3ea0: 50 4c 45 20 46 52 4f 4d 20 74 65 73 74 63 6f 6e PLE FROM testcon
3eb0: 66 69 67 20 23 23 23 23 23 23 23 23 23 0a 23 20 fig #########.#
3ec0: 6d 61 74 63 68 69 6e 67 20 66 69 6c 65 28 73 29 matching file(s)
3ed0: 20 77 69 6c 6c 20 62 65 20 64 69 66 66 27 64 20 will be diff'd
3ee0: 77 69 74 68 20 70 72 65 76 69 6f 75 73 20 72 75 with previous ru
3ef0: 6e 20 61 6e 64 20 6c 6f 67 70 72 6f 20 61 70 70 n and logpro app
3f00: 6c 69 65 64 0a 23 20 69 66 20 50 41 53 53 20 6f lied.# if PASS o
3f10: 72 20 57 41 52 4e 20 72 65 73 75 6c 74 20 66 72 r WARN result fr
3f20: 6f 6d 20 6c 6f 67 70 72 6f 20 74 68 65 6e 20 57 om logpro then W
3f30: 41 49 56 45 52 20 73 74 61 74 65 20 69 73 20 73 AIVER state is s
3f40: 65 74 0a 23 0a 5b 77 61 69 76 65 72 73 5d 0a 23 et.#.[waivers].#
3f50: 20 6c 6f 67 70 72 6f 5f 66 69 6c 65 20 20 20 20 logpro_file
3f60: 72 75 6c 65 6e 61 6d 65 20 20 20 20 20 20 69 6e rulename in
3f70: 70 75 74 5f 67 6c 6f 62 0a 77 61 69 76 65 72 5f put_glob.waiver_
3f80: 31 20 20 20 20 20 20 20 20 20 6c 6f 67 70 72 6f 1 logpro
3f90: 20 20 20 20 20 20 20 20 6c 6f 6f 6b 69 74 74 6d lookittm
3fa0: 70 2e 6c 6f 67 0a 0a 5b 77 61 69 76 65 72 5f 72 p.log..[waiver_r
3fb0: 75 6c 65 73 5d 0a 0a 23 20 54 68 69 73 20 62 75 ules]..# This bu
3fc0: 69 6c 74 69 6e 20 72 75 6c 65 20 69 73 20 74 68 iltin rule is th
3fd0: 65 20 64 65 66 61 75 6c 74 20 69 66 20 74 68 65 e default if the
3fe0: 72 65 20 69 73 20 6e 6f 20 3c 77 61 69 76 65 72 re is no <waiver
3ff0: 6e 61 6d 65 3e 2e 6c 6f 67 70 72 6f 20 66 69 6c name>.logpro fil
4000: 65 0a 23 20 64 69 66 66 20 20 20 64 69 66 66 20 e.# diff diff
4010: 25 66 69 6c 65 31 25 20 25 66 69 6c 65 32 25 0a %file1% %file2%.
4020: 0a 23 20 54 68 69 73 20 62 75 69 6c 74 69 6e 20 .# This builtin
4030: 72 75 6c 65 20 69 73 20 61 70 70 6c 69 65 64 20 rule is applied
4040: 69 66 20 61 20 3c 77 61 69 76 65 72 6e 61 6d 65 if a <waivername
4050: 3e 2e 6c 6f 67 70 72 6f 20 66 69 6c 65 20 65 78 >.logpro file ex
4060: 69 73 74 73 0a 23 20 6c 6f 67 70 72 6f 20 64 69 ists.# logpro di
4070: 66 66 20 25 66 69 6c 65 31 25 20 25 66 69 6c 65 ff %file1% %file
4080: 32 25 20 7c 20 6c 6f 67 70 72 6f 20 25 77 61 69 2% | logpro %wai
4090: 76 65 72 6e 61 6d 65 25 2e 6c 6f 67 70 72 6f 20 vername%.logpro
40a0: 25 77 61 69 76 65 72 6e 61 6d 65 25 2e 68 74 6d %waivername%.htm
40b0: 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d l.--------------
40c0: 2d 2d 2d 0a 0a 45 7a 73 74 65 70 73 0a 7e 7e 7e ---..Ezsteps.~~~
40d0: 7e 7e 7e 7e 0a 0a 2e 45 78 61 6d 70 6c 65 20 65 ~~~~...Example e
40e0: 7a 73 74 65 70 73 20 77 69 74 68 20 6c 6f 67 70 zsteps with logp
40f0: 72 6f 20 72 75 6c 65 73 0a 2d 2d 2d 2d 2d 2d 2d ro rules.-------
4100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 65 7a 73 74 ----------.[ezst
4110: 65 70 73 5d 0a 6c 6f 6f 6b 69 74 74 6d 70 20 20 eps].lookittmp
4120: 20 6c 73 20 2f 74 6d 70 0a 0a 5b 6c 6f 67 70 72 ls /tmp..[logpr
4130: 6f 5d 0a 6c 6f 6f 6b 69 74 74 6d 70 20 3b 3b 20 o].lookittmp ;;
4140: 4e 6f 74 65 3a 20 63 6f 6e 66 69 67 20 66 69 6c Note: config fil
4150: 65 20 66 6f 72 6d 61 74 20 73 75 70 70 6f 72 74 e format support
4160: 73 20 6d 75 6c 74 69 2d 6c 69 6e 65 20 65 6e 74 s multi-line ent
4170: 72 69 65 73 20 77 68 65 72 65 20 6c 65 61 64 69 ries where leadi
4180: 6e 67 20 77 68 69 74 65 73 70 61 63 65 20 69 73 ng whitespace is
4190: 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 65 61 removed from ea
41a0: 63 68 20 6c 69 6e 65 0a 20 20 3b 3b 20 20 20 20 ch line. ;;
41b0: 20 61 20 62 6c 61 6e 6b 20 6c 69 6e 65 20 69 6e a blank line in
41c0: 64 69 63 61 74 65 73 20 74 68 65 20 65 6e 64 20 dicates the end
41d0: 6f 66 20 74 68 65 20 62 6c 6f 63 6b 20 6f 66 20 of the block of
41e0: 74 65 78 74 20 0a 20 20 28 65 78 70 65 63 74 3a text . (expect:
41f0: 72 65 71 75 69 72 65 64 20 69 6e 20 22 4c 6f 67 required in "Log
4200: 46 69 6c 65 42 6f 64 79 22 20 3e 20 30 20 22 41 FileBody" > 0 "A
4210: 20 66 69 6c 65 20 6e 61 6d 65 20 74 68 61 74 20 file name that
4220: 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 65 78 69 should never exi
4230: 73 74 21 22 20 23 2f 54 68 69 73 20 69 73 20 61 st!" #/This is a
4240: 20 61 77 66 75 6c 6c 79 20 73 74 75 70 69 64 20 awfully stupid
4250: 66 69 6c 65 20 6e 61 6d 65 20 74 68 61 74 20 73 file name that s
4260: 68 6f 75 6c 64 20 6e 65 76 65 72 20 62 65 20 66 hould never be f
4270: 6f 75 6e 64 20 69 6e 20 74 68 65 20 74 65 6d 70 ound in the temp
4280: 20 64 69 72 2f 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d dir/)..--------
4290: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 6f 20 74 72 ---------..To tr
42a0: 61 6e 73 66 65 72 20 74 68 65 20 65 6e 76 69 72 ansfer the envir
42b0: 6f 6e 6d 65 6e 74 20 74 6f 20 74 68 65 20 6e 65 onment to the ne
42c0: 78 74 20 73 74 65 70 20 79 6f 75 20 63 61 6e 20 xt step you can
42d0: 64 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 do the following
42e0: 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d :..-------------
42f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
4300: 24 4d 54 5f 4d 45 47 41 54 45 53 54 20 2d 65 6e $MT_MEGATEST -en
4310: 76 32 66 69 6c 65 20 2e 65 7a 73 74 65 70 73 2f v2file .ezsteps/
4320: 24 7b 73 74 65 70 6e 61 6d 65 7d 09 20 20 0a 2d ${stepname}. .-
4330: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4340: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 72 69 -----------..Tri
4350: 67 67 65 72 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a ggers.~~~~~~~~..
4360: 49 6e 20 79 6f 75 72 20 74 65 73 74 63 6f 6e 66 In your testconf
4370: 69 67 20 6f 72 20 6d 65 67 61 74 65 73 74 2e 63 ig or megatest.c
4380: 6f 6e 66 69 67 20 74 72 69 67 67 65 72 73 20 63 onfig triggers c
4390: 61 6e 20 62 65 20 73 70 65 63 69 66 69 65 64 20 an be specified
43a0: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
43b0: 2d 2d 2d 0a 5b 74 72 69 67 67 65 72 73 5d 0a 0a ---.[triggers]..
43c0: 23 20 43 61 6c 6c 20 73 63 72 69 70 74 20 72 75 # Call script ru
43d0: 6e 6e 69 6e 67 2e 73 68 20 77 68 65 6e 20 74 65 nning.sh when te
43e0: 73 74 20 67 6f 65 73 20 74 6f 20 73 74 61 74 65 st goes to state
43f0: 3d 52 55 4e 4e 49 4e 47 2c 20 73 74 61 74 75 73 =RUNNING, status
4400: 3d 50 41 53 53 0a 52 55 4e 4e 49 4e 47 2f 50 41 =PASS.RUNNING/PA
4410: 53 53 20 72 75 6e 6e 69 6e 67 2e 73 68 0a 0a 23 SS running.sh..#
4420: 20 43 61 6c 6c 20 73 63 72 69 70 74 20 72 75 6e Call script run
4430: 6e 69 6e 67 2e 73 68 20 61 6e 79 20 74 69 6d 65 ning.sh any time
4440: 20 73 74 61 74 65 20 67 6f 65 73 20 74 6f 20 52 state goes to R
4450: 55 4e 4e 49 4e 47 0a 52 55 4e 4e 49 4e 47 2f 20 UNNING.RUNNING/
4460: 72 75 6e 6e 69 6e 67 2e 73 68 0a 0a 23 20 43 61 running.sh..# Ca
4470: 6c 6c 20 73 63 72 69 70 74 20 6f 6e 70 61 73 73 ll script onpass
4480: 2e 73 68 20 61 6e 79 20 74 69 6d 65 20 73 74 61 .sh any time sta
4490: 74 75 73 20 67 6f 65 73 20 74 6f 20 50 41 53 53 tus goes to PASS
44a0: 0a 50 41 53 53 2f 20 6f 6e 70 61 73 73 2e 73 68 .PASS/ onpass.sh
44b0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
44c0: 2d 2d 0a 0a 53 63 72 69 70 74 73 20 63 61 6c 6c --..Scripts call
44d0: 65 64 20 77 69 6c 6c 20 68 61 76 65 3b 20 74 65 ed will have; te
44e0: 73 74 2d 69 64 20 74 65 73 74 2d 72 75 6e 64 69 st-id test-rundi
44f0: 72 20 74 72 69 67 67 65 72 20 74 65 73 74 2d 6e r trigger test-n
4500: 61 6d 65 20 69 74 65 6d 2d 70 61 74 68 20 73 74 ame item-path st
4510: 61 74 65 20 73 74 61 74 75 73 20 65 76 65 6e 74 ate status event
4520: 2d 74 69 6d 65 2c 20 61 64 64 65 64 20 74 6f 20 -time, added to
4530: 74 68 65 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65 2e the commandline.
4540: 0a 0a 48 49 4e 54 0a 0a 54 6f 20 73 74 61 72 74 ..HINT..To start
4550: 20 61 6e 20 78 74 65 72 6d 20 28 75 73 65 66 75 an xterm (usefu
4560: 6c 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 29 l for debugging)
4570: 2c 20 75 73 65 20 61 20 63 6f 6d 6d 61 6e 64 20 , use a command
4580: 6c 69 6e 65 20 6c 69 6b 65 20 74 68 65 20 66 6f line like the fo
4590: 6c 6c 6f 77 69 6e 67 3a 0a 0a 2d 2d 2d 2d 2d 2d llowing:..------
45a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 74 72 69 -----------.[tri
45b0: 67 67 65 72 73 5d 0a 43 4f 4d 50 4c 45 54 45 44 ggers].COMPLETED
45c0: 2f 20 78 74 65 72 6d 20 2d 65 20 62 61 73 68 20 / xterm -e bash
45d0: 2d 73 20 2d 2d 20 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d -s -- .---------
45e0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e 4f 54 45 3a 20 --------..NOTE:
45f0: 54 68 65 72 65 20 69 73 20 61 20 74 72 61 69 6c There is a trail
4600: 69 6e 67 20 73 70 61 63 65 20 61 66 74 65 72 20 ing space after
4610: 74 68 65 20 2d 2d 0a 0a 54 68 65 72 65 20 61 72 the --..There ar
4620: 65 20 61 20 6e 75 6d 62 65 72 20 6f 66 20 65 6e e a number of en
4630: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
4640: 6c 65 73 20 61 76 61 69 6c 61 62 6c 65 20 74 6f les available to
4650: 20 74 68 65 20 74 72 69 67 67 65 72 20 73 63 72 the trigger scr
4660: 69 70 74 0a 62 75 74 20 73 69 6e 63 65 20 74 72 ipt.but since tr
4670: 69 67 67 65 72 73 20 63 61 6e 20 62 65 20 63 61 iggers can be ca
4680: 6c 6c 65 64 20 69 6e 20 76 61 72 69 6f 75 73 20 lled in various
4690: 63 6f 6e 74 65 78 74 73 20 6e 6f 74 20 61 6c 6c contexts not all
46a0: 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 0a 61 variables are.a
46b0: 76 61 69 6c 61 62 6c 65 20 61 74 20 61 6c 6c 20 vailable at all
46c0: 74 69 6d 65 73 2e 20 54 68 65 20 74 72 69 67 67 times. The trigg
46d0: 65 72 20 73 63 72 69 70 74 20 73 68 6f 75 6c 64 er script should
46e0: 20 63 68 65 63 6b 20 66 6f 72 20 74 68 65 20 76 check for the v
46f0: 61 72 69 61 62 6c 65 20 61 6e 64 0a 66 61 69 6c ariable and.fail
4700: 20 67 72 61 63 65 66 75 6c 6c 79 20 69 66 20 69 gracefully if i
4710: 74 20 64 6f 65 73 6e 27 74 20 65 78 69 73 74 2e t doesn't exist.
4720: 0a 0a 2e 45 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 ...Environment v
4730: 61 72 69 61 62 6c 65 73 20 76 69 73 69 62 6c 65 ariables visible
4740: 20 74 6f 20 74 68 65 20 74 72 69 67 67 65 72 20 to the trigger
4750: 73 63 72 69 70 74 0a 5b 77 69 64 74 68 3d 22 39 script.[width="9
4760: 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d 22 2c 0%",cols="^,2m",
4770: 66 72 61 6d 65 3d 22 74 6f 70 62 6f 74 22 2c 6f frame="topbot",o
4780: 70 74 69 6f 6e 73 3d 22 68 65 61 64 65 72 22 5d ptions="header"]
4790: 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d .|==============
47a0: 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 56 61 72 69 61 62 ========.|Variab
47b0: 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 20 7c le |
47c0: 20 50 75 72 70 6f 73 65 20 20 20 20 20 20 20 20 Purpose
47d0: 20 20 20 20 0a 7c 20 4d 54 5f 54 45 53 54 5f 52 .| MT_TEST_R
47e0: 55 4e 5f 44 49 52 20 20 20 20 20 7c 20 54 68 65 UN_DIR | The
47f0: 20 64 69 72 65 63 74 6f 72 79 20 77 68 65 72 65 directory where
4800: 20 4d 65 67 61 74 65 73 74 20 72 61 6e 20 74 68 Megatest ran th
4810: 69 73 20 74 65 73 74 20 20 20 20 20 20 20 20 20 is test
4820: 20 20 20 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f .| MT_
4830: 43 4d 44 49 4e 46 4f 20 20 20 20 20 20 20 20 20 CMDINFO
4840: 20 7c 20 45 6e 63 6f 64 65 64 20 63 6f 6d 6d 61 | Encoded comma
4850: 6e 64 20 64 61 74 61 20 66 6f 72 20 74 68 65 20 nd data for the
4860: 74 65 73 74 20 20 20 20 20 20 20 20 20 20 20 20 test
4870: 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f 44 45 42 .| MT_DEB
4880: 55 47 5f 4d 4f 44 45 20 20 20 20 20 20 20 7c 20 UG_MODE |
4890: 55 73 65 64 20 74 6f 20 70 61 73 73 20 74 68 65 Used to pass the
48a0: 20 64 65 62 75 67 20 6d 6f 64 65 20 74 6f 20 6e debug mode to n
48b0: 65 73 74 65 64 20 63 61 6c 6c 73 20 74 6f 20 4d ested calls to M
48c0: 65 67 61 74 65 73 74 20 20 20 20 20 20 20 20 20 egatest
48d0: 20 20 20 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f .| MT_
48e0: 52 55 4e 5f 41 52 45 41 5f 48 4f 4d 45 20 20 20 RUN_AREA_HOME
48f0: 20 7c 20 4d 65 67 61 74 65 73 74 20 68 6f 6d 65 | Megatest home
4900: 20 61 72 65 61 20 0a 7c 20 4d 54 5f 54 45 53 54 area .| MT_TEST
4910: 53 55 49 54 45 4e 41 4d 45 20 20 20 20 7c 20 54 SUITENAME | T
4920: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 69 73 20 he name of this
4930: 74 65 73 74 73 75 69 74 65 20 6f 72 20 61 72 65 testsuite or are
4940: 61 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 a
4950: 20 20 20 20 0a 7c 20 4d 54 5f 54 45 53 54 5f 4e .| MT_TEST_N
4960: 41 4d 45 20 20 20 20 20 20 20 20 7c 20 54 68 65 AME | The
4970: 20 6e 61 6d 65 20 6f 66 20 74 68 69 73 20 74 65 name of this te
4980: 73 74 0a 7c 20 4d 54 5f 49 54 45 4d 5f 49 4e 46 st.| MT_ITEM_INF
4990: 4f 20 20 20 20 20 20 20 20 7c 20 54 68 65 20 76 O | The v
49a0: 61 72 69 61 62 6c 65 20 61 6e 64 20 76 61 6c 75 ariable and valu
49b0: 65 73 20 66 6f 72 20 74 68 65 20 74 65 73 74 20 es for the test
49c0: 69 74 65 6d 0a 7c 20 4d 54 5f 4d 45 47 41 54 45 item.| MT_MEGATE
49d0: 53 54 20 20 20 20 20 20 20 20 20 7c 20 57 68 69 ST | Whi
49e0: 63 68 20 4d 65 67 61 74 65 73 74 20 62 69 6e 61 ch Megatest bina
49f0: 72 79 20 69 73 20 62 65 69 6e 67 20 75 73 65 64 ry is being used
4a00: 20 62 79 20 74 68 69 73 20 61 72 65 61 0a 7c 20 by this area.|
4a10: 4d 54 5f 54 41 52 47 45 54 20 20 20 20 20 20 20 MT_TARGET
4a20: 20 20 20 20 7c 20 54 68 65 20 74 61 72 67 65 74 | The target
4a30: 20 76 61 72 69 61 62 6c 65 20 76 61 6c 75 65 73 variable values
4a40: 2c 20 73 65 70 61 72 61 74 65 64 20 62 79 20 27 , separated by '
4a50: 2f 27 0a 7c 20 4d 54 5f 4c 49 4e 4b 54 52 45 45 /'.| MT_LINKTREE
4a60: 20 20 20 20 20 20 20 20 20 7c 20 54 68 65 20 62 | The b
4a70: 61 73 65 20 6f 66 20 74 68 65 20 6c 69 6e 6b 20 ase of the link
4a80: 74 72 65 65 20 77 68 65 72 65 20 61 6c 6c 20 72 tree where all r
4a90: 75 6e 20 74 65 73 74 73 20 63 61 6e 20 62 65 20 un tests can be
4aa0: 66 6f 75 6e 64 0a 7c 20 4d 54 5f 49 54 45 4d 50 found.| MT_ITEMP
4ab0: 41 54 48 20 20 20 20 20 20 20 20 20 7c 20 54 68 ATH | Th
4ac0: 65 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 e values of the
4ad0: 69 74 65 6d 20 70 61 74 68 20 76 61 72 69 61 62 item path variab
4ae0: 6c 65 73 2c 20 73 65 70 61 72 61 74 65 64 20 62 les, separated b
4af0: 79 20 27 2f 27 0a 7c 20 4d 54 5f 52 55 4e 4e 41 y '/'.| MT_RUNNA
4b00: 4d 45 20 20 20 20 20 20 20 20 20 20 7c 20 54 68 ME | Th
4b10: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 72 75 e name of the ru
4b20: 6e 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d n.|=============
4b30: 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 0a 4f 76 65 72 =========...Over
4b40: 72 69 64 65 20 74 68 65 20 54 6f 70 6c 65 76 65 ride the Topleve
4b50: 6c 20 48 54 4d 4c 20 46 69 6c 65 0a 7e 7e 7e 7e l HTML File.~~~~
4b60: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
4b70: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 4d 65 67 ~~~~~~~~~~~..Meg
4b80: 61 74 65 73 74 20 67 65 6e 65 72 61 74 65 73 20 atest generates
4b90: 61 20 73 69 6d 70 6c 65 20 68 74 6d 6c 20 66 69 a simple html fi
4ba0: 6c 65 20 73 75 6d 6d 61 72 79 20 66 6f 72 20 74 le summary for t
4bb0: 6f 70 20 6c 65 76 65 6c 20 74 65 73 74 73 20 6f op level tests o
4bc0: 66 0a 69 74 65 72 61 74 65 64 20 74 65 73 74 73 f.iterated tests
4bd0: 2e 20 54 68 65 20 67 65 6e 65 72 61 74 69 6f 6e . The generation
4be0: 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64 can be overridd
4bf0: 65 6e 2e 20 4e 4f 54 45 3a 20 74 68 65 20 6f 75 en. NOTE: the ou
4c00: 74 70 75 74 20 6f 66 0a 74 68 65 20 73 63 72 69 tput of.the scri
4c10: 70 74 20 69 73 20 63 61 70 74 75 72 65 64 20 66 pt is captured f
4c20: 72 6f 6d 20 73 74 64 6f 75 74 20 74 6f 20 63 72 rom stdout to cr
4c30: 65 61 74 65 20 74 68 65 20 68 74 6d 6c 2e 0a 0a eate the html...
4c40: 0a 2e 46 6f 72 20 74 65 73 74 20 22 72 75 6e 66 ..For test "runf
4c50: 69 72 73 74 22 20 6f 76 65 72 72 69 64 65 20 74 irst" override t
4c60: 68 65 20 74 6f 70 6c 65 76 65 6c 20 67 65 6e 65 he toplevel gene
4c70: 72 61 74 69 6f 6e 20 77 69 74 68 20 61 20 73 63 ration with a sc
4c80: 72 69 70 74 20 22 6d 79 73 75 6d 6d 61 72 79 2e ript "mysummary.
4c90: 73 68 22 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d sh".------------
4ca0: 2d 2d 2d 2d 2d 0a 23 20 4f 76 65 72 72 69 64 65 -----.# Override
4cb0: 20 74 68 65 20 72 6f 6c 6c 75 70 20 66 6f 72 20 the rollup for
4cc0: 73 70 65 63 69 66 69 63 20 74 65 73 74 73 0a 5b specific tests.[
4cd0: 74 65 73 74 72 6f 6c 6c 75 70 5d 0a 72 75 6e 66 testrollup].runf
4ce0: 69 72 73 74 20 6d 79 73 75 6d 6d 61 72 79 2e 73 irst mysummary.s
4cf0: 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d h.--------------
4d00: 2d 2d 2d 0a 0a 41 72 63 68 69 76 69 6e 67 20 53 ---..Archiving S
4d10: 65 74 75 70 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d etup.-----------
4d20: 2d 2d 2d 2d 0a 0a 49 6e 20 6d 65 67 61 74 65 73 ----..In megates
4d30: 74 2e 63 6f 6e 66 69 67 20 61 64 64 20 74 68 65 t.config add the
4d40: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 63 74 69 following secti
4d50: 6f 6e 73 3a 0a 0a 2e 6d 65 67 61 74 65 73 74 2e ons:...megatest.
4d60: 63 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d config.---------
4d70: 2d 2d 2d 2d 2d 0a 5b 61 72 63 68 69 76 65 5d 0a -----.[archive].
4d80: 23 20 77 68 65 72 65 20 74 6f 20 67 65 74 20 62 # where to get b
4d90: 75 70 20 65 78 65 63 75 74 61 62 6c 65 0a 23 20 up executable.#
4da0: 62 75 70 20 2f 70 61 74 68 2f 74 6f 2f 62 75 70 bup /path/to/bup
4db0: 0a 0a 5b 61 72 63 68 69 76 65 2d 64 69 73 6b 73 ..[archive-disks
4dc0: 5d 0a 0a 23 20 41 72 63 68 69 76 65 73 20 77 69 ]..# Archives wi
4dd0: 6c 6c 20 62 65 20 6f 72 67 61 6e 69 73 65 64 20 ll be organised
4de0: 75 6e 64 65 72 20 74 68 65 73 65 20 70 61 74 68 under these path
4df0: 73 20 6c 69 6b 65 20 74 68 69 73 3a 0a 23 20 20 s like this:.#
4e00: 3c 74 65 73 74 73 75 69 74 65 3e 2f 3c 63 72 65 <testsuite>/<cre
4e10: 61 74 69 6f 6e 64 61 74 65 3e 0a 23 20 57 69 74 ationdate>.# Wit
4e20: 68 69 6e 20 74 68 65 20 61 72 63 68 69 76 65 20 hin the archive
4e30: 74 68 65 20 64 61 74 61 20 69 73 20 73 74 72 75 the data is stru
4e40: 63 74 75 72 65 64 20 6c 69 6b 65 20 74 68 69 73 ctured like this
4e50: 3a 0a 23 20 20 3c 74 61 72 67 65 74 3e 2f 3c 72 :.# <target>/<r
4e60: 75 6e 6e 61 6d 65 3e 2f 3c 74 65 73 74 3e 2f 0a unname>/<test>/.
4e70: 61 72 63 68 69 76 65 30 20 2f 6d 66 73 2f 6d 79 archive0 /mfs/my
4e80: 61 72 63 68 69 76 65 2d 64 61 74 61 2f 61 64 69 archive-data/adi
4e90: 73 6b 31 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d sk1.------------
4ea0: 2d 2d 0a 0a 48 61 6e 64 6c 69 6e 67 20 45 6e 76 --..Handling Env
4eb0: 69 72 6f 6e 6d 65 6e 74 20 56 61 72 69 61 62 6c ironment Variabl
4ec0: 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d es.-------------
4ed0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4ee0: 2d 0a 0a 49 74 20 69 73 20 6f 66 74 65 6e 20 6e -..It is often n
4ef0: 65 63 65 73 73 61 72 79 20 74 6f 20 63 61 70 74 ecessary to capt
4f00: 75 72 65 20 61 6e 64 20 6f 72 20 6d 61 6e 69 70 ure and or manip
4f10: 75 6c 61 74 65 20 65 6e 76 69 72 6f 6e 6d 65 6e ulate environmen
4f20: 74 0a 76 61 72 69 61 62 6c 65 73 2e 20 4d 65 67 t.variables. Meg
4f30: 61 74 65 73 74 20 68 61 73 20 73 6f 6d 65 20 66 atest has some f
4f40: 61 63 69 6c 69 74 69 65 73 20 62 75 69 6c 74 20 acilities built
4f50: 69 6e 20 74 6f 20 68 65 6c 70 2e 0a 0a 43 61 70 in to help...Cap
4f60: 74 75 72 65 20 76 61 72 69 61 62 6c 65 73 0a 7e ture variables.~
4f70: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
4f80: 0a 0a 2e 43 6f 6d 6d 61 6e 64 73 0a 2d 2d 2d 2d ...Commands.----
4f90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4fa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 63 61 70 ----------.# cap
4fb0: 74 75 72 65 20 74 68 65 20 63 75 72 72 65 6e 74 ture the current
4fc0: 20 65 6e 76 69 72 6f 6d 65 6e 74 20 69 6e 74 6f enviroment into
4fd0: 20 61 20 64 62 20 63 61 6c 6c 65 64 20 65 6e 76 a db called env
4fe0: 64 61 74 2e 64 62 20 75 6e 64 65 72 0a 23 20 74 dat.db under.# t
4ff0: 68 65 20 63 6f 6e 74 65 78 74 20 22 62 65 66 6f he context "befo
5000: 72 65 22 0a 6d 65 67 61 74 65 73 74 20 2d 65 6e re".megatest -en
5010: 76 63 61 70 20 62 65 66 6f 72 65 0a 0a 23 20 63 vcap before..# c
5020: 61 70 74 75 72 65 20 74 68 65 20 63 75 72 72 65 apture the curre
5030: 6e 74 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 69 nt environment i
5040: 6e 74 6f 20 61 20 64 62 20 63 61 6c 6c 65 64 20 nto a db called
5050: 73 74 61 72 74 75 70 2e 64 62 20 77 69 74 68 20 startup.db with
5060: 0a 23 20 63 6f 6e 74 65 78 74 20 22 61 66 74 65 .# context "afte
5070: 72 22 0a 6d 65 67 61 74 65 73 74 20 2d 65 6e 76 r".megatest -env
5080: 63 61 70 20 61 66 74 65 72 20 73 74 61 72 74 75 cap after startu
5090: 70 2e 64 62 0a 0a 23 20 77 72 69 74 65 20 74 68 p.db..# write th
50a0: 65 20 64 69 66 66 20 66 72 6f 6d 20 62 65 66 6f e diff from befo
50b0: 72 65 20 74 6f 20 61 66 74 65 72 0a 6d 65 67 61 re to after.mega
50c0: 74 65 73 74 20 2d 65 6e 76 64 65 6c 74 61 20 62 test -envdelta b
50d0: 65 66 6f 72 65 2d 61 66 74 65 72 20 2d 64 75 6d efore-after -dum
50e0: 70 6d 6f 64 65 20 62 61 73 68 0a 2d 2d 2d 2d 2d pmode bash.-----
50f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 75 6d 70 20 ---------..Dump
5110: 6d 6f 64 65 73 20 69 6e 63 6c 75 64 65 20 62 61 modes include ba
5120: 73 68 2c 20 63 73 68 20 61 6e 64 20 63 6f 6e 66 sh, csh and conf
5130: 69 67 2e 20 59 6f 75 20 63 61 6e 20 69 6e 63 6c ig. You can incl
5140: 75 64 65 20 63 6f 6e 66 69 67 20 64 61 74 61 0a ude config data.
5150: 69 6e 74 6f 20 6d 65 67 61 74 65 73 74 2e 63 6f into megatest.co
5160: 6e 66 69 67 20 6f 72 20 72 75 6e 63 6f 6e 66 69 nfig or runconfi
5170: 67 73 2e 63 6f 6e 66 69 67 2e 0a 0a 2e 45 78 61 gs.config....Exa
5180: 6d 70 6c 65 20 6f 66 20 67 65 6e 65 72 61 74 69 mple of generati
5190: 6e 67 20 61 6e 64 20 75 73 69 6e 67 20 63 6f 6e ng and using con
51a0: 66 69 67 20 64 61 74 61 0a 2d 2d 2d 2d 2d 2d 2d fig data.-------
51b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
51c0: 2d 2d 2d 2d 2d 2d 2d 0a 6d 65 67 61 74 65 73 74 -------.megatest
51d0: 20 2d 65 6e 76 63 61 70 20 6f 72 69 67 69 6e 61 -envcap origina
51e0: 6c 0a 23 20 64 6f 20 73 6f 6d 65 20 73 74 75 66 l.# do some stuf
51f0: 66 20 68 65 72 65 0a 6d 65 67 61 74 65 73 74 20 f here.megatest
5200: 2d 65 6e 76 63 61 70 20 6d 75 6e 67 65 64 0a 6d -envcap munged.m
5210: 65 67 61 74 65 73 74 20 2d 65 6e 76 64 65 6c 74 egatest -envdelt
5220: 61 20 6f 72 69 67 69 6e 61 6c 2d 6d 75 6e 67 65 a original-munge
5230: 64 20 2d 64 75 6d 70 6d 6f 64 65 20 69 6e 69 20 d -dumpmode ini
5240: 2d 6f 20 6d 6f 64 69 66 69 65 64 2e 63 6f 6e 66 -o modified.conf
5250: 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ig.-------------
5260: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5270: 2d 0a 0a 54 68 65 6e 20 69 6e 20 72 75 6e 63 6f -..Then in runco
5280: 6e 66 69 67 73 2e 63 6f 6e 66 69 67 0a 0a 2e 45 nfigs.config...E
5290: 78 61 6d 70 6c 65 20 6f 66 20 75 73 69 6e 67 20 xample of using
52a0: 6d 6f 64 69 66 69 65 64 2e 63 6f 6e 66 69 67 20 modified.config
52b0: 69 6e 20 61 20 74 65 73 74 63 6f 6e 66 69 67 0a in a testconfig.
52c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
52d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 63 --------------.c
52e0: 61 74 20 74 65 73 74 63 6f 6e 66 69 67 0a 5b 70 at testconfig.[p
52f0: 72 65 2d 6c 61 75 6e 63 68 2d 65 6e 76 2d 76 61 re-launch-env-va
5300: 72 73 5d 0a 5b 69 6e 63 6c 75 64 65 20 6d 6f 64 rs].[include mod
5310: 69 66 69 65 64 2e 63 6f 6e 66 69 67 5d 0a 2d 2d ified.config].--
5320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5330: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4d 61 ------------..Ma
5340: 6e 61 67 69 6e 67 20 4f 6c 64 20 52 75 6e 73 0a naging Old Runs.
5350: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5360: 2d 0a 0a 49 74 20 69 73 20 6f 66 74 65 6e 20 64 -..It is often d
5370: 65 73 69 72 65 64 20 74 6f 20 6b 65 65 70 20 73 esired to keep s
5380: 6f 6d 65 20 6f 6c 64 65 72 20 72 75 6e 73 20 61 ome older runs a
5390: 72 6f 75 6e 64 20 62 75 74 20 74 68 69 73 20 6d round but this m
53a0: 75 73 74 20 62 65 20 62 61 6c 61 6e 63 65 64 20 ust be balanced
53b0: 77 69 74 68 20 74 68 65 20 63 6f 73 74 73 20 6f with the costs o
53c0: 66 20 64 69 73 6b 20 73 70 61 63 65 2e 0a 0a 2e f disk space....
53d0: 20 55 73 65 20 2d 72 65 6d 6f 76 65 2d 6b 65 65 Use -remove-kee
53e0: 70 0a 2e 20 55 73 65 20 2d 61 72 63 68 69 76 65 p.. Use -archive
53f0: 20 28 63 61 6e 20 61 6c 73 6f 20 62 65 20 64 6f (can also be do
5400: 6e 65 20 66 72 6f 6d 20 74 68 65 20 2d 72 65 6d ne from the -rem
5410: 6f 76 65 2d 6b 65 65 70 20 69 6e 74 65 72 66 61 ove-keep interfa
5420: 63 65 29 0a 2e 20 75 73 65 20 2d 72 65 6d 6f 76 ce).. use -remov
5430: 65 2d 72 75 6e 73 20 77 69 74 68 20 2d 6b 65 65 e-runs with -kee
5440: 70 2d 72 65 63 6f 72 64 73 0a 0a 2e 46 6f 72 20 p-records...For
5450: 65 61 63 68 20 74 61 72 67 65 74 2c 20 72 65 6d each target, rem
5460: 6f 76 65 20 61 6c 6c 20 72 75 6e 73 20 62 75 74 ove all runs but
5470: 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 the most recent
5480: 20 33 20 69 66 20 74 68 65 79 20 61 72 65 20 6f 3 if they are o
5490: 76 65 72 20 31 20 77 65 65 6b 20 6f 6c 64 0a 2d ver 1 week old.-
54a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
54b0: 2d 2d 2d 2d 0a 23 20 75 73 65 20 2d 70 72 65 63 ----.# use -prec
54c0: 6d 64 20 27 73 6c 65 65 70 20 35 3b 6e 62 66 61 md 'sleep 5;nbfa
54d0: 6b 65 27 20 74 6f 20 6c 69 6d 69 74 20 6f 76 65 ke' to limit ove
54e0: 72 6c 6f 61 64 69 6e 67 20 74 68 65 20 68 6f 73 rloading the hos
54f0: 74 20 63 6f 6d 70 75 74 65 72 20 62 75 74 20 74 t computer but t
5500: 6f 20 61 6c 6c 6f 77 20 74 68 65 20 72 65 6d 6f o allow the remo
5510: 76 65 73 20 74 6f 20 72 75 6e 20 69 6e 20 70 61 ves to run in pa
5520: 72 61 6c 6c 65 6c 2e 0a 6d 65 67 61 74 65 73 74 rallel..megatest
5530: 20 2d 61 63 74 69 6f 6e 73 20 70 72 69 6e 74 2c -actions print,
5540: 72 65 6d 6f 76 65 2d 72 75 6e 73 20 2d 72 65 6d remove-runs -rem
5550: 6f 76 65 2d 6b 65 65 70 20 33 20 2d 74 61 72 67 ove-keep 3 -targ
5560: 65 74 20 25 2f 25 2f 25 2f 25 20 2d 72 75 6e 6e et %/%/%/% -runn
5570: 61 6d 65 20 25 20 2d 61 67 65 20 31 77 20 2d 70 ame % -age 1w -p
5580: 72 65 63 6d 64 20 27 73 6c 65 65 70 20 35 3b 6e recmd 'sleep 5;n
5590: 62 66 61 6b 65 27 22 0a 2d 2d 2d 2d 2d 2d 2d 2d bfake'".--------
55a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e -------------..N
55b0: 65 73 74 65 64 20 52 75 6e 73 0a 2d 2d 2d 2d 2d ested Runs.-----
55c0: 2d 2d 2d 2d 2d 2d 0a 0a 41 20 4d 65 67 61 74 65 ------..A Megate
55d0: 73 74 20 74 65 73 74 20 63 61 6e 20 72 75 6e 20 st test can run
55e0: 61 20 66 75 6c 6c 20 4d 65 67 61 74 65 73 74 20 a full Megatest
55f0: 72 75 6e 20 69 6e 20 65 69 74 68 65 72 20 74 68 run in either th
5600: 65 20 73 61 6d 65 0a 4d 65 67 61 74 65 73 74 20 e same.Megatest
5610: 61 72 65 61 20 6f 72 20 69 6e 20 61 6e 6f 74 68 area or in anoth
5620: 65 72 20 61 72 65 61 2e 20 54 68 69 73 20 69 73 er area. This is
5630: 20 61 20 70 6f 77 65 72 66 75 6c 20 77 61 79 20 a powerful way
5640: 6f 66 20 63 68 61 69 6e 69 6e 67 0a 63 6f 6d 70 of chaining.comp
5650: 6c 65 78 20 73 75 69 74 65 73 20 6f 66 20 74 65 lex suites of te
5660: 73 74 73 20 61 6e 64 20 6f 72 20 61 63 74 69 6f sts and or actio
5670: 6e 73 2e 0a 0a 49 66 20 79 6f 75 20 61 72 65 20 ns...If you are
5680: 6e 6f 74 20 75 73 69 6e 67 20 74 68 65 20 63 75 not using the cu
5690: 72 72 65 6e 74 20 61 72 65 61 20 79 6f 75 20 63 rrent area you c
56a0: 61 6e 20 75 73 65 20 65 7a 73 74 65 70 73 20 74 an use ezsteps t
56b0: 6f 20 72 65 74 72 69 65 76 65 0a 61 6e 64 20 73 o retrieve.and s
56c0: 65 74 75 70 20 74 68 65 20 73 75 62 2d 4d 65 67 etup the sub-Meg
56d0: 61 74 65 73 74 20 72 75 6e 20 61 72 65 61 2e 0a atest run area..
56e0: 0a 49 6e 20 74 68 65 20 74 65 73 74 63 6f 6e 66 .In the testconf
56f0: 69 67 3a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ig:.------------
5700: 2d 2d 2d 0a 5b 73 75 62 72 75 6e 5d 0a 0a 23 20 ---.[subrun]..#
5710: 52 65 71 75 69 72 65 64 3a 20 77 61 69 74 20 66 Required: wait f
5720: 6f 72 20 74 68 65 20 72 75 6e 20 6f 72 20 6a 75 or the run or ju
5730: 73 74 20 6c 61 75 6e 63 68 20 69 74 0a 23 20 20 st launch it.#
5740: 20 20 20 20 20 20 20 20 20 69 66 20 6e 6f 20 74 if no t
5750: 68 65 6e 20 74 68 65 20 72 75 6e 20 77 69 6c 6c hen the run will
5760: 20 62 65 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 be an automatic
5770: 20 50 41 53 53 20 69 72 72 65 73 70 65 63 74 69 PASS irrespecti
5780: 76 65 20 6f 66 20 74 68 65 20 61 63 74 75 61 6c ve of the actual
5790: 20 72 65 73 75 6c 74 0a 72 75 6e 2d 77 61 69 74 result.run-wait
57a0: 20 79 65 73 7c 6e 6f 0a 0a 23 20 4f 70 74 69 6f yes|no..# Optio
57b0: 6e 61 6c 3a 20 77 68 65 72 65 20 74 6f 20 65 78 nal: where to ex
57c0: 65 63 75 74 65 20 74 68 65 20 72 75 6e 2e 20 44 ecute the run. D
57d0: 65 66 61 75 6c 74 20 69 73 20 74 68 65 20 63 75 efault is the cu
57e0: 72 72 65 6e 74 20 72 75 6e 61 72 65 61 0a 72 75 rrent runarea.ru
57f0: 6e 2d 61 72 65 61 20 2f 73 6f 6d 65 2f 70 61 74 n-area /some/pat
5800: 68 2f 74 6f 2f 6d 65 67 61 74 65 73 74 2f 61 72 h/to/megatest/ar
5810: 65 61 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 ea..# Optional:
5820: 6d 65 74 68 6f 64 20 74 6f 20 75 73 65 20 74 6f method to use to
5830: 20 64 65 74 65 72 6d 69 6e 65 20 70 61 73 73 2f determine pass/
5840: 66 61 69 6c 20 73 74 61 74 75 73 20 6f 66 20 74 fail status of t
5850: 68 65 20 72 75 6e 0a 23 20 20 20 61 75 74 6f 20 he run.# auto
5860: 28 64 65 66 61 75 6c 74 29 20 2d 20 72 6f 6c 6c (default) - roll
5870: 20 75 70 20 74 68 65 20 6e 65 74 20 73 74 61 74 up the net stat
5880: 65 2f 73 74 61 74 75 73 20 6f 66 20 74 68 65 20 e/status of the
5890: 73 75 62 2d 72 75 6e 0a 23 20 20 20 6c 6f 67 70 sub-run.# logp
58a0: 72 6f 20 20 20 20 20 20 20 20 20 2d 20 75 73 65 ro - use
58b0: 20 74 68 65 20 70 72 6f 76 69 64 65 64 20 6c 6f the provided lo
58c0: 67 70 72 6f 20 72 75 6c 65 73 2c 20 68 61 70 70 gpro rules, happ
58d0: 65 6e 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c ens automaticall
58e0: 79 20 69 66 20 74 68 65 72 65 20 69 73 20 61 20 y if there is a
58f0: 6c 6f 67 70 72 6f 20 73 65 63 74 69 6f 6e 0a 23 logpro section.#
5900: 20 70 61 73 73 66 61 69 6c 20 61 75 74 6f 7c 6c passfail auto|l
5910: 6f 67 70 72 6f 0a 23 20 45 78 61 6d 70 6c 65 20 ogpro.# Example
5920: 6f 66 20 6c 6f 67 70 72 6f 3a 0a 70 61 73 73 66 of logpro:.passf
5930: 61 69 6c 20 6c 6f 67 70 72 6f 0a 0a 23 20 4f 70 ail logpro..# Op
5940: 74 69 6f 6e 61 6c 3a 20 0a 6c 6f 67 70 72 6f 20 tional: .logpro
5950: 3b 3b 20 69 66 20 74 68 69 73 20 73 65 63 74 69 ;; if this secti
5960: 6f 6e 20 65 78 69 73 74 73 20 74 68 65 6e 20 6c on exists then l
5970: 6f 67 70 72 6f 20 69 73 20 75 73 65 64 20 74 6f ogpro is used to
5980: 20 64 65 74 65 72 6d 69 6e 65 20 70 61 73 73 2f determine pass/
5990: 66 61 69 6c 0a 20 20 28 65 78 70 65 63 74 3a 72 fail. (expect:r
59a0: 65 71 75 69 72 65 64 20 69 6e 20 22 4c 6f 67 46 equired in "LogF
59b0: 69 6c 65 42 6f 64 79 22 20 3e 3d 20 31 20 22 41 ileBody" >= 1 "A
59c0: 74 20 6c 65 61 73 74 20 6f 6e 65 20 70 61 73 73 t least one pass
59d0: 22 20 23 2f 50 41 53 53 2f 29 0a 20 20 28 65 78 " #/PASS/). (ex
59e0: 70 65 63 74 3a 66 61 69 6c 20 20 20 20 20 69 6e pect:fail in
59f0: 20 22 4c 6f 67 46 69 6c 65 42 6f 64 79 22 20 20 "LogFileBody"
5a00: 3d 20 30 20 22 4e 6f 20 46 41 49 4c 73 20 61 6c = 0 "No FAILs al
5a10: 6c 6f 77 65 64 22 20 20 23 2f 46 41 49 4c 2f 29 lowed" #/FAIL/)
5a20: 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 74 61 ..# Optional: ta
5a30: 72 67 65 74 20 74 72 61 6e 73 6c 61 74 6f 72 2c rget translator,
5a40: 20 64 65 66 61 75 6c 74 20 69 73 20 74 6f 20 75 default is to u
5a50: 73 65 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 se the parent ta
5a60: 72 67 65 74 0a 74 61 72 67 65 74 20 23 7b 73 68 rget.target #{sh
5a70: 65 6c 6c 20 73 6f 6d 65 73 63 72 69 70 74 2e 73 ell somescript.s
5a80: 68 7d 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 h}..# Optional:
5a90: 72 75 6e 6e 61 6d 65 20 74 72 61 6e 73 6c 61 74 runname translat
5aa0: 6f 72 2f 67 65 6e 65 72 61 74 6f 72 2c 20 64 65 or/generator, de
5ab0: 66 61 75 6c 74 20 69 73 20 74 6f 20 75 73 65 20 fault is to use
5ac0: 74 68 65 20 70 61 72 65 6e 74 20 72 75 6e 6e 61 the parent runna
5ad0: 6d 65 0a 72 75 6e 2d 6e 61 6d 65 20 23 7b 73 6f me.run-name #{so
5ae0: 6d 65 73 63 72 69 70 74 2e 73 68 7d 0a 0a 23 20 mescript.sh}..#
5af0: 4f 70 74 69 6f 6e 61 6c 3a 20 74 65 73 74 70 61 Optional: testpa
5b00: 74 74 20 73 70 65 63 2c 20 64 65 66 61 75 6c 74 tt spec, default
5b10: 20 69 73 20 74 6f 20 66 69 72 73 74 20 6c 6f 6f is to first loo
5b20: 6b 20 66 6f 72 20 54 45 53 54 50 41 54 54 20 73 k for TESTPATT s
5b30: 70 65 63 20 66 72 6f 6d 20 72 75 6e 63 6f 6e 66 pec from runconf
5b40: 69 67 73 20 75 6e 6c 65 73 73 20 74 68 65 72 65 igs unless there
5b50: 20 69 73 20 61 20 63 6f 6e 74 6f 75 72 20 73 70 is a contour sp
5b60: 65 63 0a 74 65 73 74 2d 70 61 74 74 20 25 2f 69 ec.test-patt %/i
5b70: 74 65 6d 31 2c 74 65 73 74 32 0a 0a 23 20 4f 70 tem1,test2..# Op
5b80: 74 69 6f 6e 61 6c 3a 20 63 6f 6e 74 6f 75 72 20 tional: contour
5b90: 73 70 65 63 2c 20 75 73 65 20 74 68 65 20 6e 61 spec, use the na
5ba0: 6d 65 64 20 63 6f 6e 74 6f 75 72 20 66 72 6f 6d med contour from
5bb0: 20 74 68 65 20 6d 65 67 61 74 65 73 74 2e 63 6f the megatest.co
5bc0: 6e 66 69 67 20 63 6f 6e 74 6f 75 72 20 73 70 65 nfig contour spe
5bd0: 63 0a 63 6f 6e 74 6f 75 72 20 63 6f 6e 74 6f 75 c.contour contou
5be0: 72 6e 61 6d 65 20 23 23 23 20 4e 4f 54 45 3a 20 rname ### NOTE:
5bf0: 4e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 Not implemented
5c00: 79 65 74 21 20 4c 65 74 20 75 73 20 6b 6e 6f 77 yet! Let us know
5c10: 20 69 66 20 79 6f 75 20 6e 65 65 64 20 74 68 69 if you need thi
5c20: 73 20 66 65 61 74 75 72 65 2e 0a 0a 23 20 4f 70 s feature...# Op
5c30: 74 69 6f 6e 61 6c 3a 20 6d 6f 64 65 2d 70 61 74 tional: mode-pat
5c40: 74 2c 20 75 73 65 20 74 68 69 73 20 73 70 65 63 t, use this spec
5c50: 20 66 6f 72 20 74 65 73 74 70 61 74 74 20 66 72 for testpatt fr
5c60: 6f 6d 20 72 75 6e 63 6f 6e 66 69 67 73 0a 6d 6f om runconfigs.mo
5c70: 64 65 2d 70 61 74 74 20 54 45 53 54 50 41 54 54 de-patt TESTPATT
5c80: 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 74 61 ..# Optional: ta
5c90: 67 2d 65 78 70 72 2c 20 75 73 65 20 74 68 69 73 g-expr, use this
5ca0: 20 74 61 67 2d 65 78 70 72 20 74 6f 20 73 65 6c tag-expr to sel
5cb0: 65 63 74 20 74 65 73 74 73 0a 74 61 67 2d 65 78 ect tests.tag-ex
5cc0: 70 72 20 71 75 69 63 6b 0a 0a 23 20 4f 70 74 69 pr quick..# Opti
5cd0: 6f 6e 61 6c 3a 20 28 6e 6f 74 20 79 65 74 20 69 onal: (not yet i
5ce0: 6d 70 6c 65 6d 65 6e 74 65 64 2c 20 72 65 6d 6f mplemented, remo
5cf0: 76 65 2d 72 75 6e 73 20 69 73 20 61 6c 77 61 79 ve-runs is alway
5d00: 73 20 70 72 6f 70 61 67 61 74 65 64 20 61 74 20 s propagated at
5d10: 74 68 69 73 20 74 69 6d 65 29 2c 20 70 72 6f 70 this time), prop
5d20: 61 67 61 74 65 20 74 68 65 73 65 20 61 63 74 69 agate these acti
5d30: 6f 6e 73 20 66 72 6f 6d 20 74 68 65 20 70 61 72 ons from the par
5d40: 65 6e 74 0a 23 20 20 20 20 20 20 20 20 20 20 20 ent.#
5d50: 74 65 73 74 0a 23 20 20 20 4e 6f 74 65 2f 2f 20 test.# Note//
5d60: 64 65 66 61 75 6c 74 20 69 73 20 25 20 66 6f 72 default is % for
5d70: 20 61 6c 6c 0a 70 72 6f 70 61 67 61 74 65 20 72 all.propagate r
5d80: 65 6d 6f 76 65 2d 72 75 6e 73 20 61 72 63 68 69 emove-runs archi
5d90: 76 65 20 2e 2e 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d ve .....--------
5da0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 72 6f 67 72 61 6d -------..Program
5db0: 6d 69 6e 67 20 41 50 49 0a 2d 2d 2d 2d 2d 2d 2d ming API.-------
5dc0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 73 65 20 --------..These
5dd0: 72 6f 75 74 69 6e 65 73 20 63 61 6e 20 62 65 20 routines can be
5de0: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 20 called from the
5df0: 6d 65 67 61 74 65 73 74 20 72 65 70 6c 2e 20 0a megatest repl. .
5e00: 0a 2e 41 50 49 20 4b 65 79 73 20 52 65 6c 61 74 ..API Keys Relat
5e10: 65 64 20 43 61 6c 6c 73 0a 5b 77 69 64 74 68 3d ed Calls.[width=
5e20: 22 37 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d "70%",cols="^,2m
5e30: 2c 32 6d 2c 32 6d 22 2c 66 72 61 6d 65 3d 22 74 ,2m,2m",frame="t
5e40: 6f 70 62 6f 74 22 2c 6f 70 74 69 6f 6e 73 3d 22 opbot",options="
5e50: 68 65 61 64 65 72 2c 66 6f 6f 74 65 72 22 5d 0a header,footer"].
5e60: 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |===============
5e70: 3d 3d 3d 3d 3d 3d 3d 0a 7c 41 50 49 20 43 61 6c =======.|API Cal
5e80: 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l
5e90: 20 20 20 20 20 20 20 20 20 7c 20 50 75 72 70 6f | Purpo
5ea0: 73 65 20 63 6f 6d 6d 65 6e 74 73 20 20 20 7c 20 se comments |
5eb0: 52 65 74 75 72 6e 73 20 20 20 20 20 20 20 20 20 Returns
5ec0: 20 20 20 20 20 20 20 20 7c 20 43 6f 6d 6d 65 6e | Commen
5ed0: 74 73 0a 7c 28 72 6d 74 3a 67 65 74 2d 6b 65 79 ts.|(rmt:get-key
5ee0: 73 20 72 75 6e 2d 69 64 29 20 20 20 20 20 20 20 s run-id)
5ef0: 20 20 20 20 7c 20 20 20 20 20 20 20 20 20 20 20 |
5f00: 20 20 20 20 20 20 20 20 20 7c 20 28 20 6b 65 79 | ( key
5f10: 31 20 6b 65 79 32 20 2e 2e 2e 20 29 20 20 20 20 1 key2 ... )
5f20: 20 20 20 7c 20 0a 7c 20 28 72 6d 74 3a 67 65 74 | .| (rmt:get
5f30: 2d 6b 65 79 2d 76 61 6c 2d 70 61 69 72 73 20 72 -key-val-pairs r
5f40: 75 6e 2d 69 64 29 20 7c 20 20 20 20 20 20 20 20 un-id) |
5f50: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 23 74 | #t
5f60: 3d 73 75 63 63 65 73 73 2f 23 66 3d 66 61 69 6c =success/#f=fail
5f70: 20 20 20 20 20 20 7c 20 57 6f 72 6b 73 20 6f 6e | Works on
5f80: 6c 79 20 69 66 20 74 68 65 20 73 65 72 76 65 72 ly if the server
5f90: 20 69 73 20 73 74 69 6c 6c 20 72 65 61 63 68 61 is still reacha
5fa0: 62 6c 65 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ble.|===========
5fb0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 0a 3a 6e ===========...:n
5fc0: 75 6d 62 65 72 65 64 21 3a 0a 0a 5a 20 64 65 38 umbered!:..Z de8
5fd0: 35 63 30 62 34 64 35 35 66 38 39 65 31 34 39 66 5c0b4d55f89e149f
5fe0: 37 36 38 38 32 33 61 64 33 31 61 33 63 0a 768823ad31a3c.