Coverage Report

Created: 2026-06-16 16:41

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/tmp/bitcoin/src/scheduler.cpp
Line
Count
Source
1
// Copyright (c) 2015-present The Bitcoin Core developers
2
// Distributed under the MIT software license, see the accompanying
3
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
4
5
#include <scheduler.h>
6
7
#include <sync.h>
8
#include <util/time.h>
9
10
#include <cassert>
11
#include <functional>
12
#include <utility>
13
14
1.29k
CScheduler::CScheduler() = default;
15
16
CScheduler::~CScheduler()
17
1.29k
{
18
1.29k
    assert(nThreadsServicingQueue == 0);
19
1.29k
    if (stopWhenEmpty) assert(taskQueue.empty());
20
1.29k
}
21
22
23
void CScheduler::serviceQueue()
24
1.31k
{
25
1.31k
    WAIT_LOCK(newTaskMutex, lock);
26
1.31k
    ++nThreadsServicingQueue;
27
28
    // newTaskMutex is locked throughout this loop EXCEPT
29
    // when the thread is waiting or when the user's function
30
    // is called.
31
445k
    while (!shouldStop()) {
32
443k
        try {
33
491k
            while (!shouldStop() && taskQueue.empty()) {
34
                // Wait until there is something to do.
35
47.6k
                newTaskScheduled.wait(lock);
36
47.6k
            }
37
38
            // Wait until either there is a new task, or until
39
            // the time of the first item on the queue:
40
41
674k
            while (!shouldStop() && !taskQueue.empty()) {
42
673k
                std::chrono::steady_clock::time_point timeToWaitFor = taskQueue.begin()->first;
43
673k
                if (newTaskScheduled.wait_until(lock, timeToWaitFor) == std::cv_status::timeout) {
44
442k
                    break; // Exit loop after timeout, it means we reached the time of the event
45
442k
                }
46
673k
            }
47
48
            // If there are multiple threads, the queue can empty while we're waiting (another
49
            // thread may service the task we were waiting on).
50
443k
            if (shouldStop() || taskQueue.empty())
51
1.29k
                continue;
52
53
442k
            Function f = taskQueue.begin()->second;
54
442k
            taskQueue.erase(taskQueue.begin());
55
56
442k
            {
57
                // Unlock before calling f, so it can reschedule itself or another task
58
                // without deadlocking:
59
442k
                REVERSE_LOCK(lock, newTaskMutex);
60
442k
                f();
61
442k
            }
62
442k
        } catch (...) {
63
0
            --nThreadsServicingQueue;
64
0
            throw;
65
0
        }
66
443k
    }
67
1.31k
    --nThreadsServicingQueue;
68
1.31k
    newTaskScheduled.notify_one();
69
1.31k
}
70
71
void CScheduler::schedule(CScheduler::Function f, std::chrono::steady_clock::time_point t)
72
452k
{
73
452k
    {
74
452k
        LOCK(newTaskMutex);
75
452k
        taskQueue.insert(std::make_pair(t, f));
76
452k
    }
77
452k
    newTaskScheduled.notify_one();
78
452k
}
79
80
void CScheduler::MockForward(std::chrono::seconds delta_seconds)
81
22
{
82
22
    assert(delta_seconds > 0s && delta_seconds <= 1h);
83
84
22
    {
85
22
        LOCK(newTaskMutex);
86
87
        // use temp_queue to maintain updated schedule
88
22
        std::multimap<std::chrono::steady_clock::time_point, Function> temp_queue;
89
90
163
        for (const auto& element : taskQueue) {
91
163
            temp_queue.emplace_hint(temp_queue.cend(), element.first - delta_seconds, element.second);
92
163
        }
93
94
        // point taskQueue to temp_queue
95
22
        taskQueue = std::move(temp_queue);
96
22
    }
97
98
    // notify that the taskQueue needs to be processed
99
22
    newTaskScheduled.notify_one();
100
22
}
101
102
static void Repeat(CScheduler& s, CScheduler::Function f, std::chrono::milliseconds delta)
103
281
{
104
281
    f();
105
281
    s.scheduleFromNow([=, &s] { Repeat(s, f, delta); }, delta);
106
281
}
107
108
void CScheduler::scheduleEvery(CScheduler::Function f, std::chrono::milliseconds delta)
109
6.66k
{
110
6.66k
    scheduleFromNow([this, f, delta] { Repeat(*this, f, delta); }, delta);
111
6.66k
}
112
113
size_t CScheduler::getQueueInfo(std::chrono::steady_clock::time_point& first,
114
                                std::chrono::steady_clock::time_point& last) const
