From d77ab463184d113ca6119403887c9f4ed0dfdf0b Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sun, 26 Apr 2026 22:36:47 +0200 Subject: First commit MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- librecrypt_chain_length.3 | 69 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 librecrypt_chain_length.3 (limited to 'librecrypt_chain_length.3') diff --git a/librecrypt_chain_length.3 b/librecrypt_chain_length.3 new file mode 100644 index 0000000..eb0b1cc --- /dev/null +++ b/librecrypt_chain_length.3 @@ -0,0 +1,69 @@ +.TH LIBRECRYPT_CHAIN_LENGTH 3 LIBRECRYPT +.SH NAME +librecrypt_chain_length - Get number of algorithms in a chained password hash string + +.SH SYNOPSIS +.nf +#include + +size_t \fBlibrecrypt_chain_length\fP(const char *\fIhash\fP); +.fi +.PP +Link with +.IR -lrecrypt . + +.SH DESCRIPTION +The +.BR librecrypt_chain_length () +function returns the number of hash algorithms +specified in the chain contained in +.IR hash . +Algorithms are delimited by +.I LIBRECRYPT_ALGORITHM_LINK_DELIMITER +(which is +.BR "\(aq>\(aq" ). +.PP +.I hash +must not be +.IR NULL . + +.SH RETURN VALUES +The +.BR librecrypt_chain_length () +function returns the number of chained hash algorithms. +The return value is always non-zero. + +.SH ERRORS +The +.BR librecrypt_chain_length () +function cannot fail. + +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.PP +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR librecrypt_chain_length () +T} Thread safety MT-Safe +T{ +.BR librecrypt_chain_length () +T} Async-signal safety AS-Safe +.TE +.sp + +.SH HISTORY +The +.BR librecrypt_chain_length () +function was introduced in version 1.0 of +.BR librecrypt . + +.SH SEE ALSO +.BR librecrypt (7), +.BR librecrypt_decompose_chain (3), +.BR librecrypt_decompose_chain1 (3), +.BR librecrypt_next_algorithm (3) -- cgit v1.2.3-70-g09d2