| commit | d3397fd7f7681a4644db975d0925f71a56b0685d | [log] [tgz] |
|---|---|---|
| author | James Farrell <jamesfarrell@google.com> | Mon Sep 30 22:59:19 2024 +0000 |
| committer | James Farrell <jamesfarrell@google.com> | Mon Sep 30 22:59:19 2024 +0000 |
| tree | e8d30dd917db009bfead9f9df486a9827c1c7930 | |
| parent | d8e2cfaf8d48b71bb64bc78907b6d4105bcbf26e [diff] |
Migrate 25 crates to monorepo quickcheck regex-automata ryu same-file serde serde_json serde_spanned serde_test sharded-slab shlex siphasher tinyvec tinyvec_macros tokio-io-timeout toml toml_datetime toml_edit uniffi uniffi_checksum_derive uniffi_meta virtio-bindings virtio-queue virtio-vsock vsock vsprintf zerocopy-derive Bug: http://b/339424309 Test: treehugger Change-Id: I4cb63870f133f63d1e9b1ed8234d1c17f7d71d51
This crates implements SipHash-2-4 and SipHash-1-3 in Rust.
It is based on the original implementation from rust-core and exposes the same API.
It also implements SipHash variants returning 128-bit tags.
The sip module implements the standard 64-bit mode, whereas the sip128 module implements the 128-bit mode.
In Cargo.toml:
[dependencies] siphasher = "1"
If you want serde support, include the feature like this:
[dependencies] siphasher = { version = "1", features = ["serde"] }
64-bit mode:
use siphasher::sip::{SipHasher, SipHasher13, SipHasher24}; // one-shot: let array: &[u8] = &[1, 2, 3]; let key: &[u8; 16] = &[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]; let hasher = SipHasher13::new_with_key(key); let h = hasher.hash(array); // incremental: use core::hash::Hasher; let array1: &[u8] = &[1, 2, 3]; let array2: &[u8] = &[4, 5, 6]; let key: &[u8; 16] = &[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]; let mut hasher = SipHasher13::new_with_key(key); hasher.write(array1); hasher.write(array2); let h = hasher.finish();
128-bit mode:
use siphasher::sip128::{Hasher128, SipHasher, SipHasher13, SipHasher24}; // one-shot: let array: &[u8] = &[1, 2, 3]; let key: &[u8; 16] = &[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]; let hasher = SipHasher13::new_with_key(key); let h = hasher.hash(array).as_bytes(); // incremental: use core::hash::Hasher; let array1: &[u8] = &[1, 2, 3]; let array2: &[u8] = &[4, 5, 6]; let key: &[u8; 16] = &[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]; let mut hasher = SipHasher13::new_with_key(key); hasher.write(array1); hasher.write(array2); let h = hasher.finish128().as_bytes();
Due to a confusing and not well documented API, methods from the Hasher trait of the standard library (std::hash::Hasher, core::hash::Hasher) produce non-portable results.
This is not specific to SipHash, and affects all hash functions.
The only safe methods in that trait are write() and finish().
It is thus recommended to use SipHash (and all other hash functions, actually) as documented above.