Debian Codegraph @

level_zero/tools/test/unit_tests/sources/debug/eu_thread_tests.cpp

raw
1 /*
2 * Copyright (C) 2021-2025 Intel Corporation
3 *
4 * SPDX-License-Identifier: MIT
5 *
6 */
7
8 #include "shared/test/common/helpers/debug_manager_state_restore.h"
9 #include "shared/test/common/helpers/stream_capture.h"
10 #include "shared/test/common/test_macros/hw_test.h"
11
12 #include "level_zero/tools/source/debug/eu_thread.h"
13
14 namespace L0 {
15 namespace ult {
16
17 TEST(EuThread, WhenConstructingEuThreadThenCorrectIdsAreSet) {
18 ze_device_thread_t devThread = {3, 4, 5, 6};
19
20 EuThread::ThreadId threadId(0, devThread);
21
22 EXPECT_EQ(0u, threadId.tileIndex);
23 EXPECT_EQ(3u, threadId.slice);
24 EXPECT_EQ(4u, threadId.subslice);
25 EXPECT_EQ(5u, threadId.eu);
26 EXPECT_EQ(6u, threadId.thread);
27
28 EuThread::ThreadId threadId2(3, 1, 2, 3, 4);
29
30 EXPECT_EQ(3u, threadId2.tileIndex);
31 EXPECT_EQ(1u, threadId2.slice);
32 EXPECT_EQ(2u, threadId2.subslice);
33 EXPECT_EQ(3u, threadId2.eu);
34 EXPECT_EQ(4u, threadId2.thread);
35
36 auto castValue = static_cast<uint64_t>(threadId2);
37
38 EXPECT_EQ(threadId2.packed, castValue);
39 }
40
41 TEST(EuThread, GivenEuThreadWhenGettingThreadIdThenValidIdReturned) {
42 ze_device_thread_t devThread = {3, 4, 5, 6};
43 EuThread::ThreadId threadId(0, devThread);
44 EuThread euThread(threadId);
45
46 auto id = euThread.getThreadId();
47
48 EXPECT_EQ(threadId.packed, id.packed);
49 }
50
51 TEST(EuThread, GivenEuThreadWhenChangingAndQueryingStatesThenStateIsChanged) {
52 ze_device_thread_t devThread = {3, 4, 5, 6};
53 EuThread::ThreadId threadId(0, devThread);
54 EuThread euThread(threadId);
55
56 EXPECT_FALSE(euThread.isStopped());
57 EXPECT_TRUE(euThread.isRunning());
58
59 bool result = euThread.stopThread(0x1234);
60
61 EXPECT_TRUE(result);
62 EXPECT_TRUE(euThread.isStopped());
63 EXPECT_FALSE(euThread.isRunning());
64 EXPECT_EQ(0x1234u, euThread.getMemoryHandle());
65
66 result = euThread.stopThread(0x5678);
67
68 EXPECT_FALSE(result);
69 EXPECT_TRUE(euThread.isStopped());
70 EXPECT_FALSE(euThread.isRunning());
71 EXPECT_EQ(0x5678u, euThread.getMemoryHandle());
72
73 result = euThread.resumeThread();
74 EXPECT_EQ(EuThread::invalidHandle, euThread.getMemoryHandle());
75
76 EXPECT_TRUE(result);
77 EXPECT_FALSE(euThread.isStopped());
78 EXPECT_TRUE(euThread.isRunning());
79
80 result = euThread.resumeThread();
81
82 EXPECT_FALSE(result);
83 EXPECT_FALSE(euThread.isStopped());
84 EXPECT_TRUE(euThread.isRunning());
85 EXPECT_EQ(EuThread::invalidHandle, euThread.getMemoryHandle());
86 }
87
88 TEST(EuThread, GivenEuThreadWhenToStringCalledThenCorrectStringReturned) {
89 ze_device_thread_t devThread = {3, 4, 5, 6};
90 EuThread::ThreadId threadId(0, devThread);
91 EuThread euThread(threadId);
92
93 auto threadString = euThread.toString();
94 EXPECT_EQ("device index = 0 slice = 3 subslice = 4 eu = 5 thread = 6", threadString);
95 }
96
97 TEST(EuThread, GivenThreadStateRunningWhenVerifyingStopWithOddCounterThenTrueReturnedAndStateStopped) {
98 ze_device_thread_t devThread = {3, 4, 5, 6};
99 EuThread::ThreadId threadId(0, devThread);
100 EuThread euThread(threadId);
101 EXPECT_TRUE(euThread.isRunning());
102
103 EXPECT_TRUE(euThread.verifyStopped(1));
104 EXPECT_TRUE(euThread.isStopped());
105 EXPECT_FALSE(euThread.isReportedAsStopped());
106 }
107
108 TEST(EuThread, GivenThreadStateStoppedAndReportedAsStoppedWhenResumedThenIsReportedAsStoppedIsFalse) {
109 ze_device_thread_t devThread = {3, 4, 5, 6};
110 EuThread::ThreadId threadId(0, devThread);
111 EuThread euThread(threadId);
112
113 EXPECT_TRUE(euThread.verifyStopped(1));
114 euThread.reportAsStopped();
115 EXPECT_TRUE(euThread.isReportedAsStopped());
116
117 EXPECT_TRUE(euThread.resumeThread());
118 EXPECT_FALSE(euThread.isReportedAsStopped());
119 }
120
121 TEST(EuThread, GivenThreadStateStoppedWhenVerifyingStopWithOddCounterThenTrueReturnedAndStateStopped) {
122 ze_device_thread_t devThread = {3, 4, 5, 6};
123 EuThread::ThreadId threadId(0, devThread);
124 EuThread euThread(threadId);
125
126 euThread.verifyStopped(1);
127 euThread.stopThread(1u);
128
129 EXPECT_TRUE(euThread.verifyStopped(1));
130 EXPECT_TRUE(euThread.isStopped());
131 }
132
133 TEST(EuThread, GivenThreadStateStoppedWhenVerifyingStopWithEvenCounterThenFalseReturnedAndStateRunning) {
134 ze_device_thread_t devThread = {3, 4, 5, 6};
135 EuThread::ThreadId threadId(0, devThread);
136 EuThread euThread(threadId);
137
138 euThread.verifyStopped(1);
139 euThread.stopThread(1u);
140
141 EXPECT_FALSE(euThread.verifyStopped(2));
142 EXPECT_TRUE(euThread.isRunning());
143 }
144
145 TEST(EuThread, GivenEnabledErrorLogsWhenThreadStateStoppedAndVerifyingStopWithEvenCounterThenErrorMessageIsPrinted) {
146 DebugManagerStateRestore restorer;
147 NEO::debugManager.flags.DebuggerLogBitmask.set(NEO::DebugVariables::DEBUGGER_LOG_BITMASK::LOG_ERROR);
148
149 ze_device_thread_t devThread = {0, 0, 0, 0};
150 EuThread::ThreadId threadId(0, devThread);
151 EuThread euThread(threadId);
152
153 euThread.verifyStopped(1);
154 euThread.stopThread(1u);
155
156 StreamCapture capture;
157 capture.captureStderr();
158
159 EXPECT_FALSE(euThread.verifyStopped(2));
160 EXPECT_TRUE(euThread.isRunning());
161
162 auto message = capture.getCapturedStderr();
163 // Trim message and remove timestamp + first space
164 size_t pos = message.find(']');
165 message.erase(0, pos + 2);
166 EXPECT_STREQ("ERROR: Thread: device index = 0 slice = 0 subslice = 0 eu = 0 thread = 0 state STOPPED when thread is running. Switching to RUNNING", message.c_str());
167 }
168
169 TEST(EuThread, GivenThreadStateRunningWhenVerifyingStopWithOddCounterForSecondStopThenTrueIsReturnedAndStateStopped) {
170 ze_device_thread_t devThread = {3, 4, 5, 6};
171 EuThread::ThreadId threadId(0, devThread);
172 EuThread euThread(threadId);
173
174 euThread.verifyStopped(1);
175 euThread.resumeThread();
176
177 EXPECT_TRUE(euThread.verifyStopped(3));
178 EXPECT_TRUE(euThread.isStopped());
179 }
180
181 TEST(EuThread, GivenThreadStateRunningWhenVerifyingStopWithEvenCounteThenFalseIsReturnedAndStateRunning) {
182 ze_device_thread_t devThread = {3, 4, 5, 6};
183 EuThread::ThreadId threadId(0, devThread);
184 EuThread euThread(threadId);
185 euThread.verifyStopped(1);
186 euThread.resumeThread();
187
188 EXPECT_FALSE(euThread.verifyStopped(2));
189 EXPECT_TRUE(euThread.isRunning());
190 }
191
192 TEST(EuThread, GivenThreadStateStoppedWhenVerifyingStopWithOddCounterBiggerByMoreThanTwoThenTrueIsReturnedAndStateStopped) {
193 ze_device_thread_t devThread = {3, 4, 5, 6};
194 EuThread::ThreadId threadId(0, devThread);
195 EuThread euThread(threadId);
196 euThread.verifyStopped(1);
197
198 EXPECT_TRUE(euThread.verifyStopped(7));
199 EXPECT_TRUE(euThread.isStopped());
200 }
201
202 TEST(EuThread, GivenEnabledErrorLogsWhenThreadStateStoppedAndVerifyingStopWithOddCounterBiggerByMoreThanTwoThenErrorMessageIsPrinted) {
203 DebugManagerStateRestore restorer;
204 NEO::debugManager.flags.DebuggerLogBitmask.set(NEO::DebugVariables::DEBUGGER_LOG_BITMASK::LOG_ERROR);
205
206 ze_device_thread_t devThread = {0, 0, 0, 0};
207 EuThread::ThreadId threadId(0, devThread);
208 EuThread euThread(threadId);
209
210 euThread.verifyStopped(1);
211
212 StreamCapture capture;
213 capture.captureStderr();
214
215 EXPECT_TRUE(euThread.verifyStopped(7));
216 EXPECT_TRUE(euThread.isStopped());
217
218 auto message = capture.getCapturedStderr();
219 // Trim message and remove timestamp + first space
220 size_t pos = message.find(']');
221 message.erase(0, pos + 2);
222 EXPECT_STREQ("ERROR: Thread: device index = 0 slice = 0 subslice = 0 eu = 0 thread = 0 state out of sync.", message.c_str());
223 }
224
225 TEST(EuThread, GivenEnabledErrorLogsWhenThreadStateRunningAndVerifyingStopWithOddCounterEqualToPreviousThenErrorMessageIsPrinted) {
226 DebugManagerStateRestore restorer;
227 NEO::debugManager.flags.DebuggerLogBitmask.set(NEO::DebugVariables::DEBUGGER_LOG_BITMASK::LOG_ERROR);
228
229 ze_device_thread_t devThread = {0, 0, 0, 0};
230 EuThread::ThreadId threadId(0, devThread);
231 EuThread euThread(threadId);
232
233 euThread.verifyStopped(1);
234 euThread.resumeThread();
235
236 StreamCapture capture;
237 capture.captureStderr();
238
239 EXPECT_TRUE(euThread.verifyStopped(1));
240 EXPECT_TRUE(euThread.isStopped());
241
242 auto message = capture.getCapturedStderr();
243 // Trim message and remove timestamp + first space
244 size_t pos = message.find(']');
245 message.erase(0, pos + 2);
246 EXPECT_STREQ("ERROR: Thread: device index = 0 slice = 0 subslice = 0 eu = 0 thread = 0 state RUNNING when thread is stopped. Switching to STOPPED", message.c_str());
247 }
248
249 TEST(EuThread, GivenThreadStateStoppedWhenVerifyingStopWithEvenCounterBiggerByMoreThanTwoThenFalseIsReturnedAndStateRunning) {
250 ze_device_thread_t devThread = {3, 4, 5, 6};
251 EuThread::ThreadId threadId(0, devThread);
252 EuThread euThread(threadId);
253 euThread.verifyStopped(1);
254
255 EXPECT_FALSE(euThread.verifyStopped(8));
256 EXPECT_TRUE(euThread.isRunning());
257 }
258
259 TEST(EuThread, GivenEuThreadWhenGettingLastCounterThenCorrectValueIsReturned) {
260 ze_device_thread_t devThread = {3, 4, 5, 6};
261 EuThread::ThreadId threadId(0, devThread);
262 EuThread euThread(threadId);
263
264 EXPECT_EQ(0u, euThread.getLastCounter());
265 euThread.verifyStopped(1);
266 EXPECT_EQ(1u, euThread.getLastCounter());
267 euThread.verifyStopped(9);
268 EXPECT_EQ(9u, euThread.getLastCounter());
269 }
270
271 TEST(EuThread, GivenEuThreadWhenGettingPageFaultThenCorrectValueIsReturned) {
272 ze_device_thread_t devThread = {3, 4, 5, 6};
273 EuThread::ThreadId threadId(0, devThread);
274 EuThread euThread(threadId);
275
276 EXPECT_EQ(false, euThread.getPageFault());
277 euThread.setPageFault(true);
278 EXPECT_EQ(true, euThread.getPageFault());
279 euThread.setPageFault(false);
280 EXPECT_EQ(false, euThread.getPageFault());
281 }
282
283 } // namespace ult
284 } // namespace L0