OLD | NEW |
| (Empty) |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 // | |
5 // Unit tests for event trace consumer base class. | |
6 #include "base/win/event_trace_consumer.h" | |
7 | |
8 #include <list> | |
9 | |
10 #include <objbase.h> | |
11 | |
12 #include "base/basictypes.h" | |
13 #include "base/files/file_path.h" | |
14 #include "base/files/file_util.h" | |
15 #include "base/files/scoped_temp_dir.h" | |
16 #include "base/logging.h" | |
17 #include "base/process/process_handle.h" | |
18 #include "base/strings/stringprintf.h" | |
19 #include "base/win/event_trace_controller.h" | |
20 #include "base/win/event_trace_provider.h" | |
21 #include "base/win/scoped_handle.h" | |
22 #include "testing/gtest/include/gtest/gtest.h" | |
23 | |
24 #include <initguid.h> // NOLINT - has to be last | |
25 | |
26 namespace base { | |
27 namespace win { | |
28 | |
29 namespace { | |
30 | |
31 typedef std::list<EVENT_TRACE> EventQueue; | |
32 | |
33 class TestConsumer: public EtwTraceConsumerBase<TestConsumer> { | |
34 public: | |
35 TestConsumer() { | |
36 sank_event_.Set(::CreateEvent(NULL, TRUE, FALSE, NULL)); | |
37 ClearQueue(); | |
38 } | |
39 | |
40 ~TestConsumer() { | |
41 ClearQueue(); | |
42 sank_event_.Close(); | |
43 } | |
44 | |
45 void ClearQueue() { | |
46 for (EventQueue::const_iterator it(events_.begin()), end(events_.end()); | |
47 it != end; ++it) { | |
48 delete[] reinterpret_cast<char*>(it->MofData); | |
49 } | |
50 | |
51 events_.clear(); | |
52 } | |
53 | |
54 static void EnqueueEvent(EVENT_TRACE* event) { | |
55 events_.push_back(*event); | |
56 EVENT_TRACE& back = events_.back(); | |
57 | |
58 if (event->MofData != NULL && event->MofLength != 0) { | |
59 back.MofData = new char[event->MofLength]; | |
60 memcpy(back.MofData, event->MofData, event->MofLength); | |
61 } | |
62 } | |
63 | |
64 static void ProcessEvent(EVENT_TRACE* event) { | |
65 EnqueueEvent(event); | |
66 ::SetEvent(sank_event_.Get()); | |
67 } | |
68 | |
69 static ScopedHandle sank_event_; | |
70 static EventQueue events_; | |
71 | |
72 private: | |
73 DISALLOW_COPY_AND_ASSIGN(TestConsumer); | |
74 }; | |
75 | |
76 ScopedHandle TestConsumer::sank_event_; | |
77 EventQueue TestConsumer::events_; | |
78 | |
79 class EtwTraceConsumerBaseTest: public testing::Test { | |
80 public: | |
81 EtwTraceConsumerBaseTest() | |
82 : session_name_(StringPrintf(L"TestSession-%d", GetCurrentProcId())) { | |
83 } | |
84 | |
85 void SetUp() override { | |
86 // Cleanup any potentially dangling sessions. | |
87 EtwTraceProperties ignore; | |
88 EtwTraceController::Stop(session_name_.c_str(), &ignore); | |
89 | |
90 // Allocate a new GUID for each provider test. | |
91 ASSERT_HRESULT_SUCCEEDED(::CoCreateGuid(&test_provider_)); | |
92 } | |
93 | |
94 void TearDown() override { | |
95 // Cleanup any potentially dangling sessions. | |
96 EtwTraceProperties ignore; | |
97 EtwTraceController::Stop(session_name_.c_str(), &ignore); | |
98 } | |
99 | |
100 protected: | |
101 GUID test_provider_; | |
102 std::wstring session_name_; | |
103 }; | |
104 | |
105 } // namespace | |
106 | |
107 TEST_F(EtwTraceConsumerBaseTest, Initialize) { | |
108 TestConsumer consumer_; | |
109 } | |
110 | |
111 TEST_F(EtwTraceConsumerBaseTest, OpenRealtimeSucceedsWhenNoSession) { | |
112 TestConsumer consumer_; | |
113 ASSERT_HRESULT_SUCCEEDED( | |
114 consumer_.OpenRealtimeSession(session_name_.c_str())); | |
115 } | |
116 | |
117 TEST_F(EtwTraceConsumerBaseTest, ConsumerImmediateFailureWhenNoSession) { | |
118 TestConsumer consumer_; | |
119 ASSERT_HRESULT_SUCCEEDED( | |
120 consumer_.OpenRealtimeSession(session_name_.c_str())); | |
121 ASSERT_HRESULT_FAILED(consumer_.Consume()); | |
122 } | |
123 | |
124 namespace { | |
125 | |
126 class EtwTraceConsumerRealtimeTest: public EtwTraceConsumerBaseTest { | |
127 public: | |
128 void SetUp() override { | |
129 EtwTraceConsumerBaseTest::SetUp(); | |
130 ASSERT_HRESULT_SUCCEEDED( | |
131 consumer_.OpenRealtimeSession(session_name_.c_str())); | |
132 } | |
133 | |
134 void TearDown() override { | |
135 consumer_.Close(); | |
136 EtwTraceConsumerBaseTest::TearDown(); | |
137 } | |
138 | |
139 DWORD ConsumerThread() { | |
140 ::SetEvent(consumer_ready_.Get()); | |
141 return consumer_.Consume(); | |
142 } | |
143 | |
144 static DWORD WINAPI ConsumerThreadMainProc(void* arg) { | |
145 return reinterpret_cast<EtwTraceConsumerRealtimeTest*>(arg)-> | |
146 ConsumerThread(); | |
147 } | |
148 | |
149 HRESULT StartConsumerThread() { | |
150 consumer_ready_.Set(::CreateEvent(NULL, TRUE, FALSE, NULL)); | |
151 EXPECT_TRUE(consumer_ready_.IsValid()); | |
152 consumer_thread_.Set(::CreateThread(NULL, 0, ConsumerThreadMainProc, this, | |
153 0, NULL)); | |
154 if (consumer_thread_.Get() == NULL) | |
155 return HRESULT_FROM_WIN32(::GetLastError()); | |
156 | |
157 HANDLE events[] = { consumer_ready_.Get(), consumer_thread_.Get() }; | |
158 DWORD result = ::WaitForMultipleObjects(arraysize(events), events, | |
159 FALSE, INFINITE); | |
160 switch (result) { | |
161 case WAIT_OBJECT_0: | |
162 // The event was set, the consumer_ is ready. | |
163 return S_OK; | |
164 case WAIT_OBJECT_0 + 1: { | |
165 // The thread finished. This may race with the event, so check | |
166 // explicitly for the event here, before concluding there's trouble. | |
167 if (::WaitForSingleObject(consumer_ready_.Get(), 0) == WAIT_OBJECT_0) | |
168 return S_OK; | |
169 DWORD exit_code = 0; | |
170 if (::GetExitCodeThread(consumer_thread_.Get(), &exit_code)) | |
171 return exit_code; | |
172 return HRESULT_FROM_WIN32(::GetLastError()); | |
173 } | |
174 default: | |
175 return E_UNEXPECTED; | |
176 } | |
177 } | |
178 | |
179 // Waits for consumer_ thread to exit, and returns its exit code. | |
180 HRESULT JoinConsumerThread() { | |
181 if (::WaitForSingleObject(consumer_thread_.Get(), INFINITE) != | |
182 WAIT_OBJECT_0) { | |
183 return HRESULT_FROM_WIN32(::GetLastError()); | |
184 } | |
185 | |
186 DWORD exit_code = 0; | |
187 if (::GetExitCodeThread(consumer_thread_.Get(), &exit_code)) | |
188 return exit_code; | |
189 | |
190 return HRESULT_FROM_WIN32(::GetLastError()); | |
191 } | |
192 | |
193 TestConsumer consumer_; | |
194 ScopedHandle consumer_ready_; | |
195 ScopedHandle consumer_thread_; | |
196 }; | |
197 | |
198 } // namespace | |
199 | |
200 TEST_F(EtwTraceConsumerRealtimeTest, ConsumerReturnsWhenSessionClosed) { | |
201 EtwTraceController controller; | |
202 if (controller.StartRealtimeSession(session_name_.c_str(), 100 * 1024) == | |
203 E_ACCESSDENIED) { | |
204 VLOG(1) << "You must be an administrator to run this test on Vista"; | |
205 return; | |
206 } | |
207 | |
208 // Start the consumer_. | |
209 ASSERT_HRESULT_SUCCEEDED(StartConsumerThread()); | |
210 | |
211 // Wait around for the consumer_ thread a bit. | |
212 ASSERT_EQ(WAIT_TIMEOUT, ::WaitForSingleObject(consumer_thread_.Get(), 50)); | |
213 ASSERT_HRESULT_SUCCEEDED(controller.Stop(NULL)); | |
214 | |
215 // The consumer_ returns success on session stop. | |
216 ASSERT_HRESULT_SUCCEEDED(JoinConsumerThread()); | |
217 } | |
218 | |
219 namespace { | |
220 | |
221 // {57E47923-A549-476f-86CA-503D57F59E62} | |
222 DEFINE_GUID( | |
223 kTestEventType, | |
224 0x57e47923, 0xa549, 0x476f, 0x86, 0xca, 0x50, 0x3d, 0x57, 0xf5, 0x9e, 0x62); | |
225 | |
226 } // namespace | |
227 | |
228 TEST_F(EtwTraceConsumerRealtimeTest, ConsumeEvent) { | |
229 EtwTraceController controller; | |
230 if (controller.StartRealtimeSession(session_name_.c_str(), 100 * 1024) == | |
231 E_ACCESSDENIED) { | |
232 VLOG(1) << "You must be an administrator to run this test on Vista"; | |
233 return; | |
234 } | |
235 | |
236 ASSERT_HRESULT_SUCCEEDED(controller.EnableProvider( | |
237 test_provider_, TRACE_LEVEL_VERBOSE, 0xFFFFFFFF)); | |
238 | |
239 EtwTraceProvider provider(test_provider_); | |
240 ASSERT_EQ(ERROR_SUCCESS, provider.Register()); | |
241 | |
242 // Start the consumer_. | |
243 ASSERT_HRESULT_SUCCEEDED(StartConsumerThread()); | |
244 ASSERT_EQ(0, TestConsumer::events_.size()); | |
245 | |
246 EtwMofEvent<1> event(kTestEventType, 1, TRACE_LEVEL_ERROR); | |
247 EXPECT_EQ(ERROR_SUCCESS, provider.Log(&event.header)); | |
248 EXPECT_EQ(WAIT_OBJECT_0, | |
249 ::WaitForSingleObject(TestConsumer::sank_event_.Get(), INFINITE)); | |
250 ASSERT_HRESULT_SUCCEEDED(controller.Stop(NULL)); | |
251 ASSERT_HRESULT_SUCCEEDED(JoinConsumerThread()); | |
252 ASSERT_NE(0u, TestConsumer::events_.size()); | |
253 } | |
254 | |
255 namespace { | |
256 | |
257 // We run events through a file session to assert that | |
258 // the content comes through. | |
259 class EtwTraceConsumerDataTest: public EtwTraceConsumerBaseTest { | |
260 public: | |
261 EtwTraceConsumerDataTest() { | |
262 } | |
263 | |
264 void SetUp() override { | |
265 EtwTraceConsumerBaseTest::SetUp(); | |
266 | |
267 EtwTraceProperties prop; | |
268 EtwTraceController::Stop(session_name_.c_str(), &prop); | |
269 | |
270 // Create a temp dir for this test. | |
271 ASSERT_TRUE(temp_dir_.CreateUniqueTempDir()); | |
272 // Construct a temp file name in our dir. | |
273 temp_file_ = temp_dir_.path().Append(L"test.etl"); | |
274 } | |
275 | |
276 void TearDown() override { | |
277 EXPECT_TRUE(base::DeleteFile(temp_file_, false)); | |
278 | |
279 EtwTraceConsumerBaseTest::TearDown(); | |
280 } | |
281 | |
282 HRESULT LogEventToTempSession(PEVENT_TRACE_HEADER header) { | |
283 EtwTraceController controller; | |
284 | |
285 // Set up a file session. | |
286 HRESULT hr = controller.StartFileSession(session_name_.c_str(), | |
287 temp_file_.value().c_str()); | |
288 if (FAILED(hr)) | |
289 return hr; | |
290 | |
291 // Enable our provider. | |
292 EXPECT_HRESULT_SUCCEEDED(controller.EnableProvider( | |
293 test_provider_, TRACE_LEVEL_VERBOSE, 0xFFFFFFFF)); | |
294 | |
295 EtwTraceProvider provider(test_provider_); | |
296 // Then register our provider, means we get a session handle immediately. | |
297 EXPECT_EQ(ERROR_SUCCESS, provider.Register()); | |
298 // Trace the event, it goes to the temp file. | |
299 EXPECT_EQ(ERROR_SUCCESS, provider.Log(header)); | |
300 EXPECT_HRESULT_SUCCEEDED(controller.DisableProvider(test_provider_)); | |
301 EXPECT_HRESULT_SUCCEEDED(provider.Unregister()); | |
302 EXPECT_HRESULT_SUCCEEDED(controller.Flush(NULL)); | |
303 EXPECT_HRESULT_SUCCEEDED(controller.Stop(NULL)); | |
304 | |
305 return S_OK; | |
306 } | |
307 | |
308 HRESULT ConsumeEventFromTempSession() { | |
309 // Now consume the event(s). | |
310 TestConsumer consumer_; | |
311 HRESULT hr = consumer_.OpenFileSession(temp_file_.value().c_str()); | |
312 if (SUCCEEDED(hr)) | |
313 hr = consumer_.Consume(); | |
314 consumer_.Close(); | |
315 // And nab the result. | |
316 events_.swap(TestConsumer::events_); | |
317 return hr; | |
318 } | |
319 | |
320 HRESULT RoundTripEvent(PEVENT_TRACE_HEADER header, PEVENT_TRACE* trace) { | |
321 base::DeleteFile(temp_file_, false); | |
322 | |
323 HRESULT hr = LogEventToTempSession(header); | |
324 if (SUCCEEDED(hr)) | |
325 hr = ConsumeEventFromTempSession(); | |
326 | |
327 if (FAILED(hr)) | |
328 return hr; | |
329 | |
330 // We should now have the event in the queue. | |
331 if (events_.empty()) | |
332 return E_FAIL; | |
333 | |
334 *trace = &events_.back(); | |
335 return S_OK; | |
336 } | |
337 | |
338 EventQueue events_; | |
339 ScopedTempDir temp_dir_; | |
340 FilePath temp_file_; | |
341 }; | |
342 | |
343 } // namespace | |
344 | |
345 | |
346 TEST_F(EtwTraceConsumerDataTest, RoundTrip) { | |
347 EtwMofEvent<1> event(kTestEventType, 1, TRACE_LEVEL_ERROR); | |
348 | |
349 static const char kData[] = "This is but test data"; | |
350 event.fields[0].DataPtr = reinterpret_cast<ULONG64>(kData); | |
351 event.fields[0].Length = sizeof(kData); | |
352 | |
353 PEVENT_TRACE trace = NULL; | |
354 HRESULT hr = RoundTripEvent(&event.header, &trace); | |
355 if (hr == E_ACCESSDENIED) { | |
356 VLOG(1) << "You must be an administrator to run this test on Vista"; | |
357 return; | |
358 } | |
359 ASSERT_HRESULT_SUCCEEDED(hr) << "RoundTripEvent failed"; | |
360 ASSERT_TRUE(trace != NULL); | |
361 ASSERT_EQ(sizeof(kData), trace->MofLength); | |
362 ASSERT_STREQ(kData, reinterpret_cast<const char*>(trace->MofData)); | |
363 } | |
364 | |
365 } // namespace win | |
366 } // namespace base | |
OLD | NEW |