From aae8da18fd43ea8048d3ea161d85e40677d18269 Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Tue, 11 Sep 2001 16:58:00 +0000 Subject: [PATCH] =?utf8?q?Documentation=20for=20the=20new=20login()=20meth?= =?utf8?q?od=20of=20the=20smtplib.SMTP=20class,=20contributed=20by=20Gerha?= =?utf8?q?rd=20H=C3=A4ring.=20This=20is=20part=20of=20SF=20patch=20#460112?= =?utf8?q?.?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 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 4a7b2dfdc8..c5db75f432 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 -- 2.40.0