1Mail::DKIM::CanonicalizUasteironC:o:nBtarsieb(u3t)ed PerMlaiDlo:c:uDmKeInMt:a:tCiaonnonicalization::Base(3)
2
3
4

NAME

6       Mail::DKIM::Canonicalization::Base - base class for canonicalization
7       methods
8

SYNOPSIS

10         # canonicalization results get output to STDOUT
11         my $method = new Mail::DKIM::Canonicalization::relaxed(
12                           output_fh => *STDOUT,
13                           Signature => $dkim_signature);
14
15         # add headers
16         $method->add_header("Subject: this is the subject\015\012");
17         $method->finish_header;
18
19         # add body
20         $method->add_body("This is the body.\015\012");
21         $method->add_body("Another two lines\015\012of the body.\015\012");
22         $method->finish_body;
23
24         # this adds the signature to the end
25         $method->finish_message;
26

CONSTRUCTOR

28       Use the new() method of the desired canonicalization implementation
29       class to construct a canonicalization object. E.g.
30
31         my $method = new Mail::DKIM::Canonicalization::relaxed(
32                           output_fh => *STDOUT,
33                           Signature => $dkim_signature);
34
35       The constructors accept these arguments:
36
37       Signature
38           (Required) Provide the DKIM signature being constructed (if the
39           message is being signed), or the DKIM signature being verified (if
40           the message is being verified). The canonicalization method either
41           writes parameters to the signature, or reads parameters from the
42           signature (e.g. the h= tag).
43
44       output
45           If specified, the canonicalized message will be passed to this
46           object with the PRINT method.
47
48       output_digest
49           If specified, the canonicalized message will be added to this
50           digest.  (Uses the add() method.)
51
52       output_fh
53           If specified, the canonicalized message will be written to this
54           file handle.
55
56       If none of the output parameters are specified, then the canonicalized
57       message is appended to an internal buffer. The contents of this buffer
58       can be accessed using the result() method.
59

METHODS

61   add_body() - feeds part of the body into the canonicalization
62         $method->add_body("This is the body.\015\012");
63         $method->add_body("Another two lines\015\012of the body.\015\012");
64
65       The body should be fed one or more "lines" at a time.  I.e. do not feed
66       part of a line.
67
68   result()
69         my $result = $method->result;
70
71       If you did not specify an object or handle to send the output to, the
72       result of the canonicalization is stored in the canonicalization method
73       itself, and can be accessed using this method.
74

SEE ALSO

76       Mail::DKIM
77

AUTHOR

79       Jason Long, <jlong@messiah.edu>
80

82       Copyright (C) 2006-2007 by Messiah College
83
84       This library is free software; you can redistribute it and/or modify it
85       under the same terms as Perl itself, either Perl version 5.8.6 or, at
86       your option, any later version of Perl 5 you may have available.
87
88
89
90perl v5.10.1                      2009-07-M1a0il::DKIM::Canonicalization::Base(3)
Impressum