Takashi Iwai 752b5a
From c61d7b2ef141abf81140756b45860a2306f395a2 Mon Sep 17 00:00:00 2001
Takashi Iwai 752b5a
From: Daniel Thompson <daniel.thompson@linaro.org>
Takashi Iwai 752b5a
Date: Thu, 18 Nov 2021 10:09:52 +0000
Takashi Iwai 752b5a
Subject: [PATCH] Documentation: dmaengine: Correctly describe dmatest with channel unset
Takashi Iwai 752b5a
Git-commit: c61d7b2ef141abf81140756b45860a2306f395a2
Takashi Iwai 752b5a
Patch-mainline: v5.17-rc1
Takashi Iwai 752b5a
References: git-fixes
Takashi Iwai 752b5a
Takashi Iwai 752b5a
Currently the documentation states that channels must be configured before
Takashi Iwai 752b5a
running the dmatest. This has not been true since commit 6b41030fdc79
Takashi Iwai 752b5a
("dmaengine: dmatest: Restore default for channel"). Fix accordingly.
Takashi Iwai 752b5a
Takashi Iwai 752b5a
Fixes: 6b41030fdc79 ("dmaengine: dmatest: Restore default for channel")
Takashi Iwai 752b5a
Signed-off-by: Daniel Thompson <daniel.thompson@linaro.org>
Takashi Iwai 752b5a
Link: https://lore.kernel.org/r/20211118100952.27268-3-daniel.thompson@linaro.org
Takashi Iwai 752b5a
Signed-off-by: Vinod Koul <vkoul@kernel.org>
Takashi Iwai 752b5a
Acked-by: Takashi Iwai <tiwai@suse.de>
Takashi Iwai 752b5a
Takashi Iwai 752b5a
---
Takashi Iwai 752b5a
 Documentation/driver-api/dmaengine/dmatest.rst | 7 ++++---
Takashi Iwai 752b5a
 1 file changed, 4 insertions(+), 3 deletions(-)
Takashi Iwai 752b5a
Takashi Iwai 752b5a
diff --git a/Documentation/driver-api/dmaengine/dmatest.rst b/Documentation/driver-api/dmaengine/dmatest.rst
Takashi Iwai 752b5a
index 529cc2cbbb1b..cf9859cd0b43 100644
Takashi Iwai 752b5a
--- a/Documentation/driver-api/dmaengine/dmatest.rst
Takashi Iwai 752b5a
+++ b/Documentation/driver-api/dmaengine/dmatest.rst
Takashi Iwai 752b5a
@@ -153,13 +153,14 @@ Part 5 - Handling channel allocation
Takashi Iwai 752b5a
 Allocating Channels
Takashi Iwai 752b5a
 -------------------
Takashi Iwai 752b5a
 
Takashi Iwai 752b5a
-Channels are required to be configured prior to starting the test run.
Takashi Iwai 752b5a
-Attempting to run the test without configuring the channels will fail.
Takashi Iwai 752b5a
+Channels do not need to be configured prior to starting a test run. Attempting
Takashi Iwai 752b5a
+to run the test without configuring the channels will result in testing any
Takashi Iwai 752b5a
+channels that are available.
Takashi Iwai 752b5a
 
Takashi Iwai 752b5a
 Example::
Takashi Iwai 752b5a
 
Takashi Iwai 752b5a
     % echo 1 > /sys/module/dmatest/parameters/run
Takashi Iwai 752b5a
-    dmatest: Could not start test, no channels configured
Takashi Iwai 752b5a
+    dmatest: No channels configured, continue with any
Takashi Iwai 752b5a
 
Takashi Iwai 752b5a
 Channels are registered using the "channel" parameter. Channels can be requested by their
Takashi Iwai 752b5a
 name, once requested, the channel is registered and a pending thread is added to the test list.
Takashi Iwai 752b5a
-- 
Takashi Iwai 752b5a
2.31.1
Takashi Iwai 752b5a