Lab
/
siphash
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
This is a maintenance fork of a C implementation of the SipHash algorithm
40 Commits
1 Branch
0 Tags
81 KiB
C 97.9%
Makefile 2.1%
 
 
Go to file
Kyle Altendorf 5a8b62a6f8 Use size_t and fixed width format specifiers for printf()... for siphash.c 
It was forgotten in #17 to apply this to siphash.c as well as halfsiphash.c.  Note
that as-is this does change to a single 16-hex-char string for v0/1/2/3 in debug
output rather than having 8 then a space then 8.  If preferred it can be changed
back to having the space and using `PRIx32` twice instead of `PRIx64` once.
 		2019-09-18 11:57:02 -04:00
.gitignore Initial commit 2014-03-23 02:51:00 -07:00
LICENSE Initial commit 2014-03-23 02:51:00 -07:00
README.md Make *c* and *d* rounds less intrusively configurable 2019-09-10 08:43:23 -04:00
halfsiphash.c Merge pull request #17 from altendky/format_specifiers 2019-09-14 12:43:31 +02:00
makefile Make *c* and *d* rounds less intrusively configurable 2019-09-10 08:43:23 -04:00
siphash.c Use size_t and fixed width format specifiers for printf()... for siphash.c 2019-09-18 11:57:02 -04:00
test.c Remove unneded #ifndef GETVECTORS check 2019-09-09 16:14:42 -04:00
vectors.h Update test vectors for HalfSipHash 2017-01-05 17:50:37 +01:00

README.md

SipHash

Reference implementation of SipHash, a family of pseudorandom functions optimized for speed on short messages.

SipHash was designed as a mitigation to hash-flooding DoS attacks. It is now used in the hash tables implementation of Python, Ruby, Perl 5, etc.

SipHash was designed by Jean-Philippe Aumasson and Daniel J. Bernstein.

Usage

Running

  make

will build tests for

  • SipHash-2-4, the default version of SipHash returning 64-bit tags
  • SipHash-2-4 with doubled tag size, i.e. 128-bit tags
  • HalfSipHash-2-4, a version of SipHash working with 32-bit words and returning 32-bit tags by default
  • HalfSipHash-2-4 with doubled tag size, i.e. 64-bit tags
  ./test

verifies 64 test vectors, and

  ./debug

does the same and prints intermediate values.

The code can be adapted to implement SipHash-c-d, the version of SipHash with c compression rounds and d finalization rounds, by defining cROUNDS or dROUNDS when compiling. This can be done with -D command line arguments to many compilers such as below.

gcc -Wall --std=c99 -DcROUNDS=2 -DdROUNDS=4 siphash.c halfsiphash.c test.c -o test

The makefile also takes c and d rounds values as parameters.

make cROUNDS=2 dROUNDS=4

Obviously, if the number of rounds is modified then the test vectors won't verify.

Intellectual property

The SipHash reference code is released under CC0 license, a public domain-like licence.

We aren't aware of any patents or patent applications relevant to SipHash, and we aren't planning to apply for any.

References

The SipHash page includes

  • a list of third-party implementations and modules
  • a list of projects using SipHash
  • references to cryptanalysis results