lib: introduce arch optimized hash library

We introduce a new hashing library that is meant to be used in
the contexts where speed is more important than uniformity of the
hashed values. The hash library leverages architecture specific
implementation to achieve high performance and fall backs to
jhash() for the generic case.

On Intel-based x86 architectures, the library can exploit the crc32l
instruction, part of the Intel SSE4.2 instruction set, if the
instruction is supported by the processor. This implementation
is twice as fast as the jhash() implementation on an i7 processor.

Additional architectures, such as Arm64 provide instructions for
accelerating the computation of CRC, so they could be added as well
in follow-up work.

Signed-off-by: Francesco Fusco <ffusco@redhat.com>
Signed-off-by: Daniel Borkmann <dborkman@redhat.com>
Signed-off-by: Thomas Graf <tgraf@redhat.com>
Cc: linux-kernel@vger.kernel.org
Signed-off-by: David S. Miller <davem@davemloft.net>

1 files changed, 36 insertions, 0 deletions

diff --git a/include/linux/hash.h b/include/linux/hash.h
index f09a0ae4d858..bd1754c7ecef 100644
--- a/include/linux/hash.h
+++ b/include/linux/hash.h
@@ -15,6 +15,7 @@
  */
 
 #include <asm/types.h>
+#include <asm/hash.h>
 #include <linux/compiler.h>
 
 /* 2^31 + 2^29 - 2^25 + 2^22 - 2^19 - 2^16 + 1 */
@@ -78,4 +79,39 @@ static inline u32 hash32_ptr(const void *ptr)
 #endif
         return (u32)val;
 }
+
+struct fast_hash_ops {
+        u32 (*hash)(const void *data, u32 len, u32 seed);
+        u32 (*hash2)(const u32 *data, u32 len, u32 seed);
+};
+
+/**
+ *      arch_fast_hash - Caclulates a hash over a given buffer that can have
+ *                       arbitrary size. This function will eventually use an
+ *                       architecture-optimized hashing implementation if
+ *                       available, and trades off distribution for speed.
+ *
+ *      @data: buffer to hash
+ *      @len: length of buffer in bytes
+ *      @seed: start seed
+ *
+ *      Returns 32bit hash.
+ */
+extern u32 arch_fast_hash(const void *data, u32 len, u32 seed);
+
+/**
+ *      arch_fast_hash2 - Caclulates a hash over a given buffer that has a
+ *                        size that is of a multiple of 32bit words. This
+ *                        function will eventually use an architecture-
+ *                        optimized hashing implementation if available,
+ *                        and trades off distribution for speed.
+ *
+ *      @data: buffer to hash (must be 32bit padded)
+ *      @len: number of 32bit words
+ *      @seed: start seed
+ *
+ *      Returns 32bit hash.
+ */
+extern u32 arch_fast_hash2(const u32 *data, u32 len, u32 seed);
+
 #endif /* _LINUX_HASH_H */