Crypt::...Camellia(3)

🌸 NAME 🌸

okay bestie, you're looking at the Crypt::...Camellia(3) manual page from the User Contributed Perl Documentation, and the main character is Crypt::Cipher::Camellia β€” the Symmetric cipher Camellia, key size: 128/192/256 bits. that's the whole NAME section and it ate. πŸ’…βœ¨


✨ SYNOPSIS ✨

two ways to slide into this cipher, bestie. example one uses Crypt::Mode::CBC:

### example 1
use Crypt::Mode::CBC;

my $key = '...'; # length must be a valid key size for this cipher
my $iv = '...';  # 16 bytes
my $cbc = Crypt::Mode::CBC->new('Camellia');
my $ciphertext = $cbc->encrypt("secret data", $key, $iv);

example two is the slower route, and it's still valid, no cap:

### example 2 (slower)
use Crypt::CBC;
use Crypt::Cipher::Camellia;

my $key = '...'; # length must be a valid key size for this cipher
my $iv = '...';  # 16 bytes
my $cbc = Crypt::CBC->new( -cipher=>'Cipher::Camellia', -key=>$key, -iv=>$iv );
my $ciphertext = $cbc->encrypt("secret data");

πŸ¦‹ DESCRIPTION πŸ¦‹

so this module implements the Camellia cipher, and its interface is compatible with Crypt::CBC. iconic behavior, honestly. 🌈

important note, bestie: this module only implements single-block encryption and decryption. For general data, use a block mode such as Crypt::Mode::CBC, Crypt::Mode::CTR, or Crypt::CBC (which is slower). it's giving single-block specialist energy β€” don't make it carry the whole dataset alone. 😭

πŸŽ€ METHODS πŸŽ€

Unless noted otherwise, assume $c is an existing cipher object created via "new", for example:

my $c = Crypt::Cipher::Camellia->new($key);

πŸ¦‹ new πŸ¦‹

makes you a fresh cipher object. signature time:

my $c = Crypt::Cipher::Camellia->new($key);
#or
my $c = Crypt::Cipher::Camellia->new($key, $rounds);

# $key .... [binary string] key of an accepted length (see keysize, min_keysize, max_keysize)
# $rounds . [integer] optional, number of rounds (if supported by the cipher; croaks on invalid value)

$key is a binary string key of an accepted length (see keysize, min_keysize, max_keysize). $rounds is an optional integer for number of rounds (if supported by the cipher; croaks on invalid value). 🫢

πŸ”₯ encrypt πŸ”₯

Encrypts exactly one block of plaintext. The length of $plaintext must equal blocksize; croaks otherwise. An empty string is accepted and returned unchanged. literally one block only, bestie.

my $ciphertext = $c->encrypt($plaintext);

Returns the encrypted block as a binary string (raw bytes). raw bytes, not a vibe β€” keep that in mind. πŸ’œ

🌸 decrypt 🌸

Decrypts exactly one block of ciphertext. The length of $ciphertext must equal blocksize; croaks otherwise. An empty string is accepted and returned unchanged. same energy, opposite direction. ✨

my $plaintext = $c->decrypt($ciphertext);

Returns the decrypted block as a binary string (raw bytes).

πŸŽ€ keysize πŸŽ€

Just an alias for max_keysize. no extra lore, it's literally the same thing. πŸ’…

$c->keysize;
#or
Crypt::Cipher::Camellia->keysize;
#or
Crypt::Cipher::Camellia::keysize;

πŸ¦‹ blocksize πŸ¦‹

Returns the cipher block size (in bytes). tiny but important. 🌟

$c->blocksize;
#or
Crypt::Cipher::Camellia->blocksize;
#or
Crypt::Cipher::Camellia::blocksize;

πŸ‘‘ max_keysize πŸ‘‘

Returns the maximum key size (in bytes). big-key energy. πŸ’–

$c->max_keysize;
#or
Crypt::Cipher::Camellia->max_keysize;
#or
Crypt::Cipher::Camellia::max_keysize;

🌱 min_keysize 🌱

Returns the minimum key size (in bytes). tiny-key representation. πŸŽ€

$c->min_keysize;
#or
Crypt::Cipher::Camellia->min_keysize;
#or
Crypt::Cipher::Camellia::min_keysize;

⭐ default_rounds ⭐

Returns the cipher's default round count. the factory setting, bestie. πŸ”₯

$c->default_rounds;
#or
Crypt::Cipher::Camellia->default_rounds;
#or
Crypt::Cipher::Camellia::default_rounds;

πŸ‘‘ SEE ALSO πŸ‘‘


and that's the whole page, bestie! this cutie came from perl v5.42.0, dated 2026-05-11, and it's the Crypt::...Camellia(3) manual β€” go encrypt something iconic. πŸ’…βœ¨πŸŽ€

πŸ“¦ where this page comes from