Net::Nmsg is a Perl XS extension to the NMSG library. The NMSG documentation describes itself as:

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

The Net::Nmsg source code is available from these locations:

Net::Nmsg v0.17, 2017-03-01


CPAN — Find the Net::Nmsg module on a CPAN mirror.

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:

Alternatively, if you followed the installation procedure above, the documentation should be available on your system via one of the following commands:

man Net::Nmsg
perldoc Net::Nmsg