SConscript revision 6998
1955SN/A# -*- mode:python -*-
2955SN/A
31762SN/A# Copyright (c) 2004-2005 The Regents of The University of Michigan
4955SN/A# All rights reserved.
5955SN/A#
6955SN/A# Redistribution and use in source and binary forms, with or without
7955SN/A# modification, are permitted provided that the following conditions are
8955SN/A# met: redistributions of source code must retain the above copyright
9955SN/A# notice, this list of conditions and the following disclaimer;
10955SN/A# redistributions in binary form must reproduce the above copyright
11955SN/A# notice, this list of conditions and the following disclaimer in the
12955SN/A# documentation and/or other materials provided with the distribution;
13955SN/A# neither the name of the copyright holders nor the names of its
14955SN/A# contributors may be used to endorse or promote products derived from
15955SN/A# this software without specific prior written permission.
16955SN/A#
17955SN/A# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18955SN/A# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19955SN/A# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
20955SN/A# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
21955SN/A# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
22955SN/A# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
23955SN/A# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24955SN/A# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25955SN/A# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26955SN/A# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27955SN/A# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
282665Ssaidi@eecs.umich.edu#
294762Snate@binkert.org# Authors: Nathan Binkert
30955SN/A
315522Snate@binkert.orgimport array
326143Snate@binkert.orgimport bisect
334762Snate@binkert.orgimport imp
345522Snate@binkert.orgimport marshal
35955SN/Aimport os
365522Snate@binkert.orgimport re
37955SN/Aimport sys
385522Snate@binkert.orgimport zlib
394202Sbinkertn@umich.edu
405742Snate@binkert.orgfrom os.path import basename, dirname, exists, isdir, isfile, join as joinpath
41955SN/A
424381Sbinkertn@umich.eduimport SCons
434381Sbinkertn@umich.edu
44955SN/A# This file defines how to build a particular configuration of M5
45955SN/A# based on variable settings in the 'env' build environment.
46955SN/A
474202Sbinkertn@umich.eduImport('*')
48955SN/A
494382Sbinkertn@umich.edu# Children need to see the environment
504382Sbinkertn@umich.eduExport('env')
514382Sbinkertn@umich.edu
526654Snate@binkert.orgbuild_env = [(opt, env[opt]) for opt in export_vars]
535517Snate@binkert.org
546143Snate@binkert.org########################################################################
556143Snate@binkert.org# Code for adding source files of various types
566143Snate@binkert.org#
576143Snate@binkert.orgclass SourceMeta(type):
586143Snate@binkert.org    def __init__(cls, name, bases, dict):
596143Snate@binkert.org        super(SourceMeta, cls).__init__(name, bases, dict)
606143Snate@binkert.org        cls.all = []
616143Snate@binkert.org        
626143Snate@binkert.org    def get(cls, **kwargs):
636143Snate@binkert.org        for src in cls.all:
646143Snate@binkert.org            for attr,value in kwargs.iteritems():
656143Snate@binkert.org                if getattr(src, attr) != value:
666143Snate@binkert.org                    break
676143Snate@binkert.org            else:
686143Snate@binkert.org                yield src
694762Snate@binkert.org
706143Snate@binkert.orgclass SourceFile(object):
716143Snate@binkert.org    __metaclass__ = SourceMeta
726143Snate@binkert.org    def __init__(self, source):
736143Snate@binkert.org        tnode = source
746143Snate@binkert.org        if not isinstance(source, SCons.Node.FS.File):
756143Snate@binkert.org            tnode = File(source)
766143Snate@binkert.org
776143Snate@binkert.org        self.tnode = tnode
786143Snate@binkert.org        self.snode = tnode.srcnode()
796143Snate@binkert.org        self.filename = str(tnode)
806143Snate@binkert.org        self.dirname = dirname(self.filename)
816143Snate@binkert.org        self.basename = basename(self.filename)
826143Snate@binkert.org        index = self.basename.rfind('.')
836143Snate@binkert.org        if index <= 0:
846143Snate@binkert.org            # dot files aren't extensions
856143Snate@binkert.org            self.extname = self.basename, None
866143Snate@binkert.org        else:
876143Snate@binkert.org            self.extname = self.basename[:index], self.basename[index+1:]
886143Snate@binkert.org
896143Snate@binkert.org        for base in type(self).__mro__:
906143Snate@binkert.org            if issubclass(base, SourceFile):
916143Snate@binkert.org                bisect.insort_right(base.all, self)       
926143Snate@binkert.org
936143Snate@binkert.org    def __lt__(self, other): return self.filename < other.filename
946143Snate@binkert.org    def __le__(self, other): return self.filename <= other.filename
956143Snate@binkert.org    def __gt__(self, other): return self.filename > other.filename
966143Snate@binkert.org    def __ge__(self, other): return self.filename >= other.filename
976143Snate@binkert.org    def __eq__(self, other): return self.filename == other.filename
986143Snate@binkert.org    def __ne__(self, other): return self.filename != other.filename
996143Snate@binkert.org        
1006143Snate@binkert.orgclass Source(SourceFile):
1016143Snate@binkert.org    '''Add a c/c++ source file to the build'''
1026143Snate@binkert.org    def __init__(self, source, Werror=True, swig=False, bin_only=False,
1036143Snate@binkert.org                 skip_lib=False):
1046143Snate@binkert.org        super(Source, self).__init__(source)
1056143Snate@binkert.org
1066143Snate@binkert.org        self.Werror = Werror
1076143Snate@binkert.org        self.swig = swig
1086143Snate@binkert.org        self.bin_only = bin_only
1096143Snate@binkert.org        self.skip_lib = bin_only or skip_lib
1106143Snate@binkert.org
1116143Snate@binkert.orgclass PySource(SourceFile):
1126143Snate@binkert.org    '''Add a python source file to the named package'''
1135522Snate@binkert.org    invalid_sym_char = re.compile('[^A-z0-9_]')
1146143Snate@binkert.org    modules = {}
1156143Snate@binkert.org    tnodes = {}
1166143Snate@binkert.org    symnames = {}
1176143Snate@binkert.org    
1186143Snate@binkert.org    def __init__(self, package, source):
1196143Snate@binkert.org        super(PySource, self).__init__(source)
1206143Snate@binkert.org
1216143Snate@binkert.org        modname,ext = self.extname
1226143Snate@binkert.org        assert ext == 'py'
1236143Snate@binkert.org
1245522Snate@binkert.org        if package:
1255522Snate@binkert.org            path = package.split('.')
1265522Snate@binkert.org        else:
1275522Snate@binkert.org            path = []
1285604Snate@binkert.org
1295604Snate@binkert.org        modpath = path[:]
1306143Snate@binkert.org        if modname != '__init__':
1316143Snate@binkert.org            modpath += [ modname ]
1324762Snate@binkert.org        modpath = '.'.join(modpath)
1334762Snate@binkert.org
1346143Snate@binkert.org        arcpath = path + [ self.basename ]
1356727Ssteve.reinhardt@amd.com        abspath = self.snode.abspath
1366727Ssteve.reinhardt@amd.com        if not exists(abspath):
1376727Ssteve.reinhardt@amd.com            abspath = self.tnode.abspath
1384762Snate@binkert.org
1396143Snate@binkert.org        self.package = package
1406143Snate@binkert.org        self.modname = modname
1416143Snate@binkert.org        self.modpath = modpath
1426143Snate@binkert.org        self.arcname = joinpath(*arcpath)
1436727Ssteve.reinhardt@amd.com        self.abspath = abspath
1446143Snate@binkert.org        self.compiled = File(self.filename + 'c')
1456143Snate@binkert.org        self.assembly = File(self.filename + '.s')
1466143Snate@binkert.org        self.symname = "PyEMB_" + PySource.invalid_sym_char.sub('_', modpath)
1475604Snate@binkert.org
1486143Snate@binkert.org        PySource.modules[modpath] = self
1496143Snate@binkert.org        PySource.tnodes[self.tnode] = self
1506143Snate@binkert.org        PySource.symnames[self.symname] = self
1514762Snate@binkert.org
1526143Snate@binkert.orgclass SimObject(PySource):
1534762Snate@binkert.org    '''Add a SimObject python file as a python source object and add
1544762Snate@binkert.org    it to a list of sim object modules'''
1554762Snate@binkert.org
1566143Snate@binkert.org    fixed = False
1576143Snate@binkert.org    modnames = []
1584762Snate@binkert.org
1596143Snate@binkert.org    def __init__(self, source):
1606143Snate@binkert.org        super(SimObject, self).__init__('m5.objects', source)
1616143Snate@binkert.org        if self.fixed:
1626143Snate@binkert.org            raise AttributeError, "Too late to call SimObject now."
1634762Snate@binkert.org
1646143Snate@binkert.org        bisect.insort_right(SimObject.modnames, self.modname)
1654762Snate@binkert.org
1666143Snate@binkert.orgclass SwigSource(SourceFile):
1674762Snate@binkert.org    '''Add a swig file to build'''
1686143Snate@binkert.org
1696143Snate@binkert.org    def __init__(self, package, source):
1706143Snate@binkert.org        super(SwigSource, self).__init__(source)
1716143Snate@binkert.org
1726143Snate@binkert.org        modname,ext = self.extname
1736143Snate@binkert.org        assert ext == 'i'
1746143Snate@binkert.org
1756143Snate@binkert.org        self.module = modname
1766143Snate@binkert.org        cc_file = joinpath(self.dirname, modname + '_wrap.cc')
1776143Snate@binkert.org        py_file = joinpath(self.dirname, modname + '.py')
1786143Snate@binkert.org
1796143Snate@binkert.org        self.cc_source = Source(cc_file, swig=True)
1806143Snate@binkert.org        self.py_source = PySource(package, py_file)
181955SN/A
1825584Snate@binkert.orgunit_tests = []
1835584Snate@binkert.orgdef UnitTest(target, sources):
1845584Snate@binkert.org    if not isinstance(sources, (list, tuple)):
1855584Snate@binkert.org        sources = [ sources ]
1866143Snate@binkert.org
1876143Snate@binkert.org    sources = [ Source(src, skip_lib=True) for src in sources ]
1886143Snate@binkert.org    unit_tests.append((target, sources))
1895584Snate@binkert.org
1904382Sbinkertn@umich.edu# Children should have access
1914202Sbinkertn@umich.eduExport('Source')
1924382Sbinkertn@umich.eduExport('PySource')
1934382Sbinkertn@umich.eduExport('SimObject')
1944382Sbinkertn@umich.eduExport('SwigSource')
1955584Snate@binkert.orgExport('UnitTest')
1964382Sbinkertn@umich.edu
1974382Sbinkertn@umich.edu########################################################################
1984382Sbinkertn@umich.edu#
1995192Ssaidi@eecs.umich.edu# Trace Flags
2005192Ssaidi@eecs.umich.edu#
2015799Snate@binkert.orgtrace_flags = {}
2025799Snate@binkert.orgdef TraceFlag(name, desc=None):
2035799Snate@binkert.org    if name in trace_flags:
2045192Ssaidi@eecs.umich.edu        raise AttributeError, "Flag %s already specified" % name
2055799Snate@binkert.org    trace_flags[name] = (name, (), desc)
2065192Ssaidi@eecs.umich.edu
2075799Snate@binkert.orgdef CompoundFlag(name, flags, desc=None):
2085799Snate@binkert.org    if name in trace_flags:
2095192Ssaidi@eecs.umich.edu        raise AttributeError, "Flag %s already specified" % name
2105192Ssaidi@eecs.umich.edu
2115192Ssaidi@eecs.umich.edu    compound = tuple(flags)
2125799Snate@binkert.org    trace_flags[name] = (name, compound, desc)
2135192Ssaidi@eecs.umich.edu
2145192Ssaidi@eecs.umich.eduExport('TraceFlag')
2155192Ssaidi@eecs.umich.eduExport('CompoundFlag')
2165192Ssaidi@eecs.umich.edu
2175192Ssaidi@eecs.umich.edu########################################################################
2185192Ssaidi@eecs.umich.edu#
2194382Sbinkertn@umich.edu# Set some compiler variables
2204382Sbinkertn@umich.edu#
2214382Sbinkertn@umich.edu
2222667Sstever@eecs.umich.edu# Include file paths are rooted in this directory.  SCons will
2232667Sstever@eecs.umich.edu# automatically expand '.' to refer to both the source directory and
2242667Sstever@eecs.umich.edu# the corresponding build directory to pick up generated include
2252667Sstever@eecs.umich.edu# files.
2262667Sstever@eecs.umich.eduenv.Append(CPPPATH=Dir('.'))
2272667Sstever@eecs.umich.edu
2285742Snate@binkert.orgfor extra_dir in extras_dir_list:
2295742Snate@binkert.org    env.Append(CPPPATH=Dir(extra_dir))
2305742Snate@binkert.org
2315793Snate@binkert.org# Workaround for bug in SCons version > 0.97d20071212
2325793Snate@binkert.org# Scons bug id: 2006 M5 Bug id: 308 
2335793Snate@binkert.orgfor root, dirs, files in os.walk(base_dir, topdown=True):
2345793Snate@binkert.org    Dir(root[len(base_dir) + 1:])
2355793Snate@binkert.org
2364382Sbinkertn@umich.edu########################################################################
2374762Snate@binkert.org#
2385344Sstever@gmail.com# Walk the tree and execute all SConscripts in subdirectories
2394382Sbinkertn@umich.edu#
2405341Sstever@gmail.com
2415742Snate@binkert.orghere = Dir('.').srcnode().abspath
2425742Snate@binkert.orgfor root, dirs, files in os.walk(base_dir, topdown=True):
2435742Snate@binkert.org    if root == here:
2445742Snate@binkert.org        # we don't want to recurse back into this SConscript
2455742Snate@binkert.org        continue
2464762Snate@binkert.org
2475742Snate@binkert.org    if 'SConscript' in files:
2485742Snate@binkert.org        build_dir = joinpath(env['BUILDDIR'], root[len(base_dir) + 1:])
2495742Snate@binkert.org        SConscript(joinpath(root, 'SConscript'), build_dir=build_dir)
2505742Snate@binkert.org
2515742Snate@binkert.orgfor extra_dir in extras_dir_list:
2525742Snate@binkert.org    prefix_len = len(dirname(extra_dir)) + 1
2535742Snate@binkert.org    for root, dirs, files in os.walk(extra_dir, topdown=True):
2545341Sstever@gmail.com        if 'SConscript' in files:
2555742Snate@binkert.org            build_dir = joinpath(env['BUILDDIR'], root[prefix_len:])
2565341Sstever@gmail.com            SConscript(joinpath(root, 'SConscript'), build_dir=build_dir)
2574773Snate@binkert.org
2586108Snate@binkert.orgfor opt in export_vars:
2591858SN/A    env.ConfigFile(opt)
2601085SN/A
2616658Snate@binkert.orgdef makeTheISA(source, target, env):
2626658Snate@binkert.org    f = file(str(target[0]), 'w')
2636658Snate@binkert.org
2646658Snate@binkert.org    isas = [ src.get_contents() for src in source ]
2656658Snate@binkert.org    target = env['TARGET_ISA']
2666658Snate@binkert.org    def define(isa):
2676658Snate@binkert.org        return isa.upper() + '_ISA'
2686658Snate@binkert.org    
2696658Snate@binkert.org    def namespace(isa):
2706658Snate@binkert.org        return isa[0].upper() + isa[1:].lower() + 'ISA' 
2716658Snate@binkert.org
2726658Snate@binkert.org
2736658Snate@binkert.org    print >>f, '#ifndef __CONFIG_THE_ISA_HH__'
2746658Snate@binkert.org    print >>f, '#define __CONFIG_THE_ISA_HH__'
2756658Snate@binkert.org    print >>f
2766658Snate@binkert.org    for i,isa in enumerate(isas):
2776658Snate@binkert.org        print >>f, '#define %s %d' % (define(isa), i + 1)
2786658Snate@binkert.org    print >>f
2796658Snate@binkert.org    print >>f, '#define THE_ISA %s' % (define(target))
2806658Snate@binkert.org    print >>f, '#define TheISA %s' % (namespace(target))
2816658Snate@binkert.org    print >>f
2826658Snate@binkert.org    print >>f, '#endif // __CONFIG_THE_ISA_HH__'  
2836658Snate@binkert.org
2846658Snate@binkert.orgenv.Command('config/the_isa.hh', map(Value, all_isa_list), makeTheISA)
2856658Snate@binkert.org
2864382Sbinkertn@umich.edu########################################################################
2874382Sbinkertn@umich.edu#
2884762Snate@binkert.org# Prevent any SimObjects from being added after this point, they
2894762Snate@binkert.org# should all have been added in the SConscripts above
2904762Snate@binkert.org#
2916654Snate@binkert.orgSimObject.fixed = True
2926654Snate@binkert.org
2935517Snate@binkert.orgclass DictImporter(object):
2945517Snate@binkert.org    '''This importer takes a dictionary of arbitrary module names that
2955517Snate@binkert.org    map to arbitrary filenames.'''
2965517Snate@binkert.org    def __init__(self, modules):
2975517Snate@binkert.org        self.modules = modules
2985517Snate@binkert.org        self.installed = set()
2995517Snate@binkert.org
3005517Snate@binkert.org    def __del__(self):
3015517Snate@binkert.org        self.unload()
3025517Snate@binkert.org
3035517Snate@binkert.org    def unload(self):
3045517Snate@binkert.org        import sys
3055517Snate@binkert.org        for module in self.installed:
3065517Snate@binkert.org            del sys.modules[module]
3075517Snate@binkert.org        self.installed = set()
3085517Snate@binkert.org
3095517Snate@binkert.org    def find_module(self, fullname, path):
3106654Snate@binkert.org        if fullname == 'm5.defines':
3115517Snate@binkert.org            return self
3125517Snate@binkert.org
3135517Snate@binkert.org        if fullname == 'm5.objects':
3145517Snate@binkert.org            return self
3155517Snate@binkert.org
3165517Snate@binkert.org        if fullname.startswith('m5.internal'):
3175517Snate@binkert.org            return None
3185517Snate@binkert.org
3196143Snate@binkert.org        source = self.modules.get(fullname, None)
3206654Snate@binkert.org        if source is not None and fullname.startswith('m5.objects'):
3215517Snate@binkert.org            return self
3225517Snate@binkert.org
3235517Snate@binkert.org        return None
3245517Snate@binkert.org
3255517Snate@binkert.org    def load_module(self, fullname):
3265517Snate@binkert.org        mod = imp.new_module(fullname)
3275517Snate@binkert.org        sys.modules[fullname] = mod
3285517Snate@binkert.org        self.installed.add(fullname)
3295517Snate@binkert.org
3305517Snate@binkert.org        mod.__loader__ = self
3315517Snate@binkert.org        if fullname == 'm5.objects':
3325517Snate@binkert.org            mod.__path__ = fullname.split('.')
3335517Snate@binkert.org            return mod
3345517Snate@binkert.org
3356654Snate@binkert.org        if fullname == 'm5.defines':
3366654Snate@binkert.org            mod.__dict__['buildEnv'] = m5.util.SmartDict(build_env)
3375517Snate@binkert.org            return mod
3385517Snate@binkert.org
3396143Snate@binkert.org        source = self.modules[fullname]
3406143Snate@binkert.org        if source.modname == '__init__':
3416143Snate@binkert.org            mod.__path__ = source.modpath
3426727Ssteve.reinhardt@amd.com        mod.__file__ = source.abspath
3435517Snate@binkert.org
3446727Ssteve.reinhardt@amd.com        exec file(source.abspath, 'r') in mod.__dict__
3455517Snate@binkert.org
3465517Snate@binkert.org        return mod
3475517Snate@binkert.org
3486654Snate@binkert.orgimport m5.SimObject
3496654Snate@binkert.orgimport m5.params
3506654Snate@binkert.org
3516654Snate@binkert.orgm5.SimObject.clear()
3526654Snate@binkert.orgm5.params.clear()
3536654Snate@binkert.org
3545517Snate@binkert.org# install the python importer so we can grab stuff from the source
3555517Snate@binkert.org# tree itself.  We can't have SimObjects added after this point or
3565517Snate@binkert.org# else we won't know about them for the rest of the stuff.
3576143Snate@binkert.orgimporter = DictImporter(PySource.modules)
3585517Snate@binkert.orgsys.meta_path[0:0] = [ importer ]
3594762Snate@binkert.org
3605517Snate@binkert.org# import all sim objects so we can populate the all_objects list
3615517Snate@binkert.org# make sure that we're working with a list, then let's sort it
3626143Snate@binkert.orgfor modname in SimObject.modnames:
3636143Snate@binkert.org    exec('from m5.objects import %s' % modname)
3645517Snate@binkert.org
3655517Snate@binkert.org# we need to unload all of the currently imported modules so that they
3665517Snate@binkert.org# will be re-imported the next time the sconscript is run
3675517Snate@binkert.orgimporter.unload()
3685517Snate@binkert.orgsys.meta_path.remove(importer)
3695517Snate@binkert.org
3705517Snate@binkert.orgsim_objects = m5.SimObject.allClasses
3715517Snate@binkert.orgall_enums = m5.params.allEnums
3725517Snate@binkert.org
3735517Snate@binkert.orgall_params = {}
3746143Snate@binkert.orgfor name,obj in sorted(sim_objects.iteritems()):
3755517Snate@binkert.org    for param in obj._params.local.values():
3766654Snate@binkert.org        # load the ptype attribute now because it depends on the
3776654Snate@binkert.org        # current version of SimObject.allClasses, but when scons
3786654Snate@binkert.org        # actually uses the value, all versions of
3796654Snate@binkert.org        # SimObject.allClasses will have been loaded
3806654Snate@binkert.org        param.ptype
3816654Snate@binkert.org
3825517Snate@binkert.org        if not hasattr(param, 'swig_decl'):
3835517Snate@binkert.org            continue
3845517Snate@binkert.org        pname = param.ptype_str
3855517Snate@binkert.org        if pname not in all_params:
3865517Snate@binkert.org            all_params[pname] = param
3874762Snate@binkert.org
3884762Snate@binkert.org########################################################################
3894762Snate@binkert.org#
3904762Snate@binkert.org# calculate extra dependencies
3914762Snate@binkert.org#
3924762Snate@binkert.orgmodule_depends = ["m5", "m5.SimObject", "m5.params"]
3936143Snate@binkert.orgdepends = [ PySource.modules[dep].tnode for dep in module_depends ]
3944762Snate@binkert.org
3954762Snate@binkert.org########################################################################
3964762Snate@binkert.org#
3974762Snate@binkert.org# Commands for the basic automatically generated python files
3984382Sbinkertn@umich.edu#
3994382Sbinkertn@umich.edu
4005517Snate@binkert.org# Generate Python file containing a dict specifying the current
4016654Snate@binkert.org# buildEnv flags.
4025517Snate@binkert.orgdef makeDefinesPyFile(target, source, env):
4035798Snate@binkert.org    build_env, hg_info = [ x.get_contents() for x in source ]
4046654Snate@binkert.org
4056654Snate@binkert.org    code = m5.util.code_formatter()
4066654Snate@binkert.org    code("""
4076654Snate@binkert.orgimport m5.internal
4086654Snate@binkert.orgimport m5.util
4096654Snate@binkert.org
4106654Snate@binkert.orgbuildEnv = m5.util.SmartDict($build_env)
4116654Snate@binkert.orghgRev = '$hg_info'
4126654Snate@binkert.org
4136654Snate@binkert.orgcompileDate = m5.internal.core.compileDate
4146669Snate@binkert.org_globals = globals()
4156669Snate@binkert.orgfor key,val in m5.internal.core.__dict__.iteritems():
4166669Snate@binkert.org    if key.startswith('flag_'):
4176669Snate@binkert.org        flag = key[5:]
4186669Snate@binkert.org        _globals[flag] = val
4196669Snate@binkert.orgdel _globals
4206654Snate@binkert.org""")
4216654Snate@binkert.org    code.write(str(target[0]))
4225517Snate@binkert.org
4235863Snate@binkert.orgdefines_info = [ Value(build_env), Value(env['HG_INFO']) ]
4245798Snate@binkert.org# Generate a file with all of the compile options in it
4255798Snate@binkert.orgenv.Command('python/m5/defines.py', defines_info, makeDefinesPyFile)
4265798Snate@binkert.orgPySource('m5', 'python/m5/defines.py')
4275798Snate@binkert.org
4285517Snate@binkert.org# Generate python file containing info about the M5 source code
4295517Snate@binkert.orgdef makeInfoPyFile(target, source, env):
4305517Snate@binkert.org    f = file(str(target[0]), 'w')
4315517Snate@binkert.org    for src in source:
4325517Snate@binkert.org        data = ''.join(file(src.srcnode().abspath, 'r').xreadlines())
4335517Snate@binkert.org        print >>f, "%s = %s" % (src, repr(data))
4345517Snate@binkert.org    f.close()
4355517Snate@binkert.org
4365798Snate@binkert.org# Generate a file that wraps the basic top level files
4375798Snate@binkert.orgenv.Command('python/m5/info.py',
4385798Snate@binkert.org            [ '#/AUTHORS', '#/LICENSE', '#/README', '#/RELEASE_NOTES' ],
4395798Snate@binkert.org            makeInfoPyFile)
4405798Snate@binkert.orgPySource('m5', 'python/m5/info.py')
4415798Snate@binkert.org
4425517Snate@binkert.org# Generate the __init__.py file for m5.objects
4435517Snate@binkert.orgdef makeObjectsInitFile(target, source, env):
4445517Snate@binkert.org    f = file(str(target[0]), 'w')
4455517Snate@binkert.org    print >>f, 'from params import *'
4465517Snate@binkert.org    print >>f, 'from m5.SimObject import *'
4475517Snate@binkert.org    for module in source:
4485517Snate@binkert.org        print >>f, 'from %s import *' % module.get_contents()
4495517Snate@binkert.org    f.close()
4505517Snate@binkert.org
4514762Snate@binkert.org# Generate an __init__.py file for the objects package
4524382Sbinkertn@umich.eduenv.Command('python/m5/objects/__init__.py',
4536143Snate@binkert.org            map(Value, SimObject.modnames),
4545517Snate@binkert.org            makeObjectsInitFile)
4554382Sbinkertn@umich.eduPySource('m5.objects', 'python/m5/objects/__init__.py')
4564382Sbinkertn@umich.edu
4574762Snate@binkert.org########################################################################
4584762Snate@binkert.org#
4594762Snate@binkert.org# Create all of the SimObject param headers and enum headers
4604762Snate@binkert.org#
4614762Snate@binkert.org
4625517Snate@binkert.orgdef createSimObjectParam(target, source, env):
4635517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
4645517Snate@binkert.org
4655517Snate@binkert.org    hh_file = file(target[0].abspath, 'w')
4665517Snate@binkert.org    name = str(source[0].get_contents())
4675517Snate@binkert.org    obj = sim_objects[name]
4685517Snate@binkert.org
4695517Snate@binkert.org    print >>hh_file, obj.cxx_decl()
4706143Snate@binkert.org    hh_file.close()
4715517Snate@binkert.org
4725517Snate@binkert.orgdef createSwigParam(target, source, env):
4735517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
4745517Snate@binkert.org
4755517Snate@binkert.org    i_file = file(target[0].abspath, 'w')
4765517Snate@binkert.org    name = str(source[0].get_contents())
4775517Snate@binkert.org    param = all_params[name]
4785517Snate@binkert.org
4795517Snate@binkert.org    for line in param.swig_decl():
4805517Snate@binkert.org        print >>i_file, line
4816143Snate@binkert.org    i_file.close()
4825517Snate@binkert.org
4835517Snate@binkert.orgdef createEnumStrings(target, source, env):
4845517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
4855517Snate@binkert.org
4865517Snate@binkert.org    cc_file = file(target[0].abspath, 'w')
4875517Snate@binkert.org    name = str(source[0].get_contents())
4885517Snate@binkert.org    obj = all_enums[name]
4895517Snate@binkert.org
4905517Snate@binkert.org    print >>cc_file, obj.cxx_def()
4915517Snate@binkert.org    cc_file.close()
4925517Snate@binkert.org
4935517Snate@binkert.orgdef createEnumParam(target, source, env):
4945517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
4955517Snate@binkert.org
4965517Snate@binkert.org    hh_file = file(target[0].abspath, 'w')
4975517Snate@binkert.org    name = str(source[0].get_contents())
4985517Snate@binkert.org    obj = all_enums[name]
4995517Snate@binkert.org
5005517Snate@binkert.org    print >>hh_file, obj.cxx_decl()
5016143Snate@binkert.org    hh_file.close()
5025517Snate@binkert.org
5034762Snate@binkert.org# Generate all of the SimObject param struct header files
5044762Snate@binkert.orgparams_hh_files = []
5056143Snate@binkert.orgfor name,simobj in sorted(sim_objects.iteritems()):
5066143Snate@binkert.org    py_source = PySource.modules[simobj.__module__]
5076143Snate@binkert.org    extra_deps = [ py_source.tnode ]
5084762Snate@binkert.org
5094762Snate@binkert.org    hh_file = File('params/%s.hh' % name)
5104762Snate@binkert.org    params_hh_files.append(hh_file)
5115517Snate@binkert.org    env.Command(hh_file, Value(name), createSimObjectParam)
5124762Snate@binkert.org    env.Depends(hh_file, depends + extra_deps)
5134762Snate@binkert.org
5144762Snate@binkert.org# Generate any parameter header files needed
5155463Snate@binkert.orgparams_i_files = []
5165517Snate@binkert.orgfor name,param in all_params.iteritems():
5176656Snate@binkert.org    i_file = File('params/%s_%s.i' % (name, param.file_ext))
5185463Snate@binkert.org    params_i_files.append(i_file)
5195517Snate@binkert.org    env.Command(i_file, Value(name), createSwigParam)
5204762Snate@binkert.org    env.Depends(i_file, depends)
5214762Snate@binkert.org
5224762Snate@binkert.org# Generate all enum header files
5236143Snate@binkert.orgfor name,enum in sorted(all_enums.iteritems()):
5246143Snate@binkert.org    py_source = PySource.modules[enum.__module__]
5256143Snate@binkert.org    extra_deps = [ py_source.tnode ]
5264762Snate@binkert.org
5274762Snate@binkert.org    cc_file = File('enums/%s.cc' % name)
5285517Snate@binkert.org    env.Command(cc_file, Value(name), createEnumStrings)
5294762Snate@binkert.org    env.Depends(cc_file, depends + extra_deps)
5304762Snate@binkert.org    Source(cc_file)
5314762Snate@binkert.org
5324762Snate@binkert.org    hh_file = File('enums/%s.hh' % name)
5335517Snate@binkert.org    env.Command(hh_file, Value(name), createEnumParam)
5344762Snate@binkert.org    env.Depends(hh_file, depends + extra_deps)
5354762Snate@binkert.org
5364762Snate@binkert.org# Build the big monolithic swigged params module (wraps all SimObject
5374762Snate@binkert.org# param structs and enum structs)
5385517Snate@binkert.orgdef buildParams(target, source, env):
5395517Snate@binkert.org    names = [ s.get_contents() for s in source ]
5405517Snate@binkert.org    objs = [ sim_objects[name] for name in names ]
5415517Snate@binkert.org    out = file(target[0].abspath, 'w')
5425517Snate@binkert.org
5435517Snate@binkert.org    ordered_objs = []
5445517Snate@binkert.org    obj_seen = set()
5455517Snate@binkert.org    def order_obj(obj):
5465517Snate@binkert.org        name = str(obj)
5475517Snate@binkert.org        if name in obj_seen:
5485517Snate@binkert.org            return
5495517Snate@binkert.org
5505517Snate@binkert.org        obj_seen.add(name)
5515517Snate@binkert.org        if str(obj) != 'SimObject':
5525517Snate@binkert.org            order_obj(obj.__bases__[0])
5535517Snate@binkert.org
5545517Snate@binkert.org        ordered_objs.append(obj)
5555517Snate@binkert.org
5565517Snate@binkert.org    for obj in objs:
5575517Snate@binkert.org        order_obj(obj)
5585517Snate@binkert.org
5595517Snate@binkert.org    enums = set()
5605517Snate@binkert.org    predecls = []
5615517Snate@binkert.org    pd_seen = set()
5625517Snate@binkert.org
5635517Snate@binkert.org    def add_pds(*pds):
5645517Snate@binkert.org        for pd in pds:
5655517Snate@binkert.org            if pd not in pd_seen:
5665517Snate@binkert.org                predecls.append(pd)
5675517Snate@binkert.org                pd_seen.add(pd)
5685517Snate@binkert.org
5695517Snate@binkert.org    for obj in ordered_objs:
5705517Snate@binkert.org        params = obj._params.local.values()
5715517Snate@binkert.org        for param in params:
5725517Snate@binkert.org            ptype = param.ptype
5735517Snate@binkert.org            if issubclass(ptype, m5.params.Enum):
5745517Snate@binkert.org                if ptype not in enums:
5755517Snate@binkert.org                    enums.add(ptype)
5765517Snate@binkert.org            pds = param.swig_predecls()
5775517Snate@binkert.org            if isinstance(pds, (list, tuple)):
5785517Snate@binkert.org                add_pds(*pds)
5795517Snate@binkert.org            else:
5805517Snate@binkert.org                add_pds(pds)
5815517Snate@binkert.org
5825517Snate@binkert.org    print >>out, '%module params'
5835517Snate@binkert.org
5845517Snate@binkert.org    print >>out, '%{'
5855517Snate@binkert.org    for obj in ordered_objs:
5865517Snate@binkert.org        print >>out, '#include "params/%s.hh"' % obj
5875517Snate@binkert.org    print >>out, '%}'
5885517Snate@binkert.org
5895517Snate@binkert.org    for pd in predecls:
5905517Snate@binkert.org        print >>out, pd
5915517Snate@binkert.org
5925517Snate@binkert.org    enums = list(enums)
5935517Snate@binkert.org    enums.sort()
5945517Snate@binkert.org    for enum in enums:
5955517Snate@binkert.org        print >>out, '%%include "enums/%s.hh"' % enum.__name__
5965517Snate@binkert.org    print >>out
5975517Snate@binkert.org
5985517Snate@binkert.org    for obj in ordered_objs:
5995517Snate@binkert.org        if obj.swig_objdecls:
6005517Snate@binkert.org            for decl in obj.swig_objdecls:
6015517Snate@binkert.org                print >>out, decl
6025517Snate@binkert.org            continue
6035517Snate@binkert.org
6045610Snate@binkert.org        class_path = obj.cxx_class.split('::')
6055623Snate@binkert.org        classname = class_path[-1]
6065623Snate@binkert.org        namespaces = class_path[:-1]
6075623Snate@binkert.org        namespaces.reverse()
6085610Snate@binkert.org
6095517Snate@binkert.org        code = ''
6105623Snate@binkert.org
6115623Snate@binkert.org        if namespaces:
6125623Snate@binkert.org            code += '// avoid name conflicts\n'
6135623Snate@binkert.org            sep_string = '_COLONS_'
6145623Snate@binkert.org            flat_name = sep_string.join(class_path)
6155623Snate@binkert.org            code += '%%rename(%s) %s;\n' % (flat_name, classname)
6165623Snate@binkert.org
6175517Snate@binkert.org        code += '// stop swig from creating/wrapping default ctor/dtor\n'
6185610Snate@binkert.org        code += '%%nodefault %s;\n' % classname
6195610Snate@binkert.org        code += 'class %s ' % classname
6205610Snate@binkert.org        if obj._base:
6215610Snate@binkert.org            code += ': public %s' % obj._base.cxx_class
6225517Snate@binkert.org        code += ' {};\n'
6235517Snate@binkert.org
6245610Snate@binkert.org        for ns in namespaces:
6255610Snate@binkert.org            new_code = 'namespace %s {\n' % ns
6265517Snate@binkert.org            new_code += code
6275517Snate@binkert.org            new_code += '}\n'
6285517Snate@binkert.org            code = new_code
6295517Snate@binkert.org
6305517Snate@binkert.org        print >>out, code
6315517Snate@binkert.org
6325517Snate@binkert.org    print >>out, '%%include "src/sim/sim_object_params.hh"' % obj
6335517Snate@binkert.org    for obj in ordered_objs:
6345517Snate@binkert.org        print >>out, '%%include "params/%s.hh"' % obj
6355517Snate@binkert.org
6364762Snate@binkert.orgparams_file = File('params/params.i')
6376143Snate@binkert.orgnames = sorted(sim_objects.keys())
6386143Snate@binkert.orgenv.Command(params_file, map(Value, names), buildParams)
6395463Snate@binkert.orgenv.Depends(params_file, params_hh_files + params_i_files + depends)
6404762Snate@binkert.orgSwigSource('m5.objects', params_file)
6414762Snate@binkert.org
6424762Snate@binkert.org# Build all swig modules
6436143Snate@binkert.orgfor swig in SwigSource.all:
6446143Snate@binkert.org    env.Command([swig.cc_source.tnode, swig.py_source.tnode], swig.tnode,
6454382Sbinkertn@umich.edu                '$SWIG $SWIGFLAGS -outdir ${TARGETS[1].dir} '
6464382Sbinkertn@umich.edu                '-o ${TARGETS[0]} $SOURCES')
6476143Snate@binkert.org    env.Depends(swig.py_source.tnode, swig.tnode)
6486143Snate@binkert.org    env.Depends(swig.cc_source.tnode, swig.tnode)
6494382Sbinkertn@umich.edu
6504762Snate@binkert.org# Generate the main swig init file
6515517Snate@binkert.orgdef makeSwigInit(target, source, env):
6525517Snate@binkert.org    f = file(str(target[0]), 'w')
6535517Snate@binkert.org    print >>f, 'extern "C" {'
6545517Snate@binkert.org    for module in source:
6555517Snate@binkert.org        print >>f, '    void init_%s();' % module.get_contents()
6565517Snate@binkert.org    print >>f, '}'
6575522Snate@binkert.org    print >>f, 'void initSwig() {'
6585517Snate@binkert.org    for module in source:
6595517Snate@binkert.org        print >>f, '    init_%s();' % module.get_contents()
6605517Snate@binkert.org    print >>f, '}'
6615517Snate@binkert.org    f.close()
6625517Snate@binkert.org
6636143Snate@binkert.orgenv.Command('python/swig/init.cc',
6646143Snate@binkert.org            map(Value, sorted(s.module for s in SwigSource.all)),
6656143Snate@binkert.org            makeSwigInit)
6665522Snate@binkert.orgSource('python/swig/init.cc')
6674382Sbinkertn@umich.edu
6686229Snate@binkert.orgdef getFlags(source_flags):
6696229Snate@binkert.org    flagsMap = {}
6706229Snate@binkert.org    flagsList = []
6716229Snate@binkert.org    for s in source_flags:
6726229Snate@binkert.org        val = eval(s.get_contents())
6736229Snate@binkert.org        name, compound, desc = val
6746229Snate@binkert.org        flagsList.append(val)
6756229Snate@binkert.org        flagsMap[name] = bool(compound)
6766229Snate@binkert.org    
6776229Snate@binkert.org    for name, compound, desc in flagsList:
6786229Snate@binkert.org        for flag in compound:
6796229Snate@binkert.org            if flag not in flagsMap:
6806229Snate@binkert.org                raise AttributeError, "Trace flag %s not found" % flag
6816229Snate@binkert.org            if flagsMap[flag]:
6826229Snate@binkert.org                raise AttributeError, \
6836229Snate@binkert.org                    "Compound flag can't point to another compound flag"
6846229Snate@binkert.org
6856229Snate@binkert.org    flagsList.sort()
6866229Snate@binkert.org    return flagsList
6876229Snate@binkert.org
6886229Snate@binkert.org
6895192Ssaidi@eecs.umich.edu# Generate traceflags.py
6905517Snate@binkert.orgdef traceFlagsPy(target, source, env):
6915517Snate@binkert.org    assert(len(target) == 1)
6925517Snate@binkert.org
6935517Snate@binkert.org    f = file(str(target[0]), 'w')
6946229Snate@binkert.org   
6956229Snate@binkert.org    allFlags = getFlags(source)
6965799Snate@binkert.org
6975799Snate@binkert.org    print >>f, 'basic = ['
6985517Snate@binkert.org    for flag, compound, desc in allFlags:
6995517Snate@binkert.org        if not compound:
7005517Snate@binkert.org            print >>f, "    '%s'," % flag
7015517Snate@binkert.org    print >>f, "    ]"
7025517Snate@binkert.org    print >>f
7035517Snate@binkert.org
7045799Snate@binkert.org    print >>f, 'compound = ['
7055517Snate@binkert.org    print >>f, "    'All',"
7065517Snate@binkert.org    for flag, compound, desc in allFlags:
7075517Snate@binkert.org        if compound:
7085517Snate@binkert.org            print >>f, "    '%s'," % flag
7095517Snate@binkert.org    print >>f, "    ]"
7105517Snate@binkert.org    print >>f
7115517Snate@binkert.org
7125799Snate@binkert.org    print >>f, "all = frozenset(basic + compound)"
7135517Snate@binkert.org    print >>f
7145517Snate@binkert.org
7155799Snate@binkert.org    print >>f, 'compoundMap = {'
7165517Snate@binkert.org    all = tuple([flag for flag,compound,desc in allFlags if not compound])
7175517Snate@binkert.org    print >>f, "    'All' : %s," % (all, )
7185517Snate@binkert.org    for flag, compound, desc in allFlags:
7195517Snate@binkert.org        if compound:
7205517Snate@binkert.org            print >>f, "    '%s' : %s," % (flag, compound)
7215517Snate@binkert.org    print >>f, "    }"
7225517Snate@binkert.org    print >>f
7235517Snate@binkert.org
7245799Snate@binkert.org    print >>f, 'descriptions = {'
7255517Snate@binkert.org    print >>f, "    'All' : 'All flags',"
7265517Snate@binkert.org    for flag, compound, desc in allFlags:
7275517Snate@binkert.org        print >>f, "    '%s' : '%s'," % (flag, desc)
7285517Snate@binkert.org    print >>f, "    }"
7295517Snate@binkert.org
7305517Snate@binkert.org    f.close()
7315517Snate@binkert.org
7325517Snate@binkert.orgdef traceFlagsCC(target, source, env):
7335517Snate@binkert.org    assert(len(target) == 1)
7345517Snate@binkert.org
7355517Snate@binkert.org    f = file(str(target[0]), 'w')
7365517Snate@binkert.org
7376229Snate@binkert.org    allFlags = getFlags(source)
7385517Snate@binkert.org
7395517Snate@binkert.org    # file header
7405517Snate@binkert.org    print >>f, '''
7415517Snate@binkert.org/*
7425517Snate@binkert.org * DO NOT EDIT THIS FILE! Automatically generated
7435517Snate@binkert.org */
7445517Snate@binkert.org
7455517Snate@binkert.org#include "base/traceflags.hh"
7465517Snate@binkert.org
7475517Snate@binkert.orgusing namespace Trace;
7485517Snate@binkert.org
7495517Snate@binkert.orgconst char *Trace::flagStrings[] =
7505517Snate@binkert.org{'''
7515517Snate@binkert.org
7525517Snate@binkert.org    # The string array is used by SimpleEnumParam to map the strings
7535517Snate@binkert.org    # provided by the user to enum values.
7545517Snate@binkert.org    for flag, compound, desc in allFlags:
7555517Snate@binkert.org        if not compound:
7565517Snate@binkert.org            print >>f, '    "%s",' % flag
7575517Snate@binkert.org
7585517Snate@binkert.org    print >>f, '    "All",'
7595517Snate@binkert.org    for flag, compound, desc in allFlags:
7605517Snate@binkert.org        if compound:
7615517Snate@binkert.org            print >>f, '    "%s",' % flag
7625517Snate@binkert.org
7635517Snate@binkert.org    print >>f, '};'
7645517Snate@binkert.org    print >>f
7655517Snate@binkert.org    print >>f, 'const int Trace::numFlagStrings = %d;' % (len(allFlags) + 1)
7665517Snate@binkert.org    print >>f
7675517Snate@binkert.org
7685517Snate@binkert.org    #
7695517Snate@binkert.org    # Now define the individual compound flag arrays.  There is an array
7705517Snate@binkert.org    # for each compound flag listing the component base flags.
7715517Snate@binkert.org    #
7725517Snate@binkert.org    all = tuple([flag for flag,compound,desc in allFlags if not compound])
7735517Snate@binkert.org    print >>f, 'static const Flags AllMap[] = {'
7745517Snate@binkert.org    for flag, compound, desc in allFlags:
7755517Snate@binkert.org        if not compound:
7765517Snate@binkert.org            print >>f, "    %s," % flag
7775517Snate@binkert.org    print >>f, '};'
7785517Snate@binkert.org    print >>f
7795517Snate@binkert.org
7805517Snate@binkert.org    for flag, compound, desc in allFlags:
7815517Snate@binkert.org        if not compound:
7825517Snate@binkert.org            continue
7835517Snate@binkert.org        print >>f, 'static const Flags %sMap[] = {' % flag
7845517Snate@binkert.org        for flag in compound:
7855517Snate@binkert.org            print >>f, "    %s," % flag
7865517Snate@binkert.org        print >>f, "    (Flags)-1"
7875517Snate@binkert.org        print >>f, '};'
7885517Snate@binkert.org        print >>f
7895517Snate@binkert.org
7905517Snate@binkert.org    #
7915517Snate@binkert.org    # Finally the compoundFlags[] array maps the compound flags
7925517Snate@binkert.org    # to their individual arrays/
7935517Snate@binkert.org    #
7945517Snate@binkert.org    print >>f, 'const Flags *Trace::compoundFlags[] ='
7955517Snate@binkert.org    print >>f, '{'
7965517Snate@binkert.org    print >>f, '    AllMap,'
7975517Snate@binkert.org    for flag, compound, desc in allFlags:
7985517Snate@binkert.org        if compound:
7995517Snate@binkert.org            print >>f, '    %sMap,' % flag
8005517Snate@binkert.org    # file trailer
8015517Snate@binkert.org    print >>f, '};'
8025517Snate@binkert.org
8035517Snate@binkert.org    f.close()
8045517Snate@binkert.org
8055517Snate@binkert.orgdef traceFlagsHH(target, source, env):
8065517Snate@binkert.org    assert(len(target) == 1)
8075517Snate@binkert.org
8085517Snate@binkert.org    f = file(str(target[0]), 'w')
8095517Snate@binkert.org
8106229Snate@binkert.org    allFlags = getFlags(source)
8115517Snate@binkert.org
8125517Snate@binkert.org    # file header boilerplate
8135517Snate@binkert.org    print >>f, '''
8145517Snate@binkert.org/*
8155517Snate@binkert.org * DO NOT EDIT THIS FILE!
8165517Snate@binkert.org *
8175517Snate@binkert.org * Automatically generated from traceflags.py
8185517Snate@binkert.org */
8195517Snate@binkert.org
8205517Snate@binkert.org#ifndef __BASE_TRACE_FLAGS_HH__
8215517Snate@binkert.org#define __BASE_TRACE_FLAGS_HH__
8225517Snate@binkert.org
8235517Snate@binkert.orgnamespace Trace {
8245517Snate@binkert.org
8255517Snate@binkert.orgenum Flags {'''
8265517Snate@binkert.org
8275517Snate@binkert.org    # Generate the enum.  Base flags come first, then compound flags.
8285517Snate@binkert.org    idx = 0
8295517Snate@binkert.org    for flag, compound, desc in allFlags:
8305517Snate@binkert.org        if not compound:
8315517Snate@binkert.org            print >>f, '    %s = %d,' % (flag, idx)
8325517Snate@binkert.org            idx += 1
8335517Snate@binkert.org
8345517Snate@binkert.org    numBaseFlags = idx
8355517Snate@binkert.org    print >>f, '    NumFlags = %d,' % idx
8365517Snate@binkert.org
8375517Snate@binkert.org    # put a comment in here to separate base from compound flags
8385517Snate@binkert.org    print >>f, '''
8395517Snate@binkert.org// The remaining enum values are *not* valid indices for Trace::flags.
8405517Snate@binkert.org// They are "compound" flags, which correspond to sets of base
8415517Snate@binkert.org// flags, and are used by changeFlag.'''
8425517Snate@binkert.org
8435517Snate@binkert.org    print >>f, '    All = %d,' % idx
8445517Snate@binkert.org    idx += 1
8455517Snate@binkert.org    for flag, compound, desc in allFlags:
8465517Snate@binkert.org        if compound:
8475517Snate@binkert.org            print >>f, '    %s = %d,' % (flag, idx)
8485517Snate@binkert.org            idx += 1
8495517Snate@binkert.org
8505517Snate@binkert.org    numCompoundFlags = idx - numBaseFlags
8515517Snate@binkert.org    print >>f, '    NumCompoundFlags = %d' % numCompoundFlags
8525517Snate@binkert.org
8535517Snate@binkert.org    # trailer boilerplate
8545517Snate@binkert.org    print >>f, '''\
8555517Snate@binkert.org}; // enum Flags
8565517Snate@binkert.org
8575517Snate@binkert.org// Array of strings for SimpleEnumParam
8585517Snate@binkert.orgextern const char *flagStrings[];
8595517Snate@binkert.orgextern const int numFlagStrings;
8605517Snate@binkert.org
8615517Snate@binkert.org// Array of arraay pointers: for each compound flag, gives the list of
8625517Snate@binkert.org// base flags to set.  Inidividual flag arrays are terminated by -1.
8635517Snate@binkert.orgextern const Flags *compoundFlags[];
8645517Snate@binkert.org
8655517Snate@binkert.org/* namespace Trace */ }
8665517Snate@binkert.org
8675517Snate@binkert.org#endif // __BASE_TRACE_FLAGS_HH__
8685517Snate@binkert.org'''
8695517Snate@binkert.org
8705517Snate@binkert.org    f.close()
8715517Snate@binkert.org
8726143Snate@binkert.orgflags = map(Value, trace_flags.values())
8735517Snate@binkert.orgenv.Command('base/traceflags.py', flags, traceFlagsPy)
8745192Ssaidi@eecs.umich.eduPySource('m5', 'base/traceflags.py')
8755192Ssaidi@eecs.umich.edu
8765517Snate@binkert.orgenv.Command('base/traceflags.hh', flags, traceFlagsHH)
8775517Snate@binkert.orgenv.Command('base/traceflags.cc', flags, traceFlagsCC)
8785192Ssaidi@eecs.umich.eduSource('base/traceflags.cc')
8795192Ssaidi@eecs.umich.edu
8805522Snate@binkert.org# embed python files.  All .py files that have been indicated by a
8815522Snate@binkert.org# PySource() call in a SConscript need to be embedded into the M5
8825522Snate@binkert.org# library.  To do that, we compile the file to byte code, marshal the
8835522Snate@binkert.org# byte code, compress it, and then generate an assembly file that
8845522Snate@binkert.org# inserts the result into the data section with symbols indicating the
8855522Snate@binkert.org# beginning, and end (and with the size at the end)
8865522Snate@binkert.orgdef objectifyPyFile(target, source, env):
8875522Snate@binkert.org    '''Action function to compile a .py into a code object, marshal
8885522Snate@binkert.org    it, compress it, and stick it into an asm file so the code appears
8895522Snate@binkert.org    as just bytes with a label in the data section'''
8905517Snate@binkert.org
8915522Snate@binkert.org    src = file(str(source[0]), 'r').read()
8925522Snate@binkert.org    dst = file(str(target[0]), 'w')
8935517Snate@binkert.org
8946143Snate@binkert.org    pysource = PySource.tnodes[source[0]]
8956727Ssteve.reinhardt@amd.com    compiled = compile(src, pysource.abspath, 'exec')
8965522Snate@binkert.org    marshalled = marshal.dumps(compiled)
8975522Snate@binkert.org    compressed = zlib.compress(marshalled)
8985522Snate@binkert.org    data = compressed
8995517Snate@binkert.org
9005522Snate@binkert.org    # Some C/C++ compilers prepend an underscore to global symbol
9015522Snate@binkert.org    # names, so if they're going to do that, we need to prepend that
9025522Snate@binkert.org    # leading underscore to globals in the assembly file.
9035522Snate@binkert.org    if env['LEADING_UNDERSCORE']:
9045522Snate@binkert.org        sym = '_' + pysource.symname
9055522Snate@binkert.org    else:
9065522Snate@binkert.org        sym = pysource.symname
9075522Snate@binkert.org
9085522Snate@binkert.org    step = 16
9095522Snate@binkert.org    print >>dst, ".data"
9105522Snate@binkert.org    print >>dst, ".globl %s_beg" % sym
9115522Snate@binkert.org    print >>dst, ".globl %s_end" % sym
9125522Snate@binkert.org    print >>dst, "%s_beg:" % sym
9135522Snate@binkert.org    for i in xrange(0, len(data), step):
9145522Snate@binkert.org        x = array.array('B', data[i:i+step])
9155522Snate@binkert.org        print >>dst, ".byte", ','.join([str(d) for d in x])
9165522Snate@binkert.org    print >>dst, "%s_end:" % sym
9175522Snate@binkert.org    print >>dst, ".long %d" % len(marshalled)
9185522Snate@binkert.org
9196143Snate@binkert.orgfor source in PySource.all:
9205522Snate@binkert.org    env.Command(source.assembly, source.tnode, objectifyPyFile)
9215522Snate@binkert.org    Source(source.assembly)
9224382Sbinkertn@umich.edu
9235522Snate@binkert.org# Generate init_python.cc which creates a bunch of EmbeddedPyModule
9245522Snate@binkert.org# structs that describe the embedded python code.  One such struct
9255522Snate@binkert.org# contains information about the importer that python uses to get at
9265522Snate@binkert.org# the embedded files, and then there's a list of all of the rest that
9275522Snate@binkert.org# the importer uses to load the rest on demand.
9285522Snate@binkert.orgdef pythonInit(target, source, env):
9295522Snate@binkert.org    dst = file(str(target[0]), 'w')
9304382Sbinkertn@umich.edu
9315522Snate@binkert.org    def dump_mod(sym, endchar=','):
9326143Snate@binkert.org        pysource = PySource.symnames[sym]
9335522Snate@binkert.org        print >>dst, '    { "%s",' % pysource.arcname
9345522Snate@binkert.org        print >>dst, '      "%s",' % pysource.modpath
9355522Snate@binkert.org        print >>dst, '       %s_beg, %s_end,' % (sym, sym)
9365522Snate@binkert.org        print >>dst, '       %s_end - %s_beg,' % (sym, sym)
9375522Snate@binkert.org        print >>dst, '       *(int *)%s_end }%s'  % (sym, endchar)
9385522Snate@binkert.org    
9395522Snate@binkert.org    print >>dst, '#include "sim/init.hh"'
9405522Snate@binkert.org
9415522Snate@binkert.org    for sym in source:
9425522Snate@binkert.org        sym = sym.get_contents()
9435522Snate@binkert.org        print >>dst, "extern const char %s_beg[], %s_end[];" % (sym, sym)
9445522Snate@binkert.org
9455522Snate@binkert.org    print >>dst, "const EmbeddedPyModule embeddedPyImporter = "
9465522Snate@binkert.org    dump_mod("PyEMB_importer", endchar=';');
9475522Snate@binkert.org    print >>dst
9485522Snate@binkert.org
9495522Snate@binkert.org    print >>dst, "const EmbeddedPyModule embeddedPyModules[] = {"
9505522Snate@binkert.org    for i,sym in enumerate(source):
9515522Snate@binkert.org        sym = sym.get_contents()
9525522Snate@binkert.org        if sym == "PyEMB_importer":
9535522Snate@binkert.org            # Skip the importer since we've already exported it
9545522Snate@binkert.org            continue
9555522Snate@binkert.org        dump_mod(sym)
9565522Snate@binkert.org    print >>dst, "    { 0, 0, 0, 0, 0, 0 }"
9575522Snate@binkert.org    print >>dst, "};"
9585522Snate@binkert.org
9596143Snate@binkert.org
9606143Snate@binkert.orgenv.Command('sim/init_python.cc',
9616143Snate@binkert.org            map(Value, (s.symname for s in PySource.all)),
9626143Snate@binkert.org            pythonInit)
9635522Snate@binkert.orgSource('sim/init_python.cc')
9644382Sbinkertn@umich.edu
9654382Sbinkertn@umich.edu########################################################################
9664382Sbinkertn@umich.edu#
9674382Sbinkertn@umich.edu# Define binaries.  Each different build type (debug, opt, etc.) gets
9684382Sbinkertn@umich.edu# a slightly different build environment.
9694382Sbinkertn@umich.edu#
9704382Sbinkertn@umich.edu
9714382Sbinkertn@umich.edu# List of constructed environments to pass back to SConstruct
9724382Sbinkertn@umich.eduenvList = []
9734382Sbinkertn@umich.edu
9746143Snate@binkert.orgdate_source = Source('base/date.cc', skip_lib=True)
975955SN/A
9762655Sstever@eecs.umich.edu# Function to create a new build environment as clone of current
9772655Sstever@eecs.umich.edu# environment 'env' with modified object suffix and optional stripped
9782655Sstever@eecs.umich.edu# binary.  Additional keyword arguments are appended to corresponding
9792655Sstever@eecs.umich.edu# build environment vars.
9802655Sstever@eecs.umich.edudef makeEnv(label, objsfx, strip = False, **kwargs):
9815601Snate@binkert.org    # SCons doesn't know to append a library suffix when there is a '.' in the
9825601Snate@binkert.org    # name.  Use '_' instead.
9835601Snate@binkert.org    libname = 'm5_' + label
9845601Snate@binkert.org    exename = 'm5.' + label
9855522Snate@binkert.org
9865863Snate@binkert.org    new_env = env.Clone(OBJSUFFIX=objsfx, SHOBJSUFFIX=objsfx + 's')
9875601Snate@binkert.org    new_env.Label = label
9885601Snate@binkert.org    new_env.Append(**kwargs)
9895601Snate@binkert.org
9905863Snate@binkert.org    swig_env = new_env.Clone()
9916143Snate@binkert.org    swig_env.Append(CCFLAGS='-Werror')
9925559Snate@binkert.org    if env['GCC']:
9935559Snate@binkert.org        swig_env.Append(CCFLAGS='-Wno-uninitialized')
9945559Snate@binkert.org        swig_env.Append(CCFLAGS='-Wno-sign-compare')
9955559Snate@binkert.org        swig_env.Append(CCFLAGS='-Wno-parentheses')
9965601Snate@binkert.org
9976143Snate@binkert.org    werror_env = new_env.Clone()
9986143Snate@binkert.org    werror_env.Append(CCFLAGS='-Werror')
9996143Snate@binkert.org
10006143Snate@binkert.org    def make_obj(source, static, extra_deps = None):
10016143Snate@binkert.org        '''This function adds the specified source to the correct
10026143Snate@binkert.org        build environment, and returns the corresponding SCons Object
10036143Snate@binkert.org        nodes'''
10046143Snate@binkert.org
10056143Snate@binkert.org        if source.swig:
10066143Snate@binkert.org            env = swig_env
10076143Snate@binkert.org        elif source.Werror:
10086143Snate@binkert.org            env = werror_env
10096143Snate@binkert.org        else:
10106143Snate@binkert.org            env = new_env
10116143Snate@binkert.org
10126143Snate@binkert.org        if static:
10136143Snate@binkert.org            obj = env.StaticObject(source.tnode)
10146143Snate@binkert.org        else:
10156143Snate@binkert.org            obj = env.SharedObject(source.tnode)
10166143Snate@binkert.org
10176143Snate@binkert.org        if extra_deps:
10186143Snate@binkert.org            env.Depends(obj, extra_deps)
10196143Snate@binkert.org
10206143Snate@binkert.org        return obj
10216143Snate@binkert.org
10226143Snate@binkert.org    static_objs = [ make_obj(s, True) for s in Source.get(skip_lib=False)]
10236143Snate@binkert.org    shared_objs = [ make_obj(s, False) for s in Source.get(skip_lib=False)]
10246143Snate@binkert.org
10256143Snate@binkert.org    static_date = make_obj(date_source, static=True, extra_deps=static_objs)
10266143Snate@binkert.org    static_objs.append(static_date)
10276143Snate@binkert.org    
10286143Snate@binkert.org    shared_date = make_obj(date_source, static=False, extra_deps=shared_objs)
10296240Snate@binkert.org    shared_objs.append(shared_date)
10305554Snate@binkert.org
10315522Snate@binkert.org    # First make a library of everything but main() so other programs can
10325522Snate@binkert.org    # link against m5.
10335797Snate@binkert.org    static_lib = new_env.StaticLibrary(libname, static_objs)
10345797Snate@binkert.org    shared_lib = new_env.SharedLibrary(libname, shared_objs)
10355522Snate@binkert.org
10365584Snate@binkert.org    for target, sources in unit_tests:
10376143Snate@binkert.org        objs = [ make_obj(s, static=True) for s in sources ]
10385862Snate@binkert.org        new_env.Program("unittest/%s.%s" % (target, label), objs + static_objs)
10395584Snate@binkert.org
10405601Snate@binkert.org    # Now link a stub with main() and the static library.
10416143Snate@binkert.org    bin_objs = [make_obj(s, True) for s in Source.get(bin_only=True) ]
10426143Snate@binkert.org    progname = exename
10432655Sstever@eecs.umich.edu    if strip:
10446143Snate@binkert.org        progname += '.unstripped'
10456143Snate@binkert.org
10466143Snate@binkert.org    targets = new_env.Program(progname, bin_objs + static_objs)
10476143Snate@binkert.org
10486143Snate@binkert.org    if strip:
10494007Ssaidi@eecs.umich.edu        if sys.platform == 'sunos5':
10504596Sbinkertn@umich.edu            cmd = 'cp $SOURCE $TARGET; strip $TARGET'
10514007Ssaidi@eecs.umich.edu        else:
10524596Sbinkertn@umich.edu            cmd = 'strip $SOURCE -o $TARGET'
10536143Snate@binkert.org        targets = new_env.Command(exename, progname, cmd)
10545522Snate@binkert.org            
10555601Snate@binkert.org    new_env.M5Binary = targets[0]
10565601Snate@binkert.org    envList.append(new_env)
10572655Sstever@eecs.umich.edu
1058955SN/A# Debug binary
10593918Ssaidi@eecs.umich.educcflags = {}
10603918Ssaidi@eecs.umich.eduif env['GCC']:
10613918Ssaidi@eecs.umich.edu    if sys.platform == 'sunos5':
10623918Ssaidi@eecs.umich.edu        ccflags['debug'] = '-gstabs+'
10633918Ssaidi@eecs.umich.edu    else:
10643918Ssaidi@eecs.umich.edu        ccflags['debug'] = '-ggdb3'
10653918Ssaidi@eecs.umich.edu    ccflags['opt'] = '-g -O3'
10663918Ssaidi@eecs.umich.edu    ccflags['fast'] = '-O3'
10673918Ssaidi@eecs.umich.edu    ccflags['prof'] = '-O3 -g -pg'
10683918Ssaidi@eecs.umich.eduelif env['SUNCC']:
10693918Ssaidi@eecs.umich.edu    ccflags['debug'] = '-g0'
10703918Ssaidi@eecs.umich.edu    ccflags['opt'] = '-g -O'
10713918Ssaidi@eecs.umich.edu    ccflags['fast'] = '-fast'
10723918Ssaidi@eecs.umich.edu    ccflags['prof'] = '-fast -g -pg'
10733940Ssaidi@eecs.umich.eduelif env['ICC']:
10743940Ssaidi@eecs.umich.edu    ccflags['debug'] = '-g -O0'
10753940Ssaidi@eecs.umich.edu    ccflags['opt'] = '-g -O'
10763942Ssaidi@eecs.umich.edu    ccflags['fast'] = '-fast'
10773940Ssaidi@eecs.umich.edu    ccflags['prof'] = '-fast -g -pg'
10783515Ssaidi@eecs.umich.eduelse:
10793918Ssaidi@eecs.umich.edu    print 'Unknown compiler, please fix compiler options'
10804762Snate@binkert.org    Exit(1)
10813515Ssaidi@eecs.umich.edu
10822655Sstever@eecs.umich.edumakeEnv('debug', '.do',
10833918Ssaidi@eecs.umich.edu        CCFLAGS = Split(ccflags['debug']),
10843619Sbinkertn@umich.edu        CPPDEFINES = ['DEBUG', 'TRACING_ON=1'])
1085955SN/A
1086955SN/A# Optimized binary
10872655Sstever@eecs.umich.edumakeEnv('opt', '.o',
10883918Ssaidi@eecs.umich.edu        CCFLAGS = Split(ccflags['opt']),
10893619Sbinkertn@umich.edu        CPPDEFINES = ['TRACING_ON=1'])
1090955SN/A
1091955SN/A# "Fast" binary
10922655Sstever@eecs.umich.edumakeEnv('fast', '.fo', strip = True,
10933918Ssaidi@eecs.umich.edu        CCFLAGS = Split(ccflags['fast']),
10943619Sbinkertn@umich.edu        CPPDEFINES = ['NDEBUG', 'TRACING_ON=0'])
1095955SN/A
1096955SN/A# Profiled binary
10972655Sstever@eecs.umich.edumakeEnv('prof', '.po',
10983918Ssaidi@eecs.umich.edu        CCFLAGS = Split(ccflags['prof']),
10993683Sstever@eecs.umich.edu        CPPDEFINES = ['NDEBUG', 'TRACING_ON=0'],
11002655Sstever@eecs.umich.edu        LINKFLAGS = '-pg')
11011869SN/A
11021869SN/AReturn('envList')
1103