forked from ~ljy/RK356X_SDK_RELEASE

hc
2023-12-11 6778948f9de86c3cfaf36725a7c87dcff9ba247f
kernel/drivers/gpu/arm/bifrost/tests/include/kutf/kutf_suite.h
....@@ -1,7 +1,7 @@
11 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
22 /*
33 *
4
- * (C) COPYRIGHT 2014, 2017, 2020-2021 ARM Limited. All rights reserved.
4
+ * (C) COPYRIGHT 2014, 2017, 2020-2022 ARM Limited. All rights reserved.
55 *
66 * This program is free software and is provided to you under the terms of the
77 * GNU General Public License version 2 as published by the Free Software
....@@ -43,36 +43,36 @@
4343 #define KUTF_MAX_LINE_LENGTH (1024u)
4444
4545 /**
46
- * Pseudo-flag indicating an absence of any specified test class. Note that
47
- * tests should not be annotated with this constant as it is simply a zero
46
+ * KUTF_F_TEST_NONE - Pseudo-flag indicating an absence of any specified test class.
47
+ * Note that tests should not be annotated with this constant as it is simply a zero
4848 * value; tests without a more specific class must be marked with the flag
4949 * KUTF_F_TEST_GENERIC.
5050 */
5151 #define KUTF_F_TEST_NONE ((unsigned int)(0))
5252
5353 /**
54
- * Class indicating this test is a smoke test.
54
+ * KUTF_F_TEST_SMOKETEST - Class indicating this test is a smoke test.
5555 * A given set of smoke tests should be quick to run, enabling rapid turn-around
5656 * of "regress-on-commit" test runs.
5757 */
5858 #define KUTF_F_TEST_SMOKETEST ((unsigned int)(1 << 1))
5959
6060 /**
61
- * Class indicating this test is a performance test.
61
+ * KUTF_F_TEST_PERFORMANCE - Class indicating this test is a performance test.
6262 * These tests typically produce a performance metric, such as "time to run" or
6363 * "frames per second",
6464 */
6565 #define KUTF_F_TEST_PERFORMANCE ((unsigned int)(1 << 2))
6666
6767 /**
68
- * Class indicating that this test is a deprecated test.
68
+ * KUTF_F_TEST_DEPRECATED - Class indicating that this test is a deprecated test.
6969 * These tests have typically been replaced by an alternative test which is
7070 * more efficient, or has better coverage.
7171 */
7272 #define KUTF_F_TEST_DEPRECATED ((unsigned int)(1 << 3))
7373
7474 /**
75
- * Class indicating that this test is a known failure.
75
+ * KUTF_F_TEST_EXPECTED_FAILURE - Class indicating that this test is a known failure.
7676 * These tests have typically been run and failed, but marking them as a known
7777 * failure means it is easier to triage results.
7878 *
....@@ -83,68 +83,69 @@
8383 #define KUTF_F_TEST_EXPECTED_FAILURE ((unsigned int)(1 << 4))
8484
8585 /**
86
- * Class indicating that this test is a generic test, which is not a member of
87
- * a more specific test class. Tests which are not created with a specific set
86
+ * KUTF_F_TEST_GENERIC - Class indicating that this test is a generic test,
87
+ * which is not a member of a more specific test class.
88
+ * Tests which are not created with a specific set
8889 * of filter flags by the user are assigned this test class by default.
8990 */
9091 #define KUTF_F_TEST_GENERIC ((unsigned int)(1 << 5))
9192
9293 /**
93
- * Class indicating this test is a resource allocation failure test.
94
+ * KUTF_F_TEST_RESFAIL - Class indicating this test is a resource allocation failure test.
9495 * A resource allocation failure test will test that an error code is
9596 * correctly propagated when an allocation fails.
9697 */
9798 #define KUTF_F_TEST_RESFAIL ((unsigned int)(1 << 6))
9899
99100 /**
100
- * Additional flag indicating that this test is an expected failure when
101
- * run in resource failure mode. These tests are never run when running
102
- * the low resource mode.
101
+ * KUTF_F_TEST_EXPECTED_FAILURE_RF - Additional flag indicating that this test
102
+ * is an expected failure when run in resource failure mode.
103
+ * These tests are never run when running the low resource mode.
103104 */
104105 #define KUTF_F_TEST_EXPECTED_FAILURE_RF ((unsigned int)(1 << 7))
105106
106107 /**
107
- * Flag reserved for user-defined filter zero.
108
+ * KUTF_F_TEST_USER_0 - Flag reserved for user-defined filter zero.
108109 */
109110 #define KUTF_F_TEST_USER_0 ((unsigned int)(1 << 24))
110111
111112 /**
112
- * Flag reserved for user-defined filter one.
113
+ * KUTF_F_TEST_USER_1 - Flag reserved for user-defined filter one.
113114 */
114115 #define KUTF_F_TEST_USER_1 ((unsigned int)(1 << 25))
115116
116117 /**
117
- * Flag reserved for user-defined filter two.
118
+ * KUTF_F_TEST_USER_2 - Flag reserved for user-defined filter two.
118119 */
119120 #define KUTF_F_TEST_USER_2 ((unsigned int)(1 << 26))
120121
121122 /**
122
- * Flag reserved for user-defined filter three.
123
+ * KUTF_F_TEST_USER_3 - Flag reserved for user-defined filter three.
123124 */
124125 #define KUTF_F_TEST_USER_3 ((unsigned int)(1 << 27))
125126
126127 /**
127
- * Flag reserved for user-defined filter four.
128
+ * KUTF_F_TEST_USER_4 - Flag reserved for user-defined filter four.
128129 */
129130 #define KUTF_F_TEST_USER_4 ((unsigned int)(1 << 28))
130131
131132 /**
132
- * Flag reserved for user-defined filter five.
133
+ * KUTF_F_TEST_USER_5 - Flag reserved for user-defined filter five.
133134 */
134135 #define KUTF_F_TEST_USER_5 ((unsigned int)(1 << 29))
135136
136137 /**
137
- * Flag reserved for user-defined filter six.
138
+ * KUTF_F_TEST_USER_6 - Flag reserved for user-defined filter six.
138139 */
139140 #define KUTF_F_TEST_USER_6 ((unsigned int)(1 << 30))
140141
141142 /**
142
- * Flag reserved for user-defined filter seven.
143
+ * KUTF_F_TEST_USER_7 - Flag reserved for user-defined filter seven.
143144 */
144145 #define KUTF_F_TEST_USER_7 ((unsigned int)(1 << 31))
145146
146147 /**
147
- * Pseudo-flag indicating that all test classes should be executed.
148
+ * KUTF_F_TEST_ALL - Pseudo-flag indicating that all test classes should be executed.
148149 */
149150 #define KUTF_F_TEST_ALL ((unsigned int)(0xFFFFFFFFU))
150151