[PWCI] "app/testpmd: warn on shared rxq switch mismatch"

VERSION

@@ -1 +1 @@
-25.11.0-rc3
+25.11.0-rc4

app/test-pmd/testpmd.c

@@ -2675,6 +2675,48 @@ rx_queue_setup(uint16_t port_id, uint16_t rx_queue_id,
 	uint32_t prev_hdrs = 0;
 	int ret;
 
+	if (rx_conf->share_group > 0) {
+		/* Additional warnings for bad Rx queue sharing */
+
+		const uint16_t dom_id = ports[port_id].dev_info.switch_info.domain_id;
+		const uint16_t rx_dom = ports[port_id].dev_info.switch_info.rx_domain;
+
+		uint16_t pid;
+		RTE_ETH_FOREACH_DEV(pid) {
+			struct rte_port *o_port = &ports[pid];
+			for (uint16_t q = 0; q < nb_rxq; ++q) {
+				struct port_rxqueue *rxq = &o_port->rxq[q];
+				if (rxq->conf.share_group != rx_conf->share_group ||
+						rxq->conf.share_qid != rx_conf->share_qid)
+					continue;
+
+				const uint16_t o_dom_id = o_port->dev_info.switch_info.domain_id;
+				const uint16_t o_rx_dom = o_port->dev_info.switch_info.rx_domain;
+
+				if (o_dom_id != dom_id) {
+					fprintf(stderr, "Bad shared rxq config: "
+						"switch domain mismatch in share group/qid %u/%u: "
+						"%u (port %u) vs. %u (port %u)\n",
+						(unsigned int)rxq->conf.share_group,
+						(unsigned int)rxq->conf.share_qid,
+						(unsigned int)dom_id,
+						(unsigned int)port_id,
+						(unsigned int)o_dom_id,
+						(unsigned int)pid);
+				} else if (o_rx_dom != rx_dom) {
+					fprintf(stderr, "Bad shared rxq config: "
+						"switch rx domain mismatch in share group/qid %u/%u: "
+						"%u (port %u) vs. %u (port %u)\n",
+						(unsigned int)rxq->conf.share_group,
+						(unsigned int)rxq->conf.share_qid,
+						(unsigned int)rx_dom,
+						(unsigned int)port_id,
+						(unsigned int)o_rx_dom,
+						(unsigned int)pid);
+				}
+			}
+		}
+	}
 
 	if ((rx_pkt_nb_segs > 1) &&
 	    (rx_conf->offloads & RTE_ETH_RX_OFFLOAD_BUFFER_SPLIT)) {

doc/api/meson.build

@@ -27,6 +27,7 @@ example = custom_target('examples.dox',
         depfile: 'examples.dox.d',
         install: get_option('enable_docs'),
         install_dir: htmldir,
+        install_tag: 'doc',
         build_by_default: get_option('enable_docs'))
 
 # set up common Doxygen configuration
@@ -76,6 +77,7 @@ doxy_html_build = custom_target('doxygen-html',
         command: [generate_doxygen, '@OUTPUT@', doxygen, '@INPUT@'],
         install: get_option('enable_docs'),
         install_dir: htmldir,
+        install_tag: 'doc',
         build_by_default: get_option('enable_docs'))
 
 doc_targets += doxy_html_build
@@ -90,6 +92,7 @@ doxy_man_build = custom_target('doxygen-man',
         command: [generate_doxygen, '@OUTPUT@', doxygen, '@INPUT@'],
         install: get_option('enable_docs'),
         install_dir: get_option('datadir'),
+        install_tag: 'doc',
         build_by_default: get_option('enable_docs'))
 
 doc_targets += doxy_man_build

doc/guides/cryptodevs/ionic.rst

@@ -1,5 +1,5 @@
 .. SPDX-License-Identifier: BSD-3-Clause
-   Copyright 2021-2024 Advanced Micro Devices, Inc.
+   Copyright 2021-2025 Advanced Micro Devices, Inc.
 
 IONIC Crypto Driver
 ===================
@@ -16,6 +16,8 @@ It currently supports the below models:
   `(pdf) <https://www.amd.com/content/dam/amd/en/documents/pensando-technical-docs/product-briefs/pensando-elba-product-brief.pdf>`__
 - DSC3-400 dual-port 400G Distributed Services Card
   `(pdf) <https://www.amd.com/content/dam/amd/en/documents/pensando-technical-docs/product-briefs/pensando-dsc3-product-brief.pdf>`__
+- Pollara 400 single-port 400G AI NIC
+  `(pdf) <https://www.amd.com/content/dam/amd/en/documents/pensando-technical-docs/product-briefs/pollara-product-brief.pdf>`__
 
 Please visit the
 `AMD Pensando Networking

doc/guides/freebsd_gsg/build_dpdk.rst

@@ -16,16 +16,16 @@ The following FreeBSD packages are required to build DPDK:
 * meson
 * ninja
 * pkgconf
-* py38-pyelftools
+* py311-pyelftools
 
-.. note:
+.. note::
 
-  The specific package for pyelftools is dependent on the version of python in use,
-  Python 3.8 being the version at type of writing, hence the ``py38`` prefix.
+   The specific package for pyelftools is dependent on the version of python in use,
+   Python 3.11 being the version at type of writing, hence the ``py311`` prefix.
 
 These can be installed using (as root)::
 
-  pkg install meson pkgconf py38-pyelftools
+   pkg install meson pkgconf py311-pyelftools
 
 To compile the required kernel modules for memory management and working
 with physical NIC devices, the kernel sources for FreeBSD also

doc/guides/linux_gsg/amd_platform.rst

@@ -22,7 +22,9 @@ Tuning Guides for AMD EPYC SoC
 
 #. `GENOA <https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/tuning-guides/58017-amd-epyc-9004-tg-data-plane-dpdk.pdf>`_
 
-#. `BERGAMO|SIENNA <https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/tuning-guides/58310_amd-epyc-8004-tg-data-plane-dpdk.pdf>`_
+#. `BERGAMO|SIENA <https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/tuning-guides/58310_amd-epyc-8004-tg-data-plane-dpdk.pdf>`_
+
+#. `TURIN <https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/tuning-guides/58468_amd-epyc-9005-tg-data-plane-dpdk.pdf>`_
 
 
 General Requirements
@@ -86,10 +88,43 @@ Core
 ~~~~
 
 AMD EPYC SoC supports CPU power functions via ``rte_power`` API from `23.11 LTS` onwards.
-These are tested and validated on MILAN, GENOA, BERGAMO and SIENA
-using Linux kernel `6.4` and above with ``amd_pstate`` power driver.
+These are tested and validated on MILAN, GENOA, BERGAMO, SIENA and TURIN
+using Linux kernel `6.4` and above with ``amd_pstate`` power driver in ``passive`` mode.
 
 .. note::
 
    * Power libraries are supported on Linux only.
    * DPDK uncore support on Linux is work in progress.
+
+Uncore
+~~~~~~
+
+AMD EPYC SoC support UNCORE power functions via ``rte_power_uncore`` from `25.03` onwards.
+These are tested and validated on GENOA, SIENA and TURIN.
+Please refer the tuning guides to enable ``HSMP`` and DPDK power management guide.
+
+
+NIC
+---
+
+To use Solarflare x4 on AMD EPYC TURIN, please ensure the following
+
+#. Upgrade Linux or distro version to 6.13 or higher.
+
+#. Disable PCIe power option via ``vfio-pci.disable_idle_d3=1`` in GRUB.
+
+#. Enable the hardware with out-of-tree sfc (contact Solarflare) Linux kernel driver first;
+   then bind with ``vfio-pci`` next.
+
+#. Please use PMD args ``fw_variant=ultra-low-latency,perf_profile=throughput``.
+
+To use Solarflare x2 on AMD EPYC TURIN, please ensure the following
+
+#. Upgrade Linux or distro version to 6.13 or higher.
+
+#. Disable PCIe power option via ``vfio-pci.disable_idle_d3=1`` in GRUB.
+
+#. Enable the hardware with ``sfc`` Linux Kernel Driver first;
+   then bind with ``vfio-pci`` next.
+
+#. Please use PMD args ``fw_variant=ultra-low-latency,perf_profile=throughput``.

doc/guides/meson.build

@@ -22,6 +22,7 @@ html_guides = custom_target('html_guides',
         depfile: '.html.d',
         build_by_default: get_option('enable_docs'),
         install: get_option('enable_docs'),
+        install_tag: 'doc',
         install_dir: htmldir)
 
 doc_targets += html_guides

doc/guides/nics/i40e.rst

@@ -104,6 +104,8 @@ For X710/XL710/XXV710,
    +--------------+-----------------------+------------------+
    | DPDK version | Kernel driver version | Firmware version |
    +==============+=======================+==================+
+   |    25.11     |         2.28.13       |       9.55       |
+   +--------------+-----------------------+------------------+
    |    25.07     |         2.28.7        |       9.54       |
    +--------------+-----------------------+------------------+
    |    25.03     |         2.27.8        |       9.53       |
@@ -128,57 +130,15 @@ For X710/XL710/XXV710,
    +--------------+-----------------------+------------------+
    |    21.11     |         2.17.4        |       8.30       |
    +--------------+-----------------------+------------------+
-   |    21.08     |         2.15.9        |       8.30       |
-   +--------------+-----------------------+------------------+
-   |    21.05     |         2.15.9        |       8.30       |
-   +--------------+-----------------------+------------------+
-   |    21.02     |         2.14.13       |       8.00       |
-   +--------------+-----------------------+------------------+
-   |    20.11     |         2.14.13       |       8.00       |
-   +--------------+-----------------------+------------------+
-   |    20.08     |         2.12.6        |       7.30       |
-   +--------------+-----------------------+------------------+
-   |    20.05     |         2.11.27       |       7.30       |
-   +--------------+-----------------------+------------------+
-   |    20.02     |         2.10.19       |       7.20       |
-   +--------------+-----------------------+------------------+
-   |    19.11     |         2.9.21        |       7.00       |
-   +--------------+-----------------------+------------------+
-   |    19.08     |         2.8.43        |       7.00       |
-   +--------------+-----------------------+------------------+
-   |    19.05     |         2.7.29        |       6.80       |
-   +--------------+-----------------------+------------------+
-   |    19.02     |         2.7.26        |       6.80       |
-   +--------------+-----------------------+------------------+
-   |    18.11     |         2.4.6         |       6.01       |
-   +--------------+-----------------------+------------------+
-   |    18.08     |         2.4.6         |       6.01       |
-   +--------------+-----------------------+------------------+
-   |    18.05     |         2.4.6         |       6.01       |
-   +--------------+-----------------------+------------------+
-   |    18.02     |         2.4.3         |       6.01       |
-   +--------------+-----------------------+------------------+
-   |    17.11     |         2.1.26        |       6.01       |
-   +--------------+-----------------------+------------------+
-   |    17.08     |         2.0.19        |       6.01       |
-   +--------------+-----------------------+------------------+
-   |    17.05     |         1.5.23        |       5.05       |
-   +--------------+-----------------------+------------------+
-   |    17.02     |         1.5.23        |       5.05       |
-   +--------------+-----------------------+------------------+
-   |    16.11     |         1.5.23        |       5.05       |
-   +--------------+-----------------------+------------------+
-   |    16.07     |         1.4.25        |       5.04       |
-   +--------------+-----------------------+------------------+
-   |    16.04     |         1.4.25        |       5.02       |
-   +--------------+-----------------------+------------------+
 
 
 For X722,
 
    +--------------+-----------------------+------------------+
    | DPDK version | Kernel driver version | Firmware version |
    +==============+=======================+==================+
+   |    25.11     |         2.28.13       |       6.51       |
+   +--------------+-----------------------+------------------+
    |    25.07     |         2.28.7        |       6.50       |
    +--------------+-----------------------+------------------+
    |    25.03     |         2.27.8        |       6.50       |
@@ -203,30 +163,6 @@ For X722,
    +--------------+-----------------------+------------------+
    |    21.11     |         2.17.4        |       5.30       |
    +--------------+-----------------------+------------------+
-   |    21.08     |         2.15.9        |       5.30       |
-   +--------------+-----------------------+------------------+
-   |    21.05     |         2.15.9        |       5.30       |
-   +--------------+-----------------------+------------------+
-   |    21.02     |         2.14.13       |       5.00       |
-   +--------------+-----------------------+------------------+
-   |    20.11     |         2.13.10       |       5.00       |
-   +--------------+-----------------------+------------------+
-   |    20.08     |         2.12.6        |       4.11       |
-   +--------------+-----------------------+------------------+
-   |    20.05     |         2.11.27       |       4.11       |
-   +--------------+-----------------------+------------------+
-   |    20.02     |         2.10.19       |       4.11       |
-   +--------------+-----------------------+------------------+
-   |    19.11     |         2.9.21        |       4.10       |
-   +--------------+-----------------------+------------------+
-   |    19.08     |         2.9.21        |       4.10       |
-   +--------------+-----------------------+------------------+
-   |    19.05     |         2.7.29        |       3.33       |
-   +--------------+-----------------------+------------------+
-   |    19.02     |         2.7.26        |       3.33       |
-   +--------------+-----------------------+------------------+
-   |    18.11     |         2.4.6         |       3.33       |
-   +--------------+-----------------------+------------------+
 
 
 Configuration

doc/guides/nics/ice.rst

@@ -63,14 +63,6 @@ For E810,
    +-----------+---------------+-----------------+-----------+--------------+-----------+
    |    DPDK   | Kernel Driver | OS Default DDP  | COMMS DDP | Wireless DDP | Firmware  |
    +===========+===============+=================+===========+==============+===========+
-   |    20.11  |     1.3.2     |      1.3.20     |  1.3.24   |      N/A     |    2.3    |
-   +-----------+---------------+-----------------+-----------+--------------+-----------+
-   |    21.02  |     1.4.11    |      1.3.24     |  1.3.28   |    1.3.4     |    2.4    |
-   +-----------+---------------+-----------------+-----------+--------------+-----------+
-   |    21.05  |     1.6.5     |      1.3.26     |  1.3.30   |    1.3.6     |    3.0    |
-   +-----------+---------------+-----------------+-----------+--------------+-----------+
-   |    21.08  |     1.7.16    |      1.3.27     |  1.3.31   |    1.3.7     |    3.1    |
-   +-----------+---------------+-----------------+-----------+--------------+-----------+
    |    21.11  |     1.7.16    |      1.3.27     |  1.3.31   |    1.3.7     |    3.1    |
    +-----------+---------------+-----------------+-----------+--------------+-----------+
    |    22.03  |     1.8.3     |      1.3.28     |  1.3.35   |    1.3.8     |    3.2    |
@@ -95,6 +87,8 @@ For E810,
    +-----------+---------------+-----------------+-----------+--------------+-----------+
    |    25.07  |     2.2.8     |      1.3.43     |  1.3.55   |    1.3.23    |    4.8    |
    +-----------+---------------+-----------------+-----------+--------------+-----------+
+   |    25.11  |     2.3.14    |      1.3.43     |  1.3.55   |    1.3.25    |    4.9    |
+   +-----------+---------------+-----------------+-----------+--------------+-----------+
 
 For E830,
 
@@ -103,7 +97,8 @@ For E830,
    +===========+===============+=================+===========+==============+===========+
    |    25.07  |     2.2.8     |      1.3.43     |  1.3.55   |    1.3.23    |    1.0    |
    +-----------+---------------+-----------------+-----------+--------------+-----------+
-
+   |    25.11  |     2.3.14    |      1.3.43     |  1.3.55   |    1.3.25    |    1.2    |
+   +-----------+---------------+-----------------+-----------+--------------+-----------+
 
 Dynamic Device Personalization (DDP) package loading
 ----------------------------------------------------

doc/guides/nics/ionic.rst

@@ -1,5 +1,5 @@
 ..  SPDX-License-Identifier: BSD-3-Clause
-    Copyright 2018-2022 Advanced Micro Devices, Inc.
+    Copyright 2018-2025 Advanced Micro Devices, Inc.
 
 IONIC Driver
 ============
@@ -15,6 +15,8 @@ It currently supports the below models:
   `(pdf) <https://www.amd.com/content/dam/amd/en/documents/pensando-technical-docs/product-briefs/pensando-elba-product-brief.pdf>`__
 - DSC3-400 dual-port 400G Distributed Services Card
   `(pdf) <https://www.amd.com/content/dam/amd/en/documents/pensando-technical-docs/product-briefs/pensando-dsc3-product-brief.pdf>`__
+- Pollara 400 single-port 400G AI NIC
+  `(pdf) <https://www.amd.com/content/dam/amd/en/documents/pensando-technical-docs/product-briefs/pollara-product-brief.pdf>`__
 
 Please visit the
 `AMD Pensando Networking