blob: 68416f5557f987dd36537b5e3fea8ac82997fe21 [file] [log] [blame]
henrike@webrtc.orgf0488722014-05-13 18:00:26 +00001/*
2 * Copyright 2004 The WebRTC Project Authors. All rights reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
Jonas Olssona4d87372019-07-05 19:08:33 +020011#include "rtc_base/thread.h"
12
kwibergbfefb032016-05-01 14:53:46 -070013#include <memory>
14
Ali Tofigh83db78e2022-08-23 12:57:16 +020015#include "api/field_trials_view.h"
Danil Chapovalov912b3b82019-11-22 15:52:40 +010016#include "api/task_queue/task_queue_factory.h"
17#include "api/task_queue/task_queue_test.h"
Danil Chapovalov4bcf8092022-07-06 19:42:34 +020018#include "api/units/time_delta.h"
Steve Anton10542f22019-01-11 09:11:00 -080019#include "rtc_base/async_invoker.h"
20#include "rtc_base/async_udp_socket.h"
Mirko Bonadei481e3452021-07-30 13:57:25 +020021#include "rtc_base/checks.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020022#include "rtc_base/event.h"
Danil Chapovalov207f8532022-08-24 12:19:46 +020023#include "rtc_base/fake_clock.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020024#include "rtc_base/gunit.h"
Mirko Bonadeie5f4c6b2021-01-15 10:41:01 +010025#include "rtc_base/internal/default_socket_server.h"
Steve Anton10542f22019-01-11 09:11:00 -080026#include "rtc_base/null_socket_server.h"
27#include "rtc_base/physical_socket_server.h"
28#include "rtc_base/socket_address.h"
Markus Handell4ab7dde2020-07-10 13:23:25 +020029#include "rtc_base/synchronization/mutex.h"
Artem Titove41c4332018-07-25 15:04:28 +020030#include "rtc_base/third_party/sigslot/sigslot.h"
Danil Chapovalov207f8532022-08-24 12:19:46 +020031#include "test/gmock.h"
Sebastian Janssonda7267a2020-03-03 10:48:05 +010032#include "test/testsupport/rtc_expect_death.h"
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000033
34#if defined(WEBRTC_WIN)
35#include <comdef.h> // NOLINT
Markus Handell4ab7dde2020-07-10 13:23:25 +020036
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000037#endif
38
Mirko Bonadeie10b1632018-12-11 18:43:40 +010039namespace rtc {
40namespace {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000041
Danil Chapovalov207f8532022-08-24 12:19:46 +020042using ::testing::ElementsAre;
Danil Chapovalov4bcf8092022-07-06 19:42:34 +020043using ::webrtc::TimeDelta;
Sebastian Jansson73387822020-01-16 11:15:35 +010044
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000045// Generates a sequence of numbers (collaboratively).
46class TestGenerator {
47 public:
48 TestGenerator() : last(0), count(0) {}
49
50 int Next(int prev) {
51 int result = prev + last;
52 last = result;
53 count += 1;
54 return result;
55 }
56
57 int last;
58 int count;
59};
60
61struct TestMessage : public MessageData {
62 explicit TestMessage(int v) : value(v) {}
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000063
64 int value;
65};
66
67// Receives on a socket and sends by posting messages.
68class SocketClient : public TestGenerator, public sigslot::has_slots<> {
69 public:
Niels Möllerd0b88792021-08-12 10:32:30 +020070 SocketClient(Socket* socket,
Yves Gerey665174f2018-06-19 15:03:05 +020071 const SocketAddress& addr,
72 Thread* post_thread,
73 MessageHandler* phandler)
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000074 : socket_(AsyncUDPSocket::Create(socket, addr)),
75 post_thread_(post_thread),
76 post_handler_(phandler) {
77 socket_->SignalReadPacket.connect(this, &SocketClient::OnPacket);
78 }
79
Steve Anton9de3aac2017-10-24 10:08:26 -070080 ~SocketClient() override { delete socket_; }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000081
82 SocketAddress address() const { return socket_->GetLocalAddress(); }
83
Yves Gerey665174f2018-06-19 15:03:05 +020084 void OnPacket(AsyncPacketSocket* socket,
85 const char* buf,
86 size_t size,
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000087 const SocketAddress& remote_addr,
Niels Möllere6933812018-11-05 13:01:41 +010088 const int64_t& packet_time_us) {
Peter Boström0c4e06b2015-10-07 12:23:21 +020089 EXPECT_EQ(size, sizeof(uint32_t));
90 uint32_t prev = reinterpret_cast<const uint32_t*>(buf)[0];
91 uint32_t result = Next(prev);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000092
Taylor Brandstetter5d97a9a2016-06-10 14:17:27 -070093 post_thread_->PostDelayed(RTC_FROM_HERE, 200, post_handler_, 0,
94 new TestMessage(result));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +000095 }
96
97 private:
98 AsyncUDPSocket* socket_;
99 Thread* post_thread_;
100 MessageHandler* post_handler_;
101};
102
103// Receives messages and sends on a socket.
Tomas Gunnarssonabdb4702020-09-05 18:43:36 +0200104class MessageClient : public MessageHandlerAutoCleanup, public TestGenerator {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000105 public:
Yves Gerey665174f2018-06-19 15:03:05 +0200106 MessageClient(Thread* pth, Socket* socket) : socket_(socket) {}
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000107
Steve Anton9de3aac2017-10-24 10:08:26 -0700108 ~MessageClient() override { delete socket_; }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000109
Steve Anton9de3aac2017-10-24 10:08:26 -0700110 void OnMessage(Message* pmsg) override {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000111 TestMessage* msg = static_cast<TestMessage*>(pmsg->pdata);
112 int result = Next(msg->value);
113 EXPECT_GE(socket_->Send(&result, sizeof(result)), 0);
114 delete msg;
115 }
116
117 private:
118 Socket* socket_;
119};
120
deadbeefaea92932017-05-23 12:55:03 -0700121class CustomThread : public rtc::Thread {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000122 public:
tommie7251592017-07-14 14:44:46 -0700123 CustomThread()
124 : Thread(std::unique_ptr<SocketServer>(new rtc::NullSocketServer())) {}
Steve Anton9de3aac2017-10-24 10:08:26 -0700125 ~CustomThread() override { Stop(); }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000126 bool Start() { return false; }
jiayl@webrtc.orgba737cb2014-09-18 16:45:21 +0000127
Yves Gerey665174f2018-06-19 15:03:05 +0200128 bool WrapCurrent() { return Thread::WrapCurrent(); }
129 void UnwrapCurrent() { Thread::UnwrapCurrent(); }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000130};
131
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000132// A thread that does nothing when it runs and signals an event
133// when it is destroyed.
134class SignalWhenDestroyedThread : public Thread {
135 public:
136 SignalWhenDestroyedThread(Event* event)
tommie7251592017-07-14 14:44:46 -0700137 : Thread(std::unique_ptr<SocketServer>(new NullSocketServer())),
138 event_(event) {}
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000139
Steve Anton9de3aac2017-10-24 10:08:26 -0700140 ~SignalWhenDestroyedThread() override {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000141 Stop();
142 event_->Set();
143 }
144
Steve Anton9de3aac2017-10-24 10:08:26 -0700145 void Run() override {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000146 // Do nothing.
147 }
148
149 private:
150 Event* event_;
151};
152
nissed9b75be2015-11-16 00:54:07 -0800153// A bool wrapped in a mutex, to avoid data races. Using a volatile
154// bool should be sufficient for correct code ("eventual consistency"
155// between caches is sufficient), but we can't tell the compiler about
156// that, and then tsan complains about a data race.
157
158// See also discussion at
159// http://stackoverflow.com/questions/7223164/is-mutex-needed-to-synchronize-a-simple-flag-between-pthreads
160
161// Using std::atomic<bool> or std::atomic_flag in C++11 is probably
162// the right thing to do, but those features are not yet allowed. Or
deadbeefaea92932017-05-23 12:55:03 -0700163// rtc::AtomicInt, if/when that is added. Since the use isn't
nissed9b75be2015-11-16 00:54:07 -0800164// performance critical, use a plain critical section for the time
165// being.
166
167class AtomicBool {
168 public:
169 explicit AtomicBool(bool value = false) : flag_(value) {}
170 AtomicBool& operator=(bool value) {
Markus Handell4ab7dde2020-07-10 13:23:25 +0200171 webrtc::MutexLock scoped_lock(&mutex_);
nissed9b75be2015-11-16 00:54:07 -0800172 flag_ = value;
173 return *this;
174 }
175 bool get() const {
Markus Handell4ab7dde2020-07-10 13:23:25 +0200176 webrtc::MutexLock scoped_lock(&mutex_);
nissed9b75be2015-11-16 00:54:07 -0800177 return flag_;
178 }
179
180 private:
Markus Handell4ab7dde2020-07-10 13:23:25 +0200181 mutable webrtc::Mutex mutex_;
nissed9b75be2015-11-16 00:54:07 -0800182 bool flag_;
183};
184
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000185// Function objects to test Thread::Invoke.
186struct FunctorA {
187 int operator()() { return 42; }
188};
189class FunctorB {
190 public:
nissed9b75be2015-11-16 00:54:07 -0800191 explicit FunctorB(AtomicBool* flag) : flag_(flag) {}
Yves Gerey665174f2018-06-19 15:03:05 +0200192 void operator()() {
193 if (flag_)
194 *flag_ = true;
195 }
196
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000197 private:
nissed9b75be2015-11-16 00:54:07 -0800198 AtomicBool* flag_;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000199};
200struct FunctorC {
201 int operator()() {
202 Thread::Current()->ProcessMessages(50);
203 return 24;
204 }
205};
Cameron Pickettd132ce12018-03-12 16:07:37 -0700206struct FunctorD {
207 public:
208 explicit FunctorD(AtomicBool* flag) : flag_(flag) {}
209 FunctorD(FunctorD&&) = default;
Byoungchan Lee14af7622022-01-12 05:24:58 +0900210
211 FunctorD(const FunctorD&) = delete;
212 FunctorD& operator=(const FunctorD&) = delete;
213
Cameron Pickettd132ce12018-03-12 16:07:37 -0700214 FunctorD& operator=(FunctorD&&) = default;
Yves Gerey665174f2018-06-19 15:03:05 +0200215 void operator()() {
216 if (flag_)
217 *flag_ = true;
218 }
219
Cameron Pickettd132ce12018-03-12 16:07:37 -0700220 private:
221 AtomicBool* flag_;
Cameron Pickettd132ce12018-03-12 16:07:37 -0700222};
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000223
224// See: https://code.google.com/p/webrtc/issues/detail?id=2409
225TEST(ThreadTest, DISABLED_Main) {
226 const SocketAddress addr("127.0.0.1", 0);
227
228 // Create the messaging client on its own thread.
tommie7251592017-07-14 14:44:46 -0700229 auto th1 = Thread::CreateWithSocketServer();
Niels Möllerd0b88792021-08-12 10:32:30 +0200230 Socket* socket = th1->socketserver()->CreateSocket(addr.family(), SOCK_DGRAM);
tommie7251592017-07-14 14:44:46 -0700231 MessageClient msg_client(th1.get(), socket);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000232
233 // Create the socket client on its own thread.
tommie7251592017-07-14 14:44:46 -0700234 auto th2 = Thread::CreateWithSocketServer();
Niels Möllerd0b88792021-08-12 10:32:30 +0200235 Socket* asocket =
236 th2->socketserver()->CreateSocket(addr.family(), SOCK_DGRAM);
tommie7251592017-07-14 14:44:46 -0700237 SocketClient sock_client(asocket, addr, th1.get(), &msg_client);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000238
239 socket->Connect(sock_client.address());
240
tommie7251592017-07-14 14:44:46 -0700241 th1->Start();
242 th2->Start();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000243
244 // Get the messages started.
tommie7251592017-07-14 14:44:46 -0700245 th1->PostDelayed(RTC_FROM_HERE, 100, &msg_client, 0, new TestMessage(1));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000246
247 // Give the clients a little while to run.
248 // Messages will be processed at 100, 300, 500, 700, 900.
249 Thread* th_main = Thread::Current();
250 th_main->ProcessMessages(1000);
251
252 // Stop the sending client. Give the receiver a bit longer to run, in case
253 // it is running on a machine that is under load (e.g. the build machine).
tommie7251592017-07-14 14:44:46 -0700254 th1->Stop();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000255 th_main->ProcessMessages(200);
tommie7251592017-07-14 14:44:46 -0700256 th2->Stop();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000257
258 // Make sure the results were correct
259 EXPECT_EQ(5, msg_client.count);
260 EXPECT_EQ(34, msg_client.last);
261 EXPECT_EQ(5, sock_client.count);
262 EXPECT_EQ(55, sock_client.last);
263}
264
Tommife041642021-04-07 10:08:28 +0200265TEST(ThreadTest, CountBlockingCalls) {
Niels Möller83830f32022-05-20 09:12:57 +0200266 rtc::AutoThread current;
267
Tommife041642021-04-07 10:08:28 +0200268 // When the test runs, this will print out:
269 // (thread_unittest.cc:262): Blocking TestBody: total=2 (actual=1, could=1)
270 RTC_LOG_THREAD_BLOCK_COUNT();
271#if RTC_DCHECK_IS_ON
Tommife041642021-04-07 10:08:28 +0200272 rtc::Thread::ScopedCountBlockingCalls blocked_calls(
273 [&](uint32_t actual_block, uint32_t could_block) {
274 EXPECT_EQ(1u, actual_block);
275 EXPECT_EQ(1u, could_block);
276 });
277
278 EXPECT_EQ(0u, blocked_calls.GetBlockingCallCount());
279 EXPECT_EQ(0u, blocked_calls.GetCouldBeBlockingCallCount());
280 EXPECT_EQ(0u, blocked_calls.GetTotalBlockedCallCount());
281
282 // Test invoking on the current thread. This should not count as an 'actual'
283 // invoke, but should still count as an invoke that could block since we
284 // that the call to Invoke serves a purpose in some configurations (and should
285 // not be used a general way to call methods on the same thread).
Niels Möller83830f32022-05-20 09:12:57 +0200286 current.Invoke<void>(RTC_FROM_HERE, []() {});
Tommife041642021-04-07 10:08:28 +0200287 EXPECT_EQ(0u, blocked_calls.GetBlockingCallCount());
288 EXPECT_EQ(1u, blocked_calls.GetCouldBeBlockingCallCount());
289 EXPECT_EQ(1u, blocked_calls.GetTotalBlockedCallCount());
290
291 // Create a new thread to invoke on.
292 auto thread = Thread::CreateWithSocketServer();
293 thread->Start();
294 EXPECT_EQ(42, thread->Invoke<int>(RTC_FROM_HERE, []() { return 42; }));
295 EXPECT_EQ(1u, blocked_calls.GetBlockingCallCount());
296 EXPECT_EQ(1u, blocked_calls.GetCouldBeBlockingCallCount());
297 EXPECT_EQ(2u, blocked_calls.GetTotalBlockedCallCount());
298 thread->Stop();
299 RTC_DCHECK_BLOCK_COUNT_NO_MORE_THAN(2);
300#else
301 RTC_DCHECK_BLOCK_COUNT_NO_MORE_THAN(0);
302 RTC_LOG(LS_INFO) << "Test not active in this config";
303#endif
304}
305
Tomas Gunnarsson89f3dd52021-04-14 12:54:10 +0200306#if RTC_DCHECK_IS_ON
307TEST(ThreadTest, CountBlockingCallsOneCallback) {
Niels Möller83830f32022-05-20 09:12:57 +0200308 rtc::AutoThread current;
Tomas Gunnarsson89f3dd52021-04-14 12:54:10 +0200309 bool was_called_back = false;
310 {
311 rtc::Thread::ScopedCountBlockingCalls blocked_calls(
312 [&](uint32_t actual_block, uint32_t could_block) {
313 was_called_back = true;
314 });
Niels Möller83830f32022-05-20 09:12:57 +0200315 current.Invoke<void>(RTC_FROM_HERE, []() {});
Tomas Gunnarsson89f3dd52021-04-14 12:54:10 +0200316 }
317 EXPECT_TRUE(was_called_back);
318}
319
320TEST(ThreadTest, CountBlockingCallsSkipCallback) {
Niels Möller83830f32022-05-20 09:12:57 +0200321 rtc::AutoThread current;
Tomas Gunnarsson89f3dd52021-04-14 12:54:10 +0200322 bool was_called_back = false;
323 {
324 rtc::Thread::ScopedCountBlockingCalls blocked_calls(
325 [&](uint32_t actual_block, uint32_t could_block) {
326 was_called_back = true;
327 });
328 // Changed `blocked_calls` to not issue the callback if there are 1 or
329 // fewer blocking calls (i.e. we set the minimum required number to 2).
330 blocked_calls.set_minimum_call_count_for_callback(2);
Niels Möller83830f32022-05-20 09:12:57 +0200331 current.Invoke<void>(RTC_FROM_HERE, []() {});
Tomas Gunnarsson89f3dd52021-04-14 12:54:10 +0200332 }
333 // We should not have gotten a call back.
334 EXPECT_FALSE(was_called_back);
335}
336#endif
337
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000338// Test that setting thread names doesn't cause a malfunction.
339// There's no easy way to verify the name was set properly at this time.
henrike@webrtc.orgc732a3e2014-10-09 22:08:15 +0000340TEST(ThreadTest, Names) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000341 // Default name
tommie7251592017-07-14 14:44:46 -0700342 auto thread = Thread::CreateWithSocketServer();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000343 EXPECT_TRUE(thread->Start());
344 thread->Stop();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000345 // Name with no object parameter
tommie7251592017-07-14 14:44:46 -0700346 thread = Thread::CreateWithSocketServer();
deadbeef37f5ecf2017-02-27 14:06:41 -0800347 EXPECT_TRUE(thread->SetName("No object", nullptr));
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000348 EXPECT_TRUE(thread->Start());
349 thread->Stop();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000350 // Really long name
tommie7251592017-07-14 14:44:46 -0700351 thread = Thread::CreateWithSocketServer();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000352 EXPECT_TRUE(thread->SetName("Abcdefghijklmnopqrstuvwxyz1234567890", this));
353 EXPECT_TRUE(thread->Start());
354 thread->Stop();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000355}
356
henrike@webrtc.orge30dab72014-10-09 15:41:40 +0000357TEST(ThreadTest, Wrap) {
358 Thread* current_thread = Thread::Current();
Niels Möller5a8f8602019-06-12 11:30:59 +0200359 ThreadManager::Instance()->SetCurrentThread(nullptr);
360
361 {
362 CustomThread cthread;
363 EXPECT_TRUE(cthread.WrapCurrent());
364 EXPECT_EQ(&cthread, Thread::Current());
365 EXPECT_TRUE(cthread.RunningForTest());
366 EXPECT_FALSE(cthread.IsOwned());
367 cthread.UnwrapCurrent();
368 EXPECT_FALSE(cthread.RunningForTest());
369 }
370 ThreadManager::Instance()->SetCurrentThread(current_thread);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000371}
372
Mirko Bonadei481e3452021-07-30 13:57:25 +0200373#if (!defined(NDEBUG) || RTC_DCHECK_IS_ON)
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200374TEST(ThreadTest, InvokeToThreadAllowedReturnsTrueWithoutPolicies) {
Niels Möller83830f32022-05-20 09:12:57 +0200375 rtc::AutoThread main_thread;
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200376 // Create and start the thread.
377 auto thread1 = Thread::CreateWithSocketServer();
378 auto thread2 = Thread::CreateWithSocketServer();
379
Danil Chapovalov4bcf8092022-07-06 19:42:34 +0200380 thread1->PostTask(
381 [&]() { EXPECT_TRUE(thread1->IsInvokeToThreadAllowed(thread2.get())); });
Niels Möller83830f32022-05-20 09:12:57 +0200382 main_thread.ProcessMessages(100);
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200383}
384
385TEST(ThreadTest, InvokeAllowedWhenThreadsAdded) {
Niels Möller83830f32022-05-20 09:12:57 +0200386 rtc::AutoThread main_thread;
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200387 // Create and start the thread.
388 auto thread1 = Thread::CreateWithSocketServer();
389 auto thread2 = Thread::CreateWithSocketServer();
390 auto thread3 = Thread::CreateWithSocketServer();
391 auto thread4 = Thread::CreateWithSocketServer();
392
393 thread1->AllowInvokesToThread(thread2.get());
394 thread1->AllowInvokesToThread(thread3.get());
395
Danil Chapovalov4bcf8092022-07-06 19:42:34 +0200396 thread1->PostTask([&]() {
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200397 EXPECT_TRUE(thread1->IsInvokeToThreadAllowed(thread2.get()));
398 EXPECT_TRUE(thread1->IsInvokeToThreadAllowed(thread3.get()));
399 EXPECT_FALSE(thread1->IsInvokeToThreadAllowed(thread4.get()));
Danil Chapovalov4bcf8092022-07-06 19:42:34 +0200400 });
Niels Möller83830f32022-05-20 09:12:57 +0200401 main_thread.ProcessMessages(100);
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200402}
403
404TEST(ThreadTest, InvokesDisallowedWhenDisallowAllInvokes) {
Niels Möller83830f32022-05-20 09:12:57 +0200405 rtc::AutoThread main_thread;
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200406 // Create and start the thread.
407 auto thread1 = Thread::CreateWithSocketServer();
408 auto thread2 = Thread::CreateWithSocketServer();
409
410 thread1->DisallowAllInvokes();
411
Danil Chapovalov4bcf8092022-07-06 19:42:34 +0200412 thread1->PostTask(
413 [&]() { EXPECT_FALSE(thread1->IsInvokeToThreadAllowed(thread2.get())); });
Niels Möller83830f32022-05-20 09:12:57 +0200414 main_thread.ProcessMessages(100);
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200415}
Mirko Bonadei481e3452021-07-30 13:57:25 +0200416#endif // (!defined(NDEBUG) || RTC_DCHECK_IS_ON)
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200417
418TEST(ThreadTest, InvokesAllowedByDefault) {
Niels Möller83830f32022-05-20 09:12:57 +0200419 rtc::AutoThread main_thread;
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200420 // Create and start the thread.
421 auto thread1 = Thread::CreateWithSocketServer();
422 auto thread2 = Thread::CreateWithSocketServer();
423
Danil Chapovalov4bcf8092022-07-06 19:42:34 +0200424 thread1->PostTask(
425 [&]() { EXPECT_TRUE(thread1->IsInvokeToThreadAllowed(thread2.get())); });
Niels Möller83830f32022-05-20 09:12:57 +0200426 main_thread.ProcessMessages(100);
Artem Titovdfc5f0d2020-07-03 12:09:26 +0200427}
428
henrike@webrtc.orgc732a3e2014-10-09 22:08:15 +0000429TEST(ThreadTest, Invoke) {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000430 // Create and start the thread.
tommie7251592017-07-14 14:44:46 -0700431 auto thread = Thread::CreateWithSocketServer();
432 thread->Start();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000433 // Try calling functors.
tommie7251592017-07-14 14:44:46 -0700434 EXPECT_EQ(42, thread->Invoke<int>(RTC_FROM_HERE, FunctorA()));
nissed9b75be2015-11-16 00:54:07 -0800435 AtomicBool called;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000436 FunctorB f2(&called);
tommie7251592017-07-14 14:44:46 -0700437 thread->Invoke<void>(RTC_FROM_HERE, f2);
nissed9b75be2015-11-16 00:54:07 -0800438 EXPECT_TRUE(called.get());
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000439 // Try calling bare functions.
440 struct LocalFuncs {
441 static int Func1() { return 999; }
442 static void Func2() {}
443 };
tommie7251592017-07-14 14:44:46 -0700444 EXPECT_EQ(999, thread->Invoke<int>(RTC_FROM_HERE, &LocalFuncs::Func1));
445 thread->Invoke<void>(RTC_FROM_HERE, &LocalFuncs::Func2);
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000446}
447
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000448// Verifies that two threads calling Invoke on each other at the same time does
Sebastian Janssonda7267a2020-03-03 10:48:05 +0100449// not deadlock but crash.
450#if RTC_DCHECK_IS_ON && GTEST_HAS_DEATH_TEST && !defined(WEBRTC_ANDROID)
451TEST(ThreadTest, TwoThreadsInvokeDeathTest) {
Mirko Bonadei386b5c32021-07-28 08:55:52 +0200452 GTEST_FLAG_SET(death_test_style, "threadsafe");
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000453 AutoThread thread;
Sebastian Janssonda7267a2020-03-03 10:48:05 +0100454 Thread* main_thread = Thread::Current();
tommie7251592017-07-14 14:44:46 -0700455 auto other_thread = Thread::CreateWithSocketServer();
456 other_thread->Start();
Sebastian Janssonda7267a2020-03-03 10:48:05 +0100457 other_thread->Invoke<void>(RTC_FROM_HERE, [main_thread] {
458 RTC_EXPECT_DEATH(main_thread->Invoke<void>(RTC_FROM_HERE, [] {}), "loop");
459 });
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000460}
461
Sebastian Janssonda7267a2020-03-03 10:48:05 +0100462TEST(ThreadTest, ThreeThreadsInvokeDeathTest) {
Mirko Bonadei386b5c32021-07-28 08:55:52 +0200463 GTEST_FLAG_SET(death_test_style, "threadsafe");
Sebastian Janssonda7267a2020-03-03 10:48:05 +0100464 AutoThread thread;
465 Thread* first = Thread::Current();
466
467 auto second = Thread::Create();
468 second->Start();
469 auto third = Thread::Create();
470 third->Start();
471
472 second->Invoke<void>(RTC_FROM_HERE, [&] {
473 third->Invoke<void>(RTC_FROM_HERE, [&] {
474 RTC_EXPECT_DEATH(first->Invoke<void>(RTC_FROM_HERE, [] {}), "loop");
475 });
476 });
477}
478
479#endif
480
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000481// Verifies that if thread A invokes a call on thread B and thread C is trying
482// to invoke A at the same time, thread A does not handle C's invoke while
483// invoking B.
484TEST(ThreadTest, ThreeThreadsInvoke) {
485 AutoThread thread;
486 Thread* thread_a = Thread::Current();
tommie7251592017-07-14 14:44:46 -0700487 auto thread_b = Thread::CreateWithSocketServer();
488 auto thread_c = Thread::CreateWithSocketServer();
489 thread_b->Start();
490 thread_c->Start();
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000491
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000492 class LockedBool {
493 public:
494 explicit LockedBool(bool value) : value_(value) {}
495
496 void Set(bool value) {
Markus Handell4ab7dde2020-07-10 13:23:25 +0200497 webrtc::MutexLock lock(&mutex_);
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000498 value_ = value;
499 }
500
501 bool Get() {
Markus Handell4ab7dde2020-07-10 13:23:25 +0200502 webrtc::MutexLock lock(&mutex_);
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000503 return value_;
504 }
505
506 private:
Markus Handell4ab7dde2020-07-10 13:23:25 +0200507 webrtc::Mutex mutex_;
508 bool value_ RTC_GUARDED_BY(mutex_);
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000509 };
510
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000511 struct LocalFuncs {
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000512 static void Set(LockedBool* out) { out->Set(true); }
513 static void InvokeSet(Thread* thread, LockedBool* out) {
Niels Möller1a29a5d2021-01-18 11:35:23 +0100514 thread->Invoke<void>(RTC_FROM_HERE, [out] { Set(out); });
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000515 }
516
Artem Titov96e3b992021-07-26 16:03:14 +0200517 // Set `out` true and call InvokeSet on `thread`.
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000518 static void SetAndInvokeSet(LockedBool* out,
519 Thread* thread,
520 LockedBool* out_inner) {
521 out->Set(true);
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000522 InvokeSet(thread, out_inner);
523 }
524
Artem Titov96e3b992021-07-26 16:03:14 +0200525 // Asynchronously invoke SetAndInvokeSet on `thread1` and wait until
526 // `thread1` starts the call.
Niels Möller0694ce72021-05-03 16:03:22 +0200527 static void AsyncInvokeSetAndWait(DEPRECATED_AsyncInvoker* invoker,
deadbeef162cb532017-02-23 17:10:07 -0800528 Thread* thread1,
529 Thread* thread2,
530 LockedBool* out) {
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000531 LockedBool async_invoked(false);
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000532
deadbeef162cb532017-02-23 17:10:07 -0800533 invoker->AsyncInvoke<void>(
Niels Möller1a29a5d2021-01-18 11:35:23 +0100534 RTC_FROM_HERE, thread1, [&async_invoked, thread2, out] {
535 SetAndInvokeSet(&async_invoked, thread2, out);
536 });
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000537
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000538 EXPECT_TRUE_WAIT(async_invoked.Get(), 2000);
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000539 }
540 };
541
Niels Möller0694ce72021-05-03 16:03:22 +0200542 DEPRECATED_AsyncInvoker invoker;
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000543 LockedBool thread_a_called(false);
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000544
545 // Start the sequence A --(invoke)--> B --(async invoke)--> C --(invoke)--> A.
546 // Thread B returns when C receives the call and C should be blocked until A
547 // starts to process messages.
Niels Möller1a29a5d2021-01-18 11:35:23 +0100548 Thread* thread_c_ptr = thread_c.get();
549 thread_b->Invoke<void>(
550 RTC_FROM_HERE, [&invoker, thread_c_ptr, thread_a, &thread_a_called] {
551 LocalFuncs::AsyncInvokeSetAndWait(&invoker, thread_c_ptr, thread_a,
552 &thread_a_called);
553 });
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000554 EXPECT_FALSE(thread_a_called.Get());
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000555
pbos@webrtc.orge93cbd12014-10-15 14:54:56 +0000556 EXPECT_TRUE_WAIT(thread_a_called.Get(), 2000);
jiayl@webrtc.org3987b6d2014-09-24 17:14:05 +0000557}
558
Sebastian Jansson73387822020-01-16 11:15:35 +0100559class ThreadQueueTest : public ::testing::Test, public Thread {
560 public:
Mirko Bonadeie5f4c6b2021-01-15 10:41:01 +0100561 ThreadQueueTest() : Thread(CreateDefaultSocketServer(), true) {}
Sebastian Jansson73387822020-01-16 11:15:35 +0100562 bool IsLocked_Worker() {
563 if (!CritForTest()->TryEnter()) {
564 return true;
565 }
566 CritForTest()->Leave();
567 return false;
568 }
569 bool IsLocked() {
570 // We have to do this on a worker thread, or else the TryEnter will
571 // succeed, since our critical sections are reentrant.
572 std::unique_ptr<Thread> worker(Thread::CreateWithSocketServer());
573 worker->Start();
Niels Möller1a29a5d2021-01-18 11:35:23 +0100574 return worker->Invoke<bool>(RTC_FROM_HERE,
575 [this] { return IsLocked_Worker(); });
Sebastian Jansson73387822020-01-16 11:15:35 +0100576 }
577};
578
579struct DeletedLockChecker {
580 DeletedLockChecker(ThreadQueueTest* test, bool* was_locked, bool* deleted)
581 : test(test), was_locked(was_locked), deleted(deleted) {}
582 ~DeletedLockChecker() {
583 *deleted = true;
584 *was_locked = test->IsLocked();
585 }
586 ThreadQueueTest* test;
587 bool* was_locked;
588 bool* deleted;
589};
590
Danil Chapovalov207f8532022-08-24 12:19:46 +0200591static void DelayedPostsWithIdenticalTimesAreProcessedInFifoOrder(
592 FakeClock& clock,
593 Thread& q) {
594 std::vector<int> run_order;
595
596 Event done;
Sebastian Jansson73387822020-01-16 11:15:35 +0100597 int64_t now = TimeMillis();
Danil Chapovalov207f8532022-08-24 12:19:46 +0200598 q.PostDelayedTask([&] { run_order.push_back(3); }, TimeDelta::Millis(3));
599 q.PostDelayedTask([&] { run_order.push_back(0); }, TimeDelta::Millis(1));
600 q.PostDelayedTask([&] { run_order.push_back(1); }, TimeDelta::Millis(2));
601 q.PostDelayedTask([&] { run_order.push_back(4); }, TimeDelta::Millis(3));
602 q.PostDelayedTask([&] { run_order.push_back(2); }, TimeDelta::Millis(2));
603 q.PostDelayedTask([&] { done.Set(); }, TimeDelta::Millis(4));
604 // Validate time was frozen while tasks were posted.
605 RTC_DCHECK_EQ(TimeMillis(), now);
Sebastian Jansson73387822020-01-16 11:15:35 +0100606
Danil Chapovalov207f8532022-08-24 12:19:46 +0200607 // Change time to make all tasks ready to run and wait for them.
608 clock.AdvanceTime(TimeDelta::Millis(4));
609 ASSERT_TRUE(done.Wait(TimeDelta::Seconds(1)));
Sebastian Jansson73387822020-01-16 11:15:35 +0100610
Danil Chapovalov207f8532022-08-24 12:19:46 +0200611 EXPECT_THAT(run_order, ElementsAre(0, 1, 2, 3, 4));
Sebastian Jansson73387822020-01-16 11:15:35 +0100612}
613
614TEST_F(ThreadQueueTest, DelayedPostsWithIdenticalTimesAreProcessedInFifoOrder) {
Danil Chapovalov207f8532022-08-24 12:19:46 +0200615 ScopedBaseFakeClock clock;
Mirko Bonadeie5f4c6b2021-01-15 10:41:01 +0100616 Thread q(CreateDefaultSocketServer(), true);
Danil Chapovalov207f8532022-08-24 12:19:46 +0200617 q.Start();
618 DelayedPostsWithIdenticalTimesAreProcessedInFifoOrder(clock, q);
Sebastian Jansson73387822020-01-16 11:15:35 +0100619
620 NullSocketServer nullss;
621 Thread q_nullss(&nullss, true);
Danil Chapovalov207f8532022-08-24 12:19:46 +0200622 q_nullss.Start();
623 DelayedPostsWithIdenticalTimesAreProcessedInFifoOrder(clock, q_nullss);
Sebastian Jansson73387822020-01-16 11:15:35 +0100624}
625
626TEST_F(ThreadQueueTest, DisposeNotLocked) {
627 bool was_locked = true;
628 bool deleted = false;
629 DeletedLockChecker* d = new DeletedLockChecker(this, &was_locked, &deleted);
630 Dispose(d);
631 Message msg;
Danil Chapovalov207f8532022-08-24 12:19:46 +0200632 ProcessMessages(0);
Sebastian Jansson73387822020-01-16 11:15:35 +0100633 EXPECT_TRUE(deleted);
634 EXPECT_FALSE(was_locked);
635}
636
Tomas Gunnarssonabdb4702020-09-05 18:43:36 +0200637class DeletedMessageHandler : public MessageHandlerAutoCleanup {
Sebastian Jansson73387822020-01-16 11:15:35 +0100638 public:
639 explicit DeletedMessageHandler(bool* deleted) : deleted_(deleted) {}
640 ~DeletedMessageHandler() override { *deleted_ = true; }
641 void OnMessage(Message* msg) override {}
642
643 private:
644 bool* deleted_;
645};
646
647TEST_F(ThreadQueueTest, DiposeHandlerWithPostedMessagePending) {
648 bool deleted = false;
649 DeletedMessageHandler* handler = new DeletedMessageHandler(&deleted);
650 // First, post a dispose.
651 Dispose(handler);
652 // Now, post a message, which should *not* be returned by Get().
653 Post(RTC_FROM_HERE, handler, 1);
654 Message msg;
Danil Chapovalov207f8532022-08-24 12:19:46 +0200655 ProcessMessages(0);
Sebastian Jansson73387822020-01-16 11:15:35 +0100656 EXPECT_TRUE(deleted);
657}
658
659// Ensure that ProcessAllMessageQueues does its essential function; process
660// all messages (both delayed and non delayed) up until the current time, on
661// all registered message queues.
662TEST(ThreadManager, ProcessAllMessageQueues) {
Niels Möller83830f32022-05-20 09:12:57 +0200663 rtc::AutoThread main_thread;
Sebastian Jansson73387822020-01-16 11:15:35 +0100664 Event entered_process_all_message_queues(true, false);
665 auto a = Thread::CreateWithSocketServer();
666 auto b = Thread::CreateWithSocketServer();
667 a->Start();
668 b->Start();
669
Niels Möller7a669002022-06-27 09:47:02 +0200670 std::atomic<int> messages_processed(0);
Sebastian Jansson73387822020-01-16 11:15:35 +0100671 auto incrementer = [&messages_processed,
672 &entered_process_all_message_queues] {
673 // Wait for event as a means to ensure Increment doesn't occur outside
674 // of ProcessAllMessageQueues. The event is set by a message posted to
675 // the main thread, which is guaranteed to be handled inside
676 // ProcessAllMessageQueues.
677 entered_process_all_message_queues.Wait(Event::kForever);
Niels Möller7a669002022-06-27 09:47:02 +0200678 messages_processed.fetch_add(1);
Sebastian Jansson73387822020-01-16 11:15:35 +0100679 };
680 auto event_signaler = [&entered_process_all_message_queues] {
681 entered_process_all_message_queues.Set();
682 };
683
684 // Post messages (both delayed and non delayed) to both threads.
Danil Chapovalov4bcf8092022-07-06 19:42:34 +0200685 a->PostTask(incrementer);
686 b->PostTask(incrementer);
687 a->PostDelayedTask(incrementer, TimeDelta::Zero());
688 b->PostDelayedTask(incrementer, TimeDelta::Zero());
689 main_thread.PostTask(event_signaler);
Sebastian Jansson73387822020-01-16 11:15:35 +0100690
691 ThreadManager::ProcessAllMessageQueuesForTesting();
Niels Möller7a669002022-06-27 09:47:02 +0200692 EXPECT_EQ(4, messages_processed.load(std::memory_order_acquire));
Sebastian Jansson73387822020-01-16 11:15:35 +0100693}
694
695// Test that ProcessAllMessageQueues doesn't hang if a thread is quitting.
696TEST(ThreadManager, ProcessAllMessageQueuesWithQuittingThread) {
697 auto t = Thread::CreateWithSocketServer();
698 t->Start();
699 t->Quit();
700 ThreadManager::ProcessAllMessageQueuesForTesting();
701}
702
703// Test that ProcessAllMessageQueues doesn't hang if a queue clears its
704// messages.
705TEST(ThreadManager, ProcessAllMessageQueuesWithClearedQueue) {
Niels Möller83830f32022-05-20 09:12:57 +0200706 rtc::AutoThread main_thread;
Sebastian Jansson73387822020-01-16 11:15:35 +0100707 Event entered_process_all_message_queues(true, false);
708 auto t = Thread::CreateWithSocketServer();
709 t->Start();
710
711 auto clearer = [&entered_process_all_message_queues] {
712 // Wait for event as a means to ensure Clear doesn't occur outside of
713 // ProcessAllMessageQueues. The event is set by a message posted to the
714 // main thread, which is guaranteed to be handled inside
715 // ProcessAllMessageQueues.
716 entered_process_all_message_queues.Wait(Event::kForever);
717 rtc::Thread::Current()->Clear(nullptr);
718 };
719 auto event_signaler = [&entered_process_all_message_queues] {
720 entered_process_all_message_queues.Set();
721 };
722
723 // Post messages (both delayed and non delayed) to both threads.
Henrik Boström2deee4b2022-01-20 11:58:05 +0100724 t->PostTask(clearer);
Niels Möller83830f32022-05-20 09:12:57 +0200725 main_thread.PostTask(event_signaler);
Sebastian Jansson73387822020-01-16 11:15:35 +0100726 ThreadManager::ProcessAllMessageQueuesForTesting();
727}
728
Tomas Gunnarssonabdb4702020-09-05 18:43:36 +0200729class RefCountedHandler : public MessageHandlerAutoCleanup,
730 public rtc::RefCountInterface {
Sebastian Jansson73387822020-01-16 11:15:35 +0100731 public:
732 void OnMessage(Message* msg) override {}
733};
734
Tomas Gunnarssonabdb4702020-09-05 18:43:36 +0200735class EmptyHandler : public MessageHandlerAutoCleanup {
Sebastian Jansson73387822020-01-16 11:15:35 +0100736 public:
737 void OnMessage(Message* msg) override {}
738};
739
740TEST(ThreadManager, ClearReentrant) {
741 std::unique_ptr<Thread> t(Thread::Create());
742 EmptyHandler handler;
743 RefCountedHandler* inner_handler(
744 new rtc::RefCountedObject<RefCountedHandler>());
745 // When the empty handler is destroyed, it will clear messages queued for
746 // itself. The message to be cleared itself wraps a MessageHandler object
747 // (RefCountedHandler) so this will cause the message queue to be cleared
748 // again in a re-entrant fashion, which previously triggered a DCHECK.
749 // The inner handler will be removed in a re-entrant fashion from the
750 // message queue of the thread while the outer handler is removed, verifying
751 // that the iterator is not invalidated in "MessageQueue::Clear".
752 t->Post(RTC_FROM_HERE, inner_handler, 0);
753 t->Post(RTC_FROM_HERE, &handler, 0,
754 new ScopedRefMessageData<RefCountedHandler>(inner_handler));
755}
756
Tommi9ebe6d72021-11-16 16:07:34 +0100757class DEPRECATED_AsyncInvokeTest : public ::testing::Test {
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000758 public:
759 void IntCallback(int value) {
760 EXPECT_EQ(expected_thread_, Thread::Current());
761 int_value_ = value;
762 }
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000763 void SetExpectedThreadForIntCallback(Thread* thread) {
764 expected_thread_ = thread;
765 }
766
767 protected:
768 enum { kWaitTimeout = 1000 };
Tommi9ebe6d72021-11-16 16:07:34 +0100769 DEPRECATED_AsyncInvokeTest() : int_value_(0), expected_thread_(nullptr) {}
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000770
Niels Möller83830f32022-05-20 09:12:57 +0200771 rtc::AutoThread main_thread_;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000772 int int_value_;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000773 Thread* expected_thread_;
774};
775
Tommi9ebe6d72021-11-16 16:07:34 +0100776TEST_F(DEPRECATED_AsyncInvokeTest, FireAndForget) {
Niels Möller0694ce72021-05-03 16:03:22 +0200777 DEPRECATED_AsyncInvoker invoker;
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000778 // Create and start the thread.
tommie7251592017-07-14 14:44:46 -0700779 auto thread = Thread::CreateWithSocketServer();
780 thread->Start();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000781 // Try calling functor.
nissed9b75be2015-11-16 00:54:07 -0800782 AtomicBool called;
tommie7251592017-07-14 14:44:46 -0700783 invoker.AsyncInvoke<void>(RTC_FROM_HERE, thread.get(), FunctorB(&called));
nissed9b75be2015-11-16 00:54:07 -0800784 EXPECT_TRUE_WAIT(called.get(), kWaitTimeout);
tommie7251592017-07-14 14:44:46 -0700785 thread->Stop();
henrike@webrtc.orgf0488722014-05-13 18:00:26 +0000786}
787
Tommi9ebe6d72021-11-16 16:07:34 +0100788TEST_F(DEPRECATED_AsyncInvokeTest, NonCopyableFunctor) {
Niels Möller0694ce72021-05-03 16:03:22 +0200789 DEPRECATED_AsyncInvoker invoker;
Cameron Pickettd132ce12018-03-12 16:07:37 -0700790 // Create and start the thread.
791 auto thread = Thread::CreateWithSocketServer();
792 thread->Start();
793 // Try calling functor.
794 AtomicBool called;
795 invoker.AsyncInvoke<void>(RTC_FROM_HERE, thread.get(), FunctorD(&called));
796 EXPECT_TRUE_WAIT(called.get(), kWaitTimeout);
797 thread->Stop();
798}
799
Tommi9ebe6d72021-11-16 16:07:34 +0100800TEST_F(DEPRECATED_AsyncInvokeTest, KillInvokerDuringExecute) {
deadbeef162cb532017-02-23 17:10:07 -0800801 // Use these events to get in a state where the functor is in the middle of
802 // executing, and then to wait for it to finish, ensuring the "EXPECT_FALSE"
803 // is run.
Niels Möllerc572ff32018-11-07 08:43:50 +0100804 Event functor_started;
805 Event functor_continue;
806 Event functor_finished;
deadbeef162cb532017-02-23 17:10:07 -0800807
tommie7251592017-07-14 14:44:46 -0700808 auto thread = Thread::CreateWithSocketServer();
809 thread->Start();
deadbeef162cb532017-02-23 17:10:07 -0800810 volatile bool invoker_destroyed = false;
811 {
deadbeef3af63b02017-08-08 17:59:47 -0700812 auto functor = [&functor_started, &functor_continue, &functor_finished,
813 &invoker_destroyed] {
814 functor_started.Set();
815 functor_continue.Wait(Event::kForever);
816 rtc::Thread::Current()->SleepMs(kWaitTimeout);
817 EXPECT_FALSE(invoker_destroyed);
818 functor_finished.Set();
819 };
Niels Möller0694ce72021-05-03 16:03:22 +0200820 DEPRECATED_AsyncInvoker invoker;
deadbeef3af63b02017-08-08 17:59:47 -0700821 invoker.AsyncInvoke<void>(RTC_FROM_HERE, thread.get(), functor);
deadbeef162cb532017-02-23 17:10:07 -0800822 functor_started.Wait(Event::kForever);
deadbeefaea92932017-05-23 12:55:03 -0700823
deadbeef3af63b02017-08-08 17:59:47 -0700824 // Destroy the invoker while the functor is still executing (doing
825 // SleepMs).
deadbeefaea92932017-05-23 12:55:03 -0700826 functor_continue.Set();
deadbeef162cb532017-02-23 17:10:07 -0800827 }
828
829 // If the destructor DIDN'T wait for the functor to finish executing, it will
830 // hit the EXPECT_FALSE(invoker_destroyed) after it finishes sleeping for a
831 // second.
832 invoker_destroyed = true;
833 functor_finished.Wait(Event::kForever);
834}
835
deadbeef3af63b02017-08-08 17:59:47 -0700836// Variant of the above test where the async-invoked task calls AsyncInvoke
Tommi9ebe6d72021-11-16 16:07:34 +0100837// *again*, for the thread on which the invoker is currently being destroyed.
838// This shouldn't deadlock or crash. The second invocation should be ignored.
839TEST_F(DEPRECATED_AsyncInvokeTest,
840 KillInvokerDuringExecuteWithReentrantInvoke) {
Niels Möllerc572ff32018-11-07 08:43:50 +0100841 Event functor_started;
deadbeef3af63b02017-08-08 17:59:47 -0700842 // Flag used to verify that the recursively invoked task never actually runs.
843 bool reentrant_functor_run = false;
844
845 Thread* main = Thread::Current();
Mirko Bonadei317a1f02019-09-17 17:06:18 +0200846 Thread thread(std::make_unique<NullSocketServer>());
deadbeef3af63b02017-08-08 17:59:47 -0700847 thread.Start();
848 {
Niels Möller0694ce72021-05-03 16:03:22 +0200849 DEPRECATED_AsyncInvoker invoker;
deadbeef3af63b02017-08-08 17:59:47 -0700850 auto reentrant_functor = [&reentrant_functor_run] {
851 reentrant_functor_run = true;
852 };
853 auto functor = [&functor_started, &invoker, main, reentrant_functor] {
854 functor_started.Set();
855 Thread::Current()->SleepMs(kWaitTimeout);
856 invoker.AsyncInvoke<void>(RTC_FROM_HERE, main, reentrant_functor);
857 };
Artem Titov96e3b992021-07-26 16:03:14 +0200858 // This queues a task on `thread` to sleep for `kWaitTimeout` then queue a
859 // task on `main`. But this second queued task should never run, since the
deadbeef3af63b02017-08-08 17:59:47 -0700860 // destructor will be entered before it's even invoked.
861 invoker.AsyncInvoke<void>(RTC_FROM_HERE, &thread, functor);
862 functor_started.Wait(Event::kForever);
863 }
864 EXPECT_FALSE(reentrant_functor_run);
865}
866
Henrik Boströmba4dcc32019-02-28 09:34:06 +0100867void WaitAndSetEvent(Event* wait_event, Event* set_event) {
868 wait_event->Wait(Event::kForever);
869 set_event->Set();
870}
871
872// A functor that keeps track of the number of copies and moves.
873class LifeCycleFunctor {
874 public:
875 struct Stats {
876 size_t copy_count = 0;
877 size_t move_count = 0;
878 };
879
880 LifeCycleFunctor(Stats* stats, Event* event) : stats_(stats), event_(event) {}
881 LifeCycleFunctor(const LifeCycleFunctor& other) { *this = other; }
882 LifeCycleFunctor(LifeCycleFunctor&& other) { *this = std::move(other); }
883
884 LifeCycleFunctor& operator=(const LifeCycleFunctor& other) {
885 stats_ = other.stats_;
886 event_ = other.event_;
887 ++stats_->copy_count;
888 return *this;
889 }
890
891 LifeCycleFunctor& operator=(LifeCycleFunctor&& other) {
892 stats_ = other.stats_;
893 event_ = other.event_;
894 ++stats_->move_count;
895 return *this;
896 }
897
898 void operator()() { event_->Set(); }
899
900 private:
901 Stats* stats_;
902 Event* event_;
903};
904
905// A functor that verifies the thread it was destroyed on.
906class DestructionFunctor {
907 public:
908 DestructionFunctor(Thread* thread, bool* thread_was_current, Event* event)
909 : thread_(thread),
910 thread_was_current_(thread_was_current),
911 event_(event) {}
912 ~DestructionFunctor() {
913 // Only signal the event if this was the functor that was invoked to avoid
914 // the event being signaled due to the destruction of temporary/moved
915 // versions of this object.
916 if (was_invoked_) {
917 *thread_was_current_ = thread_->IsCurrent();
918 event_->Set();
919 }
920 }
921
922 void operator()() { was_invoked_ = true; }
923
924 private:
925 Thread* thread_;
926 bool* thread_was_current_;
927 Event* event_;
928 bool was_invoked_ = false;
929};
930
Henrik Boströmba4dcc32019-02-28 09:34:06 +0100931TEST(ThreadPostTaskTest, InvokesWithLambda) {
932 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
933 background_thread->Start();
934
935 Event event;
Henrik Boström595f6882022-01-24 09:57:03 +0100936 background_thread->PostTask([&event] { event.Set(); });
Henrik Boströmba4dcc32019-02-28 09:34:06 +0100937 event.Wait(Event::kForever);
938}
939
940TEST(ThreadPostTaskTest, InvokesWithCopiedFunctor) {
941 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
942 background_thread->Start();
943
944 LifeCycleFunctor::Stats stats;
945 Event event;
946 LifeCycleFunctor functor(&stats, &event);
Henrik Boström595f6882022-01-24 09:57:03 +0100947 background_thread->PostTask(functor);
Henrik Boströmba4dcc32019-02-28 09:34:06 +0100948 event.Wait(Event::kForever);
949
950 EXPECT_EQ(1u, stats.copy_count);
951 EXPECT_EQ(0u, stats.move_count);
952}
953
954TEST(ThreadPostTaskTest, InvokesWithMovedFunctor) {
955 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
956 background_thread->Start();
957
958 LifeCycleFunctor::Stats stats;
959 Event event;
960 LifeCycleFunctor functor(&stats, &event);
Henrik Boström595f6882022-01-24 09:57:03 +0100961 background_thread->PostTask(std::move(functor));
Henrik Boströmba4dcc32019-02-28 09:34:06 +0100962 event.Wait(Event::kForever);
963
964 EXPECT_EQ(0u, stats.copy_count);
965 EXPECT_EQ(1u, stats.move_count);
966}
967
968TEST(ThreadPostTaskTest, InvokesWithReferencedFunctorShouldCopy) {
969 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
970 background_thread->Start();
971
972 LifeCycleFunctor::Stats stats;
973 Event event;
974 LifeCycleFunctor functor(&stats, &event);
975 LifeCycleFunctor& functor_ref = functor;
Henrik Boström595f6882022-01-24 09:57:03 +0100976 background_thread->PostTask(functor_ref);
Henrik Boströmba4dcc32019-02-28 09:34:06 +0100977 event.Wait(Event::kForever);
978
979 EXPECT_EQ(1u, stats.copy_count);
980 EXPECT_EQ(0u, stats.move_count);
981}
982
983TEST(ThreadPostTaskTest, InvokesWithCopiedFunctorDestroyedOnTargetThread) {
984 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
985 background_thread->Start();
986
987 Event event;
988 bool was_invoked_on_background_thread = false;
989 DestructionFunctor functor(background_thread.get(),
990 &was_invoked_on_background_thread, &event);
Henrik Boström595f6882022-01-24 09:57:03 +0100991 background_thread->PostTask(functor);
Henrik Boströmba4dcc32019-02-28 09:34:06 +0100992 event.Wait(Event::kForever);
993
994 EXPECT_TRUE(was_invoked_on_background_thread);
995}
996
997TEST(ThreadPostTaskTest, InvokesWithMovedFunctorDestroyedOnTargetThread) {
998 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
999 background_thread->Start();
1000
1001 Event event;
1002 bool was_invoked_on_background_thread = false;
1003 DestructionFunctor functor(background_thread.get(),
1004 &was_invoked_on_background_thread, &event);
Henrik Boström595f6882022-01-24 09:57:03 +01001005 background_thread->PostTask(std::move(functor));
Henrik Boströmba4dcc32019-02-28 09:34:06 +01001006 event.Wait(Event::kForever);
1007
1008 EXPECT_TRUE(was_invoked_on_background_thread);
1009}
1010
1011TEST(ThreadPostTaskTest,
1012 InvokesWithReferencedFunctorShouldCopyAndDestroyedOnTargetThread) {
1013 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
1014 background_thread->Start();
1015
1016 Event event;
1017 bool was_invoked_on_background_thread = false;
1018 DestructionFunctor functor(background_thread.get(),
1019 &was_invoked_on_background_thread, &event);
1020 DestructionFunctor& functor_ref = functor;
Henrik Boström595f6882022-01-24 09:57:03 +01001021 background_thread->PostTask(functor_ref);
Henrik Boströmba4dcc32019-02-28 09:34:06 +01001022 event.Wait(Event::kForever);
1023
1024 EXPECT_TRUE(was_invoked_on_background_thread);
1025}
1026
1027TEST(ThreadPostTaskTest, InvokesOnBackgroundThread) {
1028 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
1029 background_thread->Start();
1030
1031 Event event;
1032 bool was_invoked_on_background_thread = false;
Niels Möller1a29a5d2021-01-18 11:35:23 +01001033 Thread* background_thread_ptr = background_thread.get();
Henrik Boström595f6882022-01-24 09:57:03 +01001034 background_thread->PostTask(
Niels Möller1a29a5d2021-01-18 11:35:23 +01001035 [background_thread_ptr, &was_invoked_on_background_thread, &event] {
1036 was_invoked_on_background_thread = background_thread_ptr->IsCurrent();
1037 event.Set();
1038 });
Henrik Boströmba4dcc32019-02-28 09:34:06 +01001039 event.Wait(Event::kForever);
1040
1041 EXPECT_TRUE(was_invoked_on_background_thread);
1042}
1043
1044TEST(ThreadPostTaskTest, InvokesAsynchronously) {
1045 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
1046 background_thread->Start();
1047
1048 // The first event ensures that SendSingleMessage() is not blocking this
1049 // thread. The second event ensures that the message is processed.
1050 Event event_set_by_test_thread;
1051 Event event_set_by_background_thread;
Henrik Boström595f6882022-01-24 09:57:03 +01001052 background_thread->PostTask(
Henrik Boström2deee4b2022-01-20 11:58:05 +01001053 [&event_set_by_test_thread, &event_set_by_background_thread] {
1054 WaitAndSetEvent(&event_set_by_test_thread,
1055 &event_set_by_background_thread);
1056 });
Henrik Boströmba4dcc32019-02-28 09:34:06 +01001057 event_set_by_test_thread.Set();
1058 event_set_by_background_thread.Wait(Event::kForever);
1059}
1060
1061TEST(ThreadPostTaskTest, InvokesInPostedOrder) {
1062 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
1063 background_thread->Start();
1064
1065 Event first;
1066 Event second;
1067 Event third;
1068 Event fourth;
1069
Henrik Boström595f6882022-01-24 09:57:03 +01001070 background_thread->PostTask(
1071 [&first, &second] { WaitAndSetEvent(&first, &second); });
1072 background_thread->PostTask(
1073 [&second, &third] { WaitAndSetEvent(&second, &third); });
1074 background_thread->PostTask(
1075 [&third, &fourth] { WaitAndSetEvent(&third, &fourth); });
Henrik Boströmba4dcc32019-02-28 09:34:06 +01001076
1077 // All tasks have been posted before the first one is unblocked.
1078 first.Set();
1079 // Only if the chain is invoked in posted order will the last event be set.
1080 fourth.Wait(Event::kForever);
1081}
1082
Steve Antonbcc1a762019-12-11 11:21:53 -08001083TEST(ThreadPostDelayedTaskTest, InvokesAsynchronously) {
1084 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
1085 background_thread->Start();
1086
1087 // The first event ensures that SendSingleMessage() is not blocking this
1088 // thread. The second event ensures that the message is processed.
1089 Event event_set_by_test_thread;
1090 Event event_set_by_background_thread;
Henrik Boström595f6882022-01-24 09:57:03 +01001091 background_thread->PostDelayedTask(
Niels Möller1a29a5d2021-01-18 11:35:23 +01001092 [&event_set_by_test_thread, &event_set_by_background_thread] {
1093 WaitAndSetEvent(&event_set_by_test_thread,
1094 &event_set_by_background_thread);
1095 },
Danil Chapovalov4bcf8092022-07-06 19:42:34 +02001096 TimeDelta::Millis(10));
Steve Antonbcc1a762019-12-11 11:21:53 -08001097 event_set_by_test_thread.Set();
1098 event_set_by_background_thread.Wait(Event::kForever);
1099}
1100
1101TEST(ThreadPostDelayedTaskTest, InvokesInDelayOrder) {
Steve Anton094396f2019-12-16 00:56:02 -08001102 ScopedFakeClock clock;
Steve Antonbcc1a762019-12-11 11:21:53 -08001103 std::unique_ptr<rtc::Thread> background_thread(rtc::Thread::Create());
1104 background_thread->Start();
1105
1106 Event first;
1107 Event second;
1108 Event third;
1109 Event fourth;
1110
Henrik Boström595f6882022-01-24 09:57:03 +01001111 background_thread->PostDelayedTask(
1112 [&third, &fourth] { WaitAndSetEvent(&third, &fourth); },
Danil Chapovalov4bcf8092022-07-06 19:42:34 +02001113 TimeDelta::Millis(11));
Henrik Boström595f6882022-01-24 09:57:03 +01001114 background_thread->PostDelayedTask(
1115 [&first, &second] { WaitAndSetEvent(&first, &second); },
Danil Chapovalov4bcf8092022-07-06 19:42:34 +02001116 TimeDelta::Millis(9));
Henrik Boström595f6882022-01-24 09:57:03 +01001117 background_thread->PostDelayedTask(
1118 [&second, &third] { WaitAndSetEvent(&second, &third); },
Danil Chapovalov4bcf8092022-07-06 19:42:34 +02001119 TimeDelta::Millis(10));
Steve Antonbcc1a762019-12-11 11:21:53 -08001120
1121 // All tasks have been posted before the first one is unblocked.
1122 first.Set();
Steve Anton094396f2019-12-16 00:56:02 -08001123 // Only if the chain is invoked in delay order will the last event be set.
Danil Chapovalov4bcf8092022-07-06 19:42:34 +02001124 clock.AdvanceTime(TimeDelta::Millis(11));
Markus Handell2cfc1af2022-08-19 08:16:48 +00001125 EXPECT_TRUE(fourth.Wait(TimeDelta::Zero()));
Steve Antonbcc1a762019-12-11 11:21:53 -08001126}
1127
Tommi6866dc72020-05-15 10:11:56 +02001128TEST(ThreadPostDelayedTaskTest, IsCurrentTaskQueue) {
1129 auto current_tq = webrtc::TaskQueueBase::Current();
1130 {
1131 std::unique_ptr<rtc::Thread> thread(rtc::Thread::Create());
1132 thread->WrapCurrent();
1133 EXPECT_EQ(webrtc::TaskQueueBase::Current(),
1134 static_cast<webrtc::TaskQueueBase*>(thread.get()));
1135 thread->UnwrapCurrent();
1136 }
1137 EXPECT_EQ(webrtc::TaskQueueBase::Current(), current_tq);
1138}
1139
Danil Chapovalov912b3b82019-11-22 15:52:40 +01001140class ThreadFactory : public webrtc::TaskQueueFactory {
1141 public:
1142 std::unique_ptr<webrtc::TaskQueueBase, webrtc::TaskQueueDeleter>
1143 CreateTaskQueue(absl::string_view /* name */,
1144 Priority /*priority*/) const override {
1145 std::unique_ptr<Thread> thread = Thread::Create();
1146 thread->Start();
1147 return std::unique_ptr<webrtc::TaskQueueBase, webrtc::TaskQueueDeleter>(
1148 thread.release());
1149 }
1150};
1151
Ali Tofigh83db78e2022-08-23 12:57:16 +02001152std::unique_ptr<webrtc::TaskQueueFactory> CreateDefaultThreadFactory(
1153 const webrtc::FieldTrialsView*) {
1154 return std::make_unique<ThreadFactory>();
1155}
1156
Danil Chapovalov912b3b82019-11-22 15:52:40 +01001157using ::webrtc::TaskQueueTest;
1158
1159INSTANTIATE_TEST_SUITE_P(RtcThread,
1160 TaskQueueTest,
Ali Tofigh83db78e2022-08-23 12:57:16 +02001161 ::testing::Values(CreateDefaultThreadFactory));
Danil Chapovalov912b3b82019-11-22 15:52:40 +01001162
Mirko Bonadeie10b1632018-12-11 18:43:40 +01001163} // namespace
1164} // namespace rtc