115
4
{
116
4
    LOCK(newTaskMutex);
117
4
    size_t result = taskQueue.size();
118
4
    if (!taskQueue.empty()) {
119
3
        first = taskQueue.begin()->first;
120
3
        last = taskQueue.rbegin()->first;
121
3
    }
122
4
    return result;
123
4
}
124
125
bool CScheduler::AreThreadsServicingQueue() const
126
1.29k
{
127
1.29k
    LOCK(newTaskMutex);
128
1.29k
    return nThreadsServicingQueue;
129
1.29k
}
130
131
132
void SerialTaskRunner::MaybeScheduleProcessQueue()
133
788k
{
134
788k
    {
135
788k
        LOCK(m_callbacks_mutex);
136
        // Try to avoid scheduling too many copies here, but if we
137
        // accidentally have two ProcessQueue's scheduled at once its
138
        // not a big deal.
139
788k
        if (m_are_callbacks_running) return;
140
719k
        if (m_callbacks_pending.empty()) return;
141
719k
    }
142
443k
    m_scheduler.schedule([this] { this->ProcessQueue(); }, std::chrono::steady_clock::now());
143
443k
}
144
145
void SerialTaskRunner::ProcessQueue()
146
443k
{
147
443k
    std::function<void()> callback;
148
443k
    {
149
443k
        LOCK(m_callbacks_mutex);
150
443k
        if (m_are_callbacks_running) return;
151
443k
        if (m_callbacks_pending.empty()) return;
152
393k
        m_are_callbacks_running = true;
153
154
393k
        callback = std::move(m_callbacks_pending.front());
155
393k
        m_callbacks_pending.pop_front();
156
393k
    }
157
158
    // RAII the setting of fCallbacksRunning and calling MaybeScheduleProcessQueue
159
    // to ensure both happen safely even if callback() throws.
160
0
    struct RAIICallbacksRunning {
161
393k
        SerialTaskRunner* instance;
162
393k
        explicit RAIICallbacksRunning(SerialTaskRunner* _instance) : instance(_instance) {}
163
393k
        ~RAIICallbacksRunning()
164
393k
        {
165
393k
            {
166
393k
                LOCK(instance->m_callbacks_mutex);
167
393k
                instance->m_are_callbacks_running = false;
168
393k
            }
169
393k
            instance->MaybeScheduleProcessQueue();
170
393k
        }
171
393k
    } raiicallbacksrunning(this);
172
173
393k
    callback();
174
393k
}
175
176
void SerialTaskRunner::insert(std::function<void()> func)
177
394k
{
178
394k
    {
179
394k
        LOCK(m_callbacks_mutex);
180
394k
        m_callbacks_pending.emplace_back(std::move(func));
181
394k
    }
182
394k
    MaybeScheduleProcessQueue();
183
394k
}
184
185
void SerialTaskRunner::flush()
186
1.29k
{
187
1.29k
    assert(!m_scheduler.AreThreadsServicingQueue());
188
1.29k
    bool should_continue = true;
189
2.61k
    while (should_continue) {
190
1.32k
        ProcessQueue();
191
1.32k
        LOCK(m_callbacks_mutex);
192
1.32k
        should_continue = !m_callbacks_pending.empty();
193
1.32k
    }
194
1.29k
}
195
196
size_t SerialTaskRunner::size()
197
129k
{
198
129k
    LOCK(m_callbacks_mutex);
199
129k
    return m_callbacks_pending.size();
200
129k
}