Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
There are two ways of building uMumur.
- GNU Autotools (deprecated and will be removed in a future release)
Whichever way you choose, there are some dependencies that need to be installed in order to successfully build uMurmur.
Aside of a C compiler, uMurmur requires the following libraries to be available:
To install the required packages on Debian 8 Jessie use these commands:
$ sudo apt install libconfig-dev libprotobuf-c-dev
and choose either one of these:
$ sudo apt install libpolarssl-dev
$ sudo apt install libssl-dev
Using GnuTLS on Debian GNU/Linux is currently not supported as the version that ships in the repository is too old.
To install the required libraries on Gentoo GNU/Linux use these commands:
# emerge -a dev-libs/libconfig # emerge -a dev-libs/protobuf-c
and choose any one of these:
# emerge -a net-libs/gnutls
# emerge -a dev-libs/openssl
# emerge -a net-libs/polarssl
To build uMurmur using CMake, at least CMake version 2.8.3 is required. If you are new to CMake, it is good practice to build the product 'out-of-tree'. In the following instructions, it is assumed you are starting inside your clone of the uMurmur repository.
$ cd .. $ mkdir umurmur-build $ cd umurmur-build $ cmake ../umurmur $ make $ sudo make install
As with GNU Autotools, there are some configuration options you might be interested in setting:
Select the TLS backend. The default is polarssl.
Enables/Disables the SharedMemory API. The default is Off.
Use the PolarSSL/mbedTLS testing certificate. The default is Off.
Use the PolarSSL/mbedTLS HAVEGE random number generator. The default is Off.
Build the umurmur-monitor utility. The default is Off.
Please note that if you would like to build the umurmur-monitor utility, you would need to either use the
option when cloning uMurmur or supply
<path-to-umurmur-monitor-clone> should be replaced with the patch to the cloned source code of umurmur-monitor
Using GNU Autotools (DEPRECATED)
Building with GNU Autotools is no longer supported, and the option to do so will be removed entirely in a future release. We strongly recommend that you build with cmake instead.
Make sure you have GNU Autotools installed. Afterwards you can use the following commands to build a default configuration of uMurmur:
$ ./autogen.sh $ ./configure $ make $ sudo make install
You can supply different configuration options to the
Selects the TLS backend. The default selection is polarssl
Enables the SharedMemory API to use with tools like umurmur-monitor
Use the PolarSSL/mbedTLS testing certificate. !!!NOT INTENDED FOR PRODUCTION!!!
Use the PolarSSL/mbedTLS HAVEGE random number generator.