X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fnics%2Faf_xdp.rst;h=b434b25df7e1b47f6b138348222397e568aca1b2;hb=c62b6e667310a58e444dbaae1d08371a6d221333;hp=0bd4239fed8edcc99bc0435c98b68c1748e7d9ad;hpb=e9ff8bb719434c5ee6ccb6f3acbdac246f965875;p=dpdk.git diff --git a/doc/guides/nics/af_xdp.rst b/doc/guides/nics/af_xdp.rst index 0bd4239fed..b434b25df7 100644 --- a/doc/guides/nics/af_xdp.rst +++ b/doc/guides/nics/af_xdp.rst @@ -21,14 +21,20 @@ be added later. Note that MTU of AF_XDP PMD is limited due to XDP lacks support for fragmentation. +AF_XDP PMD enables need_wakeup flag by default if it is supported. This +need_wakeup feature is used to support executing application and driver on the +same core efficiently. This feature not only has a large positive performance +impact for the one core case, but also does not degrade 2 core performance and +actually improves it for Tx heavy workloads. + Options ------- The following options can be provided to set up an af_xdp port in DPDK. * ``iface`` - name of the Kernel interface to attach to (required); -* ``queue`` - netdev queue id (optional, default 0); -* ``pmd_zero_copy`` - enable zero copy or not (optional, default 0); +* ``start_queue`` - starting netdev queue id (optional, default 0); +* ``queue_count`` - total netdev queue number (optional, default 1); Prerequisites ------------- @@ -40,6 +46,8 @@ This is a Linux-specific PMD, thus the following prerequisites apply: User can install libbpf via `make install_lib` && `make install_headers` in /tools/lib/bpf; * A Kernel bound interface to attach to; +* For need_wakeup feature, it requires kernel version later than v5.3-rc1; +* For PMD zero copy, it requires kernel version later than v5.4-rc1; Set up an af_xdp interface ----------------------------- @@ -48,4 +56,4 @@ The following example will set up an af_xdp interface in DPDK: .. code-block:: console - --vdev net_af_xdp,iface=ens786f1,queue=0 + --vdev net_af_xdp,iface=ens786f1