gnutls_pubkey_verify_hash2(3)

1gnutls_pubkey_verify_hash2(3)       gnutls       gnutls_pubkey_verify_hash2(3)
2
3
4

NAME

6       gnutls_pubkey_verify_hash2 - API function
7

SYNOPSIS

9       #include <gnutls/abstract.h>
10
11       int  gnutls_pubkey_verify_hash2(gnutls_pubkey_t  key, gnutls_sign_algo‐
12       rithm_t algo, unsigned int flags, const gnutls_datum_t  *  hash,  const
13       gnutls_datum_t * signature);
14

ARGUMENTS

16       gnutls_pubkey_t key
17                   Holds the public key
18
19       gnutls_sign_algorithm_t algo
20                   The signature algorithm used
21
22       unsigned int flags
23                   Zero or an OR list of gnutls_certificate_verify_flags
24
25       const gnutls_datum_t * hash
26                   holds the hash digest to be verified
27
28       const gnutls_datum_t * signature
29                   contains the signature
30

DESCRIPTION

32       This function will verify the given signed digest, using the parameters
33       from the public key. Note that unlike gnutls_privkey_sign_hash(),  this
34       function  accepts  a signature algorithm instead of a digest algorithm.
35       You can use gnutls_pk_to_sign() to get the appropriate value.
36

RETURNS

38       In case of  a  verification  failure  GNUTLS_E_PK_SIG_VERIFY_FAILED  is
39       returned,  and  zero or positive code on success. For known to be inse‐
40       cure signatures this function will  return  GNUTLS_E_INSUFFICIENT_SECU‐
41       RITY unless the flag GNUTLS_VERIFY_ALLOW_BROKEN is specified.
42

SINCE

44       3.0
45

REPORTING BUGS

47       Report bugs to <bugs@gnutls.org>.
48       Home page: http://www.gnutls.org
49
50

COPYRIGHT

52       Copyright © 2001-2018 Free Software Foundation, Inc., and others.
53       Copying  and  distribution  of this file, with or without modification,
54       are permitted in any medium  without  royalty  provided  the  copyright
55       notice and this notice are preserved.
56