Coverage Report

Created: 2026-09-02 14:16

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.35k
CScheduler::CScheduler() = default;
15
16
CScheduler::~CScheduler()
17
1.35k
{
18
1.35k
    assert(nThreadsServicingQueue == 0);
19
1.35k
    if (stopWhenEmpty) assert(taskQueue.empty());
20
1.35k
}
21
22
23
void CScheduler::serviceQueue()
24
1.36k
{
25
1.36k
    WAIT_LOCK(newTaskMutex, lock);
26
1.36k
    ++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
389k
    while (!shouldStop()) {
32
388k
        try {
33
413k
            while (!shouldStop() && taskQueue.empty()) {
34
                // Wait until there is something to do.
35
24.8k
                newTaskScheduled.wait(lock);
36
24.8k
            }
37
38
            // Wait until either there is a new task, or until
39
            // the time of the first item on the queue:
40
41
604k
            while (!shouldStop() && !taskQueue.empty()) {
42
602k
                std::chrono::steady_clock::time_point timeToWaitFor = taskQueue.begin()->first;
43
602k
                if (newTaskScheduled.wait_until(lock, timeToWaitFor) == std::cv_status::timeout) {
44
387k
                    break; // Exit loop after timeout, it means we reached the time of the event
45
387k
                }
46
602k
            }
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
388k
            if (shouldStop() || taskQueue.empty())
51
1.35k
                continue;
52
53
387k
            Function f = taskQueue.begin()->second;
54
387k
            taskQueue.erase(taskQueue.begin());
55
56
387k
            {
57
                // Unlock before calling f, so it can reschedule itself or another task
58
                // without deadlocking:
59
387k
                REVERSE_LOCK(lock, newTaskMutex);
60
387k
                f();
61
387k
            }
62
387k
        } catch (...) {
63
0
            --nThreadsServicingQueue;
64
0
            throw;
65
0
        }
66
388k
    }
67
1.36k
    --nThreadsServicingQueue;
68
1.36k
    newTaskScheduled.notify_one();
69
1.36k
}
70
71
void CScheduler::schedule(CScheduler::Function f, std::chrono::steady_clock::time_point t)
72
397k
{
73
397k
    {
74
397k
        LOCK(newTaskMutex);
75
397k
        taskQueue.insert(std::make_pair(t, f));
76
397k
    }
77
397k
    newTaskScheduled.notify_one();
78
397k
}
79
80
void CScheduler::MockForward(std::chrono::seconds delta_seconds)
81
58
{
82
58
    assert(delta_seconds > 0s && delta_seconds <= 1h);
83
84
58
    {
85
58
        LOCK(newTaskMutex);
86
87
        // use temp_queue to maintain updated schedule
88
58
        std::multimap<std::chrono::steady_clock::time_point, Function> temp_queue;
89
90
496
        for (const auto& element : taskQueue) {
91
496
            temp_queue.emplace_hint(temp_queue.cend(), element.first - delta_seconds, element.second);
92
496
        }
93
94
        // point taskQueue to temp_queue
95
58
        taskQueue = std::move(temp_queue);
96
58
    }
97
98
    // notify that the taskQueue needs to be processed
99
58
    newTaskScheduled.notify_one();
100
58
}
101
102
static void Repeat(CScheduler& s, CScheduler::Function f, std::chrono::milliseconds delta)
103
423
{
104
423
    f();
105
423
    s.scheduleFromNow([=, &s] { Repeat(s, f, delta); }, delta);
106
423
}
107
108
void CScheduler::scheduleEvery(CScheduler::Function f, std::chrono::milliseconds delta)
109
6.89k
{
110
6.89k
    scheduleFromNow([this, f, delta] { Repeat(*this, f, delta); }, delta);
111
6.89k
}
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.35k
{
127
1.35k
    LOCK(newTaskMutex);
128
1.35k
    return nThreadsServicingQueue;
129
1.35k
}
130
131
132
void SerialTaskRunner::MaybeScheduleProcessQueue()
133
707k
{
134
707k
    {
135
707k
        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
707k
        if (m_are_callbacks_running) return;
140
624k
        if (m_callbacks_pending.empty()) return;
141
624k
    }
142
388k
    m_scheduler.schedule([this] { this->ProcessQueue(); }, std::chrono::steady_clock::now());
143
388k
}
144
145
void SerialTaskRunner::ProcessQueue()
146
387k
{
147
387k
    std::function<void()> callback;
148
387k
    {
149
387k
        LOCK(m_callbacks_mutex);
150
387k
        if (m_are_callbacks_running) return;
151
387k
        if (m_callbacks_pending.empty()) return;
152
353k
        m_are_callbacks_running = true;
153
154
353k
        callback = std::move(m_callbacks_pending.front());
155
353k
        m_callbacks_pending.pop_front();
156
353k
    }
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
353k
        SerialTaskRunner* instance;
162
353k
        explicit RAIICallbacksRunning(SerialTaskRunner* _instance) : instance(_instance) {}
163
353k
        ~RAIICallbacksRunning()
164
353k
        {
165
353k
            {
166
353k
                LOCK(instance->m_callbacks_mutex);
167
353k
                instance->m_are_callbacks_running = false;
168
353k
            }
169
353k
            instance->MaybeScheduleProcessQueue();
170
353k
        }
171
353k
    } raiicallbacksrunning(this);
172
173
353k
    callback();
174
353k
}
175
176
void SerialTaskRunner::insert(std::function<void()> func)
177
354k
{
178
354k
    {
179
354k
        LOCK(m_callbacks_mutex);
180
354k
        m_callbacks_pending.emplace_back(std::move(func));
181
354k
    }
182
354k
    MaybeScheduleProcessQueue();
183
354k
}
184
185
void SerialTaskRunner::flush()
186
1.35k
{
187
1.35k
    assert(!m_scheduler.AreThreadsServicingQueue());
188
1.35k
    bool should_continue = true;
189
2.81k
    while (should_continue) {
190
1.46k
        ProcessQueue();
191
1.46k
        LOCK(m_callbacks_mutex);
192
1.46k
        should_continue = !m_callbacks_pending.empty();
193
1.46k
    }
194
1.35k
}
195
196
size_t SerialTaskRunner::size()
197
125k
{
198
125k
    LOCK(m_callbacks_mutex);
199
125k
    return m_callbacks_pending.size();
200
125k
}