Re: [PATCH blktests v2 2/2] doc: document how to configure bcache tests

[Shinichiro Kawasaki <shinichiro.kawasaki@wdc.com>]

On Jan 21, 2026 / 15:36, Daniel Wagner wrote:
> Add a bcache entry in running-tests which explains how to configure
> blktests for the bcache tests.
> 
> Signed-off-by: Daniel Wagner <dwagner@suse.de>
> ---
>  Documentation/running-tests.md | 16 ++++++++++++++++
>  1 file changed, 16 insertions(+)
> 
> diff --git a/Documentation/running-tests.md b/Documentation/running-tests.md
> index f9da042bb3a0..c4abc6767cd0 100644
> --- a/Documentation/running-tests.md
> +++ b/Documentation/running-tests.md
> @@ -189,6 +189,22 @@ THROTL_BLKDEV_TYPES="sdebug" ./check throtl/
>  THROTL_BLKDEV_TYPES="nullb sdebug" ./check throtl/
>  ```
>  
> +### bcache test configuration
> +
> +The bcache tests require multiple devices to run simultaneously. By default,
> +blktests executes each test case iteratively for every individual device listed
> +in TEST_DEVS. This standard behavior makes it impossible to pass a group of
> +devices into a single test via TEST_DEVS.
> +
> +To solve this, the TEST_CASE_DEV_ARRAY was introduced. This allows for custom
> +device configurations on a per-test basis. For bcache tests, a minimum of three
> +devices is required. Configuration Example
> +
> +Add the following to your configuration to define the devices used for all
> +bcache tests:

As you noted in the cover letter, TEST_CASE_DEV_ARRAY is already described in
running-tests.md. So I think this section can be some more concise. My quick
rewrite is as follows. If it makes sense for you, please consider to pick it up.


### Bcache test configuration

The bcache tests require multiple devices to run simultaneously. By default,
blktests run each test case for each device in TEST_DEVS. This behavior
prevents testing with multiple devices. The TEST_CASE_DEV_ARRAY resolves this by
enabling multiple device configurations per test. Bcache tests need at
least three devices, which can be specified in your configuration as follows:

> +
> +TEST_CASE_DEV_ARRAY[bcache/*]="/dev/nvme0n1 /dev/vdb /dev/vdc"
> +
>  ### Normal user
>  
>  To run test cases which require normal user privilege, prepare a user and
> 
> -- 
> 2.52.0
>