README-kernel.md

CCN-lite for the Linux kernel

Prerequisites

Follow the UNIX installation instructions to set up the CCN-lite sources and relevant environment variables.

The Linux Kernel Module was tested with Ubuntu 17.10, Nov, 22, 17 patches, with Kernel 4.13.

Installation

1. Change to the directory CCNL_HOME/src/ccnl-lnxkernel

   cmake .
   make

   Use the target ccn-lite-lnxkernel to compile only the module.

2. Insert the module:

   cd ccnl_lxkernel
   sudo insmod ./ccn-lite-lxkernel.ko e=eth0 v=trace

3. Verify that the module was succesfully inserted into the kernel with:

   dmesg

   or alternatively

   tail /var/log/syslog

   Use option -f to continuously monitor the module's output:

   tail -f /var/log/syslog

Usage

Options

The module has several options when inserting. You can list them using modinfo:

modinfo ./ccn-lite-lnxkernel.ko

The following describes options special to the kernel. For all other options, see the output of ccn-lite-relay -h.

• k - path to the public key used to verify messages sent from ccn-lite-ctrl
• p - path to the private key

Control

You can control the module via ccn-lite-ctrl through the UNIX socket. For example to trigger a dump, use:

sudo $CCNL_HOME/bin/ccn-lite-ctrl debug dump | ccn-lite-ccnb2xml

Notice that you need to use sudo issuing the control command to access the UNIX socket. Type ccn-lite-ctrl -h to see all available commands.

Removal

Use rmmod to remove the module from the kernel:

sudo rmmod ccn_lite_lnxkernel