symm/keccak1600.c: Add new function to overwrite the state.

[catacomb] / symm / keccak1600.h

diff --git a/symm/keccak1600.h b/symm/keccak1600.h
index 2867be9..f5aad98 100644 (file)
--- a/symm/keccak1600.h
+++ b/symm/keccak1600.h
@@ -112,6 +112,26 @@ extern void keccak1600_init(keccak1600_state */*s*/);
 extern void keccak1600_mix(keccak1600_state */*s*/,
                           const kludge64 */*p*/, size_t /*n*/);
 
+/* --- @keccak1600_set@ --- *
+ *
+ * Arguments:  @keccak1600_state *s@ = a state to update
+ *             @const kludge64 *p@ = pointer to 64-bit words to mix in
+ *             @size_t n@ = size of the input, in 64-bit words
+ *
+ * Returns:    ---
+ *
+ * Use:                Stores data into a %$\Keccak[r, 1600 - r]$% state.  Note that
+ *             it's the caller's responsibility to pass in no more than
+ *             %$r$% bits of data.
+ *
+ *             This is not the operation you wanted for ordinary hashing.
+ *             It's provided for the use of higher-level protocols which use
+ *             duplexing and other fancy sponge features.
+ */
+
+extern void keccak1600_set(keccak1600_state */*s*/,
+                          const kludge64 */*p*/, size_t /*n*/);
+
 /* --- @keccak1600_extract@ --- *
  *
  * Arguments:  @const keccak1600_state *s@ = a state to extract output from