NAME¶
gnutls_x509_dn_get_rdn_ava - API function
SYNOPSIS¶
#include <gnutls/x509.h>
int gnutls_x509_dn_get_rdn_ava(gnutls_x509_dn_t dn, int
irdn, int iava, gnutls_x509_ava_st *
ava);
ARGUMENTS¶
- gnutls_x509_dn_t dn
- a pointer to DN
- int irdn
- index of RDN
- int iava
- index of AVA.
- gnutls_x509_ava_st * ava
- Pointer to structure which will hold output information.
DESCRIPTION¶
Get pointers to data within the DN. The format of the
ava structure is
shown below.
struct gnutls_x509_ava_st { gnutls_datum_t oid; gnutls_datum_t value; unsigned
long value_tag; };
The X.509 distinguished name is a sequence of sequences of strings and this is
what the
irdn and
iava indexes model.
Note that
ava will contain pointers into the
dn structure which in
turns points to the original certificate. Thus you should not modify any data
or deallocate any of those.
This is a low-level function that requires the caller to do the value
conversions when necessary (e.g. from UCS-2).
RETURNS¶
Returns 0 on success, or an error code.
REPORTING BUGS¶
Report bugs to <bugs@gnutls.org>.
Home page:
http://www.gnutls.org
COPYRIGHT¶
Copyright © 2001-2014 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 /usr/share/doc/gnutls/ directory does not contain the HTML form visit
- http://www.gnutls.org/manual/