2021-02-17 15:56:36 +08:00
|
|
|
=pod
|
|
|
|
|
|
|
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
|
|
PKCS12_item_decrypt_d2i, PKCS12_item_decrypt_d2i_ex,
|
|
|
|
|
PKCS12_item_i2d_encrypt, PKCS12_item_i2d_encrypt_ex - PKCS12 item
|
|
|
|
|
encrypt/decrypt functions
|
|
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
|
|
#include <openssl/pkcs12.h>
|
|
|
|
|
|
|
|
|
|
void *PKCS12_item_decrypt_d2i(const X509_ALGOR *algor, const ASN1_ITEM *it,
|
|
|
|
|
const char *pass, int passlen,
|
|
|
|
|
const ASN1_OCTET_STRING *oct, int zbuf);
|
|
|
|
|
void *PKCS12_item_decrypt_d2i_ex(const X509_ALGOR *algor, const ASN1_ITEM *it,
|
|
|
|
|
const char *pass, int passlen,
|
|
|
|
|
const ASN1_OCTET_STRING *oct, int zbuf,
|
|
|
|
|
OSSL_LIB_CTX *libctx,
|
|
|
|
|
const char *propq);
|
|
|
|
|
ASN1_OCTET_STRING *PKCS12_item_i2d_encrypt(X509_ALGOR *algor,
|
|
|
|
|
const ASN1_ITEM *it,
|
|
|
|
|
const char *pass, int passlen,
|
|
|
|
|
void *obj, int zbuf);
|
|
|
|
|
ASN1_OCTET_STRING *PKCS12_item_i2d_encrypt_ex(X509_ALGOR *algor,
|
|
|
|
|
const ASN1_ITEM *it,
|
|
|
|
|
const char *pass, int passlen,
|
|
|
|
|
void *obj, int zbuf,
|
|
|
|
|
OSSL_LIB_CTX *ctx,
|
|
|
|
|
const char *propq);
|
|
|
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
|
|
PKCS12_item_decrypt_d2i() and PKCS12_item_decrypt_d2i_ex() decrypt an octet
|
2021-04-30 07:11:42 +08:00
|
|
|
string containing an ASN.1 encoded object using the algorithm I<algor> and
|
2021-02-17 15:56:36 +08:00
|
|
|
password I<pass> of length I<passlen>. If I<zbuf> is nonzero then the output
|
|
|
|
|
buffer will zeroed after the decrypt.
|
|
|
|
|
|
|
|
|
|
PKCS12_item_i2d_encrypt() and PKCS12_item_i2d_encrypt_ex() encrypt an ASN.1
|
|
|
|
|
object I<it> using the algorithm I<algor> and password I<pass> of length
|
|
|
|
|
I<passlen>, returning an encoded object in I<obj>. If I<zbuf> is nonzero then
|
|
|
|
|
the buffer containing the input encoding will be zeroed after the encrypt.
|
|
|
|
|
|
|
|
|
|
Functions ending in _ex() allow for a library context I<ctx> and property query
|
|
|
|
|
I<propq> to be used to select algorithm implementations.
|
|
|
|
|
|
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
|
|
|
|
|
|
PKCS12_item_decrypt_d2i() and PKCS12_item_decrypt_d2i_ex() return the decrypted
|
|
|
|
|
object or NULL if an error occurred.
|
|
|
|
|
|
|
|
|
|
PKCS12_item_i2d_encrypt() and PKCS12_item_i2d_encrypt_ex() return the encrypted
|
|
|
|
|
data as an ASN.1 Octet String or NULL if an error occurred.
|
|
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
|
|
L<PKCS12_pbe_crypt_ex(3)>,
|
|
|
|
|
L<PKCS8_encrypt_ex(3)>
|
|
|
|
|
|
|
|
|
|
=head1 HISTORY
|
|
|
|
|
|
|
|
|
|
PKCS12_item_decrypt_d2i_ex() and PKCS12_item_i2d_encrypt_ex() were added in OpenSSL 3.0.
|
|
|
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
|
|
Copyright 2021 The OpenSSL Project Authors. All Rights Reserved.
|
|
|
|
|
|
|
|
|
|
Licensed under the Apache License 2.0 (the "License"). You may not use
|
|
|
|
|
this file except in compliance with the License. You can obtain a copy
|
|
|
|
|
in the file LICENSE in the source distribution or at
|
|
|
|
|
L<https://www.openssl.org/source/license.html>.
|
|
|
|
|
|
|
|
|
|
=cut
|
