← Back to branch summary

~ubuntu-branches/ubuntu/precise/gnutls28/precise

« back to all changes in this revision

Viewing changes to doc/manpages/gnutls_x509_crt_get_issuer_dn_by_oid.3

  • Committer: Package Import Robot
  • Author(s): Andreas Metzler
  • Date: 2011-09-20 19:37:06 UTC
  • mfrom: (1.1.3)
  • Revision ID: package-import@ubuntu.com-20110920193706-a9phjijvddzg3nkl
Tags: 3.0.3-1
* New upstream version. (Includes a fix for #640639)
* Bump shlibs.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/manpages/gnutls_x509_crt_get_issuer_dn_by_oid.3
1
1
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
2
 
.TH "gnutls_x509_crt_get_issuer_dn_by_oid" 3 "3.0.1" "gnutls" "gnutls"
 
2
.TH "gnutls_x509_crt_get_issuer_dn_by_oid" 3 "3.0.2" "gnutls" "gnutls"
3
3
.SH NAME
4
4
gnutls_x509_crt_get_issuer_dn_by_oid \- API function
5
5
.SH SYNOPSIS
6
6
.B #include <gnutls/x509.h>
7
7
.sp
8
 
.BI "int gnutls_x509_crt_get_issuer_dn_by_oid(gnutls_x509_crt_t " cert ", const char * " oid ", int " indx ", unsigned int " raw_flag ", void * " buf ", size_t * " sizeof_buf ");"
 
8
.BI "int gnutls_x509_crt_get_issuer_dn_by_oid(gnutls_x509_crt_t " cert ", const char * " oid ", int " indx ", unsigned int " raw_flag ", void * " buf ", size_t * " buf_size ");"
9
9
.SH ARGUMENTS
10
10
.IP "gnutls_x509_crt_t cert" 12
11
11
should contain a \fBgnutls_x509_crt_t\fP structure
17
17
If non (0) returns the raw DER data of the DN part.
18
18
.IP "void * buf" 12
19
19
a pointer to a structure to hold the name (may be null)
20
 
.IP "size_t * sizeof_buf" 12
 
20
.IP "size_t * buf_size" 12
21
21
initially holds the size of \fIbuf\fP
22
22
.SH "DESCRIPTION"
23
23
This function will extract the part of the name of the Certificate
31
31
in hex format with a '\#' prefix.  You can check about known OIDs
32
32
using \fBgnutls_x509_dn_oid_known()\fP.
33
33
 
34
 
If \fIbuf\fP is null then only the size will be filled.
 
34
If \fIbuf\fP is null then only the size will be filled. If the \fIraw_flag\fP
 
35
is not specified the output is always null terminated, although the
 
36
\fIbuf_size\fP will not include the null character.
35
37
.SH "RETURNS"
36
38
GNUTLS_E_SHORT_MEMORY_BUFFER if the provided buffer is not
37
 
long enough, and in that case the *sizeof_buf will be updated
 
39
long enough, and in that case the \fIbuf_size\fP will be updated
38
40
with the required size.  On success 0 is returned.
39
41
.SH "REPORTING BUGS"
40
42
Report bugs to <bug-gnutls@gnu.org>.