SConscript revision 11342
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
448334Snate@binkert.org# This file defines how to build a particular configuration of gem5
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
548614Sgblack@eecs.umich.edufrom m5.util import code_formatter, compareVersions
557674Snate@binkert.org
566143Snate@binkert.org########################################################################
576143Snate@binkert.org# Code for adding source files of various types
586143Snate@binkert.org#
598233Snate@binkert.org# When specifying a source file of some type, a set of guards can be
608233Snate@binkert.org# specified for that file.  When get() is used to find the files, if
618233Snate@binkert.org# get specifies a set of filters, only files that match those filters
628233Snate@binkert.org# will be accepted (unspecified filters on files are assumed to be
638233Snate@binkert.org# false).  Current filters are:
648334Snate@binkert.org#     main -- specifies the gem5 main() function
658334Snate@binkert.org#     skip_lib -- do not put this file into the gem5 library
6610453SAndrew.Bardsley@arm.com#     skip_no_python -- do not put this file into a no_python library
6710453SAndrew.Bardsley@arm.com#       as it embeds compiled Python
688233Snate@binkert.org#     <unittest> -- unit tests use filters based on the unit test name
698233Snate@binkert.org#
708233Snate@binkert.org# A parent can now be specified for a source file and default filter
718233Snate@binkert.org# values will be retrieved recursively from parents (children override
728233Snate@binkert.org# parents).
738233Snate@binkert.org#
746143Snate@binkert.orgclass SourceMeta(type):
758233Snate@binkert.org    '''Meta class for source files that keeps track of all files of a
768233Snate@binkert.org    particular type and has a get function for finding all functions
778233Snate@binkert.org    of a certain type that match a set of guards'''
786143Snate@binkert.org    def __init__(cls, name, bases, dict):
796143Snate@binkert.org        super(SourceMeta, cls).__init__(name, bases, dict)
806143Snate@binkert.org        cls.all = []
8111308Santhony.gutierrez@amd.com
828233Snate@binkert.org    def get(cls, **guards):
838233Snate@binkert.org        '''Find all files that match the specified guards.  If a source
848233Snate@binkert.org        file does not specify a flag, the default is False'''
856143Snate@binkert.org        for src in cls.all:
868233Snate@binkert.org            for flag,value in guards.iteritems():
878233Snate@binkert.org                # if the flag is found and has a different value, skip
888233Snate@binkert.org                # this file
898233Snate@binkert.org                if src.all_guards.get(flag, False) != value:
906143Snate@binkert.org                    break
916143Snate@binkert.org            else:
926143Snate@binkert.org                yield src
934762Snate@binkert.org
946143Snate@binkert.orgclass SourceFile(object):
958233Snate@binkert.org    '''Base object that encapsulates the notion of a source file.
968233Snate@binkert.org    This includes, the source node, target node, various manipulations
978233Snate@binkert.org    of those.  A source file also specifies a set of guards which
988233Snate@binkert.org    describing which builds the source file applies to.  A parent can
998233Snate@binkert.org    also be specified to get default guards from'''
1006143Snate@binkert.org    __metaclass__ = SourceMeta
1018233Snate@binkert.org    def __init__(self, source, parent=None, **guards):
1028233Snate@binkert.org        self.guards = guards
1038233Snate@binkert.org        self.parent = parent
1048233Snate@binkert.org
1056143Snate@binkert.org        tnode = source
1066143Snate@binkert.org        if not isinstance(source, SCons.Node.FS.File):
1076143Snate@binkert.org            tnode = File(source)
1086143Snate@binkert.org
1096143Snate@binkert.org        self.tnode = tnode
1106143Snate@binkert.org        self.snode = tnode.srcnode()
1116143Snate@binkert.org
1126143Snate@binkert.org        for base in type(self).__mro__:
1136143Snate@binkert.org            if issubclass(base, SourceFile):
1147065Snate@binkert.org                base.all.append(self)
1156143Snate@binkert.org
1168233Snate@binkert.org    @property
1178233Snate@binkert.org    def filename(self):
1188233Snate@binkert.org        return str(self.tnode)
1198233Snate@binkert.org
1208233Snate@binkert.org    @property
1218233Snate@binkert.org    def dirname(self):
1228233Snate@binkert.org        return dirname(self.filename)
1238233Snate@binkert.org
1248233Snate@binkert.org    @property
1258233Snate@binkert.org    def basename(self):
1268233Snate@binkert.org        return basename(self.filename)
1278233Snate@binkert.org
1288233Snate@binkert.org    @property
1298233Snate@binkert.org    def extname(self):
1308233Snate@binkert.org        index = self.basename.rfind('.')
1318233Snate@binkert.org        if index <= 0:
1328233Snate@binkert.org            # dot files aren't extensions
1338233Snate@binkert.org            return self.basename, None
1348233Snate@binkert.org
1358233Snate@binkert.org        return self.basename[:index], self.basename[index+1:]
1368233Snate@binkert.org
1378233Snate@binkert.org    @property
1388233Snate@binkert.org    def all_guards(self):
1398233Snate@binkert.org        '''find all guards for this object getting default values
1408233Snate@binkert.org        recursively from its parents'''
1418233Snate@binkert.org        guards = {}
1428233Snate@binkert.org        if self.parent:
1438233Snate@binkert.org            guards.update(self.parent.guards)
1448233Snate@binkert.org        guards.update(self.guards)
1458233Snate@binkert.org        return guards
1468233Snate@binkert.org
1476143Snate@binkert.org    def __lt__(self, other): return self.filename < other.filename
1486143Snate@binkert.org    def __le__(self, other): return self.filename <= other.filename
1496143Snate@binkert.org    def __gt__(self, other): return self.filename > other.filename
1506143Snate@binkert.org    def __ge__(self, other): return self.filename >= other.filename
1516143Snate@binkert.org    def __eq__(self, other): return self.filename == other.filename
1526143Snate@binkert.org    def __ne__(self, other): return self.filename != other.filename
1539982Satgutier@umich.edu
15410196SCurtis.Dunham@arm.com    @staticmethod
15510196SCurtis.Dunham@arm.com    def done():
15610196SCurtis.Dunham@arm.com        def disabled(cls, name, *ignored):
15710196SCurtis.Dunham@arm.com            raise RuntimeError("Additional SourceFile '%s'" % name,\
15810196SCurtis.Dunham@arm.com                  "declared, but targets deps are already fixed.")
15910196SCurtis.Dunham@arm.com        SourceFile.__init__ = disabled
16010196SCurtis.Dunham@arm.com
16110196SCurtis.Dunham@arm.com
1626143Snate@binkert.orgclass Source(SourceFile):
1636143Snate@binkert.org    '''Add a c/c++ source file to the build'''
1648945Ssteve.reinhardt@amd.com    def __init__(self, source, Werror=True, swig=False, **guards):
1658233Snate@binkert.org        '''specify the source file, and any guards'''
1668233Snate@binkert.org        super(Source, self).__init__(source, **guards)
1676143Snate@binkert.org
1688945Ssteve.reinhardt@amd.com        self.Werror = Werror
1696143Snate@binkert.org        self.swig = swig
1706143Snate@binkert.org
1716143Snate@binkert.orgclass PySource(SourceFile):
1726143Snate@binkert.org    '''Add a python source file to the named package'''
1735522Snate@binkert.org    invalid_sym_char = re.compile('[^A-z0-9_]')
1746143Snate@binkert.org    modules = {}
1756143Snate@binkert.org    tnodes = {}
1766143Snate@binkert.org    symnames = {}
1779982Satgutier@umich.edu
1788233Snate@binkert.org    def __init__(self, package, source, **guards):
1798233Snate@binkert.org        '''specify the python package, the source file, and any guards'''
1808233Snate@binkert.org        super(PySource, self).__init__(source, **guards)
1816143Snate@binkert.org
1826143Snate@binkert.org        modname,ext = self.extname
1836143Snate@binkert.org        assert ext == 'py'
1846143Snate@binkert.org
1855522Snate@binkert.org        if package:
1865522Snate@binkert.org            path = package.split('.')
1875522Snate@binkert.org        else:
1885522Snate@binkert.org            path = []
1895604Snate@binkert.org
1905604Snate@binkert.org        modpath = path[:]
1916143Snate@binkert.org        if modname != '__init__':
1926143Snate@binkert.org            modpath += [ modname ]
1934762Snate@binkert.org        modpath = '.'.join(modpath)
1944762Snate@binkert.org
1956143Snate@binkert.org        arcpath = path + [ self.basename ]
1966727Ssteve.reinhardt@amd.com        abspath = self.snode.abspath
1976727Ssteve.reinhardt@amd.com        if not exists(abspath):
1986727Ssteve.reinhardt@amd.com            abspath = self.tnode.abspath
1994762Snate@binkert.org
2006143Snate@binkert.org        self.package = package
2016143Snate@binkert.org        self.modname = modname
2026143Snate@binkert.org        self.modpath = modpath
2036143Snate@binkert.org        self.arcname = joinpath(*arcpath)
2046727Ssteve.reinhardt@amd.com        self.abspath = abspath
2056143Snate@binkert.org        self.compiled = File(self.filename + 'c')
2067674Snate@binkert.org        self.cpp = File(self.filename + '.cc')
2077674Snate@binkert.org        self.symname = PySource.invalid_sym_char.sub('_', modpath)
2085604Snate@binkert.org
2096143Snate@binkert.org        PySource.modules[modpath] = self
2106143Snate@binkert.org        PySource.tnodes[self.tnode] = self
2116143Snate@binkert.org        PySource.symnames[self.symname] = self
2124762Snate@binkert.org
2136143Snate@binkert.orgclass SimObject(PySource):
2144762Snate@binkert.org    '''Add a SimObject python file as a python source object and add
2154762Snate@binkert.org    it to a list of sim object modules'''
2164762Snate@binkert.org
2176143Snate@binkert.org    fixed = False
2186143Snate@binkert.org    modnames = []
2194762Snate@binkert.org
2208233Snate@binkert.org    def __init__(self, source, **guards):
2218233Snate@binkert.org        '''Specify the source file and any guards (automatically in
2228233Snate@binkert.org        the m5.objects package)'''
2238233Snate@binkert.org        super(SimObject, self).__init__('m5.objects', source, **guards)
2246143Snate@binkert.org        if self.fixed:
2256143Snate@binkert.org            raise AttributeError, "Too late to call SimObject now."
2264762Snate@binkert.org
2276143Snate@binkert.org        bisect.insort_right(SimObject.modnames, self.modname)
2284762Snate@binkert.org
2296143Snate@binkert.orgclass SwigSource(SourceFile):
2304762Snate@binkert.org    '''Add a swig file to build'''
2316143Snate@binkert.org
2328233Snate@binkert.org    def __init__(self, package, source, **guards):
2338233Snate@binkert.org        '''Specify the python package, the source file, and any guards'''
23410453SAndrew.Bardsley@arm.com        super(SwigSource, self).__init__(source, skip_no_python=True, **guards)
2356143Snate@binkert.org
2366143Snate@binkert.org        modname,ext = self.extname
2376143Snate@binkert.org        assert ext == 'i'
2386143Snate@binkert.org
2396143Snate@binkert.org        self.module = modname
2406143Snate@binkert.org        cc_file = joinpath(self.dirname, modname + '_wrap.cc')
2416143Snate@binkert.org        py_file = joinpath(self.dirname, modname + '.py')
2426143Snate@binkert.org
24310453SAndrew.Bardsley@arm.com        self.cc_source = Source(cc_file, swig=True, parent=self, **guards)
24410453SAndrew.Bardsley@arm.com        self.py_source = PySource(package, py_file, parent=self, **guards)
245955SN/A
2469396Sandreas.hansson@arm.comclass ProtoBuf(SourceFile):
2479396Sandreas.hansson@arm.com    '''Add a Protocol Buffer to build'''
2489396Sandreas.hansson@arm.com
2499396Sandreas.hansson@arm.com    def __init__(self, source, **guards):
2509396Sandreas.hansson@arm.com        '''Specify the source file, and any guards'''
2519396Sandreas.hansson@arm.com        super(ProtoBuf, self).__init__(source, **guards)
2529396Sandreas.hansson@arm.com
2539396Sandreas.hansson@arm.com        # Get the file name and the extension
2549396Sandreas.hansson@arm.com        modname,ext = self.extname
2559396Sandreas.hansson@arm.com        assert ext == 'proto'
2569396Sandreas.hansson@arm.com
2579396Sandreas.hansson@arm.com        # Currently, we stick to generating the C++ headers, so we
2589396Sandreas.hansson@arm.com        # only need to track the source and header.
2599930Sandreas.hansson@arm.com        self.cc_file = File(modname + '.pb.cc')
2609930Sandreas.hansson@arm.com        self.hh_file = File(modname + '.pb.h')
2619396Sandreas.hansson@arm.com
2628235Snate@binkert.orgclass UnitTest(object):
2638235Snate@binkert.org    '''Create a UnitTest'''
2646143Snate@binkert.org
2658235Snate@binkert.org    all = []
2669003SAli.Saidi@ARM.com    def __init__(self, target, *sources, **kwargs):
2678235Snate@binkert.org        '''Specify the target name and any sources.  Sources that are
2688235Snate@binkert.org        not SourceFiles are evalued with Source().  All files are
2698235Snate@binkert.org        guarded with a guard of the same name as the UnitTest
2708235Snate@binkert.org        target.'''
2718235Snate@binkert.org
2728235Snate@binkert.org        srcs = []
2738235Snate@binkert.org        for src in sources:
2748235Snate@binkert.org            if not isinstance(src, SourceFile):
2758235Snate@binkert.org                src = Source(src, skip_lib=True)
2768235Snate@binkert.org            src.guards[target] = True
2778235Snate@binkert.org            srcs.append(src)
2788235Snate@binkert.org
2798235Snate@binkert.org        self.sources = srcs
2808235Snate@binkert.org        self.target = target
2819003SAli.Saidi@ARM.com        self.main = kwargs.get('main', False)
2828235Snate@binkert.org        UnitTest.all.append(self)
2835584Snate@binkert.org
2844382Sbinkertn@umich.edu# Children should have access
2854202Sbinkertn@umich.eduExport('Source')
2864382Sbinkertn@umich.eduExport('PySource')
2874382Sbinkertn@umich.eduExport('SimObject')
2884382Sbinkertn@umich.eduExport('SwigSource')
2899396Sandreas.hansson@arm.comExport('ProtoBuf')
2905584Snate@binkert.orgExport('UnitTest')
2914382Sbinkertn@umich.edu
2924382Sbinkertn@umich.edu########################################################################
2934382Sbinkertn@umich.edu#
2948232Snate@binkert.org# Debug Flags
2955192Ssaidi@eecs.umich.edu#
2968232Snate@binkert.orgdebug_flags = {}
2978232Snate@binkert.orgdef DebugFlag(name, desc=None):
2988232Snate@binkert.org    if name in debug_flags:
2995192Ssaidi@eecs.umich.edu        raise AttributeError, "Flag %s already specified" % name
3008232Snate@binkert.org    debug_flags[name] = (name, (), desc)
3015192Ssaidi@eecs.umich.edu
3025799Snate@binkert.orgdef CompoundFlag(name, flags, desc=None):
3038232Snate@binkert.org    if name in debug_flags:
3045192Ssaidi@eecs.umich.edu        raise AttributeError, "Flag %s already specified" % name
3055192Ssaidi@eecs.umich.edu
3065192Ssaidi@eecs.umich.edu    compound = tuple(flags)
3078232Snate@binkert.org    debug_flags[name] = (name, compound, desc)
3085192Ssaidi@eecs.umich.edu
3098232Snate@binkert.orgExport('DebugFlag')
3105192Ssaidi@eecs.umich.eduExport('CompoundFlag')
3115192Ssaidi@eecs.umich.edu
3125192Ssaidi@eecs.umich.edu########################################################################
3135192Ssaidi@eecs.umich.edu#
3144382Sbinkertn@umich.edu# Set some compiler variables
3154382Sbinkertn@umich.edu#
3164382Sbinkertn@umich.edu
3172667Sstever@eecs.umich.edu# Include file paths are rooted in this directory.  SCons will
3182667Sstever@eecs.umich.edu# automatically expand '.' to refer to both the source directory and
3192667Sstever@eecs.umich.edu# the corresponding build directory to pick up generated include
3202667Sstever@eecs.umich.edu# files.
3212667Sstever@eecs.umich.eduenv.Append(CPPPATH=Dir('.'))
3222667Sstever@eecs.umich.edu
3235742Snate@binkert.orgfor extra_dir in extras_dir_list:
3245742Snate@binkert.org    env.Append(CPPPATH=Dir(extra_dir))
3255742Snate@binkert.org
3265793Snate@binkert.org# Workaround for bug in SCons version > 0.97d20071212
3278334Snate@binkert.org# Scons bug id: 2006 gem5 Bug id: 308
3285793Snate@binkert.orgfor root, dirs, files in os.walk(base_dir, topdown=True):
3295793Snate@binkert.org    Dir(root[len(base_dir) + 1:])
3305793Snate@binkert.org
3314382Sbinkertn@umich.edu########################################################################
3324762Snate@binkert.org#
3335344Sstever@gmail.com# Walk the tree and execute all SConscripts in subdirectories
3344382Sbinkertn@umich.edu#
3355341Sstever@gmail.com
3365742Snate@binkert.orghere = Dir('.').srcnode().abspath
3375742Snate@binkert.orgfor root, dirs, files in os.walk(base_dir, topdown=True):
3385742Snate@binkert.org    if root == here:
3395742Snate@binkert.org        # we don't want to recurse back into this SConscript
3405742Snate@binkert.org        continue
3414762Snate@binkert.org
3425742Snate@binkert.org    if 'SConscript' in files:
3435742Snate@binkert.org        build_dir = joinpath(env['BUILDDIR'], root[len(base_dir) + 1:])
3447722Sgblack@eecs.umich.edu        SConscript(joinpath(root, 'SConscript'), variant_dir=build_dir)
3455742Snate@binkert.org
3465742Snate@binkert.orgfor extra_dir in extras_dir_list:
3475742Snate@binkert.org    prefix_len = len(dirname(extra_dir)) + 1
3489930Sandreas.hansson@arm.com
3499930Sandreas.hansson@arm.com    # Also add the corresponding build directory to pick up generated
3509930Sandreas.hansson@arm.com    # include files.
3519930Sandreas.hansson@arm.com    env.Append(CPPPATH=Dir(joinpath(env['BUILDDIR'], extra_dir[prefix_len:])))
3529930Sandreas.hansson@arm.com
3535742Snate@binkert.org    for root, dirs, files in os.walk(extra_dir, topdown=True):
3548242Sbradley.danofsky@amd.com        # if build lives in the extras directory, don't walk down it
3558242Sbradley.danofsky@amd.com        if 'build' in dirs:
3568242Sbradley.danofsky@amd.com            dirs.remove('build')
3578242Sbradley.danofsky@amd.com
3585341Sstever@gmail.com        if 'SConscript' in files:
3595742Snate@binkert.org            build_dir = joinpath(env['BUILDDIR'], root[prefix_len:])
3607722Sgblack@eecs.umich.edu            SConscript(joinpath(root, 'SConscript'), variant_dir=build_dir)
3614773Snate@binkert.org
3626108Snate@binkert.orgfor opt in export_vars:
3631858SN/A    env.ConfigFile(opt)
3641085SN/A
3656658Snate@binkert.orgdef makeTheISA(source, target, env):
3666658Snate@binkert.org    isas = [ src.get_contents() for src in source ]
3677673Snate@binkert.org    target_isa = env['TARGET_ISA']
3686658Snate@binkert.org    def define(isa):
3696658Snate@binkert.org        return isa.upper() + '_ISA'
37011308Santhony.gutierrez@amd.com
3716658Snate@binkert.org    def namespace(isa):
37211308Santhony.gutierrez@amd.com        return isa[0].upper() + isa[1:].lower() + 'ISA'
3736658Snate@binkert.org
3746658Snate@binkert.org
3757673Snate@binkert.org    code = code_formatter()
3767673Snate@binkert.org    code('''\
3777673Snate@binkert.org#ifndef __CONFIG_THE_ISA_HH__
3787673Snate@binkert.org#define __CONFIG_THE_ISA_HH__
3797673Snate@binkert.org
3807673Snate@binkert.org''')
3817673Snate@binkert.org
38210467Sandreas.hansson@arm.com    # create defines for the preprocessing and compile-time determination
3836658Snate@binkert.org    for i,isa in enumerate(isas):
3847673Snate@binkert.org        code('#define $0 $1', define(isa), i + 1)
38510467Sandreas.hansson@arm.com    code()
38610467Sandreas.hansson@arm.com
38710467Sandreas.hansson@arm.com    # create an enum for any run-time determination of the ISA, we
38810467Sandreas.hansson@arm.com    # reuse the same name as the namespaces
38910467Sandreas.hansson@arm.com    code('enum class Arch {')
39010467Sandreas.hansson@arm.com    for i,isa in enumerate(isas):
39110467Sandreas.hansson@arm.com        if i + 1 == len(isas):
39210467Sandreas.hansson@arm.com            code('  $0 = $1', namespace(isa), define(isa))
39310467Sandreas.hansson@arm.com        else:
39410467Sandreas.hansson@arm.com            code('  $0 = $1,', namespace(isa), define(isa))
39510467Sandreas.hansson@arm.com    code('};')
3967673Snate@binkert.org
3977673Snate@binkert.org    code('''
3987673Snate@binkert.org
3997673Snate@binkert.org#define THE_ISA ${{define(target_isa)}}
4007673Snate@binkert.org#define TheISA ${{namespace(target_isa)}}
4019048SAli.Saidi@ARM.com#define THE_ISA_STR "${{target_isa}}"
4027673Snate@binkert.org
4037673Snate@binkert.org#endif // __CONFIG_THE_ISA_HH__''')
4047673Snate@binkert.org
4057673Snate@binkert.org    code.write(str(target[0]))
4066658Snate@binkert.org
4077756SAli.Saidi@ARM.comenv.Command('config/the_isa.hh', map(Value, all_isa_list),
4087816Ssteve.reinhardt@amd.com            MakeAction(makeTheISA, Transform("CFG ISA", 0)))
4096658Snate@binkert.org
41011308Santhony.gutierrez@amd.comdef makeTheGPUISA(source, target, env):
41111308Santhony.gutierrez@amd.com    isas = [ src.get_contents() for src in source ]
41211308Santhony.gutierrez@amd.com    target_gpu_isa = env['TARGET_GPU_ISA']
41311308Santhony.gutierrez@amd.com    def define(isa):
41411308Santhony.gutierrez@amd.com        return isa.upper() + '_ISA'
41511308Santhony.gutierrez@amd.com
41611308Santhony.gutierrez@amd.com    def namespace(isa):
41711308Santhony.gutierrez@amd.com        return isa[0].upper() + isa[1:].lower() + 'ISA'
41811308Santhony.gutierrez@amd.com
41911308Santhony.gutierrez@amd.com
42011308Santhony.gutierrez@amd.com    code = code_formatter()
42111308Santhony.gutierrez@amd.com    code('''\
42211308Santhony.gutierrez@amd.com#ifndef __CONFIG_THE_GPU_ISA_HH__
42311308Santhony.gutierrez@amd.com#define __CONFIG_THE_GPU_ISA_HH__
42411308Santhony.gutierrez@amd.com
42511308Santhony.gutierrez@amd.com''')
42611308Santhony.gutierrez@amd.com
42711308Santhony.gutierrez@amd.com    # create defines for the preprocessing and compile-time determination
42811308Santhony.gutierrez@amd.com    for i,isa in enumerate(isas):
42911308Santhony.gutierrez@amd.com        code('#define $0 $1', define(isa), i + 1)
43011308Santhony.gutierrez@amd.com    code()
43111308Santhony.gutierrez@amd.com
43211308Santhony.gutierrez@amd.com    # create an enum for any run-time determination of the ISA, we
43311308Santhony.gutierrez@amd.com    # reuse the same name as the namespaces
43411308Santhony.gutierrez@amd.com    code('enum class GPUArch {')
43511308Santhony.gutierrez@amd.com    for i,isa in enumerate(isas):
43611308Santhony.gutierrez@amd.com        if i + 1 == len(isas):
43711308Santhony.gutierrez@amd.com            code('  $0 = $1', namespace(isa), define(isa))
43811308Santhony.gutierrez@amd.com        else:
43911308Santhony.gutierrez@amd.com            code('  $0 = $1,', namespace(isa), define(isa))
44011308Santhony.gutierrez@amd.com    code('};')
44111308Santhony.gutierrez@amd.com
44211308Santhony.gutierrez@amd.com    code('''
44311308Santhony.gutierrez@amd.com
44411308Santhony.gutierrez@amd.com#define THE_GPU_ISA ${{define(target_gpu_isa)}}
44511308Santhony.gutierrez@amd.com#define TheGpuISA ${{namespace(target_gpu_isa)}}
44611308Santhony.gutierrez@amd.com#define THE_GPU_ISA_STR "${{target_gpu_isa}}"
44711308Santhony.gutierrez@amd.com
44811308Santhony.gutierrez@amd.com#endif // __CONFIG_THE_GPU_ISA_HH__''')
44911308Santhony.gutierrez@amd.com
45011308Santhony.gutierrez@amd.com    code.write(str(target[0]))
45111308Santhony.gutierrez@amd.com
45211308Santhony.gutierrez@amd.comenv.Command('config/the_gpu_isa.hh', map(Value, all_gpu_isa_list),
45311308Santhony.gutierrez@amd.com            MakeAction(makeTheGPUISA, Transform("CFG ISA", 0)))
45411308Santhony.gutierrez@amd.com
4554382Sbinkertn@umich.edu########################################################################
4564382Sbinkertn@umich.edu#
4574762Snate@binkert.org# Prevent any SimObjects from being added after this point, they
4584762Snate@binkert.org# should all have been added in the SConscripts above
4594762Snate@binkert.org#
4606654Snate@binkert.orgSimObject.fixed = True
4616654Snate@binkert.org
4625517Snate@binkert.orgclass DictImporter(object):
4635517Snate@binkert.org    '''This importer takes a dictionary of arbitrary module names that
4645517Snate@binkert.org    map to arbitrary filenames.'''
4655517Snate@binkert.org    def __init__(self, modules):
4665517Snate@binkert.org        self.modules = modules
4675517Snate@binkert.org        self.installed = set()
4685517Snate@binkert.org
4695517Snate@binkert.org    def __del__(self):
4705517Snate@binkert.org        self.unload()
4715517Snate@binkert.org
4725517Snate@binkert.org    def unload(self):
4735517Snate@binkert.org        import sys
4745517Snate@binkert.org        for module in self.installed:
4755517Snate@binkert.org            del sys.modules[module]
4765517Snate@binkert.org        self.installed = set()
4775517Snate@binkert.org
4785517Snate@binkert.org    def find_module(self, fullname, path):
4796654Snate@binkert.org        if fullname == 'm5.defines':
4805517Snate@binkert.org            return self
4815517Snate@binkert.org
4825517Snate@binkert.org        if fullname == 'm5.objects':
4835517Snate@binkert.org            return self
4845517Snate@binkert.org
4855517Snate@binkert.org        if fullname.startswith('m5.internal'):
4865517Snate@binkert.org            return None
4875517Snate@binkert.org
4886143Snate@binkert.org        source = self.modules.get(fullname, None)
4896654Snate@binkert.org        if source is not None and fullname.startswith('m5.objects'):
4905517Snate@binkert.org            return self
4915517Snate@binkert.org
4925517Snate@binkert.org        return None
4935517Snate@binkert.org
4945517Snate@binkert.org    def load_module(self, fullname):
4955517Snate@binkert.org        mod = imp.new_module(fullname)
4965517Snate@binkert.org        sys.modules[fullname] = mod
4975517Snate@binkert.org        self.installed.add(fullname)
4985517Snate@binkert.org
4995517Snate@binkert.org        mod.__loader__ = self
5005517Snate@binkert.org        if fullname == 'm5.objects':
5015517Snate@binkert.org            mod.__path__ = fullname.split('.')
5025517Snate@binkert.org            return mod
5035517Snate@binkert.org
5046654Snate@binkert.org        if fullname == 'm5.defines':
5056654Snate@binkert.org            mod.__dict__['buildEnv'] = m5.util.SmartDict(build_env)
5065517Snate@binkert.org            return mod
5075517Snate@binkert.org
5086143Snate@binkert.org        source = self.modules[fullname]
5096143Snate@binkert.org        if source.modname == '__init__':
5106143Snate@binkert.org            mod.__path__ = source.modpath
5116727Ssteve.reinhardt@amd.com        mod.__file__ = source.abspath
5125517Snate@binkert.org
5136727Ssteve.reinhardt@amd.com        exec file(source.abspath, 'r') in mod.__dict__
5145517Snate@binkert.org
5155517Snate@binkert.org        return mod
5165517Snate@binkert.org
5176654Snate@binkert.orgimport m5.SimObject
5186654Snate@binkert.orgimport m5.params
5197673Snate@binkert.orgfrom m5.util import code_formatter
5206654Snate@binkert.org
5216654Snate@binkert.orgm5.SimObject.clear()
5226654Snate@binkert.orgm5.params.clear()
5236654Snate@binkert.org
5245517Snate@binkert.org# install the python importer so we can grab stuff from the source
5255517Snate@binkert.org# tree itself.  We can't have SimObjects added after this point or
5265517Snate@binkert.org# else we won't know about them for the rest of the stuff.
5276143Snate@binkert.orgimporter = DictImporter(PySource.modules)
5285517Snate@binkert.orgsys.meta_path[0:0] = [ importer ]
5294762Snate@binkert.org
5305517Snate@binkert.org# import all sim objects so we can populate the all_objects list
5315517Snate@binkert.org# make sure that we're working with a list, then let's sort it
5326143Snate@binkert.orgfor modname in SimObject.modnames:
5336143Snate@binkert.org    exec('from m5.objects import %s' % modname)
5345517Snate@binkert.org
5355517Snate@binkert.org# we need to unload all of the currently imported modules so that they
5365517Snate@binkert.org# will be re-imported the next time the sconscript is run
5375517Snate@binkert.orgimporter.unload()
5385517Snate@binkert.orgsys.meta_path.remove(importer)
5395517Snate@binkert.org
5405517Snate@binkert.orgsim_objects = m5.SimObject.allClasses
5415517Snate@binkert.orgall_enums = m5.params.allEnums
5425517Snate@binkert.org
5439338SAndreas.Sandberg@arm.comif m5.SimObject.noCxxHeader:
5449338SAndreas.Sandberg@arm.com    print >> sys.stderr, \
5459338SAndreas.Sandberg@arm.com        "warning: At least one SimObject lacks a header specification. " \
5469338SAndreas.Sandberg@arm.com        "This can cause unexpected results in the generated SWIG " \
5479338SAndreas.Sandberg@arm.com        "wrappers."
5489338SAndreas.Sandberg@arm.com
5498596Ssteve.reinhardt@amd.com# Find param types that need to be explicitly wrapped with swig.
5508596Ssteve.reinhardt@amd.com# These will be recognized because the ParamDesc will have a
5518596Ssteve.reinhardt@amd.com# swig_decl() method.  Most param types are based on types that don't
5528596Ssteve.reinhardt@amd.com# need this, either because they're based on native types (like Int)
5538596Ssteve.reinhardt@amd.com# or because they're SimObjects (which get swigged independently).
5548596Ssteve.reinhardt@amd.com# For now the only things handled here are VectorParam types.
5558596Ssteve.reinhardt@amd.comparams_to_swig = {}
5566143Snate@binkert.orgfor name,obj in sorted(sim_objects.iteritems()):
5575517Snate@binkert.org    for param in obj._params.local.values():
5586654Snate@binkert.org        # load the ptype attribute now because it depends on the
5596654Snate@binkert.org        # current version of SimObject.allClasses, but when scons
5606654Snate@binkert.org        # actually uses the value, all versions of
5616654Snate@binkert.org        # SimObject.allClasses will have been loaded
5626654Snate@binkert.org        param.ptype
5636654Snate@binkert.org
5645517Snate@binkert.org        if not hasattr(param, 'swig_decl'):
5655517Snate@binkert.org            continue
5665517Snate@binkert.org        pname = param.ptype_str
5678596Ssteve.reinhardt@amd.com        if pname not in params_to_swig:
5688596Ssteve.reinhardt@amd.com            params_to_swig[pname] = param
5694762Snate@binkert.org
5704762Snate@binkert.org########################################################################
5714762Snate@binkert.org#
5724762Snate@binkert.org# calculate extra dependencies
5734762Snate@binkert.org#
5744762Snate@binkert.orgmodule_depends = ["m5", "m5.SimObject", "m5.params"]
5757675Snate@binkert.orgdepends = [ PySource.modules[dep].snode for dep in module_depends ]
57610584Sandreas.hansson@arm.comdepends.sort(key = lambda x: x.name)
5774762Snate@binkert.org
5784762Snate@binkert.org########################################################################
5794762Snate@binkert.org#
5804762Snate@binkert.org# Commands for the basic automatically generated python files
5814382Sbinkertn@umich.edu#
5824382Sbinkertn@umich.edu
5835517Snate@binkert.org# Generate Python file containing a dict specifying the current
5846654Snate@binkert.org# buildEnv flags.
5855517Snate@binkert.orgdef makeDefinesPyFile(target, source, env):
5868126Sgblack@eecs.umich.edu    build_env = source[0].get_contents()
5876654Snate@binkert.org
5887673Snate@binkert.org    code = code_formatter()
5896654Snate@binkert.org    code("""
5906654Snate@binkert.orgimport m5.internal
5916654Snate@binkert.orgimport m5.util
5926654Snate@binkert.org
5936654Snate@binkert.orgbuildEnv = m5.util.SmartDict($build_env)
5946654Snate@binkert.org
5956654Snate@binkert.orgcompileDate = m5.internal.core.compileDate
5966669Snate@binkert.org_globals = globals()
5976669Snate@binkert.orgfor key,val in m5.internal.core.__dict__.iteritems():
5986669Snate@binkert.org    if key.startswith('flag_'):
5996669Snate@binkert.org        flag = key[5:]
6006669Snate@binkert.org        _globals[flag] = val
6016669Snate@binkert.orgdel _globals
6026654Snate@binkert.org""")
6037673Snate@binkert.org    code.write(target[0].abspath)
6045517Snate@binkert.org
6058126Sgblack@eecs.umich.edudefines_info = Value(build_env)
6065798Snate@binkert.org# Generate a file with all of the compile options in it
6077756SAli.Saidi@ARM.comenv.Command('python/m5/defines.py', defines_info,
6087816Ssteve.reinhardt@amd.com            MakeAction(makeDefinesPyFile, Transform("DEFINES", 0)))
6095798Snate@binkert.orgPySource('m5', 'python/m5/defines.py')
6105798Snate@binkert.org
6115517Snate@binkert.org# Generate python file containing info about the M5 source code
6125517Snate@binkert.orgdef makeInfoPyFile(target, source, env):
6137673Snate@binkert.org    code = code_formatter()
6145517Snate@binkert.org    for src in source:
6155517Snate@binkert.org        data = ''.join(file(src.srcnode().abspath, 'r').xreadlines())
6167673Snate@binkert.org        code('$src = ${{repr(data)}}')
6177673Snate@binkert.org    code.write(str(target[0]))
6185517Snate@binkert.org
6195798Snate@binkert.org# Generate a file that wraps the basic top level files
6205798Snate@binkert.orgenv.Command('python/m5/info.py',
6218333Snate@binkert.org            [ '#/COPYING', '#/LICENSE', '#/README', ],
6227816Ssteve.reinhardt@amd.com            MakeAction(makeInfoPyFile, Transform("INFO")))
6235798Snate@binkert.orgPySource('m5', 'python/m5/info.py')
6245798Snate@binkert.org
6254762Snate@binkert.org########################################################################
6264762Snate@binkert.org#
6274762Snate@binkert.org# Create all of the SimObject param headers and enum headers
6284762Snate@binkert.org#
6294762Snate@binkert.org
6308596Ssteve.reinhardt@amd.comdef createSimObjectParamStruct(target, source, env):
6315517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6325517Snate@binkert.org
6335517Snate@binkert.org    name = str(source[0].get_contents())
6345517Snate@binkert.org    obj = sim_objects[name]
6355517Snate@binkert.org
6367673Snate@binkert.org    code = code_formatter()
6378596Ssteve.reinhardt@amd.com    obj.cxx_param_decl(code)
6387673Snate@binkert.org    code.write(target[0].abspath)
6395517Snate@binkert.org
64010458Sandreas.hansson@arm.comdef createSimObjectCxxConfig(is_header):
64110458Sandreas.hansson@arm.com    def body(target, source, env):
64210458Sandreas.hansson@arm.com        assert len(target) == 1 and len(source) == 1
64310458Sandreas.hansson@arm.com
64410458Sandreas.hansson@arm.com        name = str(source[0].get_contents())
64510458Sandreas.hansson@arm.com        obj = sim_objects[name]
64610458Sandreas.hansson@arm.com
64710458Sandreas.hansson@arm.com        code = code_formatter()
64810458Sandreas.hansson@arm.com        obj.cxx_config_param_file(code, is_header)
64910458Sandreas.hansson@arm.com        code.write(target[0].abspath)
65010458Sandreas.hansson@arm.com    return body
65110458Sandreas.hansson@arm.com
6528596Ssteve.reinhardt@amd.comdef createParamSwigWrapper(target, source, env):
6535517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6545517Snate@binkert.org
6555517Snate@binkert.org    name = str(source[0].get_contents())
6568596Ssteve.reinhardt@amd.com    param = params_to_swig[name]
6575517Snate@binkert.org
6587673Snate@binkert.org    code = code_formatter()
6597673Snate@binkert.org    param.swig_decl(code)
6607673Snate@binkert.org    code.write(target[0].abspath)
6615517Snate@binkert.org
6625517Snate@binkert.orgdef createEnumStrings(target, source, env):
6635517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6645517Snate@binkert.org
6655517Snate@binkert.org    name = str(source[0].get_contents())
6665517Snate@binkert.org    obj = all_enums[name]
6675517Snate@binkert.org
6687673Snate@binkert.org    code = code_formatter()
6697673Snate@binkert.org    obj.cxx_def(code)
6707673Snate@binkert.org    code.write(target[0].abspath)
6715517Snate@binkert.org
6728596Ssteve.reinhardt@amd.comdef createEnumDecls(target, source, env):
6735517Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6745517Snate@binkert.org
6755517Snate@binkert.org    name = str(source[0].get_contents())
6765517Snate@binkert.org    obj = all_enums[name]
6775517Snate@binkert.org
6787673Snate@binkert.org    code = code_formatter()
6797673Snate@binkert.org    obj.cxx_decl(code)
6807673Snate@binkert.org    code.write(target[0].abspath)
6815517Snate@binkert.org
6828596Ssteve.reinhardt@amd.comdef createEnumSwigWrapper(target, source, env):
6837675Snate@binkert.org    assert len(target) == 1 and len(source) == 1
6847675Snate@binkert.org
6857675Snate@binkert.org    name = str(source[0].get_contents())
6867675Snate@binkert.org    obj = all_enums[name]
6877675Snate@binkert.org
6887675Snate@binkert.org    code = code_formatter()
6898596Ssteve.reinhardt@amd.com    obj.swig_decl(code)
6907675Snate@binkert.org    code.write(target[0].abspath)
6917675Snate@binkert.org
6928596Ssteve.reinhardt@amd.comdef createSimObjectSwigWrapper(target, source, env):
6938596Ssteve.reinhardt@amd.com    name = source[0].get_contents()
6948596Ssteve.reinhardt@amd.com    obj = sim_objects[name]
6958596Ssteve.reinhardt@amd.com
6968596Ssteve.reinhardt@amd.com    code = code_formatter()
6978596Ssteve.reinhardt@amd.com    obj.swig_decl(code)
6988596Ssteve.reinhardt@amd.com    code.write(target[0].abspath)
6998596Ssteve.reinhardt@amd.com
70010454SCurtis.Dunham@arm.com# dummy target for generated code
70110454SCurtis.Dunham@arm.com# we start out with all the Source files so they get copied to build/*/ also.
70210454SCurtis.Dunham@arm.comSWIG = env.Dummy('swig', [s.tnode for s in Source.get()])
70310454SCurtis.Dunham@arm.com
7048596Ssteve.reinhardt@amd.com# Generate all of the SimObject param C++ struct header files
7054762Snate@binkert.orgparams_hh_files = []
7066143Snate@binkert.orgfor name,simobj in sorted(sim_objects.iteritems()):
7076143Snate@binkert.org    py_source = PySource.modules[simobj.__module__]
7086143Snate@binkert.org    extra_deps = [ py_source.tnode ]
7094762Snate@binkert.org
7104762Snate@binkert.org    hh_file = File('params/%s.hh' % name)
7114762Snate@binkert.org    params_hh_files.append(hh_file)
7127756SAli.Saidi@ARM.com    env.Command(hh_file, Value(name),
7138596Ssteve.reinhardt@amd.com                MakeAction(createSimObjectParamStruct, Transform("SO PARAM")))
7144762Snate@binkert.org    env.Depends(hh_file, depends + extra_deps)
71510454SCurtis.Dunham@arm.com    env.Depends(SWIG, hh_file)
7164762Snate@binkert.org
71710458Sandreas.hansson@arm.com# C++ parameter description files
71810458Sandreas.hansson@arm.comif GetOption('with_cxx_config'):
71910458Sandreas.hansson@arm.com    for name,simobj in sorted(sim_objects.iteritems()):
72010458Sandreas.hansson@arm.com        py_source = PySource.modules[simobj.__module__]
72110458Sandreas.hansson@arm.com        extra_deps = [ py_source.tnode ]
72210458Sandreas.hansson@arm.com
72310458Sandreas.hansson@arm.com        cxx_config_hh_file = File('cxx_config/%s.hh' % name)
72410458Sandreas.hansson@arm.com        cxx_config_cc_file = File('cxx_config/%s.cc' % name)
72510458Sandreas.hansson@arm.com        env.Command(cxx_config_hh_file, Value(name),
72610458Sandreas.hansson@arm.com                    MakeAction(createSimObjectCxxConfig(True),
72710458Sandreas.hansson@arm.com                    Transform("CXXCPRHH")))
72810458Sandreas.hansson@arm.com        env.Command(cxx_config_cc_file, Value(name),
72910458Sandreas.hansson@arm.com                    MakeAction(createSimObjectCxxConfig(False),
73010458Sandreas.hansson@arm.com                    Transform("CXXCPRCC")))
73110458Sandreas.hansson@arm.com        env.Depends(cxx_config_hh_file, depends + extra_deps +
73210458Sandreas.hansson@arm.com                    [File('params/%s.hh' % name), File('sim/cxx_config.hh')])
73310458Sandreas.hansson@arm.com        env.Depends(cxx_config_cc_file, depends + extra_deps +
73410458Sandreas.hansson@arm.com                    [cxx_config_hh_file])
73510458Sandreas.hansson@arm.com        Source(cxx_config_cc_file)
73610458Sandreas.hansson@arm.com
73710458Sandreas.hansson@arm.com    cxx_config_init_cc_file = File('cxx_config/init.cc')
73810458Sandreas.hansson@arm.com
73910458Sandreas.hansson@arm.com    def createCxxConfigInitCC(target, source, env):
74010458Sandreas.hansson@arm.com        assert len(target) == 1 and len(source) == 1
74110458Sandreas.hansson@arm.com
74210458Sandreas.hansson@arm.com        code = code_formatter()
74310458Sandreas.hansson@arm.com
74410458Sandreas.hansson@arm.com        for name,simobj in sorted(sim_objects.iteritems()):
74510458Sandreas.hansson@arm.com            if not hasattr(simobj, 'abstract') or not simobj.abstract:
74610458Sandreas.hansson@arm.com                code('#include "cxx_config/${name}.hh"')
74710458Sandreas.hansson@arm.com        code()
74810458Sandreas.hansson@arm.com        code('void cxxConfigInit()')
74910458Sandreas.hansson@arm.com        code('{')
75010458Sandreas.hansson@arm.com        code.indent()
75110458Sandreas.hansson@arm.com        for name,simobj in sorted(sim_objects.iteritems()):
75210458Sandreas.hansson@arm.com            not_abstract = not hasattr(simobj, 'abstract') or \
75310458Sandreas.hansson@arm.com                not simobj.abstract
75410458Sandreas.hansson@arm.com            if not_abstract and 'type' in simobj.__dict__:
75510458Sandreas.hansson@arm.com                code('cxx_config_directory["${name}"] = '
75610458Sandreas.hansson@arm.com                     '${name}CxxConfigParams::makeDirectoryEntry();')
75710458Sandreas.hansson@arm.com        code.dedent()
75810458Sandreas.hansson@arm.com        code('}')
75910458Sandreas.hansson@arm.com        code.write(target[0].abspath)
76010458Sandreas.hansson@arm.com
76110458Sandreas.hansson@arm.com    py_source = PySource.modules[simobj.__module__]
76210458Sandreas.hansson@arm.com    extra_deps = [ py_source.tnode ]
76310458Sandreas.hansson@arm.com    env.Command(cxx_config_init_cc_file, Value(name),
76410458Sandreas.hansson@arm.com        MakeAction(createCxxConfigInitCC, Transform("CXXCINIT")))
76510458Sandreas.hansson@arm.com    cxx_param_hh_files = ["cxx_config/%s.hh" % simobj
76610584Sandreas.hansson@arm.com        for name,simobj in sorted(sim_objects.iteritems())
76710458Sandreas.hansson@arm.com        if not hasattr(simobj, 'abstract') or not simobj.abstract]
76810458Sandreas.hansson@arm.com    Depends(cxx_config_init_cc_file, cxx_param_hh_files +
76910458Sandreas.hansson@arm.com            [File('sim/cxx_config.hh')])
77010458Sandreas.hansson@arm.com    Source(cxx_config_init_cc_file)
77110458Sandreas.hansson@arm.com
7728596Ssteve.reinhardt@amd.com# Generate any needed param SWIG wrapper files
7735463Snate@binkert.orgparams_i_files = []
77410584Sandreas.hansson@arm.comfor name,param in sorted(params_to_swig.iteritems()):
7758596Ssteve.reinhardt@amd.com    i_file = File('python/m5/internal/%s.i' % (param.swig_module_name()))
7765463Snate@binkert.org    params_i_files.append(i_file)
7777756SAli.Saidi@ARM.com    env.Command(i_file, Value(name),
7788596Ssteve.reinhardt@amd.com                MakeAction(createParamSwigWrapper, Transform("SW PARAM")))
7794762Snate@binkert.org    env.Depends(i_file, depends)
78010454SCurtis.Dunham@arm.com    env.Depends(SWIG, i_file)
7817677Snate@binkert.org    SwigSource('m5.internal', i_file)
7824762Snate@binkert.org
7834762Snate@binkert.org# Generate all enum header files
7846143Snate@binkert.orgfor name,enum in sorted(all_enums.iteritems()):
7856143Snate@binkert.org    py_source = PySource.modules[enum.__module__]
7866143Snate@binkert.org    extra_deps = [ py_source.tnode ]
7874762Snate@binkert.org
7884762Snate@binkert.org    cc_file = File('enums/%s.cc' % name)
7897756SAli.Saidi@ARM.com    env.Command(cc_file, Value(name),
7907816Ssteve.reinhardt@amd.com                MakeAction(createEnumStrings, Transform("ENUM STR")))
7914762Snate@binkert.org    env.Depends(cc_file, depends + extra_deps)
79210454SCurtis.Dunham@arm.com    env.Depends(SWIG, cc_file)
7934762Snate@binkert.org    Source(cc_file)
7944762Snate@binkert.org
7954762Snate@binkert.org    hh_file = File('enums/%s.hh' % name)
7967756SAli.Saidi@ARM.com    env.Command(hh_file, Value(name),
7978596Ssteve.reinhardt@amd.com                MakeAction(createEnumDecls, Transform("ENUMDECL")))
7984762Snate@binkert.org    env.Depends(hh_file, depends + extra_deps)
79910454SCurtis.Dunham@arm.com    env.Depends(SWIG, hh_file)
8004762Snate@binkert.org
8017677Snate@binkert.org    i_file = File('python/m5/internal/enum_%s.i' % name)
8027756SAli.Saidi@ARM.com    env.Command(i_file, Value(name),
8038596Ssteve.reinhardt@amd.com                MakeAction(createEnumSwigWrapper, Transform("ENUMSWIG")))
8047675Snate@binkert.org    env.Depends(i_file, depends + extra_deps)
80510454SCurtis.Dunham@arm.com    env.Depends(SWIG, i_file)
8067677Snate@binkert.org    SwigSource('m5.internal', i_file)
8075517Snate@binkert.org
8088596Ssteve.reinhardt@amd.com# Generate SimObject SWIG wrapper files
80910584Sandreas.hansson@arm.comfor name,simobj in sorted(sim_objects.iteritems()):
8109248SAndreas.Sandberg@arm.com    py_source = PySource.modules[simobj.__module__]
8119248SAndreas.Sandberg@arm.com    extra_deps = [ py_source.tnode ]
8128596Ssteve.reinhardt@amd.com    i_file = File('python/m5/internal/param_%s.i' % name)
8138596Ssteve.reinhardt@amd.com    env.Command(i_file, Value(name),
8148596Ssteve.reinhardt@amd.com                MakeAction(createSimObjectSwigWrapper, Transform("SO SWIG")))
8159248SAndreas.Sandberg@arm.com    env.Depends(i_file, depends + extra_deps)
8168596Ssteve.reinhardt@amd.com    SwigSource('m5.internal', i_file)
8174762Snate@binkert.org
8187674Snate@binkert.org# Generate the main swig init file
8197674Snate@binkert.orgdef makeEmbeddedSwigInit(target, source, env):
8207674Snate@binkert.org    code = code_formatter()
8217674Snate@binkert.org    module = source[0].get_contents()
8227674Snate@binkert.org    code('''\
8237674Snate@binkert.org#include "sim/init.hh"
8247674Snate@binkert.org
8257674Snate@binkert.orgextern "C" {
8267674Snate@binkert.org    void init_${module}();
8277674Snate@binkert.org}
8287674Snate@binkert.org
8297674Snate@binkert.orgEmbeddedSwig embed_swig_${module}(init_${module});
8307674Snate@binkert.org''')
8317674Snate@binkert.org    code.write(str(target[0]))
83211308Santhony.gutierrez@amd.com
8334762Snate@binkert.org# Build all swig modules
8346143Snate@binkert.orgfor swig in SwigSource.all:
8356143Snate@binkert.org    env.Command([swig.cc_source.tnode, swig.py_source.tnode], swig.tnode,
8367756SAli.Saidi@ARM.com                MakeAction('$SWIG $SWIGFLAGS -outdir ${TARGETS[1].dir} '
8377816Ssteve.reinhardt@amd.com                '-o ${TARGETS[0]} $SOURCES', Transform("SWIG")))
8388235Snate@binkert.org    cc_file = str(swig.tnode)
8398596Ssteve.reinhardt@amd.com    init_file = '%s/%s_init.cc' % (dirname(cc_file), basename(cc_file))
8407756SAli.Saidi@ARM.com    env.Command(init_file, Value(swig.module),
8417816Ssteve.reinhardt@amd.com                MakeAction(makeEmbeddedSwigInit, Transform("EMBED SW")))
84210454SCurtis.Dunham@arm.com    env.Depends(SWIG, init_file)
8438235Snate@binkert.org    Source(init_file, **swig.guards)
8444382Sbinkertn@umich.edu
8459396Sandreas.hansson@arm.com# Build all protocol buffers if we have got protoc and protobuf available
8469396Sandreas.hansson@arm.comif env['HAVE_PROTOBUF']:
8479396Sandreas.hansson@arm.com    for proto in ProtoBuf.all:
8489396Sandreas.hansson@arm.com        # Use both the source and header as the target, and the .proto
8499396Sandreas.hansson@arm.com        # file as the source. When executing the protoc compiler, also
8509396Sandreas.hansson@arm.com        # specify the proto_path to avoid having the generated files
8519396Sandreas.hansson@arm.com        # include the path.
8529396Sandreas.hansson@arm.com        env.Command([proto.cc_file, proto.hh_file], proto.tnode,
8539396Sandreas.hansson@arm.com                    MakeAction('$PROTOC --cpp_out ${TARGET.dir} '
8549396Sandreas.hansson@arm.com                               '--proto_path ${SOURCE.dir} $SOURCE',
8559396Sandreas.hansson@arm.com                               Transform("PROTOC")))
8569396Sandreas.hansson@arm.com
85710454SCurtis.Dunham@arm.com        env.Depends(SWIG, [proto.cc_file, proto.hh_file])
8589396Sandreas.hansson@arm.com        # Add the C++ source file
8599396Sandreas.hansson@arm.com        Source(proto.cc_file, **proto.guards)
8609396Sandreas.hansson@arm.comelif ProtoBuf.all:
8619396Sandreas.hansson@arm.com    print 'Got protobuf to build, but lacks support!'
8629396Sandreas.hansson@arm.com    Exit(1)
8639396Sandreas.hansson@arm.com
8648232Snate@binkert.org#
8658232Snate@binkert.org# Handle debug flags
8668232Snate@binkert.org#
8678232Snate@binkert.orgdef makeDebugFlagCC(target, source, env):
8688232Snate@binkert.org    assert(len(target) == 1 and len(source) == 1)
8696229Snate@binkert.org
87010455SCurtis.Dunham@arm.com    code = code_formatter()
8716229Snate@binkert.org
87210455SCurtis.Dunham@arm.com    # delay definition of CompoundFlags until after all the definition
87310455SCurtis.Dunham@arm.com    # of all constituent SimpleFlags
87410455SCurtis.Dunham@arm.com    comp_code = code_formatter()
8755517Snate@binkert.org
8765517Snate@binkert.org    # file header
8777673Snate@binkert.org    code('''
8785517Snate@binkert.org/*
87910455SCurtis.Dunham@arm.com * DO NOT EDIT THIS FILE! Automatically generated by SCons.
8805517Snate@binkert.org */
8815517Snate@binkert.org
8828232Snate@binkert.org#include "base/debug.hh"
88310455SCurtis.Dunham@arm.com
88410455SCurtis.Dunham@arm.comnamespace Debug {
88510455SCurtis.Dunham@arm.com
8867673Snate@binkert.org''')
8877673Snate@binkert.org
88810455SCurtis.Dunham@arm.com    for name, flag in sorted(source[0].read().iteritems()):
88910455SCurtis.Dunham@arm.com        n, compound, desc = flag
89010455SCurtis.Dunham@arm.com        assert n == name
8915517Snate@binkert.org
89210455SCurtis.Dunham@arm.com        if not compound:
89310455SCurtis.Dunham@arm.com            code('SimpleFlag $name("$name", "$desc");')
89410455SCurtis.Dunham@arm.com        else:
89510455SCurtis.Dunham@arm.com            comp_code('CompoundFlag $name("$name", "$desc",')
89610455SCurtis.Dunham@arm.com            comp_code.indent()
89710455SCurtis.Dunham@arm.com            last = len(compound) - 1
89810455SCurtis.Dunham@arm.com            for i,flag in enumerate(compound):
89910455SCurtis.Dunham@arm.com                if i != last:
90010685Sandreas.hansson@arm.com                    comp_code('&$flag,')
90110455SCurtis.Dunham@arm.com                else:
90210685Sandreas.hansson@arm.com                    comp_code('&$flag);')
90310455SCurtis.Dunham@arm.com            comp_code.dedent()
9045517Snate@binkert.org
90510455SCurtis.Dunham@arm.com    code.append(comp_code)
9068232Snate@binkert.org    code()
9078232Snate@binkert.org    code('} // namespace Debug')
9085517Snate@binkert.org
9097673Snate@binkert.org    code.write(str(target[0]))
9105517Snate@binkert.org
9118232Snate@binkert.orgdef makeDebugFlagHH(target, source, env):
9128232Snate@binkert.org    assert(len(target) == 1 and len(source) == 1)
9135517Snate@binkert.org
9148232Snate@binkert.org    val = eval(source[0].get_contents())
9158232Snate@binkert.org    name, compound, desc = val
9168232Snate@binkert.org
9177673Snate@binkert.org    code = code_formatter()
9185517Snate@binkert.org
9195517Snate@binkert.org    # file header boilerplate
9207673Snate@binkert.org    code('''\
9215517Snate@binkert.org/*
92210455SCurtis.Dunham@arm.com * DO NOT EDIT THIS FILE! Automatically generated by SCons.
9235517Snate@binkert.org */
9245517Snate@binkert.org
9258232Snate@binkert.org#ifndef __DEBUG_${name}_HH__
9268232Snate@binkert.org#define __DEBUG_${name}_HH__
9275517Snate@binkert.org
9288232Snate@binkert.orgnamespace Debug {
9298232Snate@binkert.org''')
9305517Snate@binkert.org
9318232Snate@binkert.org    if compound:
9328232Snate@binkert.org        code('class CompoundFlag;')
9338232Snate@binkert.org    code('class SimpleFlag;')
9345517Snate@binkert.org
9358232Snate@binkert.org    if compound:
9368232Snate@binkert.org        code('extern CompoundFlag $name;')
9378232Snate@binkert.org        for flag in compound:
9388232Snate@binkert.org            code('extern SimpleFlag $flag;')
9398232Snate@binkert.org    else:
9408232Snate@binkert.org        code('extern SimpleFlag $name;')
9415517Snate@binkert.org
9428232Snate@binkert.org    code('''
9438232Snate@binkert.org}
9445517Snate@binkert.org
9458232Snate@binkert.org#endif // __DEBUG_${name}_HH__
9467673Snate@binkert.org''')
9475517Snate@binkert.org
9487673Snate@binkert.org    code.write(str(target[0]))
9495517Snate@binkert.org
9508232Snate@binkert.orgfor name,flag in sorted(debug_flags.iteritems()):
9518232Snate@binkert.org    n, compound, desc = flag
9528232Snate@binkert.org    assert n == name
9535192Ssaidi@eecs.umich.edu
95410454SCurtis.Dunham@arm.com    hh_file = 'debug/%s.hh' % name
95510454SCurtis.Dunham@arm.com    env.Command(hh_file, Value(flag),
9568232Snate@binkert.org                MakeAction(makeDebugFlagHH, Transform("TRACING", 0)))
95710455SCurtis.Dunham@arm.com    env.Depends(SWIG, hh_file)
95810455SCurtis.Dunham@arm.com
95910455SCurtis.Dunham@arm.comenv.Command('debug/flags.cc', Value(debug_flags),
96010455SCurtis.Dunham@arm.com            MakeAction(makeDebugFlagCC, Transform("TRACING", 0)))
96110455SCurtis.Dunham@arm.comenv.Depends(SWIG, 'debug/flags.cc')
96210455SCurtis.Dunham@arm.comSource('debug/flags.cc')
9635192Ssaidi@eecs.umich.edu
96411077SCurtis.Dunham@arm.com# version tags
96511330SCurtis.Dunham@arm.comtags = \
96611077SCurtis.Dunham@arm.comenv.Command('sim/tags.cc', None,
96711077SCurtis.Dunham@arm.com            MakeAction('util/cpt_upgrader.py --get-cc-file > $TARGET',
96811077SCurtis.Dunham@arm.com                       Transform("VER TAGS")))
96911330SCurtis.Dunham@arm.comenv.AlwaysBuild(tags)
97011077SCurtis.Dunham@arm.com
9717674Snate@binkert.org# Embed python files.  All .py files that have been indicated by a
9725522Snate@binkert.org# PySource() call in a SConscript need to be embedded into the M5
9735522Snate@binkert.org# library.  To do that, we compile the file to byte code, marshal the
9747674Snate@binkert.org# byte code, compress it, and then generate a c++ file that
9757674Snate@binkert.org# inserts the result into an array.
9767674Snate@binkert.orgdef embedPyFile(target, source, env):
9777674Snate@binkert.org    def c_str(string):
9787674Snate@binkert.org        if string is None:
9797674Snate@binkert.org            return "0"
9807674Snate@binkert.org        return '"%s"' % string
9817674Snate@binkert.org
9825522Snate@binkert.org    '''Action function to compile a .py into a code object, marshal
9835522Snate@binkert.org    it, compress it, and stick it into an asm file so the code appears
9845522Snate@binkert.org    as just bytes with a label in the data section'''
9855517Snate@binkert.org
9865522Snate@binkert.org    src = file(str(source[0]), 'r').read()
9875517Snate@binkert.org
9886143Snate@binkert.org    pysource = PySource.tnodes[source[0]]
9896727Ssteve.reinhardt@amd.com    compiled = compile(src, pysource.abspath, 'exec')
9905522Snate@binkert.org    marshalled = marshal.dumps(compiled)
9915522Snate@binkert.org    compressed = zlib.compress(marshalled)
9925522Snate@binkert.org    data = compressed
9937674Snate@binkert.org    sym = pysource.symname
9945517Snate@binkert.org
9957673Snate@binkert.org    code = code_formatter()
9967673Snate@binkert.org    code('''\
9977674Snate@binkert.org#include "sim/init.hh"
9987673Snate@binkert.org
9997674Snate@binkert.orgnamespace {
10007674Snate@binkert.org
10018946Sandreas.hansson@arm.comconst uint8_t data_${sym}[] = {
10027674Snate@binkert.org''')
10037674Snate@binkert.org    code.indent()
10047674Snate@binkert.org    step = 16
10055522Snate@binkert.org    for i in xrange(0, len(data), step):
10065522Snate@binkert.org        x = array.array('B', data[i:i+step])
10077674Snate@binkert.org        code(''.join('%d,' % d for d in x))
10087674Snate@binkert.org    code.dedent()
100911308Santhony.gutierrez@amd.com
10107674Snate@binkert.org    code('''};
10117673Snate@binkert.org
10127674Snate@binkert.orgEmbeddedPython embedded_${sym}(
10137674Snate@binkert.org    ${{c_str(pysource.arcname)}},
10147674Snate@binkert.org    ${{c_str(pysource.abspath)}},
10157674Snate@binkert.org    ${{c_str(pysource.modpath)}},
10167674Snate@binkert.org    data_${sym},
10177674Snate@binkert.org    ${{len(data)}},
10187674Snate@binkert.org    ${{len(marshalled)}});
10197674Snate@binkert.org
10207811Ssteve.reinhardt@amd.com} // anonymous namespace
10217674Snate@binkert.org''')
10227673Snate@binkert.org    code.write(str(target[0]))
10235522Snate@binkert.org
10246143Snate@binkert.orgfor source in PySource.all:
102510453SAndrew.Bardsley@arm.com    env.Command(source.cpp, source.tnode,
10267816Ssteve.reinhardt@amd.com                MakeAction(embedPyFile, Transform("EMBED PY")))
102710454SCurtis.Dunham@arm.com    env.Depends(SWIG, source.cpp)
102810453SAndrew.Bardsley@arm.com    Source(source.cpp, skip_no_python=True)
10294382Sbinkertn@umich.edu
10304382Sbinkertn@umich.edu########################################################################
10314382Sbinkertn@umich.edu#
10324382Sbinkertn@umich.edu# Define binaries.  Each different build type (debug, opt, etc.) gets
10334382Sbinkertn@umich.edu# a slightly different build environment.
10344382Sbinkertn@umich.edu#
10354382Sbinkertn@umich.edu
10364382Sbinkertn@umich.edu# List of constructed environments to pass back to SConstruct
103710196SCurtis.Dunham@arm.comdate_source = Source('base/date.cc', skip_lib=True)
10384382Sbinkertn@umich.edu
103910196SCurtis.Dunham@arm.com# Capture this directory for the closure makeEnv, otherwise when it is
104010196SCurtis.Dunham@arm.com# called, it won't know what directory it should use.
104110196SCurtis.Dunham@arm.comvariant_dir = Dir('.').path
104210196SCurtis.Dunham@arm.comdef variant(*path):
104310196SCurtis.Dunham@arm.com    return os.path.join(variant_dir, *path)
104410196SCurtis.Dunham@arm.comdef variantd(*path):
104510196SCurtis.Dunham@arm.com    return variant(*path)+'/'
1046955SN/A
10472655Sstever@eecs.umich.edu# Function to create a new build environment as clone of current
10482655Sstever@eecs.umich.edu# environment 'env' with modified object suffix and optional stripped
10492655Sstever@eecs.umich.edu# binary.  Additional keyword arguments are appended to corresponding
10502655Sstever@eecs.umich.edu# build environment vars.
105110196SCurtis.Dunham@arm.comdef makeEnv(env, label, objsfx, strip = False, **kwargs):
10525601Snate@binkert.org    # SCons doesn't know to append a library suffix when there is a '.' in the
10535601Snate@binkert.org    # name.  Use '_' instead.
105410196SCurtis.Dunham@arm.com    libname = variant('gem5_' + label)
105510196SCurtis.Dunham@arm.com    exename = variant('gem5.' + label)
105610196SCurtis.Dunham@arm.com    secondary_exename = variant('m5.' + label)
10575522Snate@binkert.org
10585863Snate@binkert.org    new_env = env.Clone(OBJSUFFIX=objsfx, SHOBJSUFFIX=objsfx + 's')
10595601Snate@binkert.org    new_env.Label = label
10605601Snate@binkert.org    new_env.Append(**kwargs)
10615601Snate@binkert.org
10625863Snate@binkert.org    swig_env = new_env.Clone()
10639556Sandreas.hansson@arm.com
10649556Sandreas.hansson@arm.com    # Both gcc and clang have issues with unused labels and values in
10659556Sandreas.hansson@arm.com    # the SWIG generated code
10669556Sandreas.hansson@arm.com    swig_env.Append(CCFLAGS=['-Wno-unused-label', '-Wno-unused-value'])
10679556Sandreas.hansson@arm.com
10685559Snate@binkert.org    if env['GCC']:
10699556Sandreas.hansson@arm.com        # Depending on the SWIG version, we also need to supress
10709618Ssteve.reinhardt@amd.com        # warnings about uninitialized variables and missing field
10719618Ssteve.reinhardt@amd.com        # initializers.
10729618Ssteve.reinhardt@amd.com        swig_env.Append(CCFLAGS=['-Wno-uninitialized',
107310238Sandreas.hansson@arm.com                                 '-Wno-missing-field-initializers',
107410878Sandreas.hansson@arm.com                                 '-Wno-unused-but-set-variable',
107511294Sandreas.hansson@arm.com                                 '-Wno-maybe-uninitialized',
107611294Sandreas.hansson@arm.com                                 '-Wno-type-limits'])
107710457Sandreas.hansson@arm.com
107810457Sandreas.hansson@arm.com        # Only gcc >= 4.9 supports UBSan, so check both the version
107910457Sandreas.hansson@arm.com        # and the command-line option before adding the compiler and
108010457Sandreas.hansson@arm.com        # linker flags.
108110457Sandreas.hansson@arm.com        if GetOption('with_ubsan') and \
108210457Sandreas.hansson@arm.com                compareVersions(env['GCC_VERSION'], '4.9') >= 0:
108310457Sandreas.hansson@arm.com            new_env.Append(CCFLAGS='-fsanitize=undefined')
108410457Sandreas.hansson@arm.com            new_env.Append(LINKFLAGS='-fsanitize=undefined')
108510457Sandreas.hansson@arm.com
108611342Sandreas.hansson@arm.com        # The address sanitizer is available for gcc >= 4.8
108711342Sandreas.hansson@arm.com        if GetOption('with_asan')  and \
108811342Sandreas.hansson@arm.com                compareVersions(env['GCC_VERSION'], '4.8') >= 0:
108911342Sandreas.hansson@arm.com            new_env.Append(CCFLAGS='-fsanitize=address')
109011342Sandreas.hansson@arm.com            new_env.Append(LINKFLAGS='-fsanitize=address')
109111342Sandreas.hansson@arm.com
10928737Skoansin.tan@gmail.com    if env['CLANG']:
109311294Sandreas.hansson@arm.com        swig_env.Append(CCFLAGS=['-Wno-sometimes-uninitialized',
109411294Sandreas.hansson@arm.com                                 '-Wno-deprecated-register',
109511294Sandreas.hansson@arm.com                                 '-Wno-tautological-compare'])
109610278SAndreas.Sandberg@ARM.com
109711342Sandreas.hansson@arm.com        # We require clang >= 3.1, so there is no need to check any
109811342Sandreas.hansson@arm.com        # versions here.
109910457Sandreas.hansson@arm.com        if GetOption('with_ubsan'):
110010457Sandreas.hansson@arm.com            new_env.Append(CCFLAGS='-fsanitize=undefined')
110110457Sandreas.hansson@arm.com            new_env.Append(LINKFLAGS='-fsanitize=undefined')
110210457Sandreas.hansson@arm.com
110311342Sandreas.hansson@arm.com        if GetOption('with_asan'):
110411342Sandreas.hansson@arm.com            new_env.Append(CCFLAGS='-fsanitize=address')
110511342Sandreas.hansson@arm.com            new_env.Append(LINKFLAGS='-fsanitize=address')
110611342Sandreas.hansson@arm.com
11078945Ssteve.reinhardt@amd.com    werror_env = new_env.Clone()
110810686SAndreas.Sandberg@ARM.com    # Treat warnings as errors but white list some warnings that we
110910686SAndreas.Sandberg@ARM.com    # want to allow (e.g., deprecation warnings).
111010686SAndreas.Sandberg@ARM.com    werror_env.Append(CCFLAGS=['-Werror',
111110686SAndreas.Sandberg@ARM.com                               '-Wno-error=deprecated-declarations',
111210686SAndreas.Sandberg@ARM.com                               '-Wno-error=deprecated',
111310686SAndreas.Sandberg@ARM.com                               ])
11148945Ssteve.reinhardt@amd.com
11156143Snate@binkert.org    def make_obj(source, static, extra_deps = None):
11166143Snate@binkert.org        '''This function adds the specified source to the correct
11176143Snate@binkert.org        build environment, and returns the corresponding SCons Object
11186143Snate@binkert.org        nodes'''
11196143Snate@binkert.org
11206143Snate@binkert.org        if source.swig:
11216143Snate@binkert.org            env = swig_env
11228945Ssteve.reinhardt@amd.com        elif source.Werror:
11238945Ssteve.reinhardt@amd.com            env = werror_env
11246143Snate@binkert.org        else:
11256143Snate@binkert.org            env = new_env
11266143Snate@binkert.org
11276143Snate@binkert.org        if static:
11286143Snate@binkert.org            obj = env.StaticObject(source.tnode)
11296143Snate@binkert.org        else:
11306143Snate@binkert.org            obj = env.SharedObject(source.tnode)
11316143Snate@binkert.org
11326143Snate@binkert.org        if extra_deps:
11336143Snate@binkert.org            env.Depends(obj, extra_deps)
11346143Snate@binkert.org
11356143Snate@binkert.org        return obj
11366143Snate@binkert.org
113710453SAndrew.Bardsley@arm.com    lib_guards = {'main': False, 'skip_lib': False}
113810453SAndrew.Bardsley@arm.com
113910453SAndrew.Bardsley@arm.com    # Without Python, leave out all SWIG and Python content from the
114010453SAndrew.Bardsley@arm.com    # library builds.  The option doesn't affect gem5 built as a program
114110453SAndrew.Bardsley@arm.com    if GetOption('without_python'):
114210453SAndrew.Bardsley@arm.com        lib_guards['skip_no_python'] = False
114310453SAndrew.Bardsley@arm.com
114410453SAndrew.Bardsley@arm.com    static_objs = [ make_obj(s, True) for s in Source.get(**lib_guards) ]
114510453SAndrew.Bardsley@arm.com    shared_objs = [ make_obj(s, False) for s in Source.get(**lib_guards) ]
11466143Snate@binkert.org
11476143Snate@binkert.org    static_date = make_obj(date_source, static=True, extra_deps=static_objs)
11486143Snate@binkert.org    static_objs.append(static_date)
114910453SAndrew.Bardsley@arm.com
11506143Snate@binkert.org    shared_date = make_obj(date_source, static=False, extra_deps=shared_objs)
11516240Snate@binkert.org    shared_objs.append(shared_date)
11525554Snate@binkert.org
11535522Snate@binkert.org    # First make a library of everything but main() so other programs can
11545522Snate@binkert.org    # link against m5.
11555797Snate@binkert.org    static_lib = new_env.StaticLibrary(libname, static_objs)
11565797Snate@binkert.org    shared_lib = new_env.SharedLibrary(libname, shared_objs)
11575522Snate@binkert.org
11585601Snate@binkert.org    # Now link a stub with main() and the static library.
11598233Snate@binkert.org    main_objs = [ make_obj(s, True) for s in Source.get(main=True) ]
11608233Snate@binkert.org
11618235Snate@binkert.org    for test in UnitTest.all:
11628235Snate@binkert.org        flags = { test.target : True }
11638235Snate@binkert.org        test_sources = Source.get(**flags)
11648235Snate@binkert.org        test_objs = [ make_obj(s, static=True) for s in test_sources ]
11659003SAli.Saidi@ARM.com        if test.main:
11669003SAli.Saidi@ARM.com            test_objs += main_objs
116710196SCurtis.Dunham@arm.com        path = variant('unittest/%s.%s' % (test.target, label))
116810196SCurtis.Dunham@arm.com        new_env.Program(path, test_objs + static_objs)
11698235Snate@binkert.org
11706143Snate@binkert.org    progname = exename
11712655Sstever@eecs.umich.edu    if strip:
11726143Snate@binkert.org        progname += '.unstripped'
11736143Snate@binkert.org
11748233Snate@binkert.org    targets = new_env.Program(progname, main_objs + static_objs)
11756143Snate@binkert.org
11766143Snate@binkert.org    if strip:
11774007Ssaidi@eecs.umich.edu        if sys.platform == 'sunos5':
11784596Sbinkertn@umich.edu            cmd = 'cp $SOURCE $TARGET; strip $TARGET'
11794007Ssaidi@eecs.umich.edu        else:
11804596Sbinkertn@umich.edu            cmd = 'strip $SOURCE -o $TARGET'
11817756SAli.Saidi@ARM.com        targets = new_env.Command(exename, progname,
11827816Ssteve.reinhardt@amd.com                    MakeAction(cmd, Transform("STRIP")))
11838334Snate@binkert.org
11848334Snate@binkert.org    new_env.Command(secondary_exename, exename,
11858334Snate@binkert.org            MakeAction('ln $SOURCE $TARGET', Transform("HARDLINK")))
11868334Snate@binkert.org
11875601Snate@binkert.org    new_env.M5Binary = targets[0]
118810196SCurtis.Dunham@arm.com    return new_env
11892655Sstever@eecs.umich.edu
11909225Sandreas.hansson@arm.com# Start out with the compiler flags common to all compilers,
11919225Sandreas.hansson@arm.com# i.e. they all use -g for opt and -g -pg for prof
11929226Sandreas.hansson@arm.comccflags = {'debug' : [], 'opt' : ['-g'], 'fast' : [], 'prof' : ['-g', '-pg'],
11939226Sandreas.hansson@arm.com           'perf' : ['-g']}
11949225Sandreas.hansson@arm.com
11959226Sandreas.hansson@arm.com# Start out with the linker flags common to all linkers, i.e. -pg for
11969226Sandreas.hansson@arm.com# prof, and -lprofiler for perf. The -lprofile flag is surrounded by
11979226Sandreas.hansson@arm.com# no-as-needed and as-needed as the binutils linker is too clever and
11989226Sandreas.hansson@arm.com# simply doesn't link to the library otherwise.
11999226Sandreas.hansson@arm.comldflags = {'debug' : [], 'opt' : [], 'fast' : [], 'prof' : ['-pg'],
12009226Sandreas.hansson@arm.com           'perf' : ['-Wl,--no-as-needed', '-lprofiler', '-Wl,--as-needed']}
12019225Sandreas.hansson@arm.com
12029227Sandreas.hansson@arm.com# For Link Time Optimization, the optimisation flags used to compile
12039227Sandreas.hansson@arm.com# individual files are decoupled from those used at link time
12049227Sandreas.hansson@arm.com# (i.e. you can compile with -O3 and perform LTO with -O0), so we need
12059227Sandreas.hansson@arm.com# to also update the linker flags based on the target.
12068946Sandreas.hansson@arm.comif env['GCC']:
12073918Ssaidi@eecs.umich.edu    if sys.platform == 'sunos5':
12089225Sandreas.hansson@arm.com        ccflags['debug'] += ['-gstabs+']
12093918Ssaidi@eecs.umich.edu    else:
12109225Sandreas.hansson@arm.com        ccflags['debug'] += ['-ggdb3']
12119225Sandreas.hansson@arm.com    ldflags['debug'] += ['-O0']
12129227Sandreas.hansson@arm.com    # opt, fast, prof and perf all share the same cc flags, also add
12139227Sandreas.hansson@arm.com    # the optimization to the ldflags as LTO defers the optimization
12149227Sandreas.hansson@arm.com    # to link time
12159226Sandreas.hansson@arm.com    for target in ['opt', 'fast', 'prof', 'perf']:
12169225Sandreas.hansson@arm.com        ccflags[target] += ['-O3']
12179227Sandreas.hansson@arm.com        ldflags[target] += ['-O3']
12189227Sandreas.hansson@arm.com
12199227Sandreas.hansson@arm.com    ccflags['fast'] += env['LTO_CCFLAGS']
12209227Sandreas.hansson@arm.com    ldflags['fast'] += env['LTO_LDFLAGS']
12218946Sandreas.hansson@arm.comelif env['CLANG']:
12229225Sandreas.hansson@arm.com    ccflags['debug'] += ['-g', '-O0']
12239226Sandreas.hansson@arm.com    # opt, fast, prof and perf all share the same cc flags
12249226Sandreas.hansson@arm.com    for target in ['opt', 'fast', 'prof', 'perf']:
12259226Sandreas.hansson@arm.com        ccflags[target] += ['-O3']
12263515Ssaidi@eecs.umich.eduelse:
12273918Ssaidi@eecs.umich.edu    print 'Unknown compiler, please fix compiler options'
12284762Snate@binkert.org    Exit(1)
12293515Ssaidi@eecs.umich.edu
12308881Smarc.orr@gmail.com
12318881Smarc.orr@gmail.com# To speed things up, we only instantiate the build environments we
12328881Smarc.orr@gmail.com# need.  We try to identify the needed environment for each target; if
12338881Smarc.orr@gmail.com# we can't, we fall back on instantiating all the environments just to
12348881Smarc.orr@gmail.com# be safe.
12359226Sandreas.hansson@arm.comtarget_types = ['debug', 'opt', 'fast', 'prof', 'perf']
12369226Sandreas.hansson@arm.comobj2target = {'do': 'debug', 'o': 'opt', 'fo': 'fast', 'po': 'prof',
12379226Sandreas.hansson@arm.com              'gpo' : 'perf'}
12388881Smarc.orr@gmail.com
12398881Smarc.orr@gmail.comdef identifyTarget(t):
12408881Smarc.orr@gmail.com    ext = t.split('.')[-1]
12418881Smarc.orr@gmail.com    if ext in target_types:
12428881Smarc.orr@gmail.com        return ext
12438881Smarc.orr@gmail.com    if obj2target.has_key(ext):
12448881Smarc.orr@gmail.com        return obj2target[ext]
12458881Smarc.orr@gmail.com    match = re.search(r'/tests/([^/]+)/', t)
12468881Smarc.orr@gmail.com    if match and match.group(1) in target_types:
12478881Smarc.orr@gmail.com        return match.group(1)
12488881Smarc.orr@gmail.com    return 'all'
12498881Smarc.orr@gmail.com
12508881Smarc.orr@gmail.comneeded_envs = [identifyTarget(target) for target in BUILD_TARGETS]
12518881Smarc.orr@gmail.comif 'all' in needed_envs:
12528881Smarc.orr@gmail.com    needed_envs += target_types
12538881Smarc.orr@gmail.com
125410196SCurtis.Dunham@arm.comgem5_root = Dir('.').up().up().abspath
125510196SCurtis.Dunham@arm.comdef makeEnvirons(target, source, env):
125610196SCurtis.Dunham@arm.com    # cause any later Source() calls to be fatal, as a diagnostic.
125710196SCurtis.Dunham@arm.com    Source.done()
1258955SN/A
125910196SCurtis.Dunham@arm.com    envList = []
1260955SN/A
126110196SCurtis.Dunham@arm.com    # Debug binary
126210196SCurtis.Dunham@arm.com    if 'debug' in needed_envs:
126310196SCurtis.Dunham@arm.com        envList.append(
126410196SCurtis.Dunham@arm.com            makeEnv(env, 'debug', '.do',
126510196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['debug']),
126610196SCurtis.Dunham@arm.com                    CPPDEFINES = ['DEBUG', 'TRACING_ON=1'],
126710196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['debug'])))
1268955SN/A
126910196SCurtis.Dunham@arm.com    # Optimized binary
127010196SCurtis.Dunham@arm.com    if 'opt' in needed_envs:
127110196SCurtis.Dunham@arm.com        envList.append(
127210196SCurtis.Dunham@arm.com            makeEnv(env, 'opt', '.o',
127310196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['opt']),
127410196SCurtis.Dunham@arm.com                    CPPDEFINES = ['TRACING_ON=1'],
127510196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['opt'])))
12761869SN/A
127710196SCurtis.Dunham@arm.com    # "Fast" binary
127810196SCurtis.Dunham@arm.com    if 'fast' in needed_envs:
127910196SCurtis.Dunham@arm.com        envList.append(
128010196SCurtis.Dunham@arm.com            makeEnv(env, 'fast', '.fo', strip = True,
128110196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['fast']),
128210196SCurtis.Dunham@arm.com                    CPPDEFINES = ['NDEBUG', 'TRACING_ON=0'],
128310196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['fast'])))
12849226Sandreas.hansson@arm.com
128510196SCurtis.Dunham@arm.com    # Profiled binary using gprof
128610196SCurtis.Dunham@arm.com    if 'prof' in needed_envs:
128710196SCurtis.Dunham@arm.com        envList.append(
128810196SCurtis.Dunham@arm.com            makeEnv(env, 'prof', '.po',
128910196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['prof']),
129010196SCurtis.Dunham@arm.com                    CPPDEFINES = ['NDEBUG', 'TRACING_ON=0'],
129110196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['prof'])))
129210196SCurtis.Dunham@arm.com
129310196SCurtis.Dunham@arm.com    # Profiled binary using google-pprof
129410196SCurtis.Dunham@arm.com    if 'perf' in needed_envs:
129510196SCurtis.Dunham@arm.com        envList.append(
129610196SCurtis.Dunham@arm.com            makeEnv(env, 'perf', '.gpo',
129710196SCurtis.Dunham@arm.com                    CCFLAGS = Split(ccflags['perf']),
129810196SCurtis.Dunham@arm.com                    CPPDEFINES = ['NDEBUG', 'TRACING_ON=0'],
129910196SCurtis.Dunham@arm.com                    LINKFLAGS = Split(ldflags['perf'])))
130010196SCurtis.Dunham@arm.com
130110196SCurtis.Dunham@arm.com    # Set up the regression tests for each build.
130210196SCurtis.Dunham@arm.com    for e in envList:
130310196SCurtis.Dunham@arm.com        SConscript(os.path.join(gem5_root, 'tests', 'SConscript'),
130410196SCurtis.Dunham@arm.com                   variant_dir = variantd('tests', e.Label),
130510196SCurtis.Dunham@arm.com                   exports = { 'env' : e }, duplicate = False)
130610196SCurtis.Dunham@arm.com
130710196SCurtis.Dunham@arm.com# The MakeEnvirons Builder defers the full dependency collection until
130810196SCurtis.Dunham@arm.com# after processing the ISA definition (due to dynamically generated
130910196SCurtis.Dunham@arm.com# source files).  Add this dependency to all targets so they will wait
131010196SCurtis.Dunham@arm.com# until the environments are completely set up.  Otherwise, a second
131110196SCurtis.Dunham@arm.com# process (e.g. -j2 or higher) will try to compile the requested target,
131210196SCurtis.Dunham@arm.com# not know how, and fail.
131310196SCurtis.Dunham@arm.comenv.Append(BUILDERS = {'MakeEnvirons' :
131410196SCurtis.Dunham@arm.com                        Builder(action=MakeAction(makeEnvirons,
131510196SCurtis.Dunham@arm.com                                                  Transform("ENVIRONS", 1)))})
131610196SCurtis.Dunham@arm.com
131710196SCurtis.Dunham@arm.comisa_target = env['PHONY_BASE'] + '-deps'
131810196SCurtis.Dunham@arm.comenvirons   = env['PHONY_BASE'] + '-environs'
131910196SCurtis.Dunham@arm.comenv.Depends('#all-deps',     isa_target)
132010196SCurtis.Dunham@arm.comenv.Depends('#all-environs', environs)
132110196SCurtis.Dunham@arm.comenv.ScanISA(isa_target, File('arch/%s/generated/inc.d' % env['TARGET_ISA']))
132210196SCurtis.Dunham@arm.comenvSetup = env.MakeEnvirons(environs, isa_target)
132310196SCurtis.Dunham@arm.com
132410196SCurtis.Dunham@arm.com# make sure no -deps targets occur before all ISAs are complete
132510196SCurtis.Dunham@arm.comenv.Depends(isa_target, '#all-isas')
132610196SCurtis.Dunham@arm.com# likewise for -environs targets and all the -deps targets
132710196SCurtis.Dunham@arm.comenv.Depends(environs, '#all-deps')
1328