diff options
Diffstat (limited to 'libar2simplified_recommendation.3')
| -rw-r--r-- | libar2simplified_recommendation.3 | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/libar2simplified_recommendation.3 b/libar2simplified_recommendation.3 new file mode 100644 index 0000000..842af40 --- /dev/null +++ b/libar2simplified_recommendation.3 @@ -0,0 +1,50 @@ +.TH LIBAR2SIMPLIFIED_RECOMMENDATION 3 LIBAR2SIMPLIFIED +.SH NAME +libar2simplified_recommendation - Get recommended hashing parameters + +.SH SYNOPSIS +.nf +#include <libar2simplified.h> + +const char *libar2simplified_recommendation(int \fIside_channel_free\fP); +.fi +.PP +Link with +.IR "-lar2simplified" . + +.SH DESCRIPTION +The +.BR libar2simplified_recommendation () +function returns a hashing parameter string +that can be used as input to the +.BR libar2simplified_crypt (3) +and +.BR libar2simplified_decode (3) +functions. +.PP +.I side_channel_free +shall be 1 if you know that the environment +is safe enought against side-channel attacks, +otherwise it shall be 0. +.PP +The output parameters are just so you have +something to start with, they shall not be taken +too seriously, and should be tween to your +requirements. + +.SH RETURN VALUES +The +.BR libar2simplified_recommendation () +function returns a statically allocated, +read-only, hashing parameter string. + +.SH ERRORS +The +.BR libar2simplified_recommendation () +function cannot fail. + +.SH SEE ALSO +.BR libar2simplified (7), +.BR libar2simplified_crypt (3), +.BR libar2simplified_decode (3), +.BR libar2_hash (3) |