Difference between revisions of "VPP"

From fd.io
Jump to: navigation, search
(Get Involved)
 
(102 intermediate revisions by 15 users not shown)
Line 3: Line 3:
 
|shortname=vpp
 
|shortname=vpp
 
|jiraName=VPP
 
|jiraName=VPP
|projectLead=Dave Barach
+
|projectLead=Damjan Marion
 
|committers=
 
|committers=
 
* Dave Barach
 
* Dave Barach
* Keith Burns
 
 
* Florin Coras
 
* Florin Coras
 +
* Benoit Ganne
 +
* Mohammed Hawari
 
* John Lo
 
* John Lo
 
* Chris Luke
 
* Chris Luke
 
* Damjan Marion
 
* Damjan Marion
 
* Neale Ranns
 
* Neale Ranns
* Ole Troan
+
* Matthew Smith
* Marco Varlese
+
* Ole Trøan
 +
* Paul Vinciguerra
 
* Dave Wallace
 
* Dave Wallace
 
* Ed Warnicke
 
* Ed Warnicke
 +
* Andrew Yourtchenko
 +
* Fan Zhang
 
}}
 
}}
  
Line 21: Line 25:
  
 
[[VPP/What is VPP?|What is VPP?]] - An introduction to the open-source Vector Packet Processing (VPP) platform
 
[[VPP/What is VPP?|What is VPP?]] - An introduction to the open-source Vector Packet Processing (VPP) platform
 +
 +
[[ VPP - Working Environments ]] - Environments/distributions, etc... that VPP builds/run on.
  
 
[[VPP/Features| Feature Summary]] - A list of features included in VPP
 
[[VPP/Features| Feature Summary]] - A list of features included in VPP
  
==Start Here==
+
== Get Involved ==
  
