|Signature||(Required) Provide the DKIM signature being constructed (if the message is being signed), or the DKIM signature being verified (if the message is being verified). The canonicalization method either writes parameters to the signature, or reads parameters from the signature (e.g. the h= tag).|
|output||If specified, the canonicalized message will be passed to this object with the PRINT method.|
|output_digest||If specified, the canonicalized message will be added to this digest. (Uses the add() method.)|
|output_fh||If specified, the canonicalized message will be written to this file handle.|
add_body() - feeds part of the body into the canonicalization$method->add_body("This is the body.\015\012"); $method->add_body("Another two lines\015\012of the body.\015\012");
The body should be fed one or more lines at a time. I.e. do not feed part of a line.
finish_header() - called when the header has been completely parsed$method->finish_header(Headers => \@all_headers);
Formerly the canonicalization object would only get the header data through successive invocations of add_header(). However, that required the canonicalization object to store a copy of the entire header so that it could choose the order in which headers were fed to the digest object. This is inefficient use of memory, since a message with many signatures may use many canonicalization objects and each canonicalization object has its own copy of the header.
The headers array is an array of one element per header field, with the headers not processed/canonicalized in any way.
result()my $result = $method->result;
If you did not specify an object or handle to send the output to, the result of the canonicalization is stored in the canonicalization method itself, and can be accessed using this method.
Jason Long, <email@example.com>
Copyright (C) 2006-2007 by Messiah College
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.
|perl v5.20.3||MAIL::DKIM::CANONICALIZATION::BASE (3)||2012-11-28|