xref: /freebsd/crypto/openssl/doc/man3/EVP_rc2_cbc.pod (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
1=pod
2
3=head1 NAME
4
5EVP_rc2_cbc,
6EVP_rc2_cfb,
7EVP_rc2_cfb64,
8EVP_rc2_ecb,
9EVP_rc2_ofb,
10EVP_rc2_40_cbc,
11EVP_rc2_64_cbc
12- EVP RC2 cipher
13
14=head1 SYNOPSIS
15
16 #include <openssl/evp.h>
17
18 const EVP_CIPHER *EVP_rc2_cbc(void);
19 const EVP_CIPHER *EVP_rc2_cfb(void);
20 const EVP_CIPHER *EVP_rc2_cfb64(void);
21 const EVP_CIPHER *EVP_rc2_ecb(void);
22 const EVP_CIPHER *EVP_rc2_ofb(void);
23 const EVP_CIPHER *EVP_rc2_40_cbc(void);
24 const EVP_CIPHER *EVP_rc2_64_cbc(void);
25
26=head1 DESCRIPTION
27
28The RC2 encryption algorithm for EVP.
29
30=over 4
31
32=item EVP_rc2_cbc(),
33EVP_rc2_cfb(),
34EVP_rc2_cfb64(),
35EVP_rc2_ecb(),
36EVP_rc2_ofb()
37
38RC2 encryption algorithm in CBC, CFB, ECB and OFB modes respectively. This is a
39variable key length cipher with an additional parameter called "effective key
40bits" or "effective key length". By default both are set to 128 bits.
41
42=item EVP_rc2_40_cbc(),
43EVP_rc2_64_cbc()
44
45RC2 algorithm in CBC mode with a default key length and effective key length of
4640 and 64 bits.
47
48WARNING: these functions are obsolete. Their usage should be replaced with the
49EVP_rc2_cbc(), EVP_CIPHER_CTX_set_key_length() and EVP_CIPHER_CTX_ctrl()
50functions to set the key length and effective key length.
51
52=back
53
54=head1 NOTES
55
56Developers should be aware of the negative performance implications of
57calling these functions multiple times and should consider using
58L<EVP_CIPHER_fetch(3)> with L<EVP_CIPHER-RC2(7)> instead.
59See L<crypto(7)/Performance> for further information.
60
61=head1 RETURN VALUES
62
63These functions return an B<EVP_CIPHER> structure that contains the
64implementation of the symmetric cipher. See L<EVP_CIPHER_meth_new(3)> for
65details of the B<EVP_CIPHER> structure.
66
67=head1 SEE ALSO
68
69L<evp(7)>,
70L<EVP_EncryptInit(3)>,
71L<EVP_CIPHER_meth_new(3)>
72
73=head1 COPYRIGHT
74
75Copyright 2017-2023 The OpenSSL Project Authors. All Rights Reserved.
76
77Licensed under the Apache License 2.0 (the "License").  You may not use
78this file except in compliance with the License.  You can obtain a copy
79in the file LICENSE in the source distribution or at
80L<https://www.openssl.org/source/license.html>.
81
82=cut
83
84