focal (3) cl_verify.3.gz

Provided by: libcanlock-dev_3.1.0-1_amd64 bug

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)