]>
Commit | Line | Data |
---|---|---|
9de6bb8a DSH |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
5 | d2i_PKCS8PrivateKey_bio, d2i_PKCS8PrivateKey_fp, | |
6 | i2d_PKCS8PrivateKey_bio, i2d_PKCS8PrivateKey_fp, | |
7 | i2d_PKCS8PrivateKey_nid_bio, i2d_PKCS8PrivateKey_nid_fp - PKCS#8 format private key functions | |
8 | ||
9 | =head1 SYNOPSIS | |
10 | ||
11 | #include <openssl/evp.h> | |
12 | ||
13 | EVP_PKEY *d2i_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY **x, pem_password_cb *cb, void *u); | |
14 | EVP_PKEY *d2i_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY **x, pem_password_cb *cb, void *u); | |
15 | ||
16 | int i2d_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY *x, const EVP_CIPHER *enc, | |
17 | char *kstr, int klen, | |
18 | pem_password_cb *cb, void *u); | |
19 | ||
20 | int i2d_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY *x, const EVP_CIPHER *enc, | |
21 | char *kstr, int klen, | |
22 | pem_password_cb *cb, void *u); | |
23 | ||
24 | int i2d_PKCS8PrivateKey_nid_bio(BIO *bp, EVP_PKEY *x, int nid, | |
25 | char *kstr, int klen, | |
26 | pem_password_cb *cb, void *u); | |
27 | ||
28 | int i2d_PKCS8PrivateKey_nid_fp(FILE *fp, EVP_PKEY *x, int nid, | |
29 | char *kstr, int klen, | |
30 | pem_password_cb *cb, void *u); | |
31 | ||
32 | =head1 DESCRIPTION | |
33 | ||
34 | The PKCS#8 functions encode and decode private keys in PKCS#8 format using both | |
35 | PKCS#5 v1.5 and PKCS#5 v2.0 password based encryption algorithms. | |
36 | ||
37 | Other than the use of DER as opposed to PEM these functions are identical to the | |
9b86974e | 38 | corresponding B<PEM> function as described in the L<pem(3)> manual page. |
9de6bb8a DSH |
39 | |
40 | =head1 NOTES | |
41 | ||
9de6bb8a DSH |
42 | These functions are currently the only way to store encrypted private keys using DER format. |
43 | ||
44 | Currently all the functions use BIOs or FILE pointers, there are no functions which | |
45 | work directly on memory: this can be readily worked around by converting the buffers | |
9b86974e | 46 | to memory BIOs, see L<BIO_s_mem(3)> for details. |
9de6bb8a DSH |
47 | |
48 | =head1 SEE ALSO | |
49 | ||
9b86974e | 50 | L<pem(3)> |
9de6bb8a DSH |
51 | |
52 | =cut |