Tizen 2.0 Release
[external/libgnutls26.git] / doc / manpages / gnutls_pubkey_verify_hash.3
1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
2 .TH "gnutls_pubkey_verify_hash" 3 "2.12.6.1" "gnutls" "gnutls"
3 .SH NAME
4 gnutls_pubkey_verify_hash \- API function
5 .SH SYNOPSIS
6 .B #include <gnutls/gnutls.h>
7 .sp
8 .BI "int gnutls_pubkey_verify_hash(gnutls_pubkey_t " key ", unsigned int " flags ", const gnutls_datum_t * " hash ", const gnutls_datum_t * " signature ");"
9 .SH ARGUMENTS
10 .IP "gnutls_pubkey_t key" 12
11 Holds the certificate
12 .IP "unsigned int flags" 12
13 should be 0 for now
14 .IP "const gnutls_datum_t * hash" 12
15 holds the hash digest to be verified
16 .IP "const gnutls_datum_t * signature" 12
17 contains the signature
18 .SH "DESCRIPTION"
19 This function will verify the given signed digest, using the
20 parameters from the certificate.
21 .SH "RETURNS"
22 In case of a verification failure \fBGNUTLS_E_PK_SIG_VERIFY_FAILED\fP 
23 is returned, and a positive code on success.
24 .SH "REPORTING BUGS"
25 Report bugs to <bug-gnutls@gnu.org>.
26 GnuTLS home page: http://www.gnu.org/software/gnutls/
27 General help using GNU software: http://www.gnu.org/gethelp/
28 .SH COPYRIGHT
29 Copyright \(co 2008 Free Software Foundation.
30 .br
31 Copying and distribution of this file, with or without modification,
32 are permitted in any medium without royalty provided the copyright
33 notice and this notice are preserved.
34 .SH "SEE ALSO"
35 The full documentation for
36 .B gnutls
37 is maintained as a Texinfo manual.  If the
38 .B info
39 and
40 .B gnutls
41 programs are properly installed at your site, the command
42 .IP
43 .B info gnutls
44 .PP
45 should give you access to the complete manual.