summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/source/devel/building.rst55
-rw-r--r--doc/source/index.rst1
2 files changed, 56 insertions, 0 deletions
diff --git a/doc/source/devel/building.rst b/doc/source/devel/building.rst
new file mode 100644
index 0000000..d7260b8
--- /dev/null
+++ b/doc/source/devel/building.rst
@@ -0,0 +1,55 @@
+Building fastd
+==============
+
+Dependencies
+~~~~~~~~~~~~
+
+* libuecc (developed together with fastd)
+* libsodium or NaCl (for most crypto methods)
+* libcap (Linux only; can be disabled if you don't need POSIX capability support)
+* Bison (>= 2.5)
+* pkg-config
+
+Optional:
+
+* libssl (for fast AES implementations; OpenSSL support must be enabled during build)
+
+Building
+~~~~~~~~
+
+fastd uses the CMake build system. The libuecc build works the same.
+
+::
+
+ # Get fastd (or use the release tarballs)
+ git clone git://git.universe-factory.net/fastd
+
+ # Create a build dir
+ mkdir fastd-build
+ cd fastd-build
+ cmake ../fastd
+
+ # Build fastd, binary can be found in the src subdir of the build dir
+ make
+
+ # Install in the system
+ make install
+
+CMake will fail if any of fastd's dependencies can't be found. The build can be configured with the ccmake tool
+if it is installed (in package ``cmake-curses-gui`` on Debian).
+
+CMake variables
+~~~~~~~~~~~~~~~
+
+There are a few option that can be given to cmake with ``-DVARIABLE=VALUE``:
+
+* If you have a recent enough toolchain (GCC 4.8 or higher recommended), you can enable link-time optimization with ENABLE_LTO=ON to get slightly better optimized binaries
+* By default, fastd will try to build against libsodium. If you want to use NaCl instead, set ENABLE_LIBSODIUM=OFF
+* Use ENABLE_OPENSSL=ON/OFF to enable or disable compiling against OpenSSL
+* If you have a toolchain without binutils plugin support (e.g. on Debian Wheezy), it is not enough to keep ENABLE_LTO disabled, in addition CMake must be told to use the standard `ar`, `ranlib` and `nm` implementation instead of the GCC-provided versions::
+
+ CMAKE_AR=/usr/bin/ar
+ CMAKE_RANLIB=/usr/bin/ranlib
+ CMAKE_NM=/usr/bin/nm
+
+* You can see all CMake options by calling ``ccmake .`` in the build directory after running cmake. Use the `t` key to toggle display between simple and advanced view and use `c` and then `g` to update the configuration after making changes in ccmake.
diff --git a/doc/source/index.rst b/doc/source/index.rst
index e8a9e28..276ba7e 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -39,4 +39,5 @@ Developer documentation
.. toctree::
:maxdepth: 2
+ devel/building
devel/protocol