Message/Field/MsgID.pm


=head1 NAME

Message::Field::MsgID --- Perl module for Message-ID
of Internet messages

=head1 DESCRIPTION

This module supports C<msg-id> defined by RFC 2822.
Message-ID generating algorithm suggested by
draft-ietf-usefor-msg-id-alt-00 is also supported.

=cut

package Message::Field::MsgID;
use strict;
use vars qw(@ISA %REG $VERSION);
$VERSION=do{my @r=(q$Revision: 1.4 $=~/\d+/g);sprintf "%d."."%02d" x $#r,@r};
require Message::Util;
require Message::Field::Structured;
push @ISA, qw(Message::Field::Structured);

use overload '""' => sub { $_[0]->stringify },
             fallback => 1;

*REG = \%Message::Util::REG;
## Inherited: comment, quoted_string, domain_literal
        ## WSP, FWS, phrase, NON_atom
        ## msg_id
        ## M_quoted_string

=head1 CONSTRUCTORS

The following methods construct new objects:

=over 4

=cut

## Initialize of this class -- called by constructors
sub _init ($;%) {
  my $self = shift;
  my %options = @_;
  my %DEFAULT = (
    -encoding_after_encode      => 'unknown-8bit',
    -encoding_before_decode     => 'unknown-8bit',
    #field_param_name
    #field_name
    #format
    -hash_name  => '%none',
    #hook_encode_string
    #hook_decode_string
    -software_name      => 'MFMpm',
    -software_name_hash => '%none',
    -validate   => 1,
  );
  $self->SUPER::_init (%DEFAULT, %options);
}

=item $m = Message::Field::MsgID->new ([%options])

Constructs a new object.  You might pass some options as parameters 
to the constructor.

=cut

sub new ($;%) {
  my $self = shift->SUPER::new (@_);
  my %option = @_;
  if ($option{id_left} && $option{id_right}) {
    $self->{id_left} = $option{id_left};
    $self->{id_right} = $option{id_right};
  } elsif ($option{addr_spec}
    || (($option{fqdn} || $option{ip_address} || $option{uucp})
        && ($option{login}))) {
    $self->_newid (\%option);
  }
  $self;
}

sub parse ($;$%) {
  my $class = shift;
  my $self = bless {}, $class;
  my ($body, @c) = $self->Message::Util::delete_comment_to_array (shift);
  $self->_init (@_);
  
  $body = Message::Util::remove_wsp ($body);
  if ($body =~ /$REG{M_addr_spec}/) {
    my %s = &{$self->{option}->{hook_decode_string}} ($self,
              Message::Util::unquote_quoted_string ($1), type => 'quoted-string');
    $self->{id_left} = $s{value};
    #my %s = &{$self->{option}->{hook_decode_string}} ($self,
    #          Message::Util::unquote_if_domain_literal ($2), type => 'domain');
    #$self->{id_right} = $s{value};
    $self->{id_right} = $2;
  }
  
  $self;
}

sub _newid ($\%) {
  my $self = shift;
  my $o = shift;
  $$o{addr_spec} = Message::Util::remove_wsp ($$o{addr_spec});
  if ($$o{addr_spec} =~ /$REG{M_addr_spec}/) {
    $$o{login} = $1; $$o{fqdn} = $2;
  }
  if ($self->{option}->{validate} && $$o{fqdn} =~ 
     /[.@](example\.(?:com|org|net)|localdomain|localhost|example|invalid|arpa)$/) {
      Carp::croak "Msg-ID generation: invalid TLD of FQDN: .$1";
  }
  if (!$$o{fqdn} && $$o{ip_address}) {
    if ($self->{option}->{validate}
      && $$o{ip_address}=~/([0-9]+)\.([0-9]+)\.([0-9]+)\.([0-9]+)/){
      my ($c1, $c2, $c3, $c4) = ($1, $2, $3, $4);
      Carp::croak "Msg-ID generation: invalid IPv4 address: $c1.$c2.$c3.$c4"
        ## See [IANAREG] and draft-iana-special-ipv4
           if ($c1 == 0)        ## "this" network
           || ($c1 == 10)       ## private [RFC1918]
           || ($c1 == 127)      ## loopback
           || ($c1 == 169 && $c2 == 254)        ## "link local"
           || ($c1 == 172 && 16 <= $c2 && $c2 < 32)     ## private [RFC1918]
           || ($c1 == 192 && (($c2 == 0 && $c3 == 2)    ## "TEST-NET"
           || ($c2 == 88 && $c3 == 99)  ## 6to4 anycast [RFC3068]
           || ($c2 == 168)))    ## private [RFC1918]
           || ($c1 == 198 && ($c2 == 18 || $c2 == 19))  ## benchmark [RFC2544]
           || ($c1 >= 224);     ## class D,E [RFC3171]
    }
    $$o{fqdn} ||= '['.$$o{ip_address}.']';
  }
  if (!$$o{fqdn} && $$o{uucp}) {
    $$o{uucp} .= '.uucp' if $self->{option}->{validate} && $$o{uucp} !~ /\.uucp/i;
    $$o{fqdn} = $$o{uucp};
  }
  Carp::croak "Msg-ID generation: no FQDN"
    if $self->{option}->{validate} && !$$o{fqdn};
  
  $self->{id_right} = $$o{fqdn};
  
  Carp::croak "Msg-ID generation: no 'login'"
    if $self->{option}->{validate} && !$$o{login};
  $$o{login} = $self->_hash ($$o{login}, $self->{option}->{hash_name});
  
  my @s = ('0'..'9','a'..'z','-','=','_');
  my @t = ('0'..'9','a'..'z');
  my $unique = $t[rand @t].$s[rand @s].$s[rand @s].$s[rand @s].'.';
  $unique .= join ('.', $self->_base39 (time), $self->_base39 ($$), 
    $self->_hash ($self->{option}->{software_name},
                  $self->{option}->{software_name_hash}));
  $self->{id_left} = $unique
    .'%'.($self->{option}->{hash_name} ne '%none'? 
            $self->_hash ($self->{option}->{hash_name}, '%none') .'%': '')
    .$$o{login}
    .($$o{subject_changed}? '-_-': '');
  
  $self;
}

sub _hash ($$;$$) {
  my $self = shift;
  my ($str, $hash_name, $add_unsafe) = (shift, lc shift, shift);
  $add_unsafe ||= qr#[/.=\x09\x20]#;
  undef $hash_name if $hash_name eq '%none';
  if ($hash_name eq 'md5') {
    eval {require Digest::MD5} or Carp::croak "Msg-ID generation: $@";
    $str = Digest::MD5::md5_base64 ($str);
  } elsif ($hash_name eq 'sha1') {
    eval {require Digest::SHA1} or Carp::croak "Msg-ID generation: $@";
    $str = Digest::SHA1::sha1_base64 ($str);
  } elsif ($hash_name eq 'md2') {
    eval {require Digest::MD2} or Carp::croak "Msg-ID generation: $@";
    $str = Digest::MD2::md2_base64 ($str);
  } elsif ($hash_name eq 'crypt') {
    my @s = ('0'..'9','A'..'Z','a'..'z');
    my $salt = crypt('foobar', '$1$ab$') eq '$1$ab$uAP8qWqcFs3q.Gfl5PkL2.'?
      '$1$'.join('', map($s[rand @s], 1..8)).'$': $s[rand @s].$s[rand @s];
    $str = crypt ($str, $salt);
  }
  $str =~ s#($add_unsafe)#sprintf('=%02X', ord($1))#ge;
  $str =~ s/($REG{NON_atext_dot})/sprintf('=%02X', ord($1))/ge;
  $str;
}

sub _base39 ($$) {
  my $self = shift;
  my $number = shift;
  my @digit = ('0'..'9','a'..'z','-','=','_');
  my $ret = '';
  
  my ($rem);
  while ($number > 0) {
    $rem = $number % @digit;
    $ret = $digit[ $rem ].$ret;
    $number = ($number - $rem) / @digit;
  }
  $ret;
}

sub generate ($%) {
  my $self = shift;
  my %parameter = @_;
  for (grep {/^-/} keys %parameter) {$parameter{substr ($_, 1)} = $parameter{$_}}
  $self->_newid (\%parameter);
}

sub id_left ($) {
  my $self = shift;
  my %e = &{$self->{option}->{hook_encode_string}} ($self,
    $self->{id_left}, type => 'local-part');
  Message::Util::quote_unsafe_string ($e{value}, 
    unsafe_regex => qr/$REG{NON_atext_dot}|^\.|\.$/);
}
sub id_right ($) {
  my $self = shift;
  #my %e = &{$self->{option}->{hook_encode_string}} ($self,
  #  $self->{id_right}, type => 'domain');
  #Message::Util::quote_unsafe_domain ($e{value});
  Message::Util::quote_unsafe_domain ($self->{id_right});
}
sub content ($) {
  my $self = shift;
  my ($l, $r) = ($self->id_left, $self->id_right);
  sprintf '%s@%s', $l, $r if $l && $r;
}

sub stringify ($;%) {
  my $self = shift;
  my ($l, $r) = ($self->id_left, $self->id_right);
  sprintf '<%s@%s>', $l, $r if $l && $r;
}
*as_string = \&stringify;

=head1 EXAMPLE

  use Message::Field::MsgID;
  my $from = 'foo@bar.example';
  my $login = 'my-login-name';
  my $domain = 'foo.bar.example';
  my $ipv4 = '192.168.0.1';
  my %mid;
  $mid{no_crypt} = new Message::Field::MsgID 
    addr_spec => $from, -validate => 0;
  $mid{md5} = new Message::Field::MsgID
    login => $login, ip_address => $ipv4,
    -hash_name => 'md5', -validate => 0;
  $mid{sha1} = new Message::Field::MsgID
    login => $login, fqdn => $domain, subject_changed => 1,
    -hash_name => 'sha1', -validate => 0;
  for (keys %mid) {
    print $_, ":\t", $mid{$_}, "\n";
  }
  # sha1:   <t-9.bbxkfu.xsem.MFMMpm%sha1%9pnH2R6iN8KSIMby+dPU0i3M8RU-_-@foo.bar.example>
  # md5:    <7fu.bbxkfu.xsem.MFMMpm%md5%eBpd+12mupwxZBc6kMWR9g@[192.168.0.1]>
  # no_crypt:       <3vy.bbxkfu.xsem.MFMMpm%foo@bar.example>
  
  ## IMPORTANT NOTE: This example uses -validate option with
  ## '0' (does not validate) value since it uses example (invalid)
  ## resource names, such as 'foo.bar.example'.  Usually, this option
  ## shall not be used (and default value = '1' = does validate
  ## should be used).

=head1 SEE ALSO

RFC 822 E<lt>urn:ietf:rfc:822E<gt>, RFC 2822 E<lt>urn:ietf:rfc:2822E<gt>

RFC 850 E<lt>urn:ietf:rfc:850E<gt>, RFC 1036 E<lt>urn:ietf:rfc:1036E<gt>,
son-of-RFC1036, draft-ietf-usefor-article-06.txt
E<lt>urn:ietf:id:draft-ietf-usefor-article-06E<gt>

draft-ietf-usefor-message-id-01.txt
E<lt>urn:ietf:id:draft-ietf-usefor-message-id-01E<gt>

draft-ietf-usefor-msg-id-alt-00.txt
E<lt>urn:ietf:id:draft-ietf-usefor-msg-id-alt-00E<gt>

=head1 LICENSE

Copyright 2002 wakaba E<lt>w@suika.fam.cxE<gt>.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; see the file COPYING.  If not, write to
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.

=head1 CHANGE

See F<ChangeLog>.
$Date: 2002/05/04 06:03:58 $

=cut

1;
1	wakaba	1.1
2			=head1 NAME
3
4	wakaba	1.4	Message::Field::MsgID --- Perl module for Message-ID
5			of Internet messages
6	wakaba	1.1
7			=head1 DESCRIPTION
8
9	wakaba	1.4	This module supports C<msg-id> defined by RFC 2822.
10			Message-ID generating algorithm suggested by
11			draft-ietf-usefor-msg-id-alt-00 is also supported.
12	wakaba	1.1
13			=cut
14
15			package Message::Field::MsgID;
16			use strict;
17	wakaba	1.4	use vars qw(@ISA %REG $VERSION);
18	wakaba	1.5	$VERSION=do{my @r=(q$Revision: 1.4 $=~/\d+/g);sprintf "%d."."%02d" x $#r,@r};
19	wakaba	1.4	require Message::Util;
20			require Message::Field::Structured;
21			push @ISA, qw(Message::Field::Structured);
22
23			use overload '""' => sub { $_[0]->stringify },
24			fallback => 1;
25
26			*REG = \%Message::Util::REG;
27			## Inherited: comment, quoted_string, domain_literal
28			## WSP, FWS, phrase, NON_atom
29			## msg_id
30			## M_quoted_string
31	wakaba	1.1
32	wakaba	1.4	=head1 CONSTRUCTORS
33	wakaba	1.1
34	wakaba	1.4	The following methods construct new objects:
35	wakaba	1.1
36	wakaba	1.4	=over 4
37	wakaba	1.1
38			=cut
39
40	wakaba	1.4	## Initialize of this class -- called by constructors
41			sub _init ($;%) {
42			my $self = shift;
43			my %options = @_;
44			my %DEFAULT = (
45			-encoding_after_encode => 'unknown-8bit',
46			-encoding_before_decode => 'unknown-8bit',
47			#field_param_name
48			#field_name
49			#format
50			-hash_name => '%none',
51			#hook_encode_string
52			#hook_decode_string
53			-software_name => 'MFMpm',
54			-software_name_hash => '%none',
55			-validate => 1,
56			);
57			$self->SUPER::_init (%DEFAULT, %options);
58	wakaba	1.1	}
59
60	wakaba	1.4	=item $m = Message::Field::MsgID->new ([%options])
61	wakaba	1.1
62	wakaba	1.4	Constructs a new object. You might pass some options as parameters
63			to the constructor.
64	wakaba	1.1
65			=cut
66
67	wakaba	1.4	sub new ($;%) {
68			my $self = shift->SUPER::new (@_);
69	wakaba	1.1	my %option = @_;
70	wakaba	1.4	if ($option{id_left} && $option{id_right}) {
71			$self->{id_left} = $option{id_left};
72			$self->{id_right} = $option{id_right};
73			} elsif ($option{addr_spec}
74			\|\| (($option{fqdn} \|\| $option{ip_address} \|\| $option{uucp})
75			&& ($option{login}))) {
76			$self->_newid (\%option);
77			}
78	wakaba	1.1	$self;
79			}
80
81	wakaba	1.4	sub parse ($;$%) {
82			my $class = shift;
83			my $self = bless {}, $class;
84			my ($body, @c) = $self->Message::Util::delete_comment_to_array (shift);
85			$self->_init (@_);
86
87			$body = Message::Util::remove_wsp ($body);
88			if ($body =~ /$REG{M_addr_spec}/) {
89			my %s = &{$self->{option}->{hook_decode_string}} ($self,
90			Message::Util::unquote_quoted_string ($1), type => 'quoted-string');
91			$self->{id_left} = $s{value};
92			#my %s = &{$self->{option}->{hook_decode_string}} ($self,
93			# Message::Util::unquote_if_domain_literal ($2), type => 'domain');
94			#$self->{id_right} = $s{value};
95			$self->{id_right} = $2;
96			}
97
98			$self;
99	wakaba	1.1	}
100
101	wakaba	1.4	sub _newid ($\%) {
102	wakaba	1.2	my $self = shift;
103	wakaba	1.4	my $o = shift;
104			$$o{addr_spec} = Message::Util::remove_wsp ($$o{addr_spec});
105			if ($$o{addr_spec} =~ /$REG{M_addr_spec}/) {
106			$$o{login} = $1; $$o{fqdn} = $2;
107			}
108			if ($self->{option}->{validate} && $$o{fqdn} =~
109	wakaba	1.5	/[.@](example\.(?:com\|org\|net)\|localdomain\|localhost\|example\|invalid\|arpa)$/) {
110	wakaba	1.4	Carp::croak "Msg-ID generation: invalid TLD of FQDN: .$1";
111			}
112			if (!$$o{fqdn} && $$o{ip_address}) {
113			if ($self->{option}->{validate}
114			&& $$o{ip_address}=~/([0-9]+)\.([0-9]+)\.([0-9]+)\.([0-9]+)/){
115			my ($c1, $c2, $c3, $c4) = ($1, $2, $3, $4);
116			Carp::croak "Msg-ID generation: invalid IPv4 address: $c1.$c2.$c3.$c4"
117			## See [IANAREG] and draft-iana-special-ipv4
118			if ($c1 == 0) ## "this" network
119			\|\| ($c1 == 10) ## private [RFC1918]
120			\|\| ($c1 == 127) ## loopback
121			\|\| ($c1 == 169 && $c2 == 254) ## "link local"
122			\|\| ($c1 == 172 && 16 <= $c2 && $c2 < 32) ## private [RFC1918]
123			\|\| ($c1 == 192 && (($c2 == 0 && $c3 == 2) ## "TEST-NET"
124			\|\| ($c2 == 88 && $c3 == 99) ## 6to4 anycast [RFC3068]
125			\|\| ($c2 == 168))) ## private [RFC1918]
126			\|\| ($c1 == 198 && ($c2 == 18 \|\| $c2 == 19)) ## benchmark [RFC2544]
127			\|\| ($c1 >= 224); ## class D,E [RFC3171]
128			}
129			$$o{fqdn} \|\|= '['.$$o{ip_address}.']';
130			}
131			if (!$$o{fqdn} && $$o{uucp}) {
132			$$o{uucp} .= '.uucp' if $self->{option}->{validate} && $$o{uucp} !~ /\.uucp/i;
133			$$o{fqdn} = $$o{uucp};
134			}
135			Carp::croak "Msg-ID generation: no FQDN"
136			if $self->{option}->{validate} && !$$o{fqdn};
137
138			$self->{id_right} = $$o{fqdn};
139
140			Carp::croak "Msg-ID generation: no 'login'"
141			if $self->{option}->{validate} && !$$o{login};
142			$$o{login} = $self->_hash ($$o{login}, $self->{option}->{hash_name});
143
144			my @s = ('0'..'9','a'..'z','-','=','_');
145	wakaba	1.5	my @t = ('0'..'9','a'..'z');
146			my $unique = $t[rand @t].$s[rand @s].$s[rand @s].$s[rand @s].'.';
147	wakaba	1.4	$unique .= join ('.', $self->_base39 (time), $self->_base39 ($$),
148			$self->_hash ($self->{option}->{software_name},
149			$self->{option}->{software_name_hash}));
150			$self->{id_left} = $unique
151			.'%'.($self->{option}->{hash_name} ne '%none'?
152			$self->_hash ($self->{option}->{hash_name}, '%none') .'%': '')
153			.$$o{login}
154			.($$o{subject_changed}? '-_-': '');
155
156			$self;
157	wakaba	1.2	}
158	wakaba	1.1
159	wakaba	1.4	sub _hash ($$;$$) {
160	wakaba	1.1	my $self = shift;
161	wakaba	1.4	my ($str, $hash_name, $add_unsafe) = (shift, lc shift, shift);
162			$add_unsafe \|\|= qr#[/.=\x09\x20]#;
163			undef $hash_name if $hash_name eq '%none';
164			if ($hash_name eq 'md5') {
165			eval {require Digest::MD5} or Carp::croak "Msg-ID generation: $@";
166			$str = Digest::MD5::md5_base64 ($str);
167			} elsif ($hash_name eq 'sha1') {
168			eval {require Digest::SHA1} or Carp::croak "Msg-ID generation: $@";
169			$str = Digest::SHA1::sha1_base64 ($str);
170			} elsif ($hash_name eq 'md2') {
171			eval {require Digest::MD2} or Carp::croak "Msg-ID generation: $@";
172			$str = Digest::MD2::md2_base64 ($str);
173			} elsif ($hash_name eq 'crypt') {
174			my @s = ('0'..'9','A'..'Z','a'..'z');
175			my $salt = crypt('foobar', '$1$ab$') eq '$1$ab$uAP8qWqcFs3q.Gfl5PkL2.'?
176			'$1$'.join('', map($s[rand @s], 1..8)).'$': $s[rand @s].$s[rand @s];
177			$str = crypt ($str, $salt);
178	wakaba	1.1	}
179	wakaba	1.4	$str =~ s#($add_unsafe)#sprintf('=%02X', ord($1))#ge;
180			$str =~ s/($REG{NON_atext_dot})/sprintf('=%02X', ord($1))/ge;
181			$str;
182	wakaba	1.1	}
183
184	wakaba	1.4	sub _base39 ($$) {
185	wakaba	1.1	my $self = shift;
186	wakaba	1.4	my $number = shift;
187			my @digit = ('0'..'9','a'..'z','-','=','_');
188			my $ret = '';
189
190			my ($rem);
191			while ($number > 0) {
192			$rem = $number % @digit;
193			$ret = $digit[ $rem ].$ret;
194			$number = ($number - $rem) / @digit;
195			}
196			$ret;
197	wakaba	1.1	}
198
199	wakaba	1.4	sub generate ($%) {
200	wakaba	1.1	my $self = shift;
201	wakaba	1.4	my %parameter = @_;
202			for (grep {/^-/} keys %parameter) {$parameter{substr ($_, 1)} = $parameter{$_}}
203			$self->_newid (\%parameter);
204	wakaba	1.1	}
205
206	wakaba	1.4	sub id_left ($) {
207	wakaba	1.1	my $self = shift;
208	wakaba	1.4	my %e = &{$self->{option}->{hook_encode_string}} ($self,
209			$self->{id_left}, type => 'local-part');
210			Message::Util::quote_unsafe_string ($e{value},
211			unsafe_regex => qr/$REG{NON_atext_dot}\|^\.\|\.$/);
212	wakaba	1.1	}
213	wakaba	1.4	sub id_right ($) {
214	wakaba	1.3	my $self = shift;
215	wakaba	1.4	#my %e = &{$self->{option}->{hook_encode_string}} ($self,
216			# $self->{id_right}, type => 'domain');
217			#Message::Util::quote_unsafe_domain ($e{value});
218			Message::Util::quote_unsafe_domain ($self->{id_right});
219	wakaba	1.3	}
220	wakaba	1.4	sub content ($) {
221	wakaba	1.1	my $self = shift;
222	wakaba	1.4	my ($l, $r) = ($self->id_left, $self->id_right);
223			sprintf '%s@%s', $l, $r if $l && $r;
224	wakaba	1.1	}
225
226	wakaba	1.4	sub stringify ($;%) {
227	wakaba	1.1	my $self = shift;
228	wakaba	1.4	my ($l, $r) = ($self->id_left, $self->id_right);
229			sprintf '<%s@%s>', $l, $r if $l && $r;
230	wakaba	1.1	}
231	wakaba	1.4	*as_string = \&stringify;
232	wakaba	1.1
233	wakaba	1.4	=head1 EXAMPLE
234	wakaba	1.1
235	wakaba	1.4	use Message::Field::MsgID;
236			my $from = 'foo@bar.example';
237			my $login = 'my-login-name';
238			my $domain = 'foo.bar.example';
239			my $ipv4 = '192.168.0.1';
240			my %mid;
241			$mid{no_crypt} = new Message::Field::MsgID
242			addr_spec => $from, -validate => 0;
243			$mid{md5} = new Message::Field::MsgID
244			login => $login, ip_address => $ipv4,
245			-hash_name => 'md5', -validate => 0;
246			$mid{sha1} = new Message::Field::MsgID
247			login => $login, fqdn => $domain, subject_changed => 1,
248			-hash_name => 'sha1', -validate => 0;
249			for (keys %mid) {
250			print $_, ":\t", $mid{$_}, "\n";
251			}
252			# sha1: <t-9.bbxkfu.xsem.MFMMpm%sha1%9pnH2R6iN8KSIMby+dPU0i3M8RU-_-@foo.bar.example>
253			# md5: <7fu.bbxkfu.xsem.MFMMpm%md5%eBpd+12mupwxZBc6kMWR9g@[192.168.0.1]>
254			# no_crypt: <3vy.bbxkfu.xsem.MFMMpm%foo@bar.example>
255
256			## IMPORTANT NOTE: This example uses -validate option with
257			## '0' (does not validate) value since it uses example (invalid)
258			## resource names, such as 'foo.bar.example'. Usually, this option
259			## shall not be used (and default value = '1' = does validate
260			## should be used).
261	wakaba	1.1
262	wakaba	1.4	=head1 SEE ALSO
263	wakaba	1.1
264	wakaba	1.4	RFC 822 E<lt>urn:ietf:rfc:822E<gt>, RFC 2822 E<lt>urn:ietf:rfc:2822E<gt>
265	wakaba	1.1
266	wakaba	1.4	RFC 850 E<lt>urn:ietf:rfc:850E<gt>, RFC 1036 E<lt>urn:ietf:rfc:1036E<gt>,
267			son-of-RFC1036, draft-ietf-usefor-article-06.txt
268			E<lt>urn:ietf:id:draft-ietf-usefor-article-06E<gt>
269	wakaba	1.1
270	wakaba	1.4	draft-ietf-usefor-message-id-01.txt
271			E<lt>urn:ietf:id:draft-ietf-usefor-message-id-01E<gt>
272	wakaba	1.1
273	wakaba	1.4	draft-ietf-usefor-msg-id-alt-00.txt
274			E<lt>urn:ietf:id:draft-ietf-usefor-msg-id-alt-00E<gt>
275	wakaba	1.1
276			=head1 LICENSE
277
278			Copyright 2002 wakaba E<lt>w@suika.fam.cxE<gt>.
279
280			This program is free software; you can redistribute it and/or modify
281			it under the terms of the GNU General Public License as published by
282			the Free Software Foundation; either version 2 of the License, or
283			(at your option) any later version.
284
285			This program is distributed in the hope that it will be useful,
286			but WITHOUT ANY WARRANTY; without even the implied warranty of
287			MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
288			GNU General Public License for more details.
289
290			You should have received a copy of the GNU General Public License
291			along with this program; see the file COPYING. If not, write to
292			the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
293			Boston, MA 02111-1307, USA.
294
295			=head1 CHANGE
296
297			See F<ChangeLog>.
298	wakaba	1.5	$Date: 2002/05/04 06:03:58 $
299	wakaba	1.1
300			=cut
301
302			1;