Added ASLR info to README
[collectd.git] / README
diff --git a/README b/README
index c683df0..6460078 100644 (file)
--- a/README
+++ b/README
@@ -93,6 +93,9 @@ Features
       DNS traffic: Query types, response codes, opcodes and traffic/octets
       transferred.
 
+    - dpdk
+      Collect DPDK interface statistics.
+
     - drbd
       Collect individual drbd resource statistics.
 
@@ -991,6 +994,10 @@ Crosscompiling
 Configuring with DPDK
 ---------------------
 
+Note: DPDK 16.04 is the minimum version of DPDK required for the dpdkstat
+plugin. This is to allow the plugin to take advantage of functions added to
+detect if the DPDK primary process is alive.
+
 Build DPDK for use with collectd:
   To compile DPDK for use with collectd dpdkstat start by:
     - Clone DPDK:
@@ -1055,13 +1062,22 @@ Build DPDK for use with collectd:
      - Run ldconfig to update the shared library cache.
 
 Configure collectd with DPDK:
+NOTE: The Address-Space Layout Randomization (ASLR) security feature in Linux should
+       be disabled, in order for the same hugepage memory mappings to be present in all
+       DPDK multi-process applications. Note that this has security implications.
+       To disable ASLR:
+               $ echo 0 > /proc/sys/kernel/randomize_va_space
+       To fully enable ASLR:
+               $ echo 2 > /proc/sys/kernel/randomize_va_space
+       See http://dpdk.org/doc/guides/prog_guide/multi_proc_support.html
+
     - Generate the build script as specified below. (i.e. run `build.sh').
     - Configure collectd with the DPDK library:
        ./configure --with-libdpdk=/usr
 
        Libraries:
        ...
-       dpdk  . . . . . . . . yes
+       libdpdk  . . . . . . . . yes
 
        Modules:
        ...