Plugin infrastructure improvements 24/4824/12
authorDamjan Marion <damarion@cisco.com>
Mon, 23 Jan 2017 20:13:45 +0000 (21:13 +0100)
committerDave Wallace <dwallacelf@gmail.com>
Fri, 3 Feb 2017 14:08:47 +0000 (14:08 +0000)
commit3b46cba8f4e909bc363403c6c92215159abb2f11
treed3d40532a31794a3e521e55a5390e26259115914
parent2ae991e27afb3fe2944dd4f60eb2b03f29365c95
Plugin infrastructure improvements

This patch replaces requirement for vlib_plugin_register function
in the plugin so file and introduces new macro:

VLIB_PLUGIN_REGISTER () = {
  .version = "version string",
  .version_required = "requred version",
  .default_disabled = 1,
  .early_init = "early_init_function_name",
};

Plugin will nor be loaded if .default_disabled is set to 1
unless explicitely enabled in startup.conf.

If .verstion_required is set, plugin will not be loaded if there
is version mismatch between plugin and vpp. This can be bypassed
by setting "skip-version-check" for specific plugin.

If .early-init string is present, plugin loader will try to resolve
this specific symbol in the plugin namespace and make a function call.

Following startup.conf configuration is added:

plugins {
  path /path/to/plugin/directory
  plugin ila_plugin.so { enable skip-version-check }
  plugin acl_plugin.so { disable }
}

Change-Id: I706c691dd34d94ffe9e02b59831af8859a95f061
Signed-off-by: Damjan Marion <damarion@cisco.com>
16 files changed:
src/plugins/acl/acl.c
src/plugins/acl/acl.h
src/plugins/acl/l2sess.c
src/plugins/acl/l2sess.h
src/plugins/flowperpkt/flowperpkt.c
src/plugins/ila/ila.c
src/plugins/ioam/encap/ip6_ioam_trace.c
src/plugins/lb/lb.c
src/plugins/sixrd/sixrd.c
src/plugins/snat/snat.c
src/plugins/snat/snat.h
src/vlib/unix/main.c
src/vlib/unix/plugin.c
src/vlib/unix/plugin.h
src/vnet/plugin/plugin.h
src/vpp/vnet/main.c