TheCloud/dwarfs
1
0
Fork 0
mirror of https://github.com/mhx/dwarfs.git synced 2025-08-04 02:06:22 -04:00
Code Issues Packages Projects Releases Wiki Activity

docs(mkdwarfs): add a warning to the -B flag

Browse Source
This commit is contained in:
Marcus Holland-Moritz 2025-04-10 21:09:19 +02:00
parent a30e23bccb
commit 00f4d64036
1 changed files with 8 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/mkdwarfs.md
View File

@ -128,9 +128,14 @@ Most other options are concerned with compression tuning:
By default, only the current block will be scanned. The larger this number, By default, only the current block will be scanned. The larger this number,
the more duplicate segments will likely be found, which may further improve the more duplicate segments will likely be found, which may further improve
compression. Impact on compression speed is minimal, but this could cause compression. Impact on compression speed is minimal, but this could cause
resulting filesystem to be slightly less efficient to use, as single small resulting filesystem to be less efficient to use, as single small files can
files can now potentially span multiple filesystem blocks. Passing `-B0` now potentially span multiple filesystem blocks. Definitely avoid passing
will completely disable duplicate segment search. large values (i.e. larger than 10) here, especially in combination with
large block sizes, unless you know *exactly* what you are doing. To give
give you an idea, using `-S 26` (i.e. 64 MiB blocks) with `-B 32` means
that in the worst case, to read a single file of less than 1 MiB in size,
the file system may have to decompress 2 GiB of data. You have been warned.
Passing `-B0` will completely disable duplicate segment search.
- `-W`, `--window-size=[*category*`::`]`*value*: - `-W`, `--window-size=[*category*`::`]`*value*:
Window size of cyclic hash used for segmenting. This is an exponent Window size of cyclic hash used for segmenting. This is an exponent