1gnutls_x509_crq_get_dn_by_oid(3)    gnutls    gnutls_x509_crq_get_dn_by_oid(3)
2
3
4

NAME

6       gnutls_x509_crq_get_dn_by_oid - API function
7

SYNOPSIS

9       #include <gnutls/x509.h>
10
11       int  gnutls_x509_crq_get_dn_by_oid(gnutls_x509_crq_t  crq, const char *
12       oid, unsigned indx,  unsigned  int  raw_flag,  void  *  buf,  size_t  *
13       buf_size);
14

ARGUMENTS

16       gnutls_x509_crq_t crq
17                   should contain a gnutls_x509_crq_t type
18
19       const char * oid
20                   holds an Object Identifier in a null terminated string
21
22       unsigned indx
23                   In case multiple same OIDs exist in the RDN, this specifies
24                   which to get. Use (0) to get the first one.
25
26       unsigned int raw_flag
27                   If non-zero returns the raw DER data of the DN part.
28
29       void * buf  a pointer to a structure to hold the name (may be NULL)
30
31       size_t * buf_size
32                   initially holds the size of  buf
33

DESCRIPTION

35       This function will extract the part of  the  name  of  the  Certificate
36       request subject, specified by the given OID. The output will be encoded
37       as described in RFC2253. The output  string  will  be  ASCII  or  UTF-8
38       encoded, depending on the certificate data.
39
40       Some  helper  macros with popular OIDs can be found in gnutls/x509.h If
41       raw flag is (0), this function will only return  known  OIDs  as  text.
42       Other  OIDs will be DER encoded, as described in RFC2253 -- in hex for‐
43       mat with a 'using gnutls_x509_dn_oid_known().
44

RETURNS

46       GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not long enough,
47       and in that case the * buf_size will be updated with the required size.
48       On success 0 is returned.
49

REPORTING BUGS

51       Report bugs to <bugs@gnutls.org>.
52       Home page: https://www.gnutls.org
53
54
56       Copyright © 2001-2020 Free Software Foundation, Inc., and others.
57       Copying and distribution of this file, with  or  without  modification,
58       are  permitted  in  any  medium  without royalty provided the copyright
59       notice and this notice are preserved.
60

SEE ALSO

62       The full documentation for gnutls is maintained as  a  Texinfo  manual.
63       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
64       visit
65
66       https://www.gnutls.org/manual/
67
68gnutls                              3.6.13    gnutls_x509_crq_get_dn_by_oid(3)
Impressum