SConscript revision 11974
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
3711974Sgabeblack@google.comimport subprocess
38955SN/Aimport sys
395522Snate@binkert.orgimport zlib
404202Sbinkertn@umich.edu
415742Snate@binkert.orgfrom os.path import basename, dirname, exists, isdir, isfile, join as joinpath
42955SN/A
434381Sbinkertn@umich.eduimport SCons
444381Sbinkertn@umich.edu
458334Snate@binkert.org# This file defines how to build a particular configuration of gem5
46955SN/A# based on variable settings in the 'env' build environment.
47955SN/A
484202Sbinkertn@umich.eduImport('*')
49955SN/A
504382Sbinkertn@umich.edu# Children need to see the environment
514382Sbinkertn@umich.eduExport('env')
524382Sbinkertn@umich.edu
536654Snate@binkert.orgbuild_env = [(opt, env[opt]) for opt in export_vars]
545517Snate@binkert.org
558614Sgblack@eecs.umich.edufrom m5.util import code_formatter, compareVersions
567674Snate@binkert.org
576143Snate@binkert.org########################################################################
586143Snate@binkert.org# Code for adding source files of various types
596143Snate@binkert.org#
608233Snate@binkert.org# When specifying a source file of some type, a set of guards can be
618233Snate@binkert.org# specified for that file.  When get() is used to find the files, if
628233Snate@binkert.org# get specifies a set of filters, only files that match those filters
638233Snate@binkert.org# will be accepted (unspecified filters on files are assumed to be
648233Snate@binkert.org# false).  Current filters are:
658334Snate@binkert.org#     main -- specifies the gem5 main() function
668334Snate@binkert.org#     skip_lib -- do not put this file into the gem5 library
6710453SAndrew.Bardsley@arm.com#     skip_no_python -- do not put this file into a no_python library
6810453SAndrew.Bardsley@arm.com#       as it embeds compiled Python
698233Snate@binkert.org#     <unittest> -- unit tests use filters based on the unit test name
708233Snate@binkert.org#
718233Snate@binkert.org# A parent can now be specified for a source file and default filter
728233Snate@binkert.org# values will be retrieved recursively from parents (children override
738233Snate@binkert.org# parents).
748233Snate@binkert.org#
756143Snate@binkert.orgclass SourceMeta(type):
768233Snate@binkert.org    '''Meta class for source files that keeps track of all files of a
778233Snate@binkert.org    particular type and has a get function for finding all functions
788233Snate@binkert.org    of a certain type that match a set of guards'''
796143Snate@binkert.org    def __init__(cls, name, bases, dict):
806143Snate@binkert.org        super(SourceMeta, cls).__init__(name, bases, dict)
816143Snate@binkert.org        cls.all = []
8211308Santhony.gutierrez@amd.com
838233Snate@binkert.org    def get(cls, **guards):
848233Snate@binkert.org        '''Find all files that match the specified guards.  If a source
858233Snate@binkert.org        file does not specify a flag, the default is False'''
866143Snate@binkert.org        for src in cls.all:
878233Snate@binkert.org            for flag,value in guards.iteritems():
888233Snate@binkert.org                # if the flag is found and has a different value, skip
898233Snate@binkert.org                # this file
908233Snate@binkert.org                if src.all_guards.get(flag, False) != value:
916143Snate@binkert.org                    break
926143Snate@binkert.org            else:
936143Snate@binkert.org                yield src
944762Snate@binkert.org
956143Snate@binkert.orgclass SourceFile(object):
968233Snate@binkert.org    '''Base object that encapsulates the notion of a source file.
978233Snate@binkert.org    This includes, the source node, target node, various manipulations
988233Snate@binkert.org    of those.  A source file also specifies a set of guards which
998233Snate@binkert.org    describing which builds the source file applies to.  A parent can
1008233Snate@binkert.org    also be specified to get default guards from'''
1016143Snate@binkert.org    __metaclass__ = SourceMeta
1028233Snate@binkert.org    def __init__(self, source, parent=None, **guards):
1038233Snate@binkert.org        self.guards = guards
1048233Snate@binkert.org        self.parent = parent
1058233Snate@binkert.org
1066143Snate@binkert.org        tnode = source
1076143Snate@binkert.org        if not isinstance(source, SCons.Node.FS.File):
1086143Snate@binkert.org            tnode = File(source)
1096143Snate@binkert.org
1106143Snate@binkert.org        self.tnode = tnode
1116143Snate@binkert.org        self.snode = tnode.srcnode()
1126143Snate@binkert.org
1136143Snate@binkert.org        for base in type(self).__mro__:
1146143Snate@binkert.org            if issubclass(base, SourceFile):
1157065Snate@binkert.org                base.all.append(self)
1166143Snate@binkert.org
1178233Snate@binkert.org    @property
1188233Snate@binkert.org    def filename(self):
1198233Snate@binkert.org        return str(self.tnode)
1208233Snate@binkert.org
1218233Snate@binkert.org    @property
1228233Snate@binkert.org    def dirname(self):
1238233Snate@binkert.org        return dirname(self.filename)
1248233Snate@binkert.org
1258233Snate@binkert.org    @property
1268233Snate@binkert.org    def basename(self):
1278233Snate@binkert.org        return basename(self.filename)
1288233Snate@binkert.org
1298233Snate@binkert.org    @property
1308233Snate@binkert.org    def extname(self):
1318233Snate@binkert.org        index = self.basename.rfind('.')
1328233Snate@binkert.org        if index <= 0:
1338233Snate@binkert.org            # dot files aren't extensions
1348233Snate@binkert.org            return self.basename, None
1358233Snate@binkert.org
1368233Snate@binkert.org        return self.basename[:index], self.basename[index+1:]
1378233Snate@binkert.org
1388233Snate@binkert.org    @property
1398233Snate@binkert.org    def all_guards(self):
1408233Snate@binkert.org        '''find all guards for this object getting default values
1418233Snate@binkert.org        recursively from its parents'''
1428233Snate@binkert.org        guards = {}
1438233Snate@binkert.org        if self.parent:
1448233Snate@binkert.org            guards.update(self.parent.guards)
1458233Snate@binkert.org        guards.update(self.guards)
1468233Snate@binkert.org        return guards
1478233Snate@binkert.org
1486143Snate@binkert.org    def __lt__(self, other): return self.filename < other.filename
1496143Snate@binkert.org    def __le__(self, other): return self.filename <= other.filename
1506143Snate@binkert.org    def __gt__(self, other): return self.filename > other.filename
1516143Snate@binkert.org    def __ge__(self, other): return self.filename >= other.filename
1526143Snate@binkert.org    def __eq__(self, other): return self.filename == other.filename
1536143Snate@binkert.org    def __ne__(self, other): return self.filename != other.filename
1549982Satgutier@umich.edu
15510196SCurtis.Dunham@arm.com    @staticmethod
15610196SCurtis.Dunham@arm.com    def done():
15710196SCurtis.Dunham@arm.com        def disabled(cls, name, *ignored):
15810196SCurtis.Dunham@arm.com            raise RuntimeError("Additional SourceFile '%s'" % name,\
15910196SCurtis.Dunham@arm.com                  "declared, but targets deps are already fixed.")
16010196SCurtis.Dunham@arm.com        SourceFile.__init__ = disabled
16110196SCurtis.Dunham@arm.com
16210196SCurtis.Dunham@arm.com
1636143Snate@binkert.orgclass Source(SourceFile):
1646143Snate@binkert.org    '''Add a c/c++ source file to the build'''
1658945Ssteve.reinhardt@amd.com    def __init__(self, source, Werror=True, swig=False, **guards):
1668233Snate@binkert.org        '''specify the source file, and any guards'''
1678233Snate@binkert.org        super(Source, self).__init__(source, **guards)
1686143Snate@binkert.org
1698945Ssteve.reinhardt@amd.com        self.Werror = Werror
1706143Snate@binkert.org        self.swig = swig
1716143Snate@binkert.org
1726143Snate@binkert.orgclass PySource(SourceFile):
1736143Snate@binkert.org    '''Add a python source file to the named package'''
1745522Snate@binkert.org    invalid_sym_char = re.compile('[^A-z0-9_]')
1756143Snate@binkert.org    modules = {}
1766143Snate@binkert.org    tnodes = {}
1776143Snate@binkert.org    symnames = {}
1789982Satgutier@umich.edu
1798233Snate@binkert.org    def __init__(self, package, source, **guards):
1808233Snate@binkert.org        '''specify the python package, the source file, and any guards'''
1818233Snate@binkert.org        super(PySource, self).__init__(source, **guards)
1826143Snate@binkert.org
1836143Snate@binkert.org        modname,ext = self.extname
1846143Snate@binkert.org        assert ext == 'py'
1856143Snate@binkert.org
1865522Snate@binkert.org        if package:
1875522Snate@binkert.org            path = package.split('.')
1885522Snate@binkert.org        else:
1895522Snate@binkert.org            path = []
1905604Snate@binkert.org
1915604Snate@binkert.org        modpath = path[:]
1926143Snate@binkert.org        if modname != '__init__':
1936143Snate@binkert.org            modpath += [ modname ]
1944762Snate@binkert.org        modpath = '.'.join(modpath)
1954762Snate@binkert.org
1966143Snate@binkert.org        arcpath = path + [ self.basename ]
1976727Ssteve.reinhardt@amd.com        abspath = self.snode.abspath
1986727Ssteve.reinhardt@amd.com        if not exists(abspath):
1996727Ssteve.reinhardt@amd.com            abspath = self.tnode.abspath
2004762Snate@binkert.org
2016143Snate@binkert.org        self.package = package
2026143Snate@binkert.org        self.modname = modname
2036143Snate@binkert.org        self.modpath = modpath
2046143Snate@binkert.org        self.arcname = joinpath(*arcpath)
2056727Ssteve.reinhardt@amd.com        self.abspath = abspath
2066143Snate@binkert.org        self.compiled = File(self.filename + 'c')
2077674Snate@binkert.org        self.cpp = File(self.filename + '.cc')
2087674Snate@binkert.org        self.symname = PySource.invalid_sym_char.sub('_', modpath)
2095604Snate@binkert.org
2106143Snate@binkert.org        PySource.modules[modpath] = self
2116143Snate@binkert.org        PySource.tnodes[self.tnode] = self
2126143Snate@binkert.org        PySource.symnames[self.symname] = self
2134762Snate@binkert.org
2146143Snate@binkert.orgclass SimObject(PySource):
2154762Snate@binkert.org    '''Add a SimObject python file as a python source object and add
2164762Snate@binkert.org    it to a list of sim object modules'''
2174762Snate@binkert.org
2186143Snate@binkert.org    fixed = False
2196143Snate@binkert.org    modnames = []
2204762Snate@binkert.org
2218233Snate@binkert.org    def __init__(self, source, **guards):
2228233Snate@binkert.org        '''Specify the source file and any guards (automatically in
2238233Snate@binkert.org        the m5.objects package)'''
2248233Snate@binkert.org        super(SimObject, self).__init__('m5.objects', source, **guards)
2256143Snate@binkert.org        if self.fixed:
2266143Snate@binkert.org            raise AttributeError, "Too late to call SimObject now."
2274762Snate@binkert.org
2286143Snate@binkert.org        bisect.insort_right(SimObject.modnames, self.modname)
2294762Snate@binkert.org
2306143Snate@binkert.orgclass SwigSource(SourceFile):
2314762Snate@binkert.org    '''Add a swig file to build'''
2326143Snate@binkert.org
2338233Snate@binkert.org    def __init__(self, package, source, **guards):
2348233Snate@binkert.org        '''Specify the python package, the source file, and any guards'''
23510453SAndrew.Bardsley@arm.com        super(SwigSource, self).__init__(source, skip_no_python=True, **guards)
2366143Snate@binkert.org
2376143Snate@binkert.org        modname,ext = self.extname
2386143Snate@binkert.org        assert ext == 'i'
2396143Snate@binkert.org
24011548Sandreas.hansson@arm.com        self.package = package
2416143Snate@binkert.org        self.module = modname
2426143Snate@binkert.org        cc_file = joinpath(self.dirname, modname + '_wrap.cc')
2436143Snate@binkert.org        py_file = joinpath(self.dirname, modname + '.py')
2446143Snate@binkert.org
24510453SAndrew.Bardsley@arm.com        self.cc_source = Source(cc_file, swig=True, parent=self, **guards)
24610453SAndrew.Bardsley@arm.com        self.py_source = PySource(package, py_file, parent=self, **guards)
247955SN/A
2489396Sandreas.hansson@arm.comclass ProtoBuf(SourceFile):
2499396Sandreas.hansson@arm.com    '''Add a Protocol Buffer to build'''
2509396Sandreas.hansson@arm.com
2519396Sandreas.hansson@arm.com    def __init__(self, source, **guards):
2529396Sandreas.hansson@arm.com        '''Specify the source file, and any guards'''
2539396Sandreas.hansson@arm.com        super(ProtoBuf, self).__init__(source, **guards)
2549396Sandreas.hansson@arm.com
2559396Sandreas.hansson@arm.com        # Get the file name and the extension
2569396Sandreas.hansson@arm.com        modname,ext = self.extname
2579396Sandreas.hansson@arm.com        assert ext == 'proto'
2589396Sandreas.hansson@arm.com
2599396Sandreas.hansson@arm.com        # Currently, we stick to generating the C++ headers, so we
2609396Sandreas.hansson@arm.com        # only need to track the source and header.
2619930Sandreas.hansson@arm.com        self.cc_file = File(modname + '.pb.cc')
2629930Sandreas.hansson@arm.com        self.hh_file = File(modname + '.pb.h')
2639396Sandreas.hansson@arm.com
2648235Snate@binkert.orgclass UnitTest(object):
2658235Snate@binkert.org    '''Create a UnitTest'''
2666143Snate@binkert.org
2678235Snate@binkert.org    all = []
2689003SAli.Saidi@ARM.com    def __init__(self, target, *sources, **kwargs):
2698235Snate@binkert.org        '''Specify the target name and any sources.  Sources that are
2708235Snate@binkert.org        not SourceFiles are evalued with Source().  All files are
2718235Snate@binkert.org        guarded with a guard of the same name as the UnitTest
2728235Snate@binkert.org        target.'''
2738235Snate@binkert.org
2748235Snate@binkert.org        srcs = []
2758235Snate@binkert.org        for src in sources:
2768235Snate@binkert.org            if not isinstance(src, SourceFile):
2778235Snate@binkert.org                src = Source(src, skip_lib=True)
2788235Snate@binkert.org            src.guards[target] = True
2798235Snate@binkert.org            srcs.append(src)
2808235Snate@binkert.org
2818235Snate@binkert.org        self.sources = srcs
2828235Snate@binkert.org        self.target = target
2839003SAli.Saidi@ARM.com        self.main = kwargs.get('main', False)
2848235Snate@binkert.org        UnitTest.all.append(self)
2855584Snate@binkert.org
2864382Sbinkertn@umich.edu# Children should have access
2874202Sbinkertn@umich.eduExport('Source')
2884382Sbinkertn@umich.eduExport('PySource')
2894382Sbinkertn@umich.eduExport('SimObject')
2904382Sbinkertn@umich.eduExport('SwigSource')
2919396Sandreas.hansson@arm.comExport('ProtoBuf')
2925584Snate@binkert.orgExport('UnitTest')
2934382Sbinkertn@umich.edu
2944382Sbinkertn@umich.edu########################################################################
2954382Sbinkertn@umich.edu#
2968232Snate@binkert.org# Debug Flags
2975192Ssaidi@eecs.umich.edu#
2988232Snate@binkert.orgdebug_flags = {}
2998232Snate@binkert.orgdef DebugFlag(name, desc=None):
3008232Snate@binkert.org    if name in debug_flags:
3015192Ssaidi@eecs.umich.edu        raise AttributeError, "Flag %s already specified" % name
3028232Snate@binkert.org    debug_flags[name] = (name, (), desc)
3035192Ssaidi@eecs.umich.edu
3045799Snate@binkert.orgdef CompoundFlag(name, flags, desc=None):
3058232Snate@binkert.org    if name in debug_flags:
3065192Ssaidi@eecs.umich.edu        raise AttributeError, "Flag %s already specified" % name
3075192Ssaidi@eecs.umich.edu
3085192Ssaidi@eecs.umich.edu    compound = tuple(flags)
3098232Snate@binkert.org    debug_flags[name] = (name, compound, desc)
3105192Ssaidi@eecs.umich.edu
3118232Snate@binkert.orgExport('DebugFlag')
3125192Ssaidi@eecs.umich.eduExport('CompoundFlag')
3135192Ssaidi@eecs.umich.edu
3145192Ssaidi@eecs.umich.edu########################################################################
3155192Ssaidi@eecs.umich.edu#
3164382Sbinkertn@umich.edu# Set some compiler variables
3174382Sbinkertn@umich.edu#
3184382Sbinkertn@umich.edu
3192667Sstever@eecs.umich.edu# Include file paths are rooted in this directory.  SCons will
3202667Sstever@eecs.umich.edu# automatically expand '.' to refer to both the source directory and
3212667Sstever@eecs.umich.edu# the corresponding build directory to pick up generated include
3222667Sstever@eecs.umich.edu# files.
3232667Sstever@eecs.umich.eduenv.Append(CPPPATH=Dir('.'))
3242667Sstever@eecs.umich.edu
3255742Snate@binkert.orgfor extra_dir in extras_dir_list:
3265742Snate@binkert.org    env.Append(CPPPATH=Dir(extra_dir))
3275742Snate@binkert.org
3285793Snate@binkert.org# Workaround for bug in SCons version > 0.97d20071212
3298334Snate@binkert.org# Scons bug id: 2006 gem5 Bug id: 308
3305793Snate@binkert.orgfor root, dirs, files in os.walk(base_dir, topdown=True):
3315793Snate@binkert.org    Dir(root[len(base_dir) + 1:])
3325793Snate@binkert.org
3334382Sbinkertn@umich.edu########################################################################
3344762Snate@binkert.org#
3355344Sstever@gmail.com# Walk the tree and execute all SConscripts in subdirectories
3364382Sbinkertn@umich.edu#
3375341Sstever@gmail.com
3385742Snate@binkert.orghere = Dir('.').srcnode().abspath
3395742Snate@binkert.orgfor root, dirs, files in os.walk(base_dir, topdown=True):
3405742Snate@binkert.org    if root == here:
3415742Snate@binkert.org        # we don't want to recurse back into this SConscript
3425742Snate@binkert.org        continue
3434762Snate@binkert.org
3445742Snate@binkert.org    if 'SConscript' in files:
3455742Snate@binkert.org        build_dir = joinpath(env['BUILDDIR'], root[len(base_dir) + 1:])
3467722Sgblack@eecs.umich.edu        SConscript(joinpath(root, 'SConscript'), variant_dir=build_dir)
3475742Snate@binkert.org
3485742Snate@binkert.orgfor extra_dir in extras_dir_list:
3495742Snate@binkert.org    prefix_len = len(dirname(extra_dir)) + 1
3509930Sandreas.hansson@arm.com
3519930Sandreas.hansson@arm.com    # Also add the corresponding build directory to pick up generated
3529930Sandreas.hansson@arm.com    # include files.
3539930Sandreas.hansson@arm.com    env.Append(CPPPATH=Dir(joinpath(env['BUILDDIR'], extra_dir[prefix_len:])))
3549930Sandreas.hansson@arm.com
3555742Snate@binkert.org    for root, dirs, files in os.walk(extra_dir, topdown=True):
3568242Sbradley.danofsky@amd.com        # if build lives in the extras directory, don't walk down it
3578242Sbradley.danofsky@amd.com        if 'build' in dirs:
3588242Sbradley.danofsky@amd.com            dirs.remove('build')
3598242Sbradley.danofsky@amd.com
3605341Sstever@gmail.com        if 'SConscript' in files:
3615742Snate@binkert.org            build_dir = joinpath(env['BUILDDIR'], root[prefix_len:])
3627722Sgblack@eecs.umich.edu            SConscript(joinpath(root, 'SConscript'), variant_dir=build_dir)
3634773Snate@binkert.org
3646108Snate@binkert.orgfor opt in export_vars:
3651858SN/A    env.ConfigFile(opt)
3661085SN/A
3676658Snate@binkert.orgdef makeTheISA(source, target, env):
3686658Snate@binkert.org    isas = [ src.get_contents() for src in source ]
3697673Snate@binkert.org    target_isa = env['TARGET_ISA']
3706658Snate@binkert.org    def define(isa):
3716658Snate@binkert.org        return isa.upper() + '_ISA'
37211308Santhony.gutierrez@amd.com
3736658Snate@binkert.org    def namespace(isa):
37411308Santhony.gutierrez@amd.com        return isa[0].upper() + isa[1:].lower() + 'ISA'
3756658Snate@binkert.org
3766658Snate@binkert.org
3777673Snate@binkert.org    code = code_formatter()
3787673Snate@binkert.org    code('''\
3797673Snate@binkert.org#ifndef __CONFIG_THE_ISA_HH__
3807673Snate@binkert.org#define __CONFIG_THE_ISA_HH__
3817673Snate@binkert.org
3827673Snate@binkert.org''')
3837673Snate@binkert.org
38410467Sandreas.hansson@arm.com    # create defines for the preprocessing and compile-time determination
3856658Snate@binkert.org    for i,isa in enumerate(isas):
3867673Snate@binkert.org        code('#define $0 $1', define(isa), i + 1)
38710467Sandreas.hansson@arm.com    code()
38810467Sandreas.hansson@arm.com
38910467Sandreas.hansson@arm.com    # create an enum for any run-time determination of the ISA, we
39010467Sandreas.hansson@arm.com    # reuse the same name as the namespaces
39110467Sandreas.hansson@arm.com    code('enum class Arch {')
39210467Sandreas.hansson@arm.com    for i,isa in enumerate(isas):
39310467Sandreas.hansson@arm.com        if i + 1 == len(isas):
39410467Sandreas.hansson@arm.com            code('  $0 = $1', namespace(isa), define(isa))
39510467Sandreas.hansson@arm.com        else:
39610467Sandreas.hansson@arm.com            code('  $0 = $1,', namespace(isa), define(isa))
39710467Sandreas.hansson@arm.com    code('};')
3987673Snate@binkert.org
3997673Snate@binkert.org    code('''
4007673Snate@binkert.org
4017673Snate@binkert.org#define THE_ISA ${{define(target_isa)}}
4027673Snate@binkert.org#define TheISA ${{namespace(target_isa)}}
4039048SAli.Saidi@ARM.com#define THE_ISA_STR "${{target_isa}}"
4047673Snate@binkert.org
4057673Snate@binkert.org#endif // __CONFIG_THE_ISA_HH__''')
4067673Snate@binkert.org
4077673Snate@binkert.org    code.write(str(target[0]))
4086658Snate@binkert.org
4097756SAli.Saidi@ARM.comenv.Command('config/the_isa.hh', map(Value, all_isa_list),
4107816Ssteve.reinhardt@amd.com            MakeAction(makeTheISA, Transform("CFG ISA", 0)))
4116658Snate@binkert.org
41211308Santhony.gutierrez@amd.comdef makeTheGPUISA(source, target, env):
41311308Santhony.gutierrez@amd.com    isas = [ src.get_contents() for src in source ]
41411308Santhony.gutierrez@amd.com    target_gpu_isa = env['TARGET_GPU_ISA']
41511308Santhony.gutierrez@amd.com    def define(isa):
41611308Santhony.gutierrez@amd.com        return isa.upper() + '_ISA'
41711308Santhony.gutierrez@amd.com
41811308Santhony.gutierrez@amd.com    def namespace(isa):
41911308Santhony.gutierrez@amd.com        return isa[0].upper() + isa[1:].lower() + 'ISA'
42011308Santhony.gutierrez@amd.com
42111308Santhony.gutierrez@amd.com
42211308Santhony.gutierrez@amd.com    code = code_formatter()
42311308Santhony.gutierrez@amd.com    code('''\
42411308Santhony.gutierrez@amd.com#ifndef __CONFIG_THE_GPU_ISA_HH__
42511308Santhony.gutierrez@amd.com#define __CONFIG_THE_GPU_ISA_HH__
42611308Santhony.gutierrez@amd.com
42711308Santhony.gutierrez@amd.com''')
42811308Santhony.gutierrez@amd.com
42911308Santhony.gutierrez@amd.com    # create defines for the preprocessing and compile-time determination
43011308Santhony.gutierrez@amd.com    for i,isa in enumerate(isas):
43111308Santhony.gutierrez@amd.com        code('#define $0 $1', define(isa), i + 1)
43211308Santhony.gutierrez@amd.com    code()
43311308Santhony.gutierrez@amd.com
43411308Santhony.gutierrez@amd.com    # create an enum for any run-time determination of the ISA, we
43511308Santhony.gutierrez@amd.com    # reuse the same name as the namespaces
43611308Santhony.gutierrez@amd.com    code('enum class GPUArch {')
43711308Santhony.gutierrez@amd.com    for i,isa in enumerate(isas):
43811308Santhony.gutierrez@amd.com        if i + 1 == len(isas):
43911308Santhony.gutierrez@amd.com            code('  $0 = $1', namespace(isa), define(isa))
44011308Santhony.gutierrez@amd.com        else:
44111308Santhony.gutierrez@amd.com            code('  $0 = $1,', namespace(isa), define(isa))
44211308Santhony.gutierrez@amd.com    code('};')
44311308Santhony.gutierrez@amd.com
44411308Santhony.gutierrez@amd.com    code('''
44511308Santhony.gutierrez@amd.com
44611308Santhony.gutierrez@amd.com#define THE_GPU_ISA ${{define(target_gpu_isa)}}
44711308Santhony.gutierrez@amd.com#define TheGpuISA ${{namespace(target_gpu_isa)}}
44811308Santhony.gutierrez@amd.com#define THE_GPU_ISA_STR "${{target_gpu_isa}}"
44911308Santhony.gutierrez@amd.com
45011308Santhony.gutierrez@amd.com#endif // __CONFIG_THE_GPU_ISA_HH__''')
45111308Santhony.gutierrez@amd.com
45211308Santhony.gutierrez@amd.com    code.write(str(target[0]))
45311308Santhony.gutierrez@amd.com
45411308Santhony.gutierrez@amd.comenv.Command('config/the_gpu_isa.hh', map(Value, all_gpu_isa_list),
45511308Santhony.gutierrez@amd.com            MakeAction(makeTheGPUISA, Transform("CFG ISA", 0)))
45611308Santhony.gutierrez@amd.com
4574382Sbinkertn@umich.edu########################################################################
4584382Sbinkertn@umich.edu#
4594762Snate@binkert.org# Prevent any SimObjects from being added after this point, they
4604762Snate@binkert.org# should all have been added in the SConscripts above
4614762Snate@binkert.org#
4626654Snate@binkert.orgSimObject.fixed = True
4636654Snate@binkert.org
4645517Snate@binkert.orgclass DictImporter(object):
4655517Snate@binkert.org    '''This importer takes a dictionary of arbitrary module names that
4665517Snate@binkert.org    map to arbitrary filenames.'''
4675517Snate@binkert.org    def __init__(self, modules):
4685517Snate@binkert.org        self.modules = modules
4695517Snate@binkert.org        self.installed = set()
4705517Snate@binkert.org
4715517Snate@binkert.org    def __del__(self):
4725517Snate@binkert.org        self.unload()
4735517Snate@binkert.org
4745517Snate@binkert.org    def unload(self):
4755517Snate@binkert.org        import sys
4765517Snate@binkert.org        for module in self.installed:
4775517Snate@binkert.org            del sys.modules[module]
4785517Snate@binkert.org        self.installed = set()
4795517Snate@binkert.org
4805517Snate@binkert.org    def find_module(self, fullname, path):
4816654Snate@binkert.org        if fullname == 'm5.defines':
4825517Snate@binkert.org            return self
4835517Snate@binkert.org
4845517Snate@binkert.org        if fullname == 'm5.objects':
4855517Snate@binkert.org            return self
4865517Snate@binkert.org
48711802Sandreas.sandberg@arm.com        if fullname.startswith('_m5'):
4885517Snate@binkert.org            return None
4895517Snate@binkert.org
4906143Snate@binkert.org        source = self.modules.get(fullname, None)
4916654Snate@binkert.org        if source is not None and fullname.startswith('m5.objects'):
4925517Snate@binkert.org            return self
4935517Snate@binkert.org
4945517Snate@binkert.org        return None
4955517Snate@binkert.org
4965517Snate@binkert.org    def load_module(self, fullname):
4975517Snate@binkert.org        mod = imp.new_module(fullname)
4985517Snate@binkert.org        sys.modules[fullname] = mod
4995517Snate@binkert.org        self.installed.add(fullname)
5005517Snate@binkert.org
5015517Snate@binkert.org        mod.__loader__ = self
5025517Snate@binkert.org        if fullname == 'm5.objects':
5035517Snate@binkert.org            mod.__path__ = fullname.split('.')
5045517Snate@binkert.org            return mod
5055517Snate@binkert.org
5066654Snate@binkert.org        if fullname == 'm5.defines':
5076654Snate@binkert.org            mod.__dict__['buildEnv'] = m5.util.SmartDict(build_env)
5085517Snate@binkert.org            return mod
5095517Snate@binkert.org
5106143Snate@binkert.org        source = self.modules[fullname]
5116143Snate@binkert.org        if source.modname == '__init__':
5126143Snate@binkert.org            mod.__path__ = source.modpath
5136727Ssteve.reinhardt@amd.com        mod.__file__ = source.abspath
5145517Snate@binkert.org
5156727Ssteve.reinhardt@amd.com        exec file(source.abspath, 'r') in mod.__dict__
5165517Snate@binkert.org
5175517Snate@binkert.org        return mod
5185517Snate@binkert.org
5196654Snate@binkert.orgimport m5.SimObject
5206654Snate@binkert.orgimport m5.params
5217673Snate@binkert.orgfrom m5.util import code_formatter
5226654Snate@binkert.org
5236654Snate@binkert.orgm5.SimObject.clear()
5246654Snate@binkert.orgm5.params.clear()
5256654Snate@binkert.org
5265517Snate@binkert.org# install the python importer so we can grab stuff from the source
5275517Snate@binkert.org# tree itself.  We can't have SimObjects added after this point or
5285517Snate@binkert.org# else we won't know about them for the rest of the stuff.
5296143Snate@binkert.orgimporter = DictImporter(PySource.modules)
5305517Snate@binkert.orgsys.meta_path[0:0] = [ importer ]
5314762Snate@binkert.org
5325517Snate@binkert.org# import all sim objects so we can populate the all_objects list
5335517Snate@binkert.org# make sure that we're working with a list, then let's sort it
5346143Snate@binkert.orgfor modname in SimObject.modnames:
5356143Snate@binkert.org    exec('from m5.objects import %s' % modname)
5365517Snate@binkert.org
5375517Snate@binkert.org# we need to unload all of the currently imported modules so that they
5385517Snate@binkert.org# will be re-imported the next time the sconscript is run
5395517Snate@binkert.orgimporter.unload()
5405517Snate@binkert.orgsys.meta_path.remove(importer)
5415517Snate@binkert.org
5425517Snate@binkert.orgsim_objects = m5.SimObject.allClasses
5435517Snate@binkert.orgall_enums = m5.params.allEnums
5445517Snate@binkert.org
5459338SAndreas.Sandberg@arm.comif m5.SimObject.noCxxHeader:
5469338SAndreas.Sandberg@arm.com    print >> sys.stderr, \
5479338SAndreas.Sandberg@arm.com        "warning: At least one SimObject lacks a header specification. " \
5489338SAndreas.Sandberg@arm.com        "This can cause unexpected results in the generated SWIG " \
5499338SAndreas.Sandberg@arm.com        "wrappers."
5509338SAndreas.Sandberg@arm.com
5518596Ssteve.reinhardt@amd.com# Find param types that need to be explicitly wrapped with swig.
5528596Ssteve.reinhardt@amd.com# These will be recognized because the ParamDesc will have a
5538596Ssteve.reinhardt@amd.com# swig_decl() method.  Most param types are based on types that don't
5548596Ssteve.reinhardt@amd.com# need this, either because they're based on native types (like Int)
5558596Ssteve.reinhardt@amd.com# or because they're SimObjects (which get swigged independently).
5568596Ssteve.reinhardt@amd.com# For now the only things handled here are VectorParam types.
5578596Ssteve.reinhardt@amd.comparams_to_swig = {}
5586143Snate@binkert.orgfor name,obj in sorted(sim_objects.iteritems()):
5595517Snate@binkert.org    for param in obj._params.local.values():
5606654Snate@binkert.org        # load the ptype attribute now because it depends on the
5616654Snate@binkert.org        # current version of SimObject.allClasses, but when scons
5626654Snate@binkert.org        # actually uses the value, all versions of
5636654Snate@binkert.org        # SimObject.allClasses will have been loaded
5646654Snate@binkert.org        param.ptype
5656654Snate@binkert.org
5665517Snate@binkert.org        if not hasattr(param, 'swig_decl'):
5675517Snate@binkert.org            continue
5685517Snate@binkert.org        pname = param.ptype_str
5698596Ssteve.reinhardt@amd.com        if pname not in params_to_swig:
5708596Ssteve.reinhardt@amd.com            params_to_swig[pname] = param
5714762Snate@binkert.org
5724762Snate@binkert.org########################################################################
5734762Snate@binkert.org#
5744762Snate@binkert.org# calculate extra dependencies
5754762Snate@binkert.org#
5764762Snate@binkert.orgmodule_depends = ["m5", "m5.SimObject", "m5.params"]
5777675Snate@binkert.orgdepends = [ PySource.modules[dep].snode for dep in module_depends ]
57810584Sandreas.hansson@arm.comdepends.sort(key = lambda x: x.name)
5794762Snate@binkert.org
5804762Snate@binkert.org########################################################################
5814762Snate@binkert.org#
5824762Snate@binkert.org# Commands for the basic automatically generated python files
5834382Sbinkertn@umich.edu#
5844382Sbinkertn@umich.edu
5855517Snate@binkert.org# Generate Python file containing a dict specifying the current
5866654Snate@binkert.org# buildEnv flags.
5875517Snate@binkert.orgdef makeDefinesPyFile(target, source, env):
5888126Sgblack@eecs.umich.edu    build_env = source[0].get_contents()
5896654Snate@binkert.org
5907673Snate@binkert.org    code = code_formatter()
5916654Snate@binkert.org    code("""
59211802Sandreas.sandberg@arm.comimport _m5.core
5936654Snate@binkert.orgimport m5.util
5946654Snate@binkert.org
5956654Snate@binkert.orgbuildEnv = m5.util.SmartDict($build_env)
5966654Snate@binkert.org
59711802Sandreas.sandberg@arm.comcompileDate = _m5.core.compileDate
5986669Snate@binkert.org_globals = globals()
59911802Sandreas.sandberg@arm.comfor key,val in _m5.core.__dict__.iteritems():
6006669Snate@binkert.org    if key.startswith('flag_'):
6016669Snate@binkert.org        flag = key[5:]
6026669Snate@binkert.org        _globals[flag] = val
6036669Snate@binkert.orgdel _globals
6046654Snate@binkert.org""")
6057673Snate@binkert.org    code.write(target[0].abspath)
6065517Snate@binkert.org
6078126Sgblack@eecs.umich.edudefines_info = Value(build_env)
6085798Snate@binkert.org# Generate a file with all of the compile options in it
6097756SAli.Saidi@ARM.comenv.Command('python/m5/defines.py', defines_info,
6107816Ssteve.reinhardt@amd.com            MakeAction(makeDefinesPyFile, Transform("DEFINES", 0)))
6115798Snate@binkert.orgPySource('m5', 'python/m5/defines.py')
6125798Snate@binkert.org
6135517Snate@binkert.org# Generate python file containing info about the M5 source code
6145517Snate@binkert.orgdef makeInfoPyFile(target, source, env):
6157673Snate@binkert.org    code = code_formatter()
6165517Snate@binkert.org    for src in source:
6175517Snate@binkert.org        data = ''.join(file(src.srcnode().abspath, 'r').xreadlines())
6187673Snate@binkert.org        code('$src = ${{repr(data)}}')
6197673Snate@binkert.org    code.write(str(target[0]))
6205517Snate@binkert.org
6215798Snate@binkert.org# Generate a file that wraps the basic top level files
6225798Snate@binkert.orgenv.Command('python/m5/info.py',
6238333Snate@binkert.org            [ '#/COPYING', '#/LICENSE', '#/README', ],
6247816Ssteve.reinhardt@amd.com            MakeAction(makeInfoPyFile, Transform("INFO")))
6255798Snate@binkert.orgPySource('m5', 'python/m5/info.py')
6265798Snate@binkert.org
6274762Snate@binkert.org########################################################################
6284762Snate@binkert.org#
6294762Snate@binkert.org# Create all of the SimObject param headers and enum headers
6304762Snate@binkert.org#
6314762Snate@binkert.org
6328596Ssteve.reinhardt@amd.comdef createSimObjectParamStruct(target, source, env):
6335517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6345517Snate@binkert.org
6355517Snate@binkert.org    name = str(source[0].get_contents())
6365517Snate@binkert.org    obj = sim_objects[name]
6375517Snate@binkert.org
6387673Snate@binkert.org    code = code_formatter()
6398596Ssteve.reinhardt@amd.com    obj.cxx_param_decl(code)
6407673Snate@binkert.org    code.write(target[0].abspath)
6415517Snate@binkert.org
64210458Sandreas.hansson@arm.comdef createSimObjectCxxConfig(is_header):
64310458Sandreas.hansson@arm.com    def body(target, source, env):
64410458Sandreas.hansson@arm.com        assert len(target) == 1 and len(source) == 1
64510458Sandreas.hansson@arm.com
64610458Sandreas.hansson@arm.com        name = str(source[0].get_contents())
64710458Sandreas.hansson@arm.com        obj = sim_objects[name]
64810458Sandreas.hansson@arm.com
64910458Sandreas.hansson@arm.com        code = code_formatter()
65010458Sandreas.hansson@arm.com        obj.cxx_config_param_file(code, is_header)
65110458Sandreas.hansson@arm.com        code.write(target[0].abspath)
65210458Sandreas.hansson@arm.com    return body
65310458Sandreas.hansson@arm.com
6548596Ssteve.reinhardt@amd.comdef createParamSwigWrapper(target, source, env):
6555517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6565517Snate@binkert.org
6575517Snate@binkert.org    name = str(source[0].get_contents())
6588596Ssteve.reinhardt@amd.com    param = params_to_swig[name]
6595517Snate@binkert.org
6607673Snate@binkert.org    code = code_formatter()
6617673Snate@binkert.org    param.swig_decl(code)
6627673Snate@binkert.org    code.write(target[0].abspath)
6635517Snate@binkert.org
6645517Snate@binkert.orgdef createEnumStrings(target, source, env):
6655517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6665517Snate@binkert.org
6675517Snate@binkert.org    name = str(source[0].get_contents())
6685517Snate@binkert.org    obj = all_enums[name]
6695517Snate@binkert.org
6707673Snate@binkert.org    code = code_formatter()
6717673Snate@binkert.org    obj.cxx_def(code)
6727673Snate@binkert.org    code.write(target[0].abspath)
6735517Snate@binkert.org
6748596Ssteve.reinhardt@amd.comdef createEnumDecls(target, source, env):
6755517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6765517Snate@binkert.org
6775517Snate@binkert.org    name = str(source[0].get_contents())
6785517Snate@binkert.org    obj = all_enums[name]
6795517Snate@binkert.org
6807673Snate@binkert.org    code = code_formatter()
6817673Snate@binkert.org    obj.cxx_decl(code)
6827673Snate@binkert.org    code.write(target[0].abspath)
6835517Snate@binkert.org
6848596Ssteve.reinhardt@amd.comdef createEnumSwigWrapper(target, source, env):
6857675Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6867675Snate@binkert.org
6877675Snate@binkert.org    name = str(source[0].get_contents())
6887675Snate@binkert.org    obj = all_enums[name]
6897675Snate@binkert.org
6907675Snate@binkert.org    code = code_formatter()
6918596Ssteve.reinhardt@amd.com    obj.swig_decl(code)
6927675Snate@binkert.org    code.write(target[0].abspath)
6937675Snate@binkert.org
6948596Ssteve.reinhardt@amd.comdef createSimObjectSwigWrapper(target, source, env):
6958596Ssteve.reinhardt@amd.com    name = source[0].get_contents()
6968596Ssteve.reinhardt@amd.com    obj = sim_objects[name]
6978596Ssteve.reinhardt@amd.com
6988596Ssteve.reinhardt@amd.com    code = code_formatter()
6998596Ssteve.reinhardt@amd.com    obj.swig_decl(code)
7008596Ssteve.reinhardt@amd.com    code.write(target[0].abspath)
7018596Ssteve.reinhardt@amd.com
70210454SCurtis.Dunham@arm.com# dummy target for generated code
70310454SCurtis.Dunham@arm.com# we start out with all the Source files so they get copied to build/*/ also.
70410454SCurtis.Dunham@arm.comSWIG = env.Dummy('swig', [s.tnode for s in Source.get()])
70510454SCurtis.Dunham@arm.com
7068596Ssteve.reinhardt@amd.com# Generate all of the SimObject param C++ struct header files
7074762Snate@binkert.orgparams_hh_files = []
7086143Snate@binkert.orgfor name,simobj in sorted(sim_objects.iteritems()):
7096143Snate@binkert.org    py_source = PySource.modules[simobj.__module__]
7106143Snate@binkert.org    extra_deps = [ py_source.tnode ]
7114762Snate@binkert.org
7124762Snate@binkert.org    hh_file = File('params/%s.hh' % name)
7134762Snate@binkert.org    params_hh_files.append(hh_file)
7147756SAli.Saidi@ARM.com    env.Command(hh_file, Value(name),
7158596Ssteve.reinhardt@amd.com                MakeAction(createSimObjectParamStruct, Transform("SO PARAM")))
7164762Snate@binkert.org    env.Depends(hh_file, depends + extra_deps)
71710454SCurtis.Dunham@arm.com    env.Depends(SWIG, hh_file)
7184762Snate@binkert.org
71910458Sandreas.hansson@arm.com# C++ parameter description files
72010458Sandreas.hansson@arm.comif GetOption('with_cxx_config'):
72110458Sandreas.hansson@arm.com    for name,simobj in sorted(sim_objects.iteritems()):
72210458Sandreas.hansson@arm.com        py_source = PySource.modules[simobj.__module__]
72310458Sandreas.hansson@arm.com        extra_deps = [ py_source.tnode ]
72410458Sandreas.hansson@arm.com
72510458Sandreas.hansson@arm.com        cxx_config_hh_file = File('cxx_config/%s.hh' % name)
72610458Sandreas.hansson@arm.com        cxx_config_cc_file = File('cxx_config/%s.cc' % name)
72710458Sandreas.hansson@arm.com        env.Command(cxx_config_hh_file, Value(name),
72810458Sandreas.hansson@arm.com                    MakeAction(createSimObjectCxxConfig(True),
72910458Sandreas.hansson@arm.com                    Transform("CXXCPRHH")))
73010458Sandreas.hansson@arm.com        env.Command(cxx_config_cc_file, Value(name),
73110458Sandreas.hansson@arm.com                    MakeAction(createSimObjectCxxConfig(False),
73210458Sandreas.hansson@arm.com                    Transform("CXXCPRCC")))
73310458Sandreas.hansson@arm.com        env.Depends(cxx_config_hh_file, depends + extra_deps +
73410458Sandreas.hansson@arm.com                    [File('params/%s.hh' % name), File('sim/cxx_config.hh')])
73510458Sandreas.hansson@arm.com        env.Depends(cxx_config_cc_file, depends + extra_deps +
73610458Sandreas.hansson@arm.com                    [cxx_config_hh_file])
73710458Sandreas.hansson@arm.com        Source(cxx_config_cc_file)
73810458Sandreas.hansson@arm.com
73910458Sandreas.hansson@arm.com    cxx_config_init_cc_file = File('cxx_config/init.cc')
74010458Sandreas.hansson@arm.com
74110458Sandreas.hansson@arm.com    def createCxxConfigInitCC(target, source, env):
74210458Sandreas.hansson@arm.com        assert len(target) == 1 and len(source) == 1
74310458Sandreas.hansson@arm.com
74410458Sandreas.hansson@arm.com        code = code_formatter()
74510458Sandreas.hansson@arm.com
74610458Sandreas.hansson@arm.com        for name,simobj in sorted(sim_objects.iteritems()):
74710458Sandreas.hansson@arm.com            if not hasattr(simobj, 'abstract') or not simobj.abstract:
74810458Sandreas.hansson@arm.com                code('#include "cxx_config/${name}.hh"')
74910458Sandreas.hansson@arm.com        code()
75010458Sandreas.hansson@arm.com        code('void cxxConfigInit()')
75110458Sandreas.hansson@arm.com        code('{')
75210458Sandreas.hansson@arm.com        code.indent()
75310458Sandreas.hansson@arm.com        for name,simobj in sorted(sim_objects.iteritems()):
75410458Sandreas.hansson@arm.com            not_abstract = not hasattr(simobj, 'abstract') or \
75510458Sandreas.hansson@arm.com                not simobj.abstract
75610458Sandreas.hansson@arm.com            if not_abstract and 'type' in simobj.__dict__:
75710458Sandreas.hansson@arm.com                code('cxx_config_directory["${name}"] = '
75810458Sandreas.hansson@arm.com                     '${name}CxxConfigParams::makeDirectoryEntry();')
75910458Sandreas.hansson@arm.com        code.dedent()
76010458Sandreas.hansson@arm.com        code('}')
76110458Sandreas.hansson@arm.com        code.write(target[0].abspath)
76210458Sandreas.hansson@arm.com
76310458Sandreas.hansson@arm.com    py_source = PySource.modules[simobj.__module__]
76410458Sandreas.hansson@arm.com    extra_deps = [ py_source.tnode ]
76510458Sandreas.hansson@arm.com    env.Command(cxx_config_init_cc_file, Value(name),
76610458Sandreas.hansson@arm.com        MakeAction(createCxxConfigInitCC, Transform("CXXCINIT")))
76710458Sandreas.hansson@arm.com    cxx_param_hh_files = ["cxx_config/%s.hh" % simobj
76810584Sandreas.hansson@arm.com        for name,simobj in sorted(sim_objects.iteritems())
76910458Sandreas.hansson@arm.com        if not hasattr(simobj, 'abstract') or not simobj.abstract]
77010458Sandreas.hansson@arm.com    Depends(cxx_config_init_cc_file, cxx_param_hh_files +
77110458Sandreas.hansson@arm.com            [File('sim/cxx_config.hh')])
77210458Sandreas.hansson@arm.com    Source(cxx_config_init_cc_file)
77310458Sandreas.hansson@arm.com
7748596Ssteve.reinhardt@amd.com# Generate any needed param SWIG wrapper files
7755463Snate@binkert.orgparams_i_files = []
77610584Sandreas.hansson@arm.comfor name,param in sorted(params_to_swig.iteritems()):
77711802Sandreas.sandberg@arm.com    i_file = File('python/_m5/%s.i' % (param.swig_module_name()))
7785463Snate@binkert.org    params_i_files.append(i_file)
7797756SAli.Saidi@ARM.com    env.Command(i_file, Value(name),
7808596Ssteve.reinhardt@amd.com                MakeAction(createParamSwigWrapper, Transform("SW PARAM")))
7814762Snate@binkert.org    env.Depends(i_file, depends)
78210454SCurtis.Dunham@arm.com    env.Depends(SWIG, i_file)
78311802Sandreas.sandberg@arm.com    SwigSource('_m5', i_file)
7844762Snate@binkert.org
7854762Snate@binkert.org# Generate all enum header files
7866143Snate@binkert.orgfor name,enum in sorted(all_enums.iteritems()):
7876143Snate@binkert.org    py_source = PySource.modules[enum.__module__]
7886143Snate@binkert.org    extra_deps = [ py_source.tnode ]
7894762Snate@binkert.org
7904762Snate@binkert.org    cc_file = File('enums/%s.cc' % name)
7917756SAli.Saidi@ARM.com    env.Command(cc_file, Value(name),
7927816Ssteve.reinhardt@amd.com                MakeAction(createEnumStrings, Transform("ENUM STR")))
7934762Snate@binkert.org    env.Depends(cc_file, depends + extra_deps)
79410454SCurtis.Dunham@arm.com    env.Depends(SWIG, cc_file)
7954762Snate@binkert.org    Source(cc_file)
7964762Snate@binkert.org
7974762Snate@binkert.org    hh_file = File('enums/%s.hh' % name)
7987756SAli.Saidi@ARM.com    env.Command(hh_file, Value(name),
7998596Ssteve.reinhardt@amd.com                MakeAction(createEnumDecls, Transform("ENUMDECL")))
8004762Snate@binkert.org    env.Depends(hh_file, depends + extra_deps)
80110454SCurtis.Dunham@arm.com    env.Depends(SWIG, hh_file)
8024762Snate@binkert.org
80311802Sandreas.sandberg@arm.com    i_file = File('python/_m5/enum_%s.i' % name)
8047756SAli.Saidi@ARM.com    env.Command(i_file, Value(name),
8058596Ssteve.reinhardt@amd.com                MakeAction(createEnumSwigWrapper, Transform("ENUMSWIG")))
8067675Snate@binkert.org    env.Depends(i_file, depends + extra_deps)
80710454SCurtis.Dunham@arm.com    env.Depends(SWIG, i_file)
80811802Sandreas.sandberg@arm.com    SwigSource('_m5', i_file)
8095517Snate@binkert.org
8108596Ssteve.reinhardt@amd.com# Generate SimObject SWIG wrapper files
81110584Sandreas.hansson@arm.comfor name,simobj in sorted(sim_objects.iteritems()):
8129248SAndreas.Sandberg@arm.com    py_source = PySource.modules[simobj.__module__]
8139248SAndreas.Sandberg@arm.com    extra_deps = [ py_source.tnode ]
81411802Sandreas.sandberg@arm.com    i_file = File('python/_m5/param_%s.i' % name)
8158596Ssteve.reinhardt@amd.com    env.Command(i_file, Value(name),
8168596Ssteve.reinhardt@amd.com                MakeAction(createSimObjectSwigWrapper, Transform("SO SWIG")))
8179248SAndreas.Sandberg@arm.com    env.Depends(i_file, depends + extra_deps)
81811802Sandreas.sandberg@arm.com    SwigSource('_m5', i_file)
8194762Snate@binkert.org
8207674Snate@binkert.org# Generate the main swig init file
82111548Sandreas.hansson@arm.comdef makeEmbeddedSwigInit(package):
82211548Sandreas.hansson@arm.com    def body(target, source, env):
82311548Sandreas.hansson@arm.com        assert len(target) == 1 and len(source) == 1
8247674Snate@binkert.org
82511548Sandreas.hansson@arm.com        code = code_formatter()
82611548Sandreas.hansson@arm.com        module = source[0].get_contents()
82711548Sandreas.hansson@arm.com        # Provide the full context so that the swig-generated call to
82811548Sandreas.hansson@arm.com        # Py_InitModule ends up placing the embedded module in the
82911548Sandreas.hansson@arm.com        # right package.
83011548Sandreas.hansson@arm.com        context = str(package) + "._" + str(module)
83111548Sandreas.hansson@arm.com        code('''\
83211548Sandreas.hansson@arm.com        #include "sim/init.hh"
8337674Snate@binkert.org
83411548Sandreas.hansson@arm.com        extern "C" {
83511548Sandreas.hansson@arm.com            void init_${module}();
83611548Sandreas.hansson@arm.com        }
83711548Sandreas.hansson@arm.com
83811548Sandreas.hansson@arm.com        EmbeddedSwig embed_swig_${module}(init_${module}, "${context}");
83911548Sandreas.hansson@arm.com        ''')
84011548Sandreas.hansson@arm.com        code.write(str(target[0]))
84111548Sandreas.hansson@arm.com    return body
84211308Santhony.gutierrez@amd.com
8434762Snate@binkert.org# Build all swig modules
8446143Snate@binkert.orgfor swig in SwigSource.all:
8456143Snate@binkert.org    env.Command([swig.cc_source.tnode, swig.py_source.tnode], swig.tnode,
8467756SAli.Saidi@ARM.com                MakeAction('$SWIG $SWIGFLAGS -outdir ${TARGETS[1].dir} '
8477816Ssteve.reinhardt@amd.com                '-o ${TARGETS[0]} $SOURCES', Transform("SWIG")))
8488235Snate@binkert.org    cc_file = str(swig.tnode)
8498596Ssteve.reinhardt@amd.com    init_file = '%s/%s_init.cc' % (dirname(cc_file), basename(cc_file))
8507756SAli.Saidi@ARM.com    env.Command(init_file, Value(swig.module),
85111548Sandreas.hansson@arm.com                MakeAction(makeEmbeddedSwigInit(swig.package),
85211548Sandreas.hansson@arm.com                           Transform("EMBED SW")))
85310454SCurtis.Dunham@arm.com    env.Depends(SWIG, init_file)
8548235Snate@binkert.org    Source(init_file, **swig.guards)
8554382Sbinkertn@umich.edu
8569396Sandreas.hansson@arm.com# Build all protocol buffers if we have got protoc and protobuf available
8579396Sandreas.hansson@arm.comif env['HAVE_PROTOBUF']:
8589396Sandreas.hansson@arm.com    for proto in ProtoBuf.all:
8599396Sandreas.hansson@arm.com        # Use both the source and header as the target, and the .proto
8609396Sandreas.hansson@arm.com        # file as the source. When executing the protoc compiler, also
8619396Sandreas.hansson@arm.com        # specify the proto_path to avoid having the generated files
8629396Sandreas.hansson@arm.com        # include the path.
8639396Sandreas.hansson@arm.com        env.Command([proto.cc_file, proto.hh_file], proto.tnode,
8649396Sandreas.hansson@arm.com                    MakeAction('$PROTOC --cpp_out ${TARGET.dir} '
8659396Sandreas.hansson@arm.com                               '--proto_path ${SOURCE.dir} $SOURCE',
8669396Sandreas.hansson@arm.com                               Transform("PROTOC")))
8679396Sandreas.hansson@arm.com
86810454SCurtis.Dunham@arm.com        env.Depends(SWIG, [proto.cc_file, proto.hh_file])
8699396Sandreas.hansson@arm.com        # Add the C++ source file
8709396Sandreas.hansson@arm.com        Source(proto.cc_file, **proto.guards)
8719396Sandreas.hansson@arm.comelif ProtoBuf.all:
8729396Sandreas.hansson@arm.com    print 'Got protobuf to build, but lacks support!'
8739396Sandreas.hansson@arm.com    Exit(1)
8749396Sandreas.hansson@arm.com
8758232Snate@binkert.org#
8768232Snate@binkert.org# Handle debug flags
8778232Snate@binkert.org#
8788232Snate@binkert.orgdef makeDebugFlagCC(target, source, env):
8798232Snate@binkert.org    assert(len(target) == 1 and len(source) == 1)
8806229Snate@binkert.org
88110455SCurtis.Dunham@arm.com    code = code_formatter()
8826229Snate@binkert.org
88310455SCurtis.Dunham@arm.com    # delay definition of CompoundFlags until after all the definition
88410455SCurtis.Dunham@arm.com    # of all constituent SimpleFlags
88510455SCurtis.Dunham@arm.com    comp_code = code_formatter()
8865517Snate@binkert.org
8875517Snate@binkert.org    # file header
8887673Snate@binkert.org    code('''
8895517Snate@binkert.org/*
89010455SCurtis.Dunham@arm.com * DO NOT EDIT THIS FILE! Automatically generated by SCons.
8915517Snate@binkert.org */
8925517Snate@binkert.org
8938232Snate@binkert.org#include "base/debug.hh"
89410455SCurtis.Dunham@arm.com
89510455SCurtis.Dunham@arm.comnamespace Debug {
89610455SCurtis.Dunham@arm.com
8977673Snate@binkert.org''')
8987673Snate@binkert.org
89910455SCurtis.Dunham@arm.com    for name, flag in sorted(source[0].read().iteritems()):
90010455SCurtis.Dunham@arm.com        n, compound, desc = flag
90110455SCurtis.Dunham@arm.com        assert n == name
9025517Snate@binkert.org
90310455SCurtis.Dunham@arm.com        if not compound:
90410455SCurtis.Dunham@arm.com            code('SimpleFlag $name("$name", "$desc");')
90510455SCurtis.Dunham@arm.com        else:
90610455SCurtis.Dunham@arm.com            comp_code('CompoundFlag $name("$name", "$desc",')
90710455SCurtis.Dunham@arm.com            comp_code.indent()
90810455SCurtis.Dunham@arm.com            last = len(compound) - 1
90910455SCurtis.Dunham@arm.com            for i,flag in enumerate(compound):
91010455SCurtis.Dunham@arm.com                if i != last:
91110685Sandreas.hansson@arm.com                    comp_code('&$flag,')
91210455SCurtis.Dunham@arm.com                else:
91310685Sandreas.hansson@arm.com                    comp_code('&$flag);')
91410455SCurtis.Dunham@arm.com            comp_code.dedent()
9155517Snate@binkert.org
91610455SCurtis.Dunham@arm.com    code.append(comp_code)
9178232Snate@binkert.org    code()
9188232Snate@binkert.org    code('} // namespace Debug')
9195517Snate@binkert.org
9207673Snate@binkert.org    code.write(str(target[0]))
9215517Snate@binkert.org
9228232Snate@binkert.orgdef makeDebugFlagHH(target, source, env):
9238232Snate@binkert.org    assert(len(target) == 1 and len(source) == 1)
9245517Snate@binkert.org
9258232Snate@binkert.org    val = eval(source[0].get_contents())
9268232Snate@binkert.org    name, compound, desc = val
9278232Snate@binkert.org
9287673Snate@binkert.org    code = code_formatter()
9295517Snate@binkert.org
9305517Snate@binkert.org    # file header boilerplate
9317673Snate@binkert.org    code('''\
9325517Snate@binkert.org/*
93310455SCurtis.Dunham@arm.com * DO NOT EDIT THIS FILE! Automatically generated by SCons.
9345517Snate@binkert.org */
9355517Snate@binkert.org
9368232Snate@binkert.org#ifndef __DEBUG_${name}_HH__
9378232Snate@binkert.org#define __DEBUG_${name}_HH__
9385517Snate@binkert.org
9398232Snate@binkert.orgnamespace Debug {
9408232Snate@binkert.org''')
9415517Snate@binkert.org
9428232Snate@binkert.org    if compound:
9438232Snate@binkert.org        code('class CompoundFlag;')
9448232Snate@binkert.org    code('class SimpleFlag;')
9455517Snate@binkert.org
9468232Snate@binkert.org    if compound:
9478232Snate@binkert.org        code('extern CompoundFlag $name;')
9488232Snate@binkert.org        for flag in compound:
9498232Snate@binkert.org            code('extern SimpleFlag $flag;')
9508232Snate@binkert.org    else:
9518232Snate@binkert.org        code('extern SimpleFlag $name;')
9525517Snate@binkert.org
9538232Snate@binkert.org    code('''
9548232Snate@binkert.org}
9555517Snate@binkert.org
9568232Snate@binkert.org#endif // __DEBUG_${name}_HH__
9577673Snate@binkert.org''')
9585517Snate@binkert.org
9597673Snate@binkert.org    code.write(str(target[0]))
9605517Snate@binkert.org
9618232Snate@binkert.orgfor name,flag in sorted(debug_flags.iteritems()):
9628232Snate@binkert.org    n, compound, desc = flag
9638232Snate@binkert.org    assert n == name
9645192Ssaidi@eecs.umich.edu
96510454SCurtis.Dunham@arm.com    hh_file = 'debug/%s.hh' % name
96610454SCurtis.Dunham@arm.com    env.Command(hh_file, Value(flag),
9678232Snate@binkert.org                MakeAction(makeDebugFlagHH, Transform("TRACING", 0)))
96810455SCurtis.Dunham@arm.com    env.Depends(SWIG, hh_file)
96910455SCurtis.Dunham@arm.com
97010455SCurtis.Dunham@arm.comenv.Command('debug/flags.cc', Value(debug_flags),
97110455SCurtis.Dunham@arm.com            MakeAction(makeDebugFlagCC, Transform("TRACING", 0)))
97210455SCurtis.Dunham@arm.comenv.Depends(SWIG, 'debug/flags.cc')
97310455SCurtis.Dunham@arm.comSource('debug/flags.cc')
9745192Ssaidi@eecs.umich.edu
97511077SCurtis.Dunham@arm.com# version tags
97611330SCurtis.Dunham@arm.comtags = \
97711077SCurtis.Dunham@arm.comenv.Command('sim/tags.cc', None,
97811077SCurtis.Dunham@arm.com            MakeAction('util/cpt_upgrader.py --get-cc-file > $TARGET',
97911077SCurtis.Dunham@arm.com                       Transform("VER TAGS")))
98011330SCurtis.Dunham@arm.comenv.AlwaysBuild(tags)
98111077SCurtis.Dunham@arm.com
9827674Snate@binkert.org# Embed python files.  All .py files that have been indicated by a
9835522Snate@binkert.org# PySource() call in a SConscript need to be embedded into the M5
9845522Snate@binkert.org# library.  To do that, we compile the file to byte code, marshal the
9857674Snate@binkert.org# byte code, compress it, and then generate a c++ file that
9867674Snate@binkert.org# inserts the result into an array.
9877674Snate@binkert.orgdef embedPyFile(target, source, env):
9887674Snate@binkert.org    def c_str(string):
9897674Snate@binkert.org        if string is None:
9907674Snate@binkert.org            return "0"
9917674Snate@binkert.org        return '"%s"' % string
9927674Snate@binkert.org
9935522Snate@binkert.org    '''Action function to compile a .py into a code object, marshal
9945522Snate@binkert.org    it, compress it, and stick it into an asm file so the code appears
9955522Snate@binkert.org    as just bytes with a label in the data section'''
9965517Snate@binkert.org
9975522Snate@binkert.org    src = file(str(source[0]), 'r').read()
9985517Snate@binkert.org
9996143Snate@binkert.org    pysource = PySource.tnodes[source[0]]
10006727Ssteve.reinhardt@amd.com    compiled = compile(src, pysource.abspath, 'exec')
10015522Snate@binkert.org    marshalled = marshal.dumps(compiled)
10025522Snate@binkert.org    compressed = zlib.compress(marshalled)
10035522Snate@binkert.org    data = compressed
10047674Snate@binkert.org    sym = pysource.symname
10055517Snate@binkert.org
10067673Snate@binkert.org    code = code_formatter()
10077673Snate@binkert.org    code('''\
10087674Snate@binkert.org#include "sim/init.hh"
10097673Snate@binkert.org
10107674Snate@binkert.orgnamespace {
10117674Snate@binkert.org
10128946Sandreas.hansson@arm.comconst uint8_t data_${sym}[] = {
10137674Snate@binkert.org''')
10147674Snate@binkert.org    code.indent()
10157674Snate@binkert.org    step = 16
10165522Snate@binkert.org    for i in xrange(0, len(data), step):
10175522Snate@binkert.org        x = array.array('B', data[i:i+step])
10187674Snate@binkert.org        code(''.join('%d,' % d for d in x))
10197674Snate@binkert.org    code.dedent()
102011308Santhony.gutierrez@amd.com
10217674Snate@binkert.org    code('''};
10227673Snate@binkert.org
10237674Snate@binkert.orgEmbeddedPython embedded_${sym}(
10247674Snate@binkert.org    ${{c_str(pysource.arcname)}},
10257674Snate@binkert.org    ${{c_str(pysource.abspath)}},
10267674Snate@binkert.org    ${{c_str(pysource.modpath)}},
10277674Snate@binkert.org    data_${sym},
10287674Snate@binkert.org    ${{len(data)}},
10297674Snate@binkert.org    ${{len(marshalled)}});
10307674Snate@binkert.org
10317811Ssteve.reinhardt@amd.com} // anonymous namespace
10327674Snate@binkert.org''')
10337673Snate@binkert.org    code.write(str(target[0]))
10345522Snate@binkert.org
10356143Snate@binkert.orgfor source in PySource.all:
103610453SAndrew.Bardsley@arm.com    env.Command(source.cpp, source.tnode,
10377816Ssteve.reinhardt@amd.com                MakeAction(embedPyFile, Transform("EMBED PY")))
103810454SCurtis.Dunham@arm.com    env.Depends(SWIG, source.cpp)
103910453SAndrew.Bardsley@arm.com    Source(source.cpp, skip_no_python=True)
10404382Sbinkertn@umich.edu
10414382Sbinkertn@umich.edu########################################################################
10424382Sbinkertn@umich.edu#
10434382Sbinkertn@umich.edu# Define binaries.  Each different build type (debug, opt, etc.) gets
10444382Sbinkertn@umich.edu# a slightly different build environment.
10454382Sbinkertn@umich.edu#
10464382Sbinkertn@umich.edu
10474382Sbinkertn@umich.edu# List of constructed environments to pass back to SConstruct
104810196SCurtis.Dunham@arm.comdate_source = Source('base/date.cc', skip_lib=True)
10494382Sbinkertn@umich.edu
105010196SCurtis.Dunham@arm.com# Capture this directory for the closure makeEnv, otherwise when it is
105110196SCurtis.Dunham@arm.com# called, it won't know what directory it should use.
105210196SCurtis.Dunham@arm.comvariant_dir = Dir('.').path
105310196SCurtis.Dunham@arm.comdef variant(*path):
105410196SCurtis.Dunham@arm.com    return os.path.join(variant_dir, *path)
105510196SCurtis.Dunham@arm.comdef variantd(*path):
105610196SCurtis.Dunham@arm.com    return variant(*path)+'/'
1057955SN/A
10582655Sstever@eecs.umich.edu# Function to create a new build environment as clone of current
10592655Sstever@eecs.umich.edu# environment 'env' with modified object suffix and optional stripped
10602655Sstever@eecs.umich.edu# binary.  Additional keyword arguments are appended to corresponding
10612655Sstever@eecs.umich.edu# build environment vars.
106210196SCurtis.Dunham@arm.comdef makeEnv(env, label, objsfx, strip = False, **kwargs):
10635601Snate@binkert.org    # SCons doesn't know to append a library suffix when there is a '.' in the
10645601Snate@binkert.org    # name.  Use '_' instead.
106510196SCurtis.Dunham@arm.com    libname = variant('gem5_' + label)
106610196SCurtis.Dunham@arm.com    exename = variant('gem5.' + label)
106710196SCurtis.Dunham@arm.com    secondary_exename = variant('m5.' + label)
10685522Snate@binkert.org
10695863Snate@binkert.org    new_env = env.Clone(OBJSUFFIX=objsfx, SHOBJSUFFIX=objsfx + 's')
10705601Snate@binkert.org    new_env.Label = label
10715601Snate@binkert.org    new_env.Append(**kwargs)
10725601Snate@binkert.org
10735863Snate@binkert.org    swig_env = new_env.Clone()
10749556Sandreas.hansson@arm.com
10759556Sandreas.hansson@arm.com    # Both gcc and clang have issues with unused labels and values in
10769556Sandreas.hansson@arm.com    # the SWIG generated code
10779556Sandreas.hansson@arm.com    swig_env.Append(CCFLAGS=['-Wno-unused-label', '-Wno-unused-value'])
10789556Sandreas.hansson@arm.com
10795559Snate@binkert.org    if env['GCC']:
10809556Sandreas.hansson@arm.com        # Depending on the SWIG version, we also need to supress
10819618Ssteve.reinhardt@amd.com        # warnings about uninitialized variables and missing field
10829618Ssteve.reinhardt@amd.com        # initializers.
10839618Ssteve.reinhardt@amd.com        swig_env.Append(CCFLAGS=['-Wno-uninitialized',
108410238Sandreas.hansson@arm.com                                 '-Wno-missing-field-initializers',
108510878Sandreas.hansson@arm.com                                 '-Wno-unused-but-set-variable',
108611294Sandreas.hansson@arm.com                                 '-Wno-maybe-uninitialized',
108711294Sandreas.hansson@arm.com                                 '-Wno-type-limits'])
108810457Sandreas.hansson@arm.com
108911718Sjoseph.gross@amd.com
109011718Sjoseph.gross@amd.com        # The address sanitizer is available for gcc >= 4.8
109111718Sjoseph.gross@amd.com        if GetOption('with_asan'):
109211718Sjoseph.gross@amd.com            if GetOption('with_ubsan') and \
109311718Sjoseph.gross@amd.com                    compareVersions(env['GCC_VERSION'], '4.9') >= 0:
109411718Sjoseph.gross@amd.com                new_env.Append(CCFLAGS=['-fsanitize=address,undefined',
109511718Sjoseph.gross@amd.com                                        '-fno-omit-frame-pointer'])
109611718Sjoseph.gross@amd.com                new_env.Append(LINKFLAGS='-fsanitize=address,undefined')
109711718Sjoseph.gross@amd.com            else:
109811718Sjoseph.gross@amd.com                new_env.Append(CCFLAGS=['-fsanitize=address',
109911718Sjoseph.gross@amd.com                                        '-fno-omit-frame-pointer'])
110011718Sjoseph.gross@amd.com                new_env.Append(LINKFLAGS='-fsanitize=address')
110110457Sandreas.hansson@arm.com        # Only gcc >= 4.9 supports UBSan, so check both the version
110210457Sandreas.hansson@arm.com        # and the command-line option before adding the compiler and
110310457Sandreas.hansson@arm.com        # linker flags.
110411718Sjoseph.gross@amd.com        elif GetOption('with_ubsan') and \
110510457Sandreas.hansson@arm.com                compareVersions(env['GCC_VERSION'], '4.9') >= 0:
110610457Sandreas.hansson@arm.com            new_env.Append(CCFLAGS='-fsanitize=undefined')
110710457Sandreas.hansson@arm.com            new_env.Append(LINKFLAGS='-fsanitize=undefined')
110810457Sandreas.hansson@arm.com
110911342Sandreas.hansson@arm.com
11108737Skoansin.tan@gmail.com    if env['CLANG']:
111111294Sandreas.hansson@arm.com        swig_env.Append(CCFLAGS=['-Wno-sometimes-uninitialized',
111211294Sandreas.hansson@arm.com                                 '-Wno-deprecated-register',
111311294Sandreas.hansson@arm.com                                 '-Wno-tautological-compare'])
111410278SAndreas.Sandberg@ARM.com
111511342Sandreas.hansson@arm.com        # We require clang >= 3.1, so there is no need to check any
111611342Sandreas.hansson@arm.com        # versions here.
111710457Sandreas.hansson@arm.com        if GetOption('with_ubsan'):
111811718Sjoseph.gross@amd.com            if GetOption('with_asan'):
111911718Sjoseph.gross@amd.com                new_env.Append(CCFLAGS=['-fsanitize=address,undefined',
112011718Sjoseph.gross@amd.com                                        '-fno-omit-frame-pointer'])
112111718Sjoseph.gross@amd.com                new_env.Append(LINKFLAGS='-fsanitize=address,undefined')
112211718Sjoseph.gross@amd.com            else:
112311718Sjoseph.gross@amd.com                new_env.Append(CCFLAGS='-fsanitize=undefined')
112411718Sjoseph.gross@amd.com                new_env.Append(LINKFLAGS='-fsanitize=undefined')
112510457Sandreas.hansson@arm.com
112611718Sjoseph.gross@amd.com        elif GetOption('with_asan'):
112711500Sandreas.hansson@arm.com            new_env.Append(CCFLAGS=['-fsanitize=address',
112811500Sandreas.hansson@arm.com                                    '-fno-omit-frame-pointer'])
112911342Sandreas.hansson@arm.com            new_env.Append(LINKFLAGS='-fsanitize=address')
113011342Sandreas.hansson@arm.com
11318945Ssteve.reinhardt@amd.com    werror_env = new_env.Clone()
113210686SAndreas.Sandberg@ARM.com    # Treat warnings as errors but white list some warnings that we
113310686SAndreas.Sandberg@ARM.com    # want to allow (e.g., deprecation warnings).
113410686SAndreas.Sandberg@ARM.com    werror_env.Append(CCFLAGS=['-Werror',
113510686SAndreas.Sandberg@ARM.com                               '-Wno-error=deprecated-declarations',
113610686SAndreas.Sandberg@ARM.com                               '-Wno-error=deprecated',
113710686SAndreas.Sandberg@ARM.com                               ])
11388945Ssteve.reinhardt@amd.com
11396143Snate@binkert.org    def make_obj(source, static, extra_deps = None):
11406143Snate@binkert.org        '''This function adds the specified source to the correct
11416143Snate@binkert.org        build environment, and returns the corresponding SCons Object
11426143Snate@binkert.org        nodes'''
11436143Snate@binkert.org
11446143Snate@binkert.org        if source.swig:
11456143Snate@binkert.org            env = swig_env
11468945Ssteve.reinhardt@amd.com        elif source.Werror:
11478945Ssteve.reinhardt@amd.com            env = werror_env
11486143Snate@binkert.org        else:
11496143Snate@binkert.org            env = new_env
11506143Snate@binkert.org
11516143Snate@binkert.org        if static:
11526143Snate@binkert.org            obj = env.StaticObject(source.tnode)
11536143Snate@binkert.org        else:
11546143Snate@binkert.org            obj = env.SharedObject(source.tnode)
11556143Snate@binkert.org
11566143Snate@binkert.org        if extra_deps:
11576143Snate@binkert.org            env.Depends(obj, extra_deps)
11586143Snate@binkert.org
11596143Snate@binkert.org        return obj
11606143Snate@binkert.org
116110453SAndrew.Bardsley@arm.com    lib_guards = {'main': False, 'skip_lib': False}
116210453SAndrew.Bardsley@arm.com
116310453SAndrew.Bardsley@arm.com    # Without Python, leave out all SWIG and Python content from the
116410453SAndrew.Bardsley@arm.com    # library builds.  The option doesn't affect gem5 built as a program
116510453SAndrew.Bardsley@arm.com    if GetOption('without_python'):
116610453SAndrew.Bardsley@arm.com        lib_guards['skip_no_python'] = False
116710453SAndrew.Bardsley@arm.com
116810453SAndrew.Bardsley@arm.com    static_objs = [ make_obj(s, True) for s in Source.get(**lib_guards) ]
116910453SAndrew.Bardsley@arm.com    shared_objs = [ make_obj(s, False) for s in Source.get(**lib_guards) ]
11706143Snate@binkert.org
11716143Snate@binkert.org    static_date = make_obj(date_source, static=True, extra_deps=static_objs)
11726143Snate@binkert.org    static_objs.append(static_date)
117310453SAndrew.Bardsley@arm.com
11746143Snate@binkert.org    shared_date = make_obj(date_source, static=False, extra_deps=shared_objs)
11756240Snate@binkert.org    shared_objs.append(shared_date)
11765554Snate@binkert.org
11775522Snate@binkert.org    # First make a library of everything but main() so other programs can
11785522Snate@binkert.org    # link against m5.
11795797Snate@binkert.org    static_lib = new_env.StaticLibrary(libname, static_objs)
11805797Snate@binkert.org    shared_lib = new_env.SharedLibrary(libname, shared_objs)
11815522Snate@binkert.org
11825601Snate@binkert.org    # Now link a stub with main() and the static library.
11838233Snate@binkert.org    main_objs = [ make_obj(s, True) for s in Source.get(main=True) ]
11848233Snate@binkert.org
11858235Snate@binkert.org    for test in UnitTest.all:
11868235Snate@binkert.org        flags = { test.target : True }
11878235Snate@binkert.org        test_sources = Source.get(**flags)
11888235Snate@binkert.org        test_objs = [ make_obj(s, static=True) for s in test_sources ]
11899003SAli.Saidi@ARM.com        if test.main:
11909003SAli.Saidi@ARM.com            test_objs += main_objs
119110196SCurtis.Dunham@arm.com        path = variant('unittest/%s.%s' % (test.target, label))
119210196SCurtis.Dunham@arm.com        new_env.Program(path, test_objs + static_objs)
11938235Snate@binkert.org
11946143Snate@binkert.org    progname = exename
11952655Sstever@eecs.umich.edu    if strip:
11966143Snate@binkert.org        progname += '.unstripped'
11976143Snate@binkert.org
119811974Sgabeblack@google.com    # When linking the gem5 binary, the command line can be too big for the
119911974Sgabeblack@google.com    # shell to handle. Use "subprocess" to spawn processes without passing
120011974Sgabeblack@google.com    # through the shell to avoid this problem. That means we also can't use
120111974Sgabeblack@google.com    # shell syntax in any of the commands this will run, but that isn't
120211974Sgabeblack@google.com    # currently an issue.
120311974Sgabeblack@google.com    def spawn_with_subprocess(sh, escape, cmd, args, env):
120411974Sgabeblack@google.com        return subprocess.call(args, env=env)
120511974Sgabeblack@google.com
120611974Sgabeblack@google.com    # Since we're not running through a shell, no escaping is necessary either.
120711974Sgabeblack@google.com    targets = new_env.Program(progname, main_objs + static_objs,
120811974Sgabeblack@google.com                              SPAWN=spawn_with_subprocess,
120911974Sgabeblack@google.com                              ESCAPE=lambda x: x)
12106143Snate@binkert.org
12116143Snate@binkert.org    if strip:
12124007Ssaidi@eecs.umich.edu        if sys.platform == 'sunos5':
12134596Sbinkertn@umich.edu            cmd = 'cp $SOURCE $TARGET; strip $TARGET'
12144007Ssaidi@eecs.umich.edu        else:
12154596Sbinkertn@umich.edu            cmd = 'strip $SOURCE -o $TARGET'
12167756SAli.Saidi@ARM.com        targets = new_env.Command(exename, progname,
12177816Ssteve.reinhardt@amd.com                    MakeAction(cmd, Transform("STRIP")))
12188334Snate@binkert.org
12198334Snate@binkert.org    new_env.Command(secondary_exename, exename,
12208334Snate@binkert.org            MakeAction('ln $SOURCE $TARGET', Transform("HARDLINK")))
12218334Snate@binkert.org
12225601Snate@binkert.org    new_env.M5Binary = targets[0]
122310196SCurtis.Dunham@arm.com    return new_env
12242655Sstever@eecs.umich.edu
12259225Sandreas.hansson@arm.com# Start out with the compiler flags common to all compilers,
12269225Sandreas.hansson@arm.com# i.e. they all use -g for opt and -g -pg for prof
12279226Sandreas.hansson@arm.comccflags = {'debug' : [], 'opt' : ['-g'], 'fast' : [], 'prof' : ['-g', '-pg'],
12289226Sandreas.hansson@arm.com           'perf' : ['-g']}
12299225Sandreas.hansson@arm.com
12309226Sandreas.hansson@arm.com# Start out with the linker flags common to all linkers, i.e. -pg for
12319226Sandreas.hansson@arm.com# prof, and -lprofiler for perf. The -lprofile flag is surrounded by
12329226Sandreas.hansson@arm.com# no-as-needed and as-needed as the binutils linker is too clever and
12339226Sandreas.hansson@arm.com# simply doesn't link to the library otherwise.
12349226Sandreas.hansson@arm.comldflags = {'debug' : [], 'opt' : [], 'fast' : [], 'prof' : ['-pg'],
12359226Sandreas.hansson@arm.com           'perf' : ['-Wl,--no-as-needed', '-lprofiler', '-Wl,--as-needed']}
12369225Sandreas.hansson@arm.com
12379227Sandreas.hansson@arm.com# For Link Time Optimization, the optimisation flags used to compile
12389227Sandreas.hansson@arm.com# individual files are decoupled from those used at link time
12399227Sandreas.hansson@arm.com# (i.e. you can compile with -O3 and perform LTO with -O0), so we need
12409227Sandreas.hansson@arm.com# to also update the linker flags based on the target.
12418946Sandreas.hansson@arm.comif env['GCC']:
12423918Ssaidi@eecs.umich.edu    if sys.platform == 'sunos5':
12439225Sandreas.hansson@arm.com        ccflags['debug'] += ['-gstabs+']
12443918Ssaidi@eecs.umich.edu    else:
12459225Sandreas.hansson@arm.com        ccflags['debug'] += ['-ggdb3']
12469225Sandreas.hansson@arm.com    ldflags['debug'] += ['-O0']
12479227Sandreas.hansson@arm.com    # opt, fast, prof and perf all share the same cc flags, also add
12489227Sandreas.hansson@arm.com    # the optimization to the ldflags as LTO defers the optimization
12499227Sandreas.hansson@arm.com    # to link time
12509226Sandreas.hansson@arm.com    for target in ['opt', 'fast', 'prof', 'perf']:
12519225Sandreas.hansson@arm.com        ccflags[target] += ['-O3']
12529227Sandreas.hansson@arm.com        ldflags[target] += ['-O3']
12539227Sandreas.hansson@arm.com
12549227Sandreas.hansson@arm.com    ccflags['fast'] += env['LTO_CCFLAGS']
12559227Sandreas.hansson@arm.com    ldflags['fast'] += env['LTO_LDFLAGS']
12568946Sandreas.hansson@arm.comelif env['CLANG']:
12579225Sandreas.hansson@arm.com    ccflags['debug'] += ['-g', '-O0']
12589226Sandreas.hansson@arm.com    # opt, fast, prof and perf all share the same cc flags
12599226Sandreas.hansson@arm.com    for target in ['opt', 'fast', 'prof', 'perf']:
12609226Sandreas.hansson@arm.com        ccflags[target] += ['-O3']
12613515Ssaidi@eecs.umich.eduelse:
12623918Ssaidi@eecs.umich.edu    print 'Unknown compiler, please fix compiler options'
12634762Snate@binkert.org    Exit(1)
12643515Ssaidi@eecs.umich.edu
12658881Smarc.orr@gmail.com
12668881Smarc.orr@gmail.com# To speed things up, we only instantiate the build environments we
12678881Smarc.orr@gmail.com# need.  We try to identify the needed environment for each target; if
12688881Smarc.orr@gmail.com# we can't, we fall back on instantiating all the environments just to
12698881Smarc.orr@gmail.com# be safe.
12709226Sandreas.hansson@arm.comtarget_types = ['debug', 'opt', 'fast', 'prof', 'perf']
12719226Sandreas.hansson@arm.comobj2target = {'do': 'debug', 'o': 'opt', 'fo': 'fast', 'po': 'prof',
12729226Sandreas.hansson@arm.com              'gpo' : 'perf'}
12738881Smarc.orr@gmail.com
12748881Smarc.orr@gmail.comdef identifyTarget(t):
12758881Smarc.orr@gmail.com    ext = t.split('.')[-1]
12768881Smarc.orr@gmail.com    if ext in target_types:
12778881Smarc.orr@gmail.com        return ext
12788881Smarc.orr@gmail.com    if obj2target.has_key(ext):
12798881Smarc.orr@gmail.com        return obj2target[ext]
12808881Smarc.orr@gmail.com    match = re.search(r'/tests/([^/]+)/', t)
12818881Smarc.orr@gmail.com    if match and match.group(1) in target_types:
12828881Smarc.orr@gmail.com        return match.group(1)
12838881Smarc.orr@gmail.com    return 'all'
12848881Smarc.orr@gmail.com
12858881Smarc.orr@gmail.comneeded_envs = [identifyTarget(target) for target in BUILD_TARGETS]
12868881Smarc.orr@gmail.comif 'all' in needed_envs:
12878881Smarc.orr@gmail.com    needed_envs += target_types
12888881Smarc.orr@gmail.com
128910196SCurtis.Dunham@arm.comdef makeEnvirons(target, source, env):
129010196SCurtis.Dunham@arm.com    # cause any later Source() calls to be fatal, as a diagnostic.
129110196SCurtis.Dunham@arm.com    Source.done()
1292955SN/A
129310196SCurtis.Dunham@arm.com    envList = []
1294955SN/A
129510196SCurtis.Dunham@arm.com    # Debug binary
129610196SCurtis.Dunham@arm.com    if 'debug' in needed_envs:
129710196SCurtis.Dunham@arm.com        envList.append(
129810196SCurtis.Dunham@arm.com            makeEnv(env, 'debug', '.do',
129910196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['debug']),
130010196SCurtis.Dunham@arm.com                    CPPDEFINES = ['DEBUG', 'TRACING_ON=1'],
130110196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['debug'])))
1302955SN/A
130310196SCurtis.Dunham@arm.com    # Optimized binary
130410196SCurtis.Dunham@arm.com    if 'opt' in needed_envs:
130510196SCurtis.Dunham@arm.com        envList.append(
130610196SCurtis.Dunham@arm.com            makeEnv(env, 'opt', '.o',
130710196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['opt']),
130810196SCurtis.Dunham@arm.com                    CPPDEFINES = ['TRACING_ON=1'],
130910196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['opt'])))
13101869SN/A
131110196SCurtis.Dunham@arm.com    # "Fast" binary
131210196SCurtis.Dunham@arm.com    if 'fast' in needed_envs:
131310196SCurtis.Dunham@arm.com        envList.append(
131410196SCurtis.Dunham@arm.com            makeEnv(env, 'fast', '.fo', strip = True,
131510196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['fast']),
131610196SCurtis.Dunham@arm.com                    CPPDEFINES = ['NDEBUG', 'TRACING_ON=0'],
131710196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['fast'])))
13189226Sandreas.hansson@arm.com
131910196SCurtis.Dunham@arm.com    # Profiled binary using gprof
132010196SCurtis.Dunham@arm.com    if 'prof' in needed_envs:
132110196SCurtis.Dunham@arm.com        envList.append(
132210196SCurtis.Dunham@arm.com            makeEnv(env, 'prof', '.po',
132310196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['prof']),
132410196SCurtis.Dunham@arm.com                    CPPDEFINES = ['NDEBUG', 'TRACING_ON=0'],
132510196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['prof'])))
132610196SCurtis.Dunham@arm.com
132710196SCurtis.Dunham@arm.com    # Profiled binary using google-pprof
132810196SCurtis.Dunham@arm.com    if 'perf' in needed_envs:
132910196SCurtis.Dunham@arm.com        envList.append(
133010196SCurtis.Dunham@arm.com            makeEnv(env, 'perf', '.gpo',
133110196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['perf']),
133210196SCurtis.Dunham@arm.com                    CPPDEFINES = ['NDEBUG', 'TRACING_ON=0'],
133310196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['perf'])))
133410196SCurtis.Dunham@arm.com
133510196SCurtis.Dunham@arm.com    # Set up the regression tests for each build.
133610196SCurtis.Dunham@arm.com    for e in envList:
133711370Ssteve.reinhardt@amd.com        SConscript(os.path.join(env.root.abspath, 'tests', 'SConscript'),
133810196SCurtis.Dunham@arm.com                   variant_dir = variantd('tests', e.Label),
133910196SCurtis.Dunham@arm.com                   exports = { 'env' : e }, duplicate = False)
134010196SCurtis.Dunham@arm.com
134110196SCurtis.Dunham@arm.com# The MakeEnvirons Builder defers the full dependency collection until
134210196SCurtis.Dunham@arm.com# after processing the ISA definition (due to dynamically generated
134310196SCurtis.Dunham@arm.com# source files).  Add this dependency to all targets so they will wait
134410196SCurtis.Dunham@arm.com# until the environments are completely set up.  Otherwise, a second
134510196SCurtis.Dunham@arm.com# process (e.g. -j2 or higher) will try to compile the requested target,
134610196SCurtis.Dunham@arm.com# not know how, and fail.
134710196SCurtis.Dunham@arm.comenv.Append(BUILDERS = {'MakeEnvirons' :
134810196SCurtis.Dunham@arm.com                        Builder(action=MakeAction(makeEnvirons,
134910196SCurtis.Dunham@arm.com                                                  Transform("ENVIRONS", 1)))})
135010196SCurtis.Dunham@arm.com
135110196SCurtis.Dunham@arm.comisa_target = env['PHONY_BASE'] + '-deps'
135210196SCurtis.Dunham@arm.comenvirons   = env['PHONY_BASE'] + '-environs'
135310196SCurtis.Dunham@arm.comenv.Depends('#all-deps',     isa_target)
135410196SCurtis.Dunham@arm.comenv.Depends('#all-environs', environs)
135510196SCurtis.Dunham@arm.comenv.ScanISA(isa_target, File('arch/%s/generated/inc.d' % env['TARGET_ISA']))
135610196SCurtis.Dunham@arm.comenvSetup = env.MakeEnvirons(environs, isa_target)
135710196SCurtis.Dunham@arm.com
135810196SCurtis.Dunham@arm.com# make sure no -deps targets occur before all ISAs are complete
135910196SCurtis.Dunham@arm.comenv.Depends(isa_target, '#all-isas')
136010196SCurtis.Dunham@arm.com# likewise for -environs targets and all the -deps targets
136110196SCurtis.Dunham@arm.comenv.Depends(environs, '#all-deps')
1362