Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_x509_crt_get_dn(3)	     gnutls	       gnutls_x509_crt_get_dn(3)

NAME
     gnutls_x509_crt_get_dn - API function

SYNOPSIS
     #include <gnutls/x509.h>

     int  gnutls_x509_crt_get_dn(gnutls_x509_crt_t  cert,  char  * buf, size_t *
     buf_size);

ARGUMENTS
     gnutls_x509_crt_t cert
		 should contain a gnutls_x509_crt_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 in the provided buffer.
     The name will be  in  the	form  "C=xxxx,O=yyyy,CN=zzzz"  as  described  in
     RFC4514. The output string will be ASCII or UTF-8 encoded, depending on the
     certificate data.

     The   buf	returned  will be null terminated and the  buf_size will account
     for the trailing null. If	buf is null then only the size will be filled.

     This function does not output a fully RFC4514 compliant string, if that  is
     required see gnutls_x509_crt_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.
     GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE if the DN does not exist, or  another
     error value on error. On success 0 is returned.

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

COPYRIGHT
     Copyright (C) 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/local/share/doc/gnutls/ directory does not contain the  HTML  form
     visit

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

gnutls				     3.8.13	       gnutls_x509_crt_get_dn(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_x509_crt_get_dn&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help