[igt-dev] [V5 i-g-t 76/81] tests/kms_universal_plane: Document each subtest for testplan

[B, Jeevan]

> -----Original Message-----
> From: igt-dev <igt-dev-bounces at lists.freedesktop.org> On Behalf Of
> Bhanuprakash Modem
> Sent: Thursday, June 29, 2023 8:19 PM
> To: igt-dev at lists.freedesktop.org
> Subject: [igt-dev] [V5 i-g-t 76/81] tests/kms_universal_plane: Document each
> subtest for testplan
> 
> Add documentation for all kms tests which is used by IGT testplan
> documentation.
> 
> Signed-off-by: Bhanuprakash Modem <bhanuprakash.modem at intel.com>
> ---
>  tests/kms_universal_plane.c | 67 +++++++++++++++++++++++++++++++++++++
>  1 file changed, 67 insertions(+)
> 
> diff --git a/tests/kms_universal_plane.c b/tests/kms_universal_plane.c index
> 957d600f1..358b7ae18 100644
> --- a/tests/kms_universal_plane.c
> +++ b/tests/kms_universal_plane.c
> @@ -28,6 +28,73 @@
>  #include <string.h>
>  #include <fcntl.h>
> 
> +/**
> + * TEST: kms universal plane
> + * Category: Display
> + *
> + * SUBTEST: cursor-fb-leak-pipe-%s
> + * Description: Check for cursor leaks after performing cursor
> +operations
> + * Driver requirement: any
> + * Functionality: plane
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: disable-primary-vs-flip-pipe-%s
> + * Description: Check pageflips while primary plane is disabled before IOCTL or
> + *              between IOCTL and pageflip execution
> + * Driver requirement: any
> + * Functionality: plane
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * SUBTEST: universal-plane-pageflip-windowed-pipe-%s
> + * Description: Check if pageflip succeeds in windowed setting
> + * Driver requirement: any
> + * Functionality: plane
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * arg[1]:
> + *
> + * @A:
> + * @B:
> + * @C:
> + * @D:
> + * @E:
> + * @F:
> + * @G:
> + * @H:
> + */
> +
Other subtest details missing. 
> +/**
> + * SUBTEST: universal-plane-pipe-%s-%s
> + * Description: Check %arg[1]
> + * Driver requirement: any
> + * Functionality: plane
> + * Mega feature: General Display Features
> + * Run type: FULL
> + * Test category: functionality test
> + *
> + * arg[1]:
> + *
> + * @A:
> + * @B:
> + * @C:
> + * @D:
> + * @E:
> + * @F:
> + * @G:
> + * @H:
> + *
> + * arg[2]:
> + *
> + * @functional: the switching between different primary plane fbs with CRTC
> off
> + * @sanity:     for scale-up or scale-down using universal plane API without
> + *              covering CRTC
> + */
> 
>  typedef struct {
>  	int drm_fd;
> --
> 2.40.0