RC4(3)

πŸ’– NAME πŸ’–

okay so bestie, welcome to this User Contributed Perl Documentation page for RC4(3) β€” aka Crypt::RC4, which is literally a Perl implementation of the RC4 encryption algorithm. that’s the whole name, no cap ✨


🌸 SYNOPSIS 🌸

there are two ways to run this: the functional style and the OO style. both are valid, both are iconic, pick your vibe πŸ’…

# Functional Style
  use Crypt::RC4;
  $encrypted = RC4( $passphrase, $plaintext );
  $decrypt = RC4( $passphrase, $encrypted );

# OO Style
  use Crypt::RC4;
  $ref = Crypt::RC4->new( $passphrase );
  $encrypted = $ref->RC4( $plaintext );

  $ref2 = Crypt::RC4->new( $passphrase );
  $decrypted = $ref2->RC4( $encrypted );

# process an entire file, one line at a time # (Warning: Encrypted file
leaks line lengths.)
  $ref3 = Crypt::RC4->new( $passphrase );
  while (<FILE>) {
      chomp;
      print $ref3->RC4($_), "\n";
  }

quick heads-up: that warning about encrypted files leaking line lengths is very real, so don’t sleep on it πŸ’€


πŸ¦‹ DESCRIPTION πŸ¦‹

so this is a simple implementation of the RC4 algorithm, developed by RSA Security, Inc. here’s the description straight from RSA’s website:

RC4 is a stream cipher designed by Rivest for RSA Data Security (now RSA Security). It is a variable key-size stream cipher with byte-oriented operations. The algorithm is based on the use of a random permutation. Analysis shows that the period of the cipher is overwhelmingly likely to be greater than 10100. Eight to sixteen machine operations are required per output byte, and the cipher can be expected to run very quickly in software. Independent analysts have scrutinized the algorithm and it is considered secure.

it’s based substantially on the "RC4 in 3 lines of perl" found at http://www.cypherspace.org β€” cute, right? πŸŽ€

also, a major bug in v1.0 was fixed by David Hook (dgh@wumpus.com.au). thanks, David! 🫢


πŸŽ€ AUTHOR πŸŽ€

shoutout to Kurt Kincaid (sifukurt@yahoo.com) and Ronald Rivest for RSA Security, Inc. β€” that’s the author credit on this page, periodt πŸ‘‘


πŸ’€ BUGS πŸ’€

Disclaimer: strictly speaking, this module uses the "alleged" RC4 algorithm. The Algorithm known as "RC4" is a trademark of RSA Security Inc., and this document makes no claims one way or another that this is the correct algorithm, and further, make no claims about the quality of the source code nor any licensing requirements for commercial use.

There’s nothing preventing you from using this module in an insecure way which leaks information. for example, encrypting multilple messages with the same passphrase may allow an attacker to decode all of them with little effort, even though they’ll appear to be secured. if serious crypto is your goal, be careful. Be very careful. 😭

it’s a pure-Perl implementation, so that rating of "Eight to sixteen machine operations" is good for nothing but a good laugh. if encryption and decryption are a bottleneck for you, please re-write this module to use native code wherever practical. ngl, that part is giving β€œdo it yourself” energy πŸ’€


πŸ‘‘ LICENSE πŸ‘‘

this is free software and may be modified and/or redistributed under the same terms as Perl itself. slay πŸ’–


🌈 SEE ALSO 🌈


okay bye bestie β€” this page is from perl v5.42.0, dated 2025-05-09, and its manual tag is RC4(3). πŸ’…πŸ«Ά

πŸ“¦ where this page comes from