diff options
Diffstat (limited to 'doc/man/libkeccak_update.3')
| -rw-r--r-- | doc/man/libkeccak_update.3 | 41 |
1 files changed, 40 insertions, 1 deletions
diff --git a/doc/man/libkeccak_update.3 b/doc/man/libkeccak_update.3 index dee71ce..52950c2 100644 --- a/doc/man/libkeccak_update.3 +++ b/doc/man/libkeccak_update.3 @@ -34,8 +34,47 @@ The .BR libkeccak_update () function may fail for any reason specified by the function .BR malloc (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_update(&state, chunk, (size_t)len) < 0) + goto fail; +} +if (libkeccak_digest(&state, NULL, 0, 0, "", binhash) < 0) + goto fail; + +libkeccak_behex_lower(hexhash, binhash, sizeof(binhash)); +printf("%s\\n", hexhash); +libkeccak_state_destroy(&state); +.fi .SH SEE ALSO .BR libkeccak_state_initialise (3), .BR libkeccak_fast_update (3), |