doc: thunderx: explain which PCI is secondary VF
diff mbox series

Message ID 20200128133147.16500-1-kkanas@marvell.com
State Accepted
Delegated to: Jerin Jacob
Headers show
Series
  • doc: thunderx: explain which PCI is secondary VF
Related show

Checks

Context Check Description
ci/Intel-compilation fail Compilation issues
ci/travis-robot warning Travis build: failed
ci/checkpatch success coding style OK

Commit Message

Krzysztof Kanas Jan. 28, 2020, 1:31 p.m. UTC
From: Krzysztof Kanas <kkanas@marvell.com>

Thunderx-nic uses secondary VF's to provide more queues to DPDK.
Current instructions explain the concept but don't show easy way to find
which PCI id is primary and which is secondary VF's.

Signed-off-by: Krzysztof Kanas <kkanas@marvell.com>
---
 doc/guides/nics/thunderx.rst | 48 ++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

Comments

Jerin Jacob Feb. 3, 2020, 8:06 a.m. UTC | #1
On Tue, Jan 28, 2020 at 7:01 PM <kkanas@marvell.com> wrote:
>
> From: Krzysztof Kanas <kkanas@marvell.com>
>
> Thunderx-nic uses secondary VF's to provide more queues to DPDK.
> Current instructions explain the concept but don't show easy way to find
> which PCI id is primary and which is secondary VF's.
>
> Signed-off-by: Krzysztof Kanas <kkanas@marvell.com>
> ---
>  doc/guides/nics/thunderx.rst | 48 ++++++++++++++++++++++++++++++++++++
>  1 file changed, 48 insertions(+)

1) Fixed the following warning
- dpdk-next-net-mrvl/doc/guides/nics/thunderx.rst:321: WARNING:
Explicit markup ends without a blank line; unexpected unindent.

2) Slightly reworded the git commit message.
    doc/thunderx: add secondary VF enumeration details

    thunderx-nic uses secondary VF's to provide more queues to DPDK.
    Current instructions explain the concept but don't show an easy way to find
    which PCI id is primary and which is secondary VF's.

    This patch extending the documentation of secondary VF w.r.t
    the enumeration details.

Acked-by: Jerin Jacob <jerinj@marvell.com>
Applied to dpdk-next-net-mrvl/master. Thanks

Patch
diff mbox series

diff --git a/doc/guides/nics/thunderx.rst b/doc/guides/nics/thunderx.rst
index 3b75a9a9afb5..fd66bda36ae4 100644
--- a/doc/guides/nics/thunderx.rst
+++ b/doc/guides/nics/thunderx.rst
@@ -313,6 +313,54 @@  We will choose four secondary queue sets from the ending of the list (0002:01:01
 
 The nicvf thunderx driver will make use of attached secondary VFs automatically during the interface configuration stage.
 
+driver thunder-nic VF's
+~~~~~~~~~~~~~~~~~~~~~~~
+
+To distinguish thunder-nic primary VFs and secondary VFs you can use sysfs
+   .. code-block:: console
+   ll /sys/bus/pci/drivers/thunder-nic/
+   total 0
+   drwxr-xr-x  2 root root     0 Jan 22 11:19 ./
+   drwxr-xr-x 86 root root     0 Jan 22 11:07 ../
+   lrwxrwxrwx  1 root root     0 Jan 22 11:19 0001:01:00.0 -> '../../../../devices/platform/soc@0/849000000000.pci/pci0001:00/0001:00:10.0/0001:01:00.0'/
+
+   cat /sys/bus/pci/drivers/thunder-nic/0001\:01\:00.0/sriov_sqs_assignment
+   12
+   0 0001:01:00.1 vfio-pci +: 12 13
+   1 0001:01:00.2 thunder-nicvf -:
+   2 0001:01:00.3 thunder-nicvf -:
+   3 0001:01:00.4 thunder-nicvf -:
+   4 0001:01:00.5 thunder-nicvf -:
+   5 0001:01:00.6 thunder-nicvf -:
+   6 0001:01:00.7 thunder-nicvf -:
+   7 0001:01:01.0 thunder-nicvf -:
+   8 0001:01:01.1 thunder-nicvf -:
+   9 0001:01:01.2 thunder-nicvf -:
+   10 0001:01:01.3 thunder-nicvf -:
+   11 0001:01:01.4 thunder-nicvf -:
+   12 0001:01:01.5 vfio-pci: 0
+   13 0001:01:01.6 vfio-pci: 0
+   14 0001:01:01.7 thunder-nicvf: 255
+   15 0001:01:02.0 thunder-nicvf: 255
+   16 0001:01:02.1 thunder-nicvf: 255
+   17 0001:01:02.2 thunder-nicvf: 255
+   18 0001:01:02.3 thunder-nicvf: 255
+   19 0001:01:02.4 thunder-nicvf: 255
+   20 0001:01:02.5 thunder-nicvf: 255
+   21 0001:01:02.6 thunder-nicvf: 255
+   22 0001:01:02.7 thunder-nicvf: 255
+   23 0001:01:03.0 thunder-nicvf: 255
+   24 0001:01:03.1 thunder-nicvf: 255
+   25 0001:01:03.2 thunder-nicvf: 255
+   26 0001:01:03.3 thunder-nicvf: 255
+   27 0001:01:03.4 thunder-nicvf: 255
+   28 0001:01:03.5 thunder-nicvf: 255
+   29 0001:01:03.6 thunder-nicvf: 255
+   30 0001:01:03.7 thunder-nicvf: 255
+   31 0001:01:04.0 thunder-nicvf: 255
+
+Every column that ends with 'thunder-nicvf: number' can be used as secondary VF.
+In printout above all entres after '14 0001:01:01.7 thunder-nicvf: 255' can be used as secondary VF.
 
 Module params
 --------------