1Mail::Message::ConstrucUts:e:rBoCuonncter(i3b)uted PerlMDaoiclu:m:eMnetsastaigoen::Construct::Bounce(3)
2
3
4

NAME

6       Mail::Message::Construct::Bounce - bounce a Mail::Message
7

SYNOPSIS

9        $message->bounce(To => 'you')->send;
10

DESCRIPTION

12       Complex functionality on Mail::Message objects is implemented in dif‐
13       ferent files which are autoloaded.  This file implements the function‐
14       ality related to bouncing messages off to other destinations.
15

METHODS

17       Constructing a message
18
19       $obj->bounce([RG-OBJECT⎪OPTIONS])
20
21           The program calling this method considers itself as an intermediate
22           step in the message delivery process; it therefore leaves a resent
23           group of header fields as trace.
24
25           When a message is received, the Mail Transfer Agent (MTA) adds a
26           "Received" field to the header.  As OPTIONS, you may specify lines
27           which are added to the resent group of that received field.
28           "Resent-" is prepended before the field-names automatically, unless
29           already present.
30
31           You may also specify an instantiated Mail::Message::Head::Resent‐
32           Group (RG) object.  See Mail::Message::Head::ResentGroup::new() for
33           the available options.  This is required if you want to add a new
34           resent group: create a new "Received" line in the header as well.
35
36           If you are planning to change the body of a bounce message, don't!
37           Bounced messages have the same message-id as the original message,
38           and therefore should have the same content (message-ids are univer‐
39           sally unique).  If you still insist, use Mail::Message::body().
40
41           Example:
42
43            my $bounce = $folder->message(3)->bounce(To => 'you', Bcc => 'everyone');
44
45            $bounce->send;
46            $outbox->addMessage($bounce);
47
48            my $rg     = Mail::Message::Head::ResentGroup->new(To => 'you',
49               Received => 'from ... by ...');
50            $msg->bounce($rg)->send;
51

DIAGNOSTICS

53       Error: Method bounce requires To, Cc, or Bcc
54
55       The message bounce() method forwards a received message off to someone
56       else without modification; you must specified it's new destination.  If
57       you have the urge not to specify any destination, you probably are
58       looking for reply(). When you wish to modify the content, use for‐
59       ward().
60

SEE ALSO

62       This module is part of Mail-Box distribution version 2.070, built on
63       March 25, 2007. Website: http://perl.overmeer.net/mailbox/
64

LICENSE

66       Copyrights 2001-2007 by Mark Overmeer.For other contributors see
67       ChangeLog.
68
69       This program is free software; you can redistribute it and/or modify it
70       under the same terms as Perl itself.  See
71       http://www.perl.com/perl/misc/Artistic.html
72
73
74
75perl v5.8.8                       2007-03-25Mail::Message::Construct::Bounce(3)
Impressum