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