test: add test for experimental verify with loops and time_based options
[fio.git] / t / run-fio-tests.py
1 #!/usr/bin/env python3
2 # SPDX-License-Identifier: GPL-2.0-only
3 #
4 # Copyright (c) 2019 Western Digital Corporation or its affiliates.
5 #
6 """
7 # run-fio-tests.py
8 #
9 # Automate running of fio tests
10 #
11 # USAGE
12 # python3 run-fio-tests.py [-r fio-root] [-f fio-path] [-a artifact-root]
13 #                           [--skip # # #...] [--run-only # # #...]
14 #
15 #
16 # EXAMPLE
17 # # git clone git://git.kernel.dk/fio.git
18 # # cd fio
19 # # make -j
20 # # python3 t/run-fio-tests.py
21 #
22 #
23 # REQUIREMENTS
24 # - Python 3.5 (subprocess.run)
25 # - Linux (libaio ioengine, zbd tests, etc)
26 # - The artifact directory must be on a file system that accepts 512-byte IO
27 #   (t0002, t0003, t0004).
28 # - The artifact directory needs to be on an SSD. Otherwise tests that carry
29 #   out file-based IO will trigger a timeout (t0006).
30 # - 4 CPUs (t0009)
31 # - SciPy (steadystate_tests.py)
32 # - libzbc (zbd tests)
33 # - root privileges (zbd test)
34 # - kernel 4.19 or later for zoned null block devices (zbd tests)
35 # - CUnit support (unittests)
36 #
37 """
38
39 #
40 # TODO  run multiple tests simultaneously
41 # TODO  Add sgunmap tests (requires SAS SSD)
42 #
43
44 import os
45 import sys
46 import json
47 import time
48 import shutil
49 import logging
50 import argparse
51 import platform
52 import traceback
53 import subprocess
54 import multiprocessing
55 from pathlib import Path
56
57
58 class FioTest():
59     """Base for all fio tests."""
60
61     def __init__(self, exe_path, parameters, success):
62         self.exe_path = exe_path
63         self.parameters = parameters
64         self.success = success
65         self.output = {}
66         self.artifact_root = None
67         self.testnum = None
68         self.test_dir = None
69         self.passed = True
70         self.failure_reason = ''
71         self.command_file = None
72         self.stdout_file = None
73         self.stderr_file = None
74         self.exitcode_file = None
75
76     def setup(self, artifact_root, testnum):
77         """Setup instance variables for test."""
78
79         self.artifact_root = artifact_root
80         self.testnum = testnum
81         self.test_dir = os.path.join(artifact_root, "{:04d}".format(testnum))
82         if not os.path.exists(self.test_dir):
83             os.mkdir(self.test_dir)
84
85         self.command_file = os.path.join(
86             self.test_dir,
87             "{0}.command".format(os.path.basename(self.exe_path)))
88         self.stdout_file = os.path.join(
89             self.test_dir,
90             "{0}.stdout".format(os.path.basename(self.exe_path)))
91         self.stderr_file = os.path.join(
92             self.test_dir,
93             "{0}.stderr".format(os.path.basename(self.exe_path)))
94         self.exitcode_file = os.path.join(
95             self.test_dir,
96             "{0}.exitcode".format(os.path.basename(self.exe_path)))
97
98     def run(self):
99         """Run the test."""
100
101         raise NotImplementedError()
102
103     def check_result(self):
104         """Check test results."""
105
106         raise NotImplementedError()
107
108
109 class FioExeTest(FioTest):
110     """Test consists of an executable binary or script"""
111
112     def __init__(self, exe_path, parameters, success):
113         """Construct a FioExeTest which is a FioTest consisting of an
114         executable binary or script.
115
116         exe_path:       location of executable binary or script
117         parameters:     list of parameters for executable
118         success:        Definition of test success
119         """
120
121         FioTest.__init__(self, exe_path, parameters, success)
122
123     def run(self):
124         """Execute the binary or script described by this instance."""
125
126         command = [self.exe_path] + self.parameters
127         command_file = open(self.command_file, "w+")
128         command_file.write("%s\n" % command)
129         command_file.close()
130
131         stdout_file = open(self.stdout_file, "w+")
132         stderr_file = open(self.stderr_file, "w+")
133         exitcode_file = open(self.exitcode_file, "w+")
134         try:
135             proc = None
136             # Avoid using subprocess.run() here because when a timeout occurs,
137             # fio will be stopped with SIGKILL. This does not give fio a
138             # chance to clean up and means that child processes may continue
139             # running and submitting IO.
140             proc = subprocess.Popen(command,
141                                     stdout=stdout_file,
142                                     stderr=stderr_file,
143                                     cwd=self.test_dir,
144                                     universal_newlines=True)
145             proc.communicate(timeout=self.success['timeout'])
146             exitcode_file.write('{0}\n'.format(proc.returncode))
147             logging.debug("Test %d: return code: %d", self.testnum, proc.returncode)
148             self.output['proc'] = proc
149         except subprocess.TimeoutExpired:
150             proc.terminate()
151             proc.communicate()
152             assert proc.poll()
153             self.output['failure'] = 'timeout'
154         except Exception:
155             if proc:
156                 if not proc.poll():
157                     proc.terminate()
158                     proc.communicate()
159             self.output['failure'] = 'exception'
160             self.output['exc_info'] = sys.exc_info()
161         finally:
162             stdout_file.close()
163             stderr_file.close()
164             exitcode_file.close()
165
166     def check_result(self):
167         """Check results of test run."""
168
169         if 'proc' not in self.output:
170             if self.output['failure'] == 'timeout':
171                 self.failure_reason = "{0} timeout,".format(self.failure_reason)
172             else:
173                 assert self.output['failure'] == 'exception'
174                 self.failure_reason = '{0} exception: {1}, {2}'.format(
175                     self.failure_reason, self.output['exc_info'][0],
176                     self.output['exc_info'][1])
177
178             self.passed = False
179             return
180
181         if 'zero_return' in self.success:
182             if self.success['zero_return']:
183                 if self.output['proc'].returncode != 0:
184                     self.passed = False
185                     self.failure_reason = "{0} non-zero return code,".format(self.failure_reason)
186             else:
187                 if self.output['proc'].returncode == 0:
188                     self.failure_reason = "{0} zero return code,".format(self.failure_reason)
189                     self.passed = False
190
191         stderr_size = os.path.getsize(self.stderr_file)
192         if 'stderr_empty' in self.success:
193             if self.success['stderr_empty']:
194                 if stderr_size != 0:
195                     self.failure_reason = "{0} stderr not empty,".format(self.failure_reason)
196                     self.passed = False
197             else:
198                 if stderr_size == 0:
199                     self.failure_reason = "{0} stderr empty,".format(self.failure_reason)
200                     self.passed = False
201
202
203 class FioJobTest(FioExeTest):
204     """Test consists of a fio job"""
205
206     def __init__(self, fio_path, fio_job, success, fio_pre_job=None,
207                  fio_pre_success=None, output_format="normal"):
208         """Construct a FioJobTest which is a FioExeTest consisting of a
209         single fio job file with an optional setup step.
210
211         fio_path:           location of fio executable
212         fio_job:            location of fio job file
213         success:            Definition of test success
214         fio_pre_job:        fio job for preconditioning
215         fio_pre_success:    Definition of test success for fio precon job
216         output_format:      normal (default), json, jsonplus, or terse
217         """
218
219         self.fio_job = fio_job
220         self.fio_pre_job = fio_pre_job
221         self.fio_pre_success = fio_pre_success if fio_pre_success else success
222         self.output_format = output_format
223         self.precon_failed = False
224         self.json_data = None
225         self.fio_output = "{0}.output".format(os.path.basename(self.fio_job))
226         self.fio_args = [
227             "--max-jobs=16",
228             "--output-format={0}".format(self.output_format),
229             "--output={0}".format(self.fio_output),
230             self.fio_job,
231             ]
232         FioExeTest.__init__(self, fio_path, self.fio_args, success)
233
234     def setup(self, artifact_root, testnum):
235         """Setup instance variables for fio job test."""
236
237         super(FioJobTest, self).setup(artifact_root, testnum)
238
239         self.command_file = os.path.join(
240             self.test_dir,
241             "{0}.command".format(os.path.basename(self.fio_job)))
242         self.stdout_file = os.path.join(
243             self.test_dir,
244             "{0}.stdout".format(os.path.basename(self.fio_job)))
245         self.stderr_file = os.path.join(
246             self.test_dir,
247             "{0}.stderr".format(os.path.basename(self.fio_job)))
248         self.exitcode_file = os.path.join(
249             self.test_dir,
250             "{0}.exitcode".format(os.path.basename(self.fio_job)))
251
252     def run_pre_job(self):
253         """Run fio job precondition step."""
254
255         precon = FioJobTest(self.exe_path, self.fio_pre_job,
256                             self.fio_pre_success,
257                             output_format=self.output_format)
258         precon.setup(self.artifact_root, self.testnum)
259         precon.run()
260         precon.check_result()
261         self.precon_failed = not precon.passed
262         self.failure_reason = precon.failure_reason
263
264     def run(self):
265         """Run fio job test."""
266
267         if self.fio_pre_job:
268             self.run_pre_job()
269
270         if not self.precon_failed:
271             super(FioJobTest, self).run()
272         else:
273             logging.debug("Test %d: precondition step failed", self.testnum)
274
275     @classmethod
276     def get_file(cls, filename):
277         """Safely read a file."""
278         file_data = ''
279         success = True
280
281         try:
282             with open(filename, "r") as output_file:
283                 file_data = output_file.read()
284         except OSError:
285             success = False
286
287         return file_data, success
288
289     def get_file_fail(self, filename):
290         """Safely read a file and fail the test upon error."""
291         file_data = None
292
293         try:
294             with open(filename, "r") as output_file:
295                 file_data = output_file.read()
296         except OSError:
297             self.failure_reason += " unable to read file {0}".format(filename)
298             self.passed = False
299
300         return file_data
301
302     def check_result(self):
303         """Check fio job results."""
304
305         if self.precon_failed:
306             self.passed = False
307             self.failure_reason = "{0} precondition step failed,".format(self.failure_reason)
308             return
309
310         super(FioJobTest, self).check_result()
311
312         if not self.passed:
313             return
314
315         if 'json' not in self.output_format:
316             return
317
318         file_data = self.get_file_fail(os.path.join(self.test_dir, self.fio_output))
319         if not file_data:
320             return
321
322         #
323         # Sometimes fio informational messages are included at the top of the
324         # JSON output, especially under Windows. Try to decode output as JSON
325         # data, skipping everything until the first {
326         #
327         lines = file_data.splitlines()
328         file_data = '\n'.join(lines[lines.index("{"):])
329         try:
330             self.json_data = json.loads(file_data)
331         except json.JSONDecodeError:
332             self.failure_reason = "{0} unable to decode JSON data,".format(self.failure_reason)
333             self.passed = False
334
335
336 class FioJobTest_t0005(FioJobTest):
337     """Test consists of fio test job t0005
338     Confirm that read['io_kbytes'] == write['io_kbytes'] == 102400"""
339
340     def check_result(self):
341         super(FioJobTest_t0005, self).check_result()
342
343         if not self.passed:
344             return
345
346         if self.json_data['jobs'][0]['read']['io_kbytes'] != 102400:
347             self.failure_reason = "{0} bytes read mismatch,".format(self.failure_reason)
348             self.passed = False
349         if self.json_data['jobs'][0]['write']['io_kbytes'] != 102400:
350             self.failure_reason = "{0} bytes written mismatch,".format(self.failure_reason)
351             self.passed = False
352
353
354 class FioJobTest_t0006(FioJobTest):
355     """Test consists of fio test job t0006
356     Confirm that read['io_kbytes'] ~ 2*write['io_kbytes']"""
357
358     def check_result(self):
359         super(FioJobTest_t0006, self).check_result()
360
361         if not self.passed:
362             return
363
364         ratio = self.json_data['jobs'][0]['read']['io_kbytes'] \
365             / self.json_data['jobs'][0]['write']['io_kbytes']
366         logging.debug("Test %d: ratio: %f", self.testnum, ratio)
367         if ratio < 1.99 or ratio > 2.01:
368             self.failure_reason = "{0} read/write ratio mismatch,".format(self.failure_reason)
369             self.passed = False
370
371
372 class FioJobTest_t0007(FioJobTest):
373     """Test consists of fio test job t0007
374     Confirm that read['io_kbytes'] = 87040"""
375
376     def check_result(self):
377         super(FioJobTest_t0007, self).check_result()
378
379         if not self.passed:
380             return
381
382         if self.json_data['jobs'][0]['read']['io_kbytes'] != 87040:
383             self.failure_reason = "{0} bytes read mismatch,".format(self.failure_reason)
384             self.passed = False
385
386
387 class FioJobTest_t0008(FioJobTest):
388     """Test consists of fio test job t0008
389     Confirm that read['io_kbytes'] = 32768 and that
390                 write['io_kbytes'] ~ 16568
391
392     I did runs with fio-ae2fafc8 and saw write['io_kbytes'] values of
393     16585, 16588. With two runs of fio-3.16 I obtained 16568"""
394
395     def check_result(self):
396         super(FioJobTest_t0008, self).check_result()
397
398         if not self.passed:
399             return
400
401         ratio = self.json_data['jobs'][0]['write']['io_kbytes'] / 16568
402         logging.debug("Test %d: ratio: %f", self.testnum, ratio)
403
404         if ratio < 0.99 or ratio > 1.01:
405             self.failure_reason = "{0} bytes written mismatch,".format(self.failure_reason)
406             self.passed = False
407         if self.json_data['jobs'][0]['read']['io_kbytes'] != 32768:
408             self.failure_reason = "{0} bytes read mismatch,".format(self.failure_reason)
409             self.passed = False
410
411
412 class FioJobTest_t0009(FioJobTest):
413     """Test consists of fio test job t0009
414     Confirm that runtime >= 60s"""
415
416     def check_result(self):
417         super(FioJobTest_t0009, self).check_result()
418
419         if not self.passed:
420             return
421
422         logging.debug('Test %d: elapsed: %d', self.testnum, self.json_data['jobs'][0]['elapsed'])
423
424         if self.json_data['jobs'][0]['elapsed'] < 60:
425             self.failure_reason = "{0} elapsed time mismatch,".format(self.failure_reason)
426             self.passed = False
427
428
429 class FioJobTest_t0012(FioJobTest):
430     """Test consists of fio test job t0012
431     Confirm ratios of job iops are 1:5:10
432     job1,job2,job3 respectively"""
433
434     def check_result(self):
435         super(FioJobTest_t0012, self).check_result()
436
437         if not self.passed:
438             return
439
440         iops_files = []
441         for i in range(1, 4):
442             filename = os.path.join(self.test_dir, "{0}_iops.{1}.log".format(os.path.basename(
443                 self.fio_job), i))
444             file_data = self.get_file_fail(filename)
445             if not file_data:
446                 return
447
448             iops_files.append(file_data.splitlines())
449
450         # there are 9 samples for job1 and job2, 4 samples for job3
451         iops1 = 0.0
452         iops2 = 0.0
453         iops3 = 0.0
454         for i in range(9):
455             iops1 = iops1 + float(iops_files[0][i].split(',')[1])
456             iops2 = iops2 + float(iops_files[1][i].split(',')[1])
457             iops3 = iops3 + float(iops_files[2][i].split(',')[1])
458
459             ratio1 = iops3/iops2
460             ratio2 = iops3/iops1
461             logging.debug("sample {0}: job1 iops={1} job2 iops={2} job3 iops={3} " \
462                 "job3/job2={4:.3f} job3/job1={5:.3f}".format(i, iops1, iops2, iops3, ratio1,
463                                                              ratio2))
464
465         # test job1 and job2 succeeded to recalibrate
466         if ratio1 < 1 or ratio1 > 3 or ratio2 < 7 or ratio2 > 13:
467             self.failure_reason += " iops ratio mismatch iops1={0} iops2={1} iops3={2} " \
468                 "expected r1~2 r2~10 got r1={3:.3f} r2={4:.3f},".format(iops1, iops2, iops3,
469                                                                         ratio1, ratio2)
470             self.passed = False
471             return
472
473
474 class FioJobTest_t0014(FioJobTest):
475     """Test consists of fio test job t0014
476         Confirm that job1_iops / job2_iops ~ 1:2 for entire duration
477         and that job1_iops / job3_iops ~ 1:3 for first half of duration.
478
479     The test is about making sure the flow feature can
480     re-calibrate the activity dynamically"""
481
482     def check_result(self):
483         super(FioJobTest_t0014, self).check_result()
484
485         if not self.passed:
486             return
487
488         iops_files = []
489         for i in range(1, 4):
490             filename = os.path.join(self.test_dir, "{0}_iops.{1}.log".format(os.path.basename(
491                 self.fio_job), i))
492             file_data = self.get_file_fail(filename)
493             if not file_data:
494                 return
495
496             iops_files.append(file_data.splitlines())
497
498         # there are 9 samples for job1 and job2, 4 samples for job3
499         iops1 = 0.0
500         iops2 = 0.0
501         iops3 = 0.0
502         for i in range(9):
503             if i < 4:
504                 iops3 = iops3 + float(iops_files[2][i].split(',')[1])
505             elif i == 4:
506                 ratio1 = iops1 / iops2
507                 ratio2 = iops1 / iops3
508
509
510                 if ratio1 < 0.43 or ratio1 > 0.57 or ratio2 < 0.21 or ratio2 > 0.45:
511                     self.failure_reason += " iops ratio mismatch iops1={0} iops2={1} iops3={2} " \
512                                            "expected r1~0.5 r2~0.33 got r1={3:.3f} r2={4:.3f},".format(
513                                                iops1, iops2, iops3, ratio1, ratio2)
514                     self.passed = False
515
516             iops1 = iops1 + float(iops_files[0][i].split(',')[1])
517             iops2 = iops2 + float(iops_files[1][i].split(',')[1])
518
519             ratio1 = iops1/iops2
520             ratio2 = iops1/iops3
521             logging.debug("sample {0}: job1 iops={1} job2 iops={2} job3 iops={3} " \
522                           "job1/job2={4:.3f} job1/job3={5:.3f}".format(i, iops1, iops2, iops3,
523                                                                        ratio1, ratio2))
524
525         # test job1 and job2 succeeded to recalibrate
526         if ratio1 < 0.43 or ratio1 > 0.57:
527             self.failure_reason += " iops ratio mismatch iops1={0} iops2={1} expected ratio~0.5 " \
528                                    "got ratio={2:.3f},".format(iops1, iops2, ratio1)
529             self.passed = False
530             return
531
532
533 class FioJobTest_t0015(FioJobTest):
534     """Test consists of fio test jobs t0015 and t0016
535     Confirm that mean(slat) + mean(clat) = mean(tlat)"""
536
537     def check_result(self):
538         super(FioJobTest_t0015, self).check_result()
539
540         if not self.passed:
541             return
542
543         slat = self.json_data['jobs'][0]['read']['slat_ns']['mean']
544         clat = self.json_data['jobs'][0]['read']['clat_ns']['mean']
545         tlat = self.json_data['jobs'][0]['read']['lat_ns']['mean']
546         logging.debug('Test %d: slat %f, clat %f, tlat %f', self.testnum, slat, clat, tlat)
547
548         if abs(slat + clat - tlat) > 1:
549             self.failure_reason = "{0} slat {1} + clat {2} = {3} != tlat {4},".format(
550                 self.failure_reason, slat, clat, slat+clat, tlat)
551             self.passed = False
552
553
554 class FioJobTest_t0019(FioJobTest):
555     """Test consists of fio test job t0019
556     Confirm that all offsets were touched sequentially"""
557
558     def check_result(self):
559         super(FioJobTest_t0019, self).check_result()
560
561         bw_log_filename = os.path.join(self.test_dir, "test_bw.log")
562         file_data = self.get_file_fail(bw_log_filename)
563         if not file_data:
564             return
565
566         log_lines = file_data.split('\n')
567
568         prev = -4096
569         for line in log_lines:
570             if len(line.strip()) == 0:
571                 continue
572             cur = int(line.split(',')[4])
573             if cur - prev != 4096:
574                 self.passed = False
575                 self.failure_reason = "offsets {0}, {1} not sequential".format(prev, cur)
576                 return
577             prev = cur
578
579         if cur/4096 != 255:
580             self.passed = False
581             self.failure_reason = "unexpected last offset {0}".format(cur)
582
583
584 class FioJobTest_t0020(FioJobTest):
585     """Test consists of fio test jobs t0020 and t0021
586     Confirm that almost all offsets were touched non-sequentially"""
587
588     def check_result(self):
589         super(FioJobTest_t0020, self).check_result()
590
591         bw_log_filename = os.path.join(self.test_dir, "test_bw.log")
592         file_data = self.get_file_fail(bw_log_filename)
593         if not file_data:
594             return
595
596         log_lines = file_data.split('\n')
597
598         seq_count = 0
599         offsets = set()
600
601         prev = int(log_lines[0].split(',')[4])
602         for line in log_lines[1:]:
603             offsets.add(prev/4096)
604             if len(line.strip()) == 0:
605                 continue
606             cur = int(line.split(',')[4])
607             if cur - prev == 4096:
608                 seq_count += 1
609             prev = cur
610
611         # 10 is an arbitrary threshold
612         if seq_count > 10:
613             self.passed = False
614             self.failure_reason = "too many ({0}) consecutive offsets".format(seq_count)
615
616         if len(offsets) != 256:
617             self.passed = False
618             self.failure_reason += " number of offsets is {0} instead of 256".format(len(offsets))
619
620         for i in range(256):
621             if not i in offsets:
622                 self.passed = False
623                 self.failure_reason += " missing offset {0}".format(i*4096)
624
625
626 class FioJobTest_t0022(FioJobTest):
627     """Test consists of fio test job t0022"""
628
629     def check_result(self):
630         super(FioJobTest_t0022, self).check_result()
631
632         bw_log_filename = os.path.join(self.test_dir, "test_bw.log")
633         file_data = self.get_file_fail(bw_log_filename)
634         if not file_data:
635             return
636
637         log_lines = file_data.split('\n')
638
639         filesize = 1024*1024
640         bs = 4096
641         seq_count = 0
642         offsets = set()
643
644         prev = int(log_lines[0].split(',')[4])
645         for line in log_lines[1:]:
646             offsets.add(prev/bs)
647             if len(line.strip()) == 0:
648                 continue
649             cur = int(line.split(',')[4])
650             if cur - prev == bs:
651                 seq_count += 1
652             prev = cur
653
654         # 10 is an arbitrary threshold
655         if seq_count > 10:
656             self.passed = False
657             self.failure_reason = "too many ({0}) consecutive offsets".format(seq_count)
658
659         if len(offsets) == filesize/bs:
660             self.passed = False
661             self.failure_reason += " no duplicate offsets found with norandommap=1"
662
663
664 class FioJobTest_t0023(FioJobTest):
665     """Test consists of fio test job t0023 randtrimwrite test."""
666
667     def check_trimwrite(self, filename):
668         """Make sure that trims are followed by writes of the same size at the same offset."""
669
670         bw_log_filename = os.path.join(self.test_dir, filename)
671         file_data = self.get_file_fail(bw_log_filename)
672         if not file_data:
673             return
674
675         log_lines = file_data.split('\n')
676
677         prev_ddir = 1
678         for line in log_lines:
679             if len(line.strip()) == 0:
680                 continue
681             vals = line.split(',')
682             ddir = int(vals[2])
683             bs = int(vals[3])
684             offset = int(vals[4])
685             if prev_ddir == 1:
686                 if ddir != 2:
687                     self.passed = False
688                     self.failure_reason += " {0}: write not preceeded by trim: {1}".format(
689                         bw_log_filename, line)
690                     break
691             else:
692                 if ddir != 1:
693                     self.passed = False
694                     self.failure_reason += " {0}: trim not preceeded by write: {1}".format(
695                         bw_log_filename, line)
696                     break
697                 else:
698                     if prev_bs != bs:
699                         self.passed = False
700                         self.failure_reason += " {0}: block size does not match: {1}".format(
701                             bw_log_filename, line)
702                         break
703                     if prev_offset != offset:
704                         self.passed = False
705                         self.failure_reason += " {0}: offset does not match: {1}".format(
706                             bw_log_filename, line)
707                         break
708             prev_ddir = ddir
709             prev_bs = bs
710             prev_offset = offset
711
712
713     def check_all_offsets(self, filename, sectorsize, filesize):
714         """Make sure all offsets were touched."""
715
716         file_data = self.get_file_fail(os.path.join(self.test_dir, filename))
717         if not file_data:
718             return
719
720         log_lines = file_data.split('\n')
721
722         offsets = set()
723
724         for line in log_lines:
725             if len(line.strip()) == 0:
726                 continue
727             vals = line.split(',')
728             bs = int(vals[3])
729             offset = int(vals[4])
730             if offset % sectorsize != 0:
731                 self.passed = False
732                 self.failure_reason += " {0}: offset {1} not a multiple of sector size {2}".format(
733                     filename, offset, sectorsize)
734                 break
735             if bs % sectorsize != 0:
736                 self.passed = False
737                 self.failure_reason += " {0}: block size {1} not a multiple of sector size " \
738                     "{2}".format(filename, bs, sectorsize)
739                 break
740             for i in range(int(bs/sectorsize)):
741                 offsets.add(offset/sectorsize + i)
742
743         if len(offsets) != filesize/sectorsize:
744             self.passed = False
745             self.failure_reason += " {0}: only {1} offsets touched; expected {2}".format(
746                 filename, len(offsets), filesize/sectorsize)
747         else:
748             logging.debug("%s: %d sectors touched", filename, len(offsets))
749
750
751     def check_result(self):
752         super(FioJobTest_t0023, self).check_result()
753
754         filesize = 1024*1024
755
756         self.check_trimwrite("basic_bw.log")
757         self.check_trimwrite("bs_bw.log")
758         self.check_trimwrite("bsrange_bw.log")
759         self.check_trimwrite("bssplit_bw.log")
760         self.check_trimwrite("basic_no_rm_bw.log")
761         self.check_trimwrite("bs_no_rm_bw.log")
762         self.check_trimwrite("bsrange_no_rm_bw.log")
763         self.check_trimwrite("bssplit_no_rm_bw.log")
764
765         self.check_all_offsets("basic_bw.log", 4096, filesize)
766         self.check_all_offsets("bs_bw.log", 8192, filesize)
767         self.check_all_offsets("bsrange_bw.log", 512, filesize)
768         self.check_all_offsets("bssplit_bw.log", 512, filesize)
769
770
771 class FioJobTest_t0024(FioJobTest_t0023):
772     """Test consists of fio test job t0024 trimwrite test."""
773
774     def check_result(self):
775         # call FioJobTest_t0023's parent to skip checks done by t0023
776         super(FioJobTest_t0023, self).check_result()
777
778         filesize = 1024*1024
779
780         self.check_trimwrite("basic_bw.log")
781         self.check_trimwrite("bs_bw.log")
782         self.check_trimwrite("bsrange_bw.log")
783         self.check_trimwrite("bssplit_bw.log")
784
785         self.check_all_offsets("basic_bw.log", 4096, filesize)
786         self.check_all_offsets("bs_bw.log", 8192, filesize)
787         self.check_all_offsets("bsrange_bw.log", 512, filesize)
788         self.check_all_offsets("bssplit_bw.log", 512, filesize)
789
790
791 class FioJobTest_t0025(FioJobTest):
792     """Test experimental verify read backs written data pattern."""
793     def check_result(self):
794         super(FioJobTest_t0025, self).check_result()
795
796         if not self.passed:
797             return
798
799         if self.json_data['jobs'][0]['read']['io_kbytes'] != 128:
800             self.passed = False
801
802
803 class FioJobTest_iops_rate(FioJobTest):
804     """Test consists of fio test job t0009
805     Confirm that job0 iops == 1000
806     and that job1_iops / job0_iops ~ 8
807     With two runs of fio-3.16 I observed a ratio of 8.3"""
808
809     def check_result(self):
810         super(FioJobTest_iops_rate, self).check_result()
811
812         if not self.passed:
813             return
814
815         iops1 = self.json_data['jobs'][0]['read']['iops']
816         logging.debug("Test %d: iops1: %f", self.testnum, iops1)
817         iops2 = self.json_data['jobs'][1]['read']['iops']
818         logging.debug("Test %d: iops2: %f", self.testnum, iops2)
819         ratio = iops2 / iops1
820         logging.debug("Test %d: ratio: %f", self.testnum, ratio)
821
822         if iops1 < 950 or iops1 > 1050:
823             self.failure_reason = "{0} iops value mismatch,".format(self.failure_reason)
824             self.passed = False
825
826         if ratio < 6 or ratio > 10:
827             self.failure_reason = "{0} iops ratio mismatch,".format(self.failure_reason)
828             self.passed = False
829
830
831 class Requirements():
832     """Requirements consists of multiple run environment characteristics.
833     These are to determine if a particular test can be run"""
834
835     _linux = False
836     _libaio = False
837     _io_uring = False
838     _zbd = False
839     _root = False
840     _zoned_nullb = False
841     _not_macos = False
842     _not_windows = False
843     _unittests = False
844     _cpucount4 = False
845
846     def __init__(self, fio_root):
847         Requirements._not_macos = platform.system() != "Darwin"
848         Requirements._not_windows = platform.system() != "Windows"
849         Requirements._linux = platform.system() == "Linux"
850
851         if Requirements._linux:
852             config_file = os.path.join(fio_root, "config-host.h")
853             contents, success = FioJobTest.get_file(config_file)
854             if not success:
855                 print("Unable to open {0} to check requirements".format(config_file))
856                 Requirements._zbd = True
857             else:
858                 Requirements._zbd = "CONFIG_HAS_BLKZONED" in contents
859                 Requirements._libaio = "CONFIG_LIBAIO" in contents
860
861             contents, success = FioJobTest.get_file("/proc/kallsyms")
862             if not success:
863                 print("Unable to open '/proc/kallsyms' to probe for io_uring support")
864             else:
865                 Requirements._io_uring = "io_uring_setup" in contents
866
867             Requirements._root = (os.geteuid() == 0)
868             if Requirements._zbd and Requirements._root:
869                 try:
870                     subprocess.run(["modprobe", "null_blk"],
871                                    stdout=subprocess.PIPE,
872                                    stderr=subprocess.PIPE)
873                     if os.path.exists("/sys/module/null_blk/parameters/zoned"):
874                         Requirements._zoned_nullb = True
875                 except Exception:
876                     pass
877
878         if platform.system() == "Windows":
879             utest_exe = "unittest.exe"
880         else:
881             utest_exe = "unittest"
882         unittest_path = os.path.join(fio_root, "unittests", utest_exe)
883         Requirements._unittests = os.path.exists(unittest_path)
884
885         Requirements._cpucount4 = multiprocessing.cpu_count() >= 4
886
887         req_list = [Requirements.linux,
888                     Requirements.libaio,
889                     Requirements.io_uring,
890                     Requirements.zbd,
891                     Requirements.root,
892                     Requirements.zoned_nullb,
893                     Requirements.not_macos,
894                     Requirements.not_windows,
895                     Requirements.unittests,
896                     Requirements.cpucount4]
897         for req in req_list:
898             value, desc = req()
899             logging.debug("Requirements: Requirement '%s' met? %s", desc, value)
900
901     @classmethod
902     def linux(cls):
903         """Are we running on Linux?"""
904         return Requirements._linux, "Linux required"
905
906     @classmethod
907     def libaio(cls):
908         """Is libaio available?"""
909         return Requirements._libaio, "libaio required"
910
911     @classmethod
912     def io_uring(cls):
913         """Is io_uring available?"""
914         return Requirements._io_uring, "io_uring required"
915
916     @classmethod
917     def zbd(cls):
918         """Is ZBD support available?"""
919         return Requirements._zbd, "Zoned block device support required"
920
921     @classmethod
922     def root(cls):
923         """Are we running as root?"""
924         return Requirements._root, "root required"
925
926     @classmethod
927     def zoned_nullb(cls):
928         """Are zoned null block devices available?"""
929         return Requirements._zoned_nullb, "Zoned null block device support required"
930
931     @classmethod
932     def not_macos(cls):
933         """Are we running on a platform other than macOS?"""
934         return Requirements._not_macos, "platform other than macOS required"
935
936     @classmethod
937     def not_windows(cls):
938         """Are we running on a platform other than Windws?"""
939         return Requirements._not_windows, "platform other than Windows required"
940
941     @classmethod
942     def unittests(cls):
943         """Were unittests built?"""
944         return Requirements._unittests, "Unittests support required"
945
946     @classmethod
947     def cpucount4(cls):
948         """Do we have at least 4 CPUs?"""
949         return Requirements._cpucount4, "4+ CPUs required"
950
951
952 SUCCESS_DEFAULT = {
953     'zero_return': True,
954     'stderr_empty': True,
955     'timeout': 600,
956     }
957 SUCCESS_NONZERO = {
958     'zero_return': False,
959     'stderr_empty': False,
960     'timeout': 600,
961     }
962 SUCCESS_STDERR = {
963     'zero_return': True,
964     'stderr_empty': False,
965     'timeout': 600,
966     }
967 TEST_LIST = [
968     {
969         'test_id':          1,
970         'test_class':       FioJobTest,
971         'job':              't0001-52c58027.fio',
972         'success':          SUCCESS_DEFAULT,
973         'pre_job':          None,
974         'pre_success':      None,
975         'requirements':     [],
976     },
977     {
978         'test_id':          2,
979         'test_class':       FioJobTest,
980         'job':              't0002-13af05ae-post.fio',
981         'success':          SUCCESS_DEFAULT,
982         'pre_job':          't0002-13af05ae-pre.fio',
983         'pre_success':      None,
984         'requirements':     [Requirements.linux, Requirements.libaio],
985     },
986     {
987         'test_id':          3,
988         'test_class':       FioJobTest,
989         'job':              't0003-0ae2c6e1-post.fio',
990         'success':          SUCCESS_NONZERO,
991         'pre_job':          't0003-0ae2c6e1-pre.fio',
992         'pre_success':      SUCCESS_DEFAULT,
993         'requirements':     [Requirements.linux, Requirements.libaio],
994     },
995     {
996         'test_id':          4,
997         'test_class':       FioJobTest,
998         'job':              't0004-8a99fdf6.fio',
999         'success':          SUCCESS_DEFAULT,
1000         'pre_job':          None,
1001         'pre_success':      None,
1002         'requirements':     [Requirements.linux, Requirements.libaio],
1003     },
1004     {
1005         'test_id':          5,
1006         'test_class':       FioJobTest_t0005,
1007         'job':              't0005-f7078f7b.fio',
1008         'success':          SUCCESS_DEFAULT,
1009         'pre_job':          None,
1010         'pre_success':      None,
1011         'output_format':    'json',
1012         'requirements':     [Requirements.not_windows],
1013     },
1014     {
1015         'test_id':          6,
1016         'test_class':       FioJobTest_t0006,
1017         'job':              't0006-82af2a7c.fio',
1018         'success':          SUCCESS_DEFAULT,
1019         'pre_job':          None,
1020         'pre_success':      None,
1021         'output_format':    'json',
1022         'requirements':     [Requirements.linux, Requirements.libaio],
1023     },
1024     {
1025         'test_id':          7,
1026         'test_class':       FioJobTest_t0007,
1027         'job':              't0007-37cf9e3c.fio',
1028         'success':          SUCCESS_DEFAULT,
1029         'pre_job':          None,
1030         'pre_success':      None,
1031         'output_format':    'json',
1032         'requirements':     [],
1033     },
1034     {
1035         'test_id':          8,
1036         'test_class':       FioJobTest_t0008,
1037         'job':              't0008-ae2fafc8.fio',
1038         'success':          SUCCESS_DEFAULT,
1039         'pre_job':          None,
1040         'pre_success':      None,
1041         'output_format':    'json',
1042         'requirements':     [],
1043     },
1044     {
1045         'test_id':          9,
1046         'test_class':       FioJobTest_t0009,
1047         'job':              't0009-f8b0bd10.fio',
1048         'success':          SUCCESS_DEFAULT,
1049         'pre_job':          None,
1050         'pre_success':      None,
1051         'output_format':    'json',
1052         'requirements':     [Requirements.not_macos,
1053                              Requirements.cpucount4],
1054         # mac os does not support CPU affinity
1055     },
1056     {
1057         'test_id':          10,
1058         'test_class':       FioJobTest,
1059         'job':              't0010-b7aae4ba.fio',
1060         'success':          SUCCESS_DEFAULT,
1061         'pre_job':          None,
1062         'pre_success':      None,
1063         'requirements':     [],
1064     },
1065     {
1066         'test_id':          11,
1067         'test_class':       FioJobTest_iops_rate,
1068         'job':              't0011-5d2788d5.fio',
1069         'success':          SUCCESS_DEFAULT,
1070         'pre_job':          None,
1071         'pre_success':      None,
1072         'output_format':    'json',
1073         'requirements':     [],
1074     },
1075     {
1076         'test_id':          12,
1077         'test_class':       FioJobTest_t0012,
1078         'job':              't0012.fio',
1079         'success':          SUCCESS_DEFAULT,
1080         'pre_job':          None,
1081         'pre_success':      None,
1082         'output_format':    'json',
1083         'requirements':     [],
1084     },
1085     {
1086         'test_id':          13,
1087         'test_class':       FioJobTest,
1088         'job':              't0013.fio',
1089         'success':          SUCCESS_DEFAULT,
1090         'pre_job':          None,
1091         'pre_success':      None,
1092         'output_format':    'json',
1093         'requirements':     [],
1094     },
1095     {
1096         'test_id':          14,
1097         'test_class':       FioJobTest_t0014,
1098         'job':              't0014.fio',
1099         'success':          SUCCESS_DEFAULT,
1100         'pre_job':          None,
1101         'pre_success':      None,
1102         'output_format':    'json',
1103         'requirements':     [],
1104     },
1105     {
1106         'test_id':          15,
1107         'test_class':       FioJobTest_t0015,
1108         'job':              't0015-e78980ff.fio',
1109         'success':          SUCCESS_DEFAULT,
1110         'pre_job':          None,
1111         'pre_success':      None,
1112         'output_format':    'json',
1113         'requirements':     [Requirements.linux, Requirements.libaio],
1114     },
1115     {
1116         'test_id':          16,
1117         'test_class':       FioJobTest_t0015,
1118         'job':              't0016-d54ae22.fio',
1119         'success':          SUCCESS_DEFAULT,
1120         'pre_job':          None,
1121         'pre_success':      None,
1122         'output_format':    'json',
1123         'requirements':     [],
1124     },
1125     {
1126         'test_id':          17,
1127         'test_class':       FioJobTest_t0015,
1128         'job':              't0017.fio',
1129         'success':          SUCCESS_DEFAULT,
1130         'pre_job':          None,
1131         'pre_success':      None,
1132         'output_format':    'json',
1133         'requirements':     [Requirements.not_windows],
1134     },
1135     {
1136         'test_id':          18,
1137         'test_class':       FioJobTest,
1138         'job':              't0018.fio',
1139         'success':          SUCCESS_DEFAULT,
1140         'pre_job':          None,
1141         'pre_success':      None,
1142         'requirements':     [Requirements.linux, Requirements.io_uring],
1143     },
1144     {
1145         'test_id':          19,
1146         'test_class':       FioJobTest_t0019,
1147         'job':              't0019.fio',
1148         'success':          SUCCESS_DEFAULT,
1149         'pre_job':          None,
1150         'pre_success':      None,
1151         'requirements':     [],
1152     },
1153     {
1154         'test_id':          20,
1155         'test_class':       FioJobTest_t0020,
1156         'job':              't0020.fio',
1157         'success':          SUCCESS_DEFAULT,
1158         'pre_job':          None,
1159         'pre_success':      None,
1160         'requirements':     [],
1161     },
1162     {
1163         'test_id':          21,
1164         'test_class':       FioJobTest_t0020,
1165         'job':              't0021.fio',
1166         'success':          SUCCESS_DEFAULT,
1167         'pre_job':          None,
1168         'pre_success':      None,
1169         'requirements':     [],
1170     },
1171     {
1172         'test_id':          22,
1173         'test_class':       FioJobTest_t0022,
1174         'job':              't0022.fio',
1175         'success':          SUCCESS_DEFAULT,
1176         'pre_job':          None,
1177         'pre_success':      None,
1178         'requirements':     [],
1179     },
1180     {
1181         'test_id':          23,
1182         'test_class':       FioJobTest_t0023,
1183         'job':              't0023.fio',
1184         'success':          SUCCESS_DEFAULT,
1185         'pre_job':          None,
1186         'pre_success':      None,
1187         'requirements':     [],
1188     },
1189     {
1190         'test_id':          24,
1191         'test_class':       FioJobTest_t0024,
1192         'job':              't0024.fio',
1193         'success':          SUCCESS_DEFAULT,
1194         'pre_job':          None,
1195         'pre_success':      None,
1196         'requirements':     [],
1197     },
1198     {
1199         'test_id':          25,
1200         'test_class':       FioJobTest_t0025,
1201         'job':              't0025.fio',
1202         'success':          SUCCESS_DEFAULT,
1203         'pre_job':          None,
1204         'pre_success':      None,
1205         'output_format':    'json',
1206         'requirements':     [],
1207     },
1208     {
1209         'test_id':          26,
1210         'test_class':       FioJobTest,
1211         'job':              't0026.fio',
1212         'success':          SUCCESS_DEFAULT,
1213         'pre_job':          None,
1214         'pre_success':      None,
1215         'requirements':     [Requirements.not_windows],
1216     },
1217     {
1218         'test_id':          1000,
1219         'test_class':       FioExeTest,
1220         'exe':              't/axmap',
1221         'parameters':       None,
1222         'success':          SUCCESS_DEFAULT,
1223         'requirements':     [],
1224     },
1225     {
1226         'test_id':          1001,
1227         'test_class':       FioExeTest,
1228         'exe':              't/ieee754',
1229         'parameters':       None,
1230         'success':          SUCCESS_DEFAULT,
1231         'requirements':     [],
1232     },
1233     {
1234         'test_id':          1002,
1235         'test_class':       FioExeTest,
1236         'exe':              't/lfsr-test',
1237         'parameters':       ['0xFFFFFF', '0', '0', 'verify'],
1238         'success':          SUCCESS_STDERR,
1239         'requirements':     [],
1240     },
1241     {
1242         'test_id':          1003,
1243         'test_class':       FioExeTest,
1244         'exe':              't/readonly.py',
1245         'parameters':       ['-f', '{fio_path}'],
1246         'success':          SUCCESS_DEFAULT,
1247         'requirements':     [],
1248     },
1249     {
1250         'test_id':          1004,
1251         'test_class':       FioExeTest,
1252         'exe':              't/steadystate_tests.py',
1253         'parameters':       ['{fio_path}'],
1254         'success':          SUCCESS_DEFAULT,
1255         'requirements':     [],
1256     },
1257     {
1258         'test_id':          1005,
1259         'test_class':       FioExeTest,
1260         'exe':              't/stest',
1261         'parameters':       None,
1262         'success':          SUCCESS_STDERR,
1263         'requirements':     [],
1264     },
1265     {
1266         'test_id':          1006,
1267         'test_class':       FioExeTest,
1268         'exe':              't/strided.py',
1269         'parameters':       ['{fio_path}'],
1270         'success':          SUCCESS_DEFAULT,
1271         'requirements':     [],
1272     },
1273     {
1274         'test_id':          1007,
1275         'test_class':       FioExeTest,
1276         'exe':              't/zbd/run-tests-against-nullb',
1277         'parameters':       ['-s', '1'],
1278         'success':          SUCCESS_DEFAULT,
1279         'requirements':     [Requirements.linux, Requirements.zbd,
1280                              Requirements.root],
1281     },
1282     {
1283         'test_id':          1008,
1284         'test_class':       FioExeTest,
1285         'exe':              't/zbd/run-tests-against-nullb',
1286         'parameters':       ['-s', '2'],
1287         'success':          SUCCESS_DEFAULT,
1288         'requirements':     [Requirements.linux, Requirements.zbd,
1289                              Requirements.root, Requirements.zoned_nullb],
1290     },
1291     {
1292         'test_id':          1009,
1293         'test_class':       FioExeTest,
1294         'exe':              'unittests/unittest',
1295         'parameters':       None,
1296         'success':          SUCCESS_DEFAULT,
1297         'requirements':     [Requirements.unittests],
1298     },
1299     {
1300         'test_id':          1010,
1301         'test_class':       FioExeTest,
1302         'exe':              't/latency_percentiles.py',
1303         'parameters':       ['-f', '{fio_path}'],
1304         'success':          SUCCESS_DEFAULT,
1305         'requirements':     [],
1306     },
1307     {
1308         'test_id':          1011,
1309         'test_class':       FioExeTest,
1310         'exe':              't/jsonplus2csv_test.py',
1311         'parameters':       ['-f', '{fio_path}'],
1312         'success':          SUCCESS_DEFAULT,
1313         'requirements':     [],
1314     },
1315     {
1316         'test_id':          1012,
1317         'test_class':       FioExeTest,
1318         'exe':              't/log_compression.py',
1319         'parameters':       ['-f', '{fio_path}'],
1320         'success':          SUCCESS_DEFAULT,
1321         'requirements':     [],
1322     },
1323 ]
1324
1325
1326 def parse_args():
1327     """Parse command-line arguments."""
1328
1329     parser = argparse.ArgumentParser()
1330     parser.add_argument('-r', '--fio-root',
1331                         help='fio root path')
1332     parser.add_argument('-f', '--fio',
1333                         help='path to fio executable (e.g., ./fio)')
1334     parser.add_argument('-a', '--artifact-root',
1335                         help='artifact root directory')
1336     parser.add_argument('-s', '--skip', nargs='+', type=int,
1337                         help='list of test(s) to skip')
1338     parser.add_argument('-o', '--run-only', nargs='+', type=int,
1339                         help='list of test(s) to run, skipping all others')
1340     parser.add_argument('-d', '--debug', action='store_true',
1341                         help='provide debug output')
1342     parser.add_argument('-k', '--skip-req', action='store_true',
1343                         help='skip requirements checking')
1344     parser.add_argument('-p', '--pass-through', action='append',
1345                         help='pass-through an argument to an executable test')
1346     args = parser.parse_args()
1347
1348     return args
1349
1350
1351 def main():
1352     """Entry point."""
1353
1354     args = parse_args()
1355     if args.debug:
1356         logging.basicConfig(level=logging.DEBUG)
1357     else:
1358         logging.basicConfig(level=logging.INFO)
1359
1360     pass_through = {}
1361     if args.pass_through:
1362         for arg in args.pass_through:
1363             if not ':' in arg:
1364                 print("Invalid --pass-through argument '%s'" % arg)
1365                 print("Syntax for --pass-through is TESTNUMBER:ARGUMENT")
1366                 return
1367             split = arg.split(":", 1)
1368             pass_through[int(split[0])] = split[1]
1369         logging.debug("Pass-through arguments: %s", pass_through)
1370
1371     if args.fio_root:
1372         fio_root = args.fio_root
1373     else:
1374         fio_root = str(Path(__file__).absolute().parent.parent)
1375     print("fio root is %s" % fio_root)
1376
1377     if args.fio:
1378         fio_path = args.fio
1379     else:
1380         if platform.system() == "Windows":
1381             fio_exe = "fio.exe"
1382         else:
1383             fio_exe = "fio"
1384         fio_path = os.path.join(fio_root, fio_exe)
1385     print("fio path is %s" % fio_path)
1386     if not shutil.which(fio_path):
1387         print("Warning: fio executable not found")
1388
1389     artifact_root = args.artifact_root if args.artifact_root else \
1390         "fio-test-{0}".format(time.strftime("%Y%m%d-%H%M%S"))
1391     os.mkdir(artifact_root)
1392     print("Artifact directory is %s" % artifact_root)
1393
1394     if not args.skip_req:
1395         req = Requirements(fio_root)
1396
1397     passed = 0
1398     failed = 0
1399     skipped = 0
1400
1401     for config in TEST_LIST:
1402         if (args.skip and config['test_id'] in args.skip) or \
1403            (args.run_only and config['test_id'] not in args.run_only):
1404             skipped = skipped + 1
1405             print("Test {0} SKIPPED (User request)".format(config['test_id']))
1406             continue
1407
1408         if issubclass(config['test_class'], FioJobTest):
1409             if config['pre_job']:
1410                 fio_pre_job = os.path.join(fio_root, 't', 'jobs',
1411                                            config['pre_job'])
1412             else:
1413                 fio_pre_job = None
1414             if config['pre_success']:
1415                 fio_pre_success = config['pre_success']
1416             else:
1417                 fio_pre_success = None
1418             if 'output_format' in config:
1419                 output_format = config['output_format']
1420             else:
1421                 output_format = 'normal'
1422             test = config['test_class'](
1423                 fio_path,
1424                 os.path.join(fio_root, 't', 'jobs', config['job']),
1425                 config['success'],
1426                 fio_pre_job=fio_pre_job,
1427                 fio_pre_success=fio_pre_success,
1428                 output_format=output_format)
1429             desc = config['job']
1430         elif issubclass(config['test_class'], FioExeTest):
1431             exe_path = os.path.join(fio_root, config['exe'])
1432             if config['parameters']:
1433                 parameters = [p.format(fio_path=fio_path) for p in config['parameters']]
1434             else:
1435                 parameters = []
1436             if Path(exe_path).suffix == '.py' and platform.system() == "Windows":
1437                 parameters.insert(0, exe_path)
1438                 exe_path = "python.exe"
1439             if config['test_id'] in pass_through:
1440                 parameters += pass_through[config['test_id']].split()
1441             test = config['test_class'](exe_path, parameters,
1442                                         config['success'])
1443             desc = config['exe']
1444         else:
1445             print("Test {0} FAILED: unable to process test config".format(config['test_id']))
1446             failed = failed + 1
1447             continue
1448
1449         if not args.skip_req:
1450             reqs_met = True
1451             for req in config['requirements']:
1452                 reqs_met, reason = req()
1453                 logging.debug("Test %d: Requirement '%s' met? %s", config['test_id'], reason,
1454                               reqs_met)
1455                 if not reqs_met:
1456                     break
1457             if not reqs_met:
1458                 print("Test {0} SKIPPED ({1}) {2}".format(config['test_id'], reason, desc))
1459                 skipped = skipped + 1
1460                 continue
1461
1462         try:
1463             test.setup(artifact_root, config['test_id'])
1464             test.run()
1465             test.check_result()
1466         except KeyboardInterrupt:
1467             break
1468         except Exception as e:
1469             test.passed = False
1470             test.failure_reason += str(e)
1471             logging.debug("Test %d exception:\n%s\n", config['test_id'], traceback.format_exc())
1472         if test.passed:
1473             result = "PASSED"
1474             passed = passed + 1
1475         else:
1476             result = "FAILED: {0}".format(test.failure_reason)
1477             failed = failed + 1
1478             contents, _ = FioJobTest.get_file(test.stderr_file)
1479             logging.debug("Test %d: stderr:\n%s", config['test_id'], contents)
1480             contents, _ = FioJobTest.get_file(test.stdout_file)
1481             logging.debug("Test %d: stdout:\n%s", config['test_id'], contents)
1482         print("Test {0} {1} {2}".format(config['test_id'], result, desc))
1483
1484     print("{0} test(s) passed, {1} failed, {2} skipped".format(passed, failed, skipped))
1485
1486     sys.exit(failed)
1487
1488
1489 if __name__ == '__main__':
1490     main()