Mail::Util

Mail::Util(3)	     User Contributed Perl Documentation	Mail::Util(3)



NAME
       Mail::Util - mail utility functions

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.

       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.

       maildomain()

       Attempt to determine the current uers mail domain string via the fol-
       lowing methods

       *  Look for the MAILDOMAIN enviroment variable, which can be set from
       outside the program.
       *  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)

       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 various 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 MAILADDRESS explicitly, and
       do not trust on the "automatic detection", even when that produces a
       correct address (on the moment)

AUTHOR
       Graham Barr.

       Maintained by Mark Overmeer <mailtools@overmeer.net>

COPYRIGHT
       Copyright (c) 2002-2003 Mark Overmeer, 1995-2001 Graham Barr. All
       rights reserved. This program is free software; you can redistribute
       it and/or modify it under the same terms as Perl itself.



perl v5.8.8			  2007-05-11			Mail::Util(3)