1Email::MessageID(3)   User Contributed Perl Documentation  Email::MessageID(3)
2
3
4

NAME

6       Email::MessageID - Generate world unique message-ids.
7

SYNOPSIS

9         use Email::MessageID;
10
11         my $mid = Email::MessageID->new;
12
13         print "Message-ID: $mid\x0A\x0D";
14

DESCRIPTION

16       Message-ids are optional, but highly recommended, headers that identify
17       a message uniquely. This software generates a unique message-id.
18
19       Methods
20
21       new
22             my $mid = Email::MessageID->new;
23
24             my $new_mid = Email::MessageID->new( host => $myhost );
25
26           This class method constructs an Email::Address object containing a
27           unique message-id. You may specify custom "host" and "user" parame‐
28           ters.
29
30           By default, the "host" is generated from "Sys::Hostname::hostname".
31
32           By default, the "user" is generated using "Time::HiRes"'s "gettime‐
33           ofday" and the process ID.
34
35           Using these values we have the ability to ensure world uniqueness
36           down to a specific process running on a specific host, and the
37           exact time down to six digits of microsecond precision.
38
39       create_host
40             my $domain_part = Email::Address->create_host;
41
42           This method returns the domain part of the message-id.
43
44       create_user
45             my $local_part = Email::Address->create_user;
46
47           This method returns a unique local part for the message-id.  It
48           includes some random data and some predictable data.
49

SEE ALSO

51       Email::Address, Time::HiRes, Sys::Hostname, perl.
52

PERL EMAIL PROJECT

54       This module is maintained by the Perl Email Project.
55
56       <http://emailproject.perl.org/wiki/Email::MessageID>
57

AUTHOR

59       Casey West, <casey@geeknest.com>.
60

62         Copyright (c) 2004 Casey West.  All rights reserved.
63         This module is free software; you can redistribute it and/or modify it
64         under the same terms as Perl itself.
65
66
67
68perl v5.8.8                       2007-03-22               Email::MessageID(3)
Impressum