|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@deftypefun {int} {gnutls_x509_crt_get_issuer_alt_name} (gnutls_x509_crt_t @var{cert}, unsigned int @var{seq}, void * @var{ian}, size_t * @var{ian_size}, unsigned int * @var{critical})
|
|
Packit Service |
4684c1 |
@var{cert}: should contain a @code{gnutls_x509_crt_t} type
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{seq}: specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.)
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{ian}: is the place where the alternative name will be copied to
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{ian_size}: holds the size of ian.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{critical}: will be non-zero if the extension is marked as critical (may be null)
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
This function retrieves the Issuer Alternative Name (2.5.29.18),
|
|
Packit Service |
4684c1 |
contained in the given certificate in the X509v3 Certificate
|
|
Packit Service |
4684c1 |
Extensions.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
When the SAN type is otherName, it will extract the data in the
|
|
Packit Service |
4684c1 |
otherName's value field, and @code{GNUTLS_SAN_OTHERNAME} is returned.
|
|
Packit Service |
4684c1 |
You may use @code{gnutls_x509_crt_get_subject_alt_othername_oid()} to get
|
|
Packit Service |
4684c1 |
the corresponding OID and the "virtual" SAN types (e.g.,
|
|
Packit Service |
4684c1 |
@code{GNUTLS_SAN_OTHERNAME_XMPP} ).
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
If an otherName OID is known, the data will be decoded. Otherwise
|
|
Packit Service |
4684c1 |
the returned data will be DER encoded, and you will have to decode
|
|
Packit Service |
4684c1 |
it yourself. Currently, only the RFC 3920 id-on-xmppAddr Issuer
|
|
Packit Service |
4684c1 |
AltName is recognized.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@strong{Returns:} the alternative issuer name type on success, one of the
|
|
Packit Service |
4684c1 |
enumerated @code{gnutls_x509_subject_alt_name_t} . It will return
|
|
Packit Service |
4684c1 |
@code{GNUTLS_E_SHORT_MEMORY_BUFFER} if @code{ian_size} is not large enough
|
|
Packit Service |
4684c1 |
to hold the value. In that case @code{ian_size} will be updated with
|
|
Packit Service |
4684c1 |
the required size. If the certificate does not have an
|
|
Packit Service |
4684c1 |
Alternative name with the specified sequence number then
|
|
Packit Service |
4684c1 |
@code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE} is returned.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@strong{Since:} 2.10.0
|
|
Packit Service |
4684c1 |
@end deftypefun
|