]> git.proxmox.com Git - mirror_ovs.git/blobdiff - Documentation/faq/releases.rst
datapath: Update kernel test list, news and FAQ
[mirror_ovs.git] / Documentation / faq / releases.rst
index c785529528e934b618f88b8ad582c7ee9fa7fe46..748540b9163460dd19e283f39b7d118afbff9f72 100644 (file)
@@ -66,6 +66,11 @@ Q: What Linux kernel versions does each Open vSwitch release work with?
     2.6.x        3.10 to 4.7
     2.7.x        3.10 to 4.9
     2.8.x        3.10 to 4.12
+    2.9.x        3.10 to 4.13
+    2.10.x       3.10 to 4.17
+    2.11.x       3.10 to 4.18
+    2.12.x       3.10 to 5.0
+    2.14.x       3.10 to 5.5
     ============ ==============
 
     Open vSwitch userspace should also work with the Linux kernel module built
@@ -93,42 +98,58 @@ Q: Are all features available with all datapaths?
       OVS source tree.
 
     Userspace
-      Also known as DPDK, dpif-netdev or dummy datapath. It is the only
-      datapath that works on NetBSD, FreeBSD and Mac OSX.
+      This datapath supports conventional system devices as well as
+      DPDK and AF_XDP devices when support for those is built.  This
+      is the only datapath that works on NetBSD, FreeBSD and Mac OSX.
 
     Hyper-V
       Also known as the Windows datapath.
 
-    The following table lists the datapath supported features from an Open
-    vSwitch user's perspective.
-
-    ===================== ============== ============== ========= =======
-    Feature               Linux upstream Linux OVS tree Userspace Hyper-V
-    ===================== ============== ============== ========= =======
-    NAT                   4.6            YES            Yes       NO
-    Connection tracking   4.3            YES            PARTIAL   PARTIAL
-    Tunnel - LISP         NO             YES            NO        NO
-    Tunnel - STT          NO             YES            NO        YES
-    Tunnel - GRE          3.11           YES            YES       YES
-    Tunnel - VXLAN        3.12           YES            YES       YES
-    Tunnel - Geneve       3.18           YES            YES       YES
-    Tunnel - GRE-IPv6     NO             NO             YES       NO
-    Tunnel - VXLAN-IPv6   4.3            YES            YES       NO
-    Tunnel - Geneve-IPv6  4.4            YES            YES       NO
-    QoS - Policing        YES            YES            YES       NO
-    QoS - Shaping         YES            YES            NO        NO
-    sFlow                 YES            YES            YES       NO
-    IPFIX                 3.10           YES            YES       NO
-    Set action            YES            YES            YES       PARTIAL
-    NIC Bonding           YES            YES            YES       YES
-    Multiple VTEPs        YES            YES            YES       YES
-    ===================== ============== ============== ========= =======
+    The following table lists the datapath supported features from an
+    Open vSwitch user's perspective.  The "Linux upstream" column
+    lists the Linux kernel version that introduced a given feature
+    into its kernel module.  The "Linux OVS tree" and "Userspace"
+    columns list the Open vSwitch release versions that introduced a
+    given feature into the included kernel module or the userspace
+    datapath, respectively.
+
+    ========================== ============== ============== ========= =======
+    Feature                    Linux upstream Linux OVS tree Userspace Hyper-V
+    ========================== ============== ============== ========= =======
+    Connection tracking             4.3            2.5          2.6      YES
+    Conntrack Fragment Reass.       4.3            2.6          2.12     YES
+    Conntrack Timeout Policies      5.2            2.12         NO       NO
+    Conntrack Zone Limit            4.18           2.10         2.13     YES
+    Conntrack NAT                   4.6            2.6          2.8      YES
+    Tunnel - LISP                   NO             2.11         NO       NO
+    Tunnel - STT                    NO             2.4          NO       YES
+    Tunnel - GRE                    3.11           1.0          2.4      YES
+    Tunnel - VXLAN                  3.12           1.10         2.4      YES
+    Tunnel - Geneve                 3.18           2.4          2.4      YES
+    Tunnel - GRE-IPv6               4.18           2.6          2.6      NO
+    Tunnel - VXLAN-IPv6             4.3            2.6          2.6      NO
+    Tunnel - Geneve-IPv6            4.4            2.6          2.6      NO
+    Tunnel - ERSPAN                 4.18           2.10         2.10     NO
+    Tunnel - ERSPAN-IPv6            4.18           2.10         2.10     NO
+    QoS - Policing                  YES            1.1          2.6      NO
+    QoS - Shaping                   YES            1.1          NO       NO
+    sFlow                           YES            1.0          1.0      NO
+    IPFIX                           3.10           1.11         1.11     YES
+    Set action                      YES            1.0          1.0    PARTIAL
+    NIC Bonding                     YES            1.0          1.0      YES
+    Multiple VTEPs                  YES            1.10         1.10     YES
+    Meter action                    4.15           2.10         2.7      NO
+    ========================== ============== ============== ========= =======
 
     Do note, however:
 
     * Only a limited set of flow fields is modifiable via the set action by the
       Hyper-V datapath.
 
+    * Userspace datapath support, in some cases, is dependent on the associated
+      interface types.  For example, DPDK interfaces support ingress and egress
+      policing, but not shaping.
+
     The following table lists features that do not *directly* impact an Open
     vSwitch user, e.g. because their absence can be hidden by the ofproto layer
     (usually this comes with a performance penalty).
@@ -161,10 +182,31 @@ Q: What DPDK version does each Open vSwitch release work with?
     2.4.x        2.0
     2.5.x        2.2
     2.6.x        16.07.2
-    2.7.x        16.11.2
-    2.8.x        17.05.1
+    2.7.x        16.11.9
+    2.8.x        17.05.2
+    2.9.x        17.11.4
+    2.10.x       17.11.4
+    2.11.x       18.11.6
+    2.12.x       18.11.6
+    2.13.x       19.11.0
     ============ =======
 
+Q: Are all the DPDK releases that OVS versions work with maintained?
+
+    No. DPDK follows YY.MM.n (Year.Month.Number) versioning.
+
+    Typically, all DPDK releases get a stable YY.MM.1 update with bugfixes 3
+    months after the YY.MM.0 release. In some cases there may also be a
+    YY.MM.2 release.
+
+    DPDK LTS releases start once a year at YY.11.0 and are maintained for
+    two years, with YY.MM.n+1 releases around every 3 months.
+
+    The latest information about DPDK stable and LTS releases can be found
+    at `DPDK stable`_.
+
+.. _DPDK stable: http://dpdk.org/doc/guides/contributing/stable.html
+
 Q: I get an error like this when I configure Open vSwitch:
 
         configure: error: Linux kernel in <dir> is version <x>, but
@@ -217,6 +259,7 @@ packaged with Open vSwitch?
     GRE      3.11
     VXLAN    3.12
     Geneve   3.18
+    ERSPAN   4.18
     LISP     not upstream
     STT      not upstream
     ======== ============