public inbox for igt-dev@lists.freedesktop.org
 help / color / mirror / Atom feed
From: himanshu.girotra@intel.com
To: igt-dev@lists.freedesktop.org, ramadevi.gandi@intel.com,
	kamil.konieczny@intel.com, jari.tahvanainen@intel.com
Subject: [PATCH i-g-t] tests/intel: Adjust test documentation
Date: Tue,  4 Nov 2025 23:28:19 +0530	[thread overview]
Message-ID: <20251104175819.13809-1-himanshu.girotra@intel.com> (raw)

From: Himanshu Girotra <himanshu.girotra@intel.com>

Change mega feature and sub-category for multigpu subtests
and some other legacy tests so that it can be fetched under
correct Feature Bucket.

Signed-off-by: Himanshu Girotra <himanshu.girotra@intel.com>
---
 tests/intel/xe_create.c          |  3 +-
 tests/intel/xe_eudebug.c         |  2 ++
 tests/intel/xe_exec_basic.c      |  9 ++++--
 tests/intel/xe_peer2peer.c       |  4 +--
 tests/intel/xe_query.c           | 55 ++++++++++++++++++++------------
 tests/intel/xe_sysfs_defaults.c  |  2 +-
 tests/intel/xe_sysfs_scheduler.c |  2 +-
 7 files changed, 48 insertions(+), 29 deletions(-)

