Tizen 2.0 Release
[external/libgnutls26.git] / doc / manpages / gnutls_pem_base64_encode_alloc.3
1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
2 .TH "gnutls_pem_base64_encode_alloc" 3 "2.12.6.1" "gnutls" "gnutls"
3 .SH NAME
4 gnutls_pem_base64_encode_alloc \- API function
5 .SH SYNOPSIS
6 .B #include <gnutls/gnutls.h>
7 .sp
8 .BI "int gnutls_pem_base64_encode_alloc(const char * " msg ", const gnutls_datum_t * " data ", gnutls_datum_t * " result ");"
9 .SH ARGUMENTS
10 .IP "const char * msg" 12
11 is a message to be put in the encoded header
12 .IP "const gnutls_datum_t * data" 12
13 contains the raw data
14 .IP "gnutls_datum_t * result" 12
15 will hold the newly allocated encoded data
16 .SH "DESCRIPTION"
17 This function will convert the given data to printable data, using
18 the base64 encoding.  This is the encoding used in PEM messages.
19 This function will allocate the required memory to hold the encoded
20 data.
21
22 You should use \fBgnutls_free()\fP to free the returned data.
23 .SH "RETURNS"
24 On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise
25 an error code is returned.
26 .SH "REPORTING BUGS"
27 Report bugs to <bug-gnutls@gnu.org>.
28 GnuTLS home page: http://www.gnu.org/software/gnutls/
29 General help using GNU software: http://www.gnu.org/gethelp/
30 .SH COPYRIGHT
31 Copyright \(co 2008 Free Software Foundation.
32 .br
33 Copying and distribution of this file, with or without modification,
34 are permitted in any medium without royalty provided the copyright
35 notice and this notice are preserved.
36 .SH "SEE ALSO"
37 The full documentation for
38 .B gnutls
39 is maintained as a Texinfo manual.  If the
40 .B info
41 and
42 .B gnutls
43 programs are properly installed at your site, the command
44 .IP
45 .B info gnutls
46 .PP
47 should give you access to the complete manual.