FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libavcodec/pthread.c
Date: 2026-01-16 07:34:38
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 35781 static av_cold void validate_thread_parameters(AVCodecContext *avctx)
50 {
51 71562 int frame_threading_supported = (avctx->codec->capabilities & AV_CODEC_CAP_FRAME_THREADS)
52
1/2
✓ Branch 0 taken 21511 times.
✗ Branch 1 not taken.
 21511 && !(avctx->flags & AV_CODEC_FLAG_LOW_DELAY)
53
4/4
✓ Branch 0 taken 21511 times.
✓ Branch 1 taken 14270 times.
✓ Branch 2 taken 21510 times.
✓ Branch 3 taken 1 times.
 57292 && !(avctx->flags2 & AV_CODEC_FLAG2_CHUNKS);
54
2/2
✓ Branch 0 taken 34544 times.
✓ Branch 1 taken 1237 times.
 35781 if (avctx->thread_count == 1) {
55 34544 avctx->active_thread_type = 0;
56
4/4
✓ Branch 0 taken 16 times.
✓ Branch 1 taken 1221 times.
✓ Branch 2 taken 10 times.
✓ Branch 3 taken 6 times.
 1237 } 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 30 times.
✓ Branch 1 taken 1197 times.
 1227 } else if (avctx->codec->capabilities & AV_CODEC_CAP_SLICE_THREADS &&
59
1/2
✓ Branch 0 taken 30 times.
✗ Branch 1 not taken.
 30 avctx->thread_type & FF_THREAD_SLICE) {
60 30 avctx->active_thread_type = FF_THREAD_SLICE;
61
1/2
✓ Branch 1 taken 1197 times.
✗ Branch 2 not taken.
 1197 } else if (!(ffcodec(avctx->codec)->caps_internal & FF_CODEC_CAP_AUTO_THREADS)) {
62 1197 avctx->thread_count = 1;
63 1197 avctx->active_thread_type = 0;
64 }
65
66
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 35781 times.
 35781 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 35781 }
71
72 35781 av_cold int ff_thread_init(AVCodecContext *avctx)
73 {
74 35781 validate_thread_parameters(avctx);
75
76
2/2
✓ Branch 0 taken 30 times.
✓ Branch 1 taken 35751 times.
 35781 if (avctx->active_thread_type&FF_THREAD_SLICE)
77 30 return ff_slice_thread_init(avctx);
78
2/2
✓ Branch 0 taken 10 times.
✓ Branch 1 taken 35741 times.
 35751 else if (avctx->active_thread_type&FF_THREAD_FRAME)
79 10 return ff_frame_thread_init(avctx);
80
81 35741 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 6222 av_cold void ff_pthread_free(void *obj, const unsigned offsets[])
93 {
94 6222 unsigned cnt = *(unsigned*)((char*)obj + offsets[0]);
95 6222 const unsigned *cur_offset = offsets;
96
97 6222 *(unsigned*)((char*)obj + offsets[0]) = 0;
98
99
4/4
✓ Branch 0 taken 7982 times.
✓ Branch 1 taken 1774 times.
✓ Branch 2 taken 3534 times.
✓ Branch 3 taken 4448 times.
 9756 for (; *(++cur_offset) != THREAD_SENTINEL && cnt; cnt--)
100 3534 pthread_mutex_destroy((pthread_mutex_t*)((char*)obj + *cur_offset));
101
3/4
✓ Branch 0 taken 3590 times.
✓ Branch 1 taken 6222 times.
✓ Branch 2 taken 3590 times.
✗ Branch 3 not taken.
 9812 for (; *(++cur_offset) != THREAD_SENTINEL && cnt; cnt--)
102 3590 pthread_cond_destroy ((pthread_cond_t *)((char*)obj + *cur_offset));
103 6222 }
104
105 1774 av_cold int ff_pthread_init(void *obj, const unsigned offsets[])
106 {
107 1774 const unsigned *cur_offset = offsets;
108 1774 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 3534 times.
✓ Branch 3 taken 3534 times.
✓ Branch 4 taken 1774 times.
 5308 PTHREAD_INIT_LOOP(mutex)
121
3/4
✗ Branch 1 not taken.
✓ Branch 2 taken 3590 times.
✓ Branch 3 taken 3590 times.
✓ Branch 4 taken 1774 times.
 5364 PTHREAD_INIT_LOOP(cond)
122
123 1774 fail:
124 1774 *(unsigned*)((char*)obj + offsets[0]) = cnt;
125 1774 return err;
126 }
127