lmapd is the proof-of-concept daemon implementation for the Large-Scale Measurement Platforms (LMAP) information and data model developed by the LMAP working group of the IETF. The information model was published as RFC8193 and the data model as RFC8194.
lmapd depends on a few open source libraries:
- libevent - an event notification library
- libxml2 - an XML library written in C
- libjson-c - a JSON library written in C
- libcheck - a unit testing framework for C
The build system is based on cmake.
$ sudo apt-get install cmake pkg-config libevent-dev libxml2-dev check $ git clone https://github.com/schoenw/lmapd.git $ cd lmapd $ mkdir build $ cd build $ cmake .. $ make $ make test # optional $ make doc # optional
The binary for the daemon is located at src/lmapd. The binary at src/lmapctl provides a little command line tool that can be used to validate configuration files and to interact with the daemon.
$ ./src/lmapd -h usage: lmapd [-f] [-n] [-s] [-v] [-h] [-q queue] [-c config] [-s status] -f fork (daemonize) -n parse config and dump config and exit -s parse config and dump state and exit -q path to queue directory -c path to config directory or file -r path to run directory (pid file and status file) -v show version information and exit -h show brief usage information and exit $ ./src/lmapctl help clean clean the workspace (be careful!) config validate and render lmap configuration help show brief list of commands reload reload the lmap configuration report report data running test if the lmap daemon is running shutdown shutdown the lmap daemon status show status information validate validate lmap configuration version show version information
An example config file is located at docs/lmapd-config.xml.
Want to contribute? Great!
Check out the current issues and provide a fix for each of them. Fork your local lmapd repository and create a new branch. When the development is done create a pull request and we can get things upstream.
Enable coverage definitions in the top-level CMakeLists.txt and build normally. In the build directory, you can now produce a nice report:
$ lcov --zerocounters --directory . $ lcov --capture --initial --directory . --output-file app $ make test $ lcov --no-checksum --directory . --capture --output-file app.info $ genhtml app.info
- Fix lmapctl timezone bug
- Implement schedule/duration
- Implement calendar/timezone-offset
- Implement pipelined execution mode
The following people have helped with suggestions and ideas:
- Vlad Ungureanu
- Vaibhav Bajpai
- Jürgen Schönwälder
- Roxana Nadrag
- Alexandru Barbarosie