FFmpeg
thread.h
Go to the documentation of this file.
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_PTHREADS || HAVE_W32THREADS || HAVE_OS2THREADS
28 
29 #if HAVE_PTHREADS
30 #include <pthread.h>
31 
32 #if defined(ASSERT_LEVEL) && ASSERT_LEVEL > 1
33 
34 #include "log.h"
35 
36 #define ASSERT_PTHREAD_NORET(func, ...) do { \
37  int ret = func(__VA_ARGS__); \
38  if (ret) { \
39  char errbuf[AV_ERROR_MAX_STRING_SIZE] = ""; \
40  av_log(NULL, AV_LOG_FATAL, AV_STRINGIFY(func) \
41  " failed with error: %s\n", \
42  av_make_error_string(errbuf, AV_ERROR_MAX_STRING_SIZE, \
43  AVERROR(ret))); \
44  abort(); \
45  } \
46 } while (0)
47 
48 #define ASSERT_PTHREAD(func, ...) do { \
49  ASSERT_PTHREAD_NORET(func, __VA_ARGS__); \
50  return 0; \
51 } while (0)
52 
53 static inline int strict_pthread_join(pthread_t thread, void **value_ptr)
54 {
55  ASSERT_PTHREAD(pthread_join, thread, value_ptr);
56 }
57 
58 static inline int strict_pthread_mutex_init(pthread_mutex_t *mutex, const pthread_mutexattr_t *attr)
59 {
60  if (attr) {
61  ASSERT_PTHREAD_NORET(pthread_mutex_init, mutex, attr);
62  } else {
63  pthread_mutexattr_t local_attr;
64  ASSERT_PTHREAD_NORET(pthread_mutexattr_init, &local_attr);
65  ASSERT_PTHREAD_NORET(pthread_mutexattr_settype, &local_attr, PTHREAD_MUTEX_ERRORCHECK);
66  ASSERT_PTHREAD_NORET(pthread_mutex_init, mutex, &local_attr);
67  ASSERT_PTHREAD_NORET(pthread_mutexattr_destroy, &local_attr);
68  }
69  return 0;
70 }
71 
72 static inline int strict_pthread_mutex_destroy(pthread_mutex_t *mutex)
73 {
74  ASSERT_PTHREAD(pthread_mutex_destroy, mutex);
75 }
76 
77 static inline int strict_pthread_mutex_lock(pthread_mutex_t *mutex)
78 {
79  ASSERT_PTHREAD(pthread_mutex_lock, mutex);
80 }
81 
82 static inline int strict_pthread_mutex_unlock(pthread_mutex_t *mutex)
83 {
84  ASSERT_PTHREAD(pthread_mutex_unlock, mutex);
85 }
86 
87 static inline int strict_pthread_cond_init(pthread_cond_t *cond, const pthread_condattr_t *attr)
88 {
89  ASSERT_PTHREAD(pthread_cond_init, cond, attr);
90 }
91 
92 static inline int strict_pthread_cond_destroy(pthread_cond_t *cond)
93 {
94  ASSERT_PTHREAD(pthread_cond_destroy, cond);
95 }
96 
97 static inline int strict_pthread_cond_signal(pthread_cond_t *cond)
98 {
99  ASSERT_PTHREAD(pthread_cond_signal, cond);
100 }
101 
102 static inline int strict_pthread_cond_broadcast(pthread_cond_t *cond)
103 {
104  ASSERT_PTHREAD(pthread_cond_broadcast, cond);
105 }
106 
107 static inline int strict_pthread_cond_wait(pthread_cond_t *cond, pthread_mutex_t *mutex)
108 {
109  ASSERT_PTHREAD(pthread_cond_wait, cond, mutex);
110 }
111 
112 static inline int strict_pthread_once(pthread_once_t *once_control, void (*init_routine)(void))
113 {
114  ASSERT_PTHREAD(pthread_once, once_control, init_routine);
115 }
116 
117 #define pthread_join strict_pthread_join
118 #define pthread_mutex_init strict_pthread_mutex_init
119 #define pthread_mutex_destroy strict_pthread_mutex_destroy
120 #define pthread_mutex_lock strict_pthread_mutex_lock
121 #define pthread_mutex_unlock strict_pthread_mutex_unlock
122 #define pthread_cond_init strict_pthread_cond_init
123 #define pthread_cond_destroy strict_pthread_cond_destroy
124 #define pthread_cond_signal strict_pthread_cond_signal
125 #define pthread_cond_broadcast strict_pthread_cond_broadcast
126 #define pthread_cond_wait strict_pthread_cond_wait
127 #define pthread_once strict_pthread_once
128 #endif
129 
130 #elif HAVE_OS2THREADS
131 #include "compat/os2threads.h"
132 #else
133 #include "compat/w32pthreads.h"
134 #endif
135 
136 #define AVMutex pthread_mutex_t
137 #define AV_MUTEX_INITIALIZER PTHREAD_MUTEX_INITIALIZER
138 
139 #define ff_mutex_init pthread_mutex_init
140 #define ff_mutex_lock pthread_mutex_lock
141 #define ff_mutex_unlock pthread_mutex_unlock
142 #define ff_mutex_destroy pthread_mutex_destroy
143 
144 #define AVOnce pthread_once_t
145 #define AV_ONCE_INIT PTHREAD_ONCE_INIT
146 
147 #define ff_thread_once(control, routine) pthread_once(control, routine)
148 
149 #else
150 
151 #define AVMutex char
152 #define AV_MUTEX_INITIALIZER 0
153 
154 static inline int ff_mutex_init(AVMutex *mutex, const void *attr){ return 0; }
155 static inline int ff_mutex_lock(AVMutex *mutex){ return 0; }
156 static inline int ff_mutex_unlock(AVMutex *mutex){ return 0; }
157 static inline int ff_mutex_destroy(AVMutex *mutex){ return 0; }
158 
159 #define AVOnce char
160 #define AV_ONCE_INIT 0
161 
162 static inline int ff_thread_once(char *control, void (*routine)(void))
163 {
164  if (!*control) {
165  routine();
166  *control = 1;
167  }
168  return 0;
169 }
170 
171 #endif
172 
173 #endif /* AVUTIL_THREAD_H */
pthread_mutex_t
_fmutex pthread_mutex_t
Definition: os2threads.h:49
pthread_join
static av_always_inline int pthread_join(pthread_t thread, void **value_ptr)
Definition: os2threads.h:90
ff_mutex_init
static int ff_mutex_init(AVMutex *mutex, const void *attr)
Definition: thread.h:154
w32pthreads.h
pthread_mutex_init
static av_always_inline int pthread_mutex_init(pthread_mutex_t *mutex, const pthread_mutexattr_t *attr)
Definition: os2threads.h:100
pthread_mutexattr_t
void pthread_mutexattr_t
Definition: os2threads.h:50
ff_mutex_unlock
static int ff_mutex_unlock(AVMutex *mutex)
Definition: thread.h:156
os2threads.h
ff_thread_once
static int ff_thread_once(char *control, void(*routine)(void))
Definition: thread.h:162
AVMutex
#define AVMutex
Definition: thread.h:151
pthread_cond_broadcast
static av_always_inline int pthread_cond_broadcast(pthread_cond_t *cond)
Definition: os2threads.h:158
pthread_once
static av_always_inline int pthread_once(pthread_once_t *once_control, void(*init_routine)(void))
Definition: os2threads.h:184
pthread_mutex_unlock
#define pthread_mutex_unlock(a)
Definition: ffprobe.c:65
ff_mutex_destroy
static int ff_mutex_destroy(AVMutex *mutex)
Definition: thread.h:157
ff_mutex_lock
static int ff_mutex_lock(AVMutex *mutex)
Definition: thread.h:155
pthread_t
Definition: os2threads.h:40
pthread_cond_destroy
static av_always_inline int pthread_cond_destroy(pthread_cond_t *cond)
Definition: os2threads.h:140
pthread_mutex_destroy
static av_always_inline int pthread_mutex_destroy(pthread_mutex_t *mutex)
Definition: os2threads.h:108
log.h
pthread_cond_t
Definition: os2threads.h:54
pthread_cond_signal
static av_always_inline int pthread_cond_signal(pthread_cond_t *cond)
Definition: os2threads.h:148
config.h
pthread_once_t
Definition: os2threads.h:62
pthread_cond_wait
static av_always_inline int pthread_cond_wait(pthread_cond_t *cond, pthread_mutex_t *mutex)
Definition: os2threads.h:166
pthread_cond_init
static av_always_inline int pthread_cond_init(pthread_cond_t *cond, const pthread_condattr_t *attr)
Definition: os2threads.h:129
pthread_condattr_t
void pthread_condattr_t
Definition: os2threads.h:60
cond
int(* cond)(enum AVPixelFormat pix_fmt)
Definition: pixdesc_query.c:28
mutex
static AVMutex mutex
Definition: log.c:44
pthread_mutex_lock
#define pthread_mutex_lock(a)
Definition: ffprobe.c:61