[PATCH i-g-t v5 2/5] lib/igt_sysfs: Rename debug level APIs/variables to debug mask

Pranay Samala pranay.samala at intel.com
Mon Jul 7 03:32:43 UTC 2025


The debug log mask is a mask rather than level. Rename each level
occurance to mask.

v3:
- Refactored for readability and address logical comment.

v4:
- Rename debug_level parameter to mask (Kunal)

v5:
- Solve the compilation issue (Rama)

Fixes: 56b91193b825 ("lib/igt_sysfs: Implement dynamic adjustment of debug log level")
Signed-off-by: Pranay Samala <pranay.samala at intel.com>
Reviewed-by: Jan Sokolowski <jan.sokolowski at intel.com>
---
 lib/igt_sysfs.c                         | 36 ++++++++++++-------------
 lib/igt_sysfs.h                         |  6 ++---
 tests/intel/kms_dp_linktrain_fallback.c |  4 +--
 tests/kms_atomic_transition.c           |  4 +--
 tests/kms_cursor_legacy.c               |  4 +--
 5 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/lib/igt_sysfs.c b/lib/igt_sysfs.c
index 23fe4ac45..2863f537a 100644
--- a/lib/igt_sysfs.c
+++ b/lib/igt_sysfs.c
@@ -446,15 +446,15 @@ int igt_sysfs_drm_module_params_open(void)
 static int saved_drm_debug_mask = -1;
 
 /**
- * igt_drm_debug_level_get:
+ * igt_drm_debug_mask_get:
  *
- * This reads the current debug log level of the machine on
+ * This reads the current debug mask of the machine on
  * which the test is currently executing.
  *
  * Returns:
- * The current log level, or -1 on error.
+ * The current debug mask, or -1 on error.
  */
-int igt_drm_debug_level_get(int dir)
+int igt_drm_debug_mask_get(int dir)
 {
 	char buf[20];
 
@@ -468,13 +468,13 @@ int igt_drm_debug_level_get(int dir)
 }
 
 /**
- * igt_drm_debug_level_reset:
+ * igt_drm_debug_mask_reset:
  *
- * This modifies the current debug log level of the machine
+ * This modifies the current debug mask of the machine
  * to the default value post-test.
  *
  */
-void igt_drm_debug_level_reset(void)
+void igt_drm_debug_mask_reset(void)
 {
 	char buf[20];
 	int dir;
@@ -486,25 +486,25 @@ void igt_drm_debug_level_reset(void)
 	if (dir < 0)
 		return;
 
-	igt_debug("Restoring DRM debug level to %d\n", saved_drm_debug_mask);
+	igt_debug("Restoring DRM debug mask to %d\n", saved_drm_debug_mask);
 	snprintf(buf, sizeof(buf), "%d", saved_drm_debug_mask);
 	igt_assert(igt_sysfs_set(dir, "debug", buf));
 
 	close(dir);
 }
 
-static void igt_drm_debug_level_reset_exit_handler(int sig)
+static void igt_drm_debug_mask_reset_exit_handler(int sig)
 {
-	igt_drm_debug_level_reset();
+	igt_drm_debug_mask_reset();
 }
 
 /**
- * igt_drm_debug_level_update:
- * @debug_level: new debug level to set
+ * igt_drm_debug_mask_update:
+ * @debug_mask: new debug mask to set
  *
- * This modifies the current drm debug log level to the new value.
+ * This modifies the current drm debug mask to the new value.
  */
