Version 3 (modified by Sebastien Decugis, 13 years ago) (diff)


Information for developers

The project is managed with mercurial. You can access the repository at this address:

The repository is read-only. If you want to submit patches, please use the developers mailing-list You can subscribe to the list here and check the archives there. The tickets system can also be used.

Last but not least, please feel free to contribute to the website! Thank you.

Developer's quick start

Although you can find a lot of information on Mercurial and CMake on the Internet, the following are a few useful tips and tricks for starting development with freeDiameter.

Clone the repository
The following command will fetch the latest source tree in a freeDiameter directory:
hg clone
Update your source tree
When you already have cloned the repository, you can retrieve updates from upstream with the command bellow:
hg pull -u
If you have made local changes, Mercurial will attempt to merge everything by it-self, which is very convenient. If you need archiving your changes, you might have a look at Mercurial Queues.
Build and test
Files/Directories named test.* are ignored by Mercurial in the freeDiameter package ([source:.hgignore]). The following files can reside in your tree without interacting with the repository, and simplify your build-and-test process:
$ ls test.conf/
CMakeFlags   freeDiameter.conf  myextension.conf
$ cat test.rebuild
#!/bin/bash -x
rm -rf
cp -Rs `pwd`/test.conf
cmake `cat CMakeFlags` ..
This allows you to save your configuration files in test.conf directory, and rebuild the whole tree from scratch in a different folder by simply running the test.rebuild script.
Useful CMake flags for development
The following flags are useful for configuring the source, for example in CMakeFlags file (see previous point).
This impacts both the compiler's flags (including symbols for debug) and freeDiameter itself (allowing some slow tracing options such as --dbg-func).
Allows the compilation of the unit tests, called by running make test.
Compile the test application extension test_app.fdx.