TheCloud/dwarfs
1
0
Fork 0
mirror of https://github.com/mhx/dwarfs.git synced 2025-09-16 07:46:27 -04:00
Code Issues Packages Projects Releases Wiki Activity

Document how to produce bit-identical images

Browse Source
This commit is contained in:
Marcus Holland-Moritz 2022-11-08 21:54:57 +01:00
parent ee39c3eef7
commit 03019e4a73
1 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/mkdwarfs.md
View File

@ -484,6 +484,21 @@ further compress the block. So if you're really desperately trying
to reduce the image size, enabling `all` packing would be an option
at the cost of using a lot more memory when using the filesystem.
### Producing bit-identical images
By default, images produced by `mkdwarfs` will not be identical
over multiple runs. There are two reasons for this:
- A creation timestamp is embedded in the image.
- The `nilsimsa` ordering algorithm is not deterministic by
default.
In order to produce bit-identical images, you need to pass
`--no-create-timestamp` and set `--order` to `path` or `similarity`.
You could also set `--order=none` and pass in files explicitly
using `--input-list`.
## FILTER RULES
The filter rules have been inspired by the `rsync` utility. They