Mail::Util(3pm) - phpMan

Command: man perldoc info search(apropos)  


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)
Valid XHTML 1.0!Valid CSS!