+// $Id$
+//
// Copyright (C) 2007
-// Fraunhofer Institut fuer offene Kommunikationssysteme (FOKUS)
-// Kompetenzzentrum fuer Satelitenkommunikation (SatCom)
+// Fraunhofer Institute for Open Communication Systems (FOKUS)
+// Competence Center NETwork research (NET), St. Augustin, GERMANY
// Stefan Bund <g0dil@berlios.de>
//
// This program is free software; you can redistribute it and/or modify
The Senf Build Environment is based on the <a href="http://www.scons.org">SCons</a> software
construction tool. SCons is a <a href="http://www.python.org">python</a> based replacement for
\c make. SENFScons consists of several SCons builders as well as some global configuration and
- build utilities. SEBFScons tightly integrates the <a
+ build utilities. SENFScons tightly integrates the <a
href="http://www.boost.org/libs/test/doc/index.html">Boost.Test</a> unit testing framework. It
also incorporates a very flexible infrastructure to build software documentation using <a
href="http://www.stack.nl/~dimitri/doxygen/">Doxygen</a>. This infrastructure uses quite a bit
of pre- and postprocessing (which is integrated with the provided Doxygen builder) to fix some
doxygen problems and generate a (IMHO) more readable layout.
+
+ \autotoc
+
+ \section senfutil_overview Building Projects using SENF
+
+ When building projects using senf, SENFSCons has a very simple helper module \ref senfutil to
+ make the building of libraries utilizing senf simpler:
+ \code
+ import sys
+ sys.path.extend(('senf/senfscons','/usr/lib/senf/senfscons'))
+ import os.path, glob, senfutil
+
+ env = Environment()
+
+ senfutil.SetupForSENF( env )
+
+ env.Append(
+
+ LIBS = [ ],
+ CXXFLAGS = [ '-Wall', '-Woverloaded-virtual' ],
+ LINKFLAGS = [ ],
+
+ CXXFLAGS_debug = [ ],
+ LINKFLAGS_debug = [ ],
+ LOGLEVELS_debug = [ 'senf::log::Debug||VERBOSE' ],
+
+ CXXFLAGS_final = [ '-O3' ],
+ LINKFLAGS_final = [ ],
+ LOGLEVELS_final = [ ],
+
+ SENF_BUILDOPTS = [ ],
+
+ )
+
+ env.Default(
+ env.Program( target = 'udpforward',
+ source = glob.glob('*.cc') )
+ )
+
+ env.Clean(DEFAULT_TARGETS, [ 'udpforward.log', 'udpforward.pid' ])
+ \endcode
+
+ This example builds a simple binary from a number of source files (all '.cc' files). It links
+ against the SENF library and automatically sets all the correct compiler options using
+ <tt>senfutil.SetupForSENF( env )</tt>.
+
+ This script automatically uses a SENF installation either symlinked or imported into the current
+ project in directory 'senf' or, if this directory does not exist, a globaly installed SENF. A
+ locally installed SENF is automatically recompiled if needed. Parallel building is also
+ supported.
+
+ This script automatically supports the \c final and \c LOGLEVELS command line parameters. The
+ LOGLEVELS parameter uses a much more readable syntax than SENF_LOG_CONF:
+ <pre>
+ $ scons -j2 final=1 \
+ LOGLEVELS='senf::log::Debug||IMPORTANT myapp::Transactions|mytrans::Area|VERBOSE'
+ </pre>
+
+ \section senfscons_intro Introduction to the SENFSCons build system
+
+ Here we give an overview on how SENF itself is built. The SENFSCons system aims to be quite
+ flexible at separates SENF specific tasks from generic tasks to facilitate reuse.
- \section layout The Project Layout
+ \subsection senfscons_layout The Project Layout
- A Project using the SENFSCons infrastructure will always use a consistent directory layout. The
- top-level directory will contain one subdirectory for every module. The main target will often
- be considered to be just another module using the facilities provided by library modules.
+ The SENFSCons infrastructure will always use a consistent directory layout. The top-level
+ directory will contain one subdirectory for every module. The main target will often be
+ considered to be just another module using the facilities provided by library modules.
The top-level project directory must contain the SENFSCons module in 'senfscons'.
cross-link the different module documentations. The unit-tests as well are run on a per-module
basis.
- \section Standard Build Configuration
+ \subsection senfscons_buildconf Standard Build Configuration
When the \c SConsctruct and \c SConscript files are build using the default SENFSCons helpers,
by default all libraries and binaries are built. Some additional targets are
<dt><tt>scons all_docs</tt></dt><dd>Build documentation of all modules</dd>
<dt><tt>scons all</tt></dt><dd>Build all targets including binaries, libraries, documentation,
- tests andpossible further targets </dd>
+ tests and possible further targets </dd>
<dt><tt>scons -u doc</tt></dt><dd>Run from within a module directory will build the
documentation of that module</dd>
invokes the module \c SConscript files. To simplify the configuration, the SENFScons python
package is provided. This package has helper utilities to simplify standard tasks.
- In \c senfscons/SConstruct.tempalte you may find an example SConstruct file. Copy this to the
+ In \c senfscons/SConstruct.template you may find an example SConstruct file. Copy this to the
project root (under the name \c SConstruct) to start a new project. You can then modify and
configure it to your wishes.
and have a prefix of \c Use. See \ref use.
After all frameworks are configured, you can use SEFNScons.MakeEnvironment() to create a
- corretly configured construction environment.
+ correctly configured construction environment.
To <i>configure the construction environment</i> you can set Variables in the construction
environment. See the SCons manpage for a list of supported variables. Some additional variables
To configure the build environment to the local environment, a \c SConfig file may be created in
the projects root directory. The supported parameters are
- <dl><dt>\c CXX</dt><dd>C++ compiler to use</dd>
- <dt>\c EXTRA_DEFINES</dt><dd>preprocessor symbols to be defined locally</dd>
- <dt>\c EXTRA_LIBS</dt><dd>additional libraries needed for a local build</dd></dl>
+ <dl>
+ <dt>\c CXX</dt>
+ <dd>C++ compiler to use</dd>
+ <dt>\c EXTRA_DEFINES</dt>
+ <dd>preprocessor symbols to be defined locally</dd>
+ <dt>\c EXTRA_LIBS</dt>
+ <dd>additional libraries needed for a local build</dd>
+ </dl>
Additionally, the \ref use define additional configuration variables which may be set here.
*/
projects / senf.git / blobdiff