FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libavcodec/pthread.c
Date: 2025-07-12 22:17:06
Exec Total Coverage
Lines: 45 46 97.8%
Functions: 5 5 100.0%
Branches: 35 42 83.3%
Line Branch Exec Source
1 /*
2 * Copyright (c) 2004 Roman Shaposhnik
3 * Copyright (c) 2008 Alexander Strange (astrange@ithinksw.com)
4 *
5 * Many thanks to Steven M. Schultz for providing clever ideas and
6 * to Michael Niedermayer <michaelni@gmx.at> for writing initial
7 * implementation.
8 *
9 * This file is part of FFmpeg.
10 *
11 * FFmpeg is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU Lesser General Public
13 * License as published by the Free Software Foundation; either
14 * version 2.1 of the License, or (at your option) any later version.
15 *
16 * FFmpeg is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 * Lesser General Public License for more details.
20 *
21 * You should have received a copy of the GNU Lesser General Public
22 * License along with FFmpeg; if not, write to the Free Software
23 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 */
25
26 /**
27 * @file
28 * Multithreading support functions
29 * @see doc/multithreading.txt
30 */
31
32 #include "libavutil/attributes.h"
33 #include "libavutil/thread.h"
34
35 #include "avcodec.h"
36 #include "avcodec_internal.h"
37 #include "codec_internal.h"
38 #include "pthread_internal.h"
39
40 /**
41 * Set the threading algorithms used.
42 *
43 * Threading requires more than one thread.
44 * Frame threading requires entire frames to be passed to the codec,
45 * and introduces extra decoding delay, so is incompatible with low_delay.
46 *
47 * @param avctx The context.
48 */
49 35374 static av_cold void validate_thread_parameters(AVCodecContext *avctx)
50 {
51 70748 int frame_threading_supported = (avctx->codec->capabilities & AV_CODEC_CAP_FRAME_THREADS)
52
1/2
✓ Branch 0 taken 21234 times.
✗ Branch 1 not taken.
 21234 && !(avctx->flags & AV_CODEC_FLAG_LOW_DELAY)
53
4/4
✓ Branch 0 taken 21234 times.
✓ Branch 1 taken 14140 times.
✓ Branch 2 taken 21233 times.
✓ Branch 3 taken 1 times.
 56608 && !(avctx->flags2 & AV_CODEC_FLAG2_CHUNKS);
54
2/2
✓ Branch 0 taken 34155 times.
✓ Branch 1 taken 1219 times.
 35374 if (avctx->thread_count == 1) {
55 34155 avctx->active_thread_type = 0;
56
4/4
✓ Branch 0 taken 16 times.
✓ Branch 1 taken 1203 times.
✓ Branch 2 taken 10 times.
✓ Branch 3 taken 6 times.
 1219 } else if (frame_threading_supported && (avctx->thread_type & FF_THREAD_FRAME)) {
57 10 avctx->active_thread_type = FF_THREAD_FRAME;
58
2/2
✓ Branch 0 taken 28 times.
✓ Branch 1 taken 1181 times.
 1209 } else if (avctx->codec->capabilities & AV_CODEC_CAP_SLICE_THREADS &&
59
1/2
✓ Branch 0 taken 28 times.
✗ Branch 1 not taken.
 28 avctx->thread_type & FF_THREAD_SLICE) {
60 28 avctx->active_thread_type = FF_THREAD_SLICE;
61
1/2
✓ Branch 1 taken 1181 times.
✗ Branch 2 not taken.
 1181 } else if (!(ffcodec(avctx->codec)->caps_internal & FF_CODEC_CAP_AUTO_THREADS)) {
62 1181 avctx->thread_count = 1;
63 1181 avctx->active_thread_type = 0;
64 }
65
66
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 35374 times.
 35374 if (avctx->thread_count > MAX_AUTO_THREADS)
67 ✗ av_log(avctx, AV_LOG_WARNING,
68 "Application has requested %d threads. Using a thread count greater than %d is not recommended.\n",
69 avctx->thread_count, MAX_AUTO_THREADS);
70 35374 }
71
72 35374 av_cold int ff_thread_init(AVCodecContext *avctx)
73 {
74 35374 validate_thread_parameters(avctx);
75
76
2/2
✓ Branch 0 taken 28 times.
✓ Branch 1 taken 35346 times.
 35374 if (avctx->active_thread_type&FF_THREAD_SLICE)
77 28 return ff_slice_thread_init(avctx);
78
2/2
✓ Branch 0 taken 10 times.
✓ Branch 1 taken 35336 times.
 35346 else if (avctx->active_thread_type&FF_THREAD_FRAME)
79 10 return ff_frame_thread_init(avctx);
80
81 35336 return 0;
82 }
83
84 35 av_cold void ff_thread_free(AVCodecContext *avctx)
85 {
86
2/2
✓ Branch 0 taken 10 times.
✓ Branch 1 taken 25 times.
 35 if (avctx->active_thread_type&FF_THREAD_FRAME)
87 10 ff_frame_thread_free(avctx, avctx->thread_count);
88 else
89 25 ff_slice_thread_free(avctx);
90 35 }
91
92 6157 av_cold void ff_pthread_free(void *obj, const unsigned offsets[])
93 {
94 6157 unsigned cnt = *(unsigned*)((char*)obj + offsets[0]);
95 6157 const unsigned *cur_offset = offsets;
96
97 6157 *(unsigned*)((char*)obj + offsets[0]) = 0;
98
99
4/4
✓ Branch 0 taken 7900 times.
✓ Branch 1 taken 1757 times.
✓ Branch 2 taken 3500 times.
✓ Branch 3 taken 4400 times.
 9657 for (; *(++cur_offset) != THREAD_SENTINEL && cnt; cnt--)
100 3500 pthread_mutex_destroy((pthread_mutex_t*)((char*)obj + *cur_offset));
101
3/4
✓ Branch 0 taken 3556 times.
✓ Branch 1 taken 6157 times.
✓ Branch 2 taken 3556 times.
✗ Branch 3 not taken.
 9713 for (; *(++cur_offset) != THREAD_SENTINEL && cnt; cnt--)
102 3556 pthread_cond_destroy ((pthread_cond_t *)((char*)obj + *cur_offset));
103 6157 }
104
105 1757 av_cold int ff_pthread_init(void *obj, const unsigned offsets[])
106 {
107 1757 const unsigned *cur_offset = offsets;
108 1757 unsigned cnt = 0;
109 int err;
110
111 #define PTHREAD_INIT_LOOP(type) \
112 for (; *(++cur_offset) != THREAD_SENTINEL; cnt++) { \
113 pthread_ ## type ## _t *dst = (void*)((char*)obj + *cur_offset); \
114 err = pthread_ ## type ## _init(dst, NULL); \
115 if (err) { \
116 err = AVERROR(err); \
117 goto fail; \
118 } \
119 }
120
3/4
✗ Branch 1 not taken.
✓ Branch 2 taken 3500 times.
✓ Branch 3 taken 3500 times.
✓ Branch 4 taken 1757 times.
 5257 PTHREAD_INIT_LOOP(mutex)
121
3/4
✗ Branch 1 not taken.
✓ Branch 2 taken 3556 times.
✓ Branch 3 taken 3556 times.
✓ Branch 4 taken 1757 times.
 5313 PTHREAD_INIT_LOOP(cond)
122
123 1757 fail:
124 1757 *(unsigned*)((char*)obj + offsets[0]) = cnt;
125 1757 return err;
126 }
127