[Intel-gfx] [RFC i-g-t v2] igt: Test tagging support
Chris Wilson
chris at chris-wilson.co.uk
Fri Jul 21 10:36:52 UTC 2017
Quoting Tvrtko Ursulin (2017-07-21 11:20:05)
> From: Tvrtko Ursulin <tvrtko.ursulin at intel.com>
>
> Proposal to add test tags as a replacement for separate test
> list which can be difficult to maintain and get out of date.
>
> Putting this maintanenace inline with tests makes it easier
> to remember to update the (now implicit) lists, and also enables
> richer test selection possibilities for the test runner.
>
> Current method of implying tags from test/subtest names has a
> couple of problems one of which is where some names can use
> the same token for different meanings. (One example is the
> "default" token.) It also creates a name clash between naming
> and tagging.
>
> Test tags are strings of tokens separated by spaces, meaning of
> which we decide by creating a convetion and helped by the
> suitable helper macros.
>
> For example tags can be things like: gem, kms, basic, guc, flip,
> semaphore, bz12345678, gt4e, etc..
>
> At runtime this would look something like this (abbreviated for
> readability):
>
> root at e31:~/intel-gpu-tools# tests/gem_sync --list-subtests-with-tags
> ...
> forked-each TAGS="gem "
> forked-store-each TAGS="gem "
> basic-all TAGS="gem basic "
> basic-store-all TAGS="gem basic "
>
> root at e31:~/intel-gpu-tools# tests/gem_concurrent_blit --list-subtests-with-tags
> ...
> 16MiB-swap-gpuX-render-write-read-bcs-bomb TAGS="gem stress "
> 16MiB-swap-gpuX-render-write-read-rcs-bomb TAGS="gem stress "
> 16MiB-swap-gpuX-render-gpu-read-after-write-bomb TAGS="gem stress "
>
> root at e31:~/intel-gpu-tools# tests/kms_flip --list-subtests-with-tags | grep basic
> basic-plain-flip TAGS="kms basic "
> basic-flip-vs-dpms TAGS="kms basic "
>
> Test runner can then enable usages like:
>
> ./run-tests --include gem --exclude stress
>
> Which I think could really be useful and more flexible than name
> based selection.
>
> This RFC implementation automatically adds various tags based on
> both binary and subtest names. This is to enable easy transition
> to the tag based system.
>
> Idea is that all current tests get some useful tags with minimum
> amount of work. Unfortunately this doesn't work for test binaries
> which at the moment do not support the subtests enumeration so
> those are the ones which would need identifying and converting.
>
> Source code usage, for tests which would want to override the
> default tag generation would look something like:
>
> igt_gem_subtest("basic", "each")
> ...
>
> igt_gem_subtest("manual", "special-setup-test")
> ...
>
> igt_gem_stress_subtest_f("tag", "name-%s", ...) {
> ...
>
> We can of course polish the details of the API if the idea will
> be deemed interesting.
>
> v2: More default tags for untagged tests for easier migration.
>
> Signed-off-by: Tvrtko Ursulin <tvrtko.ursulin at intel.com>
> ---
> lib/igt_core.c | 118 ++++++++++++++++++++++++++++++++++++++++++---
> lib/igt_core.h | 29 +++++++++--
> tests/gem_concurrent_all.c | 34 ++++++-------
> 3 files changed, 154 insertions(+), 27 deletions(-)
>
> diff --git a/lib/igt_core.c b/lib/igt_core.c
> index c0488e944cec..d140196cad13 100644
> --- a/lib/igt_core.c
> +++ b/lib/igt_core.c
> @@ -253,10 +253,12 @@ static unsigned int exit_handler_count;
> const char *igt_interactive_debug;
>
> /* subtests helpers */
> -static bool list_subtests = false;
> -static char *run_single_subtest = NULL;
> +static bool list_subtests, list_subtests_tags;
> +static char *run_single_subtest;
> static bool run_single_subtest_found = false;
> -static const char *in_subtest = NULL;
> +static const char *in_subtest;
> +static char *subtest_tags;
> +static bool subtest_tags_allocated;
> static struct timespec subtest_time;
> static clockid_t igt_clock = (clockid_t)-1;
> static bool in_fixture = false;
> @@ -276,6 +278,7 @@ bool test_child;
>
> enum {
> OPT_LIST_SUBTESTS,
> + OPT_LIST_SUBTESTS_TAGS,
> OPT_RUN_SUBTEST,
> OPT_DESCRIPTION,
> OPT_DEBUG,
> @@ -599,6 +602,7 @@ static void print_usage(const char *help_str, bool output_on_stderr)
>
> fprintf(f, "Usage: %s [OPTIONS]\n", command_str);
> fprintf(f, " --list-subtests\n"
> + " --list-subtest-with-tags\n"
> " --run-subtest <pattern>\n"
> " --debug[=log-domain]\n"
> " --interactive-debug[=domain]\n"
> @@ -709,6 +713,7 @@ static int common_init(int *argc, char **argv,
> int c, option_index = 0, i, x;
> static struct option long_options[] = {
> {"list-subtests", 0, 0, OPT_LIST_SUBTESTS},
> + {"list-subtests-with-tags", 0, 0, OPT_LIST_SUBTESTS_TAGS},
> {"run-subtest", 1, 0, OPT_RUN_SUBTEST},
> {"help-description", 0, 0, OPT_DESCRIPTION},
> {"debug", optional_argument, 0, OPT_DEBUG},
> @@ -803,6 +808,12 @@ static int common_init(int *argc, char **argv,
> if (!run_single_subtest)
> list_subtests = true;
> break;
> + case OPT_LIST_SUBTESTS_TAGS:
> + if (!run_single_subtest) {
> + list_subtests = true;
> + list_subtests_tags = true;
> + }
> + break;
> case OPT_RUN_SUBTEST:
> if (!list_subtests)
> run_single_subtest = strdup(optarg);
> @@ -935,19 +946,100 @@ void igt_simple_init_parse_opts(int *argc, char **argv,
> extra_opt_handler, handler_data);
> }
>
> +#define __IGT_TAGS_MAX (4096)
> +
> +static char * __get_tag_str(char *tags)
> +{
> + if (tags)
> + return tags;
> +
> + tags = malloc(__IGT_TAGS_MAX);
> + igt_assert(tags);
> +
> + memset(tags, 0, __IGT_TAGS_MAX);
> +
> + return tags;
> +}
> +
> +static char * __add_tag(char *tags, unsigned int *pos, const char *tag)
> +{
> + size_t left = __IGT_TAGS_MAX - *pos;
> + char _tag[128];
> + int ret;
> +
> + if (!tag)
> + return tags;
> +
> + tags = __get_tag_str(tags);
> +
> + sprintf(_tag, "%s ", tag);
> + if (!strncmp(tags, _tag, strlen(_tag)))
> + return tags;
> +
> + sprintf(_tag, " %s ", tag);
> + if (strstr(tags, _tag))
> + return tags;
> +
> + ret = snprintf(tags + *pos, left, "%s ", tag);
> + igt_assert(ret > 0 && ret < left);
> +
> + *pos += ret;
> +
> + return tags;
> +}
> +
> /*
> * Note: Testcases which use these helpers MUST NOT output anything to stdout
> * outside of places protected by igt_run_subtest checks - the piglit
> * runner adds every line to the subtest list.
> */
> -bool __igt_run_subtest(const char *subtest_name)
> +bool __igt_run_subtest(const char *subtest_name, const char *tags)
> {
> + unsigned int tag_idx = 0;
> + char *_tags = NULL;
> + const char *tag;
> int i;
>
> assert(!in_subtest);
> + assert(!subtest_tags);
> assert(!in_fixture);
> assert(test_with_subtests);
>
> + if (!tags) {
> + if (!strncmp(command_str, "gem_", 4))
> + tag = "gem";
> + else if (!strncmp(command_str, "prime_", 4))
> + tag = "gem";
> + else if (!strncmp(command_str, "kms_", 4))
> + tag = "kms";
> + else if (!strncmp(command_str, "pm_", 3))
> + tag = "pm";
> + else if (!strncmp(command_str, "drv_", 3))
> + tag = "drv";
> + else if (!strncmp(command_str, "debugfs_", 3))
> + tag = "drv";
> + else if (!strncmp(command_str, "core_", 4))
> + tag = "drm";
> + else if (!strncmp(command_str, "drm_", 4))
> + tag = "drm";
> + else if (!strncmp(command_str, "sw_", 4))
> + tag = "external";
> + else
> + tag = NULL;
> +
> + _tags = __add_tag(_tags, &tag_idx, tag);
> +
> + if (!strncmp(subtest_name, "basic-", 6))
> + tag = "basic";
> + else
> + tag = NULL;
> +
> + _tags = __add_tag(_tags, &tag_idx, tag);
> +
> + tags = _tags;
> + subtest_tags_allocated = _tags;
> + }
> +
> /* check the subtest name only contains a-z, A-Z, 0-9, '-' and '_' */
> for (i = 0; subtest_name[i] != '\0'; i++)
> if (subtest_name[i] != '_' && subtest_name[i] != '-'
> @@ -958,7 +1050,10 @@ bool __igt_run_subtest(const char *subtest_name)
> }
>
> if (list_subtests) {
> - printf("%s\n", subtest_name);
> + if (list_subtests_tags && tags)
> + printf("%s TAGS=\"%s\"\n", subtest_name, tags);
> + else
> + printf("%s\n", subtest_name);
> return false;
> }
>
> @@ -983,7 +1078,11 @@ bool __igt_run_subtest(const char *subtest_name)
> _igt_log_buffer_reset();
>
> gettime(&subtest_time);
> - return (in_subtest = subtest_name);
> +
> + in_subtest = subtest_name;
> + subtest_tags = (char *)tags;
> +
> + return true;
> }
>
> /**
> @@ -1034,7 +1133,12 @@ static void exit_subtest(const char *result)
> (!__igt_plain_output) ? "\x1b[0m" : "");
> fflush(stdout);
>
> - in_subtest = NULL;
> + if (subtest_tags_allocated)
> + free(subtest_tags);
> +
> + in_subtest = subtest_tags = NULL;
> + subtest_tags_allocated = false;
> +
> siglongjmp(igt_subtest_jmpbuf, 1);
> }
>
> diff --git a/lib/igt_core.h b/lib/igt_core.h
> index 1619a9d65400..6c55c04b7de0 100644
> --- a/lib/igt_core.h
> +++ b/lib/igt_core.h
> @@ -147,7 +147,7 @@ int igt_subtest_init_parse_opts(int *argc, char **argv,
> #define igt_subtest_init(argc, argv) \
> igt_subtest_init_parse_opts(&argc, argv, NULL, NULL, NULL, NULL, NULL);
>
> -bool __igt_run_subtest(const char *subtest_name);
> +bool __igt_run_subtest(const char *subtest_name, const char *subtest_tags);
> #define __igt_tokencat2(x, y) x ## y
>
> /**
> @@ -160,6 +160,29 @@ bool __igt_run_subtest(const char *subtest_name);
> */
> #define igt_tokencat(x, y) __igt_tokencat2(x, y)
>
> +#define igt_tagged_subtest(tags, name) \
> + for (; __igt_run_subtest((name), (tags)) && \
> + (sigsetjmp(igt_subtest_jmpbuf, 1) == 0); \
> + igt_success())
> +
> +#define igt_gem_subtest(tags, name) igt_tagged_subtest("gem "tags, name)
> +
> +#define __igt_tagged_subtest_f(tags, tmp, format...) \
> + for (char tmp [256]; \
> + snprintf( tmp , sizeof( tmp ), format), \
> + __igt_run_subtest(tmp, tags) && \
> + (sigsetjmp(igt_subtest_jmpbuf, 1) == 0); \
> + igt_success())
> +
> +#define igt_tagged_subtest_f(tags, f...) \
> + __igt_tagged_subtest_f(tags, igt_tokencat(__tmpchar, __LINE__), f)
> +
> +#define igt_gem_subtest_f(tags, f...) \
> + igt_tagged_subtest_f("gem "tags, f)
> +
> +#define igt_gem_stress_subtest_f(tags, f...) \
> + igt_tagged_subtest_f("gem stress "tags, f)
> +
> /**
> * igt_subtest:
> * @name: name of the subtest
> @@ -171,14 +194,14 @@ bool __igt_run_subtest(const char *subtest_name);
> *
> * This is a simpler version of igt_subtest_f()
> */
> -#define igt_subtest(name) for (; __igt_run_subtest((name)) && \
> +#define igt_subtest(name) for (; __igt_run_subtest((name), NULL) && \
> (sigsetjmp(igt_subtest_jmpbuf, 1) == 0); \
> igt_success())
> #define __igt_subtest_f(tmp, format...) \
> for (char tmp [256]; \
> snprintf( tmp , sizeof( tmp ), \
> format), \
> - __igt_run_subtest( tmp ) && \
> + __igt_run_subtest(tmp, NULL) && \
> (sigsetjmp(igt_subtest_jmpbuf, 1) == 0); \
> igt_success())
>
> diff --git a/tests/gem_concurrent_all.c b/tests/gem_concurrent_all.c
> index 201b491bc245..eef0c8878081 100644
> --- a/tests/gem_concurrent_all.c
> +++ b/tests/gem_concurrent_all.c
> @@ -1492,47 +1492,47 @@ run_mode(const char *prefix,
> igt_subtest_group {
> igt_fixture p->require();
>
> - igt_subtest_f("%s-%s-%s-sanitycheck0%s%s", prefix, mode->name, p->prefix, suffix, h->suffix) {
> + igt_gem_stress_subtest_f("", "%s-%s-%s-sanitycheck0%s%s", prefix, mode->name, p->prefix, suffix, h->suffix) {
They are not all stress tests. So you want to be able to build the tags
dynamically... Similarly they offer different types of "stress", you
probably don't want to lump the hang tests in amongst the plain
concurrency tests, and you probably want the swapping tests separated
etc. Stress is missing the point.
-Chris
More information about the Intel-gfx
mailing list