NAME

       libcanlock - Create Cancel-Key

SYNOPSIS

       #include <libcanlock-3/canlock.h>

       int cl_verify(cl_hash_version hash,
                     const char *c_key, const char *c_lock);

       Supported values for hash (by version 3.0.0 of libcanlock):
       CL_SHA1 CL_SHA224 CL_SHA256 CL_SHA384 CL_SHA512

DESCRIPTION

       The  cl_verify()  function  checks  whether a <c-key-string> and a <c-lock-string> element
       according to RFC8315 matches or not.

       The hash algorithm for <scheme> is selected with hash.

       The <c-key-string> element is specified with c_key and the  <c-lock-string>  element  with
       c_lock

RETURN VALUE

       Upon successful completion zero is returned.
       All other values indicate an error.

AUTHORS

       Dennis Preiser
       (Based in part on the implementation from G. J. Andruk for Version 2)

       The  base64  implementation  is written by Kungliga Tekniska Hogskolan (Royal Institute of
       Technology, Stockholm, Sweden)

       The hash algorithms are implemented with code from RFC6234

REPORTING BUGS

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

STANDARDS

       libcanlock tries to comply with the following standards:

       RFC5537, RFC6234, RFC8315

SEE ALSO

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