aboutsummaryrefslogtreecommitdiffstats
path: root/man3/libkeccak_fast_digest.3
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2019-02-10 23:19:58 +0100
committerMattias Andrée <maandree@kth.se>2019-02-10 23:19:58 +0100
commitc461a856bc3bca4b1190cf46a1d8a4f401f79b5c (patch)
treedae918632e8bfc1f3d0c23f00a23e7c2e68db4ef /man3/libkeccak_fast_digest.3
parentAdd test from github issue #10 (diff)
downloadlibkeccak-c461a856bc3bca4b1190cf46a1d8a4f401f79b5c.tar.gz
libkeccak-c461a856bc3bca4b1190cf46a1d8a4f401f79b5c.tar.bz2
libkeccak-c461a856bc3bca4b1190cf46a1d8a4f401f79b5c.tar.xz
General API improvements
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'man3/libkeccak_fast_digest.3')
-rw-r--r--man3/libkeccak_fast_digest.341
1 files changed, 18 insertions, 23 deletions
diff --git a/man3/libkeccak_fast_digest.3 b/man3/libkeccak_fast_digest.3
index d5c55a5..9e9c1f3 100644
--- a/man3/libkeccak_fast_digest.3
+++ b/man3/libkeccak_fast_digest.3
@@ -5,11 +5,9 @@ libkeccak_fast_digest - Complete the hashing of a message without erasure
.LP
.nf
#include <libkeccak.h>
-.P
-int
-libkeccak_fast_digest(libkeccak_state_t *\fIstate\fP, const char *\fImsg\fP,
- size_t \fImsglen\fP, size_t \fIbits\fP, const char *\fIsuffix\fP,
- char *\fIhashsum\fP);
+
+int libkeccak_fast_digest(libkeccak_state_t *\fIstate\fP, const void *\fImsg\fP, size_t \fImsglen\fP,
+ size_t \fIbits\fP, const char *\fIsuffix\fP, void *\fIhashsum\fP);
.fi
.P
Link with
@@ -54,7 +52,7 @@ message. If this string is empty,
may be used instead. This is used to select hash algorithm.
For pure Keccak,
.I NULL
-or "" is used. For the other algorithms the constants
+or \(dq\(dq is used. For the other algorithms the constants
.B LIBKECCAK_SHA3_SUFFIX
(for SHA-3),
.B LIBKECCAK_RAWSHAKE_SUFFIX
@@ -98,7 +96,7 @@ function may fail for any reason specified by the function
This example calculates the Keccak[b = 1024, c = 576, n = 256]
hash of the input from stdin, and prints the hash, in hexadecimal
form, to stdout.
-.LP
+.PP
.nf
libkeccak_state_t state;
libkeccak_spec_t spec;
@@ -111,26 +109,26 @@ spec.bitrate = 1024;
spec.capacity = 576;
spec.output = 256;
if (libkeccak_state_initialise(&state, &spec) < 0)
- goto fail;
+ goto fail;
for (;;) {
- len = read(STDIN_FILENO, chunk, sizeof(chunk));
+ len = read(STDIN_FILENO, chunk, sizeof(chunk));
- if ((len < 0) && (errno == EINTR))
- continue;
- if (len < 0)
- goto fail;
- if (len == 0)
- break;
+ if ((len < 0) && (errno == EINTR))
+ continue;
+ if (len < 0)
+ goto fail;
+ if (len == 0)
+ break;
- if (libkeccak_fast_update(&state, chunk, (size_t)len) < 0)
- goto fail;
+ if (libkeccak_fast_update(&state, chunk, (size_t)len) < 0)
+ goto fail;
}
-if (libkeccak_fast_digest(&state, NULL, 0, 0, "", binhash) < 0)
- goto fail;
+if (libkeccak_fast_digest(&state, NULL, 0, 0, \(dq\(dq, binhash) < 0)
+ goto fail;
libkeccak_behex_lower(hexhash, binhash, sizeof(binhash));
-printf("%s\\n", hexhash);
+printf(\(dq%s\en\(dq, hexhash);
libkeccak_state_fast_destroy(&state);
.fi
.SH SEE ALSO
@@ -141,6 +139,3 @@ libkeccak_state_fast_destroy(&state);
.BR libkeccak_simple_squeeze (3),
.BR libkeccak_fast_squeeze (3),
.BR libkeccak_squeeze (3)
-.SH BUGS
-Please report bugs to https://github.com/maandree/libkeccak/issues or to
-maandree@kth.se