Difference between revisions of "VPP/Macswapplugin"

From fd.io
< VPP
Jump to: navigation, search
m (add note that debug and release builds look in the same place for plugins)
(add more explanatory text)
Line 1: Line 1:
Using emacs:
+
= Macswap plugin build instructions =
 +
 
 +
These instructions will setup the plugin source in '''/vpp/devboot/macswap'''. This location is chosen only for example; there is no direct correlation between the plugin source tree and the VPP source tree.
 +
 +
There are instructions for both Emacs users and for non-Emacs users.
 +
 
 +
 
 +
== Emacs ==
 +
 
 +
There are a set of templates that Emacs users can make use of to build skeleton plugins, including the macswap plugin.
  
 
<pre>
 
<pre>
Line 10: Line 19:
 
</pre>
 
</pre>
  
OR
 
  
At the shell prompt:
+
== Non-Emacs ==
 +
 
 +
People who do not use Emacs can use a pre-generated copy of the macswap plugin by entering these commands at a shell prompt:
  
 
<pre>
 
<pre>
Line 23: Line 33:
  
  
To build:
+
== Building the plugin ==
 +
 
 +
At a shell prompt:
  
 
<pre>
 
<pre>

Revision as of 19:01, 5 April 2016

Macswap plugin build instructions

These instructions will setup the plugin source in /vpp/devboot/macswap. This location is chosen only for example; there is no direct correlation between the plugin source tree and the VPP source tree.

There are instructions for both Emacs users and for non-Emacs users.


Emacs

There are a set of templates that Emacs users can make use of to build skeleton plugins, including the macswap plugin.

C-x C-f, /vpp/build-root/emacs-list/all-skel.el
M-x eval-buffer
M-x shell; mkdir /vpp/devboot
M-x make-plugin
macswap
C-x s


Non-Emacs

People who do not use Emacs can use a pre-generated copy of the macswap plugin by entering these commands at a shell prompt:

cd ~
git clone https://github.com/alagalah/macswap-plugin
cd macswap-plugin
mkdir /vpp/devboot
tar -zxvf macswap-plugin.tar.gz -C /vpp/devboot


Building the plugin

At a shell prompt:

cd /vpp/devboot/macswap-plugin
autoreconf -i -f
mkdir build
cd build
../configure --with-plugin-toolkit
make
sudo make install
ls /usr/lib/vpp_plugins/

NB: This builds against the libraries/headers installed in the system; not those in the local build environment. Both release and debug builds of VPP will search in /usr/lib/vpp_plugins for plugins to load when they start.