doc/manpages/gnutls_x509_crt_set_proxy_dn.3

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
   2 .TH "gnutls_x509_crt_set_proxy_dn" 3 "2.12.6.1" "gnutls" "gnutls"
   3 .SH NAME
   4 gnutls_x509_crt_set_proxy_dn \- API function
   5 .SH SYNOPSIS
   6 .B #include <gnutls/x509.h>
   7 .sp
   8 .BI "int gnutls_x509_crt_set_proxy_dn(gnutls_x509_crt_t " crt ", gnutls_x509_crt_t " eecrt ", unsigned int " raw_flag ", const void * " name ", unsigned int " sizeof_name ");"
   9 .SH ARGUMENTS
  10 .IP "gnutls_x509_crt_t crt" 12
  11 a gnutls_x509_crt_t structure with the new proxy cert
  12 .IP "gnutls_x509_crt_t eecrt" 12
  13 the end entity certificate that will be issuing the proxy
  14 .IP "unsigned int raw_flag" 12
  15 must be 0, or 1 if the CN is DER encoded
  16 .IP "const void * name" 12
  17 a pointer to the CN name, may be NULL (but MUST then be added later)
  18 .IP "unsigned int sizeof_name" 12
  19 holds the size of \fIname\fP
  20 .SH "DESCRIPTION"
  21 This function will set the subject in \fIcrt\fP to the end entity's
  22 \fIeecrt\fP subject name, and add a single Common Name component \fIname\fP
  23 of size \fIsizeof_name\fP.  This corresponds to the required proxy
  24 certificate naming style.  Note that if \fIname\fP is \fBNULL\fP, you MUST
  25 set it later by using \fBgnutls_x509_crt_set_dn_by_oid()\fP or similar.
  26 .SH "RETURNS"
  27 On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a
  28 negative error value.
  29 .SH "REPORTING BUGS"
  30 Report bugs to <bug-gnutls@gnu.org>.
  31 GnuTLS home page: http://www.gnu.org/software/gnutls/
  32 General help using GNU software: http://www.gnu.org/gethelp/
  33 .SH COPYRIGHT
  34 Copyright \(co 2008 Free Software Foundation.
  35 .br
  36 Copying and distribution of this file, with or without modification,
  37 are permitted in any medium without royalty provided the copyright
  38 notice and this notice are preserved.
  39 .SH "SEE ALSO"
  40 The full documentation for
  41 .B gnutls
  42 is maintained as a Texinfo manual.  If the
  43 .B info
  44 and
  45 .B gnutls
  46 programs are properly installed at your site, the command
  47 .IP
  48 .B info gnutls
  49 .PP
  50 should give you access to the complete manual.