Difference between revisions of "VPPHostStack"

From fd.io
Jump to: navigation, search
Line 6: Line 6:
 
* Transport protocol implementations (e.g. TCP, SCTP, UDP)
 
* Transport protocol implementations (e.g. TCP, SCTP, UDP)
 
* Comms Library (VCL) and LD_PRELOAD Library
 
* Comms Library (VCL) and LD_PRELOAD Library
 
Applications can link against the following APIs for host-stack service:
 
* Builtin C API. It can only be used by applications hosted within VPP
 
* "Raw" session layer API
 
* VCL API that offers a POSIX-like interface
 
* POSIX API through LD_PRELOAD
 
  
 
== Start Here ==
 
== Start Here ==
Line 19: Line 13:
 
== Getting Started ==
 
== Getting Started ==
  
Simple testing of the stack can be driven from a number of layers.  
+
Applications can link against the following APIs for host-stack service:
 +
* Builtin C API. It can only be used by applications hosted within VPP
 +
* "Raw" session layer API. It does not offer any support for async communication
 +
* VCL API that offers a POSIX-like interface. It comes with its own epoll implementation.
 +
* POSIX API through LD_PRELOAD
  
 +
A number of test applications can be used to exercise these APIs.
  
== Running List of Presentations ==
+
=== Builtin Echo Server/Client ===
  
* [[Media:Vpp-hoststack.pdf|DPDK Summit North America 2017]]
+
Once two vpp instances are brought and conf, the builtin echo apps can be
* [[Media:Vpp-hoststack-kc.pdf|FD.io Mini Summit KubeCon 2017]]
+
 
 +
=== External Echo Server/Client ===
 +
 
 +
=== VCL socket client/server ===
 +
 
 +
For more details see the tutorial [VPP/VPPCommunicationsLibrary | here]
  
 
== Session Layer Architecture ==
 
== Session Layer Architecture ==
  
 
[[File:Session API.png|550px|center|Session API Diagram]]
 
[[File:Session API.png|550px|center|Session API Diagram]]
 +
 +
== Running List of Presentations ==
 +
 +
* [[Media:Vpp-hoststack.pdf|DPDK Summit North America 2017]]
 +
* [[Media:Vpp-hoststack-kc.pdf|FD.io Mini Summit KubeCon 2017]]

Revision as of 23:06, 6 March 2018

Description

VPP's host stack is a user space implementation of a number of transport, session and application layer protocols that leverages VPP's existing protocol stack. It roughly consists of four major components:

  • Session Layer that accepts pluggable transport protocols
  • Shared memory mechanisms for pushing data between VPP and applications
  • Transport protocol implementations (e.g. TCP, SCTP, UDP)
  • Comms Library (VCL) and LD_PRELOAD Library

Start Here

Set Up Dev Environment - Explains how to set up a VPP development environment and the requirements for using the build tools

Getting Started

Applications can link against the following APIs for host-stack service:

  • Builtin C API. It can only be used by applications hosted within VPP
  • "Raw" session layer API. It does not offer any support for async communication
  • VCL API that offers a POSIX-like interface. It comes with its own epoll implementation.
  • POSIX API through LD_PRELOAD

A number of test applications can be used to exercise these APIs.

Builtin Echo Server/Client

Once two vpp instances are brought and conf, the builtin echo apps can be

External Echo Server/Client

VCL socket client/server

For more details see the tutorial [VPP/VPPCommunicationsLibrary | here]

Session Layer Architecture

Session API Diagram

Running List of Presentations