Coverage Report

Created: 2026-01-25 07:18

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/ffmpeg/libavutil/thread.h
Line
Count
Source
1
/*
2
 * This file is part of FFmpeg.
3
 *
4
 * FFmpeg is free software; you can redistribute it and/or
5
 * modify it under the terms of the GNU Lesser General Public
6
 * License as published by the Free Software Foundation; either
7
 * version 2.1 of the License, or (at your option) any later version.
8
 *
9
 * FFmpeg is distributed in the hope that it will be useful,
10
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12
 * Lesser General Public License for more details.
13
 *
14
 * You should have received a copy of the GNU Lesser General Public
15
 * License along with FFmpeg; if not, write to the Free Software
16
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17
 */
18
19
// This header should only be used to simplify code where
20
// threading is optional, not as a generic threading abstraction.
21
22
#ifndef AVUTIL_THREAD_H
23
#define AVUTIL_THREAD_H
24
25
#include "config.h"
26
27
#if HAVE_PRCTL
28
#include <sys/prctl.h>
29
#elif (HAVE_PTHREAD_SETNAME_NP || HAVE_PTHREAD_SET_NAME_NP) && HAVE_PTHREAD_NP_H
30
#include <pthread_np.h>
31
#endif
32
33
#include "error.h"
34
35
#if HAVE_PTHREADS || HAVE_W32THREADS || HAVE_OS2THREADS
36
37
#if HAVE_PTHREADS
38
#include <pthread.h>
39
40
#if defined(ASSERT_LEVEL) && ASSERT_LEVEL > 1
41
42
#include <stdlib.h>
43
44
#include "log.h"
45
#include "macros.h"
46
47
#define ASSERT_PTHREAD_ABORT(func, ret) do {                            \
48
    char errbuf[AV_ERROR_MAX_STRING_SIZE] = "";                         \
49
    av_log(NULL, AV_LOG_FATAL, AV_STRINGIFY(func)                       \
50
           " failed with error: %s\n",                                  \
51
           av_make_error_string(errbuf, AV_ERROR_MAX_STRING_SIZE,       \
52
                                AVERROR(ret)));                         \
53
    abort();                                                            \
54
} while (0)
55
56
#define ASSERT_PTHREAD_NORET(func, ...) do {                            \
57
    int ret = func(__VA_ARGS__);                                        \
58
    if (ret)                                                            \
59
        ASSERT_PTHREAD_ABORT(func, ret);                                \
60
} while (0)
61
62
#define ASSERT_PTHREAD(func, ...) do {                                  \
63
    ASSERT_PTHREAD_NORET(func, __VA_ARGS__);                            \
64
    return 0;                                                           \
65
} while (0)
66
67
static inline int strict_pthread_join(pthread_t thread, void **value_ptr)
68
{
69
    ASSERT_PTHREAD(pthread_join, thread, value_ptr);
70
}
71
72
static inline int strict_pthread_mutex_init(pthread_mutex_t *mutex, const pthread_mutexattr_t *attr)
73
{
74
    if (attr) {
75
        ASSERT_PTHREAD_NORET(pthread_mutex_init, mutex, attr);
76
    } else {
77
        pthread_mutexattr_t local_attr;
78
        ASSERT_PTHREAD_NORET(pthread_mutexattr_init, &local_attr);
79
        ASSERT_PTHREAD_NORET(pthread_mutexattr_settype, &local_attr, PTHREAD_MUTEX_ERRORCHECK);
80
        ASSERT_PTHREAD_NORET(pthread_mutex_init, mutex, &local_attr);
81
        ASSERT_PTHREAD_NORET(pthread_mutexattr_destroy, &local_attr);
82
    }
83
    return 0;
84
}
85
86
static inline int strict_pthread_mutex_destroy(pthread_mutex_t *mutex)
87
{
88
    ASSERT_PTHREAD(pthread_mutex_destroy, mutex);
89
}
90
91
static inline int strict_pthread_mutex_lock(pthread_mutex_t *mutex)
92
{
93
    ASSERT_PTHREAD(pthread_mutex_lock, mutex);
94
}
95
96
static inline int strict_pthread_mutex_unlock(pthread_mutex_t *mutex)
97
{
98
    ASSERT_PTHREAD(pthread_mutex_unlock, mutex);
99
}
100
101
static inline int strict_pthread_cond_init(pthread_cond_t *cond, const pthread_condattr_t *attr)
102
{
103
    ASSERT_PTHREAD(pthread_cond_init, cond, attr);
104
}
105
106
static inline int strict_pthread_cond_destroy(pthread_cond_t *cond)
107
{
108
    ASSERT_PTHREAD(pthread_cond_destroy, cond);
109
}
110
111
static inline int strict_pthread_cond_signal(pthread_cond_t *cond)
112
{
113
    ASSERT_PTHREAD(pthread_cond_signal, cond);
114
}
115
116
static inline int strict_pthread_cond_broadcast(pthread_cond_t *cond)
117
{
118
    ASSERT_PTHREAD(pthread_cond_broadcast, cond);
119
}
120
121
static inline int strict_pthread_cond_wait(pthread_cond_t *cond, pthread_mutex_t *mutex)
122
{
123
    ASSERT_PTHREAD(pthread_cond_wait, cond, mutex);
124
}
125
126
static inline int strict_pthread_cond_timedwait(pthread_cond_t *cond, pthread_mutex_t *mutex,
127
                                                const struct timespec *abstime)
