Document mac_reset()

src/include/aegis128l.h

@@ -271,6 +271,8 @@ void aegis128l_decrypt_unauthenticated(uint8_t *m, const uint8_t *c, size_t clen
  * After initialization, the state can be reused to generate multiple MACs by cloning it
  * with `aegis128l_mac_state_clone()`. It is only safe to copy a state directly without using
  * the clone function if the state is guaranteed to be properly aligned.
+ *
+ * A state can also be reset for reuse without cloning with `aegis128l_mac_reset()`.
  */
 void aegis128l_mac_init(aegis128l_mac_state *st_, const uint8_t *k, const uint8_t *npub);
 

src/include/aegis128x2.h

@@ -271,6 +271,8 @@ void aegis128x2_decrypt_unauthenticated(uint8_t *m, const uint8_t *c, size_t cle
  * After initialization, the state can be reused to generate multiple MACs by cloning it
  * with `aegis128x2_mac_state_clone()`. It is only safe to copy a state directly without using
  * the clone function if the state is guaranteed to be properly aligned.
+ *
+ * A state can also be reset for reuse without cloning with `aegis128x2_mac_reset()`.
  */
 void aegis128x2_mac_init(aegis128x2_mac_state *st_, const uint8_t *k, const uint8_t *npub);
 

src/include/aegis128x4.h

@@ -271,6 +271,8 @@ void aegis128x4_decrypt_unauthenticated(uint8_t *m, const uint8_t *c, size_t cle
  * After initialization, the state can be reused to generate multiple MACs by cloning it
  * with `aegis128x4_mac_state_clone()`. It is only safe to copy a state directly without using
  * the clone function if the state is guaranteed to be properly aligned.
+ *
+ * A state can also be reset for reuse without cloning with `aegis128x4_mac_reset()`.
  */
 void aegis128x4_mac_init(aegis128x4_mac_state *st_, const uint8_t *k, const uint8_t *npub);
 

src/include/aegis256.h

@@ -271,6 +271,8 @@ void aegis256_decrypt_unauthenticated(uint8_t *m, const uint8_t *c, size_t clen,
  * After initialization, the state can be reused to generate multiple MACs by cloning it
  * with `aegis256_mac_state_clone()`. It is only safe to copy a state directly without using
  * the clone function if the state is guaranteed to be properly aligned.
+ *
+ * A state can also be reset for reuse without cloning with `aegis256_mac_reset()`.
  */
 void aegis256_mac_init(aegis256_mac_state *st_, const uint8_t *k, const uint8_t *npub);
 

src/include/aegis256x2.h

@@ -271,6 +271,8 @@ void aegis256x2_decrypt_unauthenticated(uint8_t *m, const uint8_t *c, size_t cle
  * After initialization, the state can be reused to generate multiple MACs by cloning it
  * with `aegis256x2_mac_state_clone()`. It is only safe to copy a state directly without using
  * the clone function if the state is guaranteed to be properly aligned.
+ *
+ * A state can also be reset for reuse without cloning with `aegis256x2_mac_reset()`.
  */
 void aegis256x2_mac_init(aegis256x2_mac_state *st_, const uint8_t *k, const uint8_t *npub);
 

src/include/aegis256x4.h

@@ -271,6 +271,8 @@ void aegis256x4_decrypt_unauthenticated(uint8_t *m, const uint8_t *c, size_t cle
  * After initialization, the state can be reused to generate multiple MACs by cloning it
  * with `aegis256x4_mac_state_clone()`. It is only safe to copy a state directly without using
  * the clone function if the state is guaranteed to be properly aligned.
+ *
+ * A state can also be reset for reuse without cloning with `aegis256x4_mac_reset()`.
  */
 void aegis256x4_mac_init(aegis256x4_mac_state *st_, const uint8_t *k, const uint8_t *npub);