SConscript

   1 # -*- mode:python -*-
   2
   3 # Copyright (c) 2004-2005 The Regents of The University of Michigan
   4 # All rights reserved.
   5 #
   6 # Redistribution and use in source and binary forms, with or without
   7 # modification, are permitted provided that the following conditions are
   8 # met: redistributions of source code must retain the above copyright
   9 # notice, this list of conditions and the following disclaimer;
  10 # redistributions in binary form must reproduce the above copyright
  11 # notice, this list of conditions and the following disclaimer in the
  12 # documentation and/or other materials provided with the distribution;
  13 # neither the name of the copyright holders nor the names of its
  14 # contributors may be used to endorse or promote products derived from
  15 # this software without specific prior written permission.
  16 #
  17 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  18 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  19 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  20 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  21 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  22 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  23 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  24 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  25 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  27 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28
  29 import os
  30 import sys
  31 from os.path import isdir
  32
  33 # This file defines how to build a particular configuration of M5
  34 # based on variable settings in the 'env' build environment.
  35
  36 # Import build environment variable from SConstruct.
  37 Import('env')
  38
  39 ###################################################
  40 #
  41 # Define needed sources.
  42 #
  43 ###################################################
  44
  45 # Base sources used by all configurations.
  46
  47 base_sources = Split('''
  48         base/circlebuf.cc
  49         base/copyright.cc
  50         base/cprintf.cc
  51         base/embedfile.cc
  52         base/fast_alloc.cc
  53         base/fifo_buffer.cc
  54         base/hostinfo.cc
  55         base/hybrid_pred.cc
  56         base/inifile.cc
  57         base/intmath.cc
  58         base/match.cc
  59         base/misc.cc
  60         base/output.cc
  61         base/pollevent.cc
  62         base/range.cc
  63         base/random.cc
  64         base/sat_counter.cc
  65         base/socket.cc
  66         base/statistics.cc
  67         base/str.cc
  68         base/time.cc
  69         base/trace.cc
  70         base/traceflags.cc
  71         base/userinfo.cc
  72         base/compression/lzss_compression.cc
  73         base/loader/aout_object.cc
  74         base/loader/ecoff_object.cc
  75         base/loader/elf_object.cc
  76         base/loader/object_file.cc
  77         base/loader/symtab.cc
  78         base/stats/events.cc
  79         base/stats/statdb.cc
  80         base/stats/visit.cc
  81         base/stats/text.cc
  82
  83         cpu/base.cc
  84         cpu/base_dyn_inst.cc
  85         cpu/exec_context.cc
  86         cpu/exetrace.cc
  87         cpu/pc_event.cc
  88         cpu/static_inst.cc
  89         cpu/o3/2bit_local_pred.cc
  90         cpu/o3/alpha_dyn_inst.cc
  91         cpu/o3/alpha_cpu.cc
  92         cpu/o3/alpha_cpu_builder.cc
  93         cpu/o3/bpred_unit.cc
  94         cpu/o3/btb.cc
  95         cpu/o3/commit.cc
  96         cpu/o3/decode.cc
  97         cpu/o3/fetch.cc
  98         cpu/o3/free_list.cc
  99         cpu/o3/cpu.cc
 100         cpu/o3/iew.cc
 101         cpu/o3/inst_queue.cc
 102         cpu/o3/ldstq.cc
 103         cpu/o3/mem_dep_unit.cc
 104         cpu/o3/ras.cc
 105         cpu/o3/rename.cc
 106         cpu/o3/rename_map.cc
 107         cpu/o3/rob.cc
 108         cpu/o3/sat_counter.cc
 109         cpu/o3/store_set.cc
 110         cpu/o3/tournament_pred.cc
 111         cpu/fast/cpu.cc
 112         cpu/sampler/sampler.cc
 113         cpu/simple/cpu.cc
 114         cpu/trace/reader/mem_trace_reader.cc
 115         cpu/trace/reader/ibm_reader.cc
 116         cpu/trace/reader/itx_reader.cc
 117         cpu/trace/reader/m5_reader.cc
 118         cpu/trace/opt_cpu.cc
 119         cpu/trace/trace_cpu.cc
 120
 121         encumbered/cpu/full/bpred.cc
 122         encumbered/cpu/full/commit.cc
 123         encumbered/cpu/full/cpu.cc
 124         encumbered/cpu/full/create_vector.cc
 125         encumbered/cpu/full/cv_spec_state.cc
 126         encumbered/cpu/full/dd_queue.cc
 127         encumbered/cpu/full/dep_link.cc
 128         encumbered/cpu/full/dispatch.cc
 129         encumbered/cpu/full/dyn_inst.cc
 130         encumbered/cpu/full/execute.cc
 131         encumbered/cpu/full/fetch.cc
 132         encumbered/cpu/full/floss_reasons.cc
 133         encumbered/cpu/full/fu_pool.cc
 134         encumbered/cpu/full/inst_fifo.cc
 135         encumbered/cpu/full/instpipe.cc
 136         encumbered/cpu/full/issue.cc
 137         encumbered/cpu/full/ls_queue.cc
 138         encumbered/cpu/full/machine_queue.cc
 139         encumbered/cpu/full/pipetrace.cc
 140         encumbered/cpu/full/readyq.cc
 141         encumbered/cpu/full/reg_info.cc
 142         encumbered/cpu/full/rob_station.cc
 143         encumbered/cpu/full/spec_memory.cc
 144         encumbered/cpu/full/spec_state.cc
 145         encumbered/cpu/full/storebuffer.cc
 146         encumbered/cpu/full/writeback.cc
 147         encumbered/cpu/full/iq/iq_station.cc
 148         encumbered/cpu/full/iq/iqueue.cc
 149         encumbered/cpu/full/iq/segmented/chain_info.cc
 150         encumbered/cpu/full/iq/segmented/chain_wire.cc
 151         encumbered/cpu/full/iq/segmented/iq_seg.cc
 152         encumbered/cpu/full/iq/segmented/iq_segmented.cc
 153         encumbered/cpu/full/iq/segmented/seg_chain.cc
 154         encumbered/cpu/full/iq/seznec/iq_seznec.cc
 155         encumbered/cpu/full/iq/standard/iq_standard.cc
 156         encumbered/mem/functional/main.cc
 157
 158         mem/base_hier.cc
 159         mem/base_mem.cc
 160         mem/hier_params.cc
 161         mem/mem_cmd.cc
 162         mem/mem_debug.cc
 163         mem/mem_req.cc
 164         mem/memory_interface.cc
 165         mem/bus/base_interface.cc
 166         mem/bus/bus.cc
 167         mem/bus/bus_bridge.cc
 168         mem/bus/bus_bridge_master.cc
 169         mem/bus/bus_bridge_slave.cc
 170         mem/bus/bus_interface.cc
 171         mem/bus/dma_bus_interface.cc
 172         mem/bus/dma_interface.cc
 173         mem/bus/master_interface.cc
 174         mem/bus/slave_interface.cc
 175         mem/cache/base_cache.cc
 176         mem/cache/cache.cc
 177         mem/cache/cache_builder.cc
 178         mem/cache/coherence/coherence_protocol.cc
 179         mem/cache/coherence/uni_coherence.cc
 180         mem/cache/miss/blocking_buffer.cc
 181         mem/cache/miss/miss_queue.cc
 182         mem/cache/miss/mshr.cc
 183         mem/cache/miss/mshr_queue.cc
 184         mem/cache/prefetch/base_prefetcher.cc
 185         mem/cache/prefetch/prefetcher.cc
 186         mem/cache/prefetch/tagged_prefetcher.cc
 187         mem/cache/tags/base_tags.cc
 188         mem/cache/tags/cache_tags.cc
 189         mem/cache/tags/fa_lru.cc
 190         mem/cache/tags/iic.cc
 191         mem/cache/tags/lru.cc
 192         mem/cache/tags/repl/gen.cc
 193         mem/cache/tags/repl/repl.cc
 194         mem/cache/tags/split.cc
 195         mem/cache/tags/split_lru.cc
 196         mem/cache/tags/split_lifo.cc
 197         mem/functional/functional.cc
 198         mem/timing/base_memory.cc
 199         mem/timing/memory_builder.cc
 200         mem/timing/simple_mem_bank.cc
 201         mem/trace/itx_writer.cc
 202         mem/trace/mem_trace_writer.cc
 203         mem/trace/m5_writer.cc
 204
 205         python/pyconfig.cc
 206         python/embedded_py.cc
 207
 208         sim/builder.cc
 209         sim/configfile.cc
 210         sim/debug.cc
 211         sim/eventq.cc
 212         sim/faults.cc
 213         sim/main.cc
 214         sim/param.cc
 215         sim/profile.cc
 216         sim/root.cc
 217         sim/serialize.cc
 218         sim/sim_events.cc
 219         sim/sim_exit.cc
 220         sim/sim_object.cc
 221         sim/startup.cc
 222         sim/stat_context.cc
 223         sim/stat_control.cc
 224         sim/trace_context.cc
 225         ''')
 226 # These are now included by the architecture specific SConscript
 227 #       arch/alpha/decoder.cc
 228 #       arch/alpha/alpha_o3_exec.cc
 229 #       arch/alpha/fast_cpu_exec.cc
 230 #       arch/alpha/simple_cpu_exec.cc
 231 #       arch/alpha/full_cpu_exec.cc
 232 #       arch/alpha/faults.cc
 233 #       arch/alpha/isa_traits.cc
 234
 235 # MySql sources
 236 mysql_sources = Split('''
 237         base/mysql.cc
 238         base/stats/mysql.cc
 239         ''')
 240
 241 # Full-system sources
 242 full_system_sources = Split('''
 243         base/crc.cc
 244         base/inet.cc
 245         base/remote_gdb.cc
 246
 247         cpu/intr_control.cc
 248         cpu/profile.cc
 249
 250         dev/alpha_console.cc
 251         dev/baddev.cc
 252         dev/simconsole.cc
 253         dev/disk_image.cc
 254         dev/etherbus.cc
 255         dev/etherdump.cc
 256         dev/etherint.cc
 257         dev/etherlink.cc
 258         dev/etherpkt.cc
 259         dev/ethertap.cc
 260         dev/ide_ctrl.cc
 261         dev/ide_disk.cc
 262         dev/io_device.cc
 263         dev/ns_gige.cc
 264         dev/pciconfigall.cc
 265         dev/pcidev.cc
 266         dev/pcifake.cc
 267         dev/pktfifo.cc
 268         dev/platform.cc
 269         dev/sinic.cc
 270         dev/simple_disk.cc
 271         dev/tsunami.cc
 272         dev/tsunami_cchip.cc
 273         dev/isa_fake.cc
 274         dev/tsunami_io.cc
 275         dev/tsunami_pchip.cc
 276         dev/uart.cc
 277         dev/uart8250.cc
 278
 279         kern/kernel_binning.cc
 280         kern/kernel_stats.cc
 281         kern/system_events.cc
 282         kern/freebsd/freebsd_system.cc
 283         kern/linux/linux_syscalls.cc
 284         kern/linux/linux_system.cc
 285         kern/linux/printk.cc
 286         kern/tru64/dump_mbuf.cc
 287         kern/tru64/printf.cc
 288         kern/tru64/tru64_events.cc
 289         kern/tru64/tru64_syscalls.cc
 290         kern/tru64/tru64_system.cc
 291
 292         mem/functional/memory_control.cc
 293         mem/functional/physical.cc
 294
 295         sim/system.cc
 296         sim/pseudo_inst.cc
 297         ''')
 298
 299 # These are now included by the architecture specific SConscript
 300 #       arch/alpha/alpha_memory.cc
 301 #       arch/alpha/arguments.cc
 302 #       arch/alpha/ev5.cc
 303 #       arch/alpha/osfpal.cc
 304 #       arch/alpha/pseudo_inst.cc
 305 #       arch/alpha/stacktrace.cc
 306 #       arch/alpha/vtophys.cc
 307
 308 # turbolaser encumbered sources
 309 turbolaser_sources = Split('''
 310         encumbered/dev/dma.cc
 311         encumbered/dev/etherdev.cc
 312         encumbered/dev/scsi.cc
 313         encumbered/dev/scsi_ctrl.cc
 314         encumbered/dev/scsi_disk.cc
 315         encumbered/dev/scsi_none.cc
 316         encumbered/dev/tlaser_clock.cc
 317         encumbered/dev/tlaser_ipi.cc
 318         encumbered/dev/tlaser_mbox.cc
 319         encumbered/dev/tlaser_mc146818.cc
 320         encumbered/dev/tlaser_node.cc
 321         encumbered/dev/tlaser_pcia.cc
 322         encumbered/dev/tlaser_pcidev.cc
 323         encumbered/dev/tlaser_serial.cc
 324         encumbered/dev/turbolaser.cc
 325         encumbered/dev/uart8530.cc
 326         ''')
 327
 328 # Syscall emulation (non-full-system) sources
 329 syscall_emulation_sources = Split('''
 330         cpu/memtest/memtest.cc
 331         encumbered/eio/eio.cc
 332         encumbered/eio/exolex.cc
 333         encumbered/eio/libexo.cc
 334         kern/linux/linux.cc
 335         kern/tru64/tru64.cc
 336         sim/process.cc
 337         sim/syscall_emul.cc
 338         ''')
 339
 340 # These are now included by the architecture specific SConscript
 341 #       arch/alpha/alpha_common_syscall_emul.cc
 342 #       arch/alpha/alpha_linux_process.cc
 343 #       arch/alpha/alpha_tru64_process.cc
 344
 345 targetarch_files = Split('''
 346         alpha_linux_process.hh
 347         alpha_memory.hh
 348         alpha_tru64_process.hh
 349         aout_machdep.h
 350         arguments.hh
 351         ecoff_machdep.h
 352         ev5.hh
 353         faults.hh
 354         stacktrace.hh
 355         vtophys.hh
 356         ''')
 357 #        pseudo_inst.hh
 358 #        isa_traits.hh
 359 #        osfpal.hh
 360 #        byte_swap.hh
 361 #        alpha_common_syscall_emul.hh
 362 #        vptr.hh
 363 #        isa_fullsys_traits.hh
 364
 365 # Set up bridging headers to the architecture specific versions
 366 for f in targetarch_files:
 367     env.Command('targetarch/' + f, 'arch/%s/%s' % (env['TARGET_ISA'], f),
 368                 '''echo '#include "arch/%s/%s"' > $TARGET''' % (env['TARGET_ISA'], f))
 369
 370 # Let the target architecture define what sources it needs
 371 arch_source = SConscript('arch/%s/SConscript' % env['TARGET_ISA'],
 372         build_dir = 'build/%s/' % env['BUILD_DIR'],
 373         exports = 'env', duplicate = False)
 374
 375 # Add a flag defining what THE_ISA should be for all compilation
 376 env.Append(CPPDEFINES=[('THE_ISA','%s_ISA' % env['TARGET_ISA'].upper())])
 377
 378 # Set up complete list of sources based on configuration.
 379 sources = base_sources + arch_source
 380
 381 if env['FULL_SYSTEM']:
 382     sources += full_system_sources
 383     if env['ALPHA_TLASER']:
 384         sources += turbolaser_sources
 385 else:
 386     sources += syscall_emulation_sources
 387
 388 if env['USE_MYSQL']:
 389     sources += mysql_sources
 390
 391 for opt in env.ExportOptions:
 392     env.ConfigFile(opt)
 393
 394 ###################################################
 395 #
 396 # Add an SCons scanner for ISA files
 397 #
 398 ###################################################
 399 import SCons.Scanner
 400
 401 def ISAScan():
 402    return SCons.Scanner.Classic("ISAScan",
 403                                 "$ISASUFFIXES",
 404                                 "SRCDIR",
 405                                 '^[ \t]*##[ \t]*include[ \t]*"([^>"]+)"')
 406
 407 def ISAPath(env, dir, target=None, source=None, a=None):
 408    return (Dir(env['SRCDIR']), Dir('.'))
 409
 410 iscan = Scanner(function = ISAScan().scan, skeys = [".isa", ".ISA"],
 411                 path_function = ISAPath)
 412 env.Append(SCANNERS = iscan)
 413
 414
 415 ###################################################
 416 #
 417 # Special build rules.
 418 #
 419 ###################################################
 420
 421 # base/traceflags.{cc,hh} are generated from base/traceflags.py.
 422 # $TARGET.base will expand to "<build-dir>/base/traceflags".
 423 env.Command(Split('base/traceflags.hh base/traceflags.cc'),
 424             'base/traceflags.py',
 425             'python $SOURCE $TARGET.base')
 426
 427 # several files are generated from arch/$TARGET_ISA/isa_desc.
 428 env.Command(Split('''
 429         arch/%s/decoder.cc
 430         arch/%s/decoder.hh
 431         arch/%s/alpha_o3_exec.cc
 432         arch/%s/fast_cpu_exec.cc
 433         arch/%s/simple_cpu_exec.cc
 434         arch/%s/full_cpu_exec.cc''' %
 435         (env['TARGET_ISA'],
 436         env['TARGET_ISA'],
 437         env['TARGET_ISA'],
 438         env['TARGET_ISA'],
 439         env['TARGET_ISA'],
 440         env['TARGET_ISA'])),
 441         Split('''
 442         arch/%s/isa/main.isa
 443         arch/isa_parser.py''' %
 444         env['TARGET_ISA']),
 445         '$SRCDIR/arch/isa_parser.py $SOURCE $TARGET.dir arch/%s' % env['TARGET_ISA'])
 446
 447
 448 # libelf build is described in its own SConscript file.
 449 # SConscript-local is the per-config build, which just copies some
 450 # header files into a place where they can be found.
 451 SConscript('libelf/SConscript-local', exports = 'env', duplicate=0)
 452 SConscript('python/SConscript', exports = ['env'], duplicate=0)
 453
 454 # This function adds the specified sources to the given build
 455 # environment, and returns a list of all the corresponding SCons
 456 # Object nodes (including an extra one for date.cc).  We explicitly
 457 # add the Object nodes so we can set up special dependencies for
 458 # date.cc.
 459 def make_objs(sources, env):
 460     objs = [env.Object(s) for s in sources]
 461     # make date.cc depend on all other objects so it always gets
 462     # recompiled whenever anything else does
 463     date_obj = env.Object('base/date.cc')
 464     env.Depends(date_obj, objs)
 465     objs.append(date_obj)
 466     return objs
 467
 468 ###################################################
 469 #
 470 # Define binaries.  Each different build type (debug, opt, etc.) gets
 471 # a slightly different build environment.
 472 #
 473 ###################################################
 474
 475 # Include file paths are rooted in this directory.  SCons will
 476 # automatically expand '.' to refer to both the source directory and
 477 # the corresponding build directory to pick up generated include
 478 # files.
 479 env.Append(CPPPATH='.')
 480
 481 # Debug binary
 482 debugEnv = env.Copy(OBJSUFFIX='.do')
 483 debugEnv.Label = 'debug'
 484 debugEnv.Append(CCFLAGS=Split('-g -gstabs+ -O0'))
 485 debugEnv.Append(CPPDEFINES='DEBUG')
 486 tlist = debugEnv.Program(target = 'm5.debug',
 487                          source = make_objs(sources, debugEnv))
 488 debugEnv.M5Binary = tlist[0]
 489
 490 # Optimized binary
 491 optEnv = env.Copy()
 492 optEnv.Label = 'opt'
 493 optEnv.Append(CCFLAGS=Split('-g -O5'))
 494 tlist = optEnv.Program(target = 'm5.opt',
 495                        source = make_objs(sources, optEnv))
 496 optEnv.M5Binary = tlist[0]
 497
 498 # "Fast" binary
 499 fastEnv = env.Copy(OBJSUFFIX='.fo')
 500 fastEnv.Label = 'fast'
 501 fastEnv.Append(CCFLAGS=Split('-O5'))
 502 fastEnv.Append(CPPDEFINES='NDEBUG')
 503 fastEnv.Program(target = 'm5.fast.unstripped',
 504                 source = make_objs(sources, fastEnv))
 505 tlist = fastEnv.Command(target = 'm5.fast',
 506                         source = 'm5.fast.unstripped',
 507                         action = 'strip $SOURCE -o $TARGET')
 508 fastEnv.M5Binary = tlist[0]
 509
 510 # Profiled binary
 511 profEnv = env.Copy(OBJSUFFIX='.po')
 512 profEnv.Label = 'prof'
 513 profEnv.Append(CCFLAGS=Split('-O5 -g -pg'), LINKFLAGS='-pg')
 514 tlist = profEnv.Program(target = 'm5.prof',
 515                         source = make_objs(sources, profEnv))
 516 profEnv.M5Binary = tlist[0]
 517
 518 envList = [debugEnv, optEnv, fastEnv, profEnv]
 519
 520 Return('envList')