128
{
129
    int ret = pthread_cond_timedwait(cond, mutex, abstime);
130
    if (ret && ret != ETIMEDOUT)
131
        ASSERT_PTHREAD_ABORT(pthread_cond_timedwait, ret);
132
    return ret;
133
}
134
135
static inline int strict_pthread_once(pthread_once_t *once_control, void (*init_routine)(void))
136
{
137
    ASSERT_PTHREAD(pthread_once, once_control, init_routine);
138
}
139
140
#define pthread_join           strict_pthread_join
141
#define pthread_mutex_init     strict_pthread_mutex_init
142
#define pthread_mutex_destroy  strict_pthread_mutex_destroy
143
#define pthread_mutex_lock     strict_pthread_mutex_lock
144
#define pthread_mutex_unlock   strict_pthread_mutex_unlock
145
#define pthread_cond_init      strict_pthread_cond_init
146
#define pthread_cond_destroy   strict_pthread_cond_destroy
147
#define pthread_cond_signal    strict_pthread_cond_signal
148
#define pthread_cond_broadcast strict_pthread_cond_broadcast
149
#define pthread_cond_wait      strict_pthread_cond_wait
150
#define pthread_cond_timedwait strict_pthread_cond_timedwait
151
#define pthread_once           strict_pthread_once
152
#endif
153
154
#elif HAVE_OS2THREADS
155
#include "compat/os2threads.h"
156
#else
157
#include "compat/w32pthreads.h"
158
#endif
159
160
#define AVMutex pthread_mutex_t
161
#define AV_MUTEX_INITIALIZER PTHREAD_MUTEX_INITIALIZER
162
163
0
#define ff_mutex_init    pthread_mutex_init
164
0
#define ff_mutex_lock    pthread_mutex_lock
165
0
#define ff_mutex_unlock  pthread_mutex_unlock
166
0
#define ff_mutex_destroy pthread_mutex_destroy
167
168
#define AVCond pthread_cond_t
169
170
#define ff_cond_init      pthread_cond_init
171
#define ff_cond_destroy   pthread_cond_destroy
172
#define ff_cond_signal    pthread_cond_signal
173
0
#define ff_cond_broadcast pthread_cond_broadcast
174
0
#define ff_cond_wait      pthread_cond_wait
175
#define ff_cond_timedwait pthread_cond_timedwait
176
177
#define AVOnce pthread_once_t
178
0
#define AV_ONCE_INIT PTHREAD_ONCE_INIT
179
180
0
#define ff_thread_once(control, routine) pthread_once(control, routine)
181
182
#else
183
184
#define AVMutex char
185
#define AV_MUTEX_INITIALIZER 0
186
187
static inline int ff_mutex_init(AVMutex *mutex, const void *attr){ return 0; }
188
static inline int ff_mutex_lock(AVMutex *mutex){ return 0; }
189
static inline int ff_mutex_unlock(AVMutex *mutex){ return 0; }
190
static inline int ff_mutex_destroy(AVMutex *mutex){ return 0; }
191
192
#define AVCond char
193
194
static inline int ff_cond_init(AVCond *cond, const void *attr){ return 0; }
195
static inline int ff_cond_destroy(AVCond *cond){ return 0; }
196
static inline int ff_cond_signal(AVCond *cond){ return 0; }
197
static inline int ff_cond_broadcast(AVCond *cond){ return 0; }
198
static inline int ff_cond_wait(AVCond *cond, AVMutex *mutex){ return 0; }
199
static inline int ff_cond_timedwait(AVCond *cond, AVMutex *mutex,
200
                                    const void *abstime){ return 0; }
201
202
#define AVOnce char
203
#define AV_ONCE_INIT 0
204
205
static inline int ff_thread_once(char *control, void (*routine)(void))
206
{
207
    if (!*control) {
208
        routine();
209
        *control = 1;
210
    }
211
    return 0;
212
}
213
214
#endif
215
216
static inline int ff_thread_setname(const char *name)
217
0
{
218
0
    int ret = 0;
219
220
0
#if HAVE_PRCTL
221
0
    ret = AVERROR(prctl(PR_SET_NAME, name));
222
#elif HAVE_PTHREAD_SETNAME_NP
223
#if defined(__APPLE__)
224
    ret = AVERROR(pthread_setname_np(name));
225
#elif defined(__NetBSD__)
226
    ret = AVERROR(pthread_setname_np(pthread_self(), "%s", name));
227
#else
228
    ret = AVERROR(pthread_setname_np(pthread_self(), name));
229
#endif
230
#elif HAVE_PTHREAD_SET_NAME_NP
231
    pthread_set_name_np(pthread_self(), name);
232
#elif HAVE_W32THREADS
233
    ret = win32_thread_setname(name);
234
#else
235
    ret = AVERROR(ENOSYS);
236
#endif
237
238
0
    return ret;
239
0
}
Unexecuted instantiation: utils.c:ff_thread_setname
Unexecuted instantiation: allcodecs.c:ff_thread_setname
Unexecuted instantiation: avcodec.c:ff_thread_setname
Unexecuted instantiation: decode.c:ff_thread_setname
Unexecuted instantiation: pthread.c:ff_thread_setname
Unexecuted instantiation: pthread_frame.c:ff_thread_setname
Unexecuted instantiation: threadprogress.c:ff_thread_setname
Unexecuted instantiation: buffer.c:ff_thread_setname
Unexecuted instantiation: crc.c:ff_thread_setname
Unexecuted instantiation: log.c:ff_thread_setname
Unexecuted instantiation: refstruct.c:ff_thread_setname
Unexecuted instantiation: slicethread.c:ff_thread_setname
240
241
#endif /* AVUTIL_THREAD_H */