| 
									
										
										
										
											2017-10-21 10:59:09 +08:00
										 |  |  | =pod | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 NAME | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | EVP_rc4, | 
					
						
							|  |  |  | EVP_rc4_40, | 
					
						
							|  |  |  | EVP_rc4_hmac_md5 | 
					
						
							|  |  |  | - EVP RC4 stream cipher | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 SYNOPSIS | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  #include <openssl/evp.h> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-07-15 16:26:35 +08:00
										 |  |  |  const EVP_CIPHER *EVP_rc4(void); | 
					
						
							|  |  |  |  const EVP_CIPHER *EVP_rc4_40(void); | 
					
						
							|  |  |  |  const EVP_CIPHER *EVP_rc4_hmac_md5(void); | 
					
						
							| 
									
										
										
										
											2017-10-21 10:59:09 +08:00
										 |  |  | 
 | 
					
						
							|  |  |  | =head1 DESCRIPTION | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | The RC4 stream cipher for EVP. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =over 4 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =item EVP_rc4() | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | RC4 stream cipher. This is a variable key length cipher with a default key | 
					
						
							|  |  |  | length of 128 bits. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =item EVP_rc4_40() | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | RC4 stream cipher with 40 bit key length. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | WARNING: this function is obsolete. Its usage should be replaced with the | 
					
						
							|  |  |  | EVP_rc4() and the EVP_CIPHER_CTX_set_key_length() functions. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =item EVP_rc4_hmac_md5() | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Authenticated encryption with the RC4 stream cipher with MD5 as HMAC. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | WARNING: this is not intended for usage outside of TLS and requires calling of | 
					
						
							|  |  |  | some undocumented ctrl functions. These ciphers do not conform to the EVP AEAD | 
					
						
							|  |  |  | interface. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =back | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-02-22 08:11:33 +08:00
										 |  |  | =head1 NOTES | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Developers should be aware of the negative performance implications of | 
					
						
							|  |  |  | calling these functions multiple times and should consider using | 
					
						
							| 
									
										
										
										
											2023-10-18 21:35:55 +08:00
										 |  |  | L<EVP_CIPHER_fetch(3)> with L<EVP_CIPHER-RC4(7)> instead. | 
					
						
							| 
									
										
										
										
											2023-02-22 08:11:33 +08:00
										 |  |  | See L<crypto(7)/Performance> for further information. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-10-21 10:59:09 +08:00
										 |  |  | =head1 RETURN VALUES | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | These functions return an B<EVP_CIPHER> structure that contains the | 
					
						
							|  |  |  | implementation of the symmetric cipher. See L<EVP_CIPHER_meth_new(3)> for | 
					
						
							|  |  |  | details of the B<EVP_CIPHER> structure. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 SEE ALSO | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | L<evp(7)>, | 
					
						
							|  |  |  | L<EVP_EncryptInit(3)>, | 
					
						
							|  |  |  | L<EVP_CIPHER_meth_new(3)> | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 COPYRIGHT | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2023-09-07 16:59:15 +08:00
										 |  |  | Copyright 2017-2023 The OpenSSL Project Authors. All Rights Reserved. | 
					
						
							| 
									
										
										
										
											2017-10-21 10:59:09 +08:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2018-12-06 21:04:44 +08:00
										 |  |  | Licensed under the Apache License 2.0 (the "License").  You may not use | 
					
						
							| 
									
										
										
										
											2017-10-21 10:59:09 +08:00
										 |  |  | 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 |