From 4722e1f0a440c223efb269c7dbdeb6bc56a5932d Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 7 Oct 2015 02:37:04 +0200 Subject: stylo + example in libkeccak_digest.3, libkeccak_fast_digest.3, libkeccak_fast_update.3, and libkeccak_update.3 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- doc/man/libkeccak_fast_update.3 | 41 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 40 insertions(+), 1 deletion(-) (limited to 'doc/man/libkeccak_fast_update.3') diff --git a/doc/man/libkeccak_fast_update.3 b/doc/man/libkeccak_fast_update.3 index fb52f45..7f9ee07 100644 --- a/doc/man/libkeccak_fast_update.3 +++ b/doc/man/libkeccak_fast_update.3 @@ -35,8 +35,47 @@ The .BR libkeccak_fast_update () function may fail for any reason specified by the function .BR realloc (3). -.SH Notes +.SH NOTES Neither parameter by be \fINULL\fP or 0. +.SH EXAMPLE +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 +.nf +libkeccak_state_t state; +libkeccak_spec_t spec; +char binhash[256 / 8]; +char hexhash[256 / 8 * 2 + 1]; +char chunk[4 << 10]; +ssize_t len; + +spec.bitrate = 1024; +spec.capacity = 576; +spec.output = 256; +if (libkeccak_state_initialise(&state, &spec) < 0) + goto fail; + +for (;;) { + len = read(STDIN_FILENO, chunk, sizeof(chunk)); + + 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_digest(&state, NULL, 0, 0, "", binhash) < 0) + goto fail; + +libkeccak_behex_lower(hexhash, binhash, sizeof(binhash)); +printf("%s\\n", hexhash); +libkeccak_state_fast_destroy(&state); +.fi .SH SEE ALSO .BR libkeccak_state_initialise (3), .BR libkeccak_update (3), -- cgit v1.2.3-70-g09d2