Tizen 2.0 Release
[external/libgnutls26.git] / doc / manpages / gnutls_x509_crq_get_attribute_by_oid.3
1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
2 .TH "gnutls_x509_crq_get_attribute_by_oid" 3 "2.12.6.1" "gnutls" "gnutls"
3 .SH NAME
4 gnutls_x509_crq_get_attribute_by_oid \- API function
5 .SH SYNOPSIS
6 .B #include <gnutls/x509.h>
7 .sp
8 .BI "int gnutls_x509_crq_get_attribute_by_oid(gnutls_x509_crq_t " crq ", const char * " oid ", int " indx ", void * " buf ", size_t * " sizeof_buf ");"
9 .SH ARGUMENTS
10 .IP "gnutls_x509_crq_t crq" 12
11 should contain a \fBgnutls_x509_crq_t\fP structure
12 .IP "const char * oid" 12
13 holds an Object Identified in zero\-terminated string
14 .IP "int indx" 12
15 In case multiple same OIDs exist in the attribute list, this
16 specifies which to send, use zero to get the first one
17 .IP "void * buf" 12
18 a pointer to a structure to hold the attribute data (may be \fBNULL\fP)
19 .IP "size_t * sizeof_buf" 12
20 initially holds the size of \fIbuf\fP
21 .SH "DESCRIPTION"
22 This function will return the attribute in the certificate request
23 specified by the given Object ID.  The attribute will be DER
24 encoded.
25 .SH "RETURNS"
26 On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a
27 negative error value.
28 .SH "REPORTING BUGS"
29 Report bugs to <bug-gnutls@gnu.org>.
30 GnuTLS home page: http://www.gnu.org/software/gnutls/
31 General help using GNU software: http://www.gnu.org/gethelp/
32 .SH COPYRIGHT
33 Copyright \(co 2008 Free Software Foundation.
34 .br
35 Copying and distribution of this file, with or without modification,
36 are permitted in any medium without royalty provided the copyright
37 notice and this notice are preserved.
38 .SH "SEE ALSO"
39 The full documentation for
40 .B gnutls
41 is maintained as a Texinfo manual.  If the
42 .B info
43 and
44 .B gnutls
45 programs are properly installed at your site, the command
46 .IP
47 .B info gnutls
48 .PP
49 should give you access to the complete manual.