FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libavcodec/pthread.c
Date: 2025-10-19 14:07:46
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 35555 static av_cold void validate_thread_parameters(AVCodecContext *avctx)
50 {
51 71110 int frame_threading_supported = (avctx->codec->capabilities & AV_CODEC_CAP_FRAME_THREADS)
52
1/2
✓ Branch 0 taken 21328 times.
✗ Branch 1 not taken.
 21328 && !(avctx->flags & AV_CODEC_FLAG_LOW_DELAY)
53
4/4
✓ Branch 0 taken 21328 times.
✓ Branch 1 taken 14227 times.
✓ Branch 2 taken 21327 times.
✓ Branch 3 taken 1 times.
 56883 && !(avctx->flags2 & AV_CODEC_FLAG2_CHUNKS);
54
2/2
✓ Branch 0 taken 34321 times.
✓ Branch 1 taken 1234 times.
 35555 if (avctx->thread_count == 1) {
55 34321 avctx->active_thread_type = 0;
56
4/4
✓ Branch 0 taken 16 times.
✓ Branch 1 taken 1218 times.
✓ Branch 2 taken 10 times.
✓ Branch 3 taken 6 times.
 1234 } 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 29 times.
✓ Branch 1 taken 1195 times.
 1224 } else if (avctx->codec->capabilities & AV_CODEC_CAP_SLICE_THREADS &&
59
1/2
✓ Branch 0 taken 29 times.
✗ Branch 1 not taken.
 29 avctx->thread_type & FF_THREAD_SLICE) {
60 29 avctx->active_thread_type = FF_THREAD_SLICE;
61
1/2
✓ Branch 1 taken 1195 times.
✗ Branch 2 not taken.
 1195 } else if (!(ffcodec(avctx->codec)->caps_internal & FF_CODEC_CAP_AUTO_THREADS)) {
62 1195 avctx->thread_count = 1;
63 1195 avctx->active_thread_type = 0;
64 }
65
66
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 35555 times.
 35555 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 35555 }
71
72 35555 av_cold int ff_thread_init(AVCodecContext *avctx)
73 {
74 35555 validate_thread_parameters(avctx);
75
76
2/2
✓ Branch 0 taken 29 times.
✓ Branch 1 taken 35526 times.
 35555 if (avctx->active_thread_type&FF_THREAD_SLICE)
77 29 return ff_slice_thread_init(avctx);
78
2/2
✓ Branch 0 taken 10 times.
✓ Branch 1 taken 35516 times.
 35526 else if (avctx->active_thread_type&FF_THREAD_FRAME)
79 10 return ff_frame_thread_init(avctx);
80
81 35516 return 0;
82 }
83
84 36 av_cold void ff_thread_free(AVCodecContext *avctx)
85 {
86
2/2
✓ Branch 0 taken 10 times.
✓ Branch 1 taken 26 times.
 36 if (avctx->active_thread_type&FF_THREAD_FRAME)
87 10 ff_frame_thread_free(avctx, avctx->thread_count);
88 else
89 26 ff_slice_thread_free(avctx);
90 36 }
91
92 6182 av_cold void ff_pthread_free(void *obj, const unsigned offsets[])
93 {
94 6182 unsigned cnt = *(unsigned*)((char*)obj + offsets[0]);
95 6182 const unsigned *cur_offset = offsets;
96
97 6182 *(unsigned*)((char*)obj + offsets[0]) = 0;
98
99
4/4
✓ Branch 0 taken 7933 times.
✓ Branch 1 taken 1765 times.
✓ Branch 2 taken 3516 times.
✓ Branch 3 taken 4417 times.
 9698 for (; *(++cur_offset) != THREAD_SENTINEL && cnt; cnt--)
100 3516 pthread_mutex_destroy((pthread_mutex_t*)((char*)obj + *cur_offset));
101
3/4
✓ Branch 0 taken 3572 times.
✓ Branch 1 taken 6182 times.
✓ Branch 2 taken 3572 times.
✗ Branch 3 not taken.
 9754 for (; *(++cur_offset) != THREAD_SENTINEL && cnt; cnt--)
102 3572 pthread_cond_destroy ((pthread_cond_t *)((char*)obj + *cur_offset));
103 6182 }
104
105 1765 av_cold int ff_pthread_init(void *obj, const unsigned offsets[])
106 {
107 1765 const unsigned *cur_offset = offsets;
108 1765 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 3516 times.
✓ Branch 3 taken 3516 times.
✓ Branch 4 taken 1765 times.
 5281 PTHREAD_INIT_LOOP(mutex)
121
3/4
✗ Branch 1 not taken.
✓ Branch 2 taken 3572 times.
✓ Branch 3 taken 3572 times.
✓ Branch 4 taken 1765 times.
 5337 PTHREAD_INIT_LOOP(cond)
122
123 1765 fail:
124 1765 *(unsigned*)((char*)obj + offsets[0]) = cnt;
125 1765 return err;
126 }
127