commit | 915bfe29c4bb20aa4e6ce80f0aba6f6add0def23 | [log] [tgz] |
---|---|---|
author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Sun May 26 07:10:53 2024 +0000 |
committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Sun May 26 07:10:53 2024 +0000 |
tree | 4ae35a94265b9c697041519825384002316eb3dc | |
parent | 376dbbaa155a7a17b6ec5aba4d26ca8ee98c3fc6 [diff] | |
parent | 47946942772472573150805fea53210b7adc7cd9 [diff] |
Snap for 11878398 from 47946942772472573150805fea53210b7adc7cd9 to busytown-mac-infra-release Change-Id: Ibb51074ecc27df2f77972cff84fe421f50e0b329
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.