DOKK / manpages / debian 11 / libcanlock-dev / cl_split.3.en
libcanlock(3) libcanlock 3.2.2 manual libcanlock(3)

libcanlock - Split Cancel-Key or Cancel-Lock

#include <libcanlock-3/canlock.h>

cl_hash_version cl_split(char *input, char **klstring);

Possible return values (by version 3.0.0 of libcanlock):
CL_INVALID CL_SHA1 CL_SHA224 CL_SHA256 CL_SHA384 CL_SHA512

The cl_split() function splits a <c-key> or <c-lock> element according to RFC8315.

The hash algorithm for <scheme> is extracted and the corresponding ID is returned. If the hash algorithm is not found or not supported, CL_INVALID is returned.

A pointer to the <c-key-string> or <c-lock-string> element respectively is written to klstring on success (points inside the string input and therefore no additional memory is allocated).
NULL is written to klstring on error.

Hash algorithm ID (CL_INVALID on error).

Michael Baeuerle
(Based in part on lock_strip_alpha() written by G. J. Andruk for Version 2)

Report bugs to <mailto:michael.baeuerle@gmx.net>.

libcanlock tries to comply with the following standards:

RFC5537, RFC6234, RFC8315

cl_clear_secret(3), cl_get_key(3), cl_get_lock(3), cl_verify(3), canlock(1)

2021-01-07 Unix