gnutls_x509_rdn_get_by_oid(3)

1gnutls_x509_rdn_get_by_oid(3)       gnutls       gnutls_x509_rdn_get_by_oid(3)
2
3
4

NAME

6       gnutls_x509_rdn_get_by_oid - API function
7

SYNOPSIS

9       #include <gnutls/x509.h>
10
11       int gnutls_x509_rdn_get_by_oid(const gnutls_datum_t * idn, const char *
12       oid, int indx, unsigned int raw_flag, void * buf, size_t * sizeof_buf);
13

ARGUMENTS

15       const gnutls_datum_t * idn
16                   should contain a DER encoded RDN sequence
17
18       const char * oid
19                   an Object Identifier
20
21       int indx    In case multiple same OIDs exist in the RDN indicates which
22                   to send. Use 0 for the first one.
23
24       unsigned int raw_flag
25                   If non zero then the raw DER data are returned.
26
27       void * buf  a pointer to a structure to hold the peer's name
28
29       size_t * sizeof_buf
30                   holds the size of buf
31

DESCRIPTION

33       This  function  will return the name of the given Object identifier, of
34       the RDN sequence.  The name  will  be  encoded  using  the  rules  from
35       RFC2253.
36

RETURNS

38       On success, GNUTLS_E_SUCCESS is returned, or GNUTLS_E_SHORT_MEMORY_BUF‐
39       FER is returned and *sizeof_buf is updated if the  provided  buffer  is
40       not long enough, otherwise a negative error value.
41

REPORTING BUGS

43       Report    bugs    to    <bug-gnutls@gnu.org>.     GnuTLS   home   page:
44       http://www.gnu.org/software/gnutls/ General help  using  GNU  software:
45       http://www.gnu.org/gethelp/
46

COPYRIGHT

48       Copyright © 2008 Free Software Foundation.
49       Copying  and  distribution  of this file, with or without modification,
50       are permitted in any medium  without  royalty  provided  the  copyright
51       notice and this notice are preserved.
52