source: mainline/tools/checkers/vcc.py@ 33c4f72

#!/usr/bin/env python
#
# Copyright (c) 2010 Martin Decky
# Copyright (c) 2010 Ondrej Sery
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
#
# - Redistributions of source code must retain the above copyright
#   notice, this list of conditions and the following disclaimer.
# - Redistributions in binary form must reproduce the above copyright
#   notice, this list of conditions and the following disclaimer in the
#   documentation and/or other materials provided with the distribution.
# - The name of the author may not be used to endorse or promote products
#   derived from this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
"""
Wrapper for Vcc checker
"""

import sys
import os
import subprocess
import jobfile
import re

jobs = [
        "kernel/kernel.job"
]

re_attribute = re.compile("__attribute__\s*\(\(.*\)\)")
re_va_list = re.compile("__builtin_va_list")

specification = ""

def usage(prname):
        "Print usage syntax"
        print prname + " <ROOT> [VCC_PATH]"

def cygpath(upath):
        "Convert Unix (Cygwin) path to Windows path"
        
        return subprocess.Popen(['cygpath', '--windows', '--absolute', upath], stdout = subprocess.PIPE).communicate()[0].strip()

def preprocess(srcfname, tmpfname, base, options):
        "Preprocess source using GCC preprocessor and compatibility tweaks"
        
        global specification
        
        args = ['gcc', '-E']
        args.extend(options.split())
        args.extend(['-DCONFIG_VERIFY_VCC=1', srcfname])
        
        # Change working directory
        
        cwd = os.getcwd()
        os.chdir(base)
        
        preproc = subprocess.Popen(args, stdout = subprocess.PIPE).communicate()[0]
        
        tmpf = file(tmpfname, "w")
        tmpf.write(specification)
        
        for line in preproc.splitlines():
                
                # Ignore preprocessor directives
                
                if (line.startswith('#')):
                        continue
                
                # Remove __attribute__((.*)) GCC extension
                
                line = re.sub(re_attribute, "", line)
                
                # Ignore unsupported __builtin_va_list type
                # (a better solution replacing __builrin_va_list with
                # an emulated implementation is needed)
                
                line = re.sub(re_va_list, "void *", line)
                
                tmpf.write("%s\n" % line)
        
        tmpf.close()
        
        os.chdir(cwd)
        
        return True

def vcc(vcc_path, root, job):
        "Run Vcc on a jobfile"
        
        # Parse jobfile
        
        inname = os.path.join(root, job)
        
        if (not os.path.isfile(inname)):
                print "Unable to open %s" % inname
                print "Did you run \"make precheck\" on the source tree?"
                return False
        
        inf = file(inname, "r")
        records = inf.read().splitlines()
        inf.close()
        
        for record in records:
                arg = jobfile.parse_arg(record)
                if (not arg):
                        return False
                
                if (len(arg) < 6):
                        print "Not enought jobfile record arguments"
                        return False
                
                srcfname = arg[0]
                tgtfname = arg[1]
                tool = arg[2]
                category = arg[3]
                base = arg[4]
                options = arg[5]
                
                srcfqname = os.path.join(base, srcfname)
                if (not os.path.isfile(srcfqname)):
                        print "Source %s not found" % srcfqname
                        return False
                
                tmpfname = "%s.preproc" % srcfname
                tmpfqname = os.path.join(base, tmpfname)
                
                vccfname = "%s.i" % srcfname
                vccfqname = os.path.join(base, vccfname);
                
                # Only C files are interesting for us
                if (tool != "cc"):
                        continue
                
                # Preprocess sources
                
                if (not preprocess(srcfname, tmpfname, base, options)):
                        return False
                
                # Run Vcc
                print " -- %s --" % srcfname            
                retval = subprocess.Popen([vcc_path, '/pointersize:32', '/newsyntax', cygpath(tmpfqname)]).wait()
                
                if (retval != 0):
                        return False
                
                # Cleanup, but only if verification was successful
                # (to be able to examine the preprocessed file)
                
                if (os.path.isfile(tmpfqname)):
                        os.remove(tmpfqname)
                        os.remove(vccfqname)
        
        return True

def main():
        global specification
        
        if (len(sys.argv) < 2):
                usage(sys.argv[0])
                return
        
        rootdir = os.path.abspath(sys.argv[1])
        if (len(sys.argv) > 2):
                vcc_path = sys.argv[2]
        else:
                vcc_path = "/cygdrive/c/Program Files (x86)/Microsoft Research/Vcc/Binaries/vcc"
        
        if (not os.path.isfile(vcc_path)):
                print "%s is not a binary." % vcc_path
                print "Please supply the full Cygwin path to Vcc as the second argument."
                return
        
        config = os.path.join(rootdir, "HelenOS.config")
        
        if (not os.path.isfile(config)):
                print "%s not found." % config
                print "Please specify the path to HelenOS build tree root as the first argument."
                return
        
        specpath = os.path.join(rootdir, "tools/checkers/vcc.h")
        if (not os.path.isfile(specpath)):
                print "%s not found." % config
                return
        
        specfile = file(specpath, "r")
        specification = specfile.read()
        specfile.close()
        
        for job in jobs:
                if (not vcc(vcc_path, rootdir, job)):
                        print
                        print "Failed job: %s" % job
                        return
        
        print
        print "All jobs passed"

if __name__ == '__main__':
        main()