|
Packit Service |
4684c1 |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
4684c1 |
.TH "gnutls_ocsp_resp_get_single" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit Service |
4684c1 |
.SH NAME
|
|
Packit Service |
4684c1 |
gnutls_ocsp_resp_get_single \- API function
|
|
Packit Service |
4684c1 |
.SH SYNOPSIS
|
|
Packit Service |
4684c1 |
.B #include <gnutls/ocsp.h>
|
|
Packit Service |
4684c1 |
.sp
|
|
Packit Service |
4684c1 |
.BI "int gnutls_ocsp_resp_get_single(gnutls_ocsp_resp_const_t " resp ", unsigned " indx ", gnutls_digest_algorithm_t * " digest ", gnutls_datum_t * " issuer_name_hash ", gnutls_datum_t * " issuer_key_hash ", gnutls_datum_t * " serial_number ", unsigned int * " cert_status ", time_t * " this_update ", time_t * " next_update ", time_t * " revocation_time ", unsigned int * " revocation_reason ");"
|
|
Packit Service |
4684c1 |
.SH ARGUMENTS
|
|
Packit Service |
4684c1 |
.IP "gnutls_ocsp_resp_const_t resp" 12
|
|
Packit Service |
4684c1 |
should contain a \fBgnutls_ocsp_resp_t\fP type
|
|
Packit Service |
4684c1 |
.IP "unsigned indx" 12
|
|
Packit Service |
4684c1 |
Specifies response number to get. Use (0) to get the first one.
|
|
Packit Service |
4684c1 |
.IP "gnutls_digest_algorithm_t * digest" 12
|
|
Packit Service |
4684c1 |
output variable with \fBgnutls_digest_algorithm_t\fP hash algorithm
|
|
Packit Service |
4684c1 |
.IP "gnutls_datum_t * issuer_name_hash" 12
|
|
Packit Service |
4684c1 |
output buffer with hash of issuer's DN
|
|
Packit Service |
4684c1 |
.IP "gnutls_datum_t * issuer_key_hash" 12
|
|
Packit Service |
4684c1 |
output buffer with hash of issuer's public key
|
|
Packit Service |
4684c1 |
.IP "gnutls_datum_t * serial_number" 12
|
|
Packit Service |
4684c1 |
output buffer with serial number of certificate to check
|
|
Packit Service |
4684c1 |
.IP "unsigned int * cert_status" 12
|
|
Packit Service |
4684c1 |
a certificate status, a \fBgnutls_ocsp_cert_status_t\fP enum.
|
|
Packit Service |
4684c1 |
.IP "time_t * this_update" 12
|
|
Packit Service |
4684c1 |
time at which the status is known to be correct.
|
|
Packit Service |
4684c1 |
.IP "time_t * next_update" 12
|
|
Packit Service |
4684c1 |
when newer information will be available, or (time_t)\-1 if unspecified
|
|
Packit Service |
4684c1 |
.IP "time_t * revocation_time" 12
|
|
Packit Service |
4684c1 |
when \fIcert_status\fP is \fBGNUTLS_OCSP_CERT_REVOKED\fP, holds time of revocation.
|
|
Packit Service |
4684c1 |
.IP "unsigned int * revocation_reason" 12
|
|
Packit Service |
4684c1 |
revocation reason, a \fBgnutls_x509_crl_reason_t\fP enum.
|
|
Packit Service |
4684c1 |
.SH "DESCRIPTION"
|
|
Packit Service |
4684c1 |
This function will return the certificate information of the
|
|
Packit Service |
4684c1 |
\fIindx\fP 'ed response in the Basic OCSP Response \fIresp\fP . The
|
|
Packit Service |
4684c1 |
information returned corresponds to the OCSP SingleResponse structure
|
|
Packit Service |
4684c1 |
except the final singleExtensions.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
Each of the pointers to output variables may be NULL to indicate
|
|
Packit Service |
4684c1 |
that the caller is not interested in that value.
|
|
Packit Service |
4684c1 |
.SH "RETURNS"
|
|
Packit Service |
4684c1 |
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
|
|
Packit Service |
4684c1 |
negative error code is returned. If you have reached the last
|
|
Packit Service |
4684c1 |
CertID available \fBGNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE\fP will be
|
|
Packit Service |
4684c1 |
returned.
|
|
Packit Service |
4684c1 |
.SH "REPORTING BUGS"
|
|
Packit Service |
4684c1 |
Report bugs to <bugs@gnutls.org>.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Home page: https://www.gnutls.org
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
.SH COPYRIGHT
|
|
Packit Service |
4684c1 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Copying and distribution of this file, with or without modification,
|
|
Packit Service |
4684c1 |
are permitted in any medium without royalty provided the copyright
|
|
Packit Service |
4684c1 |
notice and this notice are preserved.
|
|
Packit Service |
4684c1 |
.SH "SEE ALSO"
|
|
Packit Service |
4684c1 |
The full documentation for
|
|
Packit Service |
4684c1 |
.B gnutls
|
|
Packit Service |
4684c1 |
is maintained as a Texinfo manual.
|
|
Packit Service |
4684c1 |
If the /usr/share/doc/gnutls/
|
|
Packit Service |
4684c1 |
directory does not contain the HTML form visit
|
|
Packit Service |
4684c1 |
.B
|
|
Packit Service |
4684c1 |
.IP https://www.gnutls.org/manual/
|
|
Packit Service |
4684c1 |
.PP
|