xref: /freebsd-src/crypto/openssl/doc/man3/EVP_des_cbc.pod (revision ad991e4c142ebabad7aef488ad97b189ecabb270)
1b077aed3SPierre Pronchery=pod
2b077aed3SPierre Pronchery
3b077aed3SPierre Pronchery=head1 NAME
4b077aed3SPierre Pronchery
5b077aed3SPierre ProncheryEVP_des_cbc,
6b077aed3SPierre ProncheryEVP_des_cfb,
7b077aed3SPierre ProncheryEVP_des_cfb1,
8b077aed3SPierre ProncheryEVP_des_cfb8,
9b077aed3SPierre ProncheryEVP_des_cfb64,
10b077aed3SPierre ProncheryEVP_des_ecb,
11b077aed3SPierre ProncheryEVP_des_ofb,
12b077aed3SPierre ProncheryEVP_des_ede,
13b077aed3SPierre ProncheryEVP_des_ede_cbc,
14b077aed3SPierre ProncheryEVP_des_ede_cfb,
15b077aed3SPierre ProncheryEVP_des_ede_cfb64,
16b077aed3SPierre ProncheryEVP_des_ede_ecb,
17b077aed3SPierre ProncheryEVP_des_ede_ofb,
18b077aed3SPierre ProncheryEVP_des_ede3,
19b077aed3SPierre ProncheryEVP_des_ede3_cbc,
20b077aed3SPierre ProncheryEVP_des_ede3_cfb,
21b077aed3SPierre ProncheryEVP_des_ede3_cfb1,
22b077aed3SPierre ProncheryEVP_des_ede3_cfb8,
23b077aed3SPierre ProncheryEVP_des_ede3_cfb64,
24b077aed3SPierre ProncheryEVP_des_ede3_ecb,
25b077aed3SPierre ProncheryEVP_des_ede3_ofb,
26b077aed3SPierre ProncheryEVP_des_ede3_wrap
27b077aed3SPierre Pronchery- EVP DES cipher
28b077aed3SPierre Pronchery
29b077aed3SPierre Pronchery=head1 SYNOPSIS
30b077aed3SPierre Pronchery
31b077aed3SPierre Pronchery=for openssl generic
32b077aed3SPierre Pronchery
33b077aed3SPierre Pronchery #include <openssl/evp.h>
34b077aed3SPierre Pronchery
35b077aed3SPierre Pronchery const EVP_CIPHER *EVP_ciphername(void)
36b077aed3SPierre Pronchery
37b077aed3SPierre ProncheryI<EVP_ciphername> is used a placeholder for any of the described cipher
38b077aed3SPierre Proncheryfunctions, such as I<EVP_des_cbc>.
39b077aed3SPierre Pronchery
40b077aed3SPierre Pronchery=head1 DESCRIPTION
41b077aed3SPierre Pronchery
42b077aed3SPierre ProncheryThe DES encryption algorithm for EVP.
43b077aed3SPierre Pronchery
44b077aed3SPierre Pronchery=over 4
45b077aed3SPierre Pronchery
46b077aed3SPierre Pronchery=item EVP_des_cbc(),
47b077aed3SPierre ProncheryEVP_des_ecb(),
48b077aed3SPierre ProncheryEVP_des_cfb(),
49b077aed3SPierre ProncheryEVP_des_cfb1(),
50b077aed3SPierre ProncheryEVP_des_cfb8(),
51b077aed3SPierre ProncheryEVP_des_cfb64(),
52b077aed3SPierre ProncheryEVP_des_ofb()
53b077aed3SPierre Pronchery
54b077aed3SPierre ProncheryDES in CBC, ECB, CFB with 64-bit shift, CFB with 1-bit shift, CFB with 8-bit
55b077aed3SPierre Proncheryshift and OFB modes.
56b077aed3SPierre Pronchery
57b077aed3SPierre ProncheryNone of these algorithms are provided by the OpenSSL default provider.
58b077aed3SPierre ProncheryTo use them it is necessary to load either the OpenSSL legacy provider or another
59b077aed3SPierre Proncheryimplementation.
60b077aed3SPierre Pronchery
61b077aed3SPierre Pronchery=item EVP_des_ede(),
62b077aed3SPierre ProncheryEVP_des_ede_cbc(),
63b077aed3SPierre ProncheryEVP_des_ede_cfb(),
64b077aed3SPierre ProncheryEVP_des_ede_cfb64(),
65b077aed3SPierre ProncheryEVP_des_ede_ecb(),
66b077aed3SPierre ProncheryEVP_des_ede_ofb()
67b077aed3SPierre Pronchery
68b077aed3SPierre ProncheryTwo key triple DES in ECB, CBC, CFB with 64-bit shift and OFB modes.
69b077aed3SPierre Pronchery
70b077aed3SPierre Pronchery=item EVP_des_ede3(),
71b077aed3SPierre ProncheryEVP_des_ede3_cbc(),
72b077aed3SPierre ProncheryEVP_des_ede3_cfb(),
73b077aed3SPierre ProncheryEVP_des_ede3_cfb1(),
74b077aed3SPierre ProncheryEVP_des_ede3_cfb8(),
75b077aed3SPierre ProncheryEVP_des_ede3_cfb64(),
76b077aed3SPierre ProncheryEVP_des_ede3_ecb(),
77b077aed3SPierre ProncheryEVP_des_ede3_ofb()
78b077aed3SPierre Pronchery
79b077aed3SPierre ProncheryThree-key triple DES in ECB, CBC, CFB with 64-bit shift, CFB with 1-bit shift,
80b077aed3SPierre ProncheryCFB with 8-bit shift and OFB modes.
81b077aed3SPierre Pronchery
82b077aed3SPierre Pronchery=item EVP_des_ede3_wrap()
83b077aed3SPierre Pronchery
84b077aed3SPierre ProncheryTriple-DES key wrap according to RFC 3217 Section 3.
85b077aed3SPierre Pronchery
86b077aed3SPierre Pronchery=back
87b077aed3SPierre Pronchery
88b077aed3SPierre Pronchery=head1 NOTES
89b077aed3SPierre Pronchery
90b077aed3SPierre ProncheryDevelopers should be aware of the negative performance implications of
91b077aed3SPierre Proncherycalling these functions multiple times and should consider using
92*ad991e4cSEd MasteL<EVP_CIPHER_fetch(3)> with L<EVP_CIPHER-DES(7)> instead.
93b077aed3SPierre ProncherySee L<crypto(7)/Performance> for further information.
94b077aed3SPierre Pronchery
95b077aed3SPierre Pronchery=head1 RETURN VALUES
96b077aed3SPierre Pronchery
97b077aed3SPierre ProncheryThese functions return an B<EVP_CIPHER> structure that contains the
98b077aed3SPierre Proncheryimplementation of the symmetric cipher. See L<EVP_CIPHER_meth_new(3)> for
99b077aed3SPierre Proncherydetails of the B<EVP_CIPHER> structure.
100b077aed3SPierre Pronchery
101b077aed3SPierre Pronchery=head1 SEE ALSO
102b077aed3SPierre Pronchery
103b077aed3SPierre ProncheryL<evp(7)>,
104b077aed3SPierre ProncheryL<EVP_EncryptInit(3)>,
105b077aed3SPierre ProncheryL<EVP_CIPHER_meth_new(3)>
106b077aed3SPierre Pronchery
107b077aed3SPierre Pronchery=head1 COPYRIGHT
108b077aed3SPierre Pronchery
109b077aed3SPierre ProncheryCopyright 2017-2023 The OpenSSL Project Authors. All Rights Reserved.
110b077aed3SPierre Pronchery
111b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License").  You may not use
112b077aed3SPierre Proncherythis file except in compliance with the License.  You can obtain a copy
113b077aed3SPierre Proncheryin the file LICENSE in the source distribution or at
114b077aed3SPierre ProncheryL<https://www.openssl.org/source/license.html>.
115b077aed3SPierre Pronchery
116b077aed3SPierre Pronchery=cut
117b077aed3SPierre Pronchery
118