From 27d5d3202081ec8e328a928c117a43e3337aff83 Mon Sep 17 00:00:00 2001 From: wm4 Date: Fri, 7 Feb 2020 15:56:52 +0100 Subject: demux: add option to disable "sharing" between back and forward buffers As requested. I guess option name and manpage text could be better and clearer. Closes: #7442 --- DOCS/man/options.rst | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) (limited to 'DOCS/man/options.rst') diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index a81d3313ea..bcdad2ed41 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -3365,7 +3365,8 @@ Demuxer position (as it removes past packets that are seek points). If the end of the file is reached, the remaining unused forward buffer space - is "donated" to the backbuffer (unless the backbuffer size is set to 0). + is "donated" to the backbuffer (unless the backbuffer size is set to 0, or + ``--demuxer-donate-buffer`` is set to ``no``). This still limits the total cache usage to the sum of the forward and backward cache, and effectively makes better use of the total allowed memory budget. (The opposite does not happen: free backward buffer is never @@ -3377,6 +3378,18 @@ Demuxer See ``--list-options`` for defaults and value range. +``--demuxer-donate-buffer=`` + Whether to let the back buffer use part of the forward buffer (default: yes). + If set to ``yes``, the "donation" behavior described in the option + description for ``--demuxer-max-back-bytes`` is enabled. This means the + back buffer may use up memory up to the sum of the forward and back buffer + options, minus the active size of the forward buffer. If set to ``no``, the + options strictly limit the forward and back buffer sizes separately. + + Note that if the end of the file is reached, the buffered data stays the + same, even if you seek back within the cache. This is because the back + buffer is only reduced when new data is read. + ``--demuxer-seekable-cache=`` This controls whether seeking can use the demuxer cache (default: auto). If enabled, short seek offsets will not trigger a low level demuxer seek -- cgit v1.2.3