plucky (3) gnutls_x509_crq_get_dn.3.gz

Provided by: gnutls-doc_3.8.9-2ubuntu2_all bug

NAME

       gnutls_x509_crq_get_dn - API function

SYNOPSIS

       #include <gnutls/x509.h>

       int gnutls_x509_crq_get_dn(gnutls_x509_crq_t crq, char * buf, size_t * buf_size);

ARGUMENTS

       gnutls_x509_crq_t crq
                   should contain a gnutls_x509_crq_t type

       char * buf  a pointer to a structure to hold the name (may be NULL)

       size_t * buf_size
                   initially holds the size of  buf

DESCRIPTION

       This  function  will  copy  the name of the Certificate request subject to the provided buffer.  The name
       will be in the form "C=xxxx,O=yyyy,CN=zzzz" as described in RFC 2253. The output string
        buf will be ASCII or UTF-8 encoded, depending on the certificate data.

       This  function  does  not  output  a  fully  RFC4514  compliant  string,  if   that   is   required   see
       gnutls_x509_crq_get_dn3().

RETURNS

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

REPORTING BUGS

       Report bugs to <bugs@gnutls.org>.
       Home page: https://www.gnutls.org

       Copyright © 2001-2023 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

       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

       https://www.gnutls.org/manual/