1
0
mirror of https://github.com/FFmpeg/FFmpeg.git synced 2025-01-03 05:10:03 +02:00
FFmpeg/doc
wm4 631c56a8e4 avformat: make avformat_network_init() explicitly optional
It was sort of optional before - if you didn't call it, networking was
initialized on demand, and an ugly warning was logged. Also, the doxygen
comments threatened that it would be made strictly required one day.

Make it explicitly optional. I would prefer to deprecate it fully, but
there might still be legitimate reasons to use this. But the average
user won't need it.

This is needed only for two reasons: to initialize TLS libraries like
OpenSSL and GnuTLS, and winsock.

OpenSSL and GnuTLS were already silently initialized on demand if the
global network init function was not called. They also have various
thread-safety acrobatics, which make concurrent initialization within
libavformat safe. In addition, the libraries are moving towards making
their global init functions safe, which removes all need for central
global init. In particular, GnuTLS 3.5.16 and OpenSSL 1.1.0g have been
found to have safe init functions. In all cases, they use internal
reference counters to avoid that the global uninit functions interfere
with concurrent uses of the library by other API users who called global
init.

winsock should be thread-safe as well, and maintains an internal
reference counter as well.

Since we still support ancient TLS libraries, which do not have this
fixed, and since it's unknown whether winsock and GnuTLS
reinitialization is costly in any way, don't deprecate the libavformat
functions yet.
2018-01-16 12:57:04 +01:00
..
doxy
examples examples/vaapi_encode: Remove redundancy check when free context. 2018-01-12 12:31:55 +01:00
.gitignore
APIchanges avformat: make avformat_network_init() explicitly optional 2018-01-16 12:57:04 +01:00
authors.texi
bitstream_filters.texi lavc: Add mpeg2_metadata bitstream filter 2017-10-17 20:56:30 +01:00
bootstrap.min.css
build_system.txt doc/build_system: Document how to build decoder fuzzer 2017-05-08 17:02:02 +02:00
codecs.texi doc/codecs.texi: Remove documentation of removed codec flags. 2017-11-20 01:10:54 +01:00
decoders.texi libavcodec/hevc_filter: support for all skip_loop_filter levels. 2017-12-04 19:05:36 +01:00
default.css
demuxers.texi dashdec: Support for multiple video/audio streams 2018-01-14 22:34:43 +08:00
developer.texi doc/developer: revise mailing list section 2017-12-05 02:06:10 -08:00
devices.texi
doxy-wrapper.sh
Doxyfile
encoders.texi aacenc: use the fast coder as the default 2018-01-13 12:03:19 +00:00
errno.txt
faq.texi doc: Add FAQs about running in background (rev 2) 2017-11-22 18:13:49 +01:00
fate_config.sh.template Merge commit '35d1f726eb9fdd376ab900587fb02122b72f2b9a' 2017-05-05 09:27:18 +02:00
fate.texi doc/fate: Document how to upload samples to the fate suite 2018-01-06 03:14:38 +01:00
ffmpeg-bitstream-filters.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg-codecs.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg-devices.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg-filters.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg-formats.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg-protocols.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg-resampler.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg-scaler.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg-utils.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffmpeg.txt
ffplay.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffprobe.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
ffprobe.xsd ffprobe: Print color properties from show_frames 2017-07-21 20:19:07 +02:00
fftools-common-opts.texi doc/fftools: Remove documentation for old -opencl_bench option 2017-11-26 15:40:24 +00:00
filter_design.txt doc: update filter_design.txt. 2017-09-12 11:03:51 +02:00
filters.texi doc/filters: fix error in aiir options names 2018-01-10 20:32:22 +01:00
formats.texi avformat: make flush_packets a tri-state and set it to -1 (auto) by default 2017-06-24 18:51:29 +02:00
general.texi avformat: add NSP demuxer 2017-12-08 16:01:09 +01:00
git-howto.texi
indevs.texi avdevice/decklink_dec: autodetect the video input format 2017-11-22 00:08:35 +01:00
issue_tracker.txt Remove the ffserver program 2018-01-06 18:31:37 +00:00
lexicon
libav-merge.txt doc/libav-merge: remove line about libavutil atomics API 2018-01-05 22:09:39 -03:00
libavcodec.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
libavdevice.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
libavfilter.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
libavformat.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
libavutil.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
libswresample.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
libswscale.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
mailing-list-faq.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
Makefile doc: Add mailing list FAQ 2017-10-03 15:25:07 -08:00
metadata.texi
mips.txt
multithreading.txt
muxers.texi avformat/hlsenc: creation of variant streams in subdirectories 2018-01-02 10:46:48 +08:00
nut.texi
optimization.txt build: Prefer NASM assembler over YASM 2017-06-21 17:00:30 -03:00
outdevs.texi Remove all output devices 2017-10-13 23:57:01 +02:00
patchwork
platform.texi build: Prefer NASM assembler over YASM 2017-06-21 17:00:30 -03:00
print_options.c
protocols.texi Remove the ffserver program 2018-01-06 18:31:37 +00:00
rate_distortion.txt
resampler.texi
scaler.texi
snow.txt
style.min.css
swresample.txt
swscale.txt
t2h.init
t2h.pm
tablegen.txt
texi2pod.pl
texidep.pl
undefined.txt doc: Add initial documentation explaining undefined behavior and SUINT 2017-07-21 17:37:05 +02:00
utils.texi lavu,lavfi,ffmpeg: Remove experimental OpenCL API 2017-11-22 23:20:39 +00:00
writing_filters.txt Merge commit '11a9320de54759340531177c9f2b1e31e6112cc2' 2017-05-03 16:49:12 +02:00