3 # Copyright (c) 2013, 2015-2020 ARM Limited
6 # The license below extends only to copyright in the software and shall
7 # not be construed as granting a license to any other intellectual
8 # property including but not limited to intellectual property relating
9 # to a hardware implementation of the functionality of the software
10 # licensed hereunder. You may use the software subject to the license
11 # terms below provided that you ensure that this notice is replicated
12 # unmodified and in its entirety in all distributions of the software,
13 # modified or unmodified, in source code or in binary form.
15 # Copyright (c) 2011 Advanced Micro Devices, Inc.
16 # Copyright (c) 2009 The Hewlett-Packard Development Company
17 # Copyright (c) 2004-2005 The Regents of The University of Michigan
18 # All rights reserved.
20 # Redistribution and use in source and binary forms, with or without
21 # modification, are permitted provided that the following conditions are
22 # met: redistributions of source code must retain the above copyright
23 # notice, this list of conditions and the following disclaimer;
24 # redistributions in binary form must reproduce the above copyright
25 # notice, this list of conditions and the following disclaimer in the
26 # documentation and/or other materials provided with the distribution;
27 # neither the name of the copyright holders nor the names of its
28 # contributors may be used to endorse or promote products derived from
29 # this software without specific prior written permission.
31 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
34 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
36 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
37 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
38 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
39 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
40 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
41 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
43 ###################################################
45 # SCons top-level build description (SConstruct) file.
47 # While in this directory ('gem5'), just type 'scons' to build the default
48 # configuration (see below), or type 'scons build/<CONFIG>/<binary>'
49 # to build some other configuration (e.g., 'build/X86/gem5.opt' for
50 # the optimized full-system version).
52 # You can build gem5 in a different directory as long as there is a
53 # 'build/<CONFIG>' somewhere along the target path. The build system
54 # expects that all configs under the same build directory are being
55 # built for the same host system.
59 # The following two commands are equivalent. The '-u' option tells
60 # scons to search up the directory tree for this SConstruct file.
61 # % cd <path-to-src>/gem5 ; scons build/X86/gem5.debug
62 # % cd <path-to-src>/gem5/build/X86; scons -u gem5.debug
64 # The following two commands are equivalent and demonstrate building
65 # in a directory outside of the source tree. The '-C' option tells
66 # scons to chdir to the specified directory to find this SConstruct
68 # % cd <path-to-src>/gem5 ; scons /local/foo/build/X86/gem5.debug
69 # % cd /local/foo/build/X86; scons -C <path-to-src>/gem5 gem5.debug
71 # You can use 'scons -H' to print scons options. If you're in this
72 # 'gem5' directory (or use -u or -C to tell scons where to find this
73 # file), you can use 'scons -h' to print all the gem5-specific build
76 ###################################################
78 # Global Python includes
87 from os
import mkdir
, environ
88 from os
.path
import abspath
, basename
, dirname
, expanduser
, normpath
89 from os
.path
import exists
, isdir
, isfile
90 from os
.path
import join
as joinpath
, split
as splitpath
98 from m5
.util
import compareVersions
, readCommand
, readCommandWithReturn
100 AddOption('--colors', dest
='use_colors', action
='store_true',
101 help="Add color to abbreviated scons output")
102 AddOption('--no-colors', dest
='use_colors', action
='store_false',
103 help="Don't add color to abbreviated scons output")
104 AddOption('--with-cxx-config', action
='store_true',
105 help="Build with support for C++-based configuration")
106 AddOption('--default',
107 help='Override which build_opts file to use for defaults')
108 AddOption('--ignore-style', action
='store_true',
109 help='Disable style checking hooks')
110 AddOption('--gold-linker', action
='store_true', help='Use the gold linker')
111 AddOption('--no-compress-debug', action
='store_true',
112 help="Don't compress debug info in build files")
113 AddOption('--no-lto', action
='store_true',
114 help='Disable Link-Time Optimization for fast')
115 AddOption('--verbose', action
='store_true',
116 help='Print full tool command lines')
117 AddOption('--without-python', action
='store_true',
118 help='Build without Python configuration support')
119 AddOption('--without-tcmalloc', action
='store_true',
120 help='Disable linking against tcmalloc')
121 AddOption('--with-ubsan', action
='store_true',
122 help='Build with Undefined Behavior Sanitizer if available')
123 AddOption('--with-asan', action
='store_true',
124 help='Build with Address Sanitizer if available')
125 AddOption('--with-systemc-tests', action
='store_true',
126 help='Build systemc tests')
128 from gem5_scons
import Transform
, error
, warning
, summarize_warnings
131 ########################################################################
133 # Set up the main build environment.
135 ########################################################################
137 main
= Environment(tools
=['default', 'git'])
139 from gem5_scons
.util
import get_termcap
140 termcap
= get_termcap()
142 main_dict_keys
= main
.Dictionary().keys()
144 # Check that we have a C/C++ compiler
145 if not ('CC' in main_dict_keys
and 'CXX' in main_dict_keys
):
146 error("No C++ compiler installed (package g++ on Ubuntu and RedHat)")
148 ###################################################
150 # Figure out which configurations to set up based on the path(s) of
153 ###################################################
155 # Find default configuration & binary.
156 Default(environ
.get('M5_DEFAULT_BINARY', 'build/ARM/gem5.debug'))
158 # helper function: find last occurrence of element in list
159 def rfind(l
, elt
, offs
= -1):
160 for i
in range(len(l
)+offs
, 0, -1):
163 raise ValueError("element not found")
165 # Take a list of paths (or SCons Nodes) and return a list with all
166 # paths made absolute and ~-expanded. Paths will be interpreted
167 # relative to the launch directory unless a different root is provided
168 def makePathListAbsolute(path_list
, root
=GetLaunchDir()):
169 return [abspath(joinpath(root
, expanduser(str(p
))))
172 # Each target must have 'build' in the interior of the path; the
173 # directory below this will determine the build parameters. For
174 # example, for target 'foo/bar/build/X86/arch/x86/blah.do' we
175 # recognize that X86 specifies the configuration because it
176 # follow 'build' in the build path.
178 # The funky assignment to "[:]" is needed to replace the list contents
179 # in place rather than reassign the symbol to a new list, which
180 # doesn't work (obviously!).
181 BUILD_TARGETS
[:] = makePathListAbsolute(BUILD_TARGETS
)
183 # Generate a list of the unique build roots and configs that the
184 # collected targets reference.
187 for t
in BUILD_TARGETS
:
188 path_dirs
= t
.split('/')
190 build_top
= rfind(path_dirs
, 'build', -2)
192 error("No non-leaf 'build' dir found on target path.", t
)
193 this_build_root
= joinpath('/',*path_dirs
[:build_top
+1])
195 build_root
= this_build_root
197 if this_build_root
!= build_root
:
198 error("build targets not under same build root\n"
199 " %s\n %s" % (build_root
, this_build_root
))
200 variant_path
= joinpath('/',*path_dirs
[:build_top
+2])
201 if variant_path
not in variant_paths
:
202 variant_paths
.append(variant_path
)
204 # Make sure build_root exists (might not if this is the first build there)
205 if not isdir(build_root
):
207 main
['BUILDROOT'] = build_root
211 main
.SConsignFile(joinpath(build_root
, "sconsign"))
213 # Default duplicate option is to use hard links, but this messes up
214 # when you use emacs to edit a file in the target dir, as emacs moves
215 # file to file~ then copies to file, breaking the link. Symbolic
216 # (soft) links work better.
217 main
.SetOption('duplicate', 'soft-copy')
220 # Set up global sticky variables... these are common to an entire build
221 # tree (not specific to a particular build like X86)
224 global_vars_file
= joinpath(build_root
, 'variables.global')
226 global_vars
= Variables(global_vars_file
, args
=ARGUMENTS
)
228 global_vars
.AddVariables(
229 ('CC', 'C compiler', environ
.get('CC', main
['CC'])),
230 ('CXX', 'C++ compiler', environ
.get('CXX', main
['CXX'])),
231 ('CCFLAGS_EXTRA', 'Extra C and C++ compiler flags', ''),
232 ('LDFLAGS_EXTRA', 'Extra linker flags', ''),
233 ('MARSHAL_CCFLAGS_EXTRA', 'Extra C and C++ marshal compiler flags', ''),
234 ('MARSHAL_LDFLAGS_EXTRA', 'Extra marshal linker flags', ''),
235 ('PYTHON_CONFIG', 'Python config binary to use',
236 [ 'python3-config', 'python-config']
238 ('PROTOC', 'protoc tool', environ
.get('PROTOC', 'protoc')),
239 ('BATCH', 'Use batch pool for build and tests', False),
240 ('BATCH_CMD', 'Batch pool submission command name', 'qdo'),
241 ('M5_BUILD_CACHE', 'Cache built objects in this directory', False),
242 ('EXTRAS', 'Add extra directories to the compilation', '')
245 # Update main environment with values from ARGUMENTS & global_vars_file
246 global_vars
.Update(main
)
248 Global build variables:
250 '''.format(help=global_vars
.GenerateHelpText(main
)), append
=True)
252 # Save sticky variable settings back to current variables file
253 global_vars
.Save(global_vars_file
, main
)
255 # Parse EXTRAS variable to build list of all directories where we're
256 # look for sources etc. This list is exported as extras_dir_list.
257 base_dir
= Dir('#src').abspath
259 extras_dir_list
= makePathListAbsolute(main
['EXTRAS'].split(':'))
264 Export('extras_dir_list')
266 # the ext directory should be on the #includes path
267 main
.Append(CPPPATH
=[Dir('ext')])
269 # Add shared top-level headers
270 main
.Prepend(CPPPATH
=Dir('include'))
272 if GetOption('verbose'):
273 def MakeAction(action
, string
, *args
, **kwargs
):
274 return Action(action
, *args
, **kwargs
)
277 main
['CCCOMSTR'] = Transform("CC")
278 main
['CXXCOMSTR'] = Transform("CXX")
279 main
['ASCOMSTR'] = Transform("AS")
280 main
['ARCOMSTR'] = Transform("AR", 0)
281 main
['LINKCOMSTR'] = Transform("LINK", 0)
282 main
['SHLINKCOMSTR'] = Transform("SHLINK", 0)
283 main
['RANLIBCOMSTR'] = Transform("RANLIB", 0)
284 main
['M4COMSTR'] = Transform("M4")
285 main
['SHCCCOMSTR'] = Transform("SHCC")
286 main
['SHCXXCOMSTR'] = Transform("SHCXX")
289 # Initialize the Link-Time Optimization (LTO) flags
290 main
['LTO_CCFLAGS'] = []
291 main
['LTO_LDFLAGS'] = []
293 # According to the readme, tcmalloc works best if the compiler doesn't
294 # assume that we're using the builtin malloc and friends. These flags
295 # are compiler-specific, so we need to set them after we detect which
296 # compiler we're using.
297 main
['TCMALLOC_CCFLAGS'] = []
299 # Platform-specific configuration. Note again that we assume that all
300 # builds under a given build root run on the same host platform.
301 conf
= gem5_scons
.Configure(main
)
303 CXX_version
= readCommand([main
['CXX'],'--version'], exception
=False)
304 CXX_V
= readCommand([main
['CXX'],'-V'], exception
=False)
306 main
['GCC'] = CXX_version
and CXX_version
.find('g++') >= 0
307 main
['CLANG'] = CXX_version
and CXX_version
.find('clang') >= 0
308 if main
['GCC'] + main
['CLANG'] > 1:
309 error('Two compilers enabled at once?')
311 # Set up default C++ compiler flags
312 if main
['GCC'] or main
['CLANG']:
313 # As gcc and clang share many flags, do the common parts here
314 main
.Append(CCFLAGS
=['-pipe'])
315 main
.Append(CCFLAGS
=['-fno-strict-aliasing'])
316 # Enable -Wall and -Wextra and then disable the few warnings that
317 # we consistently violate
318 main
.Append(CCFLAGS
=['-Wall', '-Wundef', '-Wextra',
319 '-Wno-sign-compare', '-Wno-unused-parameter'])
320 # We always compile using C++14
321 main
.Append(CXXFLAGS
=['-std=c++14'])
322 if sys
.platform
.startswith('freebsd'):
323 main
.Append(CCFLAGS
=['-I/usr/local/include'])
324 main
.Append(CXXFLAGS
=['-I/usr/local/include'])
326 conf
.CheckLinkFlag('-Wl,--as-needed')
327 if GetOption('gold_linker'):
328 main
.Append(LINKFLAGS
='-fuse-ld=gold')
330 # Treat warnings as errors but white list some warnings that we
331 # want to allow (e.g., deprecation warnings).
332 main
.Append(CCFLAGS
=['-Werror',
333 '-Wno-error=deprecated-declarations',
334 '-Wno-error=deprecated',
338 "Don't know what compiler options to use for your compiler.",
339 "compiler: " + main
['CXX'],
340 "version: " + CXX_version
.replace('\n', '<nl>') if
341 CXX_version
else 'COMMAND NOT FOUND!',
342 "If you're trying to use a compiler other than GCC",
343 "or clang, there appears to be something wrong with your",
346 "If you are trying to use a compiler other than those listed",
347 "above you will need to ease fix SConstruct and ",
348 "src/SConscript to support that compiler.")))
351 gcc_version
= readCommand([main
['CXX'], '-dumpversion'], exception
=False)
352 if compareVersions(gcc_version
, "5") < 0:
353 error('gcc version 5 or newer required.\n'
354 'Installed version:', gcc_version
)
357 main
['GCC_VERSION'] = gcc_version
359 # Add the appropriate Link-Time Optimization (LTO) flags
360 # unless LTO is explicitly turned off. Note that these flags
361 # are only used by the fast target.
362 if not GetOption('no_lto'):
363 # Pass the LTO flag when compiling to produce GIMPLE
364 # output, we merely create the flags here and only append
366 main
['LTO_CCFLAGS'] = ['-flto=%d' % GetOption('num_jobs')]
368 # Use the same amount of jobs for LTO as we are running
370 main
['LTO_LDFLAGS'] = ['-flto=%d' % GetOption('num_jobs')]
372 main
.Append(TCMALLOC_CCFLAGS
=['-fno-builtin-malloc', '-fno-builtin-calloc',
373 '-fno-builtin-realloc', '-fno-builtin-free'])
376 clang_version_re
= re
.compile(".* version (\d+\.\d+)")
377 clang_version_match
= clang_version_re
.search(CXX_version
)
378 if (clang_version_match
):
379 clang_version
= clang_version_match
.groups()[0]
380 if compareVersions(clang_version
, "3.9") < 0:
381 error('clang version 3.9 or newer required.\n'
382 'Installed version:', clang_version
)
384 error('Unable to determine clang version.')
386 # clang has a few additional warnings that we disable, extraneous
387 # parantheses are allowed due to Ruby's printing of the AST,
388 # finally self assignments are allowed as the generated CPU code
390 main
.Append(CCFLAGS
=['-Wno-parentheses',
392 # Some versions of libstdc++ (4.8?) seem to
393 # use struct hash and class hash
395 '-Wno-mismatched-tags',
397 conf
.CheckCxxFlag('-Wno-c99-designator')
398 conf
.CheckCxxFlag('-Wno-defaulted-function-deleted')
400 main
.Append(TCMALLOC_CCFLAGS
=['-fno-builtin'])
402 # On Mac OS X/Darwin we need to also use libc++ (part of XCode) as
403 # opposed to libstdc++, as the later is dated.
404 if sys
.platform
== "darwin":
405 main
.Append(CXXFLAGS
=['-stdlib=libc++'])
406 main
.Append(LIBS
=['c++'])
408 # On FreeBSD we need libthr.
409 if sys
.platform
.startswith('freebsd'):
410 main
.Append(LIBS
=['thr'])
412 # Add sanitizers flags
414 if GetOption('with_ubsan'):
415 sanitizers
.append('undefined')
416 if GetOption('with_asan'):
417 # Available for gcc >= 5 or llvm >= 3.1 both a requirement
418 # by the build system
419 sanitizers
.append('address')
420 suppressions_file
= Dir('util').File('lsan-suppressions').get_abspath()
421 suppressions_opt
= 'suppressions=%s' % suppressions_file
422 main
['ENV']['LSAN_OPTIONS'] = ':'.join([suppressions_opt
,
423 'print_suppressions=0'])
425 warning('To suppress false positive leaks, set the LSAN_OPTIONS '
426 'environment variable to "%s" when running gem5' %
428 warning('LSAN_OPTIONS=suppressions=%s' % suppressions_opt
)
431 sanitizers
= ','.join(sanitizers
)
432 if main
['GCC'] or main
['CLANG']:
433 main
.Append(CCFLAGS
=['-fsanitize=%s' % sanitizers
,
434 '-fno-omit-frame-pointer'],
435 LINKFLAGS
='-fsanitize=%s' % sanitizers
)
437 warning("Don't know how to enable %s sanitizer(s) for your "
438 "compiler." % sanitizers
)
440 # Set up common yacc/bison flags (needed for Ruby)
441 main
['YACCFLAGS'] = '-d'
442 main
['YACCHXXFILESUFFIX'] = '.hh'
444 # Do this after we save setting back, or else we'll tack on an
445 # extra 'qdo' every time we run scons.
447 main
['CC'] = main
['BATCH_CMD'] + ' ' + main
['CC']
448 main
['CXX'] = main
['BATCH_CMD'] + ' ' + main
['CXX']
449 main
['AS'] = main
['BATCH_CMD'] + ' ' + main
['AS']
450 main
['AR'] = main
['BATCH_CMD'] + ' ' + main
['AR']
451 main
['RANLIB'] = main
['BATCH_CMD'] + ' ' + main
['RANLIB']
453 if sys
.platform
== 'cygwin':
454 # cygwin has some header file issues...
455 main
.Append(CCFLAGS
=["-Wno-uninitialized"])
458 have_pkg_config
= main
.Detect('pkg-config')
460 # Check for the protobuf compiler
461 main
['HAVE_PROTOC'] = False
464 protoc_version
= readCommand([main
['PROTOC'], '--version']).split()
465 except Exception as e
:
466 warning('While checking protoc version:', str(e
))
468 # Based on the availability of the compress stream wrappers, require 2.1.0.
469 min_protoc_version
= '2.1.0'
471 # First two words should be "libprotoc x.y.z"
472 if len(protoc_version
) < 2 or protoc_version
[0] != 'libprotoc':
473 warning('Protocol buffer compiler (protoc) not found.\n'
474 'Please install protobuf-compiler for tracing support.')
475 elif compareVersions(protoc_version
[1], min_protoc_version
) < 0:
476 warning('protoc version', min_protoc_version
, 'or newer required.\n'
477 'Installed version:', protoc_version
[1])
479 # Attempt to determine the appropriate include path and
480 # library path using pkg-config, that means we also need to
481 # check for pkg-config. Note that it is possible to use
482 # protobuf without the involvement of pkg-config. Later on we
483 # check go a library config check and at that point the test
484 # will fail if libprotobuf cannot be found.
486 conf
.CheckPkgConfig('protobuf', '--cflags', '--libs-only-L')
487 main
['HAVE_PROTOC'] = True
491 # Cache build files in the supplied directory.
492 if main
['M5_BUILD_CACHE']:
493 print('Using build cache located at', main
['M5_BUILD_CACHE'])
494 CacheDir(main
['M5_BUILD_CACHE'])
496 if not GetOption('no_compress_debug'):
497 if not conf
.CheckCxxFlag('-gz'):
498 warning("Can't enable object file debug section compression")
499 if not conf
.CheckLinkFlag('-gz'):
500 warning("Can't enable executable debug section compression")
502 main
['USE_PYTHON'] = not GetOption('without_python')
503 if main
['USE_PYTHON']:
504 # Find Python include and library directories for embedding the
505 # interpreter. We rely on python-config to resolve the appropriate
506 # includes and linker flags. ParseConfig does not seem to understand
507 # the more exotic linker flags such as -Xlinker and -export-dynamic so
508 # we add them explicitly below. If you want to link in an alternate
509 # version of python, see above for instructions on how to invoke
510 # scons with the appropriate PATH set.
512 python_config
= main
.Detect(main
['PYTHON_CONFIG'])
513 if python_config
is None:
514 error("Can't find a suitable python-config, tried %s" % \
515 main
['PYTHON_CONFIG'])
517 print("Info: Using Python config: %s" % (python_config
, ))
519 py_includes
= readCommand([python_config
, '--includes'],
520 exception
='').split()
521 py_includes
= list(filter(
522 lambda s
: match(r
'.*\/include\/.*',s
), py_includes
))
523 # Strip the -I from the include folders before adding them to the
525 py_includes
= list(map(
526 lambda s
: s
[2:] if s
.startswith('-I') else s
, py_includes
))
527 main
.Append(CPPPATH
=py_includes
)
529 # Read the linker flags and split them into libraries and other link
530 # flags. The libraries are added later through the call the CheckLib.
531 # Note: starting in Python 3.8 the --embed flag is required to get the
532 # -lpython3.8 linker flag
533 retcode
, cmd_stdout
= readCommandWithReturn(
534 [python_config
, '--ldflags', '--embed'], exception
='')
536 # If --embed isn't detected then we're running python <3.8
537 retcode
, cmd_stdout
= readCommandWithReturn(
538 [python_config
, '--ldflags'], exception
='')
540 # Checking retcode again
542 error("Failing on python-config --ldflags command")
544 py_ld_flags
= cmd_stdout
.split()
547 for lib
in py_ld_flags
:
548 if not lib
.startswith('-l'):
549 main
.Append(LINKFLAGS
=[lib
])
552 if lib
not in py_libs
:
555 # verify that this stuff works
556 if not conf
.CheckHeader('Python.h', '<>'):
557 error("Check failed for Python.h header in",
558 ' '.join(py_includes
), "\n"
559 "Two possible reasons:\n"
560 "1. Python headers are not installed (You can install the "
561 "package python-dev on Ubuntu and RedHat)\n"
562 "2. SCons is using a wrong C compiler. This can happen if "
563 "CC has the wrong value.\n"
564 "CC = %s" % main
['CC'])
567 if not conf
.CheckLib(lib
):
568 error("Can't find library %s required by python." % lib
)
570 main
.Prepend(CPPPATH
=Dir('ext/pybind11/include/'))
572 marshal_env
= main
.Clone()
574 # Bare minimum environment that only includes python
575 marshal_env
.Append(CCFLAGS
='$MARSHAL_CCFLAGS_EXTRA')
576 marshal_env
.Append(LINKFLAGS
='$MARSHAL_LDFLAGS_EXTRA')
578 py_version
= conf
.CheckPythonLib()
580 error("Can't find a working Python installation")
582 # Found a working Python installation. Check if it meets minimum
584 if py_version
[0] < 3 or \
585 (py_version
[0] == 3 and py_version
[1] < 6):
586 error('Python version too old. Version 3.6 or newer is required.')
587 elif py_version
[0] > 3:
588 warning('Python version too new. Python 3 expected.')
590 # On Solaris you need to use libsocket for socket ops
591 if not conf
.CheckLibWithHeader(
592 [None, 'socket'], 'sys/socket.h', 'C++', 'accept(0,0,0);'):
593 error("Can't find library with socket calls (e.g. accept()).")
595 # Check for zlib. If the check passes, libz will be automatically
596 # added to the LIBS environment variable.
597 if not conf
.CheckLibWithHeader('z', 'zlib.h', 'C++','zlibVersion();'):
598 error('Did not find needed zlib compression library '
599 'and/or zlib.h header file.\n'
600 'Please install zlib and try again.')
602 # If we have the protobuf compiler, also make sure we have the
603 # development libraries. If the check passes, libprotobuf will be
604 # automatically added to the LIBS environment variable. After
605 # this, we can use the HAVE_PROTOBUF flag to determine if we have
606 # got both protoc and libprotobuf available.
607 main
['HAVE_PROTOBUF'] = main
['HAVE_PROTOC'] and \
608 conf
.CheckLibWithHeader('protobuf', 'google/protobuf/message.h',
609 'C++', 'GOOGLE_PROTOBUF_VERIFY_VERSION;')
611 # Valgrind gets much less confused if you tell it when you're using
612 # alternative stacks.
613 main
['HAVE_VALGRIND'] = conf
.CheckCHeader('valgrind/valgrind.h')
615 # If we have the compiler but not the library, print another warning.
616 if main
['HAVE_PROTOC'] and not main
['HAVE_PROTOBUF']:
617 warning('Did not find protocol buffer library and/or headers.\n'
618 'Please install libprotobuf-dev for tracing support.')
622 conf
.CheckLibWithHeader([None, 'rt'], 'time.h', 'C',
623 'clock_nanosleep(0,0,NULL,NULL);')
624 if not have_posix_clock
:
625 warning("Can't find library for POSIX clocks.")
627 have_posix_timers
= \
628 conf
.CheckLibWithHeader([None, 'rt'], [ 'time.h', 'signal.h' ], 'C',
629 'timer_create(CLOCK_MONOTONIC, NULL, NULL);')
631 if not GetOption('without_tcmalloc'):
632 if conf
.CheckLib('tcmalloc'):
633 main
.Append(CCFLAGS
=main
['TCMALLOC_CCFLAGS'])
634 elif conf
.CheckLib('tcmalloc_minimal'):
635 main
.Append(CCFLAGS
=main
['TCMALLOC_CCFLAGS'])
637 warning("You can get a 12% performance improvement by "
638 "installing tcmalloc (libgoogle-perftools-dev package "
639 "on Ubuntu or RedHat).")
642 if conf
.CheckLibWithHeader([None, 'execinfo'], 'execinfo.h', 'C',
643 'char temp; backtrace_symbols_fd((void *)&temp, 0, 0);'):
644 main
['BACKTRACE_IMPL'] = 'glibc'
646 main
['BACKTRACE_IMPL'] = 'none'
647 warning("No suitable back trace implementation found.")
649 # Check for <fenv.h> (C99 FP environment control)
650 have_fenv
= conf
.CheckHeader('fenv.h', '<>')
652 warning("Header file <fenv.h> not found.\n"
653 "This host has no IEEE FP rounding mode control.")
655 # Check for <png.h> (libpng library needed if wanting to dump
656 # frame buffer image in png format)
657 have_png
= conf
.CheckHeader('png.h', '<>')
659 warning("Header file <png.h> not found.\n"
660 "This host has no libpng library.\n"
661 "Disabling support for PNG framebuffers.")
663 # Check if we should enable KVM-based hardware virtualization. The API
664 # we rely on exists since version 2.6.36 of the kernel, but somehow
665 # the KVM_API_VERSION does not reflect the change. We test for one of
666 # the types as a fall back.
667 have_kvm
= conf
.CheckHeader('linux/kvm.h', '<>')
669 print("Info: Compatible header file <linux/kvm.h> not found, "
670 "disabling KVM support.")
672 # Check if the TUN/TAP driver is available.
673 have_tuntap
= conf
.CheckHeader('linux/if_tun.h', '<>')
675 print("Info: Compatible header file <linux/if_tun.h> not found.")
677 # x86 needs support for xsave. We test for the structure here since we
678 # won't be able to run new tests by the time we know which ISA we're
680 have_kvm_xsave
= conf
.CheckTypeSize('struct kvm_xsave',
681 '#include <linux/kvm.h>') != 0
683 # Check if the requested target ISA is compatible with the host
684 def is_isa_kvm_compatible(isa
):
687 host_isa
= platform
.machine()
689 warning("Failed to determine host ISA.")
692 if not have_posix_timers
:
693 warning("Can not enable KVM, host seems to lack support "
698 return host_isa
in ( "armv7l", "aarch64" )
700 if host_isa
!= "x86_64":
703 if not have_kvm_xsave
:
704 warning("KVM on x86 requires xsave support in kernel headers.")
712 # Check if the exclude_host attribute is available. We want this to
713 # get accurate instruction counts in KVM.
714 main
['HAVE_PERF_ATTR_EXCLUDE_HOST'] = conf
.CheckMember(
715 'linux/perf_event.h', 'struct perf_event_attr', 'exclude_host')
717 # Check if there is a pkg-config configuration for hdf5. If we find
718 # it, setup the environment to enable linking and header inclusion. We
719 # don't actually try to include any headers or link with hdf5 at this
722 conf
.CheckPkgConfig(['hdf5-serial', 'hdf5'],
723 '--cflags-only-I', '--libs-only-L')
725 # Check if the HDF5 libraries can be found. This check respects the
726 # include path and library path provided by pkg-config. We perform
727 # this check even if there isn't a pkg-config configuration for hdf5
728 # since some installations don't use pkg-config.
730 conf
.CheckLibWithHeader('hdf5', 'hdf5.h', 'C',
731 'H5Fcreate("", 0, 0, 0);') and \
732 conf
.CheckLibWithHeader('hdf5_cpp', 'H5Cpp.h', 'C++',
733 'H5::H5File("", 0);')
735 warning("Couldn't find any HDF5 C++ libraries. Disabling HDF5 support.")
737 ######################################################################
739 # Finish the configuration
743 ######################################################################
745 # Collect all non-global variables
748 # Define the universe of supported ISAs
750 all_gpu_isa_list
= [ ]
751 Export('all_isa_list')
752 Export('all_gpu_isa_list')
754 class CpuModel(object):
755 '''The CpuModel class encapsulates everything the ISA parser needs to
756 know about a particular CPU model.'''
758 # Dict of available CPU model objects. Accessible as CpuModel.dict.
761 # Constructor. Automatically adds models to CpuModel.dict.
762 def __init__(self
, name
, default
=False):
763 self
.name
= name
# name of model
765 # This cpu is enabled by default
766 self
.default
= default
769 if name
in CpuModel
.dict:
770 raise AttributeError("CpuModel '%s' already registered" % name
)
771 CpuModel
.dict[name
] = self
775 # Sticky variables get saved in the variables file so they persist from
776 # one invocation to the next (unless overridden, in which case the new
777 # value becomes sticky).
778 sticky_vars
= Variables(args
=ARGUMENTS
)
779 Export('sticky_vars')
781 # Sticky variables that should be exported
783 Export('export_vars')
787 Export('all_protocols')
789 Export('protocol_dirs')
791 Export('slicc_includes')
793 # Walk the tree and execute all SConsopts scripts that wil add to the
795 if GetOption('verbose'):
796 print("Reading SConsopts")
797 for bdir
in [ base_dir
] + extras_dir_list
:
799 error("Directory '%s' does not exist." % bdir
)
800 for root
, dirs
, files
in os
.walk(bdir
):
801 if 'SConsopts' in files
:
802 if GetOption('verbose'):
803 print("Reading", joinpath(root
, 'SConsopts'))
804 SConscript(joinpath(root
, 'SConsopts'))
807 all_gpu_isa_list
.sort()
809 sticky_vars
.AddVariables(
810 EnumVariable('TARGET_ISA', 'Target ISA', 'null', all_isa_list
),
811 EnumVariable('TARGET_GPU_ISA', 'Target GPU ISA', 'gcn3', all_gpu_isa_list
),
812 ListVariable('CPU_MODELS', 'CPU models',
813 sorted(n
for n
,m
in CpuModel
.dict.items() if m
.default
),
814 sorted(CpuModel
.dict.keys())),
815 BoolVariable('EFENCE', 'Link with Electric Fence malloc debugger',
817 BoolVariable('USE_SSE2',
818 'Compile for SSE2 (-msse2) to get IEEE FP on x86 hosts',
820 BoolVariable('USE_POSIX_CLOCK', 'Use POSIX Clocks', have_posix_clock
),
821 BoolVariable('USE_FENV', 'Use <fenv.h> IEEE mode control', have_fenv
),
822 BoolVariable('USE_PNG', 'Enable support for PNG images', have_png
),
823 BoolVariable('USE_KVM', 'Enable hardware virtualized (KVM) CPU models',
825 BoolVariable('USE_TUNTAP',
826 'Enable using a tap device to bridge to the host network',
828 BoolVariable('BUILD_GPU', 'Build the compute-GPU model', False),
829 EnumVariable('PROTOCOL', 'Coherence protocol for Ruby', 'None',
831 ('NUMBER_BITS_PER_SET', 'Max elements in set (default 64)',
833 BoolVariable('USE_HDF5', 'Enable the HDF5 support', have_hdf5
),
836 # These variables get exported to #defines in config/*.hh (see src/SConscript).
837 export_vars
+= ['USE_FENV', 'TARGET_ISA', 'TARGET_GPU_ISA',
838 'USE_POSIX_CLOCK', 'USE_KVM', 'USE_TUNTAP', 'PROTOCOL',
839 'HAVE_PROTOBUF', 'HAVE_VALGRIND',
840 'HAVE_PERF_ATTR_EXCLUDE_HOST', 'USE_PNG',
841 'NUMBER_BITS_PER_SET', 'USE_HDF5']
843 ###################################################
845 # Define a SCons builder for configuration flag headers.
847 ###################################################
849 # This function generates a config header file that #defines the
850 # variable symbol to the current variable setting (0 or 1). The source
851 # operands are the name of the variable and a Value node containing the
852 # value of the variable.
853 def build_config_file(target
, source
, env
):
854 (variable
, value
) = [s
.get_contents().decode('utf-8') for s
in source
]
855 with
open(str(target
[0].abspath
), 'w') as f
:
856 print('#define', variable
, value
, file=f
)
859 # Combine the two functions into a scons Action object.
860 config_action
= MakeAction(build_config_file
, Transform("CONFIG H", 2))
862 # The emitter munges the source & target node lists to reflect what
863 # we're really doing.
864 def config_emitter(target
, source
, env
):
865 # extract variable name from Builder arg
866 variable
= str(target
[0])
867 # True target is config header file
868 target
= Dir('config').File(variable
.lower() + '.hh')
870 if isinstance(val
, bool):
873 elif isinstance(val
, str):
874 val
= '"' + val
+ '"'
876 # Sources are variable name & value (packaged in SCons Value nodes)
877 return [target
], [Value(variable
), Value(val
)]
879 config_builder
= Builder(emitter
=config_emitter
, action
=config_action
)
881 main
.Append(BUILDERS
= { 'ConfigFile' : config_builder
})
883 def add_local_rpath(env
, *targets
):
884 '''Set up an RPATH for a library which lives in the build directory.
886 The construction environment variable BIN_RPATH_PREFIX should be set to
887 the relative path of the build directory starting from the location of the
889 for target
in targets
:
890 target
= env
.Entry(target
)
891 if not isinstance(target
, SCons
.Node
.FS
.Dir
):
893 relpath
= os
.path
.relpath(target
.abspath
, env
['BUILDDIR'])
896 '${BIN_RPATH_PREFIX}',
899 env
.Append(RPATH
=[env
.Literal(os
.path
.join(*components
))])
901 if sys
.platform
!= "darwin":
902 main
.Append(LINKFLAGS
=Split('-z origin'))
904 main
.AddMethod(add_local_rpath
, 'AddLocalRPATH')
906 # builds in ext are shared across all configs in the build root.
907 ext_dir
= Dir('#ext').abspath
909 for root
, dirs
, files
in os
.walk(ext_dir
):
910 if 'SConscript' in files
:
911 build_dir
= os
.path
.relpath(root
, ext_dir
)
912 ext_build_dirs
.append(build_dir
)
913 main
.SConscript(joinpath(root
, 'SConscript'),
914 variant_dir
=joinpath(build_root
, build_dir
))
916 gdb_xml_dir
= joinpath(ext_dir
, 'gdb-xml')
917 Export('gdb_xml_dir')
919 ###################################################
921 # This builder and wrapper method are used to set up a directory with
922 # switching headers. Those are headers which are in a generic location and
923 # that include more specific headers from a directory chosen at build time
924 # based on the current build settings.
926 ###################################################
928 def build_switching_header(target
, source
, env
):
929 path
= str(target
[0])
930 subdir
= str(source
[0])
931 dp
, fp
= os
.path
.split(path
)
932 dp
= os
.path
.relpath(os
.path
.realpath(dp
),
933 os
.path
.realpath(env
['BUILDDIR']))
934 with
open(path
, 'w') as hdr
:
935 print('#include "%s/%s/%s"' % (dp
, subdir
, fp
), file=hdr
)
937 switching_header_action
= MakeAction(build_switching_header
,
938 Transform('GENERATE'))
940 switching_header_builder
= Builder(action
=switching_header_action
,
941 source_factory
=Value
,
944 main
.Append(BUILDERS
= { 'SwitchingHeader': switching_header_builder
})
946 def switching_headers(self
, headers
, source
):
947 for header
in headers
:
948 self
.SwitchingHeader(header
, source
)
950 main
.AddMethod(switching_headers
, 'SwitchingHeaders')
952 ###################################################
954 # Define build environments for selected configurations.
956 ###################################################
958 for variant_path
in variant_paths
:
959 if not GetOption('silent'):
960 print("Building in", variant_path
)
962 # Make a copy of the build-root environment to use for this config.
964 env
['BUILDDIR'] = variant_path
966 # variant_dir is the tail component of build path, and is used to
967 # determine the build parameters (e.g., 'X86')
968 (build_root
, variant_dir
) = splitpath(variant_path
)
970 # Set env variables according to the build directory config.
971 sticky_vars
.files
= []
972 # Variables for $BUILD_ROOT/$VARIANT_DIR are stored in
973 # $BUILD_ROOT/variables/$VARIANT_DIR so you can nuke
974 # $BUILD_ROOT/$VARIANT_DIR without losing your variables settings.
975 current_vars_file
= joinpath(build_root
, 'variables', variant_dir
)
976 if isfile(current_vars_file
):
977 sticky_vars
.files
.append(current_vars_file
)
978 if not GetOption('silent'):
979 print("Using saved variables file %s" % current_vars_file
)
980 elif variant_dir
in ext_build_dirs
:
981 # Things in ext are built without a variant directory.
984 # Build dir-specific variables file doesn't exist.
986 # Make sure the directory is there so we can create it later
987 opt_dir
= dirname(current_vars_file
)
988 if not isdir(opt_dir
):
991 # Get default build variables from source tree. Variables are
992 # normally determined by name of $VARIANT_DIR, but can be
993 # overridden by '--default=' arg on command line.
994 default
= GetOption('default')
995 opts_dir
= Dir('#build_opts').abspath
997 default_vars_files
= [joinpath(build_root
, 'variables', default
),
998 joinpath(opts_dir
, default
)]
1000 default_vars_files
= [joinpath(opts_dir
, variant_dir
)]
1001 existing_files
= list(filter(isfile
, default_vars_files
))
1003 default_vars_file
= existing_files
[0]
1004 sticky_vars
.files
.append(default_vars_file
)
1005 print("Variables file %s not found,\n using defaults in %s"
1006 % (current_vars_file
, default_vars_file
))
1008 error("Cannot find variables file %s or default file(s) %s"
1009 % (current_vars_file
, ' or '.join(default_vars_files
)))
1012 # Apply current variable settings to env
1013 sticky_vars
.Update(env
)
1016 Build variables for {dir}:
1018 '''.format(dir=variant_dir
, help=sticky_vars
.GenerateHelpText(env
)),
1021 # Process variable settings.
1023 if not have_fenv
and env
['USE_FENV']:
1024 warning("<fenv.h> not available; forcing USE_FENV to False in",
1026 env
['USE_FENV'] = False
1028 if not env
['USE_FENV']:
1029 warning("No IEEE FP rounding mode control in", variant_dir
+ ".\n"
1030 "FP results may deviate slightly from other platforms.")
1032 if not have_png
and env
['USE_PNG']:
1033 warning("<png.h> not available; forcing USE_PNG to False in",
1035 env
['USE_PNG'] = False
1038 env
.Append(LIBS
=['png'])
1041 env
.Append(LIBS
=['efence'])
1045 warning("Can not enable KVM, host seems to lack KVM support")
1046 env
['USE_KVM'] = False
1047 elif not is_isa_kvm_compatible(env
['TARGET_ISA']):
1048 print("Info: KVM support disabled due to unsupported host and "
1049 "target ISA combination")
1050 env
['USE_KVM'] = False
1052 if env
['USE_TUNTAP']:
1054 warning("Can't connect EtherTap with a tap device.")
1055 env
['USE_TUNTAP'] = False
1057 if env
['BUILD_GPU']:
1058 env
.Append(CPPDEFINES
=['BUILD_GPU'])
1060 # Warn about missing optional functionality
1062 if not main
['HAVE_PERF_ATTR_EXCLUDE_HOST']:
1063 warning("perf_event headers lack support for the exclude_host "
1064 "attribute. KVM instruction counts will be inaccurate.")
1066 # Save sticky variable settings back to current variables file
1067 sticky_vars
.Save(current_vars_file
, env
)
1070 env
.Append(CCFLAGS
=['-msse2'])
1072 env
.Append(CCFLAGS
='$CCFLAGS_EXTRA')
1073 env
.Append(LINKFLAGS
='$LDFLAGS_EXTRA')
1076 if main
['USE_PYTHON']:
1077 exports
.append('marshal_env')
1079 # The src/SConscript file sets up the build rules in 'env' according
1080 # to the configured variables. It returns a list of environments,
1081 # one for each variant build (debug, opt, etc.)
1082 SConscript('src/SConscript', variant_dir
=variant_path
, exports
=exports
)
1084 atexit
.register(summarize_warnings
)