From d9668e7153d92cfeee3eee08848426f762aa02a2 Mon Sep 17 00:00:00 2001 From: Scott Keeler Date: Thu, 6 Sep 2018 07:52:59 -0400 Subject: docs: what is vpp and features and performance Change-Id: I5a9ae39ed0429b3de001b5109268d577a281cd46 Signed-off-by: Scott Keeler --- docs/overview/features/controlplane.rst | 2 ++ docs/overview/features/index.rst | 2 ++ docs/overview/features/l2.rst | 2 ++ docs/overview/features/l3.rst | 2 ++ docs/overview/features/l4.rst | 9 +++++++ docs/overview/features/plugins.rst | 2 ++ docs/overview/features/trafficmanagement.rst | 4 ++- docs/overview/features/tunnels.rst | 2 ++ docs/overview/performance/index.rst | 40 ++++++++++++++-------------- docs/overview/supported.rst | 18 +++++++------ 10 files changed, 54 insertions(+), 29 deletions(-) diff --git a/docs/overview/features/controlplane.rst b/docs/overview/features/controlplane.rst index ddf0d34c69f..849617ae4e6 100644 --- a/docs/overview/features/controlplane.rst +++ b/docs/overview/features/controlplane.rst @@ -4,6 +4,8 @@ Control Plane ============= +This section identifies the features associated with Control Plane: + * DHCP client/proxy * DHCPv6 Proxy diff --git a/docs/overview/features/index.rst b/docs/overview/features/index.rst index 43d0503d999..dc825c4c2a9 100644 --- a/docs/overview/features/index.rst +++ b/docs/overview/features/index.rst @@ -4,6 +4,8 @@ Features ======== +The table below identifies different features that are associated to VPP. To see more details about a specific feature, just click the hyperlink associated to the feature noted in the table below. + .. rst-class:: center-align-table +-------------------------+-----------+-----------+ diff --git a/docs/overview/features/l2.rst b/docs/overview/features/l2.rst index a567356209b..56c12053ab8 100644 --- a/docs/overview/features/l2.rst +++ b/docs/overview/features/l2.rst @@ -4,6 +4,8 @@ Layer 2 ======= +This section identifies the features associated with Layer 2: + MAC Layer --------- * Ethernet diff --git a/docs/overview/features/l3.rst b/docs/overview/features/l3.rst index fd90b13efd9..57ae10ff208 100644 --- a/docs/overview/features/l3.rst +++ b/docs/overview/features/l3.rst @@ -4,6 +4,8 @@ Layer 3 ======= +This section identifies the features associated with Layer 3: + IP Layer -------- * ICMP diff --git a/docs/overview/features/l4.rst b/docs/overview/features/l4.rst index 052c6b1b45a..28e1df5f65d 100644 --- a/docs/overview/features/l4.rst +++ b/docs/overview/features/l4.rst @@ -3,3 +3,12 @@ ======= Layer 4 ======= + +This section identifies the features associated with Layer 4: + +* Session: + - connectionless transports + - datagram reception and transmission +* TCP: congestion control +* UDP: datagram mode +* TLS async support diff --git a/docs/overview/features/plugins.rst b/docs/overview/features/plugins.rst index 99431134f7f..0394a816cdb 100644 --- a/docs/overview/features/plugins.rst +++ b/docs/overview/features/plugins.rst @@ -4,4 +4,6 @@ Plugins ======= +This section identifies the features associated with Plugins: + * iOAM diff --git a/docs/overview/features/trafficmanagement.rst b/docs/overview/features/trafficmanagement.rst index 9320165ec09..e56af50a90e 100644 --- a/docs/overview/features/trafficmanagement.rst +++ b/docs/overview/features/trafficmanagement.rst @@ -4,6 +4,8 @@ Traffic Management ================== +This section identifies the features associated with Traffic Management: + IP Layer Input Checks --------------------- * Source Reverse Path Forwarding @@ -51,5 +53,5 @@ COP MAC/IP Pairing -------------- -(security feature). +Security feature diff --git a/docs/overview/features/tunnels.rst b/docs/overview/features/tunnels.rst index 352c4393099..0f2b2d23db0 100644 --- a/docs/overview/features/tunnels.rst +++ b/docs/overview/features/tunnels.rst @@ -4,6 +4,8 @@ Tunnels ======= +This section identifies the features associated with Tunnels: + Layer 2 ------- * L2TP diff --git a/docs/overview/performance/index.rst b/docs/overview/performance/index.rst index 2c8077119cf..1c250206fcf 100644 --- a/docs/overview/performance/index.rst +++ b/docs/overview/performance/index.rst @@ -6,34 +6,34 @@ Performance Overview ^^^^^^^^ -One of the benefits of FD.io VPP, is high performance on relatively low-power computing, this performance is based on the following features: +One of the benefits of FD.io VPP is high performance on relatively low-power computing, this performance is based on the following features: -* A high-performance user-space network stack designed for commodity hardware. +* A high-performance user-space network stack designed for commodity hardware: - L2, L3 and L4 features and encapsulations. -* Optimized packet interfaces supporting a multitude of use cases. +* Optimized packet interfaces supporting a multitude of use cases: - - An integrated vhost-user backend for high speed VM-to-VM connectivity. - - An integrated memif container backend for high speed Container-to-Container connectivity. - - An integrated vhost based interface to punt packets to the Linux Kernel. + - An integrated vhost-user backend for high speed VM-to-VM connectivity + - An integrated memif container backend for high speed Container-to-Container connectivity + - An integrated vhost based interface to punt packets to the Linux Kernel -* The same optimized code-paths run execute on the host, and inside VMs and Linux containers. -* Leverages best-of-breed open source driver technology: `DPDK `_. -* Tested at scale; linear core scaling, tested with millions of flows and mac addresses. +* The same optimized code-paths run execute on the host, and inside VMs and Linux containers +* Leverages best-of-breed open source driver technology: `DPDK `_ +* Tested at scale; linear core scaling, tested with millions of flows and mac addresses These features have been designed to take full advantage of common micro-processor optimization techniques, such as: -* Reducing cache and TLS misses by processing packets in vectors. -* Realizing `IPC `_ gains with vector instructions such as: SSE, AVX and NEON. -* Eliminating mode switching, context switches and blocking, to always be doing useful work. -* Cache-lined aliged buffers for cache and memory efficiency. +* Reducing cache and TLS misses by processing packets in vectors +* Realizing `IPC `_ gains with vector instructions such as: SSE, AVX and NEON +* Eliminating mode switching, context switches and blocking, to always be doing useful work +* Cache-lined aliged buffers for cache and memory efficiency Packet Throughput Graphs ^^^^^^^^^^^^^^^^^^^^^^^^ -These are some of the packet throughput graphs for FD.io VPP 18.04 from the CSIT `18.04 benchmarking report `_. +These are some of the packet throughput graphs for FD.io VPP 18.04 from the CSIT `18.04 benchmarking report `_: .. toctree:: @@ -45,7 +45,7 @@ These are some of the packet throughput graphs for FD.io VPP 18.04 from the CSIT Trending Throughput Graphs ^^^^^^^^^^^^^^^^^^^^^^^^^^ -These are some of the trending packet throughput graphs from the CSIT `trending dashboard `_. **Please note that**, performance in the trending graphs will change on a nightly basis in line with the software development cycle. +These are some of the trending packet throughput graphs from the CSIT `trending dashboard `_. **Please note that**, performance in the trending graphs will change on a nightly basis in line with the software development cycle: .. toctree:: @@ -58,14 +58,14 @@ For More information on CSIT The FD.io CSIT is implemented with below platforms: -* - x86/64 -* - ARM-AArch64 +* x86/64 +* ARM-AArch64 - * - Huawei TaiShan 2280 - * - Marvell MACCHIATObin + * Huawei TaiShan 2280 + * Marvell MACCHIATObin -These are FD.io Continuous System Integration and Testing (CSIT)'s documentation links. +These are FD.io Continuous System Integration and Testing (CSIT)'s documentation links: * `CSIT Code Documentation `_ * `CSIT Test Overview `_ diff --git a/docs/overview/supported.rst b/docs/overview/supported.rst index c843514e05a..959d4483407 100644 --- a/docs/overview/supported.rst +++ b/docs/overview/supported.rst @@ -5,13 +5,15 @@ Architectures and Operating Systems *********************************** +The following architectures and operating systems are supported in VPP: + Architectures ----------------------- -* - The FD.io VPP platform supports: +* The FD.io VPP platform supports: - * - x86/64 - * - ARM-AArch64 + * x86/64 + * ARM-AArch64 Operating Systems and Packaging ------------------------------- @@ -19,9 +21,9 @@ Operating Systems and Packaging FD.io VPP supports package installation on the following recent LTS operating systems releases: -* - Operating Systems: +* Operating Systems: - * - Debian - * - Ubuntu - * - CentOS - * - OpenSUSE + * Debian + * Ubuntu + * CentOS + * OpenSUSE -- cgit 1.2.3-korg