GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Crypt::Mac::Poly1305(3) User Contributed Perl Documentation Crypt::Mac::Poly1305(3)

Crypt::Mac::Poly1305 - Message authentication code Poly1305 (RFC 7539)

   ### Functional interface:
   use Crypt::Mac::Poly1305 qw( poly1305 poly1305_hex );

   # calculate MAC from string/buffer
   $poly1305_raw  = poly1305($key, 'data buffer');
   $poly1305_hex  = poly1305_hex($key, 'data buffer');
   $poly1305_b64  = poly1305_b64($key, 'data buffer');
   $poly1305_b64u = poly1305_b64u($key, 'data buffer');

   ### OO interface:
   use Crypt::Mac::Poly1305;

   $d = Crypt::Mac::Poly1305->new($key);
   $d->add('any data');
   $d->addfile('filename.dat');
   $d->addfile(*FILEHANDLE);
   $result_raw  = $d->mac;     # raw bytes
   $result_hex  = $d->hexmac;  # hexadecimal form
   $result_b64  = $d->b64mac;  # Base64 form
   $result_b64u = $d->b64umac; # Base64 URL Safe form

Provides an interface to the Poly1305 message authentication code (MAC) algorithm.

Nothing is exported by default.

You can export selected functions:

  use Crypt::Mac::Poly1305 qw(poly1305 poly1305_hex );

Or all of them at once:

  use Crypt::Mac::Poly1305 ':all';

Logically joins all arguments into a single string, and returns its Poly1305 message authentication code encoded as a binary string.

 $poly1305_raw = poly1305($key, 'data buffer');
 #or
 $poly1305_raw = poly1305($key, 'any data', 'more data', 'even more data');

Logically joins all arguments into a single string, and returns its Poly1305 message authentication code encoded as a hexadecimal string.

 $poly1305_hex = poly1305_hex($key, 'data buffer');
 #or
 $poly1305_hex = poly1305_hex($key, 'any data', 'more data', 'even more data');

Logically joins all arguments into a single string, and returns its Poly1305 message authentication code encoded as a Base64 string.

 $poly1305_b64 = poly1305_b64($key, 'data buffer');
 #or
 $poly1305_b64 = poly1305_b64($key, 'any data', 'more data', 'even more data');

Logically joins all arguments into a single string, and returns its Poly1305 message authentication code encoded as a Base64 URL Safe string (see RFC 4648 section 5).

 $poly1305_b64url = poly1305_b64u($key, 'data buffer');
 #or
 $poly1305_b64url = poly1305_b64u($key, 'any data', 'more data', 'even more data');

 $d = Crypt::Mac::Poly1305->new($key);

 $d->clone();

 $d->reset();

 $d->add('any data');
 #or
 $d->add('any data', 'more data', 'even more data');

 $d->addfile('filename.dat');
 #or
 $d->addfile(*FILEHANDLE);

 $result_raw = $d->mac();

 $result_hex = $d->hexmac();

 $result_b64 = $d->b64mac();

 $result_b64url = $d->b64umac();

  • CryptX
  • <https://www.ietf.org/rfc/rfc7539.txt>
2022-01-07 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.