From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ouyang Changchun Subject: =?utf-8?q?=5BPATCH=5D_doc=3A_Update_doc_for_ixgbe_VF_R?= =?utf-8?q?SS?= Date: Tue, 3 Mar 2015 16:50:48 +0800 Message-ID: <1425372648-21410-1-git-send-email-changchun.ouyang@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable To: dev-VfR2kkLFssw@public.gmane.org Return-path: List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces-VfR2kkLFssw@public.gmane.org Sender: "dev" Since the following commit has already been merged into dpdk.org mainline= , commit: 42d2f78abcb77ecb769be4149df550308169ef0f So update the prog guide for it. Signed-off-by: Changchun Ouyang --- .../prog_guide/i40e_ixgbe_igb_virt_func_drv.rst | 38 ++++++++++++++++= ++++++ 1 file changed, 38 insertions(+) diff --git a/doc/guides/prog_guide/i40e_ixgbe_igb_virt_func_drv.rst b/doc= /guides/prog_guide/i40e_ixgbe_igb_virt_func_drv.rst index 41e316e..3039ba6 100755 --- a/doc/guides/prog_guide/i40e_ixgbe_igb_virt_func_drv.rst +++ b/doc/guides/prog_guide/i40e_ixgbe_igb_virt_func_drv.rst @@ -172,6 +172,44 @@ For example, =20 Launch the DPDK testpmd/example or your own host daemon application = using the DPDK PMD library. =20 +* Using the DPDK PMD PF ixgbe driver to enable VF RSS: + + Same steps as above to install the modules of uio, igb_uio, specify = max_vfs for PCI device, and + launch the DPDK testpmd/example or your own host daemon application = using the DPDK PMD library. + + The available queue number(at most 4) per VF depends on the total nu= mber of pool, which is + determined by the max number of VF at PF initialization stage and th= e number of queue specified + in config: + + * If the max number of VF is set in the range of 1 to 32: + + If the number of rxq is specified as 4(e.g. '--rxq 4' in testpmd= ), then there are totally 32 + pools(ETH_32_POOLS), and each VF could have 4 or less(e.g. 2) qu= eues; + + If the number of rxq is specified as 2(e.g. '--rxq 2' in testpmd= ), then there are totally 32 + pools(ETH_32_POOLS), and each VF could have 2 queues; + + * If the max number of VF is in the range of 33 to 64: + + If the number of rxq is 4 ('--rxq 4' in testpmd), then error mes= sage is expected as rxq is not + correct at this case; + + If the number of rxq is 2 ('--rxq 2' in testpmd), then there is = totally 64 pools(ETH_64_POOLS), + and each VF have 2 queues; + + On host, to enable VF RSS functionality, rx mq mode should be set as= ETH_MQ_RX_VMDQ_RSS + or ETH_MQ_RX_RSS mode, and SRIOV mode should be activated(max_vfs >=3D= 1). + It also needs config VF RSS information like hash function, RSS key,= RSS key length. + + .. code-block:: console + + testpmd -c 0xffff -n 4 -- --coremask=3D --rxq=3D4 --t= xq=3D4 -i + + The limitation for VF RSS on Intel=C2=AE 82599 10 Gigabit Ethernet C= ontroller is: + The hash and key are shared among PF and all VF, the RETA table with= 128 entries is also shared + among PF and all VF; So it could not to provide a method to query th= e hash and reta content per + VF on guest, while, if possible, please query them on host(PF) for t= he shared RETA information. + Virtual Function enumeration is performed in the following sequence by t= he Linux* pci driver for a dual-port NIC. When you enable the four Virtual Functions with the above command, the f= our enabled functions have a Function# represented by (Bus#, Device#, Function#) in sequence starting from 0 to= 3. --=20 1.8.4.2