Skip to content

Commit 3f7846f

Browse files
committed
docs: caveat that the meta-null verify form corrupts header hashing
1 parent 13ac3e6 commit 3f7846f

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

docs/verification.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,8 @@ split -l 1 ~/MANIFEST.jsonl \
4141
tr -d '\n' | sha256sum
4242
```
4343

44+
**Caveat**: Use this meta-null form only when rows actually carry `"meta": null` — applied to a header line (which has no `meta`), `jq` reads the absent `.meta` as null and injects `meta: {}`, corrupting the header hash; use the plain `del(.physical_keys)` form otherwise.
45+
4446
## CRC64/NVMe Verification
4547

4648
CRC64-NVMe is a whole-file checksum (no chunking). The digest is 8 bytes,

0 commit comments

Comments
 (0)