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.
simet-lmapd is a fork from the proof-of-concept lmapd implementation, adding features needed by the SIMET2 project for production use. We contribute those back to the reference lmapd implementation, and will resync to the upstream implementation should the features be accepted.
The "merge back" contribution branches are those in the "for-upstream/" branch namespace of the simetnicbr/simet-lmapd project.
The license of any changes and contributed code by NIC.br is the same as the upstream code.
0.4.1+simet0.15.3 (simet-lmapd fork 0.15.5)
lmapd depends on a few open source libraries:
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 # optionalThe 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 informationAn 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.infoThe following people have helped with suggestions and ideas:
Development of this code was kindly supported by the EU FP7 Leone and Flamingo research projects.
GPLv3 (believed to be SPDX-License-Identifier: GPL-3.0-or-later, waiting for upstream clarification)