-void igt_drm_debug_level_update(unsigned int new_log_level)
+void igt_drm_debug_mask_update(unsigned int new_mask)
 {
 	char buf[20];
 	int dir;
@@ -513,14 +513,14 @@ void igt_drm_debug_level_update(unsigned int new_log_level)
 	if (dir < 0)
 		return;
 
-	saved_drm_debug_mask = igt_drm_debug_level_get(dir);
+	saved_drm_debug_mask = igt_drm_debug_mask_get(dir);
 	if (saved_drm_debug_mask < 0) {
 		close(dir);
 		return;
 	}
 
-	igt_debug("Setting DRM debug level to %d\n", new_log_level);
-	snprintf(buf, sizeof(buf), "%d", new_log_level);
+	igt_debug("Setting DRM debug mask to %d\n", new_mask);
+	snprintf(buf, sizeof(buf), "%d", new_mask);
 	igt_assert(igt_sysfs_set(dir, "debug", buf));
 
 	close(dir);
@@ -529,7 +529,7 @@ void igt_drm_debug_level_update(unsigned int new_log_level)
 	 * TODO: Check whether multiple exit handlers will get installed,
 	 * if we call this api multiple times
 	 */
-	igt_install_exit_handler(igt_drm_debug_level_reset_exit_handler);
+	igt_install_exit_handler(igt_drm_debug_mask_reset_exit_handler);
 }
 
 /**
diff --git a/lib/igt_sysfs.h b/lib/igt_sysfs.h
index 265f77d4d..892682344 100644
--- a/lib/igt_sysfs.h
+++ b/lib/igt_sysfs.h
@@ -143,9 +143,9 @@ void igt_sysfs_set_boolean(int dir, const char *attr, bool value);
 void bind_fbcon(bool enable);
 void fbcon_blink_enable(bool enable);
 
-void igt_drm_debug_level_update(unsigned int new_log_level);
-void igt_drm_debug_level_reset(void);
-int igt_drm_debug_level_get(int dir);
+void igt_drm_debug_mask_update(unsigned int new_log_level);
+void igt_drm_debug_mask_reset(void);
+int igt_drm_debug_mask_get(int dir);
 int igt_sysfs_drm_module_params_open(void);
 
 /**
diff --git a/tests/intel/kms_dp_linktrain_fallback.c b/tests/intel/kms_dp_linktrain_fallback.c
index f8ef0cac4..96e2836a8 100644
--- a/tests/intel/kms_dp_linktrain_fallback.c
+++ b/tests/intel/kms_dp_linktrain_fallback.c
@@ -607,11 +607,11 @@ igt_main
 			data.n_pipes++;
 		dir = igt_sysfs_drm_module_params_open();
 		if (dir >= 0) {
-			current_log_level = igt_drm_debug_level_get(dir);
+			current_log_level = igt_drm_debug_mask_get(dir);
 			close(dir);
 
 			if (current_log_level > 10)
-				igt_drm_debug_level_update(10);
+				igt_drm_debug_mask_update(10);
 		}
 		/*
 		 * Some environments may have environment
diff --git a/tests/kms_atomic_transition.c b/tests/kms_atomic_transition.c
index 2b64424ce..56a696f86 100644
--- a/tests/kms_atomic_transition.c
+++ b/tests/kms_atomic_transition.c
@@ -1190,11 +1190,11 @@ igt_main_args("", long_opts, help_str, opt_handler, &data)
 
 		dir = igt_sysfs_drm_module_params_open();
 		if (dir >= 0) {
-			current_log_level = igt_drm_debug_level_get(dir);
+			current_log_level = igt_drm_debug_mask_get(dir);
 			close(dir);
 
 			if (current_log_level > 10)
-				igt_drm_debug_level_update(10);
+				igt_drm_debug_mask_update(10);
 		}
 	}
 
diff --git a/tests/kms_cursor_legacy.c b/tests/kms_cursor_legacy.c
index 44f031e7b..c8970f9f6 100644
--- a/tests/kms_cursor_legacy.c
+++ b/tests/kms_cursor_legacy.c
@@ -1853,11 +1853,11 @@ igt_main
 
 		dir = igt_sysfs_drm_module_params_open();
 		if (dir >= 0) {
-			current_log_level = igt_drm_debug_level_get(dir);
+			current_log_level = igt_drm_debug_mask_get(dir);
 			close(dir);
 
 			if (current_log_level > 10)
-				igt_drm_debug_level_update(10);
+				igt_drm_debug_mask_update(10);
 		}
 	}
 
-- 
2.34.1



More information about the igt-dev mailing list