|
Packit |
aea12f |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
991b93 |
.TH "gnutls_x509_privkey_import_pkcs8" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit |
aea12f |
.SH NAME
|
|
Packit |
aea12f |
gnutls_x509_privkey_import_pkcs8 \- API function
|
|
Packit |
aea12f |
.SH SYNOPSIS
|
|
Packit |
aea12f |
.B #include <gnutls/x509.h>
|
|
Packit |
aea12f |
.sp
|
|
Packit |
aea12f |
.BI "int gnutls_x509_privkey_import_pkcs8(gnutls_x509_privkey_t " key ", const gnutls_datum_t * " data ", gnutls_x509_crt_fmt_t " format ", const char * " password ", unsigned int " flags ");"
|
|
Packit |
aea12f |
.SH ARGUMENTS
|
|
Packit |
aea12f |
.IP "gnutls_x509_privkey_t key" 12
|
|
Packit |
aea12f |
The data to store the parsed key
|
|
Packit |
aea12f |
.IP "const gnutls_datum_t * data" 12
|
|
Packit |
aea12f |
The DER or PEM encoded key.
|
|
Packit |
aea12f |
.IP "gnutls_x509_crt_fmt_t format" 12
|
|
Packit |
aea12f |
One of DER or PEM
|
|
Packit |
aea12f |
.IP "const char * password" 12
|
|
Packit |
aea12f |
the password to decrypt the key (if it is encrypted).
|
|
Packit |
aea12f |
.IP "unsigned int flags" 12
|
|
Packit |
aea12f |
0 if encrypted or GNUTLS_PKCS_PLAIN if not encrypted.
|
|
Packit |
aea12f |
.SH "DESCRIPTION"
|
|
Packit |
aea12f |
This function will convert the given DER or PEM encoded PKCS8 2.0
|
|
Packit |
aea12f |
encrypted key to the native gnutls_x509_privkey_t format. The
|
|
Packit |
aea12f |
output will be stored in \fIkey\fP . Both RSA and DSA keys can be
|
|
Packit |
aea12f |
imported, and flags can only be used to indicate an unencrypted
|
|
Packit |
aea12f |
key.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
The \fIpassword\fP can be either ASCII or UTF\-8 in the default PBES2
|
|
Packit |
aea12f |
encryption schemas, or ASCII for the PKCS12 schemas.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
If the Certificate is PEM encoded it should have a header of
|
|
Packit |
aea12f |
"ENCRYPTED PRIVATE KEY", or "PRIVATE KEY". You only need to
|
|
Packit |
aea12f |
specify the flags if the key is DER encoded, since in that case
|
|
Packit |
aea12f |
the encryption status cannot be auto\-detected.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
If the \fBGNUTLS_PKCS_PLAIN\fP flag is specified and the supplied data
|
|
Packit |
aea12f |
are encrypted then \fBGNUTLS_E_DECRYPTION_FAILED\fP is returned.
|
|
Packit |
aea12f |
.SH "RETURNS"
|
|
Packit |
aea12f |
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
|
|
Packit |
aea12f |
negative error value.
|
|
Packit |
aea12f |
.SH "REPORTING BUGS"
|
|
Packit |
aea12f |
Report bugs to <bugs@gnutls.org>.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Home page: https://www.gnutls.org
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
.SH COPYRIGHT
|
|
Packit Service |
991b93 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Copying and distribution of this file, with or without modification,
|
|
Packit |
aea12f |
are permitted in any medium without royalty provided the copyright
|
|
Packit |
aea12f |
notice and this notice are preserved.
|
|
Packit |
aea12f |
.SH "SEE ALSO"
|
|
Packit |
aea12f |
The full documentation for
|
|
Packit |
aea12f |
.B gnutls
|
|
Packit |
aea12f |
is maintained as a Texinfo manual.
|
|
Packit |
aea12f |
If the /usr/share/doc/gnutls/
|
|
Packit |
aea12f |
directory does not contain the HTML form visit
|
|
Packit |
aea12f |
.B
|
|
Packit |
aea12f |
.IP https://www.gnutls.org/manual/
|
|
Packit |
aea12f |
.PP
|