.. index:: pair: group; Test RSS viability
.. _doxid-group__usecases-rss:

Test RSS viability
==================

.. toctree::
	:hidden:

	group_usecases-rss-run.rst

Test RSS viability

Make sure that if RSS is enabled, sent packets are received by the corresponding queue

#. Prepare ethernet device state for test

#. Initialise the port in order to obtain RSS capabilities

#. Enable RSS_HASH offload if it is supported

#. Check maximum number of Rx queues

#. Request appropriate RSS configuration that will be applied on device configure stage

#. Start the Ethernet device

#. Prepare a packet by **tmpl**

#. Get RSS Redirection Table. If the corresponding RPC is not supported, use default Redirection Table

#. Get RSS hash configuration. If the corresponding RPC is not supported, use previously requested configuration

#. Calculate packet hash, using Toeplitz function and current hash key

#. Determine the queue index by means of the hash

#. Ensure that interface is UP on Tester side

#. Transmit the packet from **tst_if**

#. Try to receive the packet on **expected_queue** Make sure that the packet received matches the packet sent

#. Check RSS hash value if it is available

#. Check other Rx queues to collect diagnostics



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- tmpl

		- The template of packet

	*
		- nb_rx_queues

		- The number of RX queues

|	:ref:`rss<doxid-group__usecases-rss-run>`