1# -*- mode:python -*- 2 3# Copyright (c) 2011 Advanced Micro Devices, Inc. 4# Copyright (c) 2009 The Hewlett-Packard Development Company 5# Copyright (c) 2004-2005 The Regents of The University of Michigan 6# All rights reserved. 7# 8# Redistribution and use in source and binary forms, with or without 9# modification, are permitted provided that the following conditions are 10# met: redistributions of source code must retain the above copyright 11# notice, this list of conditions and the following disclaimer; 12# redistributions in binary form must reproduce the above copyright 13# notice, this list of conditions and the following disclaimer in the 14# documentation and/or other materials provided with the distribution; 15# neither the name of the copyright holders nor the names of its 16# contributors may be used to endorse or promote products derived from 17# this software without specific prior written permission. 18# 19# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 20# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 21# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 22# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 23# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 24# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 25# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 29# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30# 31# Authors: Steve Reinhardt 32# Nathan Binkert 33 34################################################### 35# 36# SCons top-level build description (SConstruct) file. 37# 38# While in this directory ('m5'), just type 'scons' to build the default 39# configuration (see below), or type 'scons build/<CONFIG>/<binary>' 40# to build some other configuration (e.g., 'build/ALPHA_FS/m5.opt' for 41# the optimized full-system version). 42# 43# You can build M5 in a different directory as long as there is a 44# 'build/<CONFIG>' somewhere along the target path. The build system 45# expects that all configs under the same build directory are being 46# built for the same host system. 47# 48# Examples: 49# 50# The following two commands are equivalent. The '-u' option tells 51# scons to search up the directory tree for this SConstruct file. 52# % cd <path-to-src>/m5 ; scons build/ALPHA_FS/m5.debug 53# % cd <path-to-src>/m5/build/ALPHA_FS; scons -u m5.debug 54# 55# The following two commands are equivalent and demonstrate building 56# in a directory outside of the source tree. The '-C' option tells 57# scons to chdir to the specified directory to find this SConstruct 58# file. 59# % cd <path-to-src>/m5 ; scons /local/foo/build/ALPHA_FS/m5.debug 60# % cd /local/foo/build/ALPHA_FS; scons -C <path-to-src>/m5 m5.debug 61# 62# You can use 'scons -H' to print scons options. If you're in this 63# 'm5' directory (or use -u or -C to tell scons where to find this 64# file), you can use 'scons -h' to print all the M5-specific build 65# options as well. 66# 67################################################### 68 69# Check for recent-enough Python and SCons versions. 70try: 71 # Really old versions of scons only take two options for the 72 # function, so check once without the revision and once with the 73 # revision, the first instance will fail for stuff other than 74 # 0.98, and the second will fail for 0.98.0 75 EnsureSConsVersion(0, 98) 76 EnsureSConsVersion(0, 98, 1) 77except SystemExit, e: 78 print """ 79For more details, see: 80 http://m5sim.org/wiki/index.php/Compiling_M5 81""" 82 raise 83 84# We ensure the python version early because we have stuff that 85# requires python 2.4 86try: 87 EnsurePythonVersion(2, 4) 88except SystemExit, e: 89 print """ 90You can use a non-default installation of the Python interpreter by 91either (1) rearranging your PATH so that scons finds the non-default 92'python' first or (2) explicitly invoking an alternative interpreter 93on the scons script. 94 95For more details, see: 96 http://m5sim.org/wiki/index.php/Using_a_non-default_Python_installation 97""" 98 raise 99 100# Global Python includes 101import os 102import re 103import subprocess 104import sys 105 106from os import mkdir, environ 107from os.path import abspath, basename, dirname, expanduser, normpath 108from os.path import exists, isdir, isfile 109from os.path import join as joinpath, split as splitpath 110 111# SCons includes 112import SCons 113import SCons.Node 114 115extra_python_paths = [ 116 Dir('src/python').srcnode().abspath, # M5 includes 117 Dir('ext/ply').srcnode().abspath, # ply is used by several files 118 ] 119 120sys.path[1:1] = extra_python_paths 121 122from m5.util import compareVersions, readCommand 123 124help_texts = { 125 "options" : "", 126 "global_vars" : "", 127 "local_vars" : "" 128} 129 130Export("help_texts") 131 132def AddM5Option(*args, **kwargs): 133 col_width = 30 134 135 help = " " + ", ".join(args) 136 if "help" in kwargs: 137 length = len(help) 138 if length >= col_width: 139 help += "\n" + " " * col_width 140 else: 141 help += " " * (col_width - length) 142 help += kwargs["help"] 143 help_texts["options"] += help + "\n" 144 145 AddOption(*args, **kwargs) 146 147AddM5Option('--colors', dest='use_colors', action='store_true', 148 help="Add color to abbreviated scons output") 149AddM5Option('--no-colors', dest='use_colors', action='store_false', 150 help="Don't add color to abbreviated scons output") 151AddM5Option('--default', dest='default', type='string', action='store', 152 help='Override which build_opts file to use for defaults') 153AddM5Option('--ignore-style', dest='ignore_style', action='store_true', 154 help='Disable style checking hooks') 155AddM5Option('--update-ref', dest='update_ref', action='store_true', 156 help='Update test reference outputs') 157AddM5Option('--verbose', dest='verbose', action='store_true', 158 help='Print full tool command lines') 159 160use_colors = GetOption('use_colors') 161if use_colors: 162 from m5.util.terminal import termcap 163elif use_colors is None: 164 # option unspecified; default behavior is to use colors iff isatty 165 from m5.util.terminal import tty_termcap as termcap 166else: 167 from m5.util.terminal import no_termcap as termcap 168 169######################################################################## 170# 171# Set up the main build environment. 172# 173######################################################################## 174use_vars = set([ 'AS', 'AR', 'CC', 'CXX', 'HOME', 'LD_LIBRARY_PATH', 'PATH', 175 'PYTHONPATH', 'RANLIB' ]) 176 177use_env = {} 178for key,val in os.environ.iteritems(): 179 if key in use_vars or key.startswith("M5"): 180 use_env[key] = val 181 182main = Environment(ENV=use_env) 183main.root = Dir(".") # The current directory (where this file lives). 184main.srcdir = Dir("src") # The source directory 185 186# add useful python code PYTHONPATH so it can be used by subprocesses 187# as well 188main.AppendENVPath('PYTHONPATH', extra_python_paths) 189 190######################################################################## 191# 192# Mercurial Stuff. 193# 194# If the M5 directory is a mercurial repository, we should do some 195# extra things. 196# 197######################################################################## 198 199hgdir = main.root.Dir(".hg") 200 201mercurial_style_message = """
| 1# -*- mode:python -*- 2 3# Copyright (c) 2011 Advanced Micro Devices, Inc. 4# Copyright (c) 2009 The Hewlett-Packard Development Company 5# Copyright (c) 2004-2005 The Regents of The University of Michigan 6# All rights reserved. 7# 8# Redistribution and use in source and binary forms, with or without 9# modification, are permitted provided that the following conditions are 10# met: redistributions of source code must retain the above copyright 11# notice, this list of conditions and the following disclaimer; 12# redistributions in binary form must reproduce the above copyright 13# notice, this list of conditions and the following disclaimer in the 14# documentation and/or other materials provided with the distribution; 15# neither the name of the copyright holders nor the names of its 16# contributors may be used to endorse or promote products derived from 17# this software without specific prior written permission. 18# 19# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 20# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 21# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 22# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 23# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 24# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 25# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 26# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 27# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 28# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 29# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 30# 31# Authors: Steve Reinhardt 32# Nathan Binkert 33 34################################################### 35# 36# SCons top-level build description (SConstruct) file. 37# 38# While in this directory ('m5'), just type 'scons' to build the default 39# configuration (see below), or type 'scons build/<CONFIG>/<binary>' 40# to build some other configuration (e.g., 'build/ALPHA_FS/m5.opt' for 41# the optimized full-system version). 42# 43# You can build M5 in a different directory as long as there is a 44# 'build/<CONFIG>' somewhere along the target path. The build system 45# expects that all configs under the same build directory are being 46# built for the same host system. 47# 48# Examples: 49# 50# The following two commands are equivalent. The '-u' option tells 51# scons to search up the directory tree for this SConstruct file. 52# % cd <path-to-src>/m5 ; scons build/ALPHA_FS/m5.debug 53# % cd <path-to-src>/m5/build/ALPHA_FS; scons -u m5.debug 54# 55# The following two commands are equivalent and demonstrate building 56# in a directory outside of the source tree. The '-C' option tells 57# scons to chdir to the specified directory to find this SConstruct 58# file. 59# % cd <path-to-src>/m5 ; scons /local/foo/build/ALPHA_FS/m5.debug 60# % cd /local/foo/build/ALPHA_FS; scons -C <path-to-src>/m5 m5.debug 61# 62# You can use 'scons -H' to print scons options. If you're in this 63# 'm5' directory (or use -u or -C to tell scons where to find this 64# file), you can use 'scons -h' to print all the M5-specific build 65# options as well. 66# 67################################################### 68 69# Check for recent-enough Python and SCons versions. 70try: 71 # Really old versions of scons only take two options for the 72 # function, so check once without the revision and once with the 73 # revision, the first instance will fail for stuff other than 74 # 0.98, and the second will fail for 0.98.0 75 EnsureSConsVersion(0, 98) 76 EnsureSConsVersion(0, 98, 1) 77except SystemExit, e: 78 print """ 79For more details, see: 80 http://m5sim.org/wiki/index.php/Compiling_M5 81""" 82 raise 83 84# We ensure the python version early because we have stuff that 85# requires python 2.4 86try: 87 EnsurePythonVersion(2, 4) 88except SystemExit, e: 89 print """ 90You can use a non-default installation of the Python interpreter by 91either (1) rearranging your PATH so that scons finds the non-default 92'python' first or (2) explicitly invoking an alternative interpreter 93on the scons script. 94 95For more details, see: 96 http://m5sim.org/wiki/index.php/Using_a_non-default_Python_installation 97""" 98 raise 99 100# Global Python includes 101import os 102import re 103import subprocess 104import sys 105 106from os import mkdir, environ 107from os.path import abspath, basename, dirname, expanduser, normpath 108from os.path import exists, isdir, isfile 109from os.path import join as joinpath, split as splitpath 110 111# SCons includes 112import SCons 113import SCons.Node 114 115extra_python_paths = [ 116 Dir('src/python').srcnode().abspath, # M5 includes 117 Dir('ext/ply').srcnode().abspath, # ply is used by several files 118 ] 119 120sys.path[1:1] = extra_python_paths 121 122from m5.util import compareVersions, readCommand 123 124help_texts = { 125 "options" : "", 126 "global_vars" : "", 127 "local_vars" : "" 128} 129 130Export("help_texts") 131 132def AddM5Option(*args, **kwargs): 133 col_width = 30 134 135 help = " " + ", ".join(args) 136 if "help" in kwargs: 137 length = len(help) 138 if length >= col_width: 139 help += "\n" + " " * col_width 140 else: 141 help += " " * (col_width - length) 142 help += kwargs["help"] 143 help_texts["options"] += help + "\n" 144 145 AddOption(*args, **kwargs) 146 147AddM5Option('--colors', dest='use_colors', action='store_true', 148 help="Add color to abbreviated scons output") 149AddM5Option('--no-colors', dest='use_colors', action='store_false', 150 help="Don't add color to abbreviated scons output") 151AddM5Option('--default', dest='default', type='string', action='store', 152 help='Override which build_opts file to use for defaults') 153AddM5Option('--ignore-style', dest='ignore_style', action='store_true', 154 help='Disable style checking hooks') 155AddM5Option('--update-ref', dest='update_ref', action='store_true', 156 help='Update test reference outputs') 157AddM5Option('--verbose', dest='verbose', action='store_true', 158 help='Print full tool command lines') 159 160use_colors = GetOption('use_colors') 161if use_colors: 162 from m5.util.terminal import termcap 163elif use_colors is None: 164 # option unspecified; default behavior is to use colors iff isatty 165 from m5.util.terminal import tty_termcap as termcap 166else: 167 from m5.util.terminal import no_termcap as termcap 168 169######################################################################## 170# 171# Set up the main build environment. 172# 173######################################################################## 174use_vars = set([ 'AS', 'AR', 'CC', 'CXX', 'HOME', 'LD_LIBRARY_PATH', 'PATH', 175 'PYTHONPATH', 'RANLIB' ]) 176 177use_env = {} 178for key,val in os.environ.iteritems(): 179 if key in use_vars or key.startswith("M5"): 180 use_env[key] = val 181 182main = Environment(ENV=use_env) 183main.root = Dir(".") # The current directory (where this file lives). 184main.srcdir = Dir("src") # The source directory 185 186# add useful python code PYTHONPATH so it can be used by subprocesses 187# as well 188main.AppendENVPath('PYTHONPATH', extra_python_paths) 189 190######################################################################## 191# 192# Mercurial Stuff. 193# 194# If the M5 directory is a mercurial repository, we should do some 195# extra things. 196# 197######################################################################## 198 199hgdir = main.root.Dir(".hg") 200 201mercurial_style_message = """
|
250################################################### 251# 252# Figure out which configurations to set up based on the path(s) of 253# the target(s). 254# 255################################################### 256 257# Find default configuration & binary. 258Default(environ.get('M5_DEFAULT_BINARY', 'build/ALPHA_SE/m5.debug')) 259 260# helper function: find last occurrence of element in list 261def rfind(l, elt, offs = -1): 262 for i in range(len(l)+offs, 0, -1): 263 if l[i] == elt: 264 return i 265 raise ValueError, "element not found" 266 267# Take a list of paths (or SCons Nodes) and return a list with all 268# paths made absolute and ~-expanded. Paths will be interpreted 269# relative to the launch directory unless a different root is provided 270def makePathListAbsolute(path_list, root=GetLaunchDir()): 271 return [abspath(joinpath(root, expanduser(str(p)))) 272 for p in path_list] 273 274# Each target must have 'build' in the interior of the path; the 275# directory below this will determine the build parameters. For 276# example, for target 'foo/bar/build/ALPHA_SE/arch/alpha/blah.do' we 277# recognize that ALPHA_SE specifies the configuration because it 278# follow 'build' in the build path. 279 280# The funky assignment to "[:]" is needed to replace the list contents 281# in place rather than reassign the symbol to a new list, which 282# doesn't work (obviously!). 283BUILD_TARGETS[:] = makePathListAbsolute(BUILD_TARGETS) 284 285# Generate a list of the unique build roots and configs that the 286# collected targets reference. 287variant_paths = [] 288build_root = None 289for t in BUILD_TARGETS: 290 path_dirs = t.split('/') 291 try: 292 build_top = rfind(path_dirs, 'build', -2) 293 except: 294 print "Error: no non-leaf 'build' dir found on target path", t 295 Exit(1) 296 this_build_root = joinpath('/',*path_dirs[:build_top+1]) 297 if not build_root: 298 build_root = this_build_root 299 else: 300 if this_build_root != build_root: 301 print "Error: build targets not under same build root\n"\ 302 " %s\n %s" % (build_root, this_build_root) 303 Exit(1) 304 variant_path = joinpath('/',*path_dirs[:build_top+2]) 305 if variant_path not in variant_paths: 306 variant_paths.append(variant_path) 307 308# Make sure build_root exists (might not if this is the first build there) 309if not isdir(build_root): 310 mkdir(build_root) 311main['BUILDROOT'] = build_root 312 313Export('main') 314 315main.SConsignFile(joinpath(build_root, "sconsign")) 316 317# Default duplicate option is to use hard links, but this messes up 318# when you use emacs to edit a file in the target dir, as emacs moves 319# file to file~ then copies to file, breaking the link. Symbolic 320# (soft) links work better. 321main.SetOption('duplicate', 'soft-copy') 322 323# 324# Set up global sticky variables... these are common to an entire build 325# tree (not specific to a particular build like ALPHA_SE) 326# 327 328global_vars_file = joinpath(build_root, 'variables.global') 329 330global_vars = Variables(global_vars_file, args=ARGUMENTS) 331 332global_vars.AddVariables( 333 ('CC', 'C compiler', environ.get('CC', main['CC'])), 334 ('CXX', 'C++ compiler', environ.get('CXX', main['CXX'])), 335 ('BATCH', 'Use batch pool for build and tests', False), 336 ('BATCH_CMD', 'Batch pool submission command name', 'qdo'), 337 ('M5_BUILD_CACHE', 'Cache built objects in this directory', False), 338 ('EXTRAS', 'Add extra directories to the compilation', '') 339 ) 340 341# Update main environment with values from ARGUMENTS & global_vars_file 342global_vars.Update(main) 343help_texts["global_vars"] += global_vars.GenerateHelpText(main) 344 345# Save sticky variable settings back to current variables file 346global_vars.Save(global_vars_file, main) 347 348# Parse EXTRAS variable to build list of all directories where we're 349# look for sources etc. This list is exported as extras_dir_list. 350base_dir = main.srcdir.abspath 351if main['EXTRAS']: 352 extras_dir_list = makePathListAbsolute(main['EXTRAS'].split(':')) 353else: 354 extras_dir_list = [] 355 356Export('base_dir') 357Export('extras_dir_list') 358 359# the ext directory should be on the #includes path 360main.Append(CPPPATH=[Dir('ext')]) 361 362def strip_build_path(path, env): 363 path = str(path) 364 variant_base = env['BUILDROOT'] + os.path.sep 365 if path.startswith(variant_base): 366 path = path[len(variant_base):] 367 elif path.startswith('build/'): 368 path = path[6:] 369 return path 370 371# Generate a string of the form: 372# common/path/prefix/src1, src2 -> tgt1, tgt2 373# to print while building. 374class Transform(object): 375 # all specific color settings should be here and nowhere else 376 tool_color = termcap.Normal 377 pfx_color = termcap.Yellow 378 srcs_color = termcap.Yellow + termcap.Bold 379 arrow_color = termcap.Blue + termcap.Bold 380 tgts_color = termcap.Yellow + termcap.Bold 381 382 def __init__(self, tool, max_sources=99): 383 self.format = self.tool_color + (" [%8s] " % tool) \ 384 + self.pfx_color + "%s" \ 385 + self.srcs_color + "%s" \ 386 + self.arrow_color + " -> " \ 387 + self.tgts_color + "%s" \ 388 + termcap.Normal 389 self.max_sources = max_sources 390 391 def __call__(self, target, source, env, for_signature=None): 392 # truncate source list according to max_sources param 393 source = source[0:self.max_sources] 394 def strip(f): 395 return strip_build_path(str(f), env) 396 if len(source) > 0: 397 srcs = map(strip, source) 398 else: 399 srcs = [''] 400 tgts = map(strip, target) 401 # surprisingly, os.path.commonprefix is a dumb char-by-char string 402 # operation that has nothing to do with paths. 403 com_pfx = os.path.commonprefix(srcs + tgts) 404 com_pfx_len = len(com_pfx) 405 if com_pfx: 406 # do some cleanup and sanity checking on common prefix 407 if com_pfx[-1] == ".": 408 # prefix matches all but file extension: ok 409 # back up one to change 'foo.cc -> o' to 'foo.cc -> .o' 410 com_pfx = com_pfx[0:-1] 411 elif com_pfx[-1] == "/": 412 # common prefix is directory path: OK 413 pass 414 else: 415 src0_len = len(srcs[0]) 416 tgt0_len = len(tgts[0]) 417 if src0_len == com_pfx_len: 418 # source is a substring of target, OK 419 pass 420 elif tgt0_len == com_pfx_len: 421 # target is a substring of source, need to back up to 422 # avoid empty string on RHS of arrow 423 sep_idx = com_pfx.rfind(".") 424 if sep_idx != -1: 425 com_pfx = com_pfx[0:sep_idx] 426 else: 427 com_pfx = '' 428 elif src0_len > com_pfx_len and srcs[0][com_pfx_len] == ".": 429 # still splitting at file extension: ok 430 pass 431 else: 432 # probably a fluke; ignore it 433 com_pfx = '' 434 # recalculate length in case com_pfx was modified 435 com_pfx_len = len(com_pfx) 436 def fmt(files): 437 f = map(lambda s: s[com_pfx_len:], files) 438 return ', '.join(f) 439 return self.format % (com_pfx, fmt(srcs), fmt(tgts)) 440 441Export('Transform') 442 443 444if GetOption('verbose'): 445 def MakeAction(action, string, *args, **kwargs): 446 return Action(action, *args, **kwargs) 447else: 448 MakeAction = Action 449 main['CCCOMSTR'] = Transform("CC") 450 main['CXXCOMSTR'] = Transform("CXX") 451 main['ASCOMSTR'] = Transform("AS") 452 main['SWIGCOMSTR'] = Transform("SWIG") 453 main['ARCOMSTR'] = Transform("AR", 0) 454 main['LINKCOMSTR'] = Transform("LINK", 0) 455 main['RANLIBCOMSTR'] = Transform("RANLIB", 0) 456 main['M4COMSTR'] = Transform("M4") 457 main['SHCCCOMSTR'] = Transform("SHCC") 458 main['SHCXXCOMSTR'] = Transform("SHCXX") 459Export('MakeAction') 460 461CXX_version = readCommand([main['CXX'],'--version'], exception=False) 462CXX_V = readCommand([main['CXX'],'-V'], exception=False) 463 464main['GCC'] = CXX_version and CXX_version.find('g++') >= 0 465main['SUNCC'] = CXX_V and CXX_V.find('Sun C++') >= 0 466main['ICC'] = CXX_V and CXX_V.find('Intel') >= 0 467if main['GCC'] + main['SUNCC'] + main['ICC'] > 1: 468 print 'Error: How can we have two at the same time?' 469 Exit(1) 470 471# Set up default C++ compiler flags 472if main['GCC']: 473 main.Append(CCFLAGS=['-pipe']) 474 main.Append(CCFLAGS=['-fno-strict-aliasing']) 475 main.Append(CCFLAGS=['-Wall', '-Wno-sign-compare', '-Wundef']) 476 main.Append(CXXFLAGS=['-Wno-deprecated']) 477 # Read the GCC version to check for versions with bugs 478 # Note CCVERSION doesn't work here because it is run with the CC 479 # before we override it from the command line 480 gcc_version = readCommand([main['CXX'], '-dumpversion'], exception=False) 481 if not compareVersions(gcc_version, '4.4.1') or \ 482 not compareVersions(gcc_version, '4.4.2'): 483 print 'Info: Tree vectorizer in GCC 4.4.1 & 4.4.2 is buggy, disabling.' 484 main.Append(CCFLAGS=['-fno-tree-vectorize']) 485elif main['ICC']: 486 pass #Fix me... add warning flags once we clean up icc warnings 487elif main['SUNCC']: 488 main.Append(CCFLAGS=['-Qoption ccfe']) 489 main.Append(CCFLAGS=['-features=gcc']) 490 main.Append(CCFLAGS=['-features=extensions']) 491 main.Append(CCFLAGS=['-library=stlport4']) 492 main.Append(CCFLAGS=['-xar']) 493 #main.Append(CCFLAGS=['-instances=semiexplicit']) 494else: 495 print 'Error: Don\'t know what compiler options to use for your compiler.' 496 print ' Please fix SConstruct and src/SConscript and try again.' 497 Exit(1) 498 499# Set up common yacc/bison flags (needed for Ruby) 500main['YACCFLAGS'] = '-d' 501main['YACCHXXFILESUFFIX'] = '.hh' 502 503# Do this after we save setting back, or else we'll tack on an 504# extra 'qdo' every time we run scons. 505if main['BATCH']: 506 main['CC'] = main['BATCH_CMD'] + ' ' + main['CC'] 507 main['CXX'] = main['BATCH_CMD'] + ' ' + main['CXX'] 508 main['AS'] = main['BATCH_CMD'] + ' ' + main['AS'] 509 main['AR'] = main['BATCH_CMD'] + ' ' + main['AR'] 510 main['RANLIB'] = main['BATCH_CMD'] + ' ' + main['RANLIB'] 511 512if sys.platform == 'cygwin': 513 # cygwin has some header file issues... 514 main.Append(CCFLAGS=["-Wno-uninitialized"]) 515 516# Check for SWIG 517if not main.has_key('SWIG'): 518 print 'Error: SWIG utility not found.' 519 print ' Please install (see http://www.swig.org) and retry.' 520 Exit(1) 521 522# Check for appropriate SWIG version 523swig_version = readCommand(('swig', '-version'), exception='').split() 524# First 3 words should be "SWIG Version x.y.z" 525if len(swig_version) < 3 or \ 526 swig_version[0] != 'SWIG' or swig_version[1] != 'Version': 527 print 'Error determining SWIG version.' 528 Exit(1) 529 530min_swig_version = '1.3.28' 531if compareVersions(swig_version[2], min_swig_version) < 0: 532 print 'Error: SWIG version', min_swig_version, 'or newer required.' 533 print ' Installed version:', swig_version[2] 534 Exit(1) 535 536# Set up SWIG flags & scanner 537swig_flags=Split('-c++ -python -modern -templatereduce $_CPPINCFLAGS') 538main.Append(SWIGFLAGS=swig_flags) 539 540# filter out all existing swig scanners, they mess up the dependency 541# stuff for some reason 542scanners = [] 543for scanner in main['SCANNERS']: 544 skeys = scanner.skeys 545 if skeys == '.i': 546 continue 547 548 if isinstance(skeys, (list, tuple)) and '.i' in skeys: 549 continue 550 551 scanners.append(scanner) 552 553# add the new swig scanner that we like better 554from SCons.Scanner import ClassicCPP as CPPScanner 555swig_inc_re = '^[ \t]*[%,#][ \t]*(?:include|import)[ \t]*(<|")([^>"]+)(>|")' 556scanners.append(CPPScanner("SwigScan", [ ".i" ], "CPPPATH", swig_inc_re)) 557 558# replace the scanners list that has what we want 559main['SCANNERS'] = scanners 560 561# Add a custom Check function to the Configure context so that we can 562# figure out if the compiler adds leading underscores to global 563# variables. This is needed for the autogenerated asm files that we 564# use for embedding the python code. 565def CheckLeading(context): 566 context.Message("Checking for leading underscore in global variables...") 567 # 1) Define a global variable called x from asm so the C compiler 568 # won't change the symbol at all. 569 # 2) Declare that variable. 570 # 3) Use the variable 571 # 572 # If the compiler prepends an underscore, this will successfully 573 # link because the external symbol 'x' will be called '_x' which 574 # was defined by the asm statement. If the compiler does not 575 # prepend an underscore, this will not successfully link because 576 # '_x' will have been defined by assembly, while the C portion of 577 # the code will be trying to use 'x' 578 ret = context.TryLink(''' 579 asm(".globl _x; _x: .byte 0"); 580 extern int x; 581 int main() { return x; } 582 ''', extension=".c") 583 context.env.Append(LEADING_UNDERSCORE=ret) 584 context.Result(ret) 585 return ret 586 587# Platform-specific configuration. Note again that we assume that all 588# builds under a given build root run on the same host platform. 589conf = Configure(main, 590 conf_dir = joinpath(build_root, '.scons_config'), 591 log_file = joinpath(build_root, 'scons_config.log'), 592 custom_tests = { 'CheckLeading' : CheckLeading }) 593 594# Check for leading underscores. Don't really need to worry either 595# way so don't need to check the return code. 596conf.CheckLeading() 597 598# Check if we should compile a 64 bit binary on Mac OS X/Darwin 599try: 600 import platform 601 uname = platform.uname() 602 if uname[0] == 'Darwin' and compareVersions(uname[2], '9.0.0') >= 0: 603 if int(readCommand('sysctl -n hw.cpu64bit_capable')[0]): 604 main.Append(CCFLAGS=['-arch', 'x86_64']) 605 main.Append(CFLAGS=['-arch', 'x86_64']) 606 main.Append(LINKFLAGS=['-arch', 'x86_64']) 607 main.Append(ASFLAGS=['-arch', 'x86_64']) 608except: 609 pass 610 611# Recent versions of scons substitute a "Null" object for Configure() 612# when configuration isn't necessary, e.g., if the "--help" option is 613# present. Unfortuantely this Null object always returns false, 614# breaking all our configuration checks. We replace it with our own 615# more optimistic null object that returns True instead. 616if not conf: 617 def NullCheck(*args, **kwargs): 618 return True 619 620 class NullConf: 621 def __init__(self, env): 622 self.env = env 623 def Finish(self): 624 return self.env 625 def __getattr__(self, mname): 626 return NullCheck 627 628 conf = NullConf(main) 629 630# Find Python include and library directories for embedding the 631# interpreter. For consistency, we will use the same Python 632# installation used to run scons (and thus this script). If you want 633# to link in an alternate version, see above for instructions on how 634# to invoke scons with a different copy of the Python interpreter. 635from distutils import sysconfig 636 637py_getvar = sysconfig.get_config_var 638 639py_debug = getattr(sys, 'pydebug', False) 640py_version = 'python' + py_getvar('VERSION') + (py_debug and "_d" or "") 641 642py_general_include = sysconfig.get_python_inc() 643py_platform_include = sysconfig.get_python_inc(plat_specific=True) 644py_includes = [ py_general_include ] 645if py_platform_include != py_general_include: 646 py_includes.append(py_platform_include) 647 648py_lib_path = [ py_getvar('LIBDIR') ] 649# add the prefix/lib/pythonX.Y/config dir, but only if there is no 650# shared library in prefix/lib/. 651if not py_getvar('Py_ENABLE_SHARED'): 652 py_lib_path.append(py_getvar('LIBPL')) 653 654py_libs = [] 655for lib in py_getvar('LIBS').split() + py_getvar('SYSLIBS').split(): 656 assert lib.startswith('-l') 657 lib = lib[2:] 658 if lib not in py_libs: 659 py_libs.append(lib) 660py_libs.append(py_version) 661 662main.Append(CPPPATH=py_includes) 663main.Append(LIBPATH=py_lib_path) 664 665# Cache build files in the supplied directory. 666if main['M5_BUILD_CACHE']: 667 print 'Using build cache located at', main['M5_BUILD_CACHE'] 668 CacheDir(main['M5_BUILD_CACHE']) 669 670 671# verify that this stuff works 672if not conf.CheckHeader('Python.h', '<>'): 673 print "Error: can't find Python.h header in", py_includes 674 Exit(1) 675 676for lib in py_libs: 677 if not conf.CheckLib(lib): 678 print "Error: can't find library %s required by python" % lib 679 Exit(1) 680 681# On Solaris you need to use libsocket for socket ops 682if not conf.CheckLibWithHeader(None, 'sys/socket.h', 'C++', 'accept(0,0,0);'): 683 if not conf.CheckLibWithHeader('socket', 'sys/socket.h', 'C++', 'accept(0,0,0);'): 684 print "Can't find library with socket calls (e.g. accept())" 685 Exit(1) 686 687# Check for zlib. If the check passes, libz will be automatically 688# added to the LIBS environment variable. 689if not conf.CheckLibWithHeader('z', 'zlib.h', 'C++','zlibVersion();'): 690 print 'Error: did not find needed zlib compression library '\ 691 'and/or zlib.h header file.' 692 print ' Please install zlib and try again.' 693 Exit(1) 694 695# Check for librt. 696have_posix_clock = \ 697 conf.CheckLibWithHeader(None, 'time.h', 'C', 698 'clock_nanosleep(0,0,NULL,NULL);') or \ 699 conf.CheckLibWithHeader('rt', 'time.h', 'C', 700 'clock_nanosleep(0,0,NULL,NULL);') 701 702if not have_posix_clock: 703 print "Can't find library for POSIX clocks." 704 705# Check for <fenv.h> (C99 FP environment control) 706have_fenv = conf.CheckHeader('fenv.h', '<>') 707if not have_fenv: 708 print "Warning: Header file <fenv.h> not found." 709 print " This host has no IEEE FP rounding mode control." 710 711###################################################################### 712# 713# Finish the configuration 714# 715main = conf.Finish() 716 717###################################################################### 718# 719# Collect all non-global variables 720# 721 722# Define the universe of supported ISAs 723all_isa_list = [ ] 724Export('all_isa_list') 725 726class CpuModel(object): 727 '''The CpuModel class encapsulates everything the ISA parser needs to 728 know about a particular CPU model.''' 729 730 # Dict of available CPU model objects. Accessible as CpuModel.dict. 731 dict = {} 732 list = [] 733 defaults = [] 734 735 # Constructor. Automatically adds models to CpuModel.dict. 736 def __init__(self, name, filename, includes, strings, default=False): 737 self.name = name # name of model 738 self.filename = filename # filename for output exec code 739 self.includes = includes # include files needed in exec file 740 # The 'strings' dict holds all the per-CPU symbols we can 741 # substitute into templates etc. 742 self.strings = strings 743 744 # This cpu is enabled by default 745 self.default = default 746 747 # Add self to dict 748 if name in CpuModel.dict: 749 raise AttributeError, "CpuModel '%s' already registered" % name 750 CpuModel.dict[name] = self 751 CpuModel.list.append(name) 752 753Export('CpuModel') 754 755# Sticky variables get saved in the variables file so they persist from 756# one invocation to the next (unless overridden, in which case the new 757# value becomes sticky). 758sticky_vars = Variables(args=ARGUMENTS) 759Export('sticky_vars') 760 761# Sticky variables that should be exported 762export_vars = [] 763Export('export_vars') 764 765# Walk the tree and execute all SConsopts scripts that wil add to the 766# above variables 767for bdir in [ base_dir ] + extras_dir_list: 768 if not isdir(bdir): 769 print "Error: directory '%s' does not exist" % bdir 770 Exit(1) 771 for root, dirs, files in os.walk(bdir): 772 if 'SConsopts' in files: 773 print "Reading", joinpath(root, 'SConsopts') 774 SConscript(joinpath(root, 'SConsopts')) 775 776all_isa_list.sort() 777 778sticky_vars.AddVariables( 779 EnumVariable('TARGET_ISA', 'Target ISA', 'alpha', all_isa_list), 780 BoolVariable('FULL_SYSTEM', 'Full-system support', False), 781 ListVariable('CPU_MODELS', 'CPU models', 782 sorted(n for n,m in CpuModel.dict.iteritems() if m.default), 783 sorted(CpuModel.list)), 784 BoolVariable('NO_FAST_ALLOC', 'Disable fast object allocator', False), 785 BoolVariable('FORCE_FAST_ALLOC', 786 'Enable fast object allocator, even for m5.debug', False), 787 BoolVariable('FAST_ALLOC_STATS', 'Enable fast object allocator statistics', 788 False), 789 BoolVariable('EFENCE', 'Link with Electric Fence malloc debugger', 790 False), 791 BoolVariable('SS_COMPATIBLE_FP', 792 'Make floating-point results compatible with SimpleScalar', 793 False), 794 BoolVariable('USE_SSE2', 795 'Compile for SSE2 (-msse2) to get IEEE FP on x86 hosts', 796 False), 797 BoolVariable('USE_POSIX_CLOCK', 'Use POSIX Clocks', have_posix_clock), 798 BoolVariable('USE_FENV', 'Use <fenv.h> IEEE mode control', have_fenv), 799 BoolVariable('USE_CHECKER', 'Use checker for detailed CPU models', False), 800 BoolVariable('CP_ANNOTATE', 'Enable critical path annotation capability', False), 801 BoolVariable('RUBY', 'Build with Ruby', False), 802 ) 803 804# These variables get exported to #defines in config/*.hh (see src/SConscript). 805export_vars += ['FULL_SYSTEM', 'USE_FENV', 806 'NO_FAST_ALLOC', 'FORCE_FAST_ALLOC', 'FAST_ALLOC_STATS', 807 'SS_COMPATIBLE_FP', 'USE_CHECKER', 'TARGET_ISA', 'CP_ANNOTATE', 808 'USE_POSIX_CLOCK' ] 809 810################################################### 811# 812# Define a SCons builder for configuration flag headers. 813# 814################################################### 815 816# This function generates a config header file that #defines the 817# variable symbol to the current variable setting (0 or 1). The source 818# operands are the name of the variable and a Value node containing the 819# value of the variable. 820def build_config_file(target, source, env): 821 (variable, value) = [s.get_contents() for s in source] 822 f = file(str(target[0]), 'w') 823 print >> f, '#define', variable, value 824 f.close() 825 return None 826 827# Generate the message to be printed when building the config file. 828def build_config_file_string(target, source, env): 829 (variable, value) = [s.get_contents() for s in source] 830 return "Defining %s as %s in %s." % (variable, value, target[0]) 831 832# Combine the two functions into a scons Action object. 833config_action = Action(build_config_file, build_config_file_string) 834 835# The emitter munges the source & target node lists to reflect what 836# we're really doing. 837def config_emitter(target, source, env): 838 # extract variable name from Builder arg 839 variable = str(target[0]) 840 # True target is config header file 841 target = joinpath('config', variable.lower() + '.hh') 842 val = env[variable] 843 if isinstance(val, bool): 844 # Force value to 0/1 845 val = int(val) 846 elif isinstance(val, str): 847 val = '"' + val + '"' 848 849 # Sources are variable name & value (packaged in SCons Value nodes) 850 return ([target], [Value(variable), Value(val)]) 851 852config_builder = Builder(emitter = config_emitter, action = config_action) 853 854main.Append(BUILDERS = { 'ConfigFile' : config_builder }) 855 856# libelf build is shared across all configs in the build root. 857main.SConscript('ext/libelf/SConscript', 858 variant_dir = joinpath(build_root, 'libelf')) 859 860# gzstream build is shared across all configs in the build root. 861main.SConscript('ext/gzstream/SConscript', 862 variant_dir = joinpath(build_root, 'gzstream')) 863 864################################################### 865# 866# This function is used to set up a directory with switching headers 867# 868################################################### 869 870main['ALL_ISA_LIST'] = all_isa_list 871def make_switching_dir(dname, switch_headers, env): 872 # Generate the header. target[0] is the full path of the output 873 # header to generate. 'source' is a dummy variable, since we get the 874 # list of ISAs from env['ALL_ISA_LIST']. 875 def gen_switch_hdr(target, source, env): 876 fname = str(target[0]) 877 f = open(fname, 'w') 878 isa = env['TARGET_ISA'].lower() 879 print >>f, '#include "%s/%s/%s"' % (dname, isa, basename(fname)) 880 f.close() 881 882 # Build SCons Action object. 'varlist' specifies env vars that this 883 # action depends on; when env['ALL_ISA_LIST'] changes these actions 884 # should get re-executed. 885 switch_hdr_action = MakeAction(gen_switch_hdr, 886 Transform("GENERATE"), varlist=['ALL_ISA_LIST']) 887 888 # Instantiate actions for each header 889 for hdr in switch_headers: 890 env.Command(hdr, [], switch_hdr_action) 891Export('make_switching_dir') 892 893################################################### 894# 895# Define build environments for selected configurations. 896# 897################################################### 898 899for variant_path in variant_paths: 900 print "Building in", variant_path 901 902 # Make a copy of the build-root environment to use for this config. 903 env = main.Clone() 904 env['BUILDDIR'] = variant_path 905 906 # variant_dir is the tail component of build path, and is used to 907 # determine the build parameters (e.g., 'ALPHA_SE') 908 (build_root, variant_dir) = splitpath(variant_path) 909 910 # Set env variables according to the build directory config. 911 sticky_vars.files = [] 912 # Variables for $BUILD_ROOT/$VARIANT_DIR are stored in 913 # $BUILD_ROOT/variables/$VARIANT_DIR so you can nuke 914 # $BUILD_ROOT/$VARIANT_DIR without losing your variables settings. 915 current_vars_file = joinpath(build_root, 'variables', variant_dir) 916 if isfile(current_vars_file): 917 sticky_vars.files.append(current_vars_file) 918 print "Using saved variables file %s" % current_vars_file 919 else: 920 # Build dir-specific variables file doesn't exist. 921 922 # Make sure the directory is there so we can create it later 923 opt_dir = dirname(current_vars_file) 924 if not isdir(opt_dir): 925 mkdir(opt_dir) 926 927 # Get default build variables from source tree. Variables are 928 # normally determined by name of $VARIANT_DIR, but can be 929 # overridden by '--default=' arg on command line. 930 default = GetOption('default') 931 opts_dir = joinpath(main.root.abspath, 'build_opts') 932 if default: 933 default_vars_files = [joinpath(build_root, 'variables', default), 934 joinpath(opts_dir, default)] 935 else: 936 default_vars_files = [joinpath(opts_dir, variant_dir)] 937 existing_files = filter(isfile, default_vars_files) 938 if existing_files: 939 default_vars_file = existing_files[0] 940 sticky_vars.files.append(default_vars_file) 941 print "Variables file %s not found,\n using defaults in %s" \ 942 % (current_vars_file, default_vars_file) 943 else: 944 print "Error: cannot find variables file %s or " \ 945 "default file(s) %s" \ 946 % (current_vars_file, ' or '.join(default_vars_files)) 947 Exit(1) 948 949 # Apply current variable settings to env 950 sticky_vars.Update(env) 951 952 help_texts["local_vars"] += \ 953 "Build variables for %s:\n" % variant_dir \ 954 + sticky_vars.GenerateHelpText(env) 955 956 # Process variable settings. 957 958 if not have_fenv and env['USE_FENV']: 959 print "Warning: <fenv.h> not available; " \ 960 "forcing USE_FENV to False in", variant_dir + "." 961 env['USE_FENV'] = False 962 963 if not env['USE_FENV']: 964 print "Warning: No IEEE FP rounding mode control in", variant_dir + "." 965 print " FP results may deviate slightly from other platforms." 966 967 if env['EFENCE']: 968 env.Append(LIBS=['efence']) 969 970 # Save sticky variable settings back to current variables file 971 sticky_vars.Save(current_vars_file, env) 972 973 if env['USE_SSE2']: 974 env.Append(CCFLAGS=['-msse2']) 975 976 # The src/SConscript file sets up the build rules in 'env' according 977 # to the configured variables. It returns a list of environments, 978 # one for each variant build (debug, opt, etc.) 979 envList = SConscript('src/SConscript', variant_dir = variant_path, 980 exports = 'env') 981 982 # Set up the regression tests for each build. 983 for e in envList: 984 SConscript('tests/SConscript', 985 variant_dir = joinpath(variant_path, 'tests', e.Label), 986 exports = { 'env' : e }, duplicate = False) 987 988# base help text 989Help(''' 990Usage: scons [scons options] [build variables] [target(s)] 991 992Extra scons options: 993%(options)s 994 995Global build variables: 996%(global_vars)s 997 998%(local_vars)s 999''' % help_texts)
| 259################################################### 260# 261# Figure out which configurations to set up based on the path(s) of 262# the target(s). 263# 264################################################### 265 266# Find default configuration & binary. 267Default(environ.get('M5_DEFAULT_BINARY', 'build/ALPHA_SE/m5.debug')) 268 269# helper function: find last occurrence of element in list 270def rfind(l, elt, offs = -1): 271 for i in range(len(l)+offs, 0, -1): 272 if l[i] == elt: 273 return i 274 raise ValueError, "element not found" 275 276# Take a list of paths (or SCons Nodes) and return a list with all 277# paths made absolute and ~-expanded. Paths will be interpreted 278# relative to the launch directory unless a different root is provided 279def makePathListAbsolute(path_list, root=GetLaunchDir()): 280 return [abspath(joinpath(root, expanduser(str(p)))) 281 for p in path_list] 282 283# Each target must have 'build' in the interior of the path; the 284# directory below this will determine the build parameters. For 285# example, for target 'foo/bar/build/ALPHA_SE/arch/alpha/blah.do' we 286# recognize that ALPHA_SE specifies the configuration because it 287# follow 'build' in the build path. 288 289# The funky assignment to "[:]" is needed to replace the list contents 290# in place rather than reassign the symbol to a new list, which 291# doesn't work (obviously!). 292BUILD_TARGETS[:] = makePathListAbsolute(BUILD_TARGETS) 293 294# Generate a list of the unique build roots and configs that the 295# collected targets reference. 296variant_paths = [] 297build_root = None 298for t in BUILD_TARGETS: 299 path_dirs = t.split('/') 300 try: 301 build_top = rfind(path_dirs, 'build', -2) 302 except: 303 print "Error: no non-leaf 'build' dir found on target path", t 304 Exit(1) 305 this_build_root = joinpath('/',*path_dirs[:build_top+1]) 306 if not build_root: 307 build_root = this_build_root 308 else: 309 if this_build_root != build_root: 310 print "Error: build targets not under same build root\n"\ 311 " %s\n %s" % (build_root, this_build_root) 312 Exit(1) 313 variant_path = joinpath('/',*path_dirs[:build_top+2]) 314 if variant_path not in variant_paths: 315 variant_paths.append(variant_path) 316 317# Make sure build_root exists (might not if this is the first build there) 318if not isdir(build_root): 319 mkdir(build_root) 320main['BUILDROOT'] = build_root 321 322Export('main') 323 324main.SConsignFile(joinpath(build_root, "sconsign")) 325 326# Default duplicate option is to use hard links, but this messes up 327# when you use emacs to edit a file in the target dir, as emacs moves 328# file to file~ then copies to file, breaking the link. Symbolic 329# (soft) links work better. 330main.SetOption('duplicate', 'soft-copy') 331 332# 333# Set up global sticky variables... these are common to an entire build 334# tree (not specific to a particular build like ALPHA_SE) 335# 336 337global_vars_file = joinpath(build_root, 'variables.global') 338 339global_vars = Variables(global_vars_file, args=ARGUMENTS) 340 341global_vars.AddVariables( 342 ('CC', 'C compiler', environ.get('CC', main['CC'])), 343 ('CXX', 'C++ compiler', environ.get('CXX', main['CXX'])), 344 ('BATCH', 'Use batch pool for build and tests', False), 345 ('BATCH_CMD', 'Batch pool submission command name', 'qdo'), 346 ('M5_BUILD_CACHE', 'Cache built objects in this directory', False), 347 ('EXTRAS', 'Add extra directories to the compilation', '') 348 ) 349 350# Update main environment with values from ARGUMENTS & global_vars_file 351global_vars.Update(main) 352help_texts["global_vars"] += global_vars.GenerateHelpText(main) 353 354# Save sticky variable settings back to current variables file 355global_vars.Save(global_vars_file, main) 356 357# Parse EXTRAS variable to build list of all directories where we're 358# look for sources etc. This list is exported as extras_dir_list. 359base_dir = main.srcdir.abspath 360if main['EXTRAS']: 361 extras_dir_list = makePathListAbsolute(main['EXTRAS'].split(':')) 362else: 363 extras_dir_list = [] 364 365Export('base_dir') 366Export('extras_dir_list') 367 368# the ext directory should be on the #includes path 369main.Append(CPPPATH=[Dir('ext')]) 370 371def strip_build_path(path, env): 372 path = str(path) 373 variant_base = env['BUILDROOT'] + os.path.sep 374 if path.startswith(variant_base): 375 path = path[len(variant_base):] 376 elif path.startswith('build/'): 377 path = path[6:] 378 return path 379 380# Generate a string of the form: 381# common/path/prefix/src1, src2 -> tgt1, tgt2 382# to print while building. 383class Transform(object): 384 # all specific color settings should be here and nowhere else 385 tool_color = termcap.Normal 386 pfx_color = termcap.Yellow 387 srcs_color = termcap.Yellow + termcap.Bold 388 arrow_color = termcap.Blue + termcap.Bold 389 tgts_color = termcap.Yellow + termcap.Bold 390 391 def __init__(self, tool, max_sources=99): 392 self.format = self.tool_color + (" [%8s] " % tool) \ 393 + self.pfx_color + "%s" \ 394 + self.srcs_color + "%s" \ 395 + self.arrow_color + " -> " \ 396 + self.tgts_color + "%s" \ 397 + termcap.Normal 398 self.max_sources = max_sources 399 400 def __call__(self, target, source, env, for_signature=None): 401 # truncate source list according to max_sources param 402 source = source[0:self.max_sources] 403 def strip(f): 404 return strip_build_path(str(f), env) 405 if len(source) > 0: 406 srcs = map(strip, source) 407 else: 408 srcs = [''] 409 tgts = map(strip, target) 410 # surprisingly, os.path.commonprefix is a dumb char-by-char string 411 # operation that has nothing to do with paths. 412 com_pfx = os.path.commonprefix(srcs + tgts) 413 com_pfx_len = len(com_pfx) 414 if com_pfx: 415 # do some cleanup and sanity checking on common prefix 416 if com_pfx[-1] == ".": 417 # prefix matches all but file extension: ok 418 # back up one to change 'foo.cc -> o' to 'foo.cc -> .o' 419 com_pfx = com_pfx[0:-1] 420 elif com_pfx[-1] == "/": 421 # common prefix is directory path: OK 422 pass 423 else: 424 src0_len = len(srcs[0]) 425 tgt0_len = len(tgts[0]) 426 if src0_len == com_pfx_len: 427 # source is a substring of target, OK 428 pass 429 elif tgt0_len == com_pfx_len: 430 # target is a substring of source, need to back up to 431 # avoid empty string on RHS of arrow 432 sep_idx = com_pfx.rfind(".") 433 if sep_idx != -1: 434 com_pfx = com_pfx[0:sep_idx] 435 else: 436 com_pfx = '' 437 elif src0_len > com_pfx_len and srcs[0][com_pfx_len] == ".": 438 # still splitting at file extension: ok 439 pass 440 else: 441 # probably a fluke; ignore it 442 com_pfx = '' 443 # recalculate length in case com_pfx was modified 444 com_pfx_len = len(com_pfx) 445 def fmt(files): 446 f = map(lambda s: s[com_pfx_len:], files) 447 return ', '.join(f) 448 return self.format % (com_pfx, fmt(srcs), fmt(tgts)) 449 450Export('Transform') 451 452 453if GetOption('verbose'): 454 def MakeAction(action, string, *args, **kwargs): 455 return Action(action, *args, **kwargs) 456else: 457 MakeAction = Action 458 main['CCCOMSTR'] = Transform("CC") 459 main['CXXCOMSTR'] = Transform("CXX") 460 main['ASCOMSTR'] = Transform("AS") 461 main['SWIGCOMSTR'] = Transform("SWIG") 462 main['ARCOMSTR'] = Transform("AR", 0) 463 main['LINKCOMSTR'] = Transform("LINK", 0) 464 main['RANLIBCOMSTR'] = Transform("RANLIB", 0) 465 main['M4COMSTR'] = Transform("M4") 466 main['SHCCCOMSTR'] = Transform("SHCC") 467 main['SHCXXCOMSTR'] = Transform("SHCXX") 468Export('MakeAction') 469 470CXX_version = readCommand([main['CXX'],'--version'], exception=False) 471CXX_V = readCommand([main['CXX'],'-V'], exception=False) 472 473main['GCC'] = CXX_version and CXX_version.find('g++') >= 0 474main['SUNCC'] = CXX_V and CXX_V.find('Sun C++') >= 0 475main['ICC'] = CXX_V and CXX_V.find('Intel') >= 0 476if main['GCC'] + main['SUNCC'] + main['ICC'] > 1: 477 print 'Error: How can we have two at the same time?' 478 Exit(1) 479 480# Set up default C++ compiler flags 481if main['GCC']: 482 main.Append(CCFLAGS=['-pipe']) 483 main.Append(CCFLAGS=['-fno-strict-aliasing']) 484 main.Append(CCFLAGS=['-Wall', '-Wno-sign-compare', '-Wundef']) 485 main.Append(CXXFLAGS=['-Wno-deprecated']) 486 # Read the GCC version to check for versions with bugs 487 # Note CCVERSION doesn't work here because it is run with the CC 488 # before we override it from the command line 489 gcc_version = readCommand([main['CXX'], '-dumpversion'], exception=False) 490 if not compareVersions(gcc_version, '4.4.1') or \ 491 not compareVersions(gcc_version, '4.4.2'): 492 print 'Info: Tree vectorizer in GCC 4.4.1 & 4.4.2 is buggy, disabling.' 493 main.Append(CCFLAGS=['-fno-tree-vectorize']) 494elif main['ICC']: 495 pass #Fix me... add warning flags once we clean up icc warnings 496elif main['SUNCC']: 497 main.Append(CCFLAGS=['-Qoption ccfe']) 498 main.Append(CCFLAGS=['-features=gcc']) 499 main.Append(CCFLAGS=['-features=extensions']) 500 main.Append(CCFLAGS=['-library=stlport4']) 501 main.Append(CCFLAGS=['-xar']) 502 #main.Append(CCFLAGS=['-instances=semiexplicit']) 503else: 504 print 'Error: Don\'t know what compiler options to use for your compiler.' 505 print ' Please fix SConstruct and src/SConscript and try again.' 506 Exit(1) 507 508# Set up common yacc/bison flags (needed for Ruby) 509main['YACCFLAGS'] = '-d' 510main['YACCHXXFILESUFFIX'] = '.hh' 511 512# Do this after we save setting back, or else we'll tack on an 513# extra 'qdo' every time we run scons. 514if main['BATCH']: 515 main['CC'] = main['BATCH_CMD'] + ' ' + main['CC'] 516 main['CXX'] = main['BATCH_CMD'] + ' ' + main['CXX'] 517 main['AS'] = main['BATCH_CMD'] + ' ' + main['AS'] 518 main['AR'] = main['BATCH_CMD'] + ' ' + main['AR'] 519 main['RANLIB'] = main['BATCH_CMD'] + ' ' + main['RANLIB'] 520 521if sys.platform == 'cygwin': 522 # cygwin has some header file issues... 523 main.Append(CCFLAGS=["-Wno-uninitialized"]) 524 525# Check for SWIG 526if not main.has_key('SWIG'): 527 print 'Error: SWIG utility not found.' 528 print ' Please install (see http://www.swig.org) and retry.' 529 Exit(1) 530 531# Check for appropriate SWIG version 532swig_version = readCommand(('swig', '-version'), exception='').split() 533# First 3 words should be "SWIG Version x.y.z" 534if len(swig_version) < 3 or \ 535 swig_version[0] != 'SWIG' or swig_version[1] != 'Version': 536 print 'Error determining SWIG version.' 537 Exit(1) 538 539min_swig_version = '1.3.28' 540if compareVersions(swig_version[2], min_swig_version) < 0: 541 print 'Error: SWIG version', min_swig_version, 'or newer required.' 542 print ' Installed version:', swig_version[2] 543 Exit(1) 544 545# Set up SWIG flags & scanner 546swig_flags=Split('-c++ -python -modern -templatereduce $_CPPINCFLAGS') 547main.Append(SWIGFLAGS=swig_flags) 548 549# filter out all existing swig scanners, they mess up the dependency 550# stuff for some reason 551scanners = [] 552for scanner in main['SCANNERS']: 553 skeys = scanner.skeys 554 if skeys == '.i': 555 continue 556 557 if isinstance(skeys, (list, tuple)) and '.i' in skeys: 558 continue 559 560 scanners.append(scanner) 561 562# add the new swig scanner that we like better 563from SCons.Scanner import ClassicCPP as CPPScanner 564swig_inc_re = '^[ \t]*[%,#][ \t]*(?:include|import)[ \t]*(<|")([^>"]+)(>|")' 565scanners.append(CPPScanner("SwigScan", [ ".i" ], "CPPPATH", swig_inc_re)) 566 567# replace the scanners list that has what we want 568main['SCANNERS'] = scanners 569 570# Add a custom Check function to the Configure context so that we can 571# figure out if the compiler adds leading underscores to global 572# variables. This is needed for the autogenerated asm files that we 573# use for embedding the python code. 574def CheckLeading(context): 575 context.Message("Checking for leading underscore in global variables...") 576 # 1) Define a global variable called x from asm so the C compiler 577 # won't change the symbol at all. 578 # 2) Declare that variable. 579 # 3) Use the variable 580 # 581 # If the compiler prepends an underscore, this will successfully 582 # link because the external symbol 'x' will be called '_x' which 583 # was defined by the asm statement. If the compiler does not 584 # prepend an underscore, this will not successfully link because 585 # '_x' will have been defined by assembly, while the C portion of 586 # the code will be trying to use 'x' 587 ret = context.TryLink(''' 588 asm(".globl _x; _x: .byte 0"); 589 extern int x; 590 int main() { return x; } 591 ''', extension=".c") 592 context.env.Append(LEADING_UNDERSCORE=ret) 593 context.Result(ret) 594 return ret 595 596# Platform-specific configuration. Note again that we assume that all 597# builds under a given build root run on the same host platform. 598conf = Configure(main, 599 conf_dir = joinpath(build_root, '.scons_config'), 600 log_file = joinpath(build_root, 'scons_config.log'), 601 custom_tests = { 'CheckLeading' : CheckLeading }) 602 603# Check for leading underscores. Don't really need to worry either 604# way so don't need to check the return code. 605conf.CheckLeading() 606 607# Check if we should compile a 64 bit binary on Mac OS X/Darwin 608try: 609 import platform 610 uname = platform.uname() 611 if uname[0] == 'Darwin' and compareVersions(uname[2], '9.0.0') >= 0: 612 if int(readCommand('sysctl -n hw.cpu64bit_capable')[0]): 613 main.Append(CCFLAGS=['-arch', 'x86_64']) 614 main.Append(CFLAGS=['-arch', 'x86_64']) 615 main.Append(LINKFLAGS=['-arch', 'x86_64']) 616 main.Append(ASFLAGS=['-arch', 'x86_64']) 617except: 618 pass 619 620# Recent versions of scons substitute a "Null" object for Configure() 621# when configuration isn't necessary, e.g., if the "--help" option is 622# present. Unfortuantely this Null object always returns false, 623# breaking all our configuration checks. We replace it with our own 624# more optimistic null object that returns True instead. 625if not conf: 626 def NullCheck(*args, **kwargs): 627 return True 628 629 class NullConf: 630 def __init__(self, env): 631 self.env = env 632 def Finish(self): 633 return self.env 634 def __getattr__(self, mname): 635 return NullCheck 636 637 conf = NullConf(main) 638 639# Find Python include and library directories for embedding the 640# interpreter. For consistency, we will use the same Python 641# installation used to run scons (and thus this script). If you want 642# to link in an alternate version, see above for instructions on how 643# to invoke scons with a different copy of the Python interpreter. 644from distutils import sysconfig 645 646py_getvar = sysconfig.get_config_var 647 648py_debug = getattr(sys, 'pydebug', False) 649py_version = 'python' + py_getvar('VERSION') + (py_debug and "_d" or "") 650 651py_general_include = sysconfig.get_python_inc() 652py_platform_include = sysconfig.get_python_inc(plat_specific=True) 653py_includes = [ py_general_include ] 654if py_platform_include != py_general_include: 655 py_includes.append(py_platform_include) 656 657py_lib_path = [ py_getvar('LIBDIR') ] 658# add the prefix/lib/pythonX.Y/config dir, but only if there is no 659# shared library in prefix/lib/. 660if not py_getvar('Py_ENABLE_SHARED'): 661 py_lib_path.append(py_getvar('LIBPL')) 662 663py_libs = [] 664for lib in py_getvar('LIBS').split() + py_getvar('SYSLIBS').split(): 665 assert lib.startswith('-l') 666 lib = lib[2:] 667 if lib not in py_libs: 668 py_libs.append(lib) 669py_libs.append(py_version) 670 671main.Append(CPPPATH=py_includes) 672main.Append(LIBPATH=py_lib_path) 673 674# Cache build files in the supplied directory. 675if main['M5_BUILD_CACHE']: 676 print 'Using build cache located at', main['M5_BUILD_CACHE'] 677 CacheDir(main['M5_BUILD_CACHE']) 678 679 680# verify that this stuff works 681if not conf.CheckHeader('Python.h', '<>'): 682 print "Error: can't find Python.h header in", py_includes 683 Exit(1) 684 685for lib in py_libs: 686 if not conf.CheckLib(lib): 687 print "Error: can't find library %s required by python" % lib 688 Exit(1) 689 690# On Solaris you need to use libsocket for socket ops 691if not conf.CheckLibWithHeader(None, 'sys/socket.h', 'C++', 'accept(0,0,0);'): 692 if not conf.CheckLibWithHeader('socket', 'sys/socket.h', 'C++', 'accept(0,0,0);'): 693 print "Can't find library with socket calls (e.g. accept())" 694 Exit(1) 695 696# Check for zlib. If the check passes, libz will be automatically 697# added to the LIBS environment variable. 698if not conf.CheckLibWithHeader('z', 'zlib.h', 'C++','zlibVersion();'): 699 print 'Error: did not find needed zlib compression library '\ 700 'and/or zlib.h header file.' 701 print ' Please install zlib and try again.' 702 Exit(1) 703 704# Check for librt. 705have_posix_clock = \ 706 conf.CheckLibWithHeader(None, 'time.h', 'C', 707 'clock_nanosleep(0,0,NULL,NULL);') or \ 708 conf.CheckLibWithHeader('rt', 'time.h', 'C', 709 'clock_nanosleep(0,0,NULL,NULL);') 710 711if not have_posix_clock: 712 print "Can't find library for POSIX clocks." 713 714# Check for <fenv.h> (C99 FP environment control) 715have_fenv = conf.CheckHeader('fenv.h', '<>') 716if not have_fenv: 717 print "Warning: Header file <fenv.h> not found." 718 print " This host has no IEEE FP rounding mode control." 719 720###################################################################### 721# 722# Finish the configuration 723# 724main = conf.Finish() 725 726###################################################################### 727# 728# Collect all non-global variables 729# 730 731# Define the universe of supported ISAs 732all_isa_list = [ ] 733Export('all_isa_list') 734 735class CpuModel(object): 736 '''The CpuModel class encapsulates everything the ISA parser needs to 737 know about a particular CPU model.''' 738 739 # Dict of available CPU model objects. Accessible as CpuModel.dict. 740 dict = {} 741 list = [] 742 defaults = [] 743 744 # Constructor. Automatically adds models to CpuModel.dict. 745 def __init__(self, name, filename, includes, strings, default=False): 746 self.name = name # name of model 747 self.filename = filename # filename for output exec code 748 self.includes = includes # include files needed in exec file 749 # The 'strings' dict holds all the per-CPU symbols we can 750 # substitute into templates etc. 751 self.strings = strings 752 753 # This cpu is enabled by default 754 self.default = default 755 756 # Add self to dict 757 if name in CpuModel.dict: 758 raise AttributeError, "CpuModel '%s' already registered" % name 759 CpuModel.dict[name] = self 760 CpuModel.list.append(name) 761 762Export('CpuModel') 763 764# Sticky variables get saved in the variables file so they persist from 765# one invocation to the next (unless overridden, in which case the new 766# value becomes sticky). 767sticky_vars = Variables(args=ARGUMENTS) 768Export('sticky_vars') 769 770# Sticky variables that should be exported 771export_vars = [] 772Export('export_vars') 773 774# Walk the tree and execute all SConsopts scripts that wil add to the 775# above variables 776for bdir in [ base_dir ] + extras_dir_list: 777 if not isdir(bdir): 778 print "Error: directory '%s' does not exist" % bdir 779 Exit(1) 780 for root, dirs, files in os.walk(bdir): 781 if 'SConsopts' in files: 782 print "Reading", joinpath(root, 'SConsopts') 783 SConscript(joinpath(root, 'SConsopts')) 784 785all_isa_list.sort() 786 787sticky_vars.AddVariables( 788 EnumVariable('TARGET_ISA', 'Target ISA', 'alpha', all_isa_list), 789 BoolVariable('FULL_SYSTEM', 'Full-system support', False), 790 ListVariable('CPU_MODELS', 'CPU models', 791 sorted(n for n,m in CpuModel.dict.iteritems() if m.default), 792 sorted(CpuModel.list)), 793 BoolVariable('NO_FAST_ALLOC', 'Disable fast object allocator', False), 794 BoolVariable('FORCE_FAST_ALLOC', 795 'Enable fast object allocator, even for m5.debug', False), 796 BoolVariable('FAST_ALLOC_STATS', 'Enable fast object allocator statistics', 797 False), 798 BoolVariable('EFENCE', 'Link with Electric Fence malloc debugger', 799 False), 800 BoolVariable('SS_COMPATIBLE_FP', 801 'Make floating-point results compatible with SimpleScalar', 802 False), 803 BoolVariable('USE_SSE2', 804 'Compile for SSE2 (-msse2) to get IEEE FP on x86 hosts', 805 False), 806 BoolVariable('USE_POSIX_CLOCK', 'Use POSIX Clocks', have_posix_clock), 807 BoolVariable('USE_FENV', 'Use <fenv.h> IEEE mode control', have_fenv), 808 BoolVariable('USE_CHECKER', 'Use checker for detailed CPU models', False), 809 BoolVariable('CP_ANNOTATE', 'Enable critical path annotation capability', False), 810 BoolVariable('RUBY', 'Build with Ruby', False), 811 ) 812 813# These variables get exported to #defines in config/*.hh (see src/SConscript). 814export_vars += ['FULL_SYSTEM', 'USE_FENV', 815 'NO_FAST_ALLOC', 'FORCE_FAST_ALLOC', 'FAST_ALLOC_STATS', 816 'SS_COMPATIBLE_FP', 'USE_CHECKER', 'TARGET_ISA', 'CP_ANNOTATE', 817 'USE_POSIX_CLOCK' ] 818 819################################################### 820# 821# Define a SCons builder for configuration flag headers. 822# 823################################################### 824 825# This function generates a config header file that #defines the 826# variable symbol to the current variable setting (0 or 1). The source 827# operands are the name of the variable and a Value node containing the 828# value of the variable. 829def build_config_file(target, source, env): 830 (variable, value) = [s.get_contents() for s in source] 831 f = file(str(target[0]), 'w') 832 print >> f, '#define', variable, value 833 f.close() 834 return None 835 836# Generate the message to be printed when building the config file. 837def build_config_file_string(target, source, env): 838 (variable, value) = [s.get_contents() for s in source] 839 return "Defining %s as %s in %s." % (variable, value, target[0]) 840 841# Combine the two functions into a scons Action object. 842config_action = Action(build_config_file, build_config_file_string) 843 844# The emitter munges the source & target node lists to reflect what 845# we're really doing. 846def config_emitter(target, source, env): 847 # extract variable name from Builder arg 848 variable = str(target[0]) 849 # True target is config header file 850 target = joinpath('config', variable.lower() + '.hh') 851 val = env[variable] 852 if isinstance(val, bool): 853 # Force value to 0/1 854 val = int(val) 855 elif isinstance(val, str): 856 val = '"' + val + '"' 857 858 # Sources are variable name & value (packaged in SCons Value nodes) 859 return ([target], [Value(variable), Value(val)]) 860 861config_builder = Builder(emitter = config_emitter, action = config_action) 862 863main.Append(BUILDERS = { 'ConfigFile' : config_builder }) 864 865# libelf build is shared across all configs in the build root. 866main.SConscript('ext/libelf/SConscript', 867 variant_dir = joinpath(build_root, 'libelf')) 868 869# gzstream build is shared across all configs in the build root. 870main.SConscript('ext/gzstream/SConscript', 871 variant_dir = joinpath(build_root, 'gzstream')) 872 873################################################### 874# 875# This function is used to set up a directory with switching headers 876# 877################################################### 878 879main['ALL_ISA_LIST'] = all_isa_list 880def make_switching_dir(dname, switch_headers, env): 881 # Generate the header. target[0] is the full path of the output 882 # header to generate. 'source' is a dummy variable, since we get the 883 # list of ISAs from env['ALL_ISA_LIST']. 884 def gen_switch_hdr(target, source, env): 885 fname = str(target[0]) 886 f = open(fname, 'w') 887 isa = env['TARGET_ISA'].lower() 888 print >>f, '#include "%s/%s/%s"' % (dname, isa, basename(fname)) 889 f.close() 890 891 # Build SCons Action object. 'varlist' specifies env vars that this 892 # action depends on; when env['ALL_ISA_LIST'] changes these actions 893 # should get re-executed. 894 switch_hdr_action = MakeAction(gen_switch_hdr, 895 Transform("GENERATE"), varlist=['ALL_ISA_LIST']) 896 897 # Instantiate actions for each header 898 for hdr in switch_headers: 899 env.Command(hdr, [], switch_hdr_action) 900Export('make_switching_dir') 901 902################################################### 903# 904# Define build environments for selected configurations. 905# 906################################################### 907 908for variant_path in variant_paths: 909 print "Building in", variant_path 910 911 # Make a copy of the build-root environment to use for this config. 912 env = main.Clone() 913 env['BUILDDIR'] = variant_path 914 915 # variant_dir is the tail component of build path, and is used to 916 # determine the build parameters (e.g., 'ALPHA_SE') 917 (build_root, variant_dir) = splitpath(variant_path) 918 919 # Set env variables according to the build directory config. 920 sticky_vars.files = [] 921 # Variables for $BUILD_ROOT/$VARIANT_DIR are stored in 922 # $BUILD_ROOT/variables/$VARIANT_DIR so you can nuke 923 # $BUILD_ROOT/$VARIANT_DIR without losing your variables settings. 924 current_vars_file = joinpath(build_root, 'variables', variant_dir) 925 if isfile(current_vars_file): 926 sticky_vars.files.append(current_vars_file) 927 print "Using saved variables file %s" % current_vars_file 928 else: 929 # Build dir-specific variables file doesn't exist. 930 931 # Make sure the directory is there so we can create it later 932 opt_dir = dirname(current_vars_file) 933 if not isdir(opt_dir): 934 mkdir(opt_dir) 935 936 # Get default build variables from source tree. Variables are 937 # normally determined by name of $VARIANT_DIR, but can be 938 # overridden by '--default=' arg on command line. 939 default = GetOption('default') 940 opts_dir = joinpath(main.root.abspath, 'build_opts') 941 if default: 942 default_vars_files = [joinpath(build_root, 'variables', default), 943 joinpath(opts_dir, default)] 944 else: 945 default_vars_files = [joinpath(opts_dir, variant_dir)] 946 existing_files = filter(isfile, default_vars_files) 947 if existing_files: 948 default_vars_file = existing_files[0] 949 sticky_vars.files.append(default_vars_file) 950 print "Variables file %s not found,\n using defaults in %s" \ 951 % (current_vars_file, default_vars_file) 952 else: 953 print "Error: cannot find variables file %s or " \ 954 "default file(s) %s" \ 955 % (current_vars_file, ' or '.join(default_vars_files)) 956 Exit(1) 957 958 # Apply current variable settings to env 959 sticky_vars.Update(env) 960 961 help_texts["local_vars"] += \ 962 "Build variables for %s:\n" % variant_dir \ 963 + sticky_vars.GenerateHelpText(env) 964 965 # Process variable settings. 966 967 if not have_fenv and env['USE_FENV']: 968 print "Warning: <fenv.h> not available; " \ 969 "forcing USE_FENV to False in", variant_dir + "." 970 env['USE_FENV'] = False 971 972 if not env['USE_FENV']: 973 print "Warning: No IEEE FP rounding mode control in", variant_dir + "." 974 print " FP results may deviate slightly from other platforms." 975 976 if env['EFENCE']: 977 env.Append(LIBS=['efence']) 978 979 # Save sticky variable settings back to current variables file 980 sticky_vars.Save(current_vars_file, env) 981 982 if env['USE_SSE2']: 983 env.Append(CCFLAGS=['-msse2']) 984 985 # The src/SConscript file sets up the build rules in 'env' according 986 # to the configured variables. It returns a list of environments, 987 # one for each variant build (debug, opt, etc.) 988 envList = SConscript('src/SConscript', variant_dir = variant_path, 989 exports = 'env') 990 991 # Set up the regression tests for each build. 992 for e in envList: 993 SConscript('tests/SConscript', 994 variant_dir = joinpath(variant_path, 'tests', e.Label), 995 exports = { 'env' : e }, duplicate = False) 996 997# base help text 998Help(''' 999Usage: scons [scons options] [build variables] [target(s)] 1000 1001Extra scons options: 1002%(options)s 1003 1004Global build variables: 1005%(global_vars)s 1006 1007%(local_vars)s 1008''' % help_texts)
|