Tizen 2.0 Release
[external/libgnutls26.git] / doc / manpages / gnutls_pkcs12_import.3
1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
2 .TH "gnutls_pkcs12_import" 3 "2.12.6.1" "gnutls" "gnutls"
3 .SH NAME
4 gnutls_pkcs12_import \- API function
5 .SH SYNOPSIS
6 .B #include <gnutls/pkcs12.h>
7 .sp
8 .BI "int gnutls_pkcs12_import(gnutls_pkcs12_t " pkcs12 ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ", unsigned int " flags ");"
9 .SH ARGUMENTS
10 .IP "gnutls_pkcs12_t pkcs12" 12
11 The structure to store the parsed PKCS12.
12 .IP "const gnutls_datum_t * data" 12
13 The DER or PEM encoded PKCS12.
14 .IP "gnutls_x509_crt_fmt_t format" 12
15 One of DER or PEM
16 .IP "unsigned int flags" 12
17 an ORed sequence of gnutls_privkey_pkcs8_flags
18 .SH "DESCRIPTION"
19 This function will convert the given DER or PEM encoded PKCS12
20 to the native gnutls_pkcs12_t format. The output will be stored in 'pkcs12'.
21
22 If the PKCS12 is PEM encoded it should have a header of "PKCS12".
23 .SH "RETURNS"
24 On success, \fBGNUTLS_E_SUCCESS\fP is returned, otherwise a
25 negative error value.
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.