[PATCH 1/2] drm/vkms: Fix run-tests.sh script name

[PATCH 1/2] drm/vkms: Fix run-tests.sh script name

[José Expósito]

The script is "run-tests.sh", no "run-test.sh".

Signed-off-by: José Expósito <jose.exposito89@gmail.com>
---
 Documentation/gpu/vkms.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/gpu/vkms.rst b/Documentation/gpu/vkms.rst
index 3574e01b928d..d8c445c417b7 100644
--- a/Documentation/gpu/vkms.rst
+++ b/Documentation/gpu/vkms.rst
@@ -161,7 +161,7 @@ To return to graphical mode, do::
 
 Once you are in text only mode, you can run tests using the --device switch
 or IGT_DEVICE variable to specify the device filter for the driver we want
-to test. IGT_DEVICE can also be used with the run-test.sh script to run the
+to test. IGT_DEVICE can also be used with the run-tests.sh script to run the
 tests for a specific driver::
 
   sudo ./build/tests/<name of test> --device "sys:/sys/devices/platform/vkms"
-- 
2.51.0

[PATCH 2/2] drm/vkms: Update testing with IGT IGT_DEVICE

[José Expósito]

VKMS is no longer in the platform bus, instead, it is in the faux bus.

In addition, when present, IGT picks hardware drivers instead of virtual
drivers, like VKMS or vgem, if they are not forced.

Update the documentation to use IGT_FORCE_DRIVER instead of IGT_DEVICE.

Signed-off-by: José Expósito <jose.exposito89@gmail.com>
---
 Documentation/gpu/vkms.rst | 19 ++++++++-----------
 1 file changed, 8 insertions(+), 11 deletions(-)

diff --git a/Documentation/gpu/vkms.rst b/Documentation/gpu/vkms.rst
index d8c445c417b7..1e79e62a6bc4 100644
--- a/Documentation/gpu/vkms.rst
+++ b/Documentation/gpu/vkms.rst
@@ -159,26 +159,23 @@ To return to graphical mode, do::
 
   sudo systemctl isolate graphical.target
 
-Once you are in text only mode, you can run tests using the --device switch
-or IGT_DEVICE variable to specify the device filter for the driver we want
-to test. IGT_DEVICE can also be used with the run-tests.sh script to run the
+Once you are in text only mode, you can run tests using the IGT_FORCE_DRIVER
+variable to specify the device filter for the driver we want to test.
+IGT_FORCE_DRIVER can also be used with the run-tests.sh script to run the
 tests for a specific driver::
 
-  sudo ./build/tests/<name of test> --device "sys:/sys/devices/platform/vkms"
-  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./build/tests/<name of test>
-  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./scripts/run-tests.sh -t <name of test>
+  sudo IGT_FORCE_DRIVER="vkms" ./build/tests/<name of test>
+  sudo IGT_FORCE_DRIVER="vkms" ./scripts/run-tests.sh -t <name of test>
 
 For example, to test the functionality of the writeback library,
 we can run the kms_writeback test::
 
-  sudo ./build/tests/kms_writeback --device "sys:/sys/devices/platform/vkms"
-  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./build/tests/kms_writeback
-  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./scripts/run-tests.sh -t kms_writeback
+  sudo IGT_FORCE_DRIVER="vkms" ./build/tests/kms_writeback
+  sudo IGT_FORCE_DRIVER="vkms" ./scripts/run-tests.sh -t kms_writeback
 
 You can also run subtests if you do not want to run the entire test::
 
-  sudo ./build/tests/kms_flip --run-subtest basic-plain-flip --device "sys:/sys/devices/platform/vkms"
-  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./build/tests/kms_flip --run-subtest basic-plain-flip
+  sudo IGT_FORCE_DRIVER="vkms" ./build/tests/kms_flip --run-subtest basic-plain-flip
 
 Testing With KUnit
 ==================
-- 
2.51.0

Re: [PATCH 2/2] drm/vkms: Update testing with IGT IGT_DEVICE

[Louis Chauvet]

Le 24/10/2025 à 13:00, José Expósito a écrit :
> VKMS is no longer in the platform bus, instead, it is in the faux bus.
> 
> In addition, when present, IGT picks hardware drivers instead of virtual
> drivers, like VKMS or vgem, if they are not forced.
> 
> Update the documentation to use IGT_FORCE_DRIVER instead of IGT_DEVICE.
> 
> Signed-off-by: José Expósito <jose.exposito89@gmail.com>

Reviewed-by: Louis Chauvet <louis.chauvet@bootlin.com>

