From 0bca7fa1a3dd86bc75c7daf716b425289927feb7 Mon Sep 17 00:00:00 2001 From: Maxime Coquelin Date: Mon, 24 Jan 2022 17:58:30 +0100 Subject: Documentation: Fix userspace Tx steering section. This patch fixes the thread mode part, as the static thread-to-txq mapping selection depends on whether the number of queues is strictly greater than the number of PMD threads, and not greater or equal. The section is also reworded as per Ilya's suggestion. Fixes: c18e707b2f25 ("dpif-netdev: Introduce hash-based Tx packet steering mode.") Reported-by: Kevin Traynor Reported-by: Ilya Maximets Acked-by: Kevin Traynor Signed-off-by: Maxime Coquelin Signed-off-by: Ilya Maximets --- Documentation/topics/userspace-tx-steering.rst | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) (limited to 'Documentation') diff --git a/Documentation/topics/userspace-tx-steering.rst b/Documentation/topics/userspace-tx-steering.rst index 16f066a8a..3f39eeadb 100644 --- a/Documentation/topics/userspace-tx-steering.rst +++ b/Documentation/topics/userspace-tx-steering.rst @@ -33,15 +33,16 @@ Thread mode This mode is automatically selected when the port's ``tx-steering`` option is set to ``thread`` or unset. -Depending on the port's number of Tx queues being greater or equal than the -number of PMD threads, static txq mapping or XPS will be used. +Thread mode enables static (1:1) thread-to-txq mapping when the number of Tx +queues is greater than number of PMD threads, and dynamic (N:1) mapping if +equal or lower. In this mode a single thread can not use more than 1 transmit +queue of a given port. This is the recommended mode for performance reasons if the number of Tx queues -is greater or equal to the number of PMD threads, because the Tx lock is not -acquired. +is greater than the number of PMD threads, because the Tx lock is not acquired. -If the number of Tx queues is greater than the number of threads, the remaining -Tx queues will not be used. +If the number of Tx queues is greater than the number of threads (including the +main thread), the remaining Tx queues will not be used. This mode is enabled by default. -- cgit v1.2.1