0000: 44 20 32 30 31 38 2d 30 34 2d 30 34 54 31 39 3a D 2018-04-04T19:
0010: 35 34 3a 30 32 2e 30 37 38 0a 4c 20 72 65 66 65 54:02.078.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: 6d 72 77 65 6c 6c 61 6e 0a 57 20 32 34 32 31 37 mrwellan.W 24217
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 2f 2f 0a 2f 2f icenses/>..//.//
0340: 20 43 6f 70 79 72 69 67 68 74 20 32 30 30 36 2d Copyright 2006-
0350: 32 30 31 32 2c 20 4d 61 74 74 68 65 77 20 57 65 2012, Matthew We
0360: 6c 6c 61 6e 64 2e 0a 0a 52 65 66 65 72 65 6e 63 lland...Referenc
0370: 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 6f 6e e.---------..Con
0380: 66 69 67 20 46 69 6c 65 20 48 65 6c 70 65 72 73 fig File Helpers
0390: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e .~~~~~~~~~~~~~~~
03a0: 7e 7e 7e 7e 0a 0a 56 61 72 69 6f 75 73 20 68 65 ~~~~..Various he
03b0: 6c 70 65 72 73 20 66 6f 72 20 6d 6f 72 65 20 61 lpers for more a
03c0: 64 76 61 6e 63 65 64 20 63 6f 6e 66 69 67 20 66 dvanced config f
03d0: 69 6c 65 73 2e 0a 0a 2e 48 65 6c 70 65 72 73 0a iles....Helpers.
03e0: 5b 77 69 64 74 68 3d 22 38 30 25 22 2c 63 6f 6c [width="80%",col
03f0: 73 3d 22 5e 2c 32 6d 2c 32 6d 2c 32 6d 22 2c 66 s="^,2m,2m,2m",f
0400: 72 61 6d 65 3d 22 74 6f 70 62 6f 74 22 2c 6f 70 rame="topbot",op
0410: 74 69 6f 6e 73 3d 22 68 65 61 64 65 72 22 5d 0a tions="header"].
0420: 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |===============
0430: 3d 3d 3d 3d 3d 3d 3d 0a 7c 48 65 6c 70 65 72 20 =======.|Helper
0440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0450: 20 20 20 20 20 7c 20 50 75 72 70 6f 73 65 20 20 | Purpose
0460: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0470: 20 20 20 20 20 7c 20 56 61 6c 69 64 20 76 61 6c | Valid val
0480: 75 65 73 20 20 20 20 20 20 20 20 20 20 20 20 7c ues |
0490: 20 43 6f 6d 6d 65 6e 74 73 0a 7c 20 23 7b 73 63 Comments.| #{sc
04a0: 68 65 6d 65 20 28 73 63 68 65 6d 65 20 63 6f 64 heme (scheme cod
04b0: 65 2e 2e 2e 29 7d 20 7c 20 45 78 65 63 75 74 65 e...)} | Execute
04c0: 20 61 72 62 69 74 72 61 72 79 20 73 63 68 65 6d arbitrary schem
04d0: 65 20 63 6f 64 65 20 7c 20 41 6e 79 20 76 61 6c e code | Any val
04e0: 69 64 20 73 63 68 65 6d 65 20 20 20 20 20 20 20 id scheme
04f0: 20 7c 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 | Value returne
0500: 64 20 66 72 6f 6d 20 74 68 65 20 63 61 6c 6c 20 d from the call
0510: 69 73 20 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 is converted to
0520: 61 20 73 74 72 69 6e 67 20 61 6e 64 20 70 72 6f a string and pro
0530: 63 65 73 73 65 64 20 61 73 20 70 61 72 74 20 6f cessed as part o
0540: 66 20 74 68 65 20 63 6f 6e 66 69 67 20 66 69 6c f the config fil
0550: 65 0a 7c 20 23 7b 73 79 73 74 65 6d 20 63 6f 6d e.| #{system com
0560: 6d 61 6e 64 7d 20 20 20 20 20 20 20 20 20 20 7c mand} |
0570: 20 45 78 65 63 75 74 65 20 70 72 6f 67 72 61 6d Execute program
0580: 2c 20 69 6e 73 65 72 74 73 20 65 78 69 74 20 63 , inserts exit c
0590: 6f 64 65 20 20 7c 20 41 6e 79 20 76 61 6c 69 64 ode | Any valid
05a0: 20 55 6e 69 78 20 63 6f 6d 6d 61 6e 64 20 20 7c Unix command |
05b0: 20 44 69 73 63 61 72 64 73 20 74 68 65 20 6f 75 Discards the ou
05c0: 74 70 75 74 20 66 72 6f 6d 20 74 68 65 20 70 72 tput from the pr
05d0: 6f 67 72 61 6d 0a 7c 20 23 7b 73 68 65 6c 6c 20 ogram.| #{shell
05e0: 20 63 6f 6d 6d 61 6e 64 7d 20 6f 72 20 23 7b 73 command} or #{s
05f0: 68 20 2e 2e 2e 7d 20 20 7c 20 45 78 65 63 75 74 h ...} | Execut
0600: 65 20 70 72 6f 67 72 61 6d 2c 20 69 6e 73 65 72 e program, inser
0610: 74 73 20 72 65 73 75 6c 74 20 66 72 6f 6d 20 73 ts result from s
0620: 74 64 6f 75 74 20 7c 20 41 6e 79 20 76 61 6c 69 tdout | Any vali
0630: 64 20 55 6e 69 78 20 63 6f 6d 6d 61 6e 64 20 7c d Unix command |
0640: 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 Value returned
0650: 66 72 6f 6d 20 74 68 65 20 63 61 6c 6c 20 69 73 from the call is
0660: 20 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 61 20 converted to a
0670: 73 74 72 69 6e 67 20 61 6e 64 20 70 72 6f 63 65 string and proce
0680: 73 73 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 ssed as part of
0690: 74 68 65 20 63 6f 6e 66 69 67 20 66 69 6c 65 0a the config file.
06a0: 7c 20 23 7b 72 65 61 6c 70 61 74 68 20 70 61 74 | #{realpath pat
06b0: 68 7d 20 6f 72 20 23 7b 72 70 20 2e 2e 2e 7d 20 h} or #{rp ...}
06c0: 20 20 7c 20 52 65 70 6c 61 63 65 20 77 69 74 68 | Replace with
06d0: 20 6e 6f 72 6d 61 6c 69 7a 65 64 20 70 61 74 68 normalized path
06e0: 20 7c 20 4d 75 73 74 20 62 65 20 61 20 76 61 6c | Must be a val
06f0: 69 64 20 70 61 74 68 20 7c 0a 7c 20 23 7b 67 65 id path |.| #{ge
0700: 74 65 6e 76 20 56 41 52 7d 20 6f 72 20 23 7b 67 tenv VAR} or #{g
0710: 76 20 56 41 52 7d 20 20 20 20 20 20 7c 20 52 65 v VAR} | Re
0720: 70 6c 61 63 65 20 77 69 74 68 20 63 6f 6e 74 65 place with conte
0730: 6e 74 20 6f 66 20 65 6e 76 20 76 61 72 69 61 62 nt of env variab
0740: 6c 65 20 7c 20 4d 75 73 74 20 62 65 20 61 20 76 le | Must be a v
0750: 61 6c 69 64 20 76 61 72 20 7c 0a 7c 20 23 7b 67 alid var |.| #{g
0760: 65 74 20 73 20 76 7d 20 6f 72 20 23 7b 67 20 73 et s v} or #{g s
0770: 20 76 7d 20 20 20 20 20 7c 20 52 65 70 6c 61 63 v} | Replac
0780: 65 20 77 69 74 68 20 76 61 72 69 61 62 6c 65 20 e with variable
0790: 76 20 66 72 6f 6d 20 73 65 63 74 69 6f 6e 20 73 v from section s
07a0: 20 7c 20 56 61 72 69 61 62 6c 65 20 6d 75 73 74 | Variable must
07b0: 20 62 65 20 64 65 66 69 6e 65 64 20 62 65 66 6f be defined befo
07c0: 72 65 20 75 73 65 20 7c 0a 7c 20 23 7b 72 67 65 re use |.| #{rge
07d0: 74 20 76 7d 20 20 20 20 20 20 20 20 20 20 20 20 t v}
07e0: 20 20 20 20 20 20 7c 20 52 65 70 6c 61 63 65 20 | Replace
07f0: 77 69 74 68 20 76 61 72 69 61 62 6c 65 20 76 20 with variable v
0800: 66 72 6f 6d 20 74 61 72 67 65 74 20 6f 72 20 64 from target or d
0810: 65 66 61 75 6c 74 20 6f 66 20 72 75 6e 63 6f 6e efault of runcon
0820: 66 69 67 73 20 66 69 6c 65 20 7c 20 7c 0a 7c 20 figs file | |.|
0830: 23 7b 6d 74 72 61 68 7d 20 20 20 20 20 20 20 20 #{mtrah}
0840: 20 20 20 20 20 20 20 20 20 20 20 7c 20 52 65 70 | Rep
0850: 6c 61 63 65 20 77 69 74 68 20 74 68 65 20 70 61 lace with the pa
0860: 74 68 20 74 6f 20 74 68 65 20 6d 65 67 61 74 65 th to the megate
0870: 73 74 20 74 65 73 74 73 75 69 74 65 20 61 72 65 st testsuite are
0880: 61 20 7c 20 7c 20 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d a | | .|========
0890: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a ==============..
08a0: 43 6f 6e 66 69 67 20 46 69 6c 65 20 53 65 74 74 Config File Sett
08b0: 69 6e 67 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ings.~~~~~~~~~~~
08c0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 53 65 74 74 69 ~~~~~~~~~..Setti
08d0: 6e 67 73 20 69 6e 20 6d 65 67 61 74 65 73 74 2e ngs in megatest.
08e0: 63 6f 6e 66 69 67 0a 0a 43 6f 6e 66 69 67 20 46 config..Config F
08f0: 69 6c 65 20 41 64 64 69 74 69 6f 6e 61 6c 20 46 ile Additional F
0900: 65 61 74 75 72 65 73 0a 7e 7e 7e 7e 7e 7e 7e 7e eatures.~~~~~~~~
0910: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0920: 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 63 6c 75 64 69 ~~~~~~~..Includi
0930: 6e 67 20 6f 75 74 70 75 74 20 66 72 6f 6d 20 61 ng output from a
0940: 20 73 63 72 69 70 74 20 61 73 20 69 66 20 69 74 script as if it
0950: 20 77 61 73 20 69 6e 6c 69 6e 65 20 74 6f 20 74 was inline to t
0960: 68 65 20 63 6f 6e 66 69 67 20 66 69 6c 65 3a 0a he config file:.
0970: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0980: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 63 72 69 ----------.[scri
0990: 70 74 69 6e 63 20 6d 79 73 63 72 69 70 74 2e 73 ptinc myscript.s
09a0: 68 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d h].-------------
09b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 66 ------------..If
09c0: 20 74 68 65 20 73 63 72 69 70 74 20 6f 75 74 70 the script outp
09d0: 75 74 73 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d uts:..----------
09e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
09f0: 5b 69 74 65 6d 73 5d 0a 41 20 61 20 62 20 63 0a [items].A a b c.
0a00: 42 20 64 20 65 20 66 0a 2d 2d 2d 2d 2d 2d 2d 2d B d e f.--------
0a10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0a20: 2d 0a 0a 54 68 65 6e 20 74 68 65 20 63 6f 6e 66 -..Then the conf
0a30: 69 67 20 66 69 6c 65 20 77 6f 75 6c 64 20 65 66 ig file would ef
0a40: 66 65 63 74 69 76 65 6c 79 20 61 70 70 65 61 72 fectively appear
0a50: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 61 6e 20 69 to contain an i
0a60: 74 65 6d 73 20 73 65 63 74 69 6f 6e 0a 65 78 61 tems section.exa
0a70: 63 74 6c 79 20 6c 69 6b 65 20 74 68 65 20 6f 75 ctly like the ou
0a80: 74 70 75 74 20 66 72 6f 6d 20 74 68 65 20 73 63 tput from the sc
0a90: 72 69 70 74 2e 20 54 68 69 73 20 69 73 20 75 73 ript. This is us
0aa0: 65 66 75 6c 20 77 68 65 6e 20 64 79 6e 61 6d 69 eful when dynami
0ab0: 63 61 6c 6c 79 0a 63 72 65 61 74 69 6e 67 20 69 cally.creating i
0ac0: 74 65 6d 73 2c 20 69 74 65 6d 73 74 61 62 6c 65 tems, itemstable
0ad0: 73 20 61 6e 64 20 6f 74 68 65 72 20 63 6f 6e 66 s and other conf
0ae0: 69 67 20 73 74 72 75 63 74 75 72 65 73 2e 20 59 ig structures. Y
0af0: 6f 75 20 63 61 6e 20 73 65 65 20 74 68 65 0a 65 ou can see the.e
0b00: 78 70 61 6e 73 69 6f 6e 20 6f 66 20 74 68 65 20 xpansion of the
0b10: 63 61 6c 6c 20 62 79 20 6c 6f 6f 6b 69 6e 67 20 call by looking
0b20: 69 6e 20 74 68 65 20 63 61 63 68 65 64 20 66 69 in the cached fi
0b30: 6c 65 73 20 28 6c 6f 6f 6b 20 69 6e 20 79 6f 75 les (look in you
0b40: 72 20 6c 69 6e 6b 74 72 65 65 0a 66 6f 72 20 6d r linktree.for m
0b50: 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 20 61 egatest.config a
0b60: 6e 64 20 72 75 6e 63 6f 6e 66 69 67 73 2e 63 6f nd runconfigs.co
0b70: 6e 66 69 67 20 63 61 63 68 65 20 66 69 6c 65 73 nfig cache files
0b80: 20 61 6e 64 20 69 6e 20 79 6f 75 72 20 74 65 73 and in your tes
0b90: 74 20 72 75 6e 0a 61 72 65 61 73 20 66 6f 72 20 t run.areas for
0ba0: 74 68 65 20 65 78 70 61 6e 64 65 64 20 61 6e 64 the expanded and
0bb0: 20 63 61 63 68 65 64 20 74 65 73 74 63 6f 6e 66 cached testconf
0bc0: 69 67 29 2e 0a 0a 57 69 6c 64 63 61 72 64 73 20 ig)...Wildcards
0bd0: 61 6e 64 20 72 65 67 65 78 65 73 20 69 6e 20 54 and regexes in T
0be0: 61 72 67 65 74 73 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d argets..--------
0bf0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0c00: 2d 0a 5b 61 2f 32 2f 62 5d 0a 56 41 52 31 20 56 -.[a/2/b].VAR1 V
0c10: 41 4c 31 0a 0a 5b 61 2f 25 2f 62 5d 0a 56 41 52 AL1..[a/%/b].VAR
0c20: 31 20 56 41 4c 32 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 1 VAL2.---------
0c30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0c40: 0a 0a 57 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e ..Will result in
0c50: 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d :..-------------
0c60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 61 2f ------------.[a/
0c70: 32 2f 62 5d 0a 56 41 52 31 20 56 41 4c 32 0a 2d 2/b].VAR1 VAL2.-
0c80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0c90: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 43 61 6e 20 75 73 --------..Can us
0ca0: 65 20 65 69 74 68 65 72 20 77 69 6c 64 63 61 72 e either wildcar
0cb0: 64 20 6f 66 20 22 25 22 20 6f 72 20 61 20 72 65 d of "%" or a re
0cc0: 67 75 6c 61 72 20 65 78 70 72 65 73 73 69 6f 6e gular expression
0cd0: 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d :..-------------
0ce0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 2f 61 ------------.[/a
0cf0: 62 63 2e 2a 64 65 66 2f 5d 0a 2d 2d 2d 2d 2d 2d bc.*def/].------
0d00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0d10: 2d 2d 2d 0a 0a 44 69 73 6b 20 53 70 61 63 65 20 ---..Disk Space
0d20: 43 68 65 63 6b 73 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e Checks.^^^^^^^^^
0d30: 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 53 6f 6d 65 20 70 ^^^^^^^^..Some p
0d40: 61 72 61 6d 65 74 65 72 73 20 79 6f 75 20 63 61 arameters you ca
0d50: 6e 20 70 75 74 20 69 6e 20 74 68 65 20 5b 73 65 n put in the [se
0d60: 74 75 70 5d 20 73 65 63 74 69 6f 6e 20 6f 66 20 tup] section of
0d70: 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 3a megatest.config:
0d80: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
0d90: 2d 2d 2d 2d 2d 0a 23 20 6d 69 6e 69 6d 75 6d 20 -----.# minimum
0da0: 73 70 61 63 65 20 72 65 71 75 69 72 65 64 20 69 space required i
0db0: 6e 20 61 20 72 75 6e 20 64 69 73 6b 20 0a 6d 69 n a run disk .mi
0dc0: 6e 73 70 61 63 65 20 31 30 30 30 30 30 30 30 0a nspace 10000000.
0dd0: 0a 23 20 6d 69 6e 69 6d 75 6d 20 73 70 61 63 65 .# minimum space
0de0: 20 72 65 71 75 69 72 65 64 20 69 6e 20 64 62 64 required in dbd
0df0: 69 72 3a 0a 64 62 64 69 72 2d 73 70 61 63 65 2d ir:.dbdir-space-
0e00: 72 65 71 75 69 72 65 64 20 31 30 30 30 30 30 0a required 100000.
0e10: 0a 23 20 73 63 72 69 70 74 20 74 68 61 74 20 74 .# script that t
0e20: 61 6b 65 73 20 70 61 74 68 20 61 73 20 70 61 72 akes path as par
0e30: 61 6d 65 74 65 72 20 61 6e 64 20 72 65 74 75 72 ameter and retur
0e40: 6e 73 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 ns number of byt
0e50: 65 73 20 61 76 61 69 6c 61 62 6c 65 3a 0a 66 72 es available:.fr
0e60: 65 65 2d 73 70 61 63 65 2d 73 63 72 69 70 74 20 ee-space-script
0e70: 63 68 65 63 6b 2d 73 70 61 63 65 2e 73 68 0a 2d check-space.sh.-
0e80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0e90: 2d 2d 0a 0a 54 72 69 6d 20 74 72 61 69 6c 69 6e --..Trim trailin
0ea0: 67 20 73 70 61 63 65 73 0a 5e 5e 5e 5e 5e 5e 5e g spaces.^^^^^^^
0eb0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2d ^^^^^^^^^^^^^..-
0ec0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0ed0: 2d 0a 5b 63 6f 6e 66 69 67 66 3a 73 65 74 74 69 -.[configf:setti
0ee0: 6e 67 73 20 74 72 69 6d 2d 74 72 61 69 6c 69 6e ngs trim-trailin
0ef0: 67 2d 73 70 61 63 65 73 20 79 65 73 5d 0a 2d 2d g-spaces yes].--
0f00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0f10: 0a 0a 4a 6f 62 20 53 75 62 6d 69 73 73 69 6f 6e ..Job Submission
0f20: 20 43 6f 6e 74 72 6f 6c 0a 5e 5e 5e 5e 5e 5e 5e Control.^^^^^^^
0f30: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a ^^^^^^^^^^^^^^^.
0f40: 0a 53 75 62 6d 69 74 20 6a 6f 62 73 20 74 6f 20 .Submit jobs to
0f50: 48 6f 73 74 20 54 79 70 65 73 20 62 61 73 65 64 Host Types based
0f60: 20 6f 6e 20 54 65 73 74 20 4e 61 6d 65 0a 2b 2b on Test Name.++
0f70: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ++++++++++++++++
0f80: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ++++++++++++++++
0f90: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 2e 49 6e 20 ++++++++++...In
0fa0: 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 0a megatest.config.
0fb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0fc0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 68 6f 73 74 2d 74 --------.[host-t
0fd0: 79 70 65 73 5d 0a 67 65 6e 65 72 61 6c 20 20 20 ypes].general
0fe0: 6e 62 66 61 6b 65 0a 72 65 6d 6f 74 65 20 20 20 nbfake.remote
0ff0: 20 62 73 75 62 0a 0a 5b 6c 61 75 6e 63 68 65 72 bsub..[launcher
1000: 73 5d 0a 72 75 6e 66 69 72 73 74 2f 73 75 6d 25 s].runfirst/sum%
1010: 20 72 65 6d 6f 74 65 0a 25 20 67 65 6e 65 72 61 remote.% genera
1020: 6c 0a 0a 5b 6a 6f 62 74 6f 6f 6c 73 5d 0a 6c 61 l..[jobtools].la
1030: 75 6e 63 68 65 72 20 62 73 75 62 0a 23 20 69 66 uncher bsub.# if
1040: 20 64 65 66 69 6e 65 64 20 61 6e 64 20 6e 6f 74 defined and not
1050: 20 22 6e 6f 22 20 66 6c 65 78 69 2d 6c 61 75 6e "no" flexi-laun
1060: 63 68 65 72 20 77 69 6c 6c 20 62 79 70 61 73 73 cher will bypass
1070: 20 6c 61 75 6e 63 68 65 72 20 75 6e 6c 65 73 73 launcher unless
1080: 20 0a 23 20 74 68 65 72 65 20 69 73 20 6e 6f 20 .# there is no
1090: 68 6f 73 74 2d 74 79 70 65 20 6d 61 74 63 68 2e host-type match.
10a0: 0a 66 6c 65 78 69 2d 6c 61 75 6e 63 68 65 72 20 .flexi-launcher
10b0: 79 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d yes.------------
10c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 68 6f ------------..ho
10d0: 73 74 2d 74 79 70 65 73 0a 2b 2b 2b 2b 2b 2b 2b st-types.+++++++
10e0: 2b 2b 2b 0a 0a 4c 69 73 74 20 6f 66 20 68 6f 73 +++..List of hos
10f0: 74 20 74 79 70 65 73 20 61 6e 64 20 74 68 65 20 t types and the
1100: 63 6f 6d 6d 61 6e 64 6c 69 6e 65 20 74 6f 20 72 commandline to r
1110: 75 6e 20 61 20 6a 6f 62 20 6f 6e 20 74 68 61 74 un a job on that
1120: 20 68 6f 73 74 20 74 79 70 65 2e 0a 0a 2e 68 6f host type....ho
1130: 73 74 2d 74 79 70 65 20 3d 3e 20 6c 61 75 6e 63 st-type => launc
1140: 68 20 63 6f 6d 6d 61 6e 64 0a 2d 2d 2d 2d 2d 2d h command.------
1150: 2d 2d 2d 2d 2d 2d 0a 67 65 6e 65 72 61 6c 20 6e ------.general n
1160: 62 66 61 6b 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d bfake.----------
1170: 2d 2d 0a 0a 6c 61 75 6e 63 68 65 72 73 0a 2b 2b --..launchers.++
1180: 2b 2b 2b 2b 2b 2b 2b 0a 0a 2e 74 65 73 74 2f 69 +++++++...test/i
1190: 74 65 6d 70 61 74 68 20 3d 3e 20 68 6f 73 74 2d tempath => host-
11a0: 74 79 70 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d type.-----------
11b0: 2d 0a 72 75 6e 66 69 72 73 74 2f 73 75 6d 25 20 -.runfirst/sum%
11c0: 72 65 6d 6f 74 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d remote.---------
11d0: 2d 2d 2d 0a 0a 4d 69 73 63 65 6c 6c 61 6e 65 6f ---..Miscellaneo
11e0: 75 73 20 53 65 74 75 70 20 49 74 65 6d 73 0a 2b us Setup Items.+
11f0: 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b ++++++++++++++++
1200: 2b 2b 2b 2b 2b 2b 2b 2b 0a 0a 41 74 74 65 6d 70 ++++++++..Attemp
1210: 74 20 74 6f 20 72 65 72 75 6e 20 74 65 73 74 73 t to rerun tests
1220: 20 69 6e 20 22 53 54 55 43 4b 2f 44 45 41 44 22 in "STUCK/DEAD"
1230: 2c 20 22 6e 2f 61 22 2c 20 22 5a 45 52 4f 5f 49 , "n/a", "ZERO_I
1240: 54 45 4d 53 22 20 73 74 61 74 65 73 2e 0a 0a 2e TEMS" states....
1250: 49 6e 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e 66 In megatest.conf
1260: 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ig.-------------
1270: 2d 2d 2d 2d 2d 0a 5b 73 65 74 75 70 5d 0a 72 65 -----.[setup].re
1280: 72 75 6e 73 20 35 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d runs 5.---------
1290: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 65 70 6c 61 ---------..Repla
12a0: 63 65 20 74 68 65 20 64 65 66 61 75 6c 74 20 62 ce the default b
12b0: 6c 61 63 6b 6c 69 73 74 65 64 20 65 6e 76 69 72 lacklisted envir
12c0: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73 onment variables
12d0: 20 77 69 74 68 20 75 73 65 72 20 73 75 70 70 6c with user suppl
12e0: 69 65 64 0a 6c 69 73 74 2e 0a 0a 44 65 66 61 75 ied.list...Defau
12f0: 6c 74 20 6c 69 73 74 3a 20 55 53 45 52 20 48 4f lt list: USER HO
1300: 4d 45 20 44 49 53 50 4c 41 59 20 4c 53 5f 43 4f ME DISPLAY LS_CO
1310: 4c 4f 52 53 20 58 4b 45 59 53 59 4d 44 42 20 45 LORS XKEYSYMDB E
1320: 44 49 54 4f 52 20 4d 41 4b 45 46 4c 41 47 53 20 DITOR MAKEFLAGS
1330: 4d 41 4b 45 46 20 4d 41 4b 45 4f 56 45 52 52 49 MAKEF MAKEOVERRI
1340: 44 45 53 0a 0a 2e 41 64 64 20 61 20 22 62 61 64 DES...Add a "bad
1350: 22 20 76 61 72 69 61 62 6c 65 20 22 50 52 4f 4d " variable "PROM
1360: 50 54 22 20 74 6f 20 74 68 65 20 76 61 72 69 61 PT" to the varia
1370: 62 6c 65 73 20 74 68 61 74 20 77 69 6c 6c 20 62 bles that will b
1380: 65 20 63 6f 6d 6d 65 6e 74 65 64 20 6f 75 74 0a e commented out.
1390: 69 6e 20 74 68 65 20 6d 65 67 61 74 65 73 74 2e in the megatest.
13a0: 73 68 20 61 6e 64 20 6d 65 67 61 74 65 73 74 2e sh and megatest.
13b0: 63 73 68 20 66 69 6c 65 73 3a 0a 2d 2d 2d 2d 2d csh files:.-----
13c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 65 ------------.[se
13d0: 74 75 70 5d 0a 62 6c 61 63 6b 6c 69 73 74 76 61 tup].blacklistva
13e0: 72 73 20 55 53 45 52 20 48 4f 4d 45 20 44 49 53 rs USER HOME DIS
13f0: 50 4c 41 59 20 4c 53 5f 43 4f 4c 4f 52 53 20 58 PLAY LS_COLORS X
1400: 4b 45 59 53 59 4d 44 42 20 45 44 49 54 4f 52 20 KEYSYMDB EDITOR
1410: 4d 41 4b 45 46 4c 41 47 53 20 50 52 4f 4d 50 54 MAKEFLAGS PROMPT
1420: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
1430: 2d 2d 0a 0a 52 75 6e 20 74 69 6d 65 20 6c 69 6d --..Run time lim
1440: 69 74 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b it.+++++++++++++
1450: 2b 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d +..-------------
1460: 2d 2d 2d 2d 0a 5b 73 65 74 75 70 5d 0a 23 20 74 ----.[setup].# t
1470: 68 69 73 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 his will automat
1480: 69 63 61 6c 6c 79 20 6b 69 6c 6c 20 74 68 65 20 ically kill the
1490: 74 65 73 74 20 69 66 20 69 74 20 72 75 6e 73 20 test if it runs
14a0: 66 6f 72 20 6d 6f 72 65 20 74 68 61 6e 20 31 68 for more than 1h
14b0: 20 32 6d 20 61 6e 64 20 33 73 0a 72 75 6e 74 69 2m and 3s.runti
14c0: 6d 65 6c 69 6d 20 31 68 20 32 6d 20 33 73 0a 2d melim 1h 2m 3s.-
14d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
14e0: 0a 0a 54 65 73 74 73 20 62 72 6f 77 73 65 72 20 ..Tests browser
14f0: 76 69 65 77 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e view.~~~~~~~~~~~
1500: 7e 7e 7e 7e 7e 7e 7e 0a 0a 54 68 65 20 74 65 73 ~~~~~~~..The tes
1510: 74 73 20 62 72 6f 77 73 65 72 20 28 73 65 65 20 ts browser (see
1520: 74 68 65 20 52 75 6e 20 43 6f 6e 74 72 6f 6c 20 the Run Control
1530: 74 61 62 20 6f 6e 20 74 68 65 20 64 61 73 68 62 tab on the dashb
1540: 6f 61 72 64 29 20 68 61 73 20 74 77 6f 20 76 69 oard) has two vi
1550: 65 77 73 20 66 6f 72 20 64 69 73 70 6c 61 79 69 ews for displayi
1560: 6e 67 20 74 68 65 20 74 65 73 74 73 2e 20 0a 0a ng the tests. ..
1570: 2e 20 44 6f 74 20 28 67 72 61 70 68 76 69 7a 29 . Dot (graphviz)
1580: 20 62 61 73 65 64 20 74 72 65 65 0a 2e 20 4e 6f based tree.. No
1590: 20 64 6f 74 2c 20 70 6c 61 69 6e 20 6c 69 73 74 dot, plain list
15a0: 69 6e 67 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 ing..The default
15b0: 20 69 73 20 74 68 65 20 67 72 61 70 68 76 69 7a is the graphviz
15c0: 20 62 61 73 65 64 20 74 72 65 65 20 62 75 74 20 based tree but
15d0: 69 66 20 79 6f 75 72 20 74 65 73 74 73 20 64 6f if your tests do
15e0: 6e 27 74 20 76 69 65 77 0a 77 65 6c 6c 20 69 6e n't view.well in
15f0: 20 74 68 61 74 20 6d 6f 64 65 20 74 68 65 6e 20 that mode then
1600: 75 73 65 20 22 6e 6f 64 6f 74 22 20 74 6f 20 74 use "nodot" to t
1610: 75 72 6e 20 69 74 20 6f 66 66 2e 0a 0a 2d 2d 2d urn it off...---
1620: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
1630: 73 65 74 75 70 5d 0a 6e 6f 64 6f 74 0a 2d 2d 2d setup].nodot.---
1640: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
1650: 43 61 70 74 75 72 69 6e 67 20 54 65 73 74 20 44 Capturing Test D
1660: 61 74 61 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ata.~~~~~~~~~~~~
1670: 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 20 61 20 74 65 ~~~~~~~..In a te
1680: 73 74 20 79 6f 75 20 63 61 6e 20 63 61 70 74 75 st you can captu
1690: 72 65 20 61 72 62 69 74 72 61 72 79 20 76 61 72 re arbitrary var
16a0: 69 61 62 6c 65 73 20 61 6e 64 20 72 6f 6c 6c 20 iables and roll
16b0: 74 68 65 6d 20 75 70 20 69 6e 20 74 68 65 0a 6d them up in the.m
16c0: 65 67 61 74 65 73 74 20 64 61 74 61 62 61 73 65 egatest database
16d0: 20 66 6f 72 20 76 69 65 77 69 6e 67 20 6f 6e 20 for viewing on
16e0: 74 68 65 20 64 61 73 68 62 6f 61 72 64 20 6f 72 the dashboard or
16f0: 20 77 65 62 20 61 70 70 2e 0a 0a 2e 49 6e 20 61 web app....In a
1700: 20 74 65 73 74 20 61 73 20 61 20 73 63 72 69 70 test as a scrip
1710: 74 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d t.--------------
1720: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 24 4d 54 5f 4d ----------.$MT_M
1730: 45 47 41 54 45 53 54 20 2d 6c 6f 61 64 2d 74 65 EGATEST -load-te
1740: 73 74 2d 64 61 74 61 20 3c 3c 20 45 4f 46 0a 66 st-data << EOF.f
1750: 6f 6f 2c 62 61 72 2c 20 20 20 31 2e 32 2c 20 20 oo,bar, 1.2,
1760: 31 2e 39 2c 20 3e 0a 66 6f 6f 2c 72 61 62 2c 20 1.9, >.foo,rab,
1770: 31 2e 30 65 39 2c 20 31 30 65 39 2c 20 31 65 39 1.0e9, 10e9, 1e9
1780: 0a 66 6f 6f 2c 62 6c 61 2c 20 20 20 31 2e 32 2c .foo,bla, 1.2,
1790: 20 20 31 2e 39 2c 20 3c 0a 66 6f 6f 2c 62 61 6c 1.9, <.foo,bal
17a0: 2c 20 20 20 31 2e 32 2c 20 20 31 2e 32 2c 20 3c , 1.2, 1.2, <
17b0: 20 20 20 2c 20 20 20 20 20 2c 43 68 65 63 6b 20 , ,Check
17c0: 66 6f 72 20 6f 76 65 72 6c 6f 61 64 0a 66 6f 6f for overload.foo
17d0: 2c 61 6c 62 2c 20 20 20 31 2e 32 2c 20 20 31 2e ,alb, 1.2, 1.
17e0: 32 2c 20 3c 3d 20 20 2c 20 41 6d 70 73 2c 54 68 2, <= , Amps,Th
17f0: 69 73 20 69 73 20 74 68 65 20 68 69 67 68 20 70 is is the high p
1800: 6f 77 65 72 20 63 69 72 63 75 69 74 20 74 65 73 ower circuit tes
1810: 74 0a 66 6f 6f 2c 61 62 6c 2c 20 20 20 31 2e 32 t.foo,abl, 1.2
1820: 2c 20 20 31 2e 33 2c 20 30 2e 31 0a 66 6f 6f 2c , 1.3, 0.1.foo,
1830: 62 72 61 2c 20 20 20 31 2e 32 2c 20 70 61 73 73 bra, 1.2, pass
1840: 2c 20 73 69 6c 6c 79 20 73 74 75 66 66 0a 66 61 , silly stuff.fa
1850: 7a 2c 62 61 72 2c 20 20 20 20 31 30 2c 20 20 38 z,bar, 10, 8
1860: 6d 41 2c 20 20 20 20 20 2c 20 20 20 20 20 2c 22 mA, , ,"
1870: 74 68 69 73 20 69 73 20 61 20 63 6f 6d 6d 65 6e this is a commen
1880: 74 22 0a 45 4f 46 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d t".EOF.---------
1890: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
18a0: 0a 41 6c 74 65 72 6e 61 74 69 76 65 6c 79 20 79 .Alternatively y
18b0: 6f 75 20 63 61 6e 20 75 73 65 20 6c 6f 67 70 72 ou can use logpr
18c0: 6f 20 74 72 69 67 67 65 72 73 20 74 6f 20 63 61 o triggers to ca
18d0: 70 74 75 72 65 20 76 61 6c 75 65 73 20 61 6e 64 pture values and
18e0: 20 69 6e 6a 65 63 74 20 74 68 65 6d 0a 69 6e 74 inject them.int
18f0: 6f 20 6d 65 67 61 74 65 73 74 20 75 73 69 6e 67 o megatest using
1900: 20 74 68 65 20 2d 73 65 74 2d 76 61 6c 75 65 73 the -set-values
1910: 20 6d 65 63 68 61 6e 69 73 6d 3a 0a 0a 2e 4d 65 mechanism:...Me
1920: 67 61 74 65 73 74 20 68 65 6c 70 20 72 65 6c 61 gatest help rela
1930: 74 65 64 20 74 6f 20 2d 73 65 74 2d 76 61 6c 75 ted to -set-valu
1940: 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d es.-------------
1950: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 54 65 73 74 -----------.Test
1960: 20 64 61 74 61 20 63 61 70 74 75 72 65 0a 20 20 data capture.
1970: 2d 73 65 74 2d 76 61 6c 75 65 73 20 20 20 20 20 -set-values
1980: 20 20 20 20 20 20 20 20 3a 20 75 70 64 61 74 65 : update
1990: 20 6f 72 20 73 65 74 20 76 61 6c 75 65 73 20 69 or set values i
19a0: 6e 20 74 68 65 20 74 65 73 74 64 61 74 61 20 74 n the testdata t
19b0: 61 62 6c 65 0a 20 20 3a 63 61 74 65 67 6f 72 79 able. :category
19c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3a :
19d0: 20 73 65 74 20 74 68 65 20 63 61 74 65 67 6f 72 set the categor
19e0: 79 20 66 69 65 6c 64 20 28 6f 70 74 69 6f 6e 61 y field (optiona
19f0: 6c 29 0a 20 20 3a 76 61 72 69 61 62 6c 65 20 20 l). :variable
1a00: 20 20 20 20 20 20 20 20 20 20 20 20 20 3a 20 73 : s
1a10: 65 74 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 et the variable
1a20: 6e 61 6d 65 20 28 6f 70 74 69 6f 6e 61 6c 29 0a name (optional).
1a30: 20 20 3a 76 61 6c 75 65 20 20 20 20 20 20 20 20 :value
1a40: 20 20 20 20 20 20 20 20 20 20 3a 20 76 61 6c 75 : valu
1a50: 65 20 6d 65 61 73 75 72 65 64 20 28 72 65 71 75 e measured (requ
1a60: 69 72 65 64 29 0a 20 20 3a 65 78 70 65 63 74 65 ired). :expecte
1a70: 64 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 d
1a80: 3a 20 76 61 6c 75 65 20 65 78 70 65 63 74 65 64 : value expected
1a90: 20 28 72 65 71 75 69 72 65 64 29 0a 20 20 3a 74 (required). :t
1aa0: 6f 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ol
1ab0: 20 20 20 20 20 20 3a 20 7c 76 61 6c 75 65 2d 65 : |value-e
1ac0: 78 70 65 63 74 7c 20 3c 3d 20 74 6f 6c 20 28 72 xpect| <= tol (r
1ad0: 65 71 75 69 72 65 64 2c 20 63 61 6e 20 62 65 20 equired, can be
1ae0: 3c 2c 20 3e 2c 20 3e 3d 2c 20 3c 3d 20 6f 72 20 <, >, >=, <= or
1af0: 6e 75 6d 62 65 72 29 0a 20 20 3a 75 6e 69 74 73 number). :units
1b00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b10: 20 20 3a 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 : name of the
1b20: 75 6e 69 74 73 20 66 6f 72 20 76 61 6c 75 65 2c units for value,
1b30: 20 65 78 70 65 63 74 65 64 5f 76 61 6c 75 65 20 expected_value
1b40: 65 74 63 2e 20 28 6f 70 74 69 6f 6e 61 6c 29 0a etc. (optional).
1b50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1b60: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 61 73 68 62 6f --------..Dashbo
1b70: 61 72 64 20 73 65 74 74 69 6e 67 73 0a 7e 7e 7e ard settings.~~~
1b80: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a ~~~~~~~~~~~~~~~.
1b90: 0a 2e 52 75 6e 73 20 74 61 62 20 62 75 74 74 6f ..Runs tab butto
1ba0: 6e 73 2c 20 66 6f 6e 74 20 61 6e 64 20 73 69 7a ns, font and siz
1bb0: 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d e.--------------
1bc0: 2d 2d 2d 2d 0a 5b 64 61 73 68 62 6f 61 72 64 5d ----.[dashboard]
1bd0: 0a 62 74 6e 2d 68 65 69 67 68 74 20 78 31 34 0a .btn-height x14.
1be0: 62 74 6e 2d 66 6f 6e 74 73 7a 20 31 30 0a 63 65 btn-fontsz 10.ce
1bf0: 6c 6c 2d 77 69 64 74 68 20 36 30 0a 2d 2d 2d 2d ll-width 60.----
1c00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
1c10: 44 61 74 61 62 61 73 65 20 73 65 74 74 69 6e 67 Database setting
1c20: 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e s.~~~~~~~~~~~~~~
1c30: 7e 7e 7e 0a 0a 2e 44 61 74 61 62 61 73 65 20 63 ~~~...Database c
1c40: 6f 6e 66 69 67 20 73 65 74 74 69 6e 67 73 20 69 onfig settings i
1c50: 6e 20 5b 73 65 74 75 70 5d 20 73 65 63 74 69 6f n [setup] sectio
1c60: 6e 20 6f 66 20 6d 65 67 61 74 65 73 74 2e 63 6f n of megatest.co
1c70: 6e 66 69 67 0a 5b 77 69 64 74 68 3d 22 37 30 25 nfig.[width="70%
1c80: 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d 2c 32 6d 2c ",cols="^,2m,2m,
1c90: 32 6d 22 2c 66 72 61 6d 65 3d 22 74 6f 70 62 6f 2m",frame="topbo
1ca0: 74 22 2c 6f 70 74 69 6f 6e 73 3d 22 68 65 61 64 t",options="head
1cb0: 65 72 22 5d 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d er"].|==========
1cc0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 56 61 ============.|Va
1cd0: 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r
1ce0: 20 20 20 20 20 20 20 20 7c 20 50 75 72 70 6f 73 | Purpos
1cf0: 65 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 56 e | V
1d00: 61 6c 69 64 20 76 61 6c 75 65 73 20 20 20 20 20 alid values
1d10: 20 20 20 20 20 20 20 7c 20 43 6f 6d 6d 65 6e 74 | Comment
1d20: 73 0a 7c 64 65 6c 61 79 2d 6f 6e 2d 62 75 73 79 s.|delay-on-busy
1d30: 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 50 | P
1d40: 72 65 76 65 6e 74 20 63 6f 6e 63 75 72 72 65 6e revent concurren
1d50: 74 20 61 63 63 65 73 73 20 69 73 73 75 65 73 20 t access issues
1d60: 7c 20 79 65 73 5c 7c 6e 6f 20 6f 72 20 6e 6f 74 | yes\|no or not
1d70: 20 64 65 66 69 6e 65 64 20 7c 20 44 65 66 61 75 defined | Defau
1d80: 6c 74 3d 6e 6f 2c 20 6d 61 79 20 68 65 6c 70 20 lt=no, may help
1d90: 6f 6e 20 73 6f 6d 65 20 6e 65 74 77 6f 72 6b 20 on some network
1da0: 66 69 6c 65 20 73 79 73 74 65 6d 73 2c 20 6d 61 file systems, ma
1db0: 79 20 73 6c 6f 77 20 74 68 69 6e 67 73 20 64 6f y slow things do
1dc0: 77 6e 20 61 6c 73 6f 2e 0a 7c 66 61 73 74 73 74 wn also..|fastst
1dd0: 61 72 74 09 09 20 20 20 7c 20 41 6c 6c 20 64 69 art.. | All di
1de0: 72 65 63 74 20 66 69 6c 65 20 61 63 63 65 73 73 rect file access
1df0: 20 74 6f 20 73 71 6c 69 74 65 20 64 62 20 66 69 to sqlite db fi
1e00: 6c 65 73 20 7c 20 79 65 73 5c 7c 6e 6f 20 6f 72 les | yes\|no or
1e10: 20 6e 6f 74 20 64 65 66 69 6e 65 64 20 7c 20 44 not defined | D
1e20: 65 66 61 75 6c 74 3d 79 65 73 2c 20 73 75 67 67 efault=yes, sugg
1e30: 65 73 74 20 6e 6f 20 66 6f 72 20 63 65 6e 74 72 est no for centr
1e40: 61 6c 20 61 75 74 6f 6d 61 74 65 64 20 73 79 73 al automated sys
1e50: 74 65 6d 73 20 61 6e 64 20 79 65 73 20 66 6f 72 tems and yes for
1e60: 20 69 6e 74 65 72 61 63 74 69 76 65 20 75 73 65 interactive use
1e70: 0a 7c 68 6f 6d 65 68 6f 73 74 20 09 09 20 20 20 .|homehost ..
1e80: 7c 20 53 74 61 72 74 20 73 65 72 76 65 72 73 20 | Start servers
1e90: 6f 6e 20 74 68 69 73 20 68 6f 73 74 20 7c 20 3c on this host | <
1ea0: 68 6f 73 74 6e 61 6d 65 3e 20 7c 20 44 65 66 61 hostname> | Defa
1eb0: 75 6c 74 73 20 74 6f 20 6c 6f 63 61 6c 20 68 6f ults to local ho
1ec0: 73 74 0a 7c 68 6f 73 74 6e 61 6d 65 09 09 20 20 st.|hostname..
1ed0: 20 7c 20 48 6f 73 74 6e 61 6d 65 20 74 6f 20 62 | Hostname to b
1ee0: 69 6e 64 20 74 6f 20 7c 20 3c 68 6f 73 74 6e 61 ind to | <hostna
1ef0: 6d 65 3e 5c 7c 2d 09 20 20 7c 20 4f 6e 20 6d 75 me>\|-. | On mu
1f00: 6c 74 69 2d 68 6f 6d 65 64 20 68 6f 73 74 73 20 lti-homed hosts
1f10: 61 6c 6c 6f 77 73 20 62 69 6e 64 69 6e 67 20 74 allows binding t
1f20: 6f 20 73 70 65 63 69 66 69 63 20 68 6f 73 74 6e o specific hostn
1f30: 61 6d 65 0a 7c 6c 6f 77 70 6f 72 74 09 09 20 20 ame.|lowport..
1f40: 20 7c 20 53 74 61 72 74 20 73 65 61 72 63 68 69 | Start searchi
1f50: 6e 67 20 66 6f 72 20 61 20 70 6f 72 74 20 61 74 ng for a port at
1f60: 20 74 68 69 73 20 70 6f 72 74 6e 75 6d 7c 20 33 this portnum| 3
1f70: 32 37 36 38 20 7c 20 0a 7c 72 65 71 75 69 72 65 2768 | .|require
1f80: 64 09 09 20 20 20 7c 20 53 65 72 76 65 72 20 72 d.. | Server r
1f90: 65 71 75 69 72 65 64 20 20 20 20 7c 20 79 65 73 equired | yes
1fa0: 5c 7c 6e 6f 20 6f 72 20 6e 6f 74 20 64 65 66 69 \|no or not defi
1fb0: 6e 65 64 20 20 7c 20 44 65 66 61 75 6c 74 3d 6e ned | Default=n
1fc0: 6f 2c 20 66 6f 72 63 65 20 73 74 61 72 74 20 6f o, force start o
1fd0: 66 20 73 65 72 76 65 72 20 61 6c 77 61 79 73 0a f server always.
1fe0: 7c 73 65 72 76 65 72 2d 71 75 65 72 79 2d 74 68 |server-query-th
1ff0: 72 65 73 68 6f 6c 64 09 20 20 20 7c 20 53 74 61 reshold. | Sta
2000: 72 74 20 73 65 72 76 65 72 20 77 68 65 6e 20 71 rt server when q
2010: 75 65 72 69 65 73 20 74 61 6b 65 20 6c 6f 6e 67 ueries take long
2020: 65 72 20 74 68 61 6e 20 74 68 69 73 20 7c 20 6e er than this | n
2030: 75 6d 62 65 72 20 69 6e 20 6d 69 6c 6c 69 73 65 umber in millise
2040: 63 6f 6e 64 73 20 7c 20 44 65 66 61 75 6c 74 3d conds | Default=
2050: 33 30 30 0a 7c 74 69 6d 65 6f 75 74 09 09 20 20 300.|timeout..
2060: 20 7c 20 68 74 74 70 20 61 70 69 20 74 69 6d 65 | http api time
2070: 6f 75 74 20 09 7c 20 6e 75 6d 62 65 72 20 69 6e out .| number in
2080: 20 68 6f 75 72 73 09 20 20 7c 20 44 65 66 61 75 hours. | Defau
2090: 6c 74 20 69 73 20 31 20 6d 69 6e 75 74 65 2c 20 lt is 1 minute,
20a0: 64 6f 20 6e 6f 74 20 63 68 61 6e 67 65 0a 7c 3d do not change.|=
20b0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
20c0: 3d 3d 3d 3d 3d 0a 0a 54 68 65 20 74 65 73 74 63 =====..The testc
20d0: 6f 6e 66 69 67 20 46 69 6c 65 0a 2d 2d 2d 2d 2d onfig File.-----
20e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
20f0: 53 65 74 75 70 20 73 65 63 74 69 6f 6e 0a 7e 7e Setup section.~~
2100: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 48 65 61 ~~~~~~~~~~~..Hea
2110: 64 65 72 0a 5e 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d der.^^^^^^..----
2120: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
2130: 5b 73 65 74 75 70 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d [setup].--------
2140: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 -----------..The
2150: 20 72 75 6e 73 63 72 69 70 74 20 6d 65 74 68 6f runscript metho
2160: 64 20 69 73 20 61 20 62 72 75 74 65 20 66 6f 72 d is a brute for
2170: 63 65 20 77 61 79 20 74 6f 20 72 75 6e 20 73 63 ce way to run sc
2180: 72 69 70 74 73 20 77 68 65 72 65 20 74 68 65 0a ripts where the.
2190: 75 73 65 72 20 69 73 20 72 65 73 70 6f 6e 73 69 user is responsi
21a0: 62 6c 65 20 66 6f 72 20 73 65 74 74 69 6e 67 20 ble for setting
21b0: 53 54 41 54 45 20 61 6e 64 20 53 54 41 54 55 53 STATE and STATUS
21c0: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
21d0: 2d 2d 2d 2d 2d 0a 72 75 6e 73 63 72 69 70 74 20 -----.runscript
21e0: 6d 61 69 6e 2e 63 73 68 0a 2d 2d 2d 2d 2d 2d 2d main.csh.-------
21f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 65 ------------..Re
2200: 71 75 69 72 65 6d 65 6e 74 73 20 73 65 63 74 69 quirements secti
2210: 6f 6e 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e on.~~~~~~~~~~~~~
2220: 7e 7e 7e 7e 7e 7e 7e 0a 0a 2e 48 65 61 64 65 72 ~~~~~~~...Header
2230: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
2240: 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e ----.[requiremen
2250: 74 73 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ts].------------
2260: 2d 2d 2d 2d 2d 2d 2d 0a 0a 57 61 69 74 20 6f 6e -------..Wait on
2270: 20 4f 74 68 65 72 20 54 65 73 74 73 0a 5e 5e 5e Other Tests.^^^
2280: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
2290: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
22a0: 2d 2d 2d 2d 2d 0a 23 20 41 20 6e 6f 72 6d 61 6c -----.# A normal
22b0: 20 77 61 69 74 6f 6e 20 77 61 69 74 73 20 66 6f waiton waits fo
22c0: 72 20 74 68 65 20 70 72 69 6f 72 20 74 65 73 74 r the prior test
22d0: 73 20 74 6f 20 62 65 20 43 4f 4d 50 4c 45 54 45 s to be COMPLETE
22e0: 44 20 0a 23 20 61 6e 64 20 50 41 53 53 2c 20 43 D .# and PASS, C
22f0: 48 45 43 4b 20 6f 72 20 57 41 49 56 45 44 0a 77 HECK or WAIVED.w
2300: 61 69 74 6f 6e 20 74 65 73 74 31 20 74 65 73 74 aiton test1 test
2310: 32 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2.--------------
2320: 2d 2d 2d 2d 2d 0a 0a 4d 6f 64 65 0a 5e 5e 5e 5e -----..Mode.^^^^
2330: 0a 0a 54 68 65 20 64 65 66 61 75 6c 74 20 28 69 ..The default (i
2340: 2e 65 2e 20 69 66 20 6d 6f 64 65 20 69 73 20 6e .e. if mode is n
2350: 6f 74 20 73 70 65 63 69 66 69 65 64 29 20 69 73 ot specified) is
2360: 20 6e 6f 72 6d 61 6c 2e 20 41 6c 6c 20 70 72 65 normal. All pre
2370: 2d 64 65 70 65 6e 64 65 6e 74 20 74 65 73 74 73 -dependent tests
2380: 0a 6d 75 73 74 20 62 65 20 43 4f 4d 50 4c 45 54 .must be COMPLET
2390: 45 44 20 61 6e 64 20 50 41 53 53 2c 20 43 48 45 ED and PASS, CHE
23a0: 43 4b 20 6f 72 20 57 41 49 56 45 44 20 62 65 66 CK or WAIVED bef
23b0: 6f 72 65 20 74 68 65 20 74 65 73 74 20 77 69 6c ore the test wil
23c0: 6c 20 73 74 61 72 74 0a 0a 2d 2d 2d 2d 2d 2d 2d l start..-------
23d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 ------------.[re
23e0: 71 75 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 quirements].mode
23f0: 20 20 20 6e 6f 72 6d 61 6c 0a 2d 2d 2d 2d 2d 2d normal.------
2400: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 -------------..T
2410: 68 65 20 74 6f 70 6c 65 76 65 6c 20 6d 6f 64 65 he toplevel mode
2420: 20 72 65 71 75 69 72 65 73 20 6f 6e 6c 79 20 74 requires only t
2430: 68 61 74 20 74 68 65 20 70 72 69 6f 72 20 74 65 hat the prior te
2440: 73 74 73 20 61 72 65 20 43 4f 4d 50 4c 45 54 45 sts are COMPLETE
2450: 44 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d D...------------
2460: 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 -------.[require
2470: 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 74 6f 70 6c ments].mode topl
2480: 65 76 65 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d evel.-----------
2490: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 20 69 74 65 6d --------..A item
24a0: 20 62 61 73 65 64 20 77 61 69 74 6f 6e 20 77 69 based waiton wi
24b0: 6c 6c 20 73 74 61 72 74 20 69 74 65 6d 73 20 69 ll start items i
24c0: 6e 20 61 20 74 65 73 74 20 77 68 65 6e 20 74 68 n a test when th
24d0: 65 20 73 61 6d 65 2d 6e 61 6d 65 64 0a 69 74 65 e same-named.ite
24e0: 6d 20 69 73 20 43 4f 4d 50 4c 45 54 45 44 20 61 m is COMPLETED a
24f0: 6e 64 20 50 41 53 53 2c 20 43 48 45 43 4b 20 6f nd PASS, CHECK o
2500: 72 20 57 41 49 56 45 44 20 69 6e 20 74 68 65 20 r WAIVED in the
2510: 70 72 69 6f 72 20 74 65 73 74 2e 20 54 68 69 73 prior test. This
2520: 0a 77 61 73 20 68 69 73 74 6f 72 69 63 61 6c 6c .was historicall
2530: 79 20 63 61 6c 6c 65 64 20 22 69 74 65 6d 77 61 y called "itemwa
2540: 69 74 22 20 6d 6f 64 65 2e 20 54 68 65 20 74 65 it" mode. The te
2550: 72 6d 73 20 22 69 74 65 6d 77 61 69 74 22 20 61 rms "itemwait" a
2560: 6e 64 0a 22 69 74 65 6d 6d 61 74 63 68 22 20 61 nd."itemmatch" a
2570: 72 65 20 73 79 6e 6f 6e 79 6d 73 2e 0a 0a 2d 2d re synonyms...--
2580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2590: 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d -.[requirements]
25a0: 0a 6d 6f 64 65 20 69 74 65 6d 6d 61 74 63 68 0a .mode itemmatch.
25b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
25c0: 2d 2d 2d 0a 0a 4f 76 65 72 72 69 64 69 6e 67 20 ---..Overriding
25d0: 45 6e 76 69 72 6f 6d 65 6e 74 20 56 61 72 69 61 Enviroment Varia
25e0: 62 6c 65 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e bles.~~~~~~~~~~~
25f0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
2600: 7e 7e 7e 7e 0a 0a 4f 76 65 72 72 69 64 65 20 76 ~~~~..Override v
2610: 61 72 69 61 62 6c 65 73 20 62 65 66 6f 72 65 20 ariables before
2620: 73 74 61 72 74 69 6e 67 20 74 68 65 20 74 65 73 starting the tes
2630: 74 2e 20 43 61 6e 20 69 6e 63 6c 75 64 65 20 66 t. Can include f
2640: 69 6c 65 73 20 28 70 65 72 68 61 70 73 20 67 65 iles (perhaps ge
2650: 6e 65 72 61 74 65 64 20 62 79 20 6d 65 67 61 74 nerated by megat
2660: 65 73 74 20 2d 65 6e 76 64 65 6c 74 61 20 6f 72 est -envdelta or
2670: 20 73 69 6d 69 6c 61 72 29 2e 0a 0a 2d 2d 2d 2d similar)...----
2680: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2690: 0a 5b 70 72 65 2d 6c 61 75 6e 63 68 2d 65 6e 76 .[pre-launch-env
26a0: 2d 76 61 72 73 5d 0a 56 41 52 31 20 76 61 6c 75 -vars].VAR1 valu
26b0: 65 31 0a 0a 23 20 47 65 74 20 73 6f 6d 65 20 67 e1..# Get some g
26c0: 65 6e 65 72 61 74 65 64 20 73 65 74 74 69 6e 67 enerated setting
26d0: 73 0a 5b 69 6e 63 6c 75 64 65 20 2e 2e 2f 67 65 s.[include ../ge
26e0: 6e 65 72 61 74 65 64 2d 76 61 72 73 2e 63 6f 6e nerated-vars.con
26f0: 66 69 67 5d 0a 0a 23 20 55 73 65 20 74 68 69 73 fig]..# Use this
2700: 20 74 72 69 63 6b 20 74 6f 20 75 6e 73 65 74 20 trick to unset
2710: 76 61 72 69 61 62 6c 65 73 0a 23 7b 73 63 68 65 variables.#{sche
2720: 6d 65 20 28 75 6e 73 65 74 65 6e 76 20 22 46 4f me (unsetenv "FO
2730: 4f 42 41 52 22 29 7d 0a 2d 2d 2d 2d 2d 2d 2d 2d OBAR")}.--------
2740: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 74 ------------..It
2750: 65 6d 6d 61 70 20 48 61 6e 64 6c 69 6e 67 0a 7e emmap Handling.~
2760: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a ~~~~~~~~~~~~~~~.
2770: 0a 46 6f 72 20 63 61 73 65 73 20 77 65 72 65 20 .For cases were
2780: 74 68 65 20 64 65 70 65 6e 64 65 6e 74 20 74 65 the dependent te
2790: 73 74 20 68 61 73 20 61 20 73 69 6d 69 6c 61 72 st has a similar
27a0: 20 62 75 74 20 6e 6f 74 20 69 64 65 6e 74 69 63 but not identic
27b0: 61 6c 0a 69 74 65 6d 70 61 74 68 20 74 6f 20 74 al.itempath to t
27c0: 68 65 20 64 6f 77 6e 73 74 72 65 61 6d 20 74 65 he downstream te
27d0: 73 74 20 61 6e 20 69 74 65 6d 6d 61 70 20 63 61 st an itemmap ca
27e0: 6e 20 61 6c 6c 6f 77 20 66 6f 72 20 69 74 65 6d n allow for item
27f0: 6d 61 74 63 68 0a 6d 6f 64 65 0a 0a 2e 65 78 61 match.mode...exa
2800: 6d 70 6c 65 20 66 6f 72 20 72 65 6d 6f 76 69 6e mple for removin
2810: 67 20 70 61 72 74 20 6f 66 20 69 74 65 6d 6d 61 g part of itemma
2820: 70 20 66 6f 72 20 77 61 69 74 6f 6e 20 74 65 73 p for waiton tes
2830: 74 20 28 65 67 3a 20 69 74 65 6d 20 2b 66 6f 6f t (eg: item +foo
2840: 2d 78 2f 62 61 72 2b 20 64 65 70 65 6e 64 73 20 -x/bar+ depends
2850: 6f 6e 20 77 61 69 74 6f 6e 27 73 20 69 74 65 6d on waiton's item
2860: 20 2b 79 2f 62 61 72 2b 29 0a 2d 2d 2d 2d 2d 2d +y/bar+).------
2870: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 -------------.[r
2880: 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 equirements].mod
2890: 65 20 69 74 65 6d 77 61 69 74 0a 23 20 69 74 65 e itemwait.# ite
28a0: 6d 6d 61 70 20 3c 69 74 65 6d 20 70 61 74 74 65 mmap <item patte
28b0: 72 6e 20 66 6f 72 20 74 68 69 73 20 74 65 73 74 rn for this test
28c0: 3e 20 20 3c 69 74 65 6d 20 72 65 70 6c 61 63 65 > <item replace
28d0: 6d 65 6e 74 20 70 61 74 74 65 72 6e 20 66 6f 72 ment pattern for
28e0: 20 77 61 69 74 6f 6e 20 74 65 73 74 3e 0a 69 74 waiton test>.it
28f0: 65 6d 6d 61 70 20 2e 2a 78 2f 20 79 2f 0a 0a 2d emmap .*x/ y/..-
2900: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2910: 2d 2d 0a 0a 2e 65 78 61 6d 70 6c 65 20 66 6f 72 --...example for
2920: 20 72 65 6d 6f 76 69 6e 67 20 70 61 72 74 20 6f removing part o
2930: 66 20 69 74 65 6d 6d 61 70 20 66 6f 72 20 77 61 f itemmap for wa
2940: 69 74 6f 6e 20 74 65 73 74 20 28 65 67 3a 20 69 iton test (eg: i
2950: 74 65 6d 20 2b 66 6f 6f 2f 62 61 72 2f 62 61 7a tem +foo/bar/baz
2960: 2b 20 69 6e 20 74 68 69 73 20 74 65 73 74 20 64 + in this test d
2970: 65 70 65 6e 64 73 20 6f 6e 20 77 61 69 74 6f 6e epends on waiton
2980: 27 73 20 69 74 65 6d 20 2b 62 61 7a 2b 29 0a 2d 's item +baz+).-
2990: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
29a0: 2d 2d 0a 0a 23 20 23 23 20 70 61 74 74 65 72 6e --..# ## pattern
29b0: 20 72 65 70 6c 61 63 65 6d 65 6e 74 20 6e 6f 74 replacement not
29c0: 65 73 0a 23 0a 23 20 23 23 20 45 78 61 6d 70 6c es.#.# ## Exampl
29d0: 65 0a 23 20 23 23 20 52 65 6d 6f 76 65 20 65 76 e.# ## Remove ev
29e0: 65 72 79 74 68 69 6e 67 20 75 70 20 74 6f 20 74 erything up to t
29f0: 68 65 20 6c 61 73 74 20 2f 0a 5b 72 65 71 75 69 he last /.[requi
2a00: 72 65 6d 65 6e 74 73 5d 0a 6d 6f 64 65 20 69 74 rements].mode it
2a10: 65 6d 77 61 69 74 0a 23 20 69 74 65 6d 6d 61 70 emwait.# itemmap
2a20: 20 3c 69 74 65 6d 20 70 61 74 74 65 72 6e 20 66 <item pattern f
2a30: 6f 72 20 74 68 69 73 20 74 65 73 74 3e 20 3c 6e or this test> <n
2a40: 6f 74 68 69 6e 67 20 68 65 72 65 20 69 6e 64 69 othing here indi
2a50: 63 61 74 65 73 20 72 65 6d 6f 76 61 6c 3e 0a 69 cates removal>.i
2a60: 74 65 6d 6d 61 70 20 2e 2a 2f 0a 2d 2d 2d 2d 2d temmap .*/.-----
2a70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
2a80: 2e 65 78 61 6d 70 6c 65 20 72 65 70 6c 61 63 69 .example replaci
2a90: 6e 67 20 70 61 72 74 20 6f 66 20 69 74 65 6d 6d ng part of itemm
2aa0: 61 70 20 66 6f 72 20 28 65 67 3a 20 69 74 65 6d ap for (eg: item
2ab0: 20 2b 66 6f 6f 2f 31 32 33 34 2b 20 77 69 6c 6c +foo/1234+ will
2ac0: 20 69 6d 70 6c 79 20 77 61 69 74 6f 6e 27 73 20 imply waiton's
2ad0: 69 74 65 6d 20 2b 62 61 72 2f 31 32 33 34 2b 29 item +bar/1234+)
2ae0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
2af0: 2d 2d 2d 2d 0a 0a 23 0a 23 20 23 23 20 45 78 61 ----..#.# ## Exa
2b00: 6d 70 6c 65 0a 23 20 23 23 20 52 65 70 6c 61 63 mple.# ## Replac
2b10: 65 20 66 6f 6f 2f 20 77 69 74 68 20 62 61 72 2f e foo/ with bar/
2b20: 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a .[requirements].
2b30: 6d 6f 64 65 20 69 74 65 6d 77 61 69 74 0a 23 20 mode itemwait.#
2b40: 69 74 65 6d 6d 61 70 20 3c 69 74 65 6d 20 70 61 itemmap <item pa
2b50: 74 74 65 72 6e 20 66 6f 72 20 74 68 69 73 20 74 ttern for this t
2b60: 65 73 74 3e 20 20 3c 69 74 65 6d 20 72 65 70 6c est> <item repl
2b70: 61 63 65 6d 65 6e 74 20 70 61 74 74 65 72 6e 20 acement pattern
2b80: 66 6f 72 20 77 61 69 74 6f 6e 20 74 65 73 74 3e for waiton test>
2b90: 0a 69 74 65 6d 6d 61 70 20 66 6f 6f 2f 20 62 61 .itemmap foo/ ba
2ba0: 72 2f 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d r/..------------
2bb0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 65 78 61 6d 70 6c -------...exampl
2bc0: 65 20 66 6f 72 20 62 61 63 6b 72 65 66 65 72 65 e for backrefere
2bd0: 6e 63 65 20 28 65 67 3a 20 69 74 65 6d 20 2b 66 nce (eg: item +f
2be0: 6f 6f 32 33 2f 74 68 75 64 2b 20 77 69 6c 6c 20 oo23/thud+ will
2bf0: 69 6d 70 6c 79 20 77 61 69 74 6f 6e 27 73 20 69 imply waiton's i
2c00: 74 65 6d 20 2b 6e 75 6d 2d 32 33 2f 62 61 72 2f tem +num-23/bar/
2c10: 74 68 75 64 2b 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d thud+.----------
2c20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 0a 23 20 23 23 ---------.#.# ##
2c30: 20 45 78 61 6d 70 6c 65 0a 23 20 23 23 20 63 61 Example.# ## ca
2c40: 6e 20 75 73 65 20 5c 7b 6e 75 6d 62 65 72 7d 20 n use \{number}
2c50: 69 6e 20 72 65 70 6c 61 63 65 6d 65 6e 74 20 70 in replacement p
2c60: 61 74 74 65 72 6e 20 74 6f 20 62 61 63 6b 72 65 attern to backre
2c70: 66 65 72 65 6e 63 65 20 61 20 28 63 61 70 74 75 ference a (captu
2c80: 72 65 29 20 66 72 6f 6d 20 6d 61 74 63 68 69 6e re) from matchin
2c90: 67 20 70 61 74 74 65 72 6e 20 73 69 6d 69 6c 61 g pattern simila
2ca0: 72 20 74 6f 20 73 65 64 20 6f 72 20 70 65 72 6c r to sed or perl
2cb0: 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a .[requirements].
2cc0: 6d 6f 64 65 20 69 74 65 6d 77 61 69 74 0a 23 20 mode itemwait.#
2cd0: 69 74 65 6d 6d 61 70 20 3c 69 74 65 6d 20 70 61 itemmap <item pa
2ce0: 74 74 65 72 6e 20 66 6f 72 20 74 68 69 73 20 74 ttern for this t
2cf0: 65 73 74 3e 20 20 3c 69 74 65 6d 20 72 65 70 6c est> <item repl
2d00: 61 63 65 6d 65 6e 74 20 70 61 74 74 65 72 6e 20 acement pattern
2d10: 66 6f 72 20 77 61 69 74 6f 6e 20 74 65 73 74 3e for waiton test>
2d20: 0a 69 74 65 6d 6d 61 70 20 66 6f 6f 28 5c 64 2b .itemmap foo(\d+
2d30: 29 2f 20 6e 75 6d 2d 5c 31 2f 62 61 72 2f 0a 0a )/ num-\1/bar/..
2d40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2d50: 2d 2d 2d 0a 0a 2e 65 78 61 6d 70 6c 65 20 6d 75 ---...example mu
2d60: 6c 74 69 70 6c 65 20 69 74 65 6d 6d 61 70 73 0a ltiple itemmaps.
2d70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2d80: 2d 2d 2d 0a 0a 23 20 6d 75 6c 74 69 2d 6c 69 6e ---..# multi-lin
2d90: 65 3b 20 6d 61 74 63 68 65 73 20 61 72 65 20 61 e; matches are a
2da0: 70 70 6c 69 65 64 20 69 6e 20 74 68 65 20 6c 69 pplied in the li
2db0: 73 74 65 64 20 6f 72 64 65 72 0a 23 20 54 68 65 sted order.# The
2dc0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 77 6f 75 6c 64 following would
2dd0: 20 6d 61 70 3a 0a 23 20 20 20 61 31 32 33 62 33 map:.# a123b3
2de0: 32 31 20 74 6f 20 62 33 32 31 66 6f 6f 61 31 32 21 to b321fooa12
2df0: 33 20 74 68 65 6e 20 74 6f 20 33 32 31 66 6f 6f 3 then to 321foo
2e00: 61 31 32 33 70 0a 23 0a 5b 72 65 71 75 69 72 65 a123p.#.[require
2e10: 6d 65 6e 74 73 5d 0a 69 74 65 6d 6d 61 70 20 28 ments].itemmap (
2e20: 61 5c 64 2b 29 28 62 5c 64 2b 29 20 5c 32 66 6f a\d+)(b\d+) \2fo
2e30: 6f 5c 31 0a 20 20 62 28 2e 2a 29 20 5c 31 70 0a o\1. b(.*) \1p.
2e40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2e50: 2d 2d 2d 0a 0a 0a 43 6f 6d 70 6c 65 78 20 6d 61 ---...Complex ma
2e60: 70 70 69 6e 67 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e pping.^^^^^^^^^^
2e70: 5e 5e 5e 5e 5e 0a 43 6f 6d 70 6c 65 78 20 6d 61 ^^^^^.Complex ma
2e80: 70 70 69 6e 67 73 20 63 61 6e 20 62 65 20 68 61 ppings can be ha
2e90: 6e 64 6c 65 64 20 77 69 74 68 20 61 20 73 65 70 ndled with a sep
2ea0: 61 72 61 74 65 20 5b 69 74 65 6d 6d 61 70 5d 20 arate [itemmap]
2eb0: 73 65 63 74 69 6f 6e 20 28 69 6e 73 74 65 61 64 section (instead
2ec0: 20 69 66 20 61 6e 20 69 74 65 6d 6d 61 70 20 6c if an itemmap l
2ed0: 69 6e 65 20 69 6e 20 74 68 65 20 5b 72 65 71 75 ine in the [requ
2ee0: 69 72 65 6d 65 6e 74 73 5d 20 73 65 63 74 69 6f irements] sectio
2ef0: 6e 29 0a 0a 45 61 63 68 20 6c 69 6e 65 20 69 6e n)..Each line in
2f00: 20 61 6e 20 69 74 65 6d 6d 61 70 20 73 65 63 74 an itemmap sect
2f10: 69 6f 6e 20 73 74 61 72 74 73 20 77 69 74 68 20 ion starts with
2f20: 61 20 77 61 69 74 6f 6e 20 74 65 73 74 20 6e 61 a waiton test na
2f30: 6d 65 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 me followed by a
2f40: 6e 20 69 74 65 6d 6d 61 70 20 65 78 70 72 65 73 n itemmap expres
2f50: 73 69 6f 6e 0a 0a 2e 65 67 3a 20 54 68 65 20 66 sion...eg: The f
2f60: 6f 6c 6c 6f 77 69 6e 67 20 63 61 75 73 65 73 20 ollowing causes
2f70: 77 61 69 74 6f 6e 20 74 65 73 74 20 41 20 69 74 waiton test A it
2f80: 65 6d 20 2b 62 61 72 2f 31 32 33 34 2b 20 74 6f em +bar/1234+ to
2f90: 20 72 75 6e 20 77 68 65 6e 20 6f 75 72 20 74 65 run when our te
2fa0: 73 74 27 73 20 2b 66 6f 6f 2f 31 32 33 34 2b 20 st's +foo/1234+
2fb0: 69 74 65 6d 20 69 73 20 72 65 71 75 65 73 74 65 item is requeste
2fc0: 64 20 61 73 20 77 65 6c 6c 20 61 73 20 63 61 75 d as well as cau
2fd0: 73 69 6e 67 20 77 61 69 74 6f 6e 20 74 65 73 74 sing waiton test
2fe0: 20 42 27 73 20 2b 62 6c 61 68 2b 20 69 74 65 6d B's +blah+ item
2ff0: 20 74 6f 20 72 75 6e 20 77 68 65 6e 20 6f 75 72 to run when our
3000: 20 74 65 73 74 27 73 20 2b 73 74 75 66 66 2f 62 test's +stuff/b
3010: 6c 61 68 2b 20 69 74 65 6d 20 69 73 20 72 65 71 lah+ item is req
3020: 75 65 73 74 65 64 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d uested.---------
3030: 2d 2d 2d 2d 2d 0a 5b 69 74 65 6d 6d 61 70 5d 0a -----.[itemmap].
3040: 41 20 66 6f 6f 2f 20 62 61 72 2f 0a 42 20 73 74 A foo/ bar/.B st
3050: 75 66 66 2f 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d uff/.-----------
3060: 2d 2d 2d 0a 0a 0a 43 6f 6d 70 6c 65 78 20 6d 61 ---...Complex ma
3070: 70 70 69 6e 67 20 65 78 61 6d 70 6c 65 0a 5e 5e pping example.^^
3080: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3090: 5e 5e 5e 5e 5e 0a 0a 0a 0a 2f 2f 20 69 6d 61 67 ^^^^^....// imag
30a0: 65 3a 3a 69 74 65 6d 6d 61 70 2e 70 6e 67 5b 5d e::itemmap.png[]
30b0: 0a 69 6d 61 67 65 3a 3a 63 6f 6d 70 6c 65 78 2d .image::complex-
30c0: 69 74 65 6d 6d 61 70 2e 70 6e 67 5b 5d 0a 0a 0a itemmap.png[]...
30d0: 57 65 20 61 63 63 6f 6d 70 6c 69 73 68 20 74 68 We accomplish th
30e0: 69 73 20 62 79 20 63 6f 6e 66 69 67 75 72 69 6e is by configurin
30f0: 67 20 74 68 65 20 74 65 73 74 63 6f 6e 66 69 67 g the testconfig
3100: 73 20 6f 66 20 6f 75 72 20 74 65 73 74 73 20 43 s of our tests C
3110: 20 44 20 61 6e 64 20 45 20 61 73 20 66 6f 6c 6c D and E as foll
3120: 6f 77 73 3a 0a 0a 2e 54 65 73 74 63 6f 6e 66 69 ows:...Testconfi
3130: 67 20 66 6f 72 20 54 65 73 74 20 45 20 68 61 73 g for Test E has
3140: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
3150: 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 -------.[require
3160: 6d 65 6e 74 73 5d 0a 77 61 69 74 6f 6e 20 43 0a ments].waiton C.
3170: 69 74 65 6d 6d 61 70 20 28 5c 64 2b 29 2f 72 65 itemmap (\d+)/re
3180: 73 20 5c 31 2f 62 62 0a 2d 2d 2d 2d 2d 2d 2d 2d s \1/bb.--------
3190: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
31a0: 2e 54 65 73 74 63 6f 6e 66 69 67 20 66 6f 72 20 .Testconfig for
31b0: 54 65 73 74 20 44 20 68 61 73 0a 2d 2d 2d 2d 2d Test D has.-----
31c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
31d0: 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e 74 73 5d -.[requirements]
31e0: 0a 77 61 69 74 6f 6e 20 43 0a 69 74 65 6d 6d 61 .waiton C.itemma
31f0: 70 20 28 5c 64 2b 29 2f 72 65 73 20 5c 31 2f 61 p (\d+)/res \1/a
3200: 61 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d a.--------------
3210: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 54 65 73 74 63 --------...Testc
3220: 6f 6e 66 69 67 20 66 6f 72 20 54 65 73 74 20 43 onfig for Test C
3230: 20 68 61 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d has.-----------
3240: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 72 65 71 -----------.[req
3250: 75 69 72 65 6d 65 6e 74 73 5d 0a 77 61 69 74 6f uirements].waito
3260: 6e 20 41 20 42 0a 0a 5b 69 74 65 6d 6d 61 70 5d n A B..[itemmap]
3270: 0a 41 20 28 5c 64 2b 29 2f 61 61 20 61 61 2f 5c .A (\d+)/aa aa/\
3280: 31 0a 42 20 28 5c 64 2b 29 2f 62 62 20 62 62 2f 1.B (\d+)/bb bb/
3290: 5c 31 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d \1.-------------
32a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 54 65 73 74 ---------...Test
32b0: 63 6f 6e 66 69 67 73 20 66 6f 72 20 54 65 73 74 configs for Test
32c0: 20 42 20 61 6e 64 20 54 65 73 74 20 41 20 68 61 B and Test A ha
32d0: 76 65 20 6e 6f 20 77 61 69 74 6f 6e 20 6f 72 20 ve no waiton or
32e0: 69 74 65 6d 6d 61 70 20 63 6f 6e 66 69 67 75 72 itemmap configur
32f0: 65 64 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ed.-------------
3300: 2d 2d 2d 2d 2d 2d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ------.---------
3310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 57 61 6c ----------...Wal
3320: 6b 20 74 68 72 6f 75 67 68 20 6f 6e 65 20 69 74 k through one it
3330: 65 6d 20 2d 2d 20 77 65 20 77 61 6e 74 20 74 68 em -- we want th
3340: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 6f 20 68 e following to h
3350: 61 70 70 65 6e 20 66 6f 72 20 74 65 73 74 70 61 appen for testpa
3360: 74 74 20 2b 44 2f 31 2f 72 65 73 2b 20 28 73 65 tt +D/1/res+ (se
3370: 65 20 62 6c 75 65 20 62 6f 78 65 73 20 69 6e 20 e blue boxes in
3380: 63 6f 6d 70 6c 65 78 20 69 74 65 6d 6d 61 70 69 complex itemmapi
3390: 6e 67 20 66 69 67 75 72 65 20 61 62 6f 76 65 29 ng figure above)
33a0: 3a 0a 0a 2e 20 65 67 20 66 72 6f 6d 20 63 6f 6d :... eg from com
33b0: 6d 61 6e 64 20 6c 69 6e 65 20 2b 6d 65 67 61 74 mand line +megat
33c0: 65 73 74 20 2d 72 75 6e 20 2d 74 65 73 74 70 61 est -run -testpa
33d0: 74 74 20 44 2f 31 2f 72 65 73 20 2d 74 61 72 67 tt D/1/res -targ
33e0: 65 74 20 6d 79 74 61 72 67 65 74 20 2d 72 75 6e et mytarget -run
33f0: 6e 61 6d 65 20 6d 79 72 75 6e 6e 61 6d 65 2b 0a name myrunname+.
3400: 2e 20 46 75 6c 6c 20 6c 69 73 74 20 74 6f 20 62 . Full list to b
3410: 65 20 72 75 6e 20 69 73 20 6e 6f 77 3a 20 2b 44 e run is now: +D
3420: 2f 31 2f 72 65 73 2b 0a 2e 20 54 65 73 74 20 44 /1/res+.. Test D
3430: 20 68 61 73 20 61 20 77 61 69 74 6f 6e 20 2d 20 has a waiton -
3440: 74 65 73 74 20 43 2e 20 20 54 65 73 74 20 44 27 test C. Test D'
3450: 73 20 69 74 65 6d 6d 61 70 20 72 75 6c 65 20 2b s itemmap rule +
3460: 69 74 65 6d 6d 61 70 20 28 5c 64 26 70 6c 75 73 itemmap (\d&plus
3470: 3b 29 2f 72 65 73 20 5c 31 2f 61 61 2b 20 2d 3e ;)/res \1/aa+ ->
3480: 20 20 63 61 75 73 65 73 20 2b 43 2f 31 2f 61 61 causes +C/1/aa
3490: 2b 20 74 6f 20 72 75 6e 20 62 65 66 6f 72 65 20 + to run before
34a0: 2b 44 2f 31 2f 72 65 73 2b 0a 2e 20 46 75 6c 6c +D/1/res+.. Full
34b0: 20 6c 69 73 74 20 74 6f 20 62 65 20 72 75 6e 20 list to be run
34c0: 69 73 20 6e 6f 77 3a 20 2b 44 2f 31 2f 72 65 73 is now: +D/1/res
34d0: 2b 2c 20 2b 43 2f 31 2f 61 61 2b 0a 2e 20 54 65 +, +C/1/aa+.. Te
34e0: 73 74 20 43 20 77 61 73 20 61 20 77 61 69 74 6f st C was a waito
34f0: 6e 20 2d 20 74 65 73 74 20 41 2e 20 54 65 73 74 n - test A. Test
3500: 20 43 27 73 20 72 75 6c 65 20 2b 41 20 28 5c 64 C's rule +A (\d
3510: 26 70 6c 75 73 3b 29 2f 61 61 20 61 61 2f 5c 31 +)/aa aa/\1
3520: 2b 20 2d 3e 20 63 61 75 73 65 73 20 2b 41 2f 61 + -> causes +A/a
3530: 61 2f 31 2b 20 74 6f 20 72 75 6e 20 62 65 66 6f a/1+ to run befo
3540: 72 65 20 2b 43 2f 31 2f 61 61 2b 0a 2e 20 46 75 re +C/1/aa+.. Fu
3550: 6c 6c 20 6c 69 73 74 20 74 6f 20 62 65 20 72 75 ll list to be ru
3560: 6e 20 69 73 20 6e 6f 77 3a 20 2b 44 2f 31 2f 72 n is now: +D/1/r
3570: 65 73 2b 2c 20 2b 43 2f 31 2f 61 61 2b 2c 20 2b es+, +C/1/aa+, +
3580: 41 2f 61 61 2f 31 2b 0a 2e 20 54 65 73 74 20 41 A/aa/1+.. Test A
3590: 20 68 61 73 20 6e 6f 20 77 61 69 74 6f 6e 73 2e has no waitons.
35a0: 20 20 41 6c 6c 20 77 61 69 74 6f 6e 73 20 6f 66 All waitons of
35b0: 20 61 6c 6c 20 74 65 73 74 73 20 69 6e 20 66 75 all tests in fu
35c0: 6c 6c 20 6c 69 73 74 20 68 61 76 65 20 62 65 65 ll list have bee
35d0: 6e 20 70 72 6f 63 65 73 73 65 64 2e 20 20 46 75 n processed. Fu
35e0: 6c 6c 20 6c 69 73 74 20 69 73 20 66 69 6e 61 6c ll list is final
35f0: 69 7a 65 64 2e 0a 0a 0a 44 79 6e 61 6d 69 63 20 ized....Dynamic
3600: 46 6c 6f 77 20 44 65 70 65 6e 64 65 6e 63 79 20 Flow Dependency
3610: 54 72 65 65 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e Tree.^^^^^^^^^^^
3620: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3630: 5e 0a 0a 2e 41 75 74 6f 67 65 6e 65 72 61 74 69 ^...Autogenerati
3640: 6f 6e 20 77 61 69 74 6f 6e 20 6c 69 73 74 20 66 on waiton list f
3650: 6f 72 20 64 79 6e 61 6d 69 63 20 66 6c 6f 77 20 or dynamic flow
3660: 64 65 70 65 6e 64 65 6e 63 79 20 74 72 65 65 73 dependency trees
3670: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
3680: 2d 2d 2d 2d 0a 5b 72 65 71 75 69 72 65 6d 65 6e ----.[requiremen
3690: 74 73 5d 0a 23 20 57 69 74 68 20 61 20 74 6f 70 ts].# With a top
36a0: 6c 65 76 65 6c 20 74 65 73 74 20 79 6f 75 20 6d level test you m
36b0: 61 79 20 77 69 73 68 20 74 6f 20 67 65 6e 65 72 ay wish to gener
36c0: 61 74 65 20 79 6f 75 72 20 6c 69 73 74 20 0a 23 ate your list .#
36d0: 20 6f 66 20 74 65 73 74 73 20 74 6f 20 72 75 6e of tests to run
36e0: 20 64 79 6e 61 6d 69 63 61 6c 6c 79 0a 23 0a 77 dynamically.#.w
36f0: 61 69 74 6f 6e 20 23 7b 73 68 65 6c 6c 20 67 65 aiton #{shell ge
3700: 74 2d 76 61 6c 69 64 2d 74 65 73 74 73 2d 74 6f t-valid-tests-to
3710: 2d 72 75 6e 2e 73 68 7d 0a 2d 2d 2d 2d 2d 2d 2d -run.sh}.-------
3720: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 52 75 ------------..Ru
3730: 6e 20 74 69 6d 65 20 6c 69 6d 69 74 0a 5e 5e 5e n time limit.^^^
3740: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d ^^^^^^^^^^^..---
3750: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
3760: 72 65 71 75 69 72 65 6d 65 6e 74 73 5d 0a 72 75 requirements].ru
3770: 6e 74 69 6d 65 6c 69 6d 20 31 68 20 32 6d 20 33 ntimelim 1h 2m 3
3780: 73 20 20 23 20 74 68 69 73 20 77 69 6c 6c 20 61 s # this will a
3790: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6b 69 6c utomatically kil
37a0: 6c 20 74 68 65 20 74 65 73 74 20 69 66 20 69 74 l the test if it
37b0: 20 72 75 6e 73 20 66 6f 72 20 6d 6f 72 65 20 74 runs for more t
37c0: 68 61 6e 20 31 68 20 32 6d 20 61 6e 64 20 33 73 han 1h 2m and 3s
37d0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
37e0: 2d 2d 0a 0a 53 6b 69 70 0a 5e 5e 5e 5e 0a 0a 41 --..Skip.^^^^..A
37f0: 20 74 65 73 74 20 77 69 74 68 20 61 20 73 6b 69 test with a ski
3800: 70 20 73 65 63 74 69 6f 6e 20 77 69 6c 6c 20 63 p section will c
3810: 6f 6e 64 69 74 69 6f 6e 61 6c 20 73 6b 69 70 20 onditional skip
3820: 72 75 6e 6e 69 6e 67 2e 0a 0a 2e 53 6b 69 70 20 running....Skip
3830: 73 65 63 74 69 6f 6e 20 65 78 61 6d 70 6c 65 0a section example.
3840: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3850: 2d 0a 5b 73 6b 69 70 5d 0a 70 72 65 76 72 75 6e -.[skip].prevrun
3860: 6e 69 6e 67 20 78 0a 23 20 72 75 6e 64 65 6c 61 ning x.# rundela
3870: 79 20 33 30 6d 20 31 35 73 0a 2d 2d 2d 2d 2d 2d y 30m 15s.------
3880: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 -----------..Ski
3890: 70 20 6f 6e 20 53 74 69 6c 6c 2d 72 75 6e 6e 69 p on Still-runni
38a0: 6e 67 20 54 65 73 74 73 0a 5e 5e 5e 5e 5e 5e 5e ng Tests.^^^^^^^
38b0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
38c0: 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^^^..----------
38d0: 2d 2d 2d 2d 2d 2d 2d 0a 23 20 4e 42 2f 2f 20 49 -------.# NB// I
38e0: 66 20 74 68 65 20 70 72 65 76 72 75 6e 6e 69 6e f the prevrunnin
38f0: 67 20 6c 69 6e 65 20 65 78 69 73 74 73 20 77 69 g line exists wi
3900: 74 68 20 2a 61 6e 79 2a 20 76 61 6c 75 65 20 74 th *any* value t
3910: 68 65 20 74 65 73 74 20 77 69 6c 6c 0a 23 20 61 he test will.# a
3920: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 53 4b 49 utomatically SKI
3930: 50 20 69 66 20 74 68 65 20 73 61 6d 65 2d 6e 61 P if the same-na
3940: 6d 65 64 20 74 65 73 74 20 69 73 20 63 75 72 72 med test is curr
3950: 65 6e 74 6c 79 20 52 55 4e 4e 49 4e 47 2e 20 54 ently RUNNING. T
3960: 68 65 0a 23 20 22 78 22 20 63 61 6e 20 62 65 20 he.# "x" can be
3970: 61 6e 79 20 73 74 72 69 6e 67 2e 20 43 6f 6d 6d any string. Comm
3980: 65 6e 74 20 6f 75 74 20 74 68 65 20 70 72 65 76 ent out the prev
3990: 72 75 6e 6e 69 6e 67 20 6c 69 6e 65 20 74 6f 20 running line to
39a0: 74 75 72 6e 20 6f 66 66 0a 23 20 73 6b 69 70 2e turn off.# skip.
39b0: 0a 0a 5b 73 6b 69 70 5d 0a 70 72 65 76 72 75 6e ..[skip].prevrun
39c0: 6e 69 6e 67 20 78 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ning x.---------
39d0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 6b 69 70 20 69 --------..Skip i
39e0: 66 20 61 20 46 69 6c 65 20 45 78 69 73 74 73 0a f a File Exists.
39f0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3a00: 5e 5e 5e 5e 5e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d ^^^^^..---------
3a10: 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 73 6b 69 70 5d 0a --------.[skip].
3a20: 66 69 6c 65 65 78 69 73 74 73 20 2f 70 61 74 68 fileexists /path
3a30: 2f 74 6f 2f 61 2f 66 69 6c 65 20 23 20 73 6b 69 /to/a/file # ski
3a40: 70 20 69 66 20 2f 70 61 74 68 2f 74 6f 2f 61 2f p if /path/to/a/
3a50: 66 69 6c 65 20 65 78 69 73 74 73 0a 2d 2d 2d 2d file exists.----
3a60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 -------------..S
3a70: 6b 69 70 20 69 66 20 74 65 73 74 20 72 61 6e 20 kip if test ran
3a80: 6d 6f 72 65 20 72 65 63 65 6e 74 6c 79 20 74 68 more recently th
3a90: 61 6e 20 73 70 65 63 69 66 69 65 64 20 74 69 6d an specified tim
3aa0: 65 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e e.^^^^^^^^^^^^^^
3ab0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3ac0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
3ad0: 5e 5e 5e 5e 0a 0a 2e 53 6b 69 70 20 69 66 20 74 ^^^^...Skip if t
3ae0: 68 69 73 20 74 65 73 74 20 68 61 73 20 62 65 65 his test has bee
3af0: 6e 20 72 75 6e 20 69 6e 20 74 68 65 20 70 61 73 n run in the pas
3b00: 74 20 66 69 66 74 65 65 6e 20 6d 69 6e 75 74 65 t fifteen minute
3b10: 73 20 61 6e 64 20 31 35 20 73 65 63 6f 6e 64 73 s and 15 seconds
3b20: 2e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
3b30: 2d 2d 2d 0a 5b 73 6b 69 70 5d 0a 72 75 6e 64 65 ---.[skip].runde
3b40: 6c 61 79 20 31 35 6d 20 31 35 73 0a 2d 2d 2d 2d lay 15m 15s.----
3b50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 -------------..D
3b60: 69 73 6b 73 0a 5e 5e 5e 5e 5e 0a 0a 41 20 64 69 isks.^^^^^..A di
3b70: 73 6b 73 20 73 65 63 74 69 6f 6e 20 69 6e 20 74 sks section in t
3b80: 65 73 74 63 6f 6e 66 69 67 20 77 69 6c 6c 20 6f estconfig will o
3b90: 76 65 72 72 69 64 65 20 74 68 65 20 64 69 73 6b verride the disk
3ba0: 73 20 73 65 63 74 69 6f 6e 20 69 6e 0a 6d 65 67 s section in.meg
3bb0: 61 74 65 73 74 2e 63 6f 6e 66 69 67 2e 20 54 68 atest.config. Th
3bc0: 69 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 is can be used t
3bd0: 6f 20 61 6c 6c 6f 63 61 74 65 20 64 69 73 6b 73 o allocate disks
3be0: 20 6f 6e 20 61 20 70 65 72 2d 74 65 73 74 20 6f on a per-test o
3bf0: 72 20 70 65 72 20 69 74 65 6d 0a 62 61 73 69 73 r per item.basis
3c00: 2e 0a 0a 43 6f 6e 74 72 6f 6c 6c 65 64 20 77 61 ...Controlled wa
3c10: 69 76 65 72 20 70 72 6f 70 61 67 61 74 69 6f 6e iver propagation
3c20: 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e .^^^^^^^^^^^^^^^
3c30: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0a 0a ^^^^^^^^^^^^^^..
3c40: 49 66 20 74 65 73 74 20 69 73 20 46 41 49 4c 20 If test is FAIL
3c50: 61 6e 64 20 70 72 65 76 69 6f 75 73 20 74 65 73 and previous tes
3c60: 74 20 69 6e 20 72 75 6e 20 77 69 74 68 20 73 61 t in run with sa
3c70: 6d 65 20 4d 54 5f 54 41 52 47 45 54 20 69 73 20 me MT_TARGET is
3c80: 57 41 49 56 45 44 20 74 68 65 6e 20 61 70 70 6c WAIVED then appl
3c90: 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 y the following
3ca0: 72 75 6c 65 73 20 66 72 6f 6d 20 74 68 65 20 74 rules from the t
3cb0: 65 73 74 63 6f 6e 66 69 67 3a 0a 49 66 20 61 20 estconfig:.If a
3cc0: 77 61 69 76 65 72 20 63 68 65 63 6b 20 69 73 20 waiver check is
3cd0: 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 65 specified in the
3ce0: 20 74 65 73 74 63 6f 6e 66 69 67 20 61 70 70 6c testconfig appl
3cf0: 79 20 74 68 65 20 63 68 65 63 6b 20 61 6e 64 20 y the check and
3d00: 69 66 20 69 74 20 70 61 73 73 65 73 20 74 68 65 if it passes the
3d10: 6e 20 73 65 74 20 74 68 69 73 20 46 41 49 4c 20 n set this FAIL
3d20: 74 6f 20 57 41 49 56 45 44 0a 0a 57 61 69 76 65 to WAIVED..Waive
3d30: 72 20 63 68 65 63 6b 20 68 61 73 20 74 77 6f 20 r check has two
3d40: 70 61 72 74 73 2c 20 31 29 20 61 20 6c 69 73 74 parts, 1) a list
3d50: 20 6f 66 20 77 61 69 76 65 72 2c 20 72 75 6c 65 of waiver, rule
3d60: 6e 61 6d 65 2c 20 66 69 6c 65 70 61 74 74 65 72 name, filepatter
3d70: 6e 73 20 61 6e 64 20 32 29 20 74 68 65 20 72 75 ns and 2) the ru
3d80: 6c 65 6e 61 6d 65 20 73 63 72 69 70 74 20 73 70 lename script sp
3d90: 65 63 20 28 6e 6f 74 65 20 74 68 61 74 20 22 64 ec (note that "d
3da0: 69 66 66 22 20 61 6e 64 20 22 6c 6f 67 70 72 6f iff" and "logpro
3db0: 22 20 61 72 65 20 70 72 65 64 65 66 69 6e 65 64 " are predefined
3dc0: 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d )..-------------
3dd0: 2d 2d 2d 2d 0a 23 23 23 23 23 23 20 45 58 41 4d ----.###### EXAM
3de0: 50 4c 45 20 46 52 4f 4d 20 74 65 73 74 63 6f 6e PLE FROM testcon
3df0: 66 69 67 20 23 23 23 23 23 23 23 23 23 0a 23 20 fig #########.#
3e00: 6d 61 74 63 68 69 6e 67 20 66 69 6c 65 28 73 29 matching file(s)
3e10: 20 77 69 6c 6c 20 62 65 20 64 69 66 66 27 64 20 will be diff'd
3e20: 77 69 74 68 20 70 72 65 76 69 6f 75 73 20 72 75 with previous ru
3e30: 6e 20 61 6e 64 20 6c 6f 67 70 72 6f 20 61 70 70 n and logpro app
3e40: 6c 69 65 64 0a 23 20 69 66 20 50 41 53 53 20 6f lied.# if PASS o
3e50: 72 20 57 41 52 4e 20 72 65 73 75 6c 74 20 66 72 r WARN result fr
3e60: 6f 6d 20 6c 6f 67 70 72 6f 20 74 68 65 6e 20 57 om logpro then W
3e70: 41 49 56 45 52 20 73 74 61 74 65 20 69 73 20 73 AIVER state is s
3e80: 65 74 0a 23 0a 5b 77 61 69 76 65 72 73 5d 0a 23 et.#.[waivers].#
3e90: 20 6c 6f 67 70 72 6f 5f 66 69 6c 65 20 20 20 20 logpro_file
3ea0: 72 75 6c 65 6e 61 6d 65 20 20 20 20 20 20 69 6e rulename in
3eb0: 70 75 74 5f 67 6c 6f 62 0a 77 61 69 76 65 72 5f put_glob.waiver_
3ec0: 31 20 20 20 20 20 20 20 20 20 6c 6f 67 70 72 6f 1 logpro
3ed0: 20 20 20 20 20 20 20 20 6c 6f 6f 6b 69 74 74 6d lookittm
3ee0: 70 2e 6c 6f 67 0a 0a 5b 77 61 69 76 65 72 5f 72 p.log..[waiver_r
3ef0: 75 6c 65 73 5d 0a 0a 23 20 54 68 69 73 20 62 75 ules]..# This bu
3f00: 69 6c 74 69 6e 20 72 75 6c 65 20 69 73 20 74 68 iltin rule is th
3f10: 65 20 64 65 66 61 75 6c 74 20 69 66 20 74 68 65 e default if the
3f20: 72 65 20 69 73 20 6e 6f 20 3c 77 61 69 76 65 72 re is no <waiver
3f30: 6e 61 6d 65 3e 2e 6c 6f 67 70 72 6f 20 66 69 6c name>.logpro fil
3f40: 65 0a 23 20 64 69 66 66 20 20 20 64 69 66 66 20 e.# diff diff
3f50: 25 66 69 6c 65 31 25 20 25 66 69 6c 65 32 25 0a %file1% %file2%.
3f60: 0a 23 20 54 68 69 73 20 62 75 69 6c 74 69 6e 20 .# This builtin
3f70: 72 75 6c 65 20 69 73 20 61 70 70 6c 69 65 64 20 rule is applied
3f80: 69 66 20 61 20 3c 77 61 69 76 65 72 6e 61 6d 65 if a <waivername
3f90: 3e 2e 6c 6f 67 70 72 6f 20 66 69 6c 65 20 65 78 >.logpro file ex
3fa0: 69 73 74 73 0a 23 20 6c 6f 67 70 72 6f 20 64 69 ists.# logpro di
3fb0: 66 66 20 25 66 69 6c 65 31 25 20 25 66 69 6c 65 ff %file1% %file
3fc0: 32 25 20 7c 20 6c 6f 67 70 72 6f 20 25 77 61 69 2% | logpro %wai
3fd0: 76 65 72 6e 61 6d 65 25 2e 6c 6f 67 70 72 6f 20 vername%.logpro
3fe0: 25 77 61 69 76 65 72 6e 61 6d 65 25 2e 68 74 6d %waivername%.htm
3ff0: 6c 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d l.--------------
4000: 2d 2d 2d 0a 0a 45 7a 73 74 65 70 73 0a 7e 7e 7e ---..Ezsteps.~~~
4010: 7e 7e 7e 7e 0a 0a 2e 45 78 61 6d 70 6c 65 20 65 ~~~~...Example e
4020: 7a 73 74 65 70 73 20 77 69 74 68 20 6c 6f 67 70 zsteps with logp
4030: 72 6f 20 72 75 6c 65 73 0a 2d 2d 2d 2d 2d 2d 2d ro rules.-------
4040: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 65 7a 73 74 ----------.[ezst
4050: 65 70 73 5d 0a 6c 6f 6f 6b 69 74 74 6d 70 20 20 eps].lookittmp
4060: 20 6c 73 20 2f 74 6d 70 0a 0a 5b 6c 6f 67 70 72 ls /tmp..[logpr
4070: 6f 5d 0a 6c 6f 6f 6b 69 74 74 6d 70 20 3b 3b 20 o].lookittmp ;;
4080: 4e 6f 74 65 3a 20 63 6f 6e 66 69 67 20 66 69 6c Note: config fil
4090: 65 20 66 6f 72 6d 61 74 20 73 75 70 70 6f 72 74 e format support
40a0: 73 20 6d 75 6c 74 69 2d 6c 69 6e 65 20 65 6e 74 s multi-line ent
40b0: 72 69 65 73 20 77 68 65 72 65 20 6c 65 61 64 69 ries where leadi
40c0: 6e 67 20 77 68 69 74 65 73 70 61 63 65 20 69 73 ng whitespace is
40d0: 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 65 61 removed from ea
40e0: 63 68 20 6c 69 6e 65 0a 20 20 3b 3b 20 20 20 20 ch line. ;;
40f0: 20 61 20 62 6c 61 6e 6b 20 6c 69 6e 65 20 69 6e a blank line in
4100: 64 69 63 61 74 65 73 20 74 68 65 20 65 6e 64 20 dicates the end
4110: 6f 66 20 74 68 65 20 62 6c 6f 63 6b 20 6f 66 20 of the block of
4120: 74 65 78 74 20 0a 20 20 28 65 78 70 65 63 74 3a text . (expect:
4130: 72 65 71 75 69 72 65 64 20 69 6e 20 22 4c 6f 67 required in "Log
4140: 46 69 6c 65 42 6f 64 79 22 20 3e 20 30 20 22 41 FileBody" > 0 "A
4150: 20 66 69 6c 65 20 6e 61 6d 65 20 74 68 61 74 20 file name that
4160: 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 65 78 69 should never exi
4170: 73 74 21 22 20 23 2f 54 68 69 73 20 69 73 20 61 st!" #/This is a
4180: 20 61 77 66 75 6c 6c 79 20 73 74 75 70 69 64 20 awfully stupid
4190: 66 69 6c 65 20 6e 61 6d 65 20 74 68 61 74 20 73 file name that s
41a0: 68 6f 75 6c 64 20 6e 65 76 65 72 20 62 65 20 66 hould never be f
41b0: 6f 75 6e 64 20 69 6e 20 74 68 65 20 74 65 6d 70 ound in the temp
41c0: 20 64 69 72 2f 29 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d dir/)..--------
41d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 6f 20 74 72 ---------..To tr
41e0: 61 6e 73 66 65 72 20 74 68 65 20 65 6e 76 69 72 ansfer the envir
41f0: 6f 6e 6d 65 6e 74 20 74 6f 20 74 68 65 20 6e 65 onment to the ne
4200: 78 74 20 73 74 65 70 20 79 6f 75 20 63 61 6e 20 xt step you can
4210: 64 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 do the following
4220: 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d :..-------------
4230: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
4240: 24 4d 54 5f 4d 45 47 41 54 45 53 54 20 2d 65 6e $MT_MEGATEST -en
4250: 76 32 66 69 6c 65 20 2e 65 7a 73 74 65 70 73 2f v2file .ezsteps/
4260: 24 7b 73 74 65 70 6e 61 6d 65 7d 09 20 20 0a 2d ${stepname}. .-
4270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4280: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 72 69 -----------..Tri
4290: 67 67 65 72 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a ggers.~~~~~~~~..
42a0: 49 6e 20 79 6f 75 72 20 74 65 73 74 63 6f 6e 66 In your testconf
42b0: 69 67 20 6f 72 20 6d 65 67 61 74 65 73 74 2e 63 ig or megatest.c
42c0: 6f 6e 66 69 67 20 74 72 69 67 67 65 72 73 20 63 onfig triggers c
42d0: 61 6e 20 62 65 20 73 70 65 63 69 66 69 65 64 20 an be specified
42e0: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
42f0: 2d 2d 2d 0a 5b 74 72 69 67 67 65 72 73 5d 0a 0a ---.[triggers]..
4300: 23 20 43 61 6c 6c 20 73 63 72 69 70 74 20 72 75 # Call script ru
4310: 6e 6e 69 6e 67 2e 73 68 20 77 68 65 6e 20 74 65 nning.sh when te
4320: 73 74 20 67 6f 65 73 20 74 6f 20 73 74 61 74 65 st goes to state
4330: 3d 52 55 4e 4e 49 4e 47 2c 20 73 74 61 74 75 73 =RUNNING, status
4340: 3d 50 41 53 53 0a 52 55 4e 4e 49 4e 47 2f 50 41 =PASS.RUNNING/PA
4350: 53 53 20 72 75 6e 6e 69 6e 67 2e 73 68 0a 0a 23 SS running.sh..#
4360: 20 43 61 6c 6c 20 73 63 72 69 70 74 20 72 75 6e Call script run
4370: 6e 69 6e 67 2e 73 68 20 61 6e 79 20 74 69 6d 65 ning.sh any time
4380: 20 73 74 61 74 65 20 67 6f 65 73 20 74 6f 20 52 state goes to R
4390: 55 4e 4e 49 4e 47 0a 52 55 4e 4e 49 4e 47 2f 20 UNNING.RUNNING/
43a0: 72 75 6e 6e 69 6e 67 2e 73 68 0a 0a 23 20 43 61 running.sh..# Ca
43b0: 6c 6c 20 73 63 72 69 70 74 20 6f 6e 70 61 73 73 ll script onpass
43c0: 2e 73 68 20 61 6e 79 20 74 69 6d 65 20 73 74 61 .sh any time sta
43d0: 74 75 73 20 67 6f 65 73 20 74 6f 20 50 41 53 53 tus goes to PASS
43e0: 0a 50 41 53 53 2f 20 6f 6e 70 61 73 73 2e 73 68 .PASS/ onpass.sh
43f0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
4400: 2d 2d 0a 0a 53 63 72 69 70 74 73 20 63 61 6c 6c --..Scripts call
4410: 65 64 20 77 69 6c 6c 20 68 61 76 65 3b 20 74 65 ed will have; te
4420: 73 74 2d 69 64 20 74 65 73 74 2d 72 75 6e 64 69 st-id test-rundi
4430: 72 20 74 72 69 67 67 65 72 20 74 65 73 74 2d 6e r trigger test-n
4440: 61 6d 65 20 69 74 65 6d 2d 70 61 74 68 20 73 74 ame item-path st
4450: 61 74 65 20 73 74 61 74 75 73 20 65 76 65 6e 74 ate status event
4460: 2d 74 69 6d 65 2c 20 61 64 64 65 64 20 74 6f 20 -time, added to
4470: 74 68 65 20 63 6f 6d 6d 61 6e 64 6c 69 6e 65 2e the commandline.
4480: 0a 0a 48 49 4e 54 0a 0a 54 6f 20 73 74 61 72 74 ..HINT..To start
4490: 20 61 6e 20 78 74 65 72 6d 20 28 75 73 65 66 75 an xterm (usefu
44a0: 6c 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 29 l for debugging)
44b0: 2c 20 75 73 65 20 61 20 63 6f 6d 6d 61 6e 64 20 , use a command
44c0: 6c 69 6e 65 20 6c 69 6b 65 20 74 68 65 20 66 6f line like the fo
44d0: 6c 6c 6f 77 69 6e 67 3a 0a 0a 2d 2d 2d 2d 2d 2d llowing:..------
44e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 74 72 69 -----------.[tri
44f0: 67 67 65 72 73 5d 0a 43 4f 4d 50 4c 45 54 45 44 ggers].COMPLETED
4500: 2f 20 78 74 65 72 6d 20 2d 65 20 62 61 73 68 20 / xterm -e bash
4510: 2d 73 20 2d 2d 20 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d -s -- .---------
4520: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e 4f 54 45 3a 20 --------..NOTE:
4530: 54 68 65 72 65 20 69 73 20 61 20 74 72 61 69 6c There is a trail
4540: 69 6e 67 20 73 70 61 63 65 20 61 66 74 65 72 20 ing space after
4550: 74 68 65 20 2d 2d 0a 0a 54 68 65 72 65 20 61 72 the --..There ar
4560: 65 20 61 20 6e 75 6d 62 65 72 20 6f 66 20 65 6e e a number of en
4570: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
4580: 6c 65 73 20 61 76 61 69 6c 61 62 6c 65 20 74 6f les available to
4590: 20 74 68 65 20 74 72 69 67 67 65 72 20 73 63 72 the trigger scr
45a0: 69 70 74 0a 62 75 74 20 73 69 6e 63 65 20 74 72 ipt.but since tr
45b0: 69 67 67 65 72 73 20 63 61 6e 20 62 65 20 63 61 iggers can be ca
45c0: 6c 6c 65 64 20 69 6e 20 76 61 72 69 6f 75 73 20 lled in various
45d0: 63 6f 6e 74 65 78 74 73 20 6e 6f 74 20 61 6c 6c contexts not all
45e0: 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 0a 61 variables are.a
45f0: 76 61 69 6c 61 62 6c 65 20 61 74 20 61 6c 6c 20 vailable at all
4600: 74 69 6d 65 73 2e 20 54 68 65 20 74 72 69 67 67 times. The trigg
4610: 65 72 20 73 63 72 69 70 74 20 73 68 6f 75 6c 64 er script should
4620: 20 63 68 65 63 6b 20 66 6f 72 20 74 68 65 20 76 check for the v
4630: 61 72 69 61 62 6c 65 20 61 6e 64 0a 66 61 69 6c ariable and.fail
4640: 20 67 72 61 63 65 66 75 6c 6c 79 20 69 66 20 69 gracefully if i
4650: 74 20 64 6f 65 73 6e 27 74 20 65 78 69 73 74 2e t doesn't exist.
4660: 0a 0a 2e 45 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 ...Environment v
4670: 61 72 69 61 62 6c 65 73 20 76 69 73 69 62 6c 65 ariables visible
4680: 20 74 6f 20 74 68 65 20 74 72 69 67 67 65 72 20 to the trigger
4690: 73 63 72 69 70 74 0a 5b 77 69 64 74 68 3d 22 39 script.[width="9
46a0: 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d 22 2c 0%",cols="^,2m",
46b0: 66 72 61 6d 65 3d 22 74 6f 70 62 6f 74 22 2c 6f frame="topbot",o
46c0: 70 74 69 6f 6e 73 3d 22 68 65 61 64 65 72 22 5d ptions="header"]
46d0: 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d .|==============
46e0: 3d 3d 3d 3d 3d 3d 3d 3d 0a 7c 56 61 72 69 61 62 ========.|Variab
46f0: 6c 65 20 20 20 20 20 20 20 20 20 20 20 20 20 7c le |
4700: 20 50 75 72 70 6f 73 65 20 20 20 20 20 20 20 20 Purpose
4710: 20 20 20 20 0a 7c 20 4d 54 5f 54 45 53 54 5f 52 .| MT_TEST_R
4720: 55 4e 5f 44 49 52 20 20 20 20 20 7c 20 54 68 65 UN_DIR | The
4730: 20 64 69 72 65 63 74 6f 72 79 20 77 68 65 72 65 directory where
4740: 20 4d 65 67 61 74 65 73 74 20 72 61 6e 20 74 68 Megatest ran th
4750: 69 73 20 74 65 73 74 20 20 20 20 20 20 20 20 20 is test
4760: 20 20 20 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f .| MT_
4770: 43 4d 44 49 4e 46 4f 20 20 20 20 20 20 20 20 20 CMDINFO
4780: 20 7c 20 45 6e 63 6f 64 65 64 20 63 6f 6d 6d 61 | Encoded comma
4790: 6e 64 20 64 61 74 61 20 66 6f 72 20 74 68 65 20 nd data for the
47a0: 74 65 73 74 20 20 20 20 20 20 20 20 20 20 20 20 test
47b0: 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f 44 45 42 .| MT_DEB
47c0: 55 47 5f 4d 4f 44 45 20 20 20 20 20 20 20 7c 20 UG_MODE |
47d0: 55 73 65 64 20 74 6f 20 70 61 73 73 20 74 68 65 Used to pass the
47e0: 20 64 65 62 75 67 20 6d 6f 64 65 20 74 6f 20 6e debug mode to n
47f0: 65 73 74 65 64 20 63 61 6c 6c 73 20 74 6f 20 4d ested calls to M
4800: 65 67 61 74 65 73 74 20 20 20 20 20 20 20 20 20 egatest
4810: 20 20 20 20 20 20 20 20 20 20 0a 7c 20 4d 54 5f .| MT_
4820: 52 55 4e 5f 41 52 45 41 5f 48 4f 4d 45 20 20 20 RUN_AREA_HOME
4830: 20 7c 20 4d 65 67 61 74 65 73 74 20 68 6f 6d 65 | Megatest home
4840: 20 61 72 65 61 20 0a 7c 20 4d 54 5f 54 45 53 54 area .| MT_TEST
4850: 53 55 49 54 45 4e 41 4d 45 20 20 20 20 7c 20 54 SUITENAME | T
4860: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 69 73 20 he name of this
4870: 74 65 73 74 73 75 69 74 65 20 6f 72 20 61 72 65 testsuite or are
4880: 61 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 a
4890: 20 20 20 20 0a 7c 20 4d 54 5f 54 45 53 54 5f 4e .| MT_TEST_N
48a0: 41 4d 45 20 20 20 20 20 20 20 20 7c 20 54 68 65 AME | The
48b0: 20 6e 61 6d 65 20 6f 66 20 74 68 69 73 20 74 65 name of this te
48c0: 73 74 0a 7c 20 4d 54 5f 49 54 45 4d 5f 49 4e 46 st.| MT_ITEM_INF
48d0: 4f 20 20 20 20 20 20 20 20 7c 20 54 68 65 20 76 O | The v
48e0: 61 72 69 61 62 6c 65 20 61 6e 64 20 76 61 6c 75 ariable and valu
48f0: 65 73 20 66 6f 72 20 74 68 65 20 74 65 73 74 20 es for the test
4900: 69 74 65 6d 0a 7c 20 4d 54 5f 4d 45 47 41 54 45 item.| MT_MEGATE
4910: 53 54 20 20 20 20 20 20 20 20 20 7c 20 57 68 69 ST | Whi
4920: 63 68 20 4d 65 67 61 74 65 73 74 20 62 69 6e 61 ch Megatest bina
4930: 72 79 20 69 73 20 62 65 69 6e 67 20 75 73 65 64 ry is being used
4940: 20 62 79 20 74 68 69 73 20 61 72 65 61 0a 7c 20 by this area.|
4950: 4d 54 5f 54 41 52 47 45 54 20 20 20 20 20 20 20 MT_TARGET
4960: 20 20 20 20 7c 20 54 68 65 20 74 61 72 67 65 74 | The target
4970: 20 76 61 72 69 61 62 6c 65 20 76 61 6c 75 65 73 variable values
4980: 2c 20 73 65 70 61 72 61 74 65 64 20 62 79 20 27 , separated by '
4990: 2f 27 0a 7c 20 4d 54 5f 4c 49 4e 4b 54 52 45 45 /'.| MT_LINKTREE
49a0: 20 20 20 20 20 20 20 20 20 7c 20 54 68 65 20 62 | The b
49b0: 61 73 65 20 6f 66 20 74 68 65 20 6c 69 6e 6b 20 ase of the link
49c0: 74 72 65 65 20 77 68 65 72 65 20 61 6c 6c 20 72 tree where all r
49d0: 75 6e 20 74 65 73 74 73 20 63 61 6e 20 62 65 20 un tests can be
49e0: 66 6f 75 6e 64 0a 7c 20 4d 54 5f 49 54 45 4d 50 found.| MT_ITEMP
49f0: 41 54 48 20 20 20 20 20 20 20 20 20 7c 20 54 68 ATH | Th
4a00: 65 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 e values of the
4a10: 69 74 65 6d 20 70 61 74 68 20 76 61 72 69 61 62 item path variab
4a20: 6c 65 73 2c 20 73 65 70 61 72 61 74 65 64 20 62 les, separated b
4a30: 79 20 27 2f 27 0a 7c 20 4d 54 5f 52 55 4e 4e 41 y '/'.| MT_RUNNA
4a40: 4d 45 20 20 20 20 20 20 20 20 20 20 7c 20 54 68 ME | Th
4a50: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 72 75 e name of the ru
4a60: 6e 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d n.|=============
4a70: 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 0a 4f 76 65 72 =========...Over
4a80: 72 69 64 65 20 74 68 65 20 54 6f 70 6c 65 76 65 ride the Topleve
4a90: 6c 20 48 54 4d 4c 20 46 69 6c 65 0a 7e 7e 7e 7e l HTML File.~~~~
4aa0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
4ab0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 4d 65 67 ~~~~~~~~~~~..Meg
4ac0: 61 74 65 73 74 20 67 65 6e 65 72 61 74 65 73 20 atest generates
4ad0: 61 20 73 69 6d 70 6c 65 20 68 74 6d 6c 20 66 69 a simple html fi
4ae0: 6c 65 20 73 75 6d 6d 61 72 79 20 66 6f 72 20 74 le summary for t
4af0: 6f 70 20 6c 65 76 65 6c 20 74 65 73 74 73 20 6f op level tests o
4b00: 66 0a 69 74 65 72 61 74 65 64 20 74 65 73 74 73 f.iterated tests
4b10: 2e 20 54 68 65 20 67 65 6e 65 72 61 74 69 6f 6e . The generation
4b20: 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64 can be overridd
4b30: 65 6e 2e 20 4e 4f 54 45 3a 20 74 68 65 20 6f 75 en. NOTE: the ou
4b40: 74 70 75 74 20 6f 66 0a 74 68 65 20 73 63 72 69 tput of.the scri
4b50: 70 74 20 69 73 20 63 61 70 74 75 72 65 64 20 66 pt is captured f
4b60: 72 6f 6d 20 73 74 64 6f 75 74 20 74 6f 20 63 72 rom stdout to cr
4b70: 65 61 74 65 20 74 68 65 20 68 74 6d 6c 2e 0a 0a eate the html...
4b80: 0a 2e 46 6f 72 20 74 65 73 74 20 22 72 75 6e 66 ..For test "runf
4b90: 69 72 73 74 22 20 6f 76 65 72 72 69 64 65 20 74 irst" override t
4ba0: 68 65 20 74 6f 70 6c 65 76 65 6c 20 67 65 6e 65 he toplevel gene
4bb0: 72 61 74 69 6f 6e 20 77 69 74 68 20 61 20 73 63 ration with a sc
4bc0: 72 69 70 74 20 22 6d 79 73 75 6d 6d 61 72 79 2e ript "mysummary.
4bd0: 73 68 22 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d sh".------------
4be0: 2d 2d 2d 2d 2d 0a 23 20 4f 76 65 72 72 69 64 65 -----.# Override
4bf0: 20 74 68 65 20 72 6f 6c 6c 75 70 20 66 6f 72 20 the rollup for
4c00: 73 70 65 63 69 66 69 63 20 74 65 73 74 73 0a 5b specific tests.[
4c10: 74 65 73 74 72 6f 6c 6c 75 70 5d 0a 72 75 6e 66 testrollup].runf
4c20: 69 72 73 74 20 6d 79 73 75 6d 6d 61 72 79 2e 73 irst mysummary.s
4c30: 68 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d h.--------------
4c40: 2d 2d 2d 0a 0a 41 72 63 68 69 76 69 6e 67 20 53 ---..Archiving S
4c50: 65 74 75 70 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d etup.-----------
4c60: 2d 2d 2d 2d 0a 0a 49 6e 20 6d 65 67 61 74 65 73 ----..In megates
4c70: 74 2e 63 6f 6e 66 69 67 20 61 64 64 20 74 68 65 t.config add the
4c80: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 63 74 69 following secti
4c90: 6f 6e 73 3a 0a 0a 2e 6d 65 67 61 74 65 73 74 2e ons:...megatest.
4ca0: 63 6f 6e 66 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d config.---------
4cb0: 2d 2d 2d 2d 2d 0a 5b 61 72 63 68 69 76 65 5d 0a -----.[archive].
4cc0: 23 20 77 68 65 72 65 20 74 6f 20 67 65 74 20 62 # where to get b
4cd0: 75 70 20 65 78 65 63 75 74 61 62 6c 65 0a 23 20 up executable.#
4ce0: 62 75 70 20 2f 70 61 74 68 2f 74 6f 2f 62 75 70 bup /path/to/bup
4cf0: 0a 0a 5b 61 72 63 68 69 76 65 2d 64 69 73 6b 73 ..[archive-disks
4d00: 5d 0a 0a 23 20 41 72 63 68 69 76 65 73 20 77 69 ]..# Archives wi
4d10: 6c 6c 20 62 65 20 6f 72 67 61 6e 69 73 65 64 20 ll be organised
4d20: 75 6e 64 65 72 20 74 68 65 73 65 20 70 61 74 68 under these path
4d30: 73 20 6c 69 6b 65 20 74 68 69 73 3a 0a 23 20 20 s like this:.#
4d40: 3c 74 65 73 74 73 75 69 74 65 3e 2f 3c 63 72 65 <testsuite>/<cre
4d50: 61 74 69 6f 6e 64 61 74 65 3e 0a 23 20 57 69 74 ationdate>.# Wit
4d60: 68 69 6e 20 74 68 65 20 61 72 63 68 69 76 65 20 hin the archive
4d70: 74 68 65 20 64 61 74 61 20 69 73 20 73 74 72 75 the data is stru
4d80: 63 74 75 72 65 64 20 6c 69 6b 65 20 74 68 69 73 ctured like this
4d90: 3a 0a 23 20 20 3c 74 61 72 67 65 74 3e 2f 3c 72 :.# <target>/<r
4da0: 75 6e 6e 61 6d 65 3e 2f 3c 74 65 73 74 3e 2f 0a unname>/<test>/.
4db0: 61 72 63 68 69 76 65 30 20 2f 6d 66 73 2f 6d 79 archive0 /mfs/my
4dc0: 61 72 63 68 69 76 65 2d 64 61 74 61 2f 61 64 69 archive-data/adi
4dd0: 73 6b 31 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d sk1.------------
4de0: 2d 2d 0a 0a 48 61 6e 64 6c 69 6e 67 20 45 6e 76 --..Handling Env
4df0: 69 72 6f 6e 6d 65 6e 74 20 56 61 72 69 61 62 6c ironment Variabl
4e00: 65 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d es.-------------
4e10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4e20: 2d 0a 0a 49 74 20 69 73 20 6f 66 74 65 6e 20 6e -..It is often n
4e30: 65 63 65 73 73 61 72 79 20 74 6f 20 63 61 70 74 ecessary to capt
4e40: 75 72 65 20 61 6e 64 20 6f 72 20 6d 61 6e 69 70 ure and or manip
4e50: 75 6c 61 74 65 20 65 6e 76 69 72 6f 6e 6d 65 6e ulate environmen
4e60: 74 0a 76 61 72 69 61 62 6c 65 73 2e 20 4d 65 67 t.variables. Meg
4e70: 61 74 65 73 74 20 68 61 73 20 73 6f 6d 65 20 66 atest has some f
4e80: 61 63 69 6c 69 74 69 65 73 20 62 75 69 6c 74 20 acilities built
4e90: 69 6e 20 74 6f 20 68 65 6c 70 2e 0a 0a 43 61 70 in to help...Cap
4ea0: 74 75 72 65 20 76 61 72 69 61 62 6c 65 73 0a 7e ture variables.~
4eb0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
4ec0: 0a 0a 2e 43 6f 6d 6d 61 6e 64 73 0a 2d 2d 2d 2d ...Commands.----
4ed0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4ee0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 63 61 70 ----------.# cap
4ef0: 74 75 72 65 20 74 68 65 20 63 75 72 72 65 6e 74 ture the current
4f00: 20 65 6e 76 69 72 6f 6d 65 6e 74 20 69 6e 74 6f enviroment into
4f10: 20 61 20 64 62 20 63 61 6c 6c 65 64 20 65 6e 76 a db called env
4f20: 64 61 74 2e 64 62 20 75 6e 64 65 72 0a 23 20 74 dat.db under.# t
4f30: 68 65 20 63 6f 6e 74 65 78 74 20 22 62 65 66 6f he context "befo
4f40: 72 65 22 0a 6d 65 67 61 74 65 73 74 20 2d 65 6e re".megatest -en
4f50: 76 63 61 70 20 62 65 66 6f 72 65 0a 0a 23 20 63 vcap before..# c
4f60: 61 70 74 75 72 65 20 74 68 65 20 63 75 72 72 65 apture the curre
4f70: 6e 74 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 69 nt environment i
4f80: 6e 74 6f 20 61 20 64 62 20 63 61 6c 6c 65 64 20 nto a db called
4f90: 73 74 61 72 74 75 70 2e 64 62 20 77 69 74 68 20 startup.db with
4fa0: 0a 23 20 63 6f 6e 74 65 78 74 20 22 61 66 74 65 .# context "afte
4fb0: 72 22 0a 6d 65 67 61 74 65 73 74 20 2d 65 6e 76 r".megatest -env
4fc0: 63 61 70 20 61 66 74 65 72 20 73 74 61 72 74 75 cap after startu
4fd0: 70 2e 64 62 0a 0a 23 20 77 72 69 74 65 20 74 68 p.db..# write th
4fe0: 65 20 64 69 66 66 20 66 72 6f 6d 20 62 65 66 6f e diff from befo
4ff0: 72 65 20 74 6f 20 61 66 74 65 72 0a 6d 65 67 61 re to after.mega
5000: 74 65 73 74 20 2d 65 6e 76 64 65 6c 74 61 20 62 test -envdelta b
5010: 65 66 6f 72 65 2d 61 66 74 65 72 20 2d 64 75 6d efore-after -dum
5020: 70 6d 6f 64 65 20 62 61 73 68 0a 2d 2d 2d 2d 2d pmode bash.-----
5030: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5040: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 44 75 6d 70 20 ---------..Dump
5050: 6d 6f 64 65 73 20 69 6e 63 6c 75 64 65 20 62 61 modes include ba
5060: 73 68 2c 20 63 73 68 20 61 6e 64 20 63 6f 6e 66 sh, csh and conf
5070: 69 67 2e 20 59 6f 75 20 63 61 6e 20 69 6e 63 6c ig. You can incl
5080: 75 64 65 20 63 6f 6e 66 69 67 20 64 61 74 61 0a ude config data.
5090: 69 6e 74 6f 20 6d 65 67 61 74 65 73 74 2e 63 6f into megatest.co
50a0: 6e 66 69 67 20 6f 72 20 72 75 6e 63 6f 6e 66 69 nfig or runconfi
50b0: 67 73 2e 63 6f 6e 66 69 67 2e 0a 0a 2e 45 78 61 gs.config....Exa
50c0: 6d 70 6c 65 20 6f 66 20 67 65 6e 65 72 61 74 69 mple of generati
50d0: 6e 67 20 61 6e 64 20 75 73 69 6e 67 20 63 6f 6e ng and using con
50e0: 66 69 67 20 64 61 74 61 0a 2d 2d 2d 2d 2d 2d 2d fig data.-------
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 0a 6d 65 67 61 74 65 73 74 -------.megatest
5110: 20 2d 65 6e 76 63 61 70 20 6f 72 69 67 69 6e 61 -envcap origina
5120: 6c 0a 23 20 64 6f 20 73 6f 6d 65 20 73 74 75 66 l.# do some stuf
5130: 66 20 68 65 72 65 0a 6d 65 67 61 74 65 73 74 20 f here.megatest
5140: 2d 65 6e 76 63 61 70 20 6d 75 6e 67 65 64 0a 6d -envcap munged.m
5150: 65 67 61 74 65 73 74 20 2d 65 6e 76 64 65 6c 74 egatest -envdelt
5160: 61 20 6f 72 69 67 69 6e 61 6c 2d 6d 75 6e 67 65 a original-munge
5170: 64 20 2d 64 75 6d 70 6d 6f 64 65 20 69 6e 69 20 d -dumpmode ini
5180: 2d 6f 20 6d 6f 64 69 66 69 65 64 2e 63 6f 6e 66 -o modified.conf
5190: 69 67 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ig.-------------
51a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
51b0: 2d 0a 0a 54 68 65 6e 20 69 6e 20 72 75 6e 63 6f -..Then in runco
51c0: 6e 66 69 67 73 2e 63 6f 6e 66 69 67 0a 0a 2e 45 nfigs.config...E
51d0: 78 61 6d 70 6c 65 20 6f 66 20 75 73 69 6e 67 20 xample of using
51e0: 6d 6f 64 69 66 69 65 64 2e 63 6f 6e 66 69 67 20 modified.config
51f0: 69 6e 20 61 20 74 65 73 74 63 6f 6e 66 69 67 0a in a testconfig.
5200: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5210: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 63 --------------.c
5220: 61 74 20 74 65 73 74 63 6f 6e 66 69 67 0a 5b 70 at testconfig.[p
5230: 72 65 2d 6c 61 75 6e 63 68 2d 65 6e 76 2d 76 61 re-launch-env-va
5240: 72 73 5d 0a 5b 69 6e 63 6c 75 64 65 20 6d 6f 64 rs].[include mod
5250: 69 66 69 65 64 2e 63 6f 6e 66 69 67 5d 0a 2d 2d ified.config].--
5260: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
5270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4d 61 ------------..Ma
5280: 6e 61 67 69 6e 67 20 4f 6c 64 20 52 75 6e 73 0a naging Old Runs.
5290: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
52a0: 2d 0a 0a 49 74 20 69 73 20 6f 66 74 65 6e 20 64 -..It is often d
52b0: 65 73 69 72 65 64 20 74 6f 20 6b 65 65 70 20 73 esired to keep s
52c0: 6f 6d 65 20 6f 6c 64 65 72 20 72 75 6e 73 20 61 ome older runs a
52d0: 72 6f 75 6e 64 20 62 75 74 20 74 68 69 73 20 6d round but this m
52e0: 75 73 74 20 62 65 20 62 61 6c 61 6e 63 65 64 20 ust be balanced
52f0: 77 69 74 68 20 74 68 65 20 63 6f 73 74 73 20 6f with the costs o
5300: 66 20 64 69 73 6b 20 73 70 61 63 65 2e 0a 0a 2e f disk space....
5310: 20 55 73 65 20 2d 72 65 6d 6f 76 65 2d 6b 65 65 Use -remove-kee
5320: 70 0a 2e 20 55 73 65 20 2d 61 72 63 68 69 76 65 p.. Use -archive
5330: 20 28 63 61 6e 20 61 6c 73 6f 20 62 65 20 64 6f (can also be do
5340: 6e 65 20 66 72 6f 6d 20 74 68 65 20 2d 72 65 6d ne from the -rem
5350: 6f 76 65 2d 6b 65 65 70 20 69 6e 74 65 72 66 61 ove-keep interfa
5360: 63 65 29 0a 2e 20 75 73 65 20 2d 72 65 6d 6f 76 ce).. use -remov
5370: 65 2d 72 75 6e 73 20 77 69 74 68 20 2d 6b 65 65 e-runs with -kee
5380: 70 2d 72 65 63 6f 72 64 73 0a 0a 2e 46 6f 72 20 p-records...For
5390: 65 61 63 68 20 74 61 72 67 65 74 2c 20 72 65 6d each target, rem
53a0: 6f 76 65 20 61 6c 6c 20 72 75 6e 73 20 62 75 74 ove all runs but
53b0: 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 the most recent
53c0: 20 33 20 69 66 20 74 68 65 79 20 61 72 65 20 6f 3 if they are o
53d0: 76 65 72 20 31 20 77 65 65 6b 20 6f 6c 64 0a 2d ver 1 week old.-
53e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
53f0: 2d 2d 2d 2d 0a 23 20 75 73 65 20 2d 70 72 65 63 ----.# use -prec
5400: 6d 64 20 27 73 6c 65 65 70 20 35 3b 6e 62 66 61 md 'sleep 5;nbfa
5410: 6b 65 27 20 74 6f 20 6c 69 6d 69 74 20 6f 76 65 ke' to limit ove
5420: 72 6c 6f 61 64 69 6e 67 20 74 68 65 20 68 6f 73 rloading the hos
5430: 74 20 63 6f 6d 70 75 74 65 72 20 62 75 74 20 74 t computer but t
5440: 6f 20 61 6c 6c 6f 77 20 74 68 65 20 72 65 6d 6f o allow the remo
5450: 76 65 73 20 74 6f 20 72 75 6e 20 69 6e 20 70 61 ves to run in pa
5460: 72 61 6c 6c 65 6c 2e 0a 6d 65 67 61 74 65 73 74 rallel..megatest
5470: 20 2d 61 63 74 69 6f 6e 73 20 70 72 69 6e 74 2c -actions print,
5480: 72 65 6d 6f 76 65 2d 72 75 6e 73 20 2d 72 65 6d remove-runs -rem
5490: 6f 76 65 2d 6b 65 65 70 20 33 20 2d 74 61 72 67 ove-keep 3 -targ
54a0: 65 74 20 25 2f 25 2f 25 2f 25 20 2d 72 75 6e 6e et %/%/%/% -runn
54b0: 61 6d 65 20 25 20 2d 61 67 65 20 31 77 20 2d 70 ame % -age 1w -p
54c0: 72 65 63 6d 64 20 27 73 6c 65 65 70 20 35 3b 6e recmd 'sleep 5;n
54d0: 62 66 61 6b 65 27 22 0a 2d 2d 2d 2d 2d 2d 2d 2d bfake'".--------
54e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4e -------------..N
54f0: 65 73 74 65 64 20 52 75 6e 73 0a 2d 2d 2d 2d 2d ested Runs.-----
5500: 2d 2d 2d 2d 2d 2d 0a 0a 41 20 4d 65 67 61 74 65 ------..A Megate
5510: 73 74 20 74 65 73 74 20 63 61 6e 20 72 75 6e 20 st test can run
5520: 61 20 66 75 6c 6c 20 4d 65 67 61 74 65 73 74 20 a full Megatest
5530: 72 75 6e 20 69 6e 20 65 69 74 68 65 72 20 74 68 run in either th
5540: 65 20 73 61 6d 65 0a 4d 65 67 61 74 65 73 74 20 e same.Megatest
5550: 61 72 65 61 20 6f 72 20 69 6e 20 61 6e 6f 74 68 area or in anoth
5560: 65 72 20 61 72 65 61 2e 20 54 68 69 73 20 69 73 er area. This is
5570: 20 61 20 70 6f 77 65 72 66 75 6c 20 77 61 79 20 a powerful way
5580: 6f 66 20 63 68 61 69 6e 69 6e 67 0a 63 6f 6d 70 of chaining.comp
5590: 6c 65 78 20 73 75 69 74 65 73 20 6f 66 20 74 65 lex suites of te
55a0: 73 74 73 20 61 6e 64 20 6f 72 20 61 63 74 69 6f sts and or actio
55b0: 6e 73 2e 0a 0a 49 66 20 79 6f 75 20 61 72 65 20 ns...If you are
55c0: 6e 6f 74 20 75 73 69 6e 67 20 74 68 65 20 63 75 not using the cu
55d0: 72 72 65 6e 74 20 61 72 65 61 20 79 6f 75 20 63 rrent area you c
55e0: 61 6e 20 75 73 65 20 65 7a 73 74 65 70 73 20 74 an use ezsteps t
55f0: 6f 20 72 65 74 72 69 65 76 65 0a 61 6e 64 20 73 o retrieve.and s
5600: 65 74 75 70 20 74 68 65 20 73 75 62 2d 4d 65 67 etup the sub-Meg
5610: 61 74 65 73 74 20 72 75 6e 20 61 72 65 61 2e 0a atest run area..
5620: 0a 49 6e 20 74 68 65 20 74 65 73 74 63 6f 6e 66 .In the testconf
5630: 69 67 3a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ig:.------------
5640: 2d 2d 2d 0a 5b 73 75 62 72 75 6e 5d 0a 0a 23 20 ---.[subrun]..#
5650: 52 65 71 75 69 72 65 64 3a 20 77 61 69 74 20 66 Required: wait f
5660: 6f 72 20 74 68 65 20 72 75 6e 20 6f 72 20 6a 75 or the run or ju
5670: 73 74 20 6c 61 75 6e 63 68 20 69 74 0a 23 20 20 st launch it.#
5680: 20 20 20 20 20 20 20 20 20 69 66 20 6e 6f 20 74 if no t
5690: 68 65 6e 20 74 68 65 20 72 75 6e 20 77 69 6c 6c hen the run will
56a0: 20 62 65 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 be an automatic
56b0: 20 50 41 53 53 20 69 72 72 65 73 70 65 63 74 69 PASS irrespecti
56c0: 76 65 20 6f 66 20 74 68 65 20 61 63 74 75 61 6c ve of the actual
56d0: 20 72 65 73 75 6c 74 0a 72 75 6e 2d 77 61 69 74 result.run-wait
56e0: 20 79 65 73 7c 6e 6f 0a 0a 23 20 4f 70 74 69 6f yes|no..# Optio
56f0: 6e 61 6c 3a 20 77 68 65 72 65 20 74 6f 20 65 78 nal: where to ex
5700: 65 63 75 74 65 20 74 68 65 20 72 75 6e 2e 20 44 ecute the run. D
5710: 65 66 61 75 6c 74 20 69 73 20 74 68 65 20 63 75 efault is the cu
5720: 72 72 65 6e 74 20 72 75 6e 61 72 65 61 0a 72 75 rrent runarea.ru
5730: 6e 2d 61 72 65 61 20 2f 73 6f 6d 65 2f 70 61 74 n-area /some/pat
5740: 68 2f 74 6f 2f 6d 65 67 61 74 65 73 74 2f 61 72 h/to/megatest/ar
5750: 65 61 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 ea..# Optional:
5760: 6d 65 74 68 6f 64 20 74 6f 20 75 73 65 20 74 6f method to use to
5770: 20 64 65 74 65 72 6d 69 6e 65 20 70 61 73 73 2f determine pass/
5780: 66 61 69 6c 20 73 74 61 74 75 73 20 6f 66 20 74 fail status of t
5790: 68 65 20 72 75 6e 0a 23 20 20 20 61 75 74 6f 20 he run.# auto
57a0: 28 64 65 66 61 75 6c 74 29 20 2d 20 72 6f 6c 6c (default) - roll
57b0: 20 75 70 20 74 68 65 20 6e 65 74 20 73 74 61 74 up the net stat
57c0: 65 2f 73 74 61 74 75 73 20 6f 66 20 74 68 65 20 e/status of the
57d0: 73 75 62 2d 72 75 6e 0a 23 20 20 20 6c 6f 67 70 sub-run.# logp
57e0: 72 6f 20 20 20 20 20 20 20 20 20 2d 20 75 73 65 ro - use
57f0: 20 74 68 65 20 70 72 6f 76 69 64 65 64 20 6c 6f the provided lo
5800: 67 70 72 6f 20 72 75 6c 65 73 2c 20 68 61 70 70 gpro rules, happ
5810: 65 6e 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c ens automaticall
5820: 79 20 69 66 20 74 68 65 72 65 20 69 73 20 61 20 y if there is a
5830: 6c 6f 67 70 72 6f 20 73 65 63 74 69 6f 6e 0a 23 logpro section.#
5840: 20 70 61 73 73 66 61 69 6c 20 61 75 74 6f 7c 6c passfail auto|l
5850: 6f 67 70 72 6f 0a 23 20 45 78 61 6d 70 6c 65 20 ogpro.# Example
5860: 6f 66 20 6c 6f 67 70 72 6f 3a 0a 70 61 73 73 66 of logpro:.passf
5870: 61 69 6c 20 6c 6f 67 70 72 6f 0a 0a 23 20 4f 70 ail logpro..# Op
5880: 74 69 6f 6e 61 6c 3a 20 0a 6c 6f 67 70 72 6f 20 tional: .logpro
5890: 3b 3b 20 69 66 20 74 68 69 73 20 73 65 63 74 69 ;; if this secti
58a0: 6f 6e 20 65 78 69 73 74 73 20 74 68 65 6e 20 6c on exists then l
58b0: 6f 67 70 72 6f 20 69 73 20 75 73 65 64 20 74 6f ogpro is used to
58c0: 20 64 65 74 65 72 6d 69 6e 65 20 70 61 73 73 2f determine pass/
58d0: 66 61 69 6c 0a 20 20 28 65 78 70 65 63 74 3a 72 fail. (expect:r
58e0: 65 71 75 69 72 65 64 20 69 6e 20 22 4c 6f 67 46 equired in "LogF
58f0: 69 6c 65 42 6f 64 79 22 20 3e 3d 20 31 20 22 41 ileBody" >= 1 "A
5900: 74 20 6c 65 61 73 74 20 6f 6e 65 20 70 61 73 73 t least one pass
5910: 22 20 23 2f 50 41 53 53 2f 29 0a 20 20 28 65 78 " #/PASS/). (ex
5920: 70 65 63 74 3a 66 61 69 6c 20 20 20 20 20 69 6e pect:fail in
5930: 20 22 4c 6f 67 46 69 6c 65 42 6f 64 79 22 20 20 "LogFileBody"
5940: 3d 20 30 20 22 4e 6f 20 46 41 49 4c 73 20 61 6c = 0 "No FAILs al
5950: 6c 6f 77 65 64 22 20 20 23 2f 46 41 49 4c 2f 29 lowed" #/FAIL/)
5960: 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 74 61 ..# Optional: ta
5970: 72 67 65 74 20 74 72 61 6e 73 6c 61 74 6f 72 2c rget translator,
5980: 20 64 65 66 61 75 6c 74 20 69 73 20 74 6f 20 75 default is to u
5990: 73 65 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 se the parent ta
59a0: 72 67 65 74 0a 74 61 72 67 65 74 20 23 7b 73 68 rget.target #{sh
59b0: 65 6c 6c 20 73 6f 6d 65 73 63 72 69 70 74 2e 73 ell somescript.s
59c0: 68 7d 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 h}..# Optional:
59d0: 72 75 6e 6e 61 6d 65 20 74 72 61 6e 73 6c 61 74 runname translat
59e0: 6f 72 2f 67 65 6e 65 72 61 74 6f 72 2c 20 64 65 or/generator, de
59f0: 66 61 75 6c 74 20 69 73 20 74 6f 20 75 73 65 20 fault is to use
5a00: 74 68 65 20 70 61 72 65 6e 74 20 72 75 6e 6e 61 the parent runna
5a10: 6d 65 0a 72 75 6e 2d 6e 61 6d 65 20 23 7b 73 6f me.run-name #{so
5a20: 6d 65 73 63 72 69 70 74 2e 73 68 7d 0a 0a 23 20 mescript.sh}..#
5a30: 4f 70 74 69 6f 6e 61 6c 3a 20 74 65 73 74 70 61 Optional: testpa
5a40: 74 74 20 73 70 65 63 2c 20 64 65 66 61 75 6c 74 tt spec, default
5a50: 20 69 73 20 74 6f 20 66 69 72 73 74 20 6c 6f 6f is to first loo
5a60: 6b 20 66 6f 72 20 54 45 53 54 50 41 54 54 20 73 k for TESTPATT s
5a70: 70 65 63 20 66 72 6f 6d 20 72 75 6e 63 6f 6e 66 pec from runconf
5a80: 69 67 73 20 75 6e 6c 65 73 73 20 74 68 65 72 65 igs unless there
5a90: 20 69 73 20 61 20 63 6f 6e 74 6f 75 72 20 73 70 is a contour sp
5aa0: 65 63 0a 74 65 73 74 2d 70 61 74 74 20 25 2f 69 ec.test-patt %/i
5ab0: 74 65 6d 31 2c 74 65 73 74 32 0a 0a 23 20 4f 70 tem1,test2..# Op
5ac0: 74 69 6f 6e 61 6c 3a 20 63 6f 6e 74 6f 75 72 20 tional: contour
5ad0: 73 70 65 63 2c 20 75 73 65 20 74 68 65 20 6e 61 spec, use the na
5ae0: 6d 65 64 20 63 6f 6e 74 6f 75 72 20 66 72 6f 6d med contour from
5af0: 20 74 68 65 20 6d 65 67 61 74 65 73 74 2e 63 6f the megatest.co
5b00: 6e 66 69 67 20 63 6f 6e 74 6f 75 72 20 73 70 65 nfig contour spe
5b10: 63 0a 63 6f 6e 74 6f 75 72 20 63 6f 6e 74 6f 75 c.contour contou
5b20: 72 6e 61 6d 65 20 23 23 23 20 4e 4f 54 45 3a 20 rname ### NOTE:
5b30: 4e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 Not implemented
5b40: 79 65 74 21 20 4c 65 74 20 75 73 20 6b 6e 6f 77 yet! Let us know
5b50: 20 69 66 20 79 6f 75 20 6e 65 65 64 20 74 68 69 if you need thi
5b60: 73 20 66 65 61 74 75 72 65 2e 0a 0a 23 20 4f 70 s feature...# Op
5b70: 74 69 6f 6e 61 6c 3a 20 6d 6f 64 65 2d 70 61 74 tional: mode-pat
5b80: 74 2c 20 75 73 65 20 74 68 69 73 20 73 70 65 63 t, use this spec
5b90: 20 66 6f 72 20 74 65 73 74 70 61 74 74 20 66 72 for testpatt fr
5ba0: 6f 6d 20 72 75 6e 63 6f 6e 66 69 67 73 0a 6d 6f om runconfigs.mo
5bb0: 64 65 2d 70 61 74 74 20 54 45 53 54 50 41 54 54 de-patt TESTPATT
5bc0: 0a 0a 23 20 4f 70 74 69 6f 6e 61 6c 3a 20 74 61 ..# Optional: ta
5bd0: 67 2d 65 78 70 72 2c 20 75 73 65 20 74 68 69 73 g-expr, use this
5be0: 20 74 61 67 2d 65 78 70 72 20 74 6f 20 73 65 6c tag-expr to sel
5bf0: 65 63 74 20 74 65 73 74 73 0a 74 61 67 2d 65 78 ect tests.tag-ex
5c00: 70 72 20 71 75 69 63 6b 0a 0a 23 20 4f 70 74 69 pr quick..# Opti
5c10: 6f 6e 61 6c 3a 20 28 6e 6f 74 20 79 65 74 20 69 onal: (not yet i
5c20: 6d 70 6c 65 6d 65 6e 74 65 64 2c 20 72 65 6d 6f mplemented, remo
5c30: 76 65 2d 72 75 6e 73 20 69 73 20 61 6c 77 61 79 ve-runs is alway
5c40: 73 20 70 72 6f 70 61 67 61 74 65 64 20 61 74 20 s propagated at
5c50: 74 68 69 73 20 74 69 6d 65 29 2c 20 70 72 6f 70 this time), prop
5c60: 61 67 61 74 65 20 74 68 65 73 65 20 61 63 74 69 agate these acti
5c70: 6f 6e 73 20 66 72 6f 6d 20 74 68 65 20 70 61 72 ons from the par
5c80: 65 6e 74 0a 23 20 20 20 20 20 20 20 20 20 20 20 ent.#
5c90: 74 65 73 74 0a 23 20 20 20 4e 6f 74 65 2f 2f 20 test.# Note//
5ca0: 64 65 66 61 75 6c 74 20 69 73 20 25 20 66 6f 72 default is % for
5cb0: 20 61 6c 6c 0a 70 72 6f 70 61 67 61 74 65 20 72 all.propagate r
5cc0: 65 6d 6f 76 65 2d 72 75 6e 73 20 61 72 63 68 69 emove-runs archi
5cd0: 76 65 20 2e 2e 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d ve .....--------
5ce0: 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 72 6f 67 72 61 6d -------..Program
5cf0: 6d 69 6e 67 20 41 50 49 0a 2d 2d 2d 2d 2d 2d 2d ming API.-------
5d00: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 73 65 20 --------..These
5d10: 72 6f 75 74 69 6e 65 73 20 63 61 6e 20 62 65 20 routines can be
5d20: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 20 called from the
5d30: 6d 65 67 61 74 65 73 74 20 72 65 70 6c 2e 20 0a megatest repl. .
5d40: 0a 2e 41 50 49 20 4b 65 79 73 20 52 65 6c 61 74 ..API Keys Relat
5d50: 65 64 20 43 61 6c 6c 73 0a 5b 77 69 64 74 68 3d ed Calls.[width=
5d60: 22 37 30 25 22 2c 63 6f 6c 73 3d 22 5e 2c 32 6d "70%",cols="^,2m
5d70: 2c 32 6d 2c 32 6d 22 2c 66 72 61 6d 65 3d 22 74 ,2m,2m",frame="t
5d80: 6f 70 62 6f 74 22 2c 6f 70 74 69 6f 6e 73 3d 22 opbot",options="
5d90: 68 65 61 64 65 72 2c 66 6f 6f 74 65 72 22 5d 0a header,footer"].
5da0: 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d |===============
5db0: 3d 3d 3d 3d 3d 3d 3d 0a 7c 41 50 49 20 43 61 6c =======.|API Cal
5dc0: 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l
5dd0: 20 20 20 20 20 20 20 20 20 7c 20 50 75 72 70 6f | Purpo
5de0: 73 65 20 63 6f 6d 6d 65 6e 74 73 20 20 20 7c 20 se comments |
5df0: 52 65 74 75 72 6e 73 20 20 20 20 20 20 20 20 20 Returns
5e00: 20 20 20 20 20 20 20 20 7c 20 43 6f 6d 6d 65 6e | Commen
5e10: 74 73 0a 7c 28 72 6d 74 3a 67 65 74 2d 6b 65 79 ts.|(rmt:get-key
5e20: 73 20 72 75 6e 2d 69 64 29 20 20 20 20 20 20 20 s run-id)
5e30: 20 20 20 20 7c 20 20 20 20 20 20 20 20 20 20 20 |
5e40: 20 20 20 20 20 20 20 20 20 7c 20 28 20 6b 65 79 | ( key
5e50: 31 20 6b 65 79 32 20 2e 2e 2e 20 29 20 20 20 20 1 key2 ... )
5e60: 20 20 20 7c 20 0a 7c 20 28 72 6d 74 3a 67 65 74 | .| (rmt:get
5e70: 2d 6b 65 79 2d 76 61 6c 2d 70 61 69 72 73 20 72 -key-val-pairs r
5e80: 75 6e 2d 69 64 29 20 7c 20 20 20 20 20 20 20 20 un-id) |
5e90: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 23 74 | #t
5ea0: 3d 73 75 63 63 65 73 73 2f 23 66 3d 66 61 69 6c =success/#f=fail
5eb0: 20 20 20 20 20 20 7c 20 57 6f 72 6b 73 20 6f 6e | Works on
5ec0: 6c 79 20 69 66 20 74 68 65 20 73 65 72 76 65 72 ly if the server
5ed0: 20 69 73 20 73 74 69 6c 6c 20 72 65 61 63 68 61 is still reacha
5ee0: 62 6c 65 0a 7c 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ble.|===========
5ef0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 0a 3a 6e ===========...:n
5f00: 75 6d 62 65 72 65 64 21 3a 0a 0a 5a 20 63 39 64 umbered!:..Z c9d
5f10: 63 37 37 33 36 38 38 64 64 64 30 66 65 39 66 36 c773688ddd0fe9f6
5f20: 61 66 36 62 37 30 63 65 39 36 36 62 36 0a af6b70ce966b6.