> ---
>   Documentation/gpu/vkms.rst | 19 ++++++++-----------
>   1 file changed, 8 insertions(+), 11 deletions(-)
> 
> diff --git a/Documentation/gpu/vkms.rst b/Documentation/gpu/vkms.rst
> index d8c445c417b7..1e79e62a6bc4 100644
> --- a/Documentation/gpu/vkms.rst
> +++ b/Documentation/gpu/vkms.rst
> @@ -159,26 +159,23 @@ To return to graphical mode, do::
>   
>     sudo systemctl isolate graphical.target
>   
> -Once you are in text only mode, you can run tests using the --device switch
> -or IGT_DEVICE variable to specify the device filter for the driver we want
> -to test. IGT_DEVICE can also be used with the run-tests.sh script to run the
> +Once you are in text only mode, you can run tests using the IGT_FORCE_DRIVER
> +variable to specify the device filter for the driver we want to test.
> +IGT_FORCE_DRIVER can also be used with the run-tests.sh script to run the
>   tests for a specific driver::
>   
> -  sudo ./build/tests/<name of test> --device "sys:/sys/devices/platform/vkms"
> -  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./build/tests/<name of test>
> -  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./scripts/run-tests.sh -t <name of test>
> +  sudo IGT_FORCE_DRIVER="vkms" ./build/tests/<name of test>
> +  sudo IGT_FORCE_DRIVER="vkms" ./scripts/run-tests.sh -t <name of test>
>   
>   For example, to test the functionality of the writeback library,
>   we can run the kms_writeback test::
>   
> -  sudo ./build/tests/kms_writeback --device "sys:/sys/devices/platform/vkms"
> -  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./build/tests/kms_writeback
> -  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./scripts/run-tests.sh -t kms_writeback
> +  sudo IGT_FORCE_DRIVER="vkms" ./build/tests/kms_writeback
> +  sudo IGT_FORCE_DRIVER="vkms" ./scripts/run-tests.sh -t kms_writeback
>   
>   You can also run subtests if you do not want to run the entire test::
>   
> -  sudo ./build/tests/kms_flip --run-subtest basic-plain-flip --device "sys:/sys/devices/platform/vkms"
> -  sudo IGT_DEVICE="sys:/sys/devices/platform/vkms" ./build/tests/kms_flip --run-subtest basic-plain-flip
> +  sudo IGT_FORCE_DRIVER="vkms" ./build/tests/kms_flip --run-subtest basic-plain-flip
>   
>   Testing With KUnit
>   ==================

-- 
--
Louis Chauvet, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [PATCH 1/2] drm/vkms: Fix run-tests.sh script name

[Louis Chauvet]

Le 24/10/2025 à 13:00, José Expósito a écrit :
> The script is "run-tests.sh", no "run-test.sh".
> 
> Signed-off-by: José Expósito <jose.exposito89@gmail.com>

Reviewed-by: Louis Chauvet <louis.chauvet@bootlin.com>

> ---
>   Documentation/gpu/vkms.rst | 2 +-
>   1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/Documentation/gpu/vkms.rst b/Documentation/gpu/vkms.rst
> index 3574e01b928d..d8c445c417b7 100644
> --- a/Documentation/gpu/vkms.rst
> +++ b/Documentation/gpu/vkms.rst
> @@ -161,7 +161,7 @@ To return to graphical mode, do::
>   
>   Once you are in text only mode, you can run tests using the --device switch
>   or IGT_DEVICE variable to specify the device filter for the driver we want
> -to test. IGT_DEVICE can also be used with the run-test.sh script to run the
> +to test. IGT_DEVICE can also be used with the run-tests.sh script to run the
>   tests for a specific driver::
>   
>     sudo ./build/tests/<name of test> --device "sys:/sys/devices/platform/vkms"

-- 
--
Louis Chauvet, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [PATCH 1/2] drm/vkms: Fix run-tests.sh script name

[Louis Chauvet]

On Fri, 24 Oct 2025 13:00:04 +0200, José Expósito wrote:
> The script is "run-tests.sh", no "run-test.sh".
> 
> 

Applied, thanks!

[1/2] drm/vkms: Fix run-tests.sh script name
      commit: edcdd00099f1b755095dd770c9cd5d3374e49ebc
[2/2] drm/vkms: Update testing with IGT IGT_DEVICE
      commit: b63300ac4095f892a8472a82f465fdc7c63a8c57

Best regards,
-- 
Louis Chauvet <louis.chauvet@bootlin.com>