[https://docs.google.com/document/d/1zqYN7qMavgbdkPWIJIrsPXlxNOZ_GhEveHQxpYr3qrg/edit?usp=sharing Quick Start Guide]
+
* [[VPP/Meeting|VPP Meeting]]
 +
* [https://lists.fd.io/mailman/listinfo/vpp-dev Join the VPP Mailing List]
 +
* [[IRC | Join fdio-vpp IRC channel]]
 +
* [[Projects/vpp/Release_Plans/Release_Plan_24.10| 24.10 Release Plan]]
 +
* [[VPP/Committers/SMEs | Committer subject matter expert list - who should I add as a reviewer to review my patch?]]
 +
* [[VPP/Working with the 16.06 Throttle Branch|Working with Throttle Branches]]
 +
* [[VPP/Installing VPP binaries from packages| Getting the Current Release]]
 +
* [[VPP/CodeStyleConventions | Coding Style]]
 +
* Static Analysis, see [//scan.coverity.com/projects/fd-io-vpp Latest Coverity Run Results]
 +
* Gerrit Code Review, see [https://gerrit.fd.io/r/q/project:vpp+is:open Open VPP Gerrit Changes] or [https://github.com/vpp-dev/vpp-gerrit-report Daily VPP Gerrit Report sorted by status]
  
[[VPP/Configuration Tool|VPP Configuration Tool]] - A tool the configures VPP in a simple and safe manner
+
==VPP Documentation==
  
[[VPP/FAQ| Frequently Asked Questions]]
+
VPP is the core technology behind the FD.io Project. The best place to learn how VPP fits in to the larger FD.io project is the [https://fd.io FD.io Main Site].
  
==Documents==
+
The [https://fd.io/docs/vpp/master VPP User Documents] is the most complete and up to date description of VPP. To get started as a user of VPP look at the '''Getting Started''' section. For developer guidance, look at the '''Developer Documentation''' section. To contribute to the user documents look at the '''Contributing''' section.
  
master (18.10): [https://docs.fd.io/vpp/18.10/ Documentation]
+
More VPP related documents:
  
Release 18.07: [https://docs.fd.io/vpp/18.07/ Documentation]
+
* CSIT Test Reports: [https://fd.io/documentation/csit by VPP version]
  
Release 18.04: [https://docs.fd.io/vpp/18.04/ Documentation], [https://docs.fd.io/csit/rls1804/report/ CSIT-VPP Test Report]
+
* [https://wiki.fd.io/view/File:Fd.io_vpp_overview_29.03.17.pptx VPP design and implementation overview (Powerpoint)]
  
Release 18.01.2: [https://docs.fd.io/vpp/18.01.2/ Documentation], [https://docs.fd.io/csit/rls1801_2/report/ CSIT-VPP Test Report]
+
* [http://stackalytics.com/?release=all&project_type=fdio-group&metric=commits&module=vpp Code Contribution Metrics]
 
+
CSIT-VPP Continuous Performance Trending: [https://docs.fd.io/csit/master/trending/introduction/index.html Dashboard],  [https://docs.fd.io/csit/master/trending/trending/index.html Graphs].
+
 
+
[https://wiki.fd.io/view/File:Fd.io_vpp_overview_29.03.17.pptx VPP design and implementation overview (Powerpoint)]
+
 
+
[http://stackalytics.com/?release=all&project_type=fdio-group&metric=commits&module=vpp Code Contribution Metrics]
+
 
+
== Get Involved ==
+
 
+
* [[VPP/Meeting|Weekly VPP Meeting]]
+
* [https://lists.fd.io/mailman3/lists/vpp-dev.lists.fd.io/ Join the VPP Mailing List]
+
* [[IRC | Join fdio-vpp IRC channel]]
+
* [[Projects/vpp/Release_Plans/Release_Plan_18.10 | 18.10 Release Plan]]
+
* [[VPP/Committers/SMEs | Committer subject matter expert list - who should I add as a reviewer to review my patch?]]
+
* [[VPP/Working with the 16.06 Throttle Branch|Working with Throttle Branches]]
+
* [[VPP/Installing VPP binaries from packages| Getting the Current Release (18.07)]]
+
* [[VPP/Documentation | How to document vpp code]]
+
* [[VPP/CodeStyleConventions | Coding Style]]
+
* Static Analysis, see [//scan.coverity.com/projects/fd-io-vpp Latest Coverity Run Results]
+
* [https://opengrok.fd.io/xref/vpp/ OpenGrok for VPP]
+
  
 
==Getting started with VPP development==
 
==Getting started with VPP development==
Line 66: Line 61:
 
[[VPP/Installing VPP binaries from packages|Installing VPP binaries from packages]] - using APT/YUM to install VPP
 
[[VPP/Installing VPP binaries from packages|Installing VPP binaries from packages]] - using APT/YUM to install VPP
  
[[VPP/Pulling,_Building,_Running,_Hacking_and_Pushing_VPP_Code| Pulling, Building, Hacking, and Pushing VPP Code]] - Explains how to get up and going with the vpp code base. NOTE: supercedes [[VPP/Setting_Up_Your_Dev_Environment|Setting Up Your Dev Environment]]
+
[[VPP/Pulling,_Building,_Running,_Hacking_and_Pushing_VPP_Code| Pulling, Building, Hacking, and Pushing VPP Code]] - Explains how to get up and going with the vpp code base.
  
 
[[VPP/Build, install, and test images|Building and Installing A VPP Package]] - Explains how to build, install and test a VPP package
 
[[VPP/Build, install, and test images|Building and Installing A VPP Package]] - Explains how to build, install and test a VPP package
  
[[VPP/Alternative builds|Alternative builds]] - various platform and feature specific VPP builds
+
[[VPP/BuildArtifactRetentionPolicy|VPP CI Build Artifact Retention Policy]] - Retention policy for VPP build artifacts uploaded to [https://packagecloud.io/fdio Packagecloud.io/fdio] by CI jobs
  
[[VPP/BugReports|Reporting Bugs]] - Explains how to report a bug, specifically: how to gather the required information
+
[https://fd.io/docs/vpp/master/contributing/reportingissues/index.html Reporting Bugs] - Explains how to report a bug, specifically: how to gather the required information
  
VPP Troubleshooting - Various tips/tricks for commonly seen issues
+
[[VPP/PythonVersionPolicy|Python Version Policy]] - Explains the selection and support of Python in use for many of the development tools.
* [[VPP/Troubleshooting/Vagrant|Issues with Vagrant]]
+
* [[VPP/Troubleshooting/BuildIssues | Build issues]]
+
  
 
==Dive Deeper==
 
==Dive Deeper==
  
 
[[VPP/The VPP API|The VPP API]] - design and implementation of the VPP API
 
[[VPP/The VPP API|The VPP API]] - design and implementation of the VPP API
 +
 +
[[VPP/ApiChangeProcess|API Change Process]] - Change your production-grade APIs in a compatible way without inhibiting innovation
  
 
[[VPP/Build_System_Deep_Dive|Build System Deep Dive]] - A close look at the components of the build system.
 
[[VPP/Build_System_Deep_Dive|Build System Deep Dive]] - A close look at the components of the build system.
Line 102: Line 97:
 
[[VPP/Software Architecture | VPP Software Architecture]]
 
[[VPP/Software Architecture | VPP Software Architecture]]
  
[[VPP/Command-line Interface (CLI) Guide|VPP Command-line Interface (CLI) User Guide]]
+
[https://fd.io/docs/vpp/master/cli-reference/gettingstarted/index.html VPP debug Command-line Interface (CLI) User Guide]
  
[[VPP/Command-line Arguments | VPP Command-line Arguments and startup configuration]]
+
[[VPP/Command-line Arguments | VPP debug CLI arguments and startup configuration]]
  
 
[[VPP/Documentation | Writing VPP Documentation]]
 
[[VPP/Documentation | Writing VPP Documentation]]
Line 111: Line 106:
  
 
[[VPP/Missing Prefetches | How to spot missing prefetches]]
 
[[VPP/Missing Prefetches | How to spot missing prefetches]]
 
[[VPP/Buffer Opaque Layout | Buffer Opaque Layout]]
 
  
 
[[VPP/Feature Arcs | Feature Arc infrastructure]]
 
[[VPP/Feature Arcs | Feature Arc infrastructure]]
Line 123: Line 116:
  
 
[[VPP/Bihash | Bounded-index extensible hash infrastructure]]
 
[[VPP/Bihash | Bounded-index extensible hash infrastructure]]
 +
 +
[[VPP/MakeTestFramework | Make Test Framework]]
  
 
==Tutorials==
 
==Tutorials==
Line 137: Line 132:
  
 
==Use Cases==
 
==Use Cases==
 
[[VPP/VPPCommunicationsLibrary|Use VPP with VCL for high-speed container networking]] - iPerf3 in Docker at 100Gbps+
 
  
 
[[VPP/Configure VPP As A Router Between Namespaces|Use VPP as a Router Between Namespaces]] - An example configuration of the VPP platform as a router.
 
[[VPP/Configure VPP As A Router Between Namespaces|Use VPP as a Router Between Namespaces]] - An example configuration of the VPP platform as a router.
Line 153: Line 146:
  
 
[[VPP/MPLS_FIB|Use VPP MPLS]] - Examples for programming VPP for MPLS P/PE support..  
 
[[VPP/MPLS_FIB|Use VPP MPLS]] - Examples for programming VPP for MPLS P/PE support..  
 +
 +
[[VPP/MFIB|Use VPP IP Multicast]] - Examples for programming VPP for IP Multicast..
 +
 +
[[VPP/MFIB|Use VPP BIER]] - Examples for programming VPP for BIER..
 +
 +
[[VPP/ABF|Use VPP for Policy Based Routing]] - Examples for programming VPP for PBR support..
  
 
[[VPP/Interconnecting vRouters with VPP|Interconnecting vRouters with VPP]] - An example to interconnect vRoutes (xrv9000) with VPP using vhost-user feature and VLAN tagging
 
[[VPP/Interconnecting vRouters with VPP|Interconnecting vRouters with VPP]] - An example to interconnect vRoutes (xrv9000) with VPP using vhost-user feature and VLAN tagging
Line 196: Line 195:
  
 
[[VPP/DHCPv6]] - DHCPv6
 
[[VPP/DHCPv6]] - DHCPv6
 +
 +
[[VPP/VOM]] - VPP Object Model
  
 
== Starter Tasks ==
 
== Starter Tasks ==
Line 202: Line 203:
  
 
== Previous Release Plans ==
 
== Previous Release Plans ==
* [[Projects/vpp/Release_Plans/Release_Plan_18.10 | 18.10 Release Plan]]
+
* [[Projects/vpp/Release_Plans_Archive | Archived Release Plans]]
* [[Projects/vpp/Release_Plans/Release_Plan_18.07 | 18.07 Release Plan]]
+
 
* [[Projects/vpp/Release_Plans/Release_Plan_18.04 | 18.04 Release Plan]]
+
== List of all subpages (used or unused) ==
* [[Projects/vpp/Release_Plans/Release_Plan_18.01 | 18.01 Release Plan]]
+
 
* [[Projects/vpp/Release_Plans/Release_Plan_17.10 | 17.10 Release Plan]]
+
{{Special:PrefixIndex |prefix=VPP|hideredirects=1}}
* [[Projects/vpp/Release_Plans/Release_Plan_17.07 | 17.07 Release Plan]]
+
* [[Projects/vpp/Release_Plans/Release_Plan_17.04 | 17.04 Release Plan]]
+
* [[Projects/vpp/Release_Plans/Release_Plan_17.01 | 17.01 Release Plan]]
+
* [[Projects/vpp/Release_Plans/Release_Plan_16.09 | 16.09 Release Plan]]
+

Latest revision as of 14:01, 22 July 2024

VPP Facts

Project Lead: Damjan Marion
Committers:

  • Dave Barach
  • Florin Coras
  • Benoit Ganne
  • Mohammed Hawari
  • John Lo
  • Chris Luke
  • Damjan Marion
  • Neale Ranns
  • Matthew Smith
  • Ole Trøan
  • Paul Vinciguerra
  • Dave Wallace
  • Ed Warnicke
  • Andrew Yourtchenko
  • Fan Zhang

Repository: git clone https://gerrit.fd.io/r/vpp
Mailing List: vpp-dev@lists.fd.io
Jenkins: jenkins silo
Gerrit Patches: code patches/reviews
Bugs: VPP bugs

Summary

What is VPP? - An introduction to the open-source Vector Packet Processing (VPP) platform

VPP - Working Environments - Environments/distributions, etc... that VPP builds/run on.

Feature Summary - A list of features included in VPP

Get Involved

VPP Documentation

VPP is the core technology behind the FD.io Project. The best place to learn how VPP fits in to the larger FD.io project is the FD.io Main Site.

The VPP User Documents is the most complete and up to date description of VPP. To get started as a user of VPP look at the Getting Started section. For developer guidance, look at the Developer Documentation section. To contribute to the user documents look at the Contributing section.

More VPP related documents:

Getting started with VPP development

Installing VPP binaries from packages - using APT/YUM to install VPP

Pulling, Building, Hacking, and Pushing VPP Code - Explains how to get up and going with the vpp code base.

Building and Installing A VPP Package - Explains how to build, install and test a VPP package

VPP CI Build Artifact Retention Policy - Retention policy for VPP build artifacts uploaded to Packagecloud.io/fdio by CI jobs

Reporting Bugs - Explains how to report a bug, specifically: how to gather the required information

Python Version Policy - Explains the selection and support of Python in use for many of the development tools.

Dive Deeper

The VPP API - design and implementation of the VPP API

API Change Process - Change your production-grade APIs in a compatible way without inhibiting innovation

Build System Deep Dive - A close look at the components of the build system.

Introduction To IP Adjacency - An explanation of the characteristics of IP adjacency and its uses.

Introduction To N-tuple Classifiers - An explanation of classifiers and how to create classifier tables and sessions.

Modifying The Packet Processing Directed Graph - An explanation of how a directed node graph processes packets, and possible ways to change the node graph.

Using VPP In A Multi-thread Model - An explanation of multi-thread modes, configurations, and setup.

Using VPP as a VXLAN Tunnel Terminator - An explanation of the VXLAN tunnel terminator, its features, architecture, and API support.

Adding a VPP tunnel encapsulation - How to add a tunnel encapsulation type to vpp.

Using VPP IPSec and IKEv2 - An explanation of IPSec and IKEv2 configuration.

Reference Material

VPP Software Architecture

VPP debug Command-line Interface (CLI) User Guide

VPP debug CLI arguments and startup configuration

Writing VPP Documentation

Performance Analysis Tools

How to spot missing prefetches

Feature Arc infrastructure

DPOs and Feature Arcs

Per-feature Notes

VPP Host Stack

Bounded-index extensible hash infrastructure

Make Test Framework

Tutorials

Deep dive code walkthrough VoDs (recorded at 2016 FD.io pre-launch Event)

VPP video tutorials (collection of short video tutorials).

VPP Howtos (collection of step-by-step howto guides).

VPP training events (videos of VPP training events).

Progressive Tutorial in Using VPP

Use Cases

Use VPP as a Router Between Namespaces - An example configuration of the VPP platform as a router.

Use VPP with dynamic TAP interfaces as a Router Between Containers - Another example of inter-namespace/inter-container routing, using TAP interfaces.

Use VPP to Connect VMs Using Vhost-User Interface - An example of connecting two virtual machines using VPP L2 Bridge and vhost-user interfaces.

Use VPP to Chain VMs Using Vhost-User Interface - An example of chaining two virtual machines and connecting to physical interface.

Use VPP as an LW46 (MAP-E) Terminator - An example configuration of the VPP platform as an lw46 (MAP-E) terminator.

Use VPP for IPv6 Segment Routing - An example of how to leverage SRv6 to create an overlay VPN with underlay optimization.

Use VPP MPLS - Examples for programming VPP for MPLS P/PE support..

Use VPP IP Multicast - Examples for programming VPP for IP Multicast..

Use VPP BIER - Examples for programming VPP for BIER..

Use VPP for Policy Based Routing - Examples for programming VPP for PBR support..

Interconnecting vRouters with VPP - An example to interconnect vRoutes (xrv9000) with VPP using vhost-user feature and VLAN tagging

Use user mode TCP stack with VPP - An example to use user mode TCP stack with VPP using netmap virtual interfaces

Use VPP as a Home Gateway - Configure VPP as a classic ipv4 NAT home gateway

Setup Bi-directional Forwarding Detection - An example on how to setup BFD between VPP and a Cisco Nexus switch

VPP on EC2 instance with SR-IOV support - An example of how to use VPP on EC2 instance with SR-IOV support

How to deploy VPP in an EC2 instance and use it to connect two different VPCs with SR functionalities - How to deploy VPP in an EC2 instance and how use it as router to connect two different VPCs with SR functionalities

VPP Committer Tasks

Release Milestones

Miscellaneous

Projects

NAT plugin - VPP CGN, NAT44, stateful NAT64 project

Security Groups - ACLs, Security Groups, Group Based Policy

VPP/IPFIX - IP Flow Information Export

VPP/AArch64 - VPP on ARM64

VPP/DHCPv6 - DHCPv6

VPP/VOM - VPP Object Model

Starter Tasks

If you are looking for tasks to pick up as 'Starter Tasks' to start contributing, we keep a list of those in Jira.

Previous Release Plans

List of all subpages (used or unused)

VPPVPP-16.09 Test Report Performance DataVPP/2022 Make Test Use Case Poll
VPP/AArch64VPP/ABFVPP/API Concepts
VPP/API VersioningVPP/Alternative buildsVPP/ApiChangeProcess
VPP/ArtifactVersioningVPP/BIERVPP/Bihash
VPP/BugReportsVPP/Build, install, and test imagesVPP/BuildArtifactRetentionPolicy
VPP/Build System Deep DiveVPP/CodeStyleConventionsVPP/Code Walkthrough VoD
VPP/Code Walkthrough VoD Topic IndexVPP/Code Walkthrough VoDsVPP/CodingTips
VPP/Command-line ArgumentsVPP/Command-line Interface (CLI) GuideVPP/CommitMessages
VPP/CommitterTasks/ApiFreezeVPP/CommitterTasks/Compare API ChangesVPP/CommitterTasks/CutPointRelease
VPP/CommitterTasks/CutReleaseVPP/CommitterTasks/FinalReleaseCandidateVPP/CommitterTasks/PullThrottleBranch
VPP/CommitterTasks/ReleasePlanVPP/Committers/SMEsVPP/Configuration Tool
VPP/Configure VPP As A Router Between NamespacesVPP/Configure VPP TAP Interfaces For Container RoutingVPP/Configure an LW46 (MAP-E) Terminator
VPP/CoreFileMismatchVPP/CurrentDataVPP/DHCPKit
VPP/DHCPv6VPP/DPOs and Feature ArcsVPP/DistributedOwnership
VPP/DocumentationVPP/EC2 instance with SRIOVVPP/FAQ
VPP/FIBVPP/Feature ArcsVPP/Features
VPP/Features/IPv6VPP/Getting VPP 16.06VPP/Getting VPP Release Binaries
VPP/HostStackVPP/HostStack/BuiltinEchoClientServerVPP/HostStack/EchoClientServer
VPP/HostStack/ExternalEchoClientServerVPP/HostStack/LDP/iperfVPP/HostStack/LDP/nginx
VPP/HostStack/LDP/sshdVPP/HostStack/SessionLayerArchitectureVPP/HostStack/TLS
VPP/HostStack/TestHttpServerVPP/HostStack/TestProxyVPP/HostStack/VCL
VPP/HostStack/VclEchoClientServerVPP/HostStack/hs-testVPP/HostStack/nginx
VPP/HotplugVPP/How To Build The Sample PluginVPP/How To Connect A PCI Interface To VPP
VPP/How To Optimize Performance (System Tuning)VPP/How To Use The API Trace ToolsVPP/How To Use The C API
VPP/How To Use The Packet Generator and Packet TracerVPP/How to Create a VPP binary control-plane APIVPP/How to add a tunnel encapsulation
VPP/HowtosVPP/IPFIXVPP/IPSec
VPP/IPSec and IKEv2VPP/IP adjacency introductionVPP/IPv6 SR VIRL topology file
VPP/Installing VPP binaries from packagesVPP/Interconnecting vRouters with VPPVPP/Introduction To IP Adjacency
VPP/Introduction To N-tuple ClassifiersVPP/Java APIVPP/Java API/Plugin support
VPP/MFIBVPP/MPLS FIBVPP/Macswapplugin
VPP/MakeTestFrameworkVPP/MeetingVPP/Missing Prefetches
VPP/Modifying The Packet Processing Directed GraphVPP/NATVPP/OVN
VPP/Per-feature NotesVPP/Performance Analysis ToolsVPP/Progressive VPP Tutorial
VPP/Pulling, Building, Running, Hacking and Pushing VPP CodeVPP/Pure L3 Between Namespaces with /32sVPP/Pure L3 Container Networking
VPP/Pushing and Testing a TagVPP/PythonVersionPolicyVPP/Python API
VPP/QuickTrexSetupVPP/RMVPP/Random Hints and Kinks for KVM usage
VPP/STN TestingVPP/SecurityGroupsVPP/Segment Routing for IPv6
VPP/Segment Routing for MPLSVPP/Setting Up Your Dev EnvironmentVPP/Software Architecture
VPP/The VPP APIVPP/Training EventsVPP/Troubleshooting
VPP/Troubleshooting/BuildIssuesVPP/Troubleshooting/VagrantVPP/Tutorial DPDK and MacSwap
VPP/Tutorial Routing and SwitchingVPP/TutorialsVPP/Use VPP to Chain VMs Using Vhost-User Interface
VPP/Use VPP to connect VMs Using Vhost-User InterfaceVPP/Using VPP In A Multi-thread ModelVPP/Using VPP as a VXLAN Tunnel Terminator
VPP/Using mTCP user mode TCP stack with VPPVPP/VOMVPP/VPP/HostStack/BuiltinEchoClientServer
VPP/VPPCommunicationsLibraryVPP/VPPConfigVPP/VPPHostStack/TestHttpServer
VPP/VPP BFD NexusVPP/VPP Home GatewayVPP/VPP WIKI DEPRECATED CONTENT
VPP/What is ODP4VPP?VPP/What is VPP?VPP/Working with the 16.06 Throttle Branch
VPP/c2cpelVPP/cpelVPP/cpeldump
VPP/elogVPP/g2VPP/jira workflow
VPP/nataas-testVPP/perftopVPP/project-meeting-minutes
VPPHostStackVPP - Working EnvironmentsVPP 16.06 DPDK Patchset
VPP SandboxVPP Sandbox/flowtableVPP Sandbox/mmb
VPP Sandbox/routerVPP Sandbox/turbotapVPP Sandbox/vpp-userdemo
VPP Usability Track