[igt-dev] [PATCH i-g-t] i915/gem_ctx_create: Added test description for test case

[apoorva1.singh at intel.com]

From: Apoorva Singh <apoorva1.singh at intel.com>

Added test and subtests description

Signed-off-by: Apoorva Singh <apoorva1.singh at intel.com>
Cc: Melkaveri, Arjun <arjun.melkaveri at intel.com>
---
 tests/i915/gem_ctx_create.c | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/tests/i915/gem_ctx_create.c b/tests/i915/gem_ctx_create.c
index 39305f02..490b9a66 100644
--- a/tests/i915/gem_ctx_create.c
+++ b/tests/i915/gem_ctx_create.c
@@ -35,6 +35,8 @@
 #include "igt_rand.h"
 #include "sw_sync.h"
 
+IGT_TEST_DESCRIPTION("Test the context create ioctls");
+
 #define ENGINE_FLAGS  (I915_EXEC_RING_MASK | I915_EXEC_BSD_MASK)
 
 static unsigned all_engines[16];
@@ -582,6 +584,7 @@ igt_main
 		igt_fork_hang_detector(fd);
 	}
 
+	igt_describe("Tests the basic functionlaity of CONTEXT_CREATE ioctl");
 	igt_subtest("basic") {
 		memset(&create, 0, sizeof(create));
 		create.ctx_id = rand();
@@ -591,41 +594,69 @@ igt_main
 		gem_context_destroy(fd, create.ctx_id);
 	}
 
+	igt_describe("Verify the functionality of CONTEXT_CREATE_EXT ioctl");
 	igt_subtest("ext-param")
 		basic_ext_param(fd);
+
 	igt_subtest("iris-pipeline")
 		iris_pipeline(fd);
 
+	igt_describe("Creates multiple contexts upto available RAM size and then checks "
+	       "the average performance of their execution on multiple parallel threads");
 	igt_subtest("maximum-mem")
 		maximum(fd, ncpus, CHECK_RAM);
+
+	igt_describe("Creates multiple contexts upto available RAM plus SWAP size and then "
+	       "checks the average performance of their execution on multiple parallel threads");
 	igt_subtest("maximum-swap")
 		maximum(fd, ncpus, CHECK_RAM | CHECK_SWAP);
 
+	igt_describe("Checks the average performance by executing a flinked buffer "
+	       "object repeatedly on different engines for a small timeout period");
 	igt_subtest("basic-files")
 		files(fd, 2, 1);
+
+	igt_describe("Checks the average performance by executing a flinked buffer "
+	       "object repeatedly on different engines for a large timeout period");
 	igt_subtest("files")
 		files(fd, 20, 1);
+
+	igt_describe("Checks the average performance by executing a flinked buffer object repeatedly "
+	       "on different engines for a large timeout period on multiple parallel threads");
 	igt_subtest("forked-files")
 		files(fd, 20, ncpus);
 
+	igt_describe("Checks the average performance of context creation and "
+	       "it's execution on all engines");
 	/* NULL value means all engines */
 	igt_subtest("active-all")
 		active(fd, NULL, 20, 1);
+
+	igt_describe("Checks the average performance of context creation and it's execution "
+	       "using all engines on multiple parallel threads");
 	igt_subtest("forked-active-all")
 		active(fd, NULL, 20, ncpus);
 
+	igt_describe("For each engine, checks the average performance of context creation "
+	       "and execution");
 	igt_subtest_with_dynamic("active") {
 		__for_each_physical_engine(fd, e) {
 			igt_dynamic_f("%s", e->name)
 				active(fd, e, 20, 1);
 		}
 	}
+
+	igt_describe("For each engine, checks the average performance of context creation "
+	       "and execution on multiple parallel threads");
 	igt_subtest_with_dynamic("forked-active") {
 		__for_each_physical_engine(fd, e) {
 			igt_dynamic_f("%s", e->name)
 				active(fd, e, 20, ncpus);
 		}
 	}
+
+	igt_describe("For each engine, checks the average performance of context creation "
+	       "and execution while all other engines are hogging the resources");
 	igt_subtest_with_dynamic("hog") {
 		__for_each_physical_engine(fd, e) {
 			igt_dynamic_f("%s", e->name)
-- 
2.28.0