|author||Amin Hassani <email@example.com>||Thu Aug 13 20:32:19 2020|
|committer||Commit Bot <firstname.lastname@example.org>||Tue Aug 18 19:41:05 2020|
Prepare for presubmit pass in platform2 All manual changes that is reqiured for repo upload to passes when we move verity to platform2. BUG=chromium:886953 TEST=presubmit passes TEST=CQ passes Change-Id: I50b7bfa1b28564068fdfa4fc48eba1af92262973 Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/dm-verity/+/2353062 Tested-by: Amin Hassani <email@example.com> Commit-Queue: Mike Frysinger <firstname.lastname@example.org> Reviewed-by: Jorge Lucangeli Obes <email@example.com> Reviewed-by: Mike Frysinger <firstname.lastname@example.org>
Verity is the userspace tool for creating integrity hashes for a device image.
This tool is a frontend for dm-bht, a device-mapper friendly block hash table structure. `verity' produces dm-bht-based images for use with dm-verity. The dm-verity module provides a transparent, integrity-checking layer over a given block device. This expects a backing device and a secondary device which provides cryptographic digests of the blocks on the primary device
Note, the secondary device image can be appended to the primary device or used as a standalone device.
This tool creates an image of the format:
Upon completion, the hash of the root hash will be printed to standard out. The root hash, tree depth, number of hashed blocks, and cryptographic hash algorithm used must be supplied to the dm-verity when configuring a device.
To build outside of Chromium OS:
./verity mode depth alg image hash_image [root_hexdigest]
dd if=/dev/zero of=/tmp/image bs=4k count=512 ./verity create 2 sha256 /tmp/image /tmp/hash | tee table # ... cat table ls -la /tmp/hash
All the source code is licensed GPLv2 to be completely kernel compatible. The Makefiles are from the parent project and are licensed under a BSD-style license.