From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id E3F32A034F for ; Tue, 1 Mar 2022 11:43:46 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id DC02E407FF; Tue, 1 Mar 2022 11:43:46 +0100 (CET) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mails.dpdk.org (Postfix) with ESMTP id 2E41B426DF for ; Tue, 1 Mar 2022 11:43:45 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1646131424; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=06UXRFPsppl/2BmMzkVKiptqYP+u79KZhx3EmuYh62Y=; b=fTrb47ejvYTBHThUZ5Fok95Ub9b69GDFEJiEGcnCgHOKANcPYi1vRVvSzh4jWwGJx96b8+ d3c/8iAGm6W56m6hWVBwGwKqgTDdOjRHMFQu8xAJz3MOssKdnfUqYrKfDLb970Wjw4yrp4 bWIW4XfNX2VhZvpufEuO1Y3f8+Fky2I= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-6-mEmYw-TzMRuVFBoGj1tOtA-1; Tue, 01 Mar 2022 05:43:41 -0500 X-MC-Unique: mEmYw-TzMRuVFBoGj1tOtA-1 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id B02B851DF; Tue, 1 Mar 2022 10:43:40 +0000 (UTC) Received: from rh.Home (unknown [10.39.194.142]) by smtp.corp.redhat.com (Postfix) with ESMTP id A4E1D6FB02; Tue, 1 Mar 2022 10:43:39 +0000 (UTC) From: Kevin Traynor To: Bruce Richardson Cc: Kevin Laatz , dpdk stable Subject: patch 'doc: improve configuration examples in idxd guide' has been queued to stable release 21.11.1 Date: Tue, 1 Mar 2022 10:41:33 +0000 Message-Id: <20220301104300.334382-17-ktraynor@redhat.com> In-Reply-To: <20220301104300.334382-1-ktraynor@redhat.com> References: <20220301104300.334382-1-ktraynor@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=ktraynor@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset="US-ASCII" X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org Hi, FYI, your patch has been queued to stable release 21.11.1 Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet. It will be pushed if I get no objections before 03/06/22. So please shout if anyone has objections. Also note that after the patch there's a diff of the upstream commit vs the patch applied to the branch. This will indicate if there was any rebasing needed to apply to the stable branch. If there were code changes for rebasing (ie: not only metadata diffs), please double check that the rebase was correctly done. Queued patches are on a temporary branch at: https://github.com/kevintraynor/dpdk-stable This queued commit can be viewed at: https://github.com/kevintraynor/dpdk-stable/commit/9970eab8c427905c6189ea4e1de0b56395fdc855 Thanks. Kevin --- >From 9970eab8c427905c6189ea4e1de0b56395fdc855 Mon Sep 17 00:00:00 2001 From: Bruce Richardson Date: Wed, 16 Feb 2022 16:06:09 +0000 Subject: [PATCH] doc: improve configuration examples in idxd guide [ upstream commit 7a8a886f38a5a6dfc0bc42fe46ae1feb45d805b8 ] The documentation on how to configure device instances using accel-config can be improved by a number of changes: * For initial example, when only configuring one queue, omit configuration of a second engine, which is unused later. * Add the "max-batch-size" setting to the options being configured for each queue * Add a final, more complete example, showing configuration of multiple queues on a device. Signed-off-by: Bruce Richardson Reviewed-by: Kevin Laatz --- doc/guides/dmadevs/idxd.rst | 29 +++++++++++++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/doc/guides/dmadevs/idxd.rst b/doc/guides/dmadevs/idxd.rst index d4a210b854..81451afd4d 100644 --- a/doc/guides/dmadevs/idxd.rst +++ b/doc/guides/dmadevs/idxd.rst @@ -56,5 +56,4 @@ To assign an engine to a group:: $ accel-config config-engine dsa0/engine0.0 --group-id=0 - $ accel-config config-engine dsa0/engine0.1 --group-id=1 To assign work queues to groups for passing descriptors to the engines a similar accel-config command can be used. @@ -72,5 +71,5 @@ Example configuration for a work queue:: $ accel-config config-wq dsa0/wq0.0 --group-id=0 \ --mode=dedicated --priority=10 --wq-size=8 \ - --type=user --name=dpdk_app1 + --max-batch-size=512 --type=user --name=dpdk_app1 Once the devices have been configured, they need to be enabled:: @@ -83,4 +82,30 @@ Check the device configuration:: $ accel-config list +Every Intel\ |reg| DSA instance supports multiple queues and each should be similarly configured. +As a further example, the following set of commands will configure and enable 4 queues on instance 0, +giving each an equal share of resources:: + + # configure 4 groups, each with one engine + accel-config config-engine dsa0/engine0.0 --group-id=0 + accel-config config-engine dsa0/engine0.1 --group-id=1 + accel-config config-engine dsa0/engine0.2 --group-id=2 + accel-config config-engine dsa0/engine0.3 --group-id=3 + + # configure 4 queues, putting each in a different group, so each + # is backed by a single engine + accel-config config-wq dsa0/wq0.0 --group-id=0 --type=user --wq-size=32 \ + --priority=10 --max-batch-size=1024 --mode=dedicated --name=dpdk_app1 + accel-config config-wq dsa0/wq0.1 --group-id=1 --type=user --wq-size=32 \ + --priority=10 --max-batch-size=1024 --mode=dedicated --name=dpdk_app1 + accel-config config-wq dsa0/wq0.2 --group-id=2 --type=user --wq-size=32 \ + --priority=10 --max-batch-size=1024 --mode=dedicated --name=dpdk_app1 + accel-config config-wq dsa0/wq0.3 --group-id=3 --type=user --wq-size=32 \ + --priority=10 --max-batch-size=1024 --mode=dedicated --name=dpdk_app1 + + # enable device and queues + accel-config enable-device dsa0 + accel-config enable-wq dsa0/wq0.0 dsa0/wq0.1 dsa0/wq0.2 dsa0/wq0.3 + + Devices using VFIO/UIO drivers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 2.34.1 --- Diff of the applied patch vs upstream commit (please double-check if non-empty: --- --- - 2022-03-01 10:41:01.862405548 +0000 +++ 0017-doc-improve-configuration-examples-in-idxd-guide.patch 2022-03-01 10:41:01.252244087 +0000 @@ -1 +1 @@ -From 7a8a886f38a5a6dfc0bc42fe46ae1feb45d805b8 Mon Sep 17 00:00:00 2001 +From 9970eab8c427905c6189ea4e1de0b56395fdc855 Mon Sep 17 00:00:00 2001 @@ -5,0 +6,2 @@ +[ upstream commit 7a8a886f38a5a6dfc0bc42fe46ae1feb45d805b8 ] + @@ -16,2 +17,0 @@ -Cc: stable@dpdk.org - @@ -25 +25 @@ -index 8d7cea6583..bdfd3e78ad 100644 +index d4a210b854..81451afd4d 100644