Blame doc/functions/gnutls_x509_privkey_import_pkcs8
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@deftypefun {int} {gnutls_x509_privkey_import_pkcs8} (gnutls_x509_privkey_t @var{key}, const gnutls_datum_t * @var{data}, gnutls_x509_crt_fmt_t @var{format}, const char * @var{password}, unsigned int @var{flags})
|
|
Packit Service |
4684c1 |
@var{key}: The data to store the parsed key
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{data}: The DER or PEM encoded key.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{format}: One of DER or PEM
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{password}: the password to decrypt the key (if it is encrypted).
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{flags}: 0 if encrypted or GNUTLS_PKCS_PLAIN if not encrypted.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
This function will convert the given DER or PEM encoded PKCS8 2.0
|
|
Packit Service |
4684c1 |
encrypted key to the native gnutls_x509_privkey_t format. The
|
|
Packit Service |
4684c1 |
output will be stored in @code{key} . Both RSA and DSA keys can be
|
|
Packit Service |
4684c1 |
imported, and flags can only be used to indicate an unencrypted
|
|
Packit Service |
4684c1 |
key.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
The @code{password} can be either ASCII or UTF-8 in the default PBES2
|
|
Packit Service |
4684c1 |
encryption schemas, or ASCII for the PKCS12 schemas.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
If the Certificate is PEM encoded it should have a header of
|
|
Packit Service |
4684c1 |
"ENCRYPTED PRIVATE KEY", or "PRIVATE KEY". You only need to
|
|
Packit Service |
4684c1 |
specify the flags if the key is DER encoded, since in that case
|
|
Packit Service |
4684c1 |
the encryption status cannot be auto-detected.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
If the @code{GNUTLS_PKCS_PLAIN} flag is specified and the supplied data
|
|
Packit Service |
4684c1 |
are encrypted then @code{GNUTLS_E_DECRYPTION_FAILED} is returned.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, otherwise a
|
|
Packit Service |
4684c1 |
negative error value.
|
|
Packit Service |
4684c1 |
@end deftypefun
|