[PATCH 23/24] selftests/resctrl: Add L2 CAT test

From: Ilpo Järvinen
Date: Tue Oct 24 2023 - 05:32:25 EST


CAT selftests only cover L3 but some newer CPUs come also with L2 CAT
support.

Add L2 CAT selftest. As measuring L2 misses is not easily available
with perf, use L3 accesses as a proxy for L2 CAT working or not.

Signed-off-by: Ilpo Järvinen <ilpo.jarvinen@xxxxxxxxxxxxxxx>
---
tools/testing/selftests/resctrl/cat_test.c | 68 +++++++++++++++++--
tools/testing/selftests/resctrl/resctrl.h | 1 +
.../testing/selftests/resctrl/resctrl_tests.c | 1 +
3 files changed, 63 insertions(+), 7 deletions(-)

diff --git a/tools/testing/selftests/resctrl/cat_test.c b/tools/testing/selftests/resctrl/cat_test.c
index 48a96acd9e31..a9c72022bb5a 100644
--- a/tools/testing/selftests/resctrl/cat_test.c
+++ b/tools/testing/selftests/resctrl/cat_test.c
@@ -131,8 +131,47 @@ void cat_test_cleanup(void)
remove(RESULT_FILE_NAME);
}

+/*
+ * L2 CAT test measures L2 misses indirectly using L3 accesses as a proxy
+ * because perf cannot directly provide the number of L2 misses (there are
+ * only platform specific ways to get the number of L2 misses).
+ *
+ * This function sets up L3 CAT to reduce noise from other processes during
+ * L2 CAT test.
+ */
+int l3_proxy_prepare(const struct resctrl_test *test, struct resctrl_val_param *param, int cpu)
+{
+ unsigned long l3_mask, split_mask;
+ unsigned int start;
+ int count_of_bits;
+ char schemata[64];
+ int n, ret;
+
+ if (!validate_resctrl_feature_request("L3", NULL)) {
+ ksft_print_msg("%s test results may contain noise because L3 CAT is not available!\n",
+ test->name);
+ return 0;
+ }
+
+ ret = get_mask_no_shareable("L3", &l3_mask);
+ if (ret)
+ return ret;
+ count_of_bits = count_contiguous_bits(l3_mask, &start);
+ n = count_of_bits / 2;
+ split_mask = create_bit_mask(start, n);
+
+ snprintf(schemata, sizeof(schemata), "%lx", l3_mask & ~split_mask);
+ ret = write_schemata("", schemata, cpu, "L3");
+ if (ret)
+ return ret;
+
+ snprintf(schemata, sizeof(schemata), "%lx", split_mask);
+ return write_schemata(param->ctrlgrp, schemata, cpu, "L3");
+}
+
/*
* cat_test: execute CAT benchmark and measure LLC cache misses
+ * @test: test information structure
* @param: parameters passed to cat_test()
* @span: buffer size for the benchmark
* @current_mask start mask for the first iteration
@@ -142,9 +181,10 @@ void cat_test_cleanup(void)
*
* Return: 0 on success. non-zero on failure.
*/
-static int cat_test(struct resctrl_val_param *param, const char *resource,
+static int cat_test(const struct resctrl_test *test, struct resctrl_val_param *param,
size_t span, unsigned long current_mask)
{
+ __u64 pea_config = PERF_COUNT_HW_CACHE_MISSES;
char *resctrl_val = param->resctrl_val;
static struct perf_event_read pe_read;
struct perf_event_attr pea;
@@ -169,20 +209,26 @@ static int cat_test(struct resctrl_val_param *param, const char *resource,
if (ret)
return ret;

+ if (!strcmp(test->resource, "L2")) {
+ ret = l3_proxy_prepare(test, param, param->cpu_no);
+ if (ret)
+ return ret;
+ pea_config = PERF_COUNT_HW_CACHE_REFERENCES;
+ }
+ perf_event_attr_initialize(&pea, pea_config);
+ perf_event_initialize_read_format(&pe_read);
+
buf = alloc_buffer(span, 1);
if (buf == NULL)
return -1;

- perf_event_attr_initialize(&pea, PERF_COUNT_HW_CACHE_MISSES);
- perf_event_initialize_read_format(&pe_read);
-
while (current_mask) {
snprintf(schemata, sizeof(schemata), "%lx", param->mask & ~current_mask);
- ret = write_schemata("", schemata, param->cpu_no, resource);
+ ret = write_schemata("", schemata, param->cpu_no, test->resource);
if (ret)
goto free_buf;
snprintf(schemata, sizeof(schemata), "%lx", current_mask);
- ret = write_schemata(param->ctrlgrp, schemata, param->cpu_no, resource);
+ ret = write_schemata(param->ctrlgrp, schemata, param->cpu_no, test->resource);
if (ret)
goto free_buf;

@@ -269,7 +315,7 @@ static int cat_run_test(const struct resctrl_test *test, const struct user_param

remove(param.filename);

- ret = cat_test(&param, test->resource, span, start_mask);
+ ret = cat_test(test, &param, span, start_mask);
if (ret)
goto out;

@@ -288,3 +334,11 @@ struct resctrl_test l3_cat_test = {
.feature_check = test_resource_feature_check,
.run_test = cat_run_test,
};
+
+struct resctrl_test l2_cat_test = {
+ .name = "L2_CAT",
+ .group = "CAT",
+ .resource = "L2",
+ .feature_check = test_resource_feature_check,
+ .run_test = cat_run_test,
+};
diff --git a/tools/testing/selftests/resctrl/resctrl.h b/tools/testing/selftests/resctrl/resctrl.h
index f9a4cfd981f8..fffeb442c173 100644
--- a/tools/testing/selftests/resctrl/resctrl.h
+++ b/tools/testing/selftests/resctrl/resctrl.h
@@ -183,5 +183,6 @@ extern struct resctrl_test mbm_test;
extern struct resctrl_test mba_test;
extern struct resctrl_test cmt_test;
extern struct resctrl_test l3_cat_test;
+extern struct resctrl_test l2_cat_test;

#endif /* RESCTRL_H */
diff --git a/tools/testing/selftests/resctrl/resctrl_tests.c b/tools/testing/selftests/resctrl/resctrl_tests.c
index d89179541d7b..9e254bca6c25 100644
--- a/tools/testing/selftests/resctrl/resctrl_tests.c
+++ b/tools/testing/selftests/resctrl/resctrl_tests.c
@@ -15,6 +15,7 @@ static struct resctrl_test *resctrl_tests[] = {
&mba_test,
&cmt_test,
&l3_cat_test,
+ &l2_cat_test,
};

static int detect_vendor(void)
--
2.30.2