Blame doc/functions/gnutls_certificate_get_issuer

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_certificate_get_issuer} (gnutls_certificate_credentials_t @var{sc}, gnutls_x509_crt_t @var{cert}, gnutls_x509_crt_t * @var{issuer}, unsigned int @var{flags})
Packit Service 4684c1
@var{sc}: is a @code{gnutls_certificate_credentials_t}  type.
Packit Service 4684c1
Packit Service 4684c1
@var{cert}: is the certificate to find issuer for
Packit Service 4684c1
Packit Service 4684c1
@var{issuer}: Will hold the issuer if any. Should be treated as constant.
Packit Service 4684c1
Packit Service 4684c1
@var{flags}: Use zero or @code{GNUTLS_TL_GET_COPY} 
Packit Service 4684c1
Packit Service 4684c1
This function will return the issuer of a given certificate.
Packit Service 4684c1
If the flag @code{GNUTLS_TL_GET_COPY}  is specified a copy of the issuer
Packit Service 4684c1
will be returned which must be freed using @code{gnutls_x509_crt_deinit()} .
Packit Service 4684c1
In that case the provided  @code{issuer} must not be initialized.
Packit Service 4684c1
Packit Service 4684c1
As with @code{gnutls_x509_trust_list_get_issuer()}  this function requires
Packit Service 4684c1
the @code{GNUTLS_TL_GET_COPY}  flag in order to operate with PKCS@code{11}  trust
Packit Service 4684c1
lists in a thread-safe way.
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
Packit Service 4684c1
negative error value.
Packit Service 4684c1
Packit Service 4684c1
@strong{Since:} 3.0
Packit Service 4684c1
@end deftypefun