~ubuntu-branches/ubuntu/dapper/gnutls12/dapper

« back to all changes in this revision

Viewing changes to doc/manpages/gnutls_x509_crq_get_dn.3

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Urlichs
  • Date: 2005-11-15 19:26:02 UTC
  • Revision ID: james.westby@ubuntu.com-20051115192602-f1ux56uyducz3f96
Tags: upstream-1.2.9
ImportĀ upstreamĀ versionĀ 1.2.9

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH "gnutls_x509_crq_get_dn" 3 "1.2.9" "gnutls" "gnutls"
 
2
.SH NAME
 
3
gnutls_x509_crq_get_dn
 
4
.SH SYNOPSIS
 
5
.B #include <gnutls/x509.h>
 
6
.sp
 
7
.BI "int gnutls_x509_crq_get_dn(gnutls_x509_crq_t " crq ", char * " buf ", size_t * " sizeof_buf ");"
 
8
.SH ARGUMENTS
 
9
.IP "gnutls_x509_crq_t crq" 12
 
10
should contain a gnutls_x509_crq_t structure
 
11
.IP "char * buf" 12
 
12
a pointer to a structure to hold the name (may be null)
 
13
.IP "size_t * sizeof_buf" 12
 
14
initially holds the size of 
 
15
.I "buf"
 
16
.SH "DESCRIPTION"
 
17
This function will copy the name of the Certificate request
 
18
subject in the provided buffer. The name will be in the form
 
19
"C=xxxx,O=yyyy,CN=zzzz" as described in RFC2253. The output string
 
20
will be ASCII or UTF-8 encoded, depending on the certificate data.
 
21
 
 
22
If 
 
23
.I "buf "
 
24
is null then only the size will be filled.
 
25
 
 
26
Returns GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not
 
27
long enough, and in that case the *sizeof_buf will be updated with
 
28
the required size.  On success 0 is returned.
 
29
.SH "REPORTING BUGS"
 
30
Report bugs to <bug-gnutls@gnu.org>.
 
31
.SH COPYRIGHT
 
32
Copyright \(co 2004 Free Software Foundation.
 
33
.br
 
34
Permission is granted to make and distribute verbatim copies of this
 
35
manual provided the copyright notice and this permission notice are
 
36
preserved on all copies.
 
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.