aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man/libkeccak_spec_check.3
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2017-10-14 01:01:14 +0200
committerMattias Andrée <maandree@kth.se>2017-10-14 01:01:14 +0200
commit3e1864aa14a33a3c917537a241f6a032cfcacf78 (patch)
tree25297b1363fa88c9f45b5102afa5e95d08e986c1 /doc/man/libkeccak_spec_check.3
parentChange style and license (diff)
downloadlibkeccak-3e1864aa14a33a3c917537a241f6a032cfcacf78.tar.gz
libkeccak-3e1864aa14a33a3c917537a241f6a032cfcacf78.tar.bz2
libkeccak-3e1864aa14a33a3c917537a241f6a032cfcacf78.tar.xz
General improvements
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'doc/man/libkeccak_spec_check.3')
-rw-r--r--doc/man/libkeccak_spec_check.395
1 files changed, 0 insertions, 95 deletions
diff --git a/doc/man/libkeccak_spec_check.3 b/doc/man/libkeccak_spec_check.3
deleted file mode 100644
index 9fc70f6..0000000
--- a/doc/man/libkeccak_spec_check.3
+++ /dev/null
@@ -1,95 +0,0 @@
-.TH LIBKECCAK_SPEC_CHECK 3 LIBKECCAK
-.SH NAME
-libkeccak_spec_check - Validate hashing parameters
-.SH SYNOPSIS
-.LP
-.nf
-#include <libkeccak.h>
-.P
-int
-libkeccak_spec_check(const libkeccak_spec_t *\fIspec\fP);
-.fi
-.P
-Link with
-.IR -lkeccak .
-.SH DESCRIPTION
-The
-.BR libkeccak_spec_check ()
-function validates the parameters of
-.IR *spec ,
-so that unusable configurations can be detected.
-It is recommended to call this function after calling
-.BR libkeccak_spec_sha3 (3),
-.BR libkeccak_spec_rawshake (3),
-.BR libkeccak_spec_shake (3),
-or, especially, after settings the parameters
-manually for Keccak hashing.
-.PP
-.nf
-typedef struct libkeccak_spec {
- long int bitrate; /* bitrate (in bits) */
- long int capacity; /* capacity (in bits) */
- long int output; /* output size (in bits) */
-} libkeccak_spec_t;
-.fi
-.SH RETURN VALUES
-The
-.BR libkeccak_spec_check ()
-function returns 0 if the settings are usable. Otherwise
-it will return one of the following constants.
-.PP
-.TP
-.B LIBKECCAK_SPEC_ERROR_BITRATE_NONPOSITIVE
-The specified bitrate was non-positive.
-.TP
-.B LIBKECCAK_SPEC_ERROR_BITRATE_MOD_8
-The specified bitrate was not equivalent to 0
-modulus 8, that is, it was not in whole bytes.
-.TP
-.B LIBKECCAK_SPEC_ERROR_CAPACITY_NONPOSITIVE
-The specified capacity was non-positive.
-.TP
-.B LIBKECCAK_SPEC_ERROR_CAPACITY_MOD_8
-The specified capacity was not equivalent to 0
-modulus 8, that is, it was not in whole bytes.
-.TP
-.B LIBKECCAK_SPEC_ERROR_OUTPUT_NONPOSITIVE
-The specified output size was non-positive.
-.TP
-.B LIBKECCAK_SPEC_ERROR_STATE_TOO_LARGE
-The state size, that is the sum of the bitrate
-and the capacity, exceeded the supported limit
-(currently at 1600 bits.)
-.TP
-.B LIBKECCAK_SPEC_ERROR_STATE_MOD_25
-The state size, that is the sum of the bitrate
-and the capacity, in bits, was not equivalent
-to 0 modulus 25. Meaning the state size cannot
-cover all lanes equivalently.
-.TP
-.B LIBKECCAK_SPEC_ERROR_WORD_NON_2_POTENT
-The word size, that is the state size divided
-by 25, is not a power of 2.
-.TP
-.B LIBKECCAK_SPEC_ERROR_WORD_MOD_8
-The word size, that is the state size divided
-by 25, is not quivalent to 0 modulus 8, that
-is, it is not in whole bytes.
-.PP
-Note that there may be more than one error. Only the first
-detected is returned.
-.SH ERRORS
-The
-.BR libkeccak_spec_check ()
-function cannot fail.
-.fi
-.SH SEE ALSO
-.BR libkeccak_spec_sha3 (3),
-.BR libkeccak_spec_rawshake (3),
-.BR libkeccak_spec_shake (3),
-.BR libkeccak_generalised_spec_initialise (3),
-.BR libkeccak_state_initialise (3),
-.BR libkeccak_hmac_initialise (3)
-.SH BUGS
-Please report bugs to https://github.com/maandree/libkeccak/issues or to
-maandree@kth.se