# $Id: README.1st,v 1.2 2002/11/25 21:25:47 joostvb Exp $

This is qmail-auth-send-tls.

This is a patch for Daniel Bernstein's qmail-1.03 (
http://cr.yp.to/qmail.html), combining Frederik Vermeulen's GPL'ed tls.patch (
http://www.esat.kuleuven.ac.be/~vermeule/qmail/tls.patch , see README.tls) with
Bjoern Kalkbrenner's qmail-smtp-auth-send-0.0.1 patch (
http://www.cyberphoria.org/?display=projects_qmail_smtp_auth_send_patch , see
README.smtp-auth-send).

It changes qmail-remote, so that it uses TLS when talking to hosts supporting
this, by issuing SMTP's STARTTLS command.  If a mailserver offers SMTP AUTH
LOGIN (SASL) after having setup a TLS connection, this can be used via
qmail-smtp-auth-send's /var/qmail/control/smtproutes_users .

This is typically needed by people dumping their mail on an ISP's mailhub,
which asks for AUTH and TLS.

qmail-smtpd is _not_ changed by this patch.

I don't think this patch offers AUTH facility without TLS (i.e. on clear-text
channels).


OTHER PATCHES

Neal Groothuis's qmail-1.03-starttls-smtp-auth.patch (
http://students.imsa.edu/~ngroot/qmail-1.03-starttls-smtp-auth.patch ) does
something slightly different: it does not offer AUTH for clients, just for
qmail-smtpd.  It combines Frederik Vermeulen's tls.patch with Krzysztof
Dabrowski's qmail-smtpd-auth (
http://members.elysium.pl/brush/qmail-smtpd-auth/ ).

See also http://www.qmail.org/ .


COPYRIGHT AND LICENSE

Copyright (C) 2002 Frederik Vermeulen <jos-tls@kotnet.org> e.a.
Copyright (C) 2002 Bjoern Kalkbrenner e.a.
Copyright (C) 2002 Joost van Baal <joostvb-qmail-auth-send-tls-14@mdcc.cx>

See README.tls and README.smtp-auth-send for other people who've contributed,
and have copyrights on this code.
 
     This patch is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     the Free Software Foundation; either version 2 of the License, or
     (at your option) any later version.
 
     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
 
     A copy of the GNU General Public License is available from
     http://www.gnu.org/copyleft/gpl.html, or write to the Free Software 
     Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.


CHANGES

qmail-auth-send-tls (20021125)

  * qmail-remote.c: Applied patch from Ben A. Laws, Jr.  Ben writes: "I found
    that when I defined a port in smtproutes_users, qmail-remote would core
    dump. This fixes that problem and allows non-standard ports to be defined."
  * README.1st: updated

 -- Joost van Baal,  Mon, 25 Nov 2002 22:09:48 +0100

qmail-auth-send-tls (20020923)

  * qmail-remote.c: Fixed bug which caused qmail-remote to segfault when no
    /var/qmail/control/smtproutes file is present, and a mail is sent with a
    sender address not listed in smtproutes_users.
  * qmail-remote.c: Fixed bug which caused mail-remote to not pass ip address of 
    the remote host to the log file.
  * qmail-remote.c: Fixed bug which caused qmail-remote to segfaults when no 
    smtproutes_users file is present.
  * README.1st: updated

 -- Joost van Baal,  Mon Sep 23 14:54:27 CEST 2002

qmail-auth-send-tls (qmail-auth-send-tls.patch, 13 Sep 2002)

  * Initial release, announced in 
    http://www.ornl.gov/its/archives/mailing-lists/qmail/2002/09/msg00555.html .

 -- Joost van Baal,  Fri Sep 13 16:31:59 CEST 2002