local: implement --local-no-sparse flag for disabling sparse files #2469

This also introduces a one time warning for sparse files and updates
the docs to warn about them.
This commit is contained in:
Nick Craig-Wood
2020-05-19 10:16:43 +01:00
parent 5cb2a2fa3c
commit 610f40f700
2 changed files with 28 additions and 4 deletions

View File

@@ -844,6 +844,12 @@ with any source.
as they are faster without unless `--multi-thread-streams` is set
explicitly.
**NB** on Windows using multi-thread downloads will cause the
resulting files to be [sparse](https://en.wikipedia.org/wiki/Sparse_file).
Use `--local-no-sparse` to disable sparse files (which may cause long
delays at the start of downloads) or disable multi-thread downloads
with `--multi-thread-streams 0`
### --multi-thread-streams=N ###
When using multi thread downloads (see above `--multi-thread-cutoff`)