hash: Add a way to calculate a hash for any algortihm

[karo-tx-uboot.git] / include / hash.h

diff --git a/include/hash.h b/include/hash.h
index 2dbbd9b7d5789e3c42b3d489156954697c47ea49..c402067af8a755156e5ffa9430ea236a0d3a008a 100644 (file)
--- a/include/hash.h
+++ b/include/hash.h
@@ -71,4 +71,26 @@ enum {
 int hash_command(const char *algo_name, int flags, cmd_tbl_t *cmdtp, int flag,
                 int argc, char * const argv[]);
 
+/**
+ * hash_block() - Hash a block according to the requested algorithm
+ *
+ * The caller probably knows the hash length for the chosen algorithm, but
+ * in order to provide a general interface, and output_size parameter is
+ * provided.
+ *
+ * @algo_name:         Hash algorithm to use
+ * @data:              Data to hash
+ * @len:               Lengh of data to hash in bytes
+ * @output:            Place to put hash value
+ * @output_size:       On entry, pointer to the number of bytes available in
+ *                     output. On exit, pointer to the number of bytes used.
+ *                     If NULL, then it is assumed that the caller has
+ *                     allocated enough space for the hash. This is possible
+ *                     since the caller is selecting the algorithm.
+ * @return 0 if ok, -ve on error: -EPROTONOSUPPORT for an unknown algorithm,
+ * -ENOSPC if the output buffer is not large enough.
+ */
+int hash_block(const char *algo_name, const void *data, unsigned int len,
+              uint8_t *output, int *output_size);
+
 #endif