Description

The NMSG format is an efficient encoding of typed, structured data into payloads which are packed into containers which can be transmitted over the network or stored to disk. Each payload is associated with a specific message schema. Modules implementing a certain message schema along with functionality to convert between binary and presentation formats can be loaded at runtime by libnmsg. nmsgtool provides a command line interface to control the transmission, storage, creation, and conversion of NMSG payloads.

Source Code

Installing Net::Nmsg

First, make sure you have the libnmsg library installed; compiling the nmsg library will require the presence of libpcap on the build system.

Second, install Net::Nmsg like any other perl module; this is an XS extension so a C compiler will be necessary. The easiest way, if you have admin privileges on the target machine, is to use the cpan interactive installation (this will automatically download the Net::Nmsg distribution from CPAN):

$ sudo cpan
cpan1> install Net::Nmsg
...
cpan2> quit

Otherwise, in order to manually install, download the .tar.gz distribution file from one of the sources above and unpack it. From within the resulting directory, follow the standard perl module build procedure:

perl Makefile.PL
make
make test
sudo make install

Using Net::Nmsg

The API for Net::Nmsg closely follows that provided by libnmsg, with the addition of some perl flourishes. You can browse the documentation online: