tests/hwsim/run-tests.py

   1 #!/usr/bin/env python2
   2 #
   3 # Test case executor
   4 # Copyright (c) 2013-2014, Jouni Malinen <j@w1.fi>
   5 #
   6 # This software may be distributed under the terms of the BSD license.
   7 # See README for more details.
   8
   9 import os
  10 import re
  11 import sys
  12 import time
  13 from datetime import datetime
  14 import argparse
  15 import subprocess
  16
  17 import logging
  18 logger = logging.getLogger()
  19
  20 sys.path.append('../../wpaspy')
  21
  22 from wpasupplicant import WpaSupplicant
  23 from hostapd import HostapdGlobal
  24 from check_kernel import check_kernel
  25 from wlantest import Wlantest
  26
  27 def reset_devs(dev, apdev):
  28     ok = True
  29     for d in dev:
  30         try:
  31             d.reset()
  32         except Exception, e:
  33             logger.info("Failed to reset device " + d.ifname)
  34             print str(e)
  35             ok = False
  36
  37     try:
  38         wpas = WpaSupplicant(global_iface='/tmp/wpas-wlan5')
  39         ifaces = wpas.global_request("INTERFACES").splitlines()
  40         for iface in ifaces:
  41             if iface.startswith("wlan"):
  42                 wpas.interface_remove(iface)
  43     except Exception, e:
  44         pass
  45
  46     try:
  47         hapd = HostapdGlobal()
  48         hapd.flush()
  49         hapd.remove('wlan3-3')
  50         hapd.remove('wlan3-2')
  51         for ap in apdev:
  52             hapd.remove(ap['ifname'])
  53     except Exception, e:
  54         logger.info("Failed to remove hostapd interface")
  55         print str(e)
  56         ok = False
  57     return ok
  58
  59 def add_log_file(conn, test, run, type, path):
  60     if not os.path.exists(path):
  61         return
  62     contents = None
  63     with open(path, 'r') as f:
  64         contents = f.read()
  65     if contents is None:
  66         return
  67     sql = "INSERT INTO logs(test,run,type,contents) VALUES(?, ?, ?, ?)"
  68     params = (test, run, type, contents)
  69     try:
  70         conn.execute(sql, params)
  71         conn.commit()
  72     except Exception, e:
  73         print "sqlite: " + str(e)
  74         print "sql: %r" % (params, )
  75
  76 def report(conn, prefill, build, commit, run, test, result, duration, logdir):
  77     if conn:
  78         if not build:
  79             build = ''
  80         if not commit:
  81             commit = ''
  82         if prefill:
  83             conn.execute('DELETE FROM results WHERE test=? AND run=? AND result=?', (test, run, 'NOTRUN'))
  84         sql = "INSERT INTO results(test,result,run,time,duration,build,commitid) VALUES(?, ?, ?, ?, ?, ?, ?)"
  85         params = (test, result, run, time.time(), duration, build, commit)
  86         try:
  87             conn.execute(sql, params)
  88             conn.commit()
  89         except Exception, e:
  90             print "sqlite: " + str(e)
  91             print "sql: %r" % (params, )
  92
  93         if result == "FAIL":
  94             for log in [ "log", "log0", "log1", "log2", "log3", "log5",
  95                          "hostapd", "dmesg", "hwsim0", "hwsim0.pcapng" ]:
  96                 add_log_file(conn, test, run, log,
  97                              logdir + "/" + test + "." + log)
  98
  99 class DataCollector(object):
 100     def __init__(self, logdir, testname, tracing, dmesg):
 101         self._logdir = logdir
 102         self._testname = testname
 103         self._tracing = tracing
 104         self._dmesg = dmesg
 105     def __enter__(self):
 106         if self._tracing:
 107             output = os.path.abspath(os.path.join(self._logdir, '%s.dat' % (self._testname, )))
 108             self._trace_cmd = subprocess.Popen(['sudo', 'trace-cmd', 'record', '-o', output, '-e', 'mac80211', '-e', 'cfg80211', 'sh', '-c', 'echo STARTED ; read l'],
 109                                                stdin=subprocess.PIPE,
 110                                                stdout=subprocess.PIPE,
 111                                                stderr=open('/dev/null', 'w'),
 112                                                cwd=self._logdir)
 113             l = self._trace_cmd.stdout.read(7)
 114             while self._trace_cmd.poll() is None and not 'STARTED' in l:
 115                 l += self._trace_cmd.stdout.read(1)
 116             res = self._trace_cmd.returncode
 117             if res:
 118                 print "Failed calling trace-cmd: returned exit status %d" % res
 119                 sys.exit(1)
 120     def __exit__(self, type, value, traceback):
 121         if self._tracing:
 122             self._trace_cmd.stdin.write('DONE\n')
 123             self._trace_cmd.wait()
 124         if self._dmesg:
 125             output = os.path.join(self._logdir, '%s.dmesg' % (self._testname, ))
 126             subprocess.call(['sudo', 'dmesg', '-c'], stdout=open(output, 'w'))
 127
 128 def rename_log(logdir, basename, testname, dev):
 129     try:
 130         import getpass
 131         srcname = os.path.join(logdir, basename)
 132         dstname = os.path.join(logdir, testname + '.' + basename)
 133         num = 0
 134         while os.path.exists(dstname):
 135             dstname = os.path.join(logdir,
 136                                    testname + '.' + basename + '-' + str(num))
 137             num = num + 1
 138         os.rename(srcname, dstname)
 139         if dev:
 140             dev.relog()
 141             subprocess.call(['sudo', 'chown', '-f', getpass.getuser(), srcname])
 142     except Exception, e:
 143         logger.info("Failed to rename log files")
 144         logger.info(e)
 145
 146 def main():
 147     tests = []
 148     test_modules = []
 149     for t in os.listdir("."):
 150         m = re.match(r'(test_.*)\.py$', t)
 151         if m:
 152             logger.debug("Import test cases from " + t)
 153             mod = __import__(m.group(1))
 154             test_modules.append(mod.__name__.replace('test_', '', 1))
 155             for s in dir(mod):
 156                 if s.startswith("test_"):
 157                     func = mod.__dict__.get(s)
 158                     tests.append(func)
 159     test_names = list(set([t.__name__.replace('test_', '', 1) for t in tests]))
 160
 161     run = None
 162
 163     parser = argparse.ArgumentParser(description='hwsim test runner')
 164     parser.add_argument('--logdir', metavar='<directory>',
 165                         help='log output directory for all other options, ' +
 166                              'must be given if other log options are used')
 167     group = parser.add_mutually_exclusive_group()
 168     group.add_argument('-d', const=logging.DEBUG, action='store_const',
 169                        dest='loglevel', default=logging.INFO,
 170                        help="verbose debug output")
 171     group.add_argument('-q', const=logging.WARNING, action='store_const',
 172                        dest='loglevel', help="be quiet")
 173
 174     parser.add_argument('-S', metavar='<sqlite3 db>', dest='database',
 175                         help='database to write results to')
 176     parser.add_argument('--prefill-tests', action='store_true', dest='prefill',
 177                         help='prefill test database with NOTRUN before all tests')
 178     parser.add_argument('--commit', metavar='<commit id>',
 179                         help='commit ID, only for database')
 180     parser.add_argument('-b', metavar='<build>', dest='build', help='build ID')
 181     parser.add_argument('-L', action='store_true', dest='update_tests_db',
 182                         help='List tests (and update descriptions in DB)')
 183     parser.add_argument('-T', action='store_true', dest='tracing',
 184                         help='collect tracing per test case (in log directory)')
 185     parser.add_argument('-D', action='store_true', dest='dmesg',
 186                         help='collect dmesg per test case (in log directory)')
 187     parser.add_argument('--shuffle-tests', action='store_true',
 188                         dest='shuffle_tests',
 189                         help='Shuffle test cases to randomize order')
 190     parser.add_argument('--split', help='split tests for parallel execution (<server number>/<total servers>)')
 191     parser.add_argument('--no-reset', action='store_true', dest='no_reset',
 192                         help='Do not reset devices at the end of the test')
 193     parser.add_argument('--long', action='store_true',
 194                         help='Include test cases that take long time')
 195     parser.add_argument('-f', dest='testmodules', metavar='<test module>',
 196                         help='execute only tests from these test modules',
 197                         type=str, choices=[[]] + test_modules, nargs='+')
 198     parser.add_argument('tests', metavar='<test>', nargs='*', type=str,
 199                         help='tests to run (only valid without -f)',
 200                         choices=[[]] + test_names)
 201
 202     args = parser.parse_args()
 203
 204     if args.tests and args.testmodules:
 205         print 'Invalid arguments - both test module and tests given'
 206         sys.exit(2)
 207
 208     if not args.logdir:
 209         if os.path.exists('logs/current'):
 210             args.logdir = 'logs/current'
 211         else:
 212             args.logdir = 'logs'
 213
 214     # Write debug level log to a file and configurable verbosity to stdout
 215     logger.setLevel(logging.DEBUG)
 216
 217     stdout_handler = logging.StreamHandler()
 218     stdout_handler.setLevel(args.loglevel)
 219     logger.addHandler(stdout_handler)
 220
 221     file_name = os.path.join(args.logdir, 'run-tests.log')
 222     log_handler = logging.FileHandler(file_name)
 223     log_handler.setLevel(logging.DEBUG)
 224     fmt = "%(asctime)s %(levelname)s %(message)s"
 225     log_formatter = logging.Formatter(fmt)
 226     log_handler.setFormatter(log_formatter)
 227     logger.addHandler(log_handler)
 228
 229     if args.database:
 230         import sqlite3
 231         conn = sqlite3.connect(args.database)
 232         conn.execute('CREATE TABLE IF NOT EXISTS results (test,result,run,time,duration,build,commitid)')
 233         conn.execute('CREATE TABLE IF NOT EXISTS tests (test,description)')
 234         conn.execute('CREATE TABLE IF NOT EXISTS logs (test,run,type,contents)')
 235     else:
 236         conn = None
 237
 238     if conn:
 239         run = int(time.time())
 240
 241     if args.update_tests_db:
 242         for t in tests:
 243             name = t.__name__.replace('test_', '', 1)
 244             if t.__doc__ is None:
 245                 print name + " - MISSING DESCRIPTION"
 246             else:
 247                 print name + " - " + t.__doc__
 248             if conn:
 249                 sql = 'INSERT OR REPLACE INTO tests(test,description) VALUES (?, ?)'
 250                 params = (name, t.__doc__)
 251                 try:
 252                     conn.execute(sql, params)
 253                 except Exception, e:
 254                     print "sqlite: " + str(e)
 255                     print "sql: %r" % (params,)
 256         if conn:
 257             conn.commit()
 258             conn.close()
 259         sys.exit(0)
 260
 261
 262     dev0 = WpaSupplicant('wlan0', '/tmp/wpas-wlan0')
 263     dev1 = WpaSupplicant('wlan1', '/tmp/wpas-wlan1')
 264     dev2 = WpaSupplicant('wlan2', '/tmp/wpas-wlan2')
 265     dev = [ dev0, dev1, dev2 ]
 266     apdev = [ ]
 267     apdev.append({"ifname": 'wlan3', "bssid": "02:00:00:00:03:00"})
 268     apdev.append({"ifname": 'wlan4', "bssid": "02:00:00:00:04:00"})
 269
 270     for d in dev:
 271         if not d.ping():
 272             logger.info(d.ifname + ": No response from wpa_supplicant")
 273             return
 274         logger.info("DEV: " + d.ifname + ": " + d.p2p_dev_addr())
 275     for ap in apdev:
 276         logger.info("APDEV: " + ap['ifname'])
 277
 278     passed = []
 279     skipped = []
 280     failed = []
 281
 282     # make sure nothing is left over from previous runs
 283     # (if there were any other manual runs or we crashed)
 284     if not reset_devs(dev, apdev):
 285         if conn:
 286             conn.close()
 287             conn = None
 288         sys.exit(1)
 289
 290     if args.dmesg:
 291         subprocess.call(['sudo', 'dmesg', '-c'], stdout=open('/dev/null', 'w'))
 292
 293     tests_to_run = []
 294     for t in tests:
 295         name = t.__name__.replace('test_', '', 1)
 296         if args.tests:
 297             if not name in args.tests:
 298                 continue
 299         if args.testmodules:
 300             if not t.__module__.replace('test_', '', 1) in args.testmodules:
 301                 continue
 302         tests_to_run.append(t)
 303
 304     if conn and args.prefill:
 305         for t in tests_to_run:
 306             name = t.__name__.replace('test_', '', 1)
 307             report(conn, False, args.build, args.commit, run, name, 'NOTRUN', 0,
 308                    args.logdir)
 309
 310     if args.split:
 311         vals = args.split.split('/')
 312         split_server = int(vals[0])
 313         split_total = int(vals[1])
 314         logger.info("Parallel execution - %d/%d" % (split_server, split_total))
 315         split_server -= 1
 316         tests_to_run.sort(key=lambda t: t.__name__)
 317         tests_to_run = [x for i,x in enumerate(tests_to_run) if i % split_total == split_server]
 318
 319     if args.shuffle_tests:
 320         from random import shuffle
 321         shuffle(tests_to_run)
 322
 323     count = 0
 324     for t in tests_to_run:
 325         name = t.__name__.replace('test_', '', 1)
 326         if log_handler:
 327             log_handler.stream.close()
 328             logger.removeHandler(log_handler)
 329             file_name = os.path.join(args.logdir, name + '.log')
 330             log_handler = logging.FileHandler(file_name)
 331             log_handler.setLevel(logging.DEBUG)
 332             log_handler.setFormatter(log_formatter)
 333             logger.addHandler(log_handler)
 334
 335         reset_ok = True
 336         with DataCollector(args.logdir, name, args.tracing, args.dmesg):
 337             count = count + 1
 338             msg = "START {} {}/{}".format(name, count, len(tests_to_run))
 339             logger.info(msg)
 340             if args.loglevel == logging.WARNING:
 341                 print msg
 342                 sys.stdout.flush()
 343             if t.__doc__:
 344                 logger.info("Test: " + t.__doc__)
 345             start = datetime.now()
 346             for d in dev:
 347                 try:
 348                     d.dump_monitor()
 349                     if not d.ping():
 350                         raise Exception("PING failed for {}".format(d.ifname))
 351                     if not d.global_ping():
 352                         raise Exception("Global PING failed for {}".format(d.ifname))
 353                     d.request("NOTE TEST-START " + name)
 354                 except Exception, e:
 355                     logger.info("Failed to issue TEST-START before " + name + " for " + d.ifname)
 356                     logger.info(e)
 357                     print "FAIL " + name + " - could not start test"
 358                     if conn:
 359                         conn.close()
 360                         conn = None
 361                     sys.exit(1)
 362             try:
 363                 if t.func_code.co_argcount > 2:
 364                     params = {}
 365                     params['logdir'] = args.logdir
 366                     params['long'] = args.long
 367                     res = t(dev, apdev, params)
 368                 elif t.func_code.co_argcount > 1:
 369                     res = t(dev, apdev)
 370                 else:
 371                     res = t(dev)
 372                 if res == "skip":
 373                     result = "SKIP"
 374                 else:
 375                     result = "PASS"
 376             except Exception, e:
 377                 logger.info(e)
 378                 if args.loglevel == logging.WARNING:
 379                     print "Exception: " + str(e)
 380                 result = "FAIL"
 381             for d in dev:
 382                 try:
 383                     d.dump_monitor()
 384                     d.request("NOTE TEST-STOP " + name)
 385                 except Exception, e:
 386                     logger.info("Failed to issue TEST-STOP after {} for {}".format(name, d.ifname))
 387                     logger.info(e)
 388                     result = "FAIL"
 389             try:
 390                 wpas = WpaSupplicant("/tmp/wpas-wlan5")
 391                 d.dump_monitor()
 392                 rename_log(args.logdir, 'log5', name, wpas)
 393                 if not args.no_reset:
 394                     wpas.remove_ifname()
 395             except Exception, e:
 396                 pass
 397             if args.no_reset:
 398                 print "Leaving devices in current state"
 399             else:
 400                 reset_ok = reset_devs(dev, apdev)
 401
 402             for i in range(0, 3):
 403                 rename_log(args.logdir, 'log' + str(i), name, dev[i])
 404             try:
 405                 hapd = HostapdGlobal()
 406             except Exception, e:
 407                 print "Failed to connect to hostapd interface"
 408                 print str(e)
 409                 reset_ok = False
 410                 result = "FAIL"
 411                 hapd = None
 412             rename_log(args.logdir, 'hostapd', name, hapd)
 413
 414             wt = Wlantest()
 415             rename_log(args.logdir, 'hwsim0.pcapng', name, wt)
 416             rename_log(args.logdir, 'hwsim0', name, wt)
 417
 418         end = datetime.now()
 419         diff = end - start
 420
 421         if result == 'PASS' and args.dmesg:
 422             if not check_kernel(os.path.join(args.logdir, name + '.dmesg')):
 423                 logger.info("Kernel issue found in dmesg - mark test failed")
 424                 result = 'FAIL'
 425
 426         if result == 'PASS':
 427             passed.append(name)
 428         elif result == 'SKIP':
 429             skipped.append(name)
 430         else:
 431             failed.append(name)
 432
 433         report(conn, args.prefill, args.build, args.commit, run, name, result,
 434                diff.total_seconds(), args.logdir)
 435         result = "{} {} {} {}".format(result, name, diff.total_seconds(), end)
 436         logger.info(result)
 437         if args.loglevel == logging.WARNING:
 438             print result
 439             sys.stdout.flush()
 440
 441         if not reset_ok:
 442             print "Terminating early due to device reset failure"
 443             break
 444
 445     if log_handler:
 446         log_handler.stream.close()
 447         logger.removeHandler(log_handler)
 448         file_name = os.path.join(args.logdir, 'run-tests.log')
 449         log_handler = logging.FileHandler(file_name)
 450         log_handler.setLevel(logging.DEBUG)
 451         log_handler.setFormatter(log_formatter)
 452         logger.addHandler(log_handler)
 453
 454     if conn:
 455         conn.close()
 456
 457     if len(failed):
 458         logger.info("passed {} test case(s)".format(len(passed)))
 459         logger.info("skipped {} test case(s)".format(len(skipped)))
 460         logger.info("failed tests: " + ' '.join(failed))
 461         if args.loglevel == logging.WARNING:
 462             print "failed tests: " + ' '.join(failed)
 463         sys.exit(1)
 464     logger.info("passed all {} test case(s)".format(len(passed)))
 465     if len(skipped):
 466         logger.info("skipped {} test case(s)".format(len(skipped)))
 467     if args.loglevel == logging.WARNING:
 468         print "passed all {} test case(s)".format(len(passed))
 469         if len(skipped):
 470             print "skipped {} test case(s)".format(len(skipped))
 471
 472 if __name__ == "__main__":
 473     main()