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

[Guo, Jia]

Hi,john
      The "bind uio_pci_generic`` is not the definitely command, but very appreciate for your correcting the other syntax issue. I will involve them in v4, Thanks very much.

Best regards,
Jeff Guo


-----Original Message-----
From: Mcnamara, John 
Sent: Thursday, January 19, 2017 7:17 PM
To: Guo, Jia <jia.guo at intel.com>; Zhang, Helin <helin.zhang at intel.com>; Wu, Jingjing <jingjing.wu at intel.com>
Cc: dev at dpdk.org; Guo, Jia <jia.guo at intel.com>; Guo at dpdk.org
Subject: RE: [dpdk-dev] [PATCH v3] doc: add known uio_pci_generic issue for i40e



> -----Original Message-----
> From: dev [mailto:dev-bounces at dpdk.org] On Behalf Of Jeff Guo
> Sent: Thursday, January 19, 2017 10:57 AM
> To: Zhang, Helin <helin.zhang at intel.com>; Wu, Jingjing 
> <jingjing.wu at intel.com>
> Cc: dev at dpdk.org; Guo, Jia <jia.guo at intel.com>; Guo at dpdk.org
> Subject: [dpdk-dev] [PATCH v3] doc: add known uio_pci_generic issue 
> for i40e
> 
> +
> +The uio_pci_generic module bind failed in X710/XL710/XXV710
> +-----------------------------------------------------------
> +
> +**Description**:
> +   The “uio_pci_generic” module is not supported by XL710, since the
> errata of XL710
> +   states that 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/x
> l710 -10-40-controller-spec-update.html>`_.
> +   The hw limitation is the same as other X710/XXV710 NICs.
> +
> +**Implication**:
> +   When bind the “uio_pci_generic” module, it probe device and check 
> +the
> Interrupt Status

Better as: When using ``bind uio_pci_generic``, it probes the device


> +   bit. Since it is not supported by X710/XL710/XXV710, it return a
> *failed* value. The statement
> +   that these products don’t support INTx masking, is indicated in 
> + the
> related `linux kernel commit
> +   < https://git.kernel.org/cgit/linux/kernel/git/stable/linux-
> stable.git/commit/drivers/pci/quirks.c?id=8bcf4525c5d43306c5fd07e132bc
> 8650
> e3491aec>`_.
> +
> +**Resolution/Workaround**:
> +   Do not bind to use the “uio_pci_generic” module in 
> +X710/XL710/XXV710
> NICs.

Better as: Do not bind to ``uio_pci_generic`` in X710/XL710/XXV710 NICs.