Blame doc/functions/gnutls_pkcs11_get_raw_issuer_by_dn

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_pkcs11_get_raw_issuer_by_dn} (const char * @var{url}, const gnutls_datum_t * @var{dn}, gnutls_datum_t * @var{issuer}, gnutls_x509_crt_fmt_t @var{fmt}, unsigned int @var{flags})
Packit Service 4684c1
@var{url}: A PKCS 11 url identifying a token
Packit Service 4684c1
Packit Service 4684c1
@var{dn}: is the DN to search for
Packit Service 4684c1
Packit Service 4684c1
@var{issuer}: Will hold the issuer if any in an allocated buffer.
Packit Service 4684c1
Packit Service 4684c1
@var{fmt}: The format of the exported issuer.
Packit Service 4684c1
Packit Service 4684c1
@var{flags}: Use zero or flags from @code{GNUTLS_PKCS11_OBJ_FLAG} .
Packit Service 4684c1
Packit Service 4684c1
This function will return the certificate with the given DN, if it
Packit Service 4684c1
is stored in the token. By default only marked as trusted issuers
Packit Service 4684c1
are returned. If any issuer should be returned specify
Packit Service 4684c1
@code{GNUTLS_PKCS11_OBJ_FLAG_RETRIEVE_ANY}  in  @code{flags} .
Packit Service 4684c1
Packit Service 4684c1
The name of the function includes issuer because it can
Packit Service 4684c1
be used to discover issuers of certificates.
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.4.0
Packit Service 4684c1
@end deftypefun