.. | .. |
---|
1 | 1 | /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ |
---|
2 | 2 | /* |
---|
3 | 3 | * |
---|
4 | | - * (C) COPYRIGHT 2014, 2017, 2020-2021 ARM Limited. All rights reserved. |
---|
| 4 | + * (C) COPYRIGHT 2014, 2017, 2020-2022 ARM Limited. All rights reserved. |
---|
5 | 5 | * |
---|
6 | 6 | * This program is free software and is provided to you under the terms of the |
---|
7 | 7 | * GNU General Public License version 2 as published by the Free Software |
---|
.. | .. |
---|
43 | 43 | #define KUTF_MAX_LINE_LENGTH (1024u) |
---|
44 | 44 | |
---|
45 | 45 | /** |
---|
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 |
---|
48 | 48 | * value; tests without a more specific class must be marked with the flag |
---|
49 | 49 | * KUTF_F_TEST_GENERIC. |
---|
50 | 50 | */ |
---|
51 | 51 | #define KUTF_F_TEST_NONE ((unsigned int)(0)) |
---|
52 | 52 | |
---|
53 | 53 | /** |
---|
54 | | - * Class indicating this test is a smoke test. |
---|
| 54 | + * KUTF_F_TEST_SMOKETEST - Class indicating this test is a smoke test. |
---|
55 | 55 | * A given set of smoke tests should be quick to run, enabling rapid turn-around |
---|
56 | 56 | * of "regress-on-commit" test runs. |
---|
57 | 57 | */ |
---|
58 | 58 | #define KUTF_F_TEST_SMOKETEST ((unsigned int)(1 << 1)) |
---|
59 | 59 | |
---|
60 | 60 | /** |
---|
61 | | - * Class indicating this test is a performance test. |
---|
| 61 | + * KUTF_F_TEST_PERFORMANCE - Class indicating this test is a performance test. |
---|
62 | 62 | * These tests typically produce a performance metric, such as "time to run" or |
---|
63 | 63 | * "frames per second", |
---|
64 | 64 | */ |
---|
65 | 65 | #define KUTF_F_TEST_PERFORMANCE ((unsigned int)(1 << 2)) |
---|
66 | 66 | |
---|
67 | 67 | /** |
---|
68 | | - * Class indicating that this test is a deprecated test. |
---|
| 68 | + * KUTF_F_TEST_DEPRECATED - Class indicating that this test is a deprecated test. |
---|
69 | 69 | * These tests have typically been replaced by an alternative test which is |
---|
70 | 70 | * more efficient, or has better coverage. |
---|
71 | 71 | */ |
---|
72 | 72 | #define KUTF_F_TEST_DEPRECATED ((unsigned int)(1 << 3)) |
---|
73 | 73 | |
---|
74 | 74 | /** |
---|
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. |
---|
76 | 76 | * These tests have typically been run and failed, but marking them as a known |
---|
77 | 77 | * failure means it is easier to triage results. |
---|
78 | 78 | * |
---|
.. | .. |
---|
83 | 83 | #define KUTF_F_TEST_EXPECTED_FAILURE ((unsigned int)(1 << 4)) |
---|
84 | 84 | |
---|
85 | 85 | /** |
---|
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 |
---|
88 | 89 | * of filter flags by the user are assigned this test class by default. |
---|
89 | 90 | */ |
---|
90 | 91 | #define KUTF_F_TEST_GENERIC ((unsigned int)(1 << 5)) |
---|
91 | 92 | |
---|
92 | 93 | /** |
---|
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. |
---|
94 | 95 | * A resource allocation failure test will test that an error code is |
---|
95 | 96 | * correctly propagated when an allocation fails. |
---|
96 | 97 | */ |
---|
97 | 98 | #define KUTF_F_TEST_RESFAIL ((unsigned int)(1 << 6)) |
---|
98 | 99 | |
---|
99 | 100 | /** |
---|
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. |
---|
103 | 104 | */ |
---|
104 | 105 | #define KUTF_F_TEST_EXPECTED_FAILURE_RF ((unsigned int)(1 << 7)) |
---|
105 | 106 | |
---|
106 | 107 | /** |
---|
107 | | - * Flag reserved for user-defined filter zero. |
---|
| 108 | + * KUTF_F_TEST_USER_0 - Flag reserved for user-defined filter zero. |
---|
108 | 109 | */ |
---|
109 | 110 | #define KUTF_F_TEST_USER_0 ((unsigned int)(1 << 24)) |
---|
110 | 111 | |
---|
111 | 112 | /** |
---|
112 | | - * Flag reserved for user-defined filter one. |
---|
| 113 | + * KUTF_F_TEST_USER_1 - Flag reserved for user-defined filter one. |
---|
113 | 114 | */ |
---|
114 | 115 | #define KUTF_F_TEST_USER_1 ((unsigned int)(1 << 25)) |
---|
115 | 116 | |
---|
116 | 117 | /** |
---|
117 | | - * Flag reserved for user-defined filter two. |
---|
| 118 | + * KUTF_F_TEST_USER_2 - Flag reserved for user-defined filter two. |
---|
118 | 119 | */ |
---|
119 | 120 | #define KUTF_F_TEST_USER_2 ((unsigned int)(1 << 26)) |
---|
120 | 121 | |
---|
121 | 122 | /** |
---|
122 | | - * Flag reserved for user-defined filter three. |
---|
| 123 | + * KUTF_F_TEST_USER_3 - Flag reserved for user-defined filter three. |
---|
123 | 124 | */ |
---|
124 | 125 | #define KUTF_F_TEST_USER_3 ((unsigned int)(1 << 27)) |
---|
125 | 126 | |
---|
126 | 127 | /** |
---|
127 | | - * Flag reserved for user-defined filter four. |
---|
| 128 | + * KUTF_F_TEST_USER_4 - Flag reserved for user-defined filter four. |
---|
128 | 129 | */ |
---|
129 | 130 | #define KUTF_F_TEST_USER_4 ((unsigned int)(1 << 28)) |
---|
130 | 131 | |
---|
131 | 132 | /** |
---|
132 | | - * Flag reserved for user-defined filter five. |
---|
| 133 | + * KUTF_F_TEST_USER_5 - Flag reserved for user-defined filter five. |
---|
133 | 134 | */ |
---|
134 | 135 | #define KUTF_F_TEST_USER_5 ((unsigned int)(1 << 29)) |
---|
135 | 136 | |
---|
136 | 137 | /** |
---|
137 | | - * Flag reserved for user-defined filter six. |
---|
| 138 | + * KUTF_F_TEST_USER_6 - Flag reserved for user-defined filter six. |
---|
138 | 139 | */ |
---|
139 | 140 | #define KUTF_F_TEST_USER_6 ((unsigned int)(1 << 30)) |
---|
140 | 141 | |
---|
141 | 142 | /** |
---|
142 | | - * Flag reserved for user-defined filter seven. |
---|
| 143 | + * KUTF_F_TEST_USER_7 - Flag reserved for user-defined filter seven. |
---|
143 | 144 | */ |
---|
144 | 145 | #define KUTF_F_TEST_USER_7 ((unsigned int)(1 << 31)) |
---|
145 | 146 | |
---|
146 | 147 | /** |
---|
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. |
---|
148 | 149 | */ |
---|
149 | 150 | #define KUTF_F_TEST_ALL ((unsigned int)(0xFFFFFFFFU)) |
---|
150 | 151 | |
---|