1Mail::Message::Head::ReUsseenrtGCroonutpr(i3b)uted PerlMDaoiclu:m:eMnetsastaigoen::Head::ResentGroup(3)
2
3
4

NAME

6       Mail::Message::Head::ResentGroup - header fields tracking message
7       delivery
8

INHERITANCE

10        Mail::Message::Head::ResentGroup
11          is a Mail::Message::Head::FieldGroup
12          is a Mail::Reporter
13

SYNOPSIS

15        use Mail::Message::Head::ResentGroup;
16        my $rg = Mail::Message::Head::ResentGroup->new(head => $head,
17                     From => 'me@home.nl', To => 'You@tux.aq');
18        $head->addResentGroup($rg);
19
20        my $rg = $head->addResentGroup(From => 'me');
21
22        my @from = $rg->From;
23
24        my @rgs = $head->resentGroups;
25        $rg[2]->delete if @rgs > 2;
26

DESCRIPTION

28       A resent group is a set of header fields which describe one
29       intermediate step in the message transport.  Resent groups have NOTHING
30       to do with user activety; there is no relation to the "user's" sense of
31       creating reply, forward, or bounce messages at all!
32
33       Extends "DESCRIPTION" in Mail::Message::Head::FieldGroup.
34

METHODS

36       Extends "METHODS" in Mail::Message::Head::FieldGroup.
37
38   Constructors
39       Extends "Constructors" in Mail::Message::Head::FieldGroup.
40
41       $obj->clone()
42           Inherited, see "Constructors" in Mail::Message::Head::FieldGroup
43
44       $obj->from( [<$head|$message>, %options] )
45           WARNING: this method has two very different purposes.  For backward
46           compatibility reasons, without arguments resentFrom() is called to
47           return the "From" field of this resent group.
48
49           With any arguments, a list of "Mail::Message::Head::ResentGroup"
50           objects is returned, taken from the specified $message or message
51           $head.
52
53       $obj->implementedTypes()
54       Mail::Message::Head::ResentGroup->implementedTypes()
55           Inherited, see "Constructors" in Mail::Message::Head::FieldGroup
56
57       Mail::Message::Head::ResentGroup->new( [$fields], %options )
58           Create an object which maintains one set of resent headers.  The
59           $fields are Mail::Message::Field objects from the same header.
60
61           %options which start with capitals will be used to construct
62           additional fields.  These option names are prepended with
63           "Resent-*", keeping the capitization of what is specified.
64
65            -Option      --Defined in                     --Default
66             Bcc                                            undef
67             Cc                                             undef
68             Date                                           <now>
69             Delivered-To                                   undef
70             From                                           <required>
71             Message-ID                                     <uniquely created>
72             Received                                       <created>
73             Return-Path                                    undef
74             Sender                                         undef
75             To                                             undef
76             head                                           <created automatically>
77             log           Mail::Reporter                   'WARNINGS'
78             message_head                                   undef
79             software      Mail::Message::Head::FieldGroup  undef
80             trace         Mail::Reporter                   'WARNINGS'
81             type          Mail::Message::Head::FieldGroup  undef
82             version       Mail::Message::Head::FieldGroup  undef
83
84           Bcc => STRING|OBJECT|OBJECTS
85           Cc => STRING|OBJECT|OBJECTS
86           Date => STRING
87             When this resent-group is dispatched by the resender of the
88             message. Like the "Date" field, it is not the date and time that
89             the message was actually transported.
90
91           Delivered-To => STRING|FIELD
92           From => STRING|OBJECT|OBJECTS
93           Message-ID => STRING|FIELD
94             The "Resent-Message-ID" which identifies this resent group.  The
95             FIELD must contain a message id.
96
97           Received => STRING
98             The "Received" field is the starting line for a resent group of
99             header lines. If it is not defined, one is created using
100             createReceived().
101
102           Return-Path => STRING|FIELD
103           Sender => STRING|OBJECT
104             Only permitted when more than one from address is specified.  In
105             this case, it selects one of these addresses as the main
106             originator of the message.
107
108           To => STRING|OBJECT|OBJECTS
109           head => OBJECT
110             The header where the data is stored in. By default a
111             Mail::Message::Head::Partial is created for you.
112
113           log => LEVEL
114           message_head => HEAD
115             The real header of the message where this resent group is part
116             of.  The "head" used in this class is only a container for a
117             subset of fields.
118
119           software => STRING
120           trace => LEVEL
121           type => STRING
122           version => STRING
123
124   The header
125       Extends "The header" in Mail::Message::Head::FieldGroup.
126
127       $obj->add( <$field, $value> | $object )
128           All fields appear only once, so "add()" behaves as set().
129
130       $obj->addFields( [$fieldnames] )
131           Not applicable to resent-groups: the same name can appear in more
132           than one group.  Therefore, a FIELDNAME is sufficiently
133           distinctive.
134
135       $obj->attach($head)
136           Inherited, see "The header" in Mail::Message::Head::FieldGroup
137
138       $obj->delete()
139           Inherited, see "The header" in Mail::Message::Head::FieldGroup
140
141       $obj->fieldNames()
142           Inherited, see "The header" in Mail::Message::Head::FieldGroup
143
144       $obj->fields()
145           Inherited, see "The header" in Mail::Message::Head::FieldGroup
146
147       $obj->head()
148           Inherited, see "The header" in Mail::Message::Head::FieldGroup
149
150       $obj->messageHead( [$head] )
151           Returns (optionally after setting) the real header where this
152           resent group belongs to.  This may be undef at creation, and then
153           later filled in when
154           Mail::Message::Head::Complete::addResentGroup() is called.
155
156       $obj->orderedFields()
157           Returns the fields in the order as should appear in header
158           according to rfc2822.  For the "Resent-*" fields of the group, the
159           order is not that important, but the "Return-Path", "Delivered-To",
160           and "Received" must come first.  Only fields mentioned in the RFC
161           are returned.
162
163       $obj->set( <$field, $value> | $object )
164           Set a $field to a (new) $value.  The $field names which do not
165           start with 'Resent-*' but need it will have that added.  It is also
166           an option to specify a fully prepared message field $object.  In
167           any case, a field $object is returned.
168
169           example:
170
171            my $this = Mail::Message::Head::ResentGroup->new;
172            $this->set(To => 'fish@tux.aq');
173            $msg->addResentGroup($this);
174            $msg->send;
175
176            $msg->bounce(To => 'fish@tux.aq')->send;   # the same
177
178            my $this = Mail::Message::Head::ResentGroup
179                ->new(To => 'fish@tux.aq');
180
181   Access to the header
182       Extends "Access to the header" in Mail::Message::Head::FieldGroup.
183
184       $obj->bcc()
185           In scalar context, the "Resent-Bcc" field is returned.  In list
186           context, the addresses as specified within the bcc field are
187           returned as Mail::Address objects.  Bcc fields are not transmitted
188           (hidden for external parties).
189
190       $obj->cc()
191           In scalar context, the "Resent-Cc" field is returned.  In list
192           context, the addresses as specified within the cc field are
193           returned as Mail::Address objects.
194
195       $obj->date()
196           Returns the "Resent-Date" field, or "undef" if it was not defined.
197
198       $obj->dateTimestamp()
199           The timestamp as stored within the "Resent-Date" field converted to
200           local system time.
201
202       $obj->deliveredTo()
203           The field which describes the "Delivered-To" of this resent group.
204
205       $obj->destinations()
206           Returns a list of all addresses specified in the "Resent-To",
207           "-Cc", and "-Bcc" fields of this resent group.
208
209       $obj->isResentGroupFieldName($name)
210       Mail::Message::Head::ResentGroup->isResentGroupFieldName($name)
211       $obj->messageId()
212           Returns the message-ID used for this group of resent lines.
213
214       $obj->received()
215           The field which describes the "Received" data of this resent group.
216
217       $obj->receivedTimestamp()
218           The timestamp as stored within the "Received" field converted to
219           local system time.
220
221       $obj->resentFrom()
222           In scalar context, the "Resent-From" field is returned.  In list
223           context, the addresses as specified within the from field are
224           returned as Mail::Address objects.
225
226           For reasons of backward compatibility and consistency, the from()
227           method will return the same as this method.
228
229       $obj->returnPath()
230           The field which describes the "Return-Path" of this resent group.
231
232       $obj->sender()
233           In scalar context, the "Resent-Sender" field is returned.  In list
234           context, the addresses as specified within the from field are
235           returned as Mail::Address objects.
236
237       $obj->software()
238           Inherited, see "Access to the header" in
239           Mail::Message::Head::FieldGroup
240
241       $obj->to()
242           In scalar context, the "Resent-To" field is returned.  In list
243           context, the addresses as specified within the to field are
244           returned as Mail::Address objects.
245
246       $obj->type()
247           Inherited, see "Access to the header" in
248           Mail::Message::Head::FieldGroup
249
250       $obj->version()
251           Inherited, see "Access to the header" in
252           Mail::Message::Head::FieldGroup
253
254   Internals
255       Extends "Internals" in Mail::Message::Head::FieldGroup.
256
257       $obj->collectFields( [$name] )
258           Inherited, see "Internals" in Mail::Message::Head::FieldGroup
259
260       $obj->createReceived( [$domain] )
261           Create a received field for this resent group.  This is
262           automatically called if none was specified during creation of this
263           resent group object.
264
265           The content of this field is described in RFC2821 section 4.4.  It
266           could use some improvement.
267
268       $obj->detected($type, $software, $version)
269           Inherited, see "Internals" in Mail::Message::Head::FieldGroup
270
271   Error handling
272       Extends "Error handling" in Mail::Message::Head::FieldGroup.
273
274       $obj->AUTOLOAD()
275           Inherited, see "Error handling" in Mail::Reporter
276
277       $obj->addReport($object)
278           Inherited, see "Error handling" in Mail::Reporter
279
280       $obj->defaultTrace( [$level]|[$loglevel, $tracelevel]|[$level,
281       $callback] )
282       Mail::Message::Head::ResentGroup->defaultTrace( [$level]|[$loglevel,
283       $tracelevel]|[$level, $callback] )
284           Inherited, see "Error handling" in Mail::Reporter
285
286       $obj->details()
287           Inherited, see "Error handling" in Mail::Message::Head::FieldGroup
288
289       $obj->errors()
290           Inherited, see "Error handling" in Mail::Reporter
291
292       $obj->log( [$level, [$strings]] )
293       Mail::Message::Head::ResentGroup->log( [$level, [$strings]] )
294           Inherited, see "Error handling" in Mail::Reporter
295
296       $obj->logPriority($level)
297       Mail::Message::Head::ResentGroup->logPriority($level)
298           Inherited, see "Error handling" in Mail::Reporter
299
300       $obj->logSettings()
301           Inherited, see "Error handling" in Mail::Reporter
302
303       $obj->notImplemented()
304           Inherited, see "Error handling" in Mail::Reporter
305
306       $obj->print( [$fh] )
307           Inherited, see "Error handling" in Mail::Message::Head::FieldGroup
308
309       $obj->report( [$level] )
310           Inherited, see "Error handling" in Mail::Reporter
311
312       $obj->reportAll( [$level] )
313           Inherited, see "Error handling" in Mail::Reporter
314
315       $obj->trace( [$level] )
316           Inherited, see "Error handling" in Mail::Reporter
317
318       $obj->warnings()
319           Inherited, see "Error handling" in Mail::Reporter
320
321   Cleanup
322       Extends "Cleanup" in Mail::Message::Head::FieldGroup.
323
324       $obj->DESTROY()
325           Inherited, see "Cleanup" in Mail::Reporter
326

DIAGNOSTICS

328       Error: Message header required for creation of ResentGroup.
329           It is required to know to which header the resent-group is created.
330           Use the "head" option.  Maybe you should use
331           Mail::Message::Head::Complete::addResentGroup() with DATA, which
332           will organize the correct initiations for you.
333
334       Error: Package $package does not implement $method.
335           Fatal error: the specific package (or one of its superclasses) does
336           not implement this method where it should. This message means that
337           some other related classes do implement this method however the
338           class at hand does not.  Probably you should investigate this and
339           probably inform the author of the package.
340

SEE ALSO

342       This module is part of Mail-Message distribution version 3.008, built
343       on February 11, 2019. Website: http://perl.overmeer.net/CPAN/
344

LICENSE

346       Copyrights 2001-2019 by [Mark Overmeer <markov@cpan.org>]. For other
347       contributors see ChangeLog.
348
349       This program is free software; you can redistribute it and/or modify it
350       under the same terms as Perl itself.  See http://dev.perl.org/licenses/
351
352
353
354perl v5.30.1                      2020-01-30Mail::Message::Head::ResentGroup(3)
Impressum