diff options
Diffstat (limited to 'DOCS/man/options.rst')
| -rw-r--r-- | DOCS/man/options.rst | 15 |
1 files changed, 14 insertions, 1 deletions
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=<yes|no>`` + 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=<yes|no|auto>`` This controls whether seeking can use the demuxer cache (default: auto). If enabled, short seek offsets will not trigger a low level demuxer seek |