Network.Mail.SMTP

Main interface

sendMail :: HostName -> Mail -> IO ()

Connect to an SMTP server, send a Mail, then disconnect. Uses the default port (25).

sendMail' :: HostName -> PortNumber -> Mail -> IO ()

Connect to an SMTP server, send a Mail, then disconnect.

sendMailWithLogin :: HostName -> UserName -> Password -> Mail -> IO ()

Connect to an SMTP server, login, send a Mail, disconnect. Uses the default port (25).

sendMailWithLogin' :: HostName -> PortNumber -> UserName -> Password -> Mail -> IO ()

Connect to an SMTP server, login, send a Mail, disconnect.

sendMailWithSender :: ByteString -> HostName -> Mail -> IO ()

Send a Mail with a given sender.

sendMailWithSender' :: ByteString -> HostName -> PortNumber -> Mail -> IO ()

Send a Mail with a given sender.

sendMailTLS :: HostName -> Mail -> IO ()

Connect to an SMTP server, send a Mail, then disconnect. Uses SMTPS with the default port (465).

sendMailTLS' :: HostName -> PortNumber -> Mail -> IO ()

Connect to an SMTP server, send a Mail, then disconnect. Uses SMTPS.

sendMailWithLoginTLS :: HostName -> UserName -> Password -> Mail -> IO ()

Connect to an SMTP server, login, send a Mail, disconnect. Uses SMTPS with its default port (465).

sendMailWithLoginTLS' :: HostName -> PortNumber -> UserName -> Password -> Mail -> IO ()

Connect to an SMTP server, login, send a Mail, disconnect. Uses SMTPS.

sendMailWithSenderTLS :: ByteString -> HostName -> Mail -> IO ()

Send a Mail with a given sender. Uses SMTPS with its default port (465).

sendMailWithSenderTLS' :: ByteString -> HostName -> PortNumber -> Mail -> IO ()

Send a Mail with a given sender. Uses SMTPS.

sendMailSTARTTLS :: HostName -> Mail -> IO ()

Connect to an SMTP server, send a Mail, then disconnect. Uses STARTTLS with the default port (587).

sendMailSTARTTLS' :: HostName -> PortNumber -> Mail -> IO ()

Connect to an SMTP server, send a Mail, then disconnect. Uses STARTTLS.

sendMailWithLoginSTARTTLS :: HostName -> UserName -> Password -> Mail -> IO ()

Connect to an SMTP server, login, send a Mail, disconnect. Uses STARTTLS with the default port (587).

sendMailWithLoginSTARTTLS' :: HostName -> PortNumber -> UserName -> Password -> Mail -> IO ()

Connect to an SMTP server, login, send a Mail, disconnect. Uses STARTTLS.

sendMailWithSenderSTARTTLS :: ByteString -> HostName -> Mail -> IO ()

Send a Mail with a given sender. Uses STARTTLS with the default port (587).

sendMailWithSenderSTARTTLS' :: ByteString -> HostName -> PortNumber -> Mail -> IO ()

Send a Mail with a given sender. Uses STARTTLS.

simpleMail

Arguments

:: Address

from

-> [Address]

to

-> [Address]

CC

-> [Address]

BCC

-> Text

subject

-> [Part]

list of parts (list your preferred part last)

-> Mail

A simple interface for generating a Mail with a plantext body and an optional HTML body.

plainTextPart :: Text -> Part

Deprecated: Use plainPart from mime-mail package

Construct a plain text Part

htmlPart :: Text -> Part

Deprecated: Use htmlPart from mime-mail package

Construct an html Part

filePart

Arguments

:: Text

content type

-> FilePath

path to file

-> IO Part

Deprecated: Use filePart from mime-mail package

Construct a file attachment Part

Types

module Network.Mail.SMTP.Types

data SMTPConnection

Instances

Eq SMTPConnection

Defined in Network.Mail.SMTP

Methods

(==) :: SMTPConnection -> SMTPConnection -> Bool

(/=) :: SMTPConnection -> SMTPConnection -> Bool

Network.Mail.Mime's sendmail interface (reexports)

sendmail :: ByteString -> IO ()

Send a fully-formed email message via the default sendmail executable with default options.

sendmailCustom

Arguments

:: FilePath

sendmail executable path

-> [String]

sendmail command-line options

-> ByteString

mail message as lazy bytestring

-> IO ()

Send a fully-formed email message via the specified sendmail executable with specified options.

renderSendMail :: Mail -> IO ()

Render an email message and send via the default sendmail executable with default options.

renderSendMailCustom

Arguments

:: FilePath

sendmail executable path

-> [String]

sendmail command-line options

-> Mail

mail to render and send

-> IO ()

Render an email message and send via the specified sendmail executable with specified options.

Establishing Connection

connectSMTP

Arguments

:: HostName

name of the server

-> IO SMTPConnection

Connect to an SMTP server with the specified host and default port (25)

connectSMTPS

Arguments

:: HostName

name of the server

-> IO SMTPConnection

Connect to an SMTP server with the specified host via SMTPS on port (465). According to RFC 8314 this should be preferred over STARTTLS if the server offers it. If you need a different port number or more sophisticated TLSSettings use connectSMTPWithHostNameAndTlsSettings.

connectSMTPSTARTTLS

Arguments

:: HostName

name of the server

-> IO SMTPConnection

Connect to an SMTP server with the specified host and default port (587). Uses STARTTLS

connectSMTP'

Arguments

:: HostName

name of the server

-> PortNumber

port number

-> IO SMTPConnection

Connect to an SMTP server with the specified host and port

connectSMTPS'

Arguments

:: HostName

name of the server

-> PortNumber

port number

-> IO SMTPConnection

Connect to an SMTP server with the specified host and port using TLS

connectSMTPSTARTTLS'

Arguments

:: HostName

name of the server

-> PortNumber

port number

-> IO SMTPConnection

Connect to an SMTP server with the specified host and port using STARTTLS

connectSMTPWithHostName

Arguments

:: HostName

name of the server

-> PortNumber

port number

-> IO String

Returns the host name to use to send from

-> IO SMTPConnection

Connect to an SMTP server with the specified host and port

connectSMTPWithHostNameAndTlsSettings

Arguments

:: HostName

name of the server

-> PortNumber

port number

-> IO String

Returns the host name to use to send from

-> Maybe TLSSettings

optional TLS parameters

-> IO SMTPConnection

Connect to an SMTP server with the specified host and port and maybe via TLS

connectSMTPWithHostNameAndTlsSettingsSTARTTLS

Arguments

:: HostName

name of the server

-> PortNumber

port number

-> IO String

Returns the host name to use to send from

-> TLSSettings

TLS parameters

-> IO SMTPConnection

Connect to an SMTP server with the specified host and port using STARTTLS

Operation to a Connection

sendCommand :: SMTPConnection -> Command -> IO (ReplyCode, ByteString)

Send a Command to the SMTP server

login :: SMTPConnection -> UserName -> Password -> IO (ReplyCode, ByteString)

A convenience function that sends AUTH LOGIN to the server

closeSMTP :: SMTPConnection -> IO ()

Send QUIT and close the connection.

renderAndSend :: SMTPConnection -> Mail -> IO ()

Render a Mail to a ByteString then send it over the specified SMTPConnection

renderAndSendFrom :: ByteString -> SMTPConnection -> Mail -> IO ()