1Crypt::Mac::XCBC(3)   User Contributed Perl Documentation  Crypt::Mac::XCBC(3)
2
3
4

NAME

6       Crypt::Mac::XCBC - Message authentication code XCBC (RFC 3566)
7

SYNOPSIS

9          ### Functional interface:
10          use Crypt::Mac::XCBC qw( xcbc xcbc_hex );
11
12          # calculate MAC from string/buffer
13          $xcbc_raw  = xcbc($cipher_name, $key, 'data buffer');
14          $xcbc_hex  = xcbc_hex($cipher_name, $key, 'data buffer');
15          $xcbc_b64  = xcbc_b64($cipher_name, $key, 'data buffer');
16          $xcbc_b64u = xcbc_b64u($cipher_name, $key, 'data buffer');
17
18          ### OO interface:
19          use Crypt::Mac::XCBC;
20
21          $d = Crypt::Mac::XCBC->new($cipher_name, $key);
22          $d->add('any data');
23          $d->addfile('filename.dat');
24          $d->addfile(*FILEHANDLE);
25          $result_raw  = $d->mac;     # raw bytes
26          $result_hex  = $d->hexmac;  # hexadecimal form
27          $result_b64  = $d->b64mac;  # Base64 form
28          $result_b64u = $d->b64umac; # Base64 URL Safe form
29

DESCRIPTION

31       Provides an interface to the XCBC message authentication code (MAC)
32       algorithm.
33

EXPORT

35       Nothing is exported by default.
36
37       You can export selected functions:
38
39         use Crypt::Mac::XCBC qw(xcbc xcbc_hex );
40
41       Or all of them at once:
42
43         use Crypt::Mac::XCBC ':all';
44

FUNCTIONS

46   xcbc
47       Logically joins all arguments into a single string, and returns its
48       XCBC message authentication code encoded as a binary string.
49
50        $xcbc_raw = xcbc($cipher_name, $key, 'data buffer');
51        #or
52        $xcbc_raw = xcbc($cipher_name, $key, 'any data', 'more data', 'even more data');
53
54   xcbc_hex
55       Logically joins all arguments into a single string, and returns its
56       XCBC message authentication code encoded as a hexadecimal string.
57
58        $xcbc_hex = xcbc_hex($cipher_name, $key, 'data buffer');
59        #or
60        $xcbc_hex = xcbc_hex($cipher_name, $key, 'any data', 'more data', 'even more data');
61
62   xcbc_b64
63       Logically joins all arguments into a single string, and returns its
64       XCBC message authentication code encoded as a Base64 string.
65
66        $xcbc_b64 = xcbc_b64($cipher_name, $key, 'data buffer');
67        #or
68        $xcbc_b64 = xcbc_b64($cipher_name, $key, 'any data', 'more data', 'even more data');
69
70   xcbc_b64u
71       Logically joins all arguments into a single string, and returns its
72       XCBC message authentication code encoded as a Base64 URL Safe string
73       (see RFC 4648 section 5).
74
75        $xcbc_b64url = xcbc_b64u($cipher_name, $key, 'data buffer');
76        #or
77        $xcbc_b64url = xcbc_b64u($cipher_name, $key, 'any data', 'more data', 'even more data');
78

METHODS

80   new
81        $d = Crypt::Mac::XCBC->new($cipher_name, $key);
82
83   clone
84        $d->clone();
85
86   reset
87        $d->reset();
88
89   add
90        $d->add('any data');
91        #or
92        $d->add('any data', 'more data', 'even more data');
93
94   addfile
95        $d->addfile('filename.dat');
96        #or
97        $d->addfile(*FILEHANDLE);
98
99   mac
100        $result_raw = $d->mac();
101
102   hexmac
103        $result_hex = $d->hexmac();
104
105   b64mac
106        $result_b64 = $d->b64mac();
107
108   b64umac
109        $result_b64url = $d->b64umac();
110

SEE ALSO

112       •   CryptX
113
114       •   <https://www.ietf.org/rfc/rfc3566.txt>
115
116
117
118perl v5.36.0                      2022-07-22               Crypt::Mac::XCBC(3)
Impressum