home | help
libcanlock(3)		     libcanlock 3.3.2 manual		   libcanlock(3)

NAME
     cl_split - Split Cancel-Key or Cancel-Lock with libcanlock

SYNOPSIS
     #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

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

     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 there-
     fore no additional memory is allocated).
     NULL is written to klstring on error.

RETURN VALUE
     Hash algorithm ID (CL_INVALID on error).

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

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

STANDARDS
     libcanlock tries to comply with the following standards:

     RFC 5537, RFC 6234, RFC 8315

SEE ALSO
     cl_clear_secret(3), cl_get_key(3),  cl_get_lock(3),  cl_verify(3),  cl_ver-
     ify_multi(3), canlock(1)

Unix				   2026-06-22			   libcanlock(3)

home | help