net/cnxk: make inline inbound device usage as default
[dpdk.git] / doc / guides / howto / flow_bifurcation.rst
1 ..  SPDX-License-Identifier: BSD-3-Clause
2     Copyright(c) 2016 Intel Corporation.
3
4 Flow Bifurcation How-to Guide
5 =============================
6
7 Flow Bifurcation is a mechanism which uses hardware capable Ethernet devices
8 to split traffic between Linux user space and kernel space. Since it is a
9 hardware assisted feature this approach can provide line rate processing
10 capability. Other than :ref:`KNI <kni>`, the software is just required to
11 enable device configuration, there is no need to take care of the packet
12 movement during the traffic split. This can yield better performance with
13 less CPU overhead.
14
15 The Flow Bifurcation splits the incoming data traffic to user space
16 applications (such as DPDK applications) and/or kernel space programs (such as
17 the Linux kernel stack). It can direct some traffic, for example data plane
18 traffic, to DPDK, while directing some other traffic, for example control
19 plane traffic, to the traditional Linux networking stack.
20
21 There are a number of technical options to achieve this. A typical example is
22 to combine the technology of SR-IOV and packet classification filtering.
23
24 SR-IOV is a PCI standard that allows the same physical adapter to be split as
25 multiple virtual functions. Each virtual function (VF) has separated queues
26 with physical functions (PF). The network adapter will direct traffic to a
27 virtual function with a matching destination MAC address. In a sense, SR-IOV
28 has the capability for queue division.
29
30 Packet classification filtering is a hardware capability available on most
31 network adapters. Filters can be configured to direct specific flows to a
32 given receive queue by hardware. Different NICs may have different filter
33 types to direct flows to a Virtual Function or a queue that belong to it.
34
35 In this way the Linux networking stack can receive specific traffic through
36 the kernel driver while a DPDK application can receive specific traffic
37 bypassing the Linux kernel by using drivers like VFIO or the DPDK ``igb_uio``
38 module.
39
40 .. _figure_flow_bifurcation_overview:
41
42 .. figure:: img/flow_bifurcation_overview.*
43
44    Flow Bifurcation Overview
45
46
47 Using Flow Bifurcation on Mellanox ConnectX
48 -------------------------------------------
49
50 The Mellanox devices are :ref:`natively bifurcated <bifurcated_driver>`,
51 so there is no need to split into SR-IOV PF/VF
52 in order to get the flow bifurcation mechanism.
53 The full device is already shared with the kernel driver.
54
55 The DPDK application can setup some flow steering rules,
56 and let the rest go to the kernel stack.
57 In order to define the filters strictly with flow rules,
58 the :ref:`flow_isolated_mode` can be configured.
59
60 There is no specific instructions to follow.
61 The recommended reading is the :doc:`../prog_guide/rte_flow` guide.
62 Below is an example of testpmd commands
63 for receiving VXLAN 42 in 4 queues of the DPDK port 0,
64 while all other packets go to the kernel:
65
66 .. code-block:: console
67
68    testpmd> flow isolate 0 true
69    testpmd> flow create 0 ingress pattern eth / ipv4 / udp / vxlan vni is 42 / end \
70             actions rss queues 0 1 2 3 end / end