[PATCH i-g-t 2/5] lib/xe/xe_sriov_provisioning: Add sched priority mask to string helper

[Marcin Bernatowicz <marcin.bernatowicz@linux.intel.com>]

Introduce xe_sriov_sched_priority_mask_to_string() to format a
scheduling priority bitmask as a space-separated list of priority names.

Signed-off-by: Marcin Bernatowicz <marcin.bernatowicz@linux.intel.com>
Cc: Adam Miszczak <adam.miszczak@linux.intel.com>
Cc: Jakub Kolakowski <jakub1.kolakowski@intel.com>
Cc: Lukasz Laguna <lukasz.laguna@intel.com>
Cc: Michal Wajdeczko <michal.wajdeczko@intel.com>
---
 lib/xe/xe_sriov_provisioning.c | 54 ++++++++++++++++++++++++++++++++++
 lib/xe/xe_sriov_provisioning.h | 11 +++++++
 2 files changed, 65 insertions(+)

diff --git a/lib/xe/xe_sriov_provisioning.c b/lib/xe/xe_sriov_provisioning.c
index 532335abe..da0df4d31 100644
--- a/lib/xe/xe_sriov_provisioning.c
+++ b/lib/xe/xe_sriov_provisioning.c
@@ -693,6 +693,60 @@ int xe_sriov_sched_priority_from_string(const char *s,
 	return -EINVAL;
 }
 
+_Static_assert(BIT(XE_SRIOV_SCHED_PRIORITY_LOW) == XE_SRIOV_SCHED_PRIORITY_MASK_LOW,
+	       "LOW mask bit must match enum order");
+_Static_assert(BIT(XE_SRIOV_SCHED_PRIORITY_NORMAL) == XE_SRIOV_SCHED_PRIORITY_MASK_NORMAL,
+	       "NORMAL mask bit must match enum order");
+_Static_assert(BIT(XE_SRIOV_SCHED_PRIORITY_HIGH) == XE_SRIOV_SCHED_PRIORITY_MASK_HIGH,
+	       "HIGH mask bit must match enum order");
+
+/**
+ * xe_sriov_sched_priority_mask_to_string - Format priority mask as text
+ * @mask: Priority bitmask.
+ * @sel: Optional selected priority (NULL for none).
+ * @buf: Output buffer.
+ * @buf_sz: Size of @buf.
+ *
+ * Converts @mask to a space-separated string of priority names. If @sel is
+ * non-NULL and present in @mask, that priority is wrapped in brackets, e.g.
+ * "low [normal] high". Writes "none" if the mask is empty.
+ *
+ * Returns: @buf.
+ */
+const char *xe_sriov_sched_priority_mask_to_string(unsigned int mask,
+						   const enum xe_sriov_sched_priority *sel,
+						   char *buf, size_t buf_sz)
+{
+	size_t n = buf_sz;
+	bool first = true;
+	char *p = buf;
+
+	igt_assert(buf && buf_sz);
+
+	for (enum xe_sriov_sched_priority prio = XE_SRIOV_SCHED_PRIORITY_LOW;
+	     prio <= XE_SRIOV_SCHED_PRIORITY_HIGH; prio++) {
+		const char *name = xe_sriov_sched_priority_to_string(prio);
+		unsigned int bit = BIT(prio);
+
+		if (mask & bit) {
+			bool highlight = sel && (*sel == prio);
+
+			p += snprintf(p, n, "%s%s%s%s",
+				      first ? "" : " ",
+				      highlight ? "[" : "",
+				      name ?: "?",
+				      highlight ? "]" : "");
+			n = buf_sz - (p - buf);
+			first = false;
+		}
+	}
+
+	if (first)
+		snprintf(buf, buf_sz, "none");
+
+	return buf;
+}
+
 /**
  * __xe_sriov_get_sched_priority - Get the scheduling priority for a given VF
  * @pf: PF device file descriptor
diff --git a/lib/xe/xe_sriov_provisioning.h b/lib/xe/xe_sriov_provisioning.h
index 65f0597fe..9305eceec 100644
--- a/lib/xe/xe_sriov_provisioning.h
+++ b/lib/xe/xe_sriov_provisioning.h
@@ -75,6 +75,14 @@ enum xe_sriov_sched_priority {
 	XE_SRIOV_SCHED_PRIORITY_HIGH
 };
 
+#define XE_SRIOV_SCHED_PRIORITY_MASK_LOW    (1u << XE_SRIOV_SCHED_PRIORITY_LOW)
+#define XE_SRIOV_SCHED_PRIORITY_MASK_NORMAL (1u << XE_SRIOV_SCHED_PRIORITY_NORMAL)
+#define XE_SRIOV_SCHED_PRIORITY_MASK_HIGH   (1u << XE_SRIOV_SCHED_PRIORITY_HIGH)
+#define XE_SRIOV_SCHED_PRIORITY_MASK_ALL \
+	(XE_SRIOV_SCHED_PRIORITY_MASK_LOW | \
+	 XE_SRIOV_SCHED_PRIORITY_MASK_NORMAL | \
+	 XE_SRIOV_SCHED_PRIORITY_MASK_HIGH)
+
 /**
  * struct xe_sriov_provisioned_range - Provisioned range for a Virtual Function (VF)
  * @vf_id: The ID of the VF
@@ -143,6 +151,9 @@ int xe_sriov_sched_priority_from_string(const char *s, enum xe_sriov_sched_prior
 int __xe_sriov_get_sched_priority(int pf, unsigned int vf_num,
 				  unsigned int gt_num,
 				  enum xe_sriov_sched_priority *value);
+const char *xe_sriov_sched_priority_mask_to_string(unsigned int mask,
+						   const enum xe_sriov_sched_priority *sel,
+						   char *buf, size_t buf_sz);
 enum xe_sriov_sched_priority xe_sriov_get_sched_priority(int pf, unsigned int vf_num,
 							 unsigned int gt_num);
 int __xe_sriov_set_sched_priority(int pf, unsigned int vf_num, unsigned int gt_num,
-- 
2.43.0