# -*- python -*-
-import sys, glob, os.path, datetime, pwd, time, fnmatch, string
-sys.path.append(Dir('#/senfscons').abspath)
-sys.path.append(Dir('#/doclib').abspath)
-import SENFSCons, senfutil
+import sys, os.path, fnmatch
+import SENFSCons, senfutil, senfconf
+
###########################################################################
# Load utilities and setup libraries and configure build
-SENFSCons.UseBoost()
-SENFSCons.UseSTLPort()
-env = SENFSCons.MakeEnvironment()
+env = Environment()
+
+env.Decider('MD5-timestamp')
+env.EnsureSConsVersion(1,2)
+
+# Load all the local SCons tools
+senfutil.loadTools(env)
env.Help("""
Additional top-level build targets:
-prepare Create all source files not part of the repository
-all_tests Build and run unit tests for all modules
-all_docs Build documentation for all modules
-all Build everything
-install_all Install SENF into $PREFIX
-deb Build debian source and binary package
-debsrc Build debian source package
-debbin Build debian binary package
-linklint Check links of doxygen documentation with 'linklint'
-fixlinks Fix broken links in doxygen documentation
-valgrind Run all tests under valgrind/memcheck
-""")
+prepare Create all target files not part of the repository
+default Build all default targets (like calling scons with no arguments)
+examples Build all examples
+all_tests Build and run unit tests for all modules
+test_changes Build tests only for files with local changes (queries svn or git)
+all_docs Build documentation for all modules
+all Build everything
+install_all Install SENF into $$PREFIX
+deb Build debian source and binary package
+debsrc Build debian source package
+debbin Build debian binary package
+linklint Check links of doxygen documentation with 'linklint'
+fixlinks Fix broken links in doxygen documentation
+all_valgrinds Run all tests under valgrind/memcheck
+lcov Generate test coverage output in doc/lcov and lcov.info
+
+You may execute targets on a remote host (if the directory layout is the same)
+by calling
-# Options used to debug inlining:
-#
-# INLINE_OPTS = [ '-finline-limit=20000', '--param','large-function-growth=10000',
-# '--param', 'large-function-insns=10000', '--param','inline-unit-growth=10000',
-# '-fvisibility-inlines-hidden', '-fno-inline-functions', '-Winline' ]
-#
-# BEWARE: You need lots of ram to compile with these settings (approx 1G)
+ scons <target>@[<user>@]<host>
-INLINE_OPTS = [ '-finline-limit=5000' ]
+Some more elaborate unit tests may be enabled by setting appropritate variables
+in the shell (unix) environment
+
+SENF_TIMING_CRITICAL_TESTS
+ Enables unit tests which depend on timing measurements. These
+ unit tests should only be run on a single core and an otherwise
+ idle system.
+
+SENF_WLAN_TEST_INTERFACE
+ WLAN interface to use for testing. The interface should not be
+ actively in use.
+
+SENF_ETH_TEST_INTERFACE
+ Ethernet interface to use for testing. The interface should not
+ be actively in use.
+
+Some unit tests will only run when executed to 'root'.
+""")
env.Append(
- CPPPATH = [ '#/include' ],
- CXXFLAGS = [ '-Wall', '-Woverloaded-virtual', '-Wno-long-long' ] + INLINE_OPTS,
- LIBS = [ 'rt', '$BOOSTREGEXLIB', '$BOOSTIOSTREAMSLIB', '$BOOSTSIGNALSLIB',
- '$BOOSTFSLIB' ],
- TEST_EXTRA_LIBS = [ ],
- ENV = { 'PATH' : os.environ.get('PATH') },
- CLEAN_PATTERNS = [ '*~', '#*#', '*.pyc', 'semantic.cache', '.sconsign', '.sconsign.dblite' ],
+ ENV = { 'PATH' : os.environ.get('PATH'),
+ 'HOME' : os.environ.get('HOME'),
+ 'SSH_AGENT_PID': os.environ.get('SSH_AGENT_PID'),
+ 'SSH_AUTH_SOCK': os.environ.get('SSH_AUTH_SOCK') },
+ CLEAN_PATTERNS = [ '*~', '#*#', '*.pyc', 'semantic.cache', '.sconsign*',
+ '.sconf_temp' ],
+
+ BUILDDIR = '${FLAVOR and "#/build/$FLAVOR" or "#"}',
+ CPPPATH = [ '#', '$BUILDDIR',
+ '${NEED_BOOST_EXT and "#/boost_ext" or None}' ],
+ LOCALLIBDIR = '$BUILDDIR',
+ LIBPATH = [ '$LOCALLIBDIR' ],
+ LIBS = [ '$EXTRA_LIBS' ],
+ EXTRA_LIBS = [ 'rt' ],
+ TEST_EXTRA_LIBS = [ ],
+ VALGRINDARGS = [ '--num-callers=50' ],
+
+ PREFIX = '#/dist',
+ LIBINSTALLDIR = '$PREFIX${syslayout and "/lib" or ""}',
+ BININSTALLDIR = '$PREFIX${syslayout and "/bin" or ""}',
+ INCLUDEINSTALLDIR = '$PREFIX${syslayout and "/include" or ""}',
+ CONFINSTALLDIR = '${syslayout and "$LIBINSTALLDIR/senf" or "$PREFIX"}',
+ OBJINSTALLDIR = '$CONFINSTALLDIR',
+ DOCINSTALLDIR = '$PREFIX${syslayout and "/share/doc/senf" or "/manual"}',
+ SCONSINSTALLDIR = '$CONFINSTALLDIR/site_scons',
+
+ CPP_INCLUDE_EXTENSIONS = [ '.h', '.hh', '.ih', '.mpp', '.cci', '.ct', '.cti' ],
+ CPP_EXCLUDE_EXTENSIONS = [ '.test.hh' ],
+
+ # These options are insane. Only useful for inline debugging. Need at least 1G free RAM
+ INLINE_OPTS_DEBUG = [ '-finline-limit=20000', '-fvisibility-inlines-hidden',
+ '-fno-inline-functions', '-Winline'
+ '--param','large-function-growth=10000',
+ '--param', 'large-function-insns=10000',
+ '--param','inline-unit-growth=10000' ],
+ INLINE_OPTS_NORMAL = [ '-finline-limit=5000' ],
+ INLINE_OPTS = [ '$INLINE_OPTS_NORMAL' ],
+ CXXFLAGS = [ '-Wall', '-Woverloaded-virtual', '-Wno-long-long', '$INLINE_OPTS',
+ '-pipe', '$CXXFLAGS_', '-fno-strict-aliasing' ],
+ CXXFLAGS_ = senfutil.BuildTypeOptions('CXXFLAGS'),
+ CXXFLAGS_final = [ '-O3' ],
+ CXXFLAGS_normal = [ '-O2', '-g' ],
+ CXXFLAGS_debug = [ '-O0', '-g' ],
+
+ CPPDEFINES = [ '$expandLogOption', '$CPPDEFINES_' ],
+ expandLogOption = senfutil.expandLogOption,
+ CPPDEFINES_ = senfutil.BuildTypeOptions('CPPDEFINES'),
+ CPPDEFINES_final = [ ],
+ CPPDEFINES_normal = [ 'SENF_DEBUG' ],
+ CPPDEFINES_debug = [ '$CPPDEFINES_normal' ],
+
+ LINKFLAGS = [ '-rdynamic', '$LINKFLAGS_' ],
+ LINKFLAGS_ = senfutil.BuildTypeOptions('LINKFLAGS'),
+ LINKFLAGS_final = [ ],
+ LINKFLAGS_normal = [ '-Wl,-S' ],
+ LINKFLAGS_debug = [ '-g' ],
)
+# Add all UNIX env vars starting with 'SENF' to the execution environment
+env.Append( ENV = dict(((k,v) for k,v in os.environ.iteritems() if k.startswith("SENF"))) )
+
env.SetDefault(
- LIBSENF = "senf"
+ LIBSENF = "senf",
+ LCOV = "lcov",
+ GENHTML = "genhtml",
+ VALGRIND = "valgrind",
+ SCONSBIN = env.File("#/tools/scons"),
+ SCONSARGS = [ '-Q', '-j$CONCURRENCY_LEVEL', 'debug=$debug', 'final=$final' ] + \
+ [ '%s=%s' % (k,v) for k,v in ARGUMENTS.iteritems() ],
+ SCONS = "@$SCONSBIN $SCONSARGS",
+ CONCURRENCY_LEVEL = env.GetOption('num_jobs') or 1,
+ TOPDIR = env.Dir('#').abspath,
+ LIBADDSUFFIX = '${FLAVOR and "_$FLAVOR" or ""}',
+ OBJADDSUFFIX = '${LIBADDSUFFIX}',
+ FLAVOR = '',
)
-# Parse the log option command line parameter into the SENF_LOG_CONF macro
-senfutil.setLogOption(env)
+# Set variables from command line
+senfutil.parseArguments(
+ env,
+ BoolVariable('final', 'Build final (optimized) build', False),
+ BoolVariable('debug', 'Link in debug symbols', False),
+ BoolVariable('syslayout', 'Install in to system layout directories (lib/, include/ etc)', False),
+ BoolVariable('sparse_tests', 'Link tests against object files and not the senf lib', False)
+)
+if 'test_changes' in COMMAND_LINE_TARGETS and not env.has_key('only_tests'):
+ import SparseTestHack
+ env['only_tests'] = " ".join(x.abspath for x in SparseTestHack.findSCMChanges(env))
+
+if env.has_key('only_tests') : env['sparse_tests'] = True
Export('env')
-# Create Doxyfile.local otherwise doxygen will barf on this non-existent file
-# Create it even when cleaning, to silence the doxygen builder warnings
-if not os.path.exists("Doxyfile.local"):
- Execute(Touch("Doxyfile.local"))
+###########################################################################
+# Configure
+
+@senfconf.Test
+def CheckValgrind(context):
+ context.Message( "Checking for valgrind... " )
+ ret = context.TryAction(['$VALGRIND --version >$TARGET'])
+ context.Result( ret[1].strip() or False )
+ return ret[0]
+
+@senfconf.Test
+def CheckValgrindWildcards(context):
+ context.Message( "Checking whether valgrind supports '...' wildcards in suppressions... " )
+ ret = context.TryAction(['$VALGRIND --suppressions=$SOURCE /bin/true'],
+ "{\n test_suppression\n Memcheck:Addr4\n ...\n fun:foo\n}\n",
+ ".sup")
+ context.Result( ret[0] )
+ return ret[0]
+
+# Default configuration (boost stuff)
+senfutil.Configure(env)
-# Create local_config.h
-if not env.GetOption('clean') and not os.path.exists("local_config.hh"):
- Execute(Touch("local_config.hh"))
+conf = env.Configure(clean=False, help=False, custom_tests = senfconf.Tests())
+env.Replace(
+ HAVE_VALGRIND = conf.CheckValgrind() and conf.CheckValgrindWildcards()
+)
+conf.Finish()
+
+# Only add this here, after all configure checks have run
+
+env.Append(LIBS = '$LIBSENF$LIBADDSUFFIX',
+ EXTRA_LIBS = [ '$BOOSTREGEXLIB', '$BOOSTIOSTREAMSLIB', '$BOOSTSIGNALSLIB',
+ '$BOOSTFSLIB' ])
###########################################################################
-# Define build targets
-# Before defining any targets, check wether this is the first build in
-# pristine directory tree. If so, call 'scons prepare' so the dependencies
-# created later are correct
+# Create Doxyfile.local otherwise doxygen will barf on this non-existent file
+# Create it even when cleaning, to silence the doxygen builder warnings
+if not os.path.exists("doclib/Doxyfile.local"):
+ Execute(Touch("doclib/Doxyfile.local"))
if not env.GetOption('clean') and not os.path.exists(".prepare-stamp") \
and not os.environ.get("SCONS") and COMMAND_LINE_TARGETS != [ 'prepare' ]:
- env.Execute([ "scons prepare" ])
-env.Clean('all', '.prepare-stamp')
+ env.Execute([ "$SCONS prepare" ])
+
+# Load SConscripts
-# Load SConscripts. Need to load debian and doclib first (they change the global environment)
+SConscriptChdir(0)
SConscript("debian/SConscript")
+SConscriptChdir(1)
+if os.path.exists('SConscript.local') : SConscript('SConscript.local')
+if env['sparse_tests']:
+ import SparseTestHack
+ SparseTestHack.setup(env)
+if env.subst('$BUILDDIR') == '#':
+ SConscript("SConscript")
+else:
+ SConscript("SConscript", variant_dir=env.subst('$BUILDDIR'), src_dir='#', duplicate=False)
+SConscript("Examples/SConscript")
+SConscript("HowTos/SConscript")
SConscript("doclib/SConscript")
-SConscript(list(set(glob.glob("*/SConscript")) - set(("debian/SConscript", "doclib/SConscript"))))
+if env['sparse_tests']:
+ verbose = 'test_changes' in COMMAND_LINE_TARGETS
+ SparseTestHack.build(env, verbose, verbose)
+
+###########################################################################
+# Define build targets
-# Define the main targets
-SENFSCons.StandardTargets(env)
-SENFSCons.GlobalTargets(env)
+#### install_all, default, all_tests, all
+env.Install('${SCONSINSTALLDIR}', [ 'site_scons/__init__.py',
+ 'site_scons/senfutil.py',
+ 'site_scons/yaptu.py' ])
+env.InstallDir('${SCONSINSTALLDIR}', [ 'site_scons/site_tools', 'site_scons/lib' ],
+ FILTER_SUFFIXES=[ '','.css','.pl','.py','.sh','.sty','.xml','.xsl','.yap' ])
+env.Install('${INCLUDEINSTALLDIR}', 'boost')
-env.Depends( SENFSCons.Doxygen(env), env.Value(env['ENV']['REVISION']) )
+env.Alias('install_all', env.FindInstalledFiles())
+env.Alias('default', DEFAULT_TARGETS)
+env.Alias('all_tests', env.FindAllBoostUnitTests())
+env.Alias('test_changes', 'all_tests')
+env.Alias('all', [ 'default', 'all_tests', 'examples', 'all_docs' ])
-libsenf = env.Library(env.subst("$LIBSENF$LIBADDSUFFIX"), env['ALLOBJECTS'])
-env.Default(libsenf)
-env.Clean('all', libsenf)
-env.Alias('default', libsenf)
+#### prepare
+env.PhonyTarget('prepare', [], [])
-SENFSCons.InstallIncludeFiles(env, [ 'config.hh' ])
-env.Alias('install_all', env.Install('$LIBINSTALLDIR', libsenf))
+#### valgrind
+env.Alias('all_valgrinds')
+if env['HAVE_VALGRIND']:
+ for test in env.FindAllBoostUnitTests():
+ stamp = env.Command(test[0].dir.File('.test-valgrind.stamp'),
+ [ test[0].dir.File('.test.bin'), 'tools/valgrind.sup' ],
+ [ """$VALGRIND --tool=memcheck
+ --error-exitcode=1
+ --suppressions=${SOURCES[1]}
+ $VALGRINDARGS
+ ${SOURCES[0]} --result_code=no $BOOSTTESTARGS
+ """.replace("\n"," "),
+ Touch("$TARGET") ])
+ alias = env.Command(test[0].dir.File('valgrind'), stamp, [ env.NopAction() ])
+ env.Alias('all_valgrinds', alias)
-if env.GetOption('clean'):
+### lcov
+env.PhonyTarget('lcov', [], [
+ '$SCONS debug=1 BUILDDIR="#/build/lcov" CCFLAGS+="-fprofile-arcs -ftest-coverage" LIBS+="gcov" all_tests',
+ '$LCOV --follow --directory $TOPDIR/build/lcov/senf --capture --output-file /tmp/senf_lcov.info --base-directory $TOPDIR',
+ '$LCOV --output-file lcov.info --remove /tmp/senf_lcov.info "*/include/*" "*/boost/*" "*.test.*" ',
+ '$GENHTML --output-directory doc/lcov --title all_tests lcov.info',
+ 'rm /tmp/senf_lcov.info' ])
+if env.GetOption('clean'):
+ env.Clean('lcov', [ os.path.join(path,f)
+ for path, subdirs, files in os.walk('.')
+ for pattern in ('*.gcno', '*.gcda', '*.gcov')
+ for f in fnmatch.filter(files,pattern) ] +
+ [ 'lcov.info', env.Dir('doc/lcov'), env.Dir('build/lcov') ])
+
+#### clean
+env.Clean('all', ('.prepare-stamp', env.Dir('dist'), env.Dir('build')))
+if env.GetOption('clean') : env.Depends('all', ('lcov', 'all_valgrinds'))
+
+if env.GetOption('clean') and 'all' in BUILD_TARGETS:
env.Clean('all', [ os.path.join(path,f)
for path, subdirs, files in os.walk('.')
for pattern in env['CLEAN_PATTERNS']
for f in fnmatch.filter(files,pattern) ])
-
-SENFSCons.PhonyTarget(env, 'prepare', [ 'true' ])
-
-SENFSCons.PhonyTarget(env, 'valgrind', [ """
- find -name .test.bin
- | while read test; do
- echo;
- echo "Running $$test";
- echo;
- valgrind --tool=memcheck --error-exitcode=99 --suppressions=valgrind.sup
- $$test $BOOSTTESTARGS;
- [ $$? -ne 99 ] || exit 1;
- done
-""".replace("\n"," ") ], [ 'all_tests' ])
+ # Disable writing to the deleted .sconsign file
+ import SCons.SConsign
+ SCons.SConsign.write = lambda : None
if not env.GetOption('clean') and not os.path.exists(".prepare-stamp"):
Execute(Touch(".prepare-stamp"))
+
+### execute targets on remote hosts
+for target in COMMAND_LINE_TARGETS:
+ if '@' in target:
+ realtarget, host = target.split('@',1)
+ cwd=env.GetLaunchDir()
+ home=os.environ['HOME']+'/'
+ if cwd.startswith(home) : cwd = cwd[len(home):]
+ args = [ '$SCONSARGS' ]
+ if env.GetLaunchDir() != os.getcwd():
+ args.append('-u')
+ env.PhonyTarget(target, [], [ "ssh $HOST scons $SCONSARGS -C $DIR $RTARGET" ],
+ HOST=host, RTARGET=realtarget, DIR=cwd, SCONSARGS=args)