[ovs-dev] [PATCH] Docs: Add DPDK AF_XDP PMD use case.

[David Marchand]

On Thu, Aug 22, 2019 at 10:30 AM Stokes, Ian <ian.stokes at intel.com> wrote:
>
>
> On 8/22/2019 7:00 AM, David Marchand wrote:
> > On Thu, Aug 22, 2019 at 12:49 AM William Tu <u9012063 at gmail.com> wrote:
> >> Add command lines for using DPDK's AF_XDP PMD driver.
> >>
> >> Signed-off-by: William Tu <u9012063 at gmail.com>
> >> ---
> >>   Documentation/intro/install/afxdp.rst | 36 +++++++++++++++++++++++++++++++++++
> >>   1 file changed, 36 insertions(+)
> >>
> >> diff --git a/Documentation/intro/install/afxdp.rst b/Documentation/intro/install/afxdp.rst
> >> index 820e9d993d8f..c3e03b40f3b5 100644
> >> --- a/Documentation/intro/install/afxdp.rst
> >> +++ b/Documentation/intro/install/afxdp.rst
> >> @@ -426,6 +426,42 @@ In the namespace, run drop or bounce back the packet::
> >>     ip netns exec at_ns0 ./xdp_rxq_info --dev p0 --action XDP_TX
> >>
> >>
> >> +Using DPDK's AF_XDP PMD driver
> >> +------------------------------
> >> +Another way to use AF_XDP is to enable DPDK and use DPDK's AF_XDP
> >> +driver. First, enable the AF_XDP PMD config at DPDK's
> >> +config/common_base file by::
> >> +
> >> +  CONFIG_RTE_LIBRTE_PMD_AF_XDP=y
> >> +
> >> +and recompile the DPDK source. Then, compile OVS with DPDK::
> > The AF_XDP pmd went in dpdk 19.05.
> >
> > OVS master uses dpdk 18.11.2.
> > - https://github.com/openvswitch/ovs/commit/446a2a7ede1f377687e8c0d848d63eb5e9988cfa
> > is required to build against 19.05,
> > - https://github.com/openvswitch/ovs/commit/75e5e39e5468cb9f15114f7d8b367d39bc26756c
> > is required to build against 19.08,
> >
> > If you want to have a note in this doc in the master branch, you must
> > properly explain this, or users will be disappointed and complain on
> > the ml :-)
>
>
> +1, also I think we shouldn't reference commits in the docs that
> reference the dpdk-latest branch (I was burned by this before in commit
> messages myself), the reason is I intend to rebase dpdk-latest on master
> after the 2.12 release and as such the commit  IDs will change due to
> the rebase.
>
> I'm not so sure we should even add documentation to master regarding the
> AF_XDP PMD until master moves to 19.11? Possibly the 'dpdk-latest' might
> be a better candidate for this doc change?

Yes, this was my thought too.


-- 
David Marchand