4 releases

0.1.3 Feb 21, 2021
0.1.2 Jun 16, 2020
0.1.1 Sep 3, 2019
0.1.0 Apr 26, 2019

27 downloads per month

MIT/Apache

13KB
170 lines

sha1dir

github crates.io build status

Compute a checksum of a directory tree, for example to validate that a directory was copied successfully to a different machine.

Installation

$ RUSTFLAGS='-C target-cpu=native' cargo install sha1dir

Usage

Run sha1dir to checksum the current directory, or run sha1dir path/to/dir1 path/to/dir2 ... to checksum one or more other directories.

Behavior

The checksum is computed as the bitwise XOR of SHA-1 hashes one per directory entry. The hash for each directory entry is the hash of the following body:

  • For regular files — the one byte 'f', 4 little endian bytes for the path length, the bytes of the path, 4 little endian bytes for the Unix file mode as given by st_mode, and finally the file contents.

  • For symbolic links — the one byte 'l', the path length / path / mode as for regular files, and then the path of the link target.

  • For directories — the one byte 'd', and the path length / path / mode.

The resulting checksum is 160 bits wide like SHA-1.


License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~4MB
~77K SLoC