gnutls_x509_dn_get_rdn_ava(3)      gnutls      gnutls_x509_dn_get_rdn_ava(3)

NAME         top

       gnutls_x509_dn_get_rdn_ava - API function

SYNOPSIS         top

       #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         top

       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         top

       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         top

       Returns 0 on success, or an error code.

REPORTING BUGS         top

       Report bugs to <>.
       Home page:

COPYRIGHT         top

       Copyright © 2001-2018 Free Software Foundation, Inc., and others.
       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         top

       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 

COLOPHON         top

       This page is part of the GnuTLS (GnuTLS Transport Layer Security
       Library) project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this manual
       page, send it to  This page was obtained from the
       tarball gnutls-3.6.2.tar.xz fetched from
       ⟨⟩ on 2018-04-30.  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

gnutls                              3.6.2      gnutls_x509_dn_get_rdn_ava(3)