Skip to content

Developers

JakeMont edited this page Mar 7, 2013 · 2 revisions

#Developing for OpenBFDD

Most users should build from one of the distribution packages, which can be downloaded from the downloads page. See the Build and Install page for details. If you are a developer, wishing to modify the OpenBFDD source code, then this page is for you.

Setup From Source Repository

If you are not using a supplied distribution package, but instead, are working directly with the sources from the open source repository, then it ill be necessary to have the GNU Autotools installed (automake, autoconf, etc.).

The code was originally setup using automake-1.11 and autoconf-2.62, but it may be possible to use other versions.

Running:

./autogen.sh

should create the support files necessary to build and install as described on the Build and Install page.

Configuration Options For Development

The standard configuration options are available. For a list of these, run:

./configure --help

In addition the --enable-debug option will enable additional runtime checking and asserts. Be aware that, by default, these asserts will halt execution of the bfdd-beacon. This build is for testing only and is not recommended for production systems.

For development, the following is recommended to disable code optimization and ensure the program can be easily debugged:

./configure --enable-debug CXXFLAGS='-g -O0'

If you wish to see the build commands, build using:

make V=1

Creating a Distribution Package

Once the project has been setup, you can create a distribution package that can be used as described on the Build and Install page, using the command:

make dist.