aboutsummaryrefslogtreecommitdiffstats
path: root/librecrypt_hash_binary.3
diff options
context:
space:
mode:
authorMattias Andrée <m@maandree.se>2026-05-20 23:04:11 +0200
committerMattias Andrée <m@maandree.se>2026-05-20 23:04:11 +0200
commitc35b47228f5494f4d806e9166628110af6dd2469 (patch)
tree3b5a123af999a5e047b8565efee293a5d95c3f6c /librecrypt_hash_binary.3
parentPrepare for supporting custom algorithms (diff)
downloadlibrecrypt-c35b47228f5494f4d806e9166628110af6dd2469.tar.gz
librecrypt-c35b47228f5494f4d806e9166628110af6dd2469.tar.bz2
librecrypt-c35b47228f5494f4d806e9166628110af6dd2469.tar.xz
Add (so far untested and undocument) support for pepperHEADmaster
Signed-off-by: Mattias Andrée <m@maandree.se>
Diffstat (limited to 'librecrypt_hash_binary.3')
-rw-r--r--librecrypt_hash_binary.334
1 files changed, 25 insertions, 9 deletions
diff --git a/librecrypt_hash_binary.3 b/librecrypt_hash_binary.3
index 759bfd7..9956f83 100644
--- a/librecrypt_hash_binary.3
+++ b/librecrypt_hash_binary.3
@@ -8,7 +8,7 @@ librecrypt_hash_binary - Compute password hash in raw binary form
ssize_t \fBlibrecrypt_hash_binary\fP(void *restrict \fIout_buffer\fP, size_t \fIsize\fP,
const char *\fIphrase\fP, size_t \fIlen\fP,
- const char *\fIsettings\fP, void *\fIreserved\fP);
+ const char *\fIsettings\fP, LIBRECRYPT_CONTEXT *\fIctx\fP);
.fi
.PP
Link with
@@ -39,9 +39,13 @@ uses asterisk-encoding to specify random salts,
the function fails.
.PP
The
-.I reserved
-parameter is reserved for future use and should be
-.IR NULL .
+.I ctx
+parameter is used for providing library
+configurations, see
+.BR librecrypt_create_context (3)
+for more information; used
+.I NULL
+for default configurations.
.PP
On successful completion, up to
.I size
@@ -83,11 +87,6 @@ The
function will fail if:
.TP
.B EINVAL
-.I reserved
-is not
-.IR NULL .
-.TP
-.B EINVAL
.I settings
is invalid.
.TP
@@ -143,6 +142,23 @@ to
in version 1.1 of
.BR librecrypt .
+Since version 1.1 of the
+.BR librecrypt_bash_binary ()
+function, the
+.I ctx
+parameter (previously called
+.IR reserved )
+has the type
+.B LIBRECRYPT_CONTEXT *
+(previously
+.BR "void *" ),
+and setting it to
+.RI non- NULL
+no longer causes failure with
+.I errno
+set to
+.IR EINVAL .
+
.SH SEE ALSO
.BR librecrypt (7),
.BR librecrypt_hash (3),