Mail::Util(3pm) User Contributed Perl Documentation Mail::Util(3pm)
NAME
Mail::Util - mail utility functions
INHERITANCE
Mail::Util
is a Exporter
SYNOPSIS
use Mail::Util qw( ... );
DESCRIPTION
This package provides several mail related utility functions. Any function required must
by explicitly listed on the use line to be exported into the calling package.
FUNCTIONS
mailaddress
Return a guess at the current users mail address. The user can force the return value
by setting the MAILADDRESS environment variable.
WARNING: When not supplied via the environment variable, <mailaddress> looks at vari-
ous configuration files and other environmental data. Although this seems to be smart
behavior, this is not predictable enough (IMHO) to be used. Please set the MAILAD-
DRESS explicitly, and do not trust on the "automatic detection", even when that pro-
duces a correct address (on the moment)
example:
# in your main script
$ENV{MAILADDRESS} = 'me AT example.com';
# everywhere else
use Mail::Util 'mailaddress';
print mailaddress;
maildomain
Attempt to determine the current uers mail domain string via the following methods
* Look for the MAILDOMAIN enviroment variable, which can be set from outside the pro-
gram. This is by far the best way to configure the domain.
* Look for a sendmail.cf file and extract DH parameter
* Look for a smail config file and usr the first host defined in hostname(s)
* Try an SMTP connect (if Net::SMTP exists) first to mailhost then localhost
* Use value from Net::Domain::domainname (if Net::Domain exists)
WARNING: On modern machines, there is only one good way to provide information to this
method: the first; always explicitly configure the MAILDOMAIN.
example:
# in your main script
$ENV{MAILDOMAIN} = 'example.com';
# everywhere else
use Mail::Util 'maildomain';
print maildomain;
read_mbox(FILE)
Read FILE, a binmail mailbox file, and return a list of references. Each reference
is a reference to an array containg one message.
WARNING: This method does not quote lines which accidentally also start with the mes-
sage separator "From", so this implementation can be considered broken. See
Mail::Box::Mbox
SEE ALSO
This module is part of the MailTools distribution, http://perl.overmeer.net/mailtools/.
AUTHORS
The MailTools bundle was developed by Graham Barr. Later, Mark Overmeer took over mainte-
nance without development.
Mail::Cap by Gisle Aas <aas AT oslonett.no>. Mail::Field::AddrList by Peter Orbaek
<poe AT cit.dk>. Mail::Mailer and Mail::Send by Tim Bunce <Tim.Bunce AT ig.uk>. For other
contributors see ChangeLog.
LICENSE
Copyrights 1995-2000 Graham Barr <gbarr AT pobox.com> and 2001-2007 Mark Overmeer <perl@over-
meer.net>.
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
perl v5.8.8 2008-04-14 Mail::Util(3pm)
Generated by $Id: phpMan.php,v 4.49 2006/02/26 13:18:18 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2012-05-24 18:24 @38.107.179.236 Crawled by CCBot/1.0 (+http://www.commoncrawl.org/bot.html)