X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fnics%2Faf_xdp.rst;h=052e59a3ae56ea55a03577d15d8162964d6600c7;hb=b94c709decbe39582c68cf3605745b60a4f7985a;hp=78a088468f4d0bb1f42e10a236ed5687cb941677;hpb=74b46340e2d4f6b4b00476ed3790580004f21341;p=dpdk.git diff --git a/doc/guides/nics/af_xdp.rst b/doc/guides/nics/af_xdp.rst index 78a088468f..052e59a3ae 100644 --- a/doc/guides/nics/af_xdp.rst +++ b/doc/guides/nics/af_xdp.rst @@ -34,6 +34,7 @@ The following options can be provided to set up an af_xdp port in DPDK. * ``queue_count`` - total netdev queue number (optional, default 1); * ``shared_umem`` - PMD will attempt to share UMEM with others (optional, default 0); +* ``xdp_prog`` - path to custom xdp program (optional, default none); Prerequisites ------------- @@ -81,3 +82,28 @@ Limitations Note: The AF_XDP PMD will fail to initialise if an MTU which violates the driver's conditions as above is set prior to launching the application. + +- **Shared UMEM** + + The sharing of UMEM is only supported for AF_XDP sockets with unique contexts. + The context refers to the netdev,qid tuple. + + The following combination will fail: + + .. code-block:: console + + --vdev net_af_xdp0,iface=ens786f1,shared_umem=1 \ + --vdev net_af_xdp1,iface=ens786f1,shared_umem=1 \ + + Either of the following however is permitted since either the netdev or qid differs + between the two vdevs: + + .. code-block:: console + + --vdev net_af_xdp0,iface=ens786f1,shared_umem=1 \ + --vdev net_af_xdp1,iface=ens786f1,start_queue=1,shared_umem=1 \ + + .. code-block:: console + + --vdev net_af_xdp0,iface=ens786f1,shared_umem=1 \ + --vdev net_af_xdp1,iface=ens786f2,shared_umem=1 \ \ No newline at end of file