diff options
author | Mattias Andrée <maandree@operamail.com> | 2015-10-06 18:56:32 +0200 |
---|---|---|
committer | Mattias Andrée <maandree@operamail.com> | 2015-10-06 18:56:32 +0200 |
commit | cfd5d4d8bc31f00dbe60c08dd687c6c770f37118 (patch) | |
tree | 95169de73d1dfea6071fd14ac7f76a3547ed22d8 /doc/man/libkeccak_state_free.3 | |
parent | add libkeccak_state_wipe.3, libkeccak_state_wipe_sponge.3, and libkeccak_state_wipe_message.3 (diff) | |
download | libkeccak-cfd5d4d8bc31f00dbe60c08dd687c6c770f37118.tar.gz libkeccak-cfd5d4d8bc31f00dbe60c08dd687c6c770f37118.tar.bz2 libkeccak-cfd5d4d8bc31f00dbe60c08dd687c6c770f37118.tar.xz |
add libkeccak_state_create.3, libkeccak_state_fast_free.3 and libkeccak_state_free.3
Signed-off-by: Mattias Andrée <maandree@operamail.com>
Diffstat (limited to '')
-rw-r--r-- | doc/man/libkeccak_state_free.3 | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/doc/man/libkeccak_state_free.3 b/doc/man/libkeccak_state_free.3 new file mode 100644 index 0000000..4263149 --- /dev/null +++ b/doc/man/libkeccak_state_free.3 @@ -0,0 +1,50 @@ +.TH LIBKECCAK_STATE_FREE 3 LIBKECCAK-%VERSION% +.SH NAME +libkeccak_state_free - Destroys and deallocates a hash state with erasure +.SH SYNOPSIS +.LP +.nf +#include <libkeccak.h> +.P +void libkeccak_state_free(libkeccak_state_t *\fIstate\fP); +.fi +.P +Link with \fI-lkeccak\fP. +.SH DESCRIPTION +The +.BR libkeccak_state_free () +function releases the allocations stored in \fI*state\fP, +and also release the allocation of \fIstate\fP. +.PP +The +.BR libkeccak_state_free () +function securely erases sensitive data. +.SH RETURN VALUES +The +.BR libkeccak_state_free () +function does not return any value. +.SH ERRORS +The +.BR libkeccak_state_free () +function cannot fail. +.SH NOTES +A double call to +.BR libkeccak_state_free () +will either result in a double free, +which is must likely to crash the process, +or free an allocation (that was created +between the calls) that was not intended +to be freed, resulting in undefined behaviour. +.SH SEE ALSO +.BR libkeccak_state_destroy (3), +.BR libkeccak_state_fast_free (3), +.BR libkeccak_state_create (3), +.BR libkeccak_state_initialise (3), +.BR libkeccak_state_reset (3), +.BR libkeccak_state_wipe (3) +.SH AUTHORS +Principal author, Mattias Andrée. See the LICENSE file for the full +list of authors. +.SH BUGS +Please report bugs to https://github.com/maandree/libkeccak/issues or to +maandree@member.fsf.org |