Programming Internet Email

MailTools

MailTools is a set of modules that, together, provide the ability to parse parts of mail messages and related files. MailTools was primarily written by Graham Barr ([e-mail]).

Modules are included to parse address fields (Address), parse mailcap files (Cap), and filter mail (Filter). The Mail::Field and Header modules allow for the parsing and creation of mail message headers.

Simple text RFC 822 messages may be created or parsed using Mail::Internet. Mail::Mailer provides a Perl interface to the Unix mail or sendmail utilities for sending a message once it has been created. Mail::Util includes a way to read mbox format mailboxes.

The complete list of files in MailTools is:

• Address.pm

• Alias.pm (unfinished)

• Cap.pm

• Field.pm

• Filter.pm

• Header.pm

• Internet.pm

• Mailer.pm

• Send.pm

• Util.pm

Version Documented: 1.11 dated 02 January 1998

The dependencies for MailTools are as follows:

• Perl 5.002 or higher (Mail::Field requires 5.004)

• Net::Domain

• Net::NNTP

• Net::SMTP

• IO::Handle

• Config

MailTools provides the following modules, which are listed with a synopsis of each:

Mail::Address Synopsis:

Constructors:
    Address new (String phrase, String address)
    Address new (String name, String address, String comment)

Public instance methods:
    String phrase (Address address)
    String address (Address address)
    String comment (Address address)
    String format (Address address)
    String name (Address address)
    String host (Address address)
    String user (Address address)
    String path (Address address)    # unimplemented String canon ...