Tizen 2.0 Release
[external/libgnutls26.git] / doc / manpages / gnutls_x509_crl_get_issuer_dn.3
1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
2 .TH "gnutls_x509_crl_get_issuer_dn" 3 "2.12.6.1" "gnutls" "gnutls"
3 .SH NAME
4 gnutls_x509_crl_get_issuer_dn \- API function
5 .SH SYNOPSIS
6 .B #include <gnutls/x509.h>
7 .sp
8 .BI "int gnutls_x509_crl_get_issuer_dn(const gnutls_x509_crl_t " crl ", char * " buf ", size_t * " sizeof_buf ");"
9 .SH ARGUMENTS
10 .IP "const gnutls_x509_crl_t crl" 12
11 should contain a gnutls_x509_crl_t structure
12 .IP "char * buf" 12
13 a pointer to a structure to hold the peer's name (may be null)
14 .IP "size_t * sizeof_buf" 12
15 initially holds the size of \fIbuf\fP
16 .SH "DESCRIPTION"
17 This function will copy the name of the CRL issuer in the provided
18 buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as
19 described in RFC2253. The output string will be ASCII or UTF\-8
20 encoded, depending on the certificate data.
21
22 If buf is \fBNULL\fP then only the size will be filled.
23 .SH "RETURNS"
24 \fBGNUTLS_E_SHORT_MEMORY_BUFFER\fP if the provided buffer is
25 not long enough, and in that case the sizeof_buf will be updated
26 with the required size, and 0 on success.
27 .SH "REPORTING BUGS"
28 Report bugs to <bug-gnutls@gnu.org>.
29 GnuTLS home page: http://www.gnu.org/software/gnutls/
30 General help using GNU software: http://www.gnu.org/gethelp/
31 .SH COPYRIGHT
32 Copyright \(co 2008 Free Software Foundation.
33 .br
34 Copying and distribution of this file, with or without modification,
35 are permitted in any medium without royalty provided the copyright
36 notice and this notice are preserved.
37 .SH "SEE ALSO"
38 The full documentation for
39 .B gnutls
40 is maintained as a Texinfo manual.  If the
41 .B info
42 and
43 .B gnutls
44 programs are properly installed at your site, the command
45 .IP
46 .B info gnutls
47 .PP
48 should give you access to the complete manual.