[dpdk-dev] [PATCH v2] doc: add known uio_pci_generic issue for i40e

[Ferruh Yigit]

On 2/12/2016 4:39 PM, Jeff Guo wrote:
> From: "Guo, Jia" <jia.guo at intel.com>
> 
> When bind with uio_pci_generic in X710/XL710/XXV710, the result
> is failed. uio_pci_generic is not supported by X710/XL710/XXV710.

Hi Jeff,

There is a Linux commit causing the issue, right. Commit done because of
the reasons mentioned in "Description". Do you think does it make sense
to note that Linux commit, and Linux kernel version that has been
introduced?

> 
> Signed-off-by: Guo, Jia <jia.guo at intel.com>

You are known as "Jeff Guo <jia.guo at intel.com>" to DPDK repo, based on
previous commits.
If this is correct, is there any problem to continue like this?

> ---
> v2: add X710/XXV710 limitation case

Also v1 Acked-by JingJing already, you can keep her ack in next version
of the patch.

> ---
>  doc/guides/rel_notes/known_issues.rst | 24 ++++++++++++++++++++++++
>  1 file changed, 24 insertions(+)
> 
> diff --git a/doc/guides/rel_notes/known_issues.rst b/doc/guides/rel_notes/known_issues.rst
> index 3cd4237..1751451 100644
> --- a/doc/guides/rel_notes/known_issues.rst
> +++ b/doc/guides/rel_notes/known_issues.rst
> @@ -640,3 +640,27 @@ I40e VF may not receive packets in the promiscuous mode
>  
>  **Driver/Module**:
>     Poll Mode Driver (PMD).
> +
> +
> +uio_pci_generic bind failed in X710/XL710/XXV710
> +-------------------------------------------------------
> +
> +**Description**:
> +   uio_pci_generic is not supported by XL710, since the errata of XL710 that the feature
> +   about the Interrupt Status bit is not implemented.The errata is the item #71 from the
> +   `xl710 controller spec  <http://www.intel.com/content/www/us/en/embedded/products/networking/xl710-10-40-controller-spec-update.html>`_.
> +   The hw limitation is the same as other X710/XXV710 NICs.
> +
> +**Implication**:
> +   When bind uio_pci_generic, the uio_pci_generic probe device and check the Interrupt
> +   Status bit related feature of NICs , since it is not supported by X710/XL710/XXV710,
> +   so it return failed.
> +
> +**Resolution/Workaround**:
> +   Do not bind to use uio_pci_generic in X710/XL710/XXV710 NICs.
> +
> +**Affected Environment/Platform**:
> +   All.
> +
> +**Driver/Module**:
> +   Poll Mode Driver (PMD).
>