diff --git a/tests/intel/xe_create.c b/tests/intel/xe_create.c
index e8b8bb025..f0a3f737a 100644
--- a/tests/intel/xe_create.c
+++ b/tests/intel/xe_create.c
@@ -383,7 +383,8 @@ static void create_execqueues(int fd, enum exec_queue_destroy ed,
  *              buffer sizes.
  *
  * SUBTEST: multigpu-create-massive-size
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Functionality: ioctl
  * Test category: functionality test
  * Feature: multigpu
diff --git a/tests/intel/xe_eudebug.c b/tests/intel/xe_eudebug.c
index 4a2c43635..f0d32f6f8 100644
--- a/tests/intel/xe_eudebug.c
+++ b/tests/intel/xe_eudebug.c
@@ -932,11 +932,13 @@ static void test_read_event(int fd)
  *	partial unbind, unbind and unbind all operations.
  *
  * SUBTEST: multigpu-basic-client
+ * Mega feature: MultiGPU
  * Functionality: attach multiGPU
  * Description:
  *	Attach the debugger to process which opens and closes xe drm client on all Xe devices.
  *
  * SUBTEST: multigpu-basic-client-many
+ * Mega feature: MultiGPU
  * Functionality: attach multiGPU
  * Description:
  *	Simultaneously attach many debuggers to many processes on all Xe devices.
diff --git a/tests/intel/xe_exec_basic.c b/tests/intel/xe_exec_basic.c
index f652ab6b2..79dace331 100644
--- a/tests/intel/xe_exec_basic.c
+++ b/tests/intel/xe_exec_basic.c
@@ -58,16 +58,19 @@
  *
  * SUBTEST: multigpu-once-%s
  * Description: Run %arg[1] test only once on multiGPU
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Test category: functionality test
  *
  * SUBTEST: multigpu-many-execqueues-many-vm-%s
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Run %arg[1] test on many exec_queues and many VMs on multiGPU
  * Test category: stress test
  *
  * SUBTEST: multigpu-no-exec-%s
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Run no-exec %arg[1] test on multiGPU
  * Test category: functionality test
  *
diff --git a/tests/intel/xe_peer2peer.c b/tests/intel/xe_peer2peer.c
index b777d2b66..c2b724a52 100644
--- a/tests/intel/xe_peer2peer.c
+++ b/tests/intel/xe_peer2peer.c
@@ -18,8 +18,8 @@
 /**
  * TEST: xe_peer2peer
  * Category: Core
- * Mega feature: General Core features
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Functionality: dma buf copy
  * Description: Peer2peer dma buf copy tests
  * Test category: xe
diff --git a/tests/intel/xe_query.c b/tests/intel/xe_query.c
index 2de88fac9..d320f3ec1 100644
--- a/tests/intel/xe_query.c
+++ b/tests/intel/xe_query.c
@@ -184,7 +184,8 @@ const char *get_topo_name(int value)
  * Test category: functionality test
  *
  * SUBTEST: multigpu-query-engines
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Display engine classes available for all Xe devices.
  * Test category: functionality test
  */
@@ -211,7 +212,8 @@ test_query_engines(int fd)
  * Test category: functionality test
  *
  * SUBTEST: multigpu-query-mem-usage
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Display memory information for all Xe devices.
  * Test category: functionality test
  */
@@ -275,7 +277,8 @@ test_query_mem_regions(int fd)
  * Test category: functionality test
  *
  * SUBTEST: multigpu-query-gt-list
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Display information about GT components for all Xe devices.
  * Test category: functionality test
  */
@@ -350,7 +353,8 @@ test_query_gt_list(int fd)
  * Test category: functionality test
  *
  * SUBTEST: multigpu-query-topology
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Display topology information of GT for all Xe devices.
  * Test category: functionality test
  */
@@ -414,7 +418,8 @@ test_query_gt_topology(int fd)
  * Test category: functionality test
  *
  * SUBTEST: multigpu-query-topology-l3-bank-mask
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Check the value of the l3 bank mask for all Xe devices.
  * Test category: functionality test
  */
@@ -486,7 +491,8 @@ test_query_gt_topology_l3_bank_mask(int fd)
  * Test category: functionality test
  *
  * SUBTEST: multigpu-query-config
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Display config information for all Xe devices.
  * Test category: functionality test
  */
@@ -543,7 +549,8 @@ test_query_config(int fd)
  * Test category: functionality test
  *
  * SUBTEST: multigpu-query-hwconfig
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Display hardware configuration for all Xe devices.
  * Test category: functionality test
  */
@@ -582,7 +589,8 @@ test_query_hwconfig(int fd)
  * Test category: negative test
  *
  * SUBTEST: multigpu-query-invalid-query
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Check query with invalid arguments for all Xe devices.
  * Test category: negative test
  */
@@ -605,7 +613,8 @@ test_query_invalid_query(int fd)
  * Test category: negative test
  *
  * SUBTEST: multigpu-query-invalid-size
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Check query with invalid size for all Xe devices.
  * Test category: negative test
  */
@@ -628,7 +637,8 @@ test_query_invalid_size(int fd)
  * Test category: negative test
  *
  * SUBTEST: multigpu-query-invalid-extension
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Description: Check query with invalid extension for all Xe devices.
  * Test category: negative test
  */
@@ -793,8 +803,8 @@ __engine_cycles(int fd, struct drm_xe_engine_class_instance *hwe)
  * SUBTEST: multigpu-query-cs-cycles
  * Description: Query CPU-GPU timestamp correlation for all Xe devices.
  * Category: Core
- * Mega feature: General Core features
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  */
 static void test_query_engine_cycles(int fd)
 {
@@ -815,8 +825,8 @@ static void test_query_engine_cycles(int fd)
  * SUBTEST: multigpu-query-invalid-cs-cycles
  * Description: Check query with invalid arguments for all Xe devices.
  * Category: Core
- * Mega feature: General Core features
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  */
 static void test_engine_cycles_invalid(int fd)
 {
@@ -929,8 +939,8 @@ test_query_uc_fw_version(int fd, uint32_t uc_type)
  *
  * SUBTEST: multigpu-query-uc-fw-version-guc
  * Description: Display GuC firmware submission version for all Xe devices.
- * Mega feature: General Core features
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Test category: functionality test
  */
 static void
@@ -946,8 +956,8 @@ test_query_uc_fw_version_guc(int fd)
  *
  * SUBTEST: multigpu-query-invalid-uc-fw-version-mbz
  * Description: Check query with invalid arguments for all Xe devices.
- * Mega feature: General Core features
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Test category: functionality test
  */
 static void
@@ -996,7 +1006,8 @@ test_query_uc_fw_version_invalid_mbz(int fd)
  *
  * SUBTEST: multigpu-query-uc-fw-version-huc
  * Description: Display HuC firmware version for all Xe devices.
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  * Test category: functionality test
  */
 static void
@@ -1011,7 +1022,8 @@ test_query_uc_fw_version_huc(int fd)
  *
  * SUBTEST: multigpu-query-oa-units
  * Description: Display fields for OA unit query for all GPU devices
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  */
 static void test_query_oa_units(int fd)
 {
@@ -1063,7 +1075,8 @@ static void test_query_oa_units(int fd)
  *
  * SUBTEST: multigpu-query-pxp-status
  * Description: Display fields for PXP unit query for all Xe devices
- * Sub-category: MultiGPU
+ * Mega feature: MultiGPU
+ * Sub-category: MultiGPU tests
  */
 static void test_query_pxp_status(int fd)
 {
diff --git a/tests/intel/xe_sysfs_defaults.c b/tests/intel/xe_sysfs_defaults.c
index 393e56651..f21ae94e6 100644
--- a/tests/intel/xe_sysfs_defaults.c
+++ b/tests/intel/xe_sysfs_defaults.c
@@ -7,7 +7,7 @@
  * TEST: xe sysfs defaults
  * Description: check if the sysfs engine .defaults node has all values.
  * Category: Core
- * Mega feature: SysMan
+ * Mega feature: General Core features
  * Sub-category: SysMan tests
  * Functionality: sysman defaults
  * Test category: functionality test
diff --git a/tests/intel/xe_sysfs_scheduler.c b/tests/intel/xe_sysfs_scheduler.c
index faafabd29..90d4ab8fd 100644
--- a/tests/intel/xe_sysfs_scheduler.c
+++ b/tests/intel/xe_sysfs_scheduler.c
@@ -6,7 +6,7 @@
 /**
  * TEST: xe sysfs scheduler
  * Category: Core
- * Mega feature: SysMan
+ * Mega feature: General Core features
  * Sub-category: SysMan tests
  * Functionality: scheduler control interface
  *
-- 
2.50.1


             reply	other threads:[~2025-11-04 17:57 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-11-04 17:58 himanshu.girotra [this message]
2025-11-05  2:05 ` [PATCH i-g-t] tests/intel: Adjust test documentation Dandamudi, Priyanka
2025-11-10  5:55   ` Girotra, Himanshu
2025-11-05 21:40 ` ✓ i915.CI.BAT: success for " Patchwork
2025-11-05 22:21 ` ✓ Xe.CI.BAT: " Patchwork
2025-11-06  8:57 ` ✓ Xe.CI.Full: " Patchwork
2025-11-06 23:24 ` ✓ i915.CI.Full: " Patchwork
  -- strict thread matches above, loose matches on Subject: below --
2026-04-06 12:10 [PATCH i-g-t] " himanshu.girotra
2026-04-06 12:15 ` Girotra, Himanshu

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20251104175819.13809-1-himanshu.girotra@intel.com \
    --to=himanshu.girotra@intel.com \
    --cc=igt-dev@lists.freedesktop.org \
    --cc=jari.tahvanainen@intel.com \
    --cc=kamil.konieczny@intel.com \
    --cc=ramadevi.gandi@intel.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox