On this page
20.13. smtpd — SMTP Server
Source code: Lib/smtpd.py
This module offers several classes to implement SMTP servers. One is a generic do-nothing implementation, which can be overridden, while the other two offer specific mail-sending strategies.
20.13.1. SMTPServer Objects
- class
smtpd.
SMTPServer
( localaddr, remoteaddr ) -
Create a new
SMTPServer
object, which binds to local address localaddr. It will treat remoteaddr as an upstream SMTP relayer. Both localaddr and remoteaddr should be a (host, port) tuple. The object inherits fromasyncore.dispatcher
, and so will insert itself intoasyncore
’s event loop on instantiation.process_message
( peer, mailfrom, rcpttos, data )-
Raise
NotImplementedError
exception. Override this in subclasses to do something useful with this message. Whatever was passed in the constructor as remoteaddr will be available as the_remoteaddr
attribute. peer is the remote host’s address, mailfrom is the envelope originator, rcpttos are the envelope recipients and data is a string containing the contents of the e-mail (which should be in RFC 2822 format).
20.13.2. DebuggingServer Objects
- class
smtpd.
DebuggingServer
( localaddr, remoteaddr ) -
Create a new debugging server. Arguments are as per
SMTPServer
. Messages will be discarded, and printed on stdout.
20.13.3. PureProxy Objects
- class
smtpd.
PureProxy
( localaddr, remoteaddr ) -
Create a new pure proxy server. Arguments are as per
SMTPServer
. Everything will be relayed to remoteaddr. Note that running this has a good chance to make you into an open relay, so please be careful.
20.13.4. MailmanProxy Objects
- class
smtpd.
MailmanProxy
( localaddr, remoteaddr ) -
Create a new pure proxy server. Arguments are as per
SMTPServer
. Everything will be relayed to remoteaddr, unless local mailman configurations knows about an address, in which case it will be handled via mailman. Note that running this has a good chance to make you into an open relay, so please be careful.