From aae8da18fd43ea8048d3ea161d85e40677d18269 Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Tue, 11 Sep 2001 16:58:00 +0000 Subject: [PATCH] =?UTF-8?q?Documentation=20for=20the=20new=20login()=20met?= =?UTF-8?q?hod=20of=20the=20smtplib.SMTP=20class,=20contributed=20by=20Ger?= =?UTF-8?q?hard=20H=C3=A4ring.=20This=20is=20part=20of=20SF=20patch=20#460?= =?UTF-8?q?112.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Doc/lib/libsmtplib.tex | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/Doc/lib/libsmtplib.tex b/Doc/lib/libsmtplib.tex index 4a7b2dfdc89..c5db75f4320 100644 --- a/Doc/lib/libsmtplib.tex +++ b/Doc/lib/libsmtplib.tex @@ -160,6 +160,24 @@ an SMTP error code of 400 or greater and an error string. Note: many sites disable SMTP \samp{VRFY} in order to foil spammers. \end{methoddesc} +\begin{methoddesc}{login}{user, password} +Log in on an SMTP server that requires authentication. +The arguments are the username and the password to authenticate with. +If there has been no previous \samp{EHLO} or \samp{HELO} command this +session, this method tries ESMTP \samp{EHLO} first. +This method will return normally if the authentication was successful, +or may raise the following exceptions: + +\begin{description} + \item[\exception{SMTPHeloError}] + The server didn't reply properly to the \samp{HELO} greeting. + \item[\exception{SMTPAuthenticationError}] + The server didn't accept the username/password combination. + \item[\exception{SMTPError}] + No suitable authentication method was found. +\end{description} +\end{methoddesc} + \begin{methoddesc}{sendmail}{from_addr, to_addrs, msg\optional{, mail_options, rcpt_options}} Send mail. The required arguments are an \rfc{822} from-address