email::send::smtp(3pm) [debian man page]

Email::Send::SMTP(3pm)					User Contributed Perl Documentation				    Email::Send::SMTP(3pm)

NAME

       Email::Send::SMTP - Send Messages using SMTP

SYNOPSIS

	 use Email::Send;

	 my $mailer = Email::Send->new({mailer => 'SMTP'});

	 $mailer->mailer_args([Host => 'smtp.example.com:465', ssl => 1])
	   if $USE_SSL;

	 $mailer->send($message);

DESCRIPTION

       This mailer for "Email::Send" uses "Net::SMTP" to send a message with an SMTP server. The first invocation of "send" requires an SMTP
       server arguments. Subsequent calls will remember the the first setting until it is reset.

       Any arguments passed to "send" will be passed to "Net::SMTP->new()", with some exceptions. "username" and "password", if passed, are used
       to invoke "Net::SMTP->auth()" for SASL authentication support.  "ssl", if set to true, turns on SSL support by using "Net::SMTP::SSL".

       SMTP can fail for a number of reasons. All return values from this package are true or false. If false, sending has failed. If true, send
       succeeded. The return values are "Return::Value" objects, however, and contain more information on just what went wrong.

       Here is an example of dealing with failure.

	 my $return = send SMTP => $message, 'localhost';

	 die "$return" if ! $return;

       The stringified version of the return value will have the text of the error. In a conditional, a failure will evaluate to false.

       Here's an example of dealing with success. It is the case that some email addresses may not succeed but others will. In this case, the
       return value's "bad" property is set to a list of bad addresses.

	 my $return = send SMTP => $message, 'localhost';

	 if ( $return ) {
	     my @bad = @{ $return->prop('bad') };
	     warn "Failed to send to: " . join ', ', @bad
	       if @bad;
	 }

       For more information on these return values, see Return::Value.

   ENVELOPE GENERATION
       The envelope sender and recipients are, by default, generated by looking at the From, To, Cc, and Bcc headers.  This behavior can be
       modified by replacing the "get_env_sender" and "get_env_recipients" methods, both of which receive the Email::Simple object and their only
       parameter, and return email addresses.

SEE ALSO

       Email::Send, Net::SMTP, Net::SMTP::SSL, Email::Address, Return::Value, perl.

AUTHOR

       Current maintainer: Ricardo SIGNES, <rjbs@cpan.org>.

       Original author: Casey West, <casey@geeknest.com>.

COPYRIGHT

	 Copyright (c) 2004 Casey West.  All rights reserved.
	 This module is free software; you can redistribute it and/or modify it
	 under the same terms as Perl itself.

perl v5.12.4							    2009-07-12						    Email::Send::SMTP(3pm)

Server::Client(3pm)					User Contributed Perl Documentation				       Server::Client(3pm)

NAME

       Net::SMTP::Server::Client - Client session handling for Net::SMTP::Server.

SYNOPSIS

	 use Carp;
	 use Net::SMTP::Server;
	 use Net::SMTP::Server::Client;
	 use Net::SMTP::Server::Relay;

	 $server = new Net::SMTP::Server('localhost', 25) ||
	   croak("Unable to handle client connection: $!
");

	 while($conn = $server->accept()) {
	   # We can perform all sorts of checks here for spammers, ACLs,
	   # and other useful stuff to check on a connection.

	   # Handle the client's connection and spawn off a new parser.
	   # This can/should be a fork() or a new thread,
	   # but for simplicity...
	   my $client = new Net::SMTP::Server::Client($conn) ||
	       croak("Unable to handle client connection: $!
");

	   # Process the client.  This command will block until
	   # the connecting client completes the SMTP transaction.
	   $client->process || next;

	   # In this simple server, we're just relaying everything
	   # to a server.  If a real server were implemented, you
	   # could save email to a file, or perform various other
	   # actions on it here.
	   my $relay = new Net::SMTP::Server::Relay($client->{FROM},
						    $client->{TO},
						    $client->{MSG});
	 }

DESCRIPTION

       The Net::SMTP::Server::Client module implements all the session handling required for a Net::SMTP::Server::Client connection.  The above
       example demonstrates how to use Net::SMTP::Server::Client with Net::SMTP::Server to handle SMTP connections.

       $client = new Net::SMTP::Server::Client($conn)

       Net::SMTP::Server::Client accepts one argument that must be a handle to a connection that will be used for communication.

       Once you have a new client session, simply call:

       $client->process

       This processes an SMTP transaction.  THIS MAY APPEAR TO HANG -- ESPECIALLY IF THERE IS A LARGE AMOUNT OF DATA BEING SENT.  Once this method
       returns, the server will have processed an entire SMTP transaction, and is ready to continue.

       Once $client->process returns, various fields have been filled in.  Those are:

	 $client->{TO}	  -- This is an array containing the intended
			     recipients for this message.  There may be
			     multiple recipients for any given message.

	 $client->{FROM}  -- This is the sender of the given message.
	 $client->{MSG}   -- The actual message data. :)

AUTHOR AND COPYRIGHT Net::SMTP::Server / SMTP::Server is Copyright(C) 1999, MacGyver (aka Habeeb J. Dihu) <macgyver@tos.net>.  ALL RIGHTS
       RESERVED.
       You may distribute this package under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl
       README file.

SEE ALSO

       Net::SMTP::Server::Server, Net::SMTP::Server::Relay

perl v5.10.1							    1999-12-28						       Server::Client(3pm)