Imported Upstream version 3.4.11
[platform/upstream/gnutls.git] / doc / manpages / gnutls_x509_crq_set_attribute_by_oid.3
index ed3cddf..1aed8cf 100644 (file)
@@ -1,36 +1,37 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
-.TH "gnutls_x509_crq_set_attribute_by_oid" 3 "3.0.19" "gnutls" "gnutls"
+.TH "gnutls_x509_crq_set_attribute_by_oid" 3 "3.4.11" "gnutls" "gnutls"
 .SH NAME
 gnutls_x509_crq_set_attribute_by_oid \- API function
 .SH SYNOPSIS
 .B #include <gnutls/x509.h>
 .sp
-.BI "int gnutls_x509_crq_set_attribute_by_oid(gnutls_x509_crq_t " crq ", const char * " oid ", void * " buf ", size_t " sizeof_buf ");"
+.BI "int gnutls_x509_crq_set_attribute_by_oid(gnutls_x509_crq_t " crq ", const char * " oid ", void * " buf ", size_t " buf_size ");"
 .SH ARGUMENTS
 .IP "gnutls_x509_crq_t crq" 12
-should contain a \fBgnutls_x509_crq_t\fP structure
+should contain a \fBgnutls_x509_crq_t\fP type
 .IP "const char * oid" 12
-holds an Object Identified in (0)\-terminated string
+holds an Object Identifier in a null\-terminated string
 .IP "void * buf" 12
 a pointer to a structure that holds the attribute data
-.IP "size_t sizeof_buf" 12
+.IP "size_t buf_size" 12
 holds the size of  \fIbuf\fP 
 .SH "DESCRIPTION"
 This function will set the attribute in the certificate request
-specified by the given Object ID.  The attribute must be be DER
+specified by the given Object ID. The provided attribute must be be DER
 encoded.
+
+Attributes in a certificate request is an optional set of data
+appended to the request. Their interpretation depends on the CA policy.
 .SH "RETURNS"
 On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
 negative error value.
 .SH "REPORTING BUGS"
-Report bugs to <bug-gnutls@gnu.org>.
-.br
-General guidelines for reporting bugs: http://www.gnu.org/gethelp/
+Report bugs to <bugs@gnutls.org>.
 .br
-GnuTLS home page: http://www.gnu.org/software/gnutls/
+Home page: http://www.gnutls.org
 
 .SH COPYRIGHT
-Copyright \(co 2012 Free Software Foundation, Inc..
+Copyright \(co 2001-2016 Free Software Foundation, Inc., and others.
 .br
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
@@ -38,16 +39,9 @@ notice and this notice are preserved.
 .SH "SEE ALSO"
 The full documentation for
 .B gnutls
-is maintained as a Texinfo manual.  If the
-.B info
-and
-.B gnutls
-programs are properly installed at your site, the command
-.IP
-.B info gnutls
-.PP
-should give you access to the complete manual.
-As an alternative you may obtain the manual from:
-.IP
-.B http://www.gnu.org/software/gnutls/manual/
+is maintained as a Texinfo manual.
+If the /usr/share/doc/gnutls/
+directory does not contain the HTML form visit
+.B
+.IP http://www.gnutls.org/manual/
 .PP