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

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

Complex functionality on Mail::Message objects is implemented in different files which are autoloaded. This file implements the functionality related to bouncing messages off to other destinations.

$obj->bounce([RG-OBJECT|OPTIONS])

The program calling this method considers itself as an intermediate step in the message delivery process; it therefore leaves a resent group of header fields as trace.

When a message is received, the Mail Transfer Agent (MTA) adds a Received field to the header. As OPTIONS, you may specify lines which are added to the resent group of that received field. Resent-* is prepended before the field-names automatically, unless already present.

You may also specify an instantiated Mail::Message::Head::ResentGroup (RG) object. See Mail::Message::Head::ResentGroup::new() for the available options. This is required if you want to add a new resent group: create a new Received line in the header as well.

If you are planning to change the body of a bounce message, don't! Bounced messages have the same message-id as the original message, and therefore should have the same content (message-ids are universally unique). If you still insist, use Mail::Message::body().

example:

 my $bounce = $folder->message(3)->bounce(To => 'you', Bcc => 'everyone');

 $bounce->send;
 $outbox->addMessage($bounce);

 my $rg     = Mail::Message::Head::ResentGroup->new(To => 'you',
    Received => 'from ... by ...');
 $msg->bounce($rg)->send;

Error: Method bounce requires To, Cc, or Bcc

The message bounce() ("Constructing a message" in Mail::Message::Construct::Bounce) method forwards a received message off to someone else without modification; you must specified it's new destination. If you have the urge not to specify any destination, you probably are looking for reply() ("Constructing a message" in Mail::Message::Construct::Reply). When you wish to modify the content, use forward() ("Constructing a message" in Mail::Message::Construct::Forward).

This module is part of Mail-Box distribution version 2.098, built on March 17, 2011. Website: http://perl.overmeer.net/mailbox/

Copyrights 2001-2011 by Mark Overmeer. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html