Blame doc/manpages/gnutls_pubkey_verify_hash2.3

Packit aea12f
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
Packit Service 991b93
.TH "gnutls_pubkey_verify_hash2" 3 "3.6.14" "gnutls" "gnutls"
Packit aea12f
.SH NAME
Packit aea12f
gnutls_pubkey_verify_hash2 \- API function
Packit aea12f
.SH SYNOPSIS
Packit aea12f
.B #include <gnutls/abstract.h>
Packit aea12f
.sp
Packit aea12f
.BI "int gnutls_pubkey_verify_hash2(gnutls_pubkey_t " key ", gnutls_sign_algorithm_t " algo ", unsigned int " flags ", const gnutls_datum_t * " hash ", const gnutls_datum_t * " signature ");"
Packit aea12f
.SH ARGUMENTS
Packit aea12f
.IP "gnutls_pubkey_t key" 12
Packit aea12f
Holds the public key
Packit aea12f
.IP "gnutls_sign_algorithm_t algo" 12
Packit aea12f
The signature algorithm used
Packit aea12f
.IP "unsigned int flags" 12
Packit aea12f
Zero or an OR list of \fBgnutls_certificate_verify_flags\fP
Packit aea12f
.IP "const gnutls_datum_t * hash" 12
Packit aea12f
holds the hash digest to be verified
Packit aea12f
.IP "const gnutls_datum_t * signature" 12
Packit aea12f
contains the signature
Packit aea12f
.SH "DESCRIPTION"
Packit aea12f
This function will verify the given signed digest, using the
Packit aea12f
parameters from the public key. Note that unlike \fBgnutls_privkey_sign_hash()\fP,
Packit aea12f
this function accepts a signature algorithm instead of a digest algorithm.
Packit aea12f
You can use \fBgnutls_pk_to_sign()\fP to get the appropriate value.
Packit aea12f
.SH "RETURNS"
Packit aea12f
In case of a verification failure \fBGNUTLS_E_PK_SIG_VERIFY_FAILED\fP 
Packit aea12f
is returned, and zero or positive code on success. For known to be insecure
Packit aea12f
signatures this function will return \fBGNUTLS_E_INSUFFICIENT_SECURITY\fP unless
Packit aea12f
the flag \fBGNUTLS_VERIFY_ALLOW_BROKEN\fP is specified.
Packit aea12f
.SH "SINCE"
Packit aea12f
3.0
Packit aea12f
.SH "REPORTING BUGS"
Packit aea12f
Report bugs to <bugs@gnutls.org>.
Packit aea12f
.br
Packit aea12f
Home page: https://www.gnutls.org
Packit aea12f
Packit aea12f
.SH COPYRIGHT
Packit Service 991b93
Copyright \(co 2001- Free Software Foundation, Inc., and others.
Packit aea12f
.br
Packit aea12f
Copying and distribution of this file, with or without modification,
Packit aea12f
are permitted in any medium without royalty provided the copyright
Packit aea12f
notice and this notice are preserved.
Packit aea12f
.SH "SEE ALSO"
Packit aea12f
The full documentation for
Packit aea12f
.B gnutls
Packit aea12f
is maintained as a Texinfo manual.
Packit aea12f
If the /usr/share/doc/gnutls/
Packit aea12f
directory does not contain the HTML form visit
Packit aea12f
.B
Packit aea12f
.IP https://www.gnutls.org/manual/
Packit aea12f
.PP