Coverage Report

Created: 2026-07-20 20:52

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.30k
CScheduler::CScheduler() = default;
15
16
CScheduler::~CScheduler()
17
1.30k
{
18
1.30k
    assert(nThreadsServicingQueue == 0);
19
1.30k
    if (stopWhenEmpty) assert(taskQueue.empty());
20
1.30k
}
21
22
23
void CScheduler::serviceQueue()
24
1.32k
{
25
1.32k
    WAIT_LOCK(newTaskMutex, lock);
26
1.32k
    ++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
464k
    while (!shouldStop()) {
32
462k
        try {
33
511k
            while (!shouldStop() && taskQueue.empty()) {
34
                // Wait until there is something to do.
35
48.2k
                newTaskScheduled.wait(lock);
36
48.2k
            }
37
38
            // Wait until either there is a new task, or until
39
            // the time of the first item on the queue:
40
41
676k
            while (!shouldStop() && !taskQueue.empty()) {
42
674k
                std::chrono::steady_clock::time_point timeToWaitFor = taskQueue.begin()->first;
43
674k
                if (newTaskScheduled.wait_until(lock, timeToWaitFor) == std::cv_status::timeout) {
44
461k
                    break; // Exit loop after timeout, it means we reached the time of the event
45
461k
                }
46
674k
            }
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
462k
            if (shouldStop() || taskQueue.empty())
51
1.30k
                continue;
52
53
461k
            Function f = taskQueue.begin()->second;
54
461k
            taskQueue.erase(taskQueue.begin());
55
56
461k
            {
57
                // Unlock before calling f, so it can reschedule itself or another task
58
                // without deadlocking:
59
461k
                REVERSE_LOCK(lock, newTaskMutex);
60
461k
                f();
61
461k
            }
62
461k
        } catch (...) {
63
0
            --nThreadsServicingQueue;
64
0
            throw;
65
0
        }
66
462k
    }
67
1.32k
    --nThreadsServicingQueue;
68
1.32k
    newTaskScheduled.notify_one();
69
1.32k
}
70
71
void CScheduler::schedule(CScheduler::Function f, std::chrono::steady_clock::time_point t)
72
471k
{
73
471k
    {
74
471k
        LOCK(newTaskMutex);
75
471k
        taskQueue.insert(std::make_pair(t, f));
76
471k
    }
77
471k
    newTaskScheduled.notify_one();
78
471k
}
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
155
        for (const auto& element : taskQueue) {
91
155
            temp_queue.emplace_hint(temp_queue.cend(), element.first - delta_seconds, element.second);
92
155
        }
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
290
{
104
290
    f();
105
290
    s.scheduleFromNow([=, &s] { Repeat(s, f, delta); }, delta);
106
290
}
107
108
void CScheduler::scheduleEvery(CScheduler::Function f, std::chrono::milliseconds delta)
109
6.70k
{
110
6.70k
    scheduleFromNow([this, f, delta] { Repeat(*this, f, delta); }, delta);
111
6.70k
}
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.30k
{
127
1.30k
    LOCK(newTaskMutex);
128
1.30k
    return nThreadsServicingQueue;
129
1.30k
}
130
131
132
void SerialTaskRunner::MaybeScheduleProcessQueue()
133
842k
{
134
842k
    {
135
842k
        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
842k
        if (m_are_callbacks_running) return;
140
720k
        if (m_callbacks_pending.empty()) return;
141
720k
    }
142
462k
    m_scheduler.schedule([this] { this->ProcessQueue(); }, std::chrono::steady_clock::now());
143
462k
}
144
145
void SerialTaskRunner::ProcessQueue()
146
461k
{
147
461k
    std::function<void()> callback;
148
461k
    {
149
461k
        LOCK(m_callbacks_mutex);
150
461k
        if (m_are_callbacks_running) return;
151
461k
        if (m_callbacks_pending.empty()) return;
152
420k
        m_are_callbacks_running = true;
153
154
420k
        callback = std::move(m_callbacks_pending.front());
155
420k
        m_callbacks_pending.pop_front();
156
420k
    }
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
420k
        SerialTaskRunner* instance;
162
420k
        explicit RAIICallbacksRunning(SerialTaskRunner* _instance) : instance(_instance) {}
163
420k
        ~RAIICallbacksRunning()
164
420k
        {
165
420k
            {
166
420k
                LOCK(instance->m_callbacks_mutex);
167
420k
                instance->m_are_callbacks_running = false;
168
420k
            }
169
420k
            instance->MaybeScheduleProcessQueue();
170
420k
        }
171
420k
    } raiicallbacksrunning(this);
172
173
420k
    callback();
174
420k
}
175
176
void SerialTaskRunner::insert(std::function<void()> func)
177
421k
{
178
421k
    {
179
421k
        LOCK(m_callbacks_mutex);
180
421k
        m_callbacks_pending.emplace_back(std::move(func));
181
421k
    }
182
421k
    MaybeScheduleProcessQueue();
183
421k
}
184
185
void SerialTaskRunner::flush()
186
1.30k
{
187
1.30k
    assert(!m_scheduler.AreThreadsServicingQueue());
188
1.30k
    bool should_continue = true;
189
2.64k
    while (should_continue) {
190
1.33k
        ProcessQueue();
191
1.33k
        LOCK(m_callbacks_mutex);
192
1.33k
        should_continue = !m_callbacks_pending.empty();
193
1.33k
    }
194
1.30k
}
195
196
size_t SerialTaskRunner::size()
197
134k
{
198
134k
    LOCK(m_callbacks_mutex);
199
134k
    return m_callbacks_pending.size();
200
134k
}