@@ -1391,6 +1391,15 @@ Advanced Options
13911391 system doesn't have :manpage:`getifaddrs(3)`, this option doesn't accept interface
13921392 name.
13931393
1394+ .. option:: --keep-unfinished-download-result[=true|false]
1395+
1396+ Keep unfinished download results even if doing so exceeds
1397+ :option:`--max-download-result`. This is useful if all unfinished
1398+ downloads must be saved in session file (see
1399+ :option:`--save-session` option). Please keep in mind that there is
1400+ no upper bound to the number of unfinished download result to keep.
1401+ If that is undesirable, turn this option off. Default: ``true``
1402+
13941403.. option:: --max-download-result=<NUM>
13951404
13961405 Set maximum number of download result kept in memory. The download
@@ -1400,8 +1409,10 @@ Advanced Options
14001409 oldest download result is removed from the front of the queue and
14011410 new one is pushed to the back. Setting big number in this option may
14021411 result high memory consumption after thousands of
1403- downloads. Specifying 0 means no download result is kept. Default:
1404- ``1000``
1412+ downloads. Specifying 0 means no download result is kept. Note that
1413+ unfinished downloads are kept in memory regardless of this option
1414+ value. See :option:`--keep-unfinished-download-result` option.
1415+ Default: ``1000``
14051416
14061417.. option:: --max-mmap-limit=<SIZE>
14071418
@@ -3240,6 +3251,7 @@ For information on the *secret* parameter, see :ref:`rpc_auth`.
32403251
32413252 * :option:`bt-max-open-files <--bt-max-open-files>`
32423253 * :option:`download-result <--download-result>`
3254+ * :option:`keep-unfinished-download-result <--keep-unfinished-download-result>`
32433255 * :option:`log <-l>`
32443256 * :option:`log-level <--log-level>`
32453257 * :option:`max-concurrent-downloads <-j>`
0 commit comments