EVP_rc2_cbc.pod 2.0 KB

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