Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gnutls_ocsp_resp_verify(3) [centos man page]

gnutls_ocsp_resp_verify(3)					      gnutls						gnutls_ocsp_resp_verify(3)

NAME
gnutls_ocsp_resp_verify - API function SYNOPSIS
#include <gnutls/ocsp.h> int gnutls_ocsp_resp_verify(gnutls_ocsp_resp_t resp, gnutls_x509_trust_list_t trustlist, unsigned int * verify, unsigned int flags); ARGUMENTS
gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure gnutls_x509_trust_list_t trustlist trust anchors as a gnutls_x509_trust_list_t structure unsigned int * verify output variable with verification status, an gnutls_ocsp_cert_status_t unsigned int flags verification flags, 0 for now. DESCRIPTION
Verify signature of the Basic OCSP Response against the public key in the certificate of a trusted signer. The trustlist should be popu- lated with trust anchors. The function will extract the signer certificate from the Basic OCSP Response and will verify it against the trustlist . A trusted signer is a certificate that is either in trustlist , or it is signed directly by a certificate in trustlist and has the id-ad-ocspSigning Extended Key Usage bit set. The output verify variable will hold verification status codes (e.g., GNUTLS_OCSP_VERIFY_SIGNER_NOT_FOUND, GNUTLS_OCSP_VERIFY_INSE- CURE_ALGORITHM) which are only valid if the function returned GNUTLS_E_SUCCESS. Note that the function returns GNUTLS_E_SUCCESS even when verification failed. The caller must always inspect the verify variable to find out the verification status. The flags variable should be 0 for now. RETURNS
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. REPORTING BUGS
Report bugs to <bug-gnutls@gnu.org>. General guidelines for reporting bugs: http://www.gnu.org/gethelp/ GnuTLS home page: http://www.gnu.org/software/gnutls/ COPYRIGHT
Copyright (C) 2012 Free Software Foundation, Inc.. Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. SEE ALSO
The full documentation for gnutls is maintained as a Texinfo manual. If the info and gnutls programs are properly installed at your site, the command info gnutls should give you access to the complete manual. As an alternative you may obtain the manual from: http://www.gnu.org/software/gnutls/manual/ gnutls 3.1.15 gnutls_ocsp_resp_verify(3)

Check Out this Related Man Page

gnutls_ocsp_resp_get_certs(3)					      gnutls					     gnutls_ocsp_resp_get_certs(3)

NAME
gnutls_ocsp_resp_get_certs - API function SYNOPSIS
#include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_certs(gnutls_ocsp_resp_t resp, gnutls_x509_crt_t ** certs, size_t * ncerts); ARGUMENTS
gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure gnutls_x509_crt_t ** certs newly allocated array with gnutls_x509_crt_t certificates size_t * ncerts output variable with number of allocated certs. DESCRIPTION
This function will extract the X.509 certificates found in the Basic OCSP Response. The certs output variable will hold a newly allocated zero-terminated array with X.509 certificates. Every certificate in the array needs to be de-allocated with gnutls_x509_crt_deinit() and the array itself must be freed using gnutls_free(). Both the certs and ncerts variables may be NULL. Then the function will work as normal but will not return the NULL:d information. This can be used to get the number of certificates only, or to just get the certificate array without its size. RETURNS
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. REPORTING BUGS
Report bugs to <bug-gnutls@gnu.org>. General guidelines for reporting bugs: http://www.gnu.org/gethelp/ GnuTLS home page: http://www.gnu.org/software/gnutls/ COPYRIGHT
Copyright (C) 2012 Free Software Foundation, Inc.. Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. SEE ALSO
The full documentation for gnutls is maintained as a Texinfo manual. If the info and gnutls programs are properly installed at your site, the command info gnutls should give you access to the complete manual. As an alternative you may obtain the manual from: http://www.gnu.org/software/gnutls/manual/ gnutls 3.1.15 gnutls_ocsp_resp_get_certs(3